Карманный сэнсэй: как заставить мини-читалку на ESP32 учить вас японскому

—

от автора

Мини-читалка Xteink на ESP32

Мини-читалка Xteink на ESP32

Карманные мини-читалки на микроконтроллерах ESP32 — вроде Xteink X4/X3 или компактных самоделок с экранами на 3.7–4.3 дюйма — сейчас переживают настоящий расцвет. Они весят меньше 100 граммов, легко помещаются в любой карман, живут от одной зарядки аккумулятора неделями и радуют глаз монохромным E-Ink дисплеем (480×800) без мерцания подсветки.

Для таких гаджетов существует отличная открытая прошивка — CrossPoint Reader. Она оптимизирована под жесткие ограничения оперативной памяти ESP32-C3 (~320 КБ SRAM), умеет на лету парсить книги в формате EPUB и раскладывать их по страницам.

Но мини-читалка — это не просто ридер для чтения длинных романов перед сном. Из-за ультракомпактного формата её постоянно вертишь в руках: в метро, в очереди за кофе или на коротком перерыве. И мне захотелось превратить это миниатюрное устройство в карманный автономный тренажёр для изучения японского языка.

Смартфон для этих целей подходит плохо: только откроешь словарь или приложение с карточками — тут же сыплются пуши из мессенджеров, новости и ленты соцсетей, а яркий экран утомляет глаза. На E-Ink всё иначе: абсолютная тишина, никаких уведомлений и глубокая фокусировка на тексте.

Так родился JPink — специализированный форк прошивки CrossPoint Reader. Ниже я подробно расскажу, как я реализовал полноценную слоговую таблицу, систему интерактивных тренировок, интервальные повторения Anki и как научил монохромный экран отображать сложные иероглифы без «мыла» и грязи.

Репозиторий проекта: https://github.com/MrProLopstar/JPink


1. Интерактивная таблица каны (Gojūon 5×10)

Изучение японского всегда начинается со слоговых азбук — Хираганы (平仮名) и Катаканы (片仮名). В интернете полно статических картинок с таблицами, но на экране читалки 480×800 они превращаются либо в нечитаемую мелочь, либо требуют постоянного зума и скролла.

Я реализовал полноценную интерактивную матрицу Годзюон (5×10):

Интерактивная таблица слоговой каны

Интерактивная таблица слоговой каны

Как это устроено:

  • Сетка 5×10: 5 базовых гласных колонок (A, I, U, E, O) и 10 согласных рядов (A, Ka, Sa, Ta, Na, Ha, Ma, Ya, Ra, Wa + N).

  • Переключение в один клик: кнопка переворота мгновенно переключает всю таблицу между Хираганой и Катаканой.

  • Удобная навигация: джойстик или клавиши со стрелками перемещают фокусную рамку по ячейкам таблицы.

  • Информационная карточка сверху: при наведении на любой слог верхняя панель крупно показывает:

    1. Четкий увеличенный символ в 36 pt;

    2. Транскрипцию по системе Хэпбёрна (латинский ромадзи);

    3. Транскрипцию по системе Поливанова (академическая русская кириллица: си, а не ши; ти, а не чи; цу, а не тсу);

    4. Манъёгана (исторический кандзи-предок): иероглиф, из скорописи которого в древности родился этот знак (например, 安 → あ, 以 → い, 宇 → う, 衣 → え, 於 → お, 加 → か).

Всё рассчитывается и масштабируется прямо на лету, без задержек и без необходимости лезть в онлайн-справочники.


2. Виды тренировок: карточки, перемешивание и квизы

Запомнить таблицу — полдела, знаки нужно довести до автоматизма. Для этого в JPink заложено три разных типа тренировок:

Режим флешкарт (Flashcards) с перемешиванием

Для хираганы, катаканы и иероглифов базового уровня JLPT N5 есть классический режим карточек. По центру выводится крупный символ, по нажатию клавиши «ОК» карточка переворачивается и показывает чтение, перевод и подсказку.

Чтобы мозг не запоминал символы по порядку их следования в алфавите, предусмотрен режим Shuffle (случайное перемешивание). Карточки тасуются перед началом тренировки, и каждый новый круг закрепляет визуальный образ знака независимо от контекста.

Карточки кандзи (JLPT N5) и война с дизерингом

Для иероглифов карточка устроена глубже:

Полноэкранная карточка кандзи N5

Полноэкранная карточка кандзи N5

На экран выводятся:

  • Крупный иероглиф;

  • Онъёми (китайские чтения) катаканой;

  • Кунъёми (японские чтения) хираганой;

  • Число черт, базовый ключ (радикал) и индекс частотности;

  • Перевод значения (на русском и английском);

  • Блок частых составных слов с фуриганой и переводом.

И здесь я столкнулся с главной особенностью E-Ink дисплеев — шахматным дизерингом.

В типовых библиотеках серый фон плашек часто рисуют через полутона. Но в монохромных дисплеях без промежуточных аппаратных градаций серый эмулируется чередованием черных и белых точек. Когда поверх такой сетки выводится мелкий шрифт (10–12 pt) со сложными чертами иероглифов, они начинают сливаться с фоновыми точками. Картинка становится грязной, штрихи ломаются, а глаза моментально устают.

Я полностью отказался от дизеринга в информационных блоках: сделал фон кристально белым, а разделение оформил строгими одинарными векторными контурами с увеличенными отступами. Контрастность взлетела моментально: на электронных чернилах тонкие шрифты читаются идеально только при абсолютной бинарности черного и белого.

Интерактивные викторины (Kana Quiz & Kanji Quiz)

Когда пассивное перелистывание карточек надоедает, можно включить режим проверки знаний:

Интерактивный квиз по кандзи

Интерактивный квиз по кандзи
  • На экран выводится случайный вопрос (символ каны или иероглиф) и 4 варианта ответа.

  • Встроенный генератор дистракторов автоматически подбирает правдоподобные варианты из базы, чтобы тест не был тривиальным.

  • Мгновенная обратная связь: при выборе ответа система рисует четкую векторную галочку ✔ для правильного варианта или крестик ✖ при ошибке.

  • В углу экрана тикает общий счет серии (Score: 8 / 10), добавляя соревновательный интерес к каждой сессии.


3. Карманный Anki: алгоритм SM-2 и свои колоды с карты памяти

Флешкарты в фиксированной базе — это хорошо, но для серьезного изучения языка необходим метод интервальных повторений (Spaced Repetition System). Всем знаком Anki, но держать его на телефоне — значит постоянно бороться с искушением переключиться на соцсети.

В JPink я встроил автономный модуль Anki Spaced Repetition:

Карточка Anki с алгоритмом SM-2

Карточка Anki с алгоритмом SM-2

Честный алгоритм SM-2 под капотом

Это не просто таймер, а полноценный математический алгоритм SuperMemo-2:

  1. Каждая карточка хранит свои параметры: число успешных повторений (reps), текущий интервал в днях (intervalDays), фактор легкости (easeFactor, от 1.30 до 2.50) и количество забываний (lapses).

  2. При ответе пользователю доступны 4 классические градации:

    • [1] Again (Снова): карточка сбрасывается в начало, интервал обнуляется, а сама карточка автоматически отправляется в хвост текущей очереди тренировки, чтобы вы обязательно повторили её еще раз до окончания сессии;

    • [2] Hard (Трудно): интервал увеличивается с пониженным коэффициентом, Ease Factor снижается;

    • [3] Good (Хорошо): классический шаг по алгоритму SM-2 (1 день → 3 дня → интервал × фактор легкости);

    • [4] Easy (Легко): интервал увеличивается с бонусным множителем, Ease Factor повышается.

Загрузка любых собственных колод с microSD

Никаких регистраций в облаках, серверов и сложной синхронизации:

  1. В настольном приложении Anki на ПК выбираем Файл → Экспорт и сохраняем колоду как текстовый файл с разделителями-табуляциями (TSV / TXT).

  2. Закидываем файл на microSD карточку читалки в папку /anki/.

  3. Читалка автоматически парсит поля: Фронт [Tab] Бэк [Tab] Чтение/Фуригана [Tab] Пример или контекст.

В конце сессии вас ждет экран статистики с количеством повторенных слов, процентом правильных ответов и значком успешного завершения дня.


4. Часы без интернета и батарейки RTC

Мини-читалка ценится своей независимостью от розетки и сети. Но у чипа ESP32-C3 нет встроенной энергонезависимой батарейки для RTC: пока подключен аккумулятор, системный счетчик времени тикает, но при глубоком разряде или перезагрузке часы сбрасывались в 1 января 1970 года.

В оригинальной прошивке время предлагалось синхронизировать исключительно по Wi-Fi через SNTP. Но если вы достали читалку в самолете или в метро, раздавать интернет со смартфона только ради того, чтобы увидеть дату в календаре, крайне неудобно.

Я добавил прямое ручное управление временем:

Интерактивный календарь на E-Ink

Интерактивный календарь на E-Ink

В разделе Settings → System → Clock появился пункт «Установить время вручную». Простой и надежный интерфейс позволяет кнопками настроить часы, минуты, день и год. Встроенный календарь с подсветкой текущей даты и возможностью листать месяцы и годы становится полностью автономным. А если вы позже подключитесь к домашней сети — часы тихо и незаметно подкорректируют секунды по эталонным серверам времени.


5. Эстетика интерфейса Lyra и умный сон

В оригинальном CrossPoint главное меню представляло собой вертикальный список. Для чистой книжной читалки этого хватало, но с появлением японского блока, Anki, календаря и новостей меню стало слишком тесным.

Я интегрировал современную тему Lyra:

Главное меню Lyra

Главное меню Lyra
  • В левой части — компактная и наглядная вертикальная карусель разделов со статусным каомодзи заряда батареи ((^_^));

  • В правой части — крупная карточка текущей книги с обложкой в стиле ар-деко, процентом прочитанного и быстрым возвратом к чтению в один клик.

А при долгом нажатии кнопки «Назад» или по таймауту бездействия мини-читалка уходит в глубокий сон с минимальным энергопотреблением. Для режима сна в прошивке предусмотрено несколько художественных заставок.

Вот два самых любимых варианта:

Ночной экран сна

Ночной экран сна

Первый — минималистичный ночной экран: спящая книжка с милым каомодзи (-.-)zzZ, звезды, полумесяц и статус SLEEPING.

Экран сна Книжная полка

Экран сна Книжная полка

Второй — уютная заставка «Книжная полка»: деревянные стеллажи с книгами, стопка томов с закладкой-ленточкой, чашка горячего дымящегося кофе, цветок в горшке и надпись «Время для историй (-.-)zzZ».

Электронные чернила сохраняют эту картинку неделями без расхода аккумулятора, так что читалка на столе выглядит как эстетичный декоративный аксессуар.


6. Локальная отладка: собственный эмулятор xteink-emulator

Разрабатывать и выравнивать интерфейс под каждый пиксель на реальном «железе» — процесс долгий: компиляция под ESP32, заливка по проводу, физическая задержка перерисовки жидких чернил. А фотографии экрана на камеру смартфона неизбежно страдают от бликов и муара.

Для быстрой разработки и тестирования я написал собственный инструмент — открытый десктопный эмулятор и тестовый стенд xteink-emulator.

Он заменяет аппаратный уровень абстракции (HAL) на десктопные компоненты поверх SDL2 и C++20:

  • Виртуальный E-Ink экран: точная эмуляция контроллеров дисплеев (SSD1677, UC8179, UC8279, UC8253, ED2208) с режимами обновления и честным 1-битным монохромом;

  • Управление: полная раскладка физических кнопок устройства на клавиатуре (D-Pad, Confirm, Back, Power, Sleep) и сенсорный экран мышью;

  • Виртуальная SD-карта: эмулятор напрямую монтирует локальную директорию fs_ с книгами, шрифтами и карточками;

  • Утилита автоматизации emulator.py: валидирует файлы локализации (check), автоматически собирает нативный бинарник под Linux/WSL (build) и запускает ридер в окне (run).

# Проверить, собрать и запустить прошивку на ПК в одну команду:python3 emulator.py all /path/to/JPink

Благодаря эмулятору можно за доли секунды проверять верстку любых экранов и сохранять идеальные скриншоты 480×800 прямо из кадрового буфера виртуального дисплея без искажений и камеры телефона.


Что получилось в итоге

Форк превратил мини-читалку на ESP32 из простого ридера в удобный автономный микрокомпьютер:

  • Интерактивная таблица каны 5×10 с транскрипцией по Поливанову и этимологией;

  • Полноценные режимы тренировок: флешкарты с перемешиванием (Shuffle), викторины с мгновенной проверкой и детальные карточки кандзи без графической грязи;

  • Карманный Anki с алгоритмом SM-2 и легким импортом собственных колод через microSD;

  • Автономные часы и календарь без привязки к интернету;

  • Современный интерфейс Lyra и эстетичный ночной экран сна;

  • Собственный десктопный эмулятор для быстрой разработки и тестирования на ПК.

Исходный код проектов открыт на GitHub:
👉 Прошивка JPink: https://github.com/MrProLopstar/JPink
👉 Десктопный эмулятор xteink-emulator: https://github.com/MrProLopstar/xteink-emulator

Если у вас есть компактная читалка на ESP32 — попробуйте залить JPink и использовать её для чтения и быстрого повторения языка в дороге.

Если проект вам приглянулся — буду очень благодарен за вашу звёздочку ⭐ на GitHub! Звёзды здорово помогают открытым проектам находить свою аудиторию и мотивируют автора двигаться дальше.

И конечно, очень жду ваши отзывы, предложения и отчёты об ошибках (в комментариях к статье или в GitHub Issues) — любая обратная связь бесценна, чтобы отполировать каждую мелочь и довести проект до идеала!

ссылка на оригинал статьи https://habr.com/ru/articles/1109626/