Мини-читалка 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).
-
Переключение в один клик: кнопка переворота мгновенно переключает всю таблицу между Хираганой и Катаканой.
-
Удобная навигация: джойстик или клавиши со стрелками перемещают фокусную рамку по ячейкам таблицы.
-
Информационная карточка сверху: при наведении на любой слог верхняя панель крупно показывает:
-
Четкий увеличенный символ в 36 pt;
-
Транскрипцию по системе Хэпбёрна (латинский ромадзи);
-
Транскрипцию по системе Поливанова (академическая русская кириллица: си, а не ши; ти, а не чи; цу, а не тсу);
-
Манъёгана (исторический кандзи-предок): иероглиф, из скорописи которого в древности родился этот знак (например,
安 → あ,以 → い,宇 → う,衣 → え,於 → お,加 → か).
-
Всё рассчитывается и масштабируется прямо на лету, без задержек и без необходимости лезть в онлайн-справочники.
2. Виды тренировок: карточки, перемешивание и квизы
Запомнить таблицу — полдела, знаки нужно довести до автоматизма. Для этого в JPink заложено три разных типа тренировок:
Режим флешкарт (Flashcards) с перемешиванием
Для хираганы, катаканы и иероглифов базового уровня JLPT N5 есть классический режим карточек. По центру выводится крупный символ, по нажатию клавиши «ОК» карточка переворачивается и показывает чтение, перевод и подсказку.
Чтобы мозг не запоминал символы по порядку их следования в алфавите, предусмотрен режим Shuffle (случайное перемешивание). Карточки тасуются перед началом тренировки, и каждый новый круг закрепляет визуальный образ знака независимо от контекста.
Карточки кандзи (JLPT 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Честный алгоритм SM-2 под капотом
Это не просто таймер, а полноценный математический алгоритм SuperMemo-2:
-
Каждая карточка хранит свои параметры: число успешных повторений (
reps), текущий интервал в днях (intervalDays), фактор легкости (easeFactor, от 1.30 до 2.50) и количество забываний (lapses). -
При ответе пользователю доступны 4 классические градации:
-
[1] Again (Снова): карточка сбрасывается в начало, интервал обнуляется, а сама карточка автоматически отправляется в хвост текущей очереди тренировки, чтобы вы обязательно повторили её еще раз до окончания сессии;
-
[2] Hard (Трудно): интервал увеличивается с пониженным коэффициентом, Ease Factor снижается;
-
[3] Good (Хорошо): классический шаг по алгоритму SM-2 (1 день → 3 дня → интервал × фактор легкости);
-
[4] Easy (Легко): интервал увеличивается с бонусным множителем, Ease Factor повышается.
-
Загрузка любых собственных колод с microSD
Никаких регистраций в облаках, серверов и сложной синхронизации:
-
В настольном приложении Anki на ПК выбираем
Файл → Экспорти сохраняем колоду как текстовый файл с разделителями-табуляциями (TSV / TXT). -
Закидываем файл на microSD карточку читалки в папку
/anki/. -
Читалка автоматически парсит поля:
Фронт [Tab] Бэк [Tab] Чтение/Фуригана [Tab] Пример или контекст.
В конце сессии вас ждет экран статистики с количеством повторенных слов, процентом правильных ответов и значком успешного завершения дня.
4. Часы без интернета и батарейки RTC
Мини-читалка ценится своей независимостью от розетки и сети. Но у чипа ESP32-C3 нет встроенной энергонезависимой батарейки для RTC: пока подключен аккумулятор, системный счетчик времени тикает, но при глубоком разряде или перезагрузке часы сбрасывались в 1 января 1970 года.
В оригинальной прошивке время предлагалось синхронизировать исключительно по Wi-Fi через SNTP. Но если вы достали читалку в самолете или в метро, раздавать интернет со смартфона только ради того, чтобы увидеть дату в календаре, крайне неудобно.
Я добавил прямое ручное управление временем:
Интерактивный календарь на E-Ink
В разделе Settings → System → Clock появился пункт «Установить время вручную». Простой и надежный интерфейс позволяет кнопками настроить часы, минуты, день и год. Встроенный календарь с подсветкой текущей даты и возможностью листать месяцы и годы становится полностью автономным. А если вы позже подключитесь к домашней сети — часы тихо и незаметно подкорректируют секунды по эталонным серверам времени.
5. Эстетика интерфейса Lyra и умный сон
В оригинальном CrossPoint главное меню представляло собой вертикальный список. Для чистой книжной читалки этого хватало, но с появлением японского блока, Anki, календаря и новостей меню стало слишком тесным.
Я интегрировал современную тему 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) — любая обратная связь бесценна, чтобы отполировать каждую мелочь и довести проект до идеала!
Источник: habr.com