MeshCore Smart UI nRF52

Неофициальная русскоязычная прошивка MeshCore Companion с компактным экранным интерфейсом для трёх nRF52840-плат:

• Heltec T096 с включённым FEM/LNA;
• Heltec T114 с цветным TFT;
• ProMicro nRF52840 + Heltec RA62 + OLED 128×64.

В v2.0.0-rc1 страница версии показывает T096 SmartUI 2.0.0-rc1, T114 SmartUI 2.0.0-rc1 или ProMicro SmartUI 2.0.0-rc1.

Открыть проект на GitHub

Это независимая модификация. Она не является официальным выпуском MeshCore или IoTThinks. Порт закреплён на коммите a3b9ad91 ветки PowerSaving-v17 проекта IoTThinks/MeshCore. Это major-миграция с прежней PS16-линии; RC пока не проходил аппаратные испытания.

Исходный код находится в ветке smartui-ps17.1. Сравнение с закреплённой базой показывает только изменения SmartUI: a3b9ad91...smartui-ps17.1.

Что умеет интерфейс

• Часы, сеть, чат, непрочитанные ЛС, анонс, настройки и выключение без пустых страниц.
• Русский компактный UI, понятные статусы и аккуратное сокращение длинных строк через ....
• Экранная клавиатура в быстрых ответах.
• Адресная отправка набранного сообщения в известный чат или companion-контакту; ретрансляторы из списка контактов исключены.
• Окно непрочитанных показывает только личные сообщения, сгруппированные по отправителям.
• Одна общая мелодия важных уведомлений; серия ограничена двумя проигрываниями.
• Ночной запрос тишины в 23:30 с отключением звука до 07:30.
• Выбор шрифта и темы отдельными списками.
• Аппаратный GPS на T096/T114 с понятными состояниями GPS ON/OFF; на ProMicro GPS скрыт.
• Исправлен выход ProMicro из сна: первое нажатие будит OLED без обязательного Reset.

Поддерживаемые платы

Плата	Дисплей	GPS в этой цели	Файл релиза
Heltec T096 FEM ON	TFT 160×80	Аппаратный	T096_FEM_SmartUI_v2.0.0-rc1.uf2
Heltec T114 с дисплеем	ST7789 240×135	Аппаратный	T114_SmartUI_v2.0.0-rc1.uf2
ProMicro nRF52840 + Heltec RA62	SSD1306 OLED 128×64	Нет	ProMicro_RA62_SmartUI_v2.0.0-rc1.uf2

Это не прошивка для FakeTec/HT-RA62, Heltec V3/V4, T114 без дисплея или произвольной ProMicro-распайки. Подробности: поддерживаемое оборудование.

Быстрый старт

v2.0.0-rc1 является предварительным выпуском. Берите UF2 и SHA256SUMS.txt только из одного релиза v2.0.0-rc1.

1. Откройте GitHub Releases и скачайте UF2 строго для своей платы.
2. Скачайте из того же GitHub Release файл SHA256SUMS.txt и проверьте SHA-256.
3. Подключите плату исправным USB-кабелем с передачей данных.
4. Переведите её в UF2-загрузчик быстрым двойным нажатием физической кнопки Reset.
5. Скопируйте UF2 на появившийся USB-диск и дождитесь автоматической перезагрузки.
6. Подключитесь из совместимого MeshCore-клиента. Если запрошен BLE PIN, используйте шестизначный код, показанный нодой.

Полная инструкция: прошивка и проверка SHA-256.

Управление одной кнопкой

Действие	Результат
Один щелчок	Следующий экран или пункт
Двойной щелчок	Предыдущий экран или пункт
Долгое нажатие	Выбрать / открыть / подтвердить
Долгое нажатие на часах	Включить или выключить тишину
Тройной щелчок	Вернуться на главный экран

Если дисплей погас, первое нажатие может только разбудить его. В первые 8 секунд после старта долгое нажатие включает CLI Rescue, а не выбирает пункт. Полная карта: управление.

Сборка из исходников

Установите PlatformIO, откройте корень репозитория и выполните нужную команду:

pio run -e Heltec_t096_companion_radio_ble_femon -t create_uf2
pio run -e Heltec_t114_companion_radio_ble -t create_uf2
pio run -e ProMicro_ra62_companion_radio_ble -t create_uf2

Готовые файлы появятся в .pio/build/<environment>/firmware.uf2. Подробная воспроизводимая процедура: сборка.

Важные предупреждения

• Свежие настройки используют радиопрофиль 869.618 MHz / BW 62.5 kHz / SF8 / CR5. Это не означает, что профиль разрешён в вашей стране.
• T096 работает с внешним FEM; не передавайте без подходящей антенны и не повышайте мощность без измерений.
• Импорт и экспорт приватного ключа включены на уровне companion-протокола. Никому не отправляйте экспортированный ключ и не добавляйте его в Git.
• Phone GPS намеренно не поддерживается: телефон не отдаёт координаты ноде без отдельного приложения или сервиса.
• Обычная прошивка может сохранить старые настройки ноды. Перед обновлением сохраните идентичность безопасным способом и проверьте радиопараметры после запуска.

Подробнее: безопасность и радио.

Проверки и статус RC

Финальная локальная проверка от 2026-08-21:

• три целевых PlatformIO environment: 3 / 3 SUCCESS;
• статический контракт: 31 PASS / 0 FAIL;
• точная framebuffer-симуляция: 455 PASS / 0 FAIL;
• структурная проверка UF2: 3 PASS / 0 FAIL.

Плата	RAM	Flash
T096 FEM ON	63,7%	77,8%
T114	64,3%	78,0%
ProMicro RA62	62,8%	93,2%

Read-only CI повторяет сборку, native-тесты, UI QA и проверку UF2. T096 симулируется с реальными bitmap-метриками, T114 — через фактическое логическое масштабирование 128×64 → 240×135, ProMicro — по таблицам OLED 128×64. Приложенные изображения сгенерированы для визуального контракта PS17-порта. Они не подтверждают работу на железе; отдельная аппаратная проверка v2.0.0-rc1 не заявляется.

Документация

• Полное описание проекта
• Поддерживаемые платы
• Управление
• Экраны, меню, шрифты и симуляции
• Прошивка готового UF2
• Сборка из исходников
• Проверка SHA-256
• Безопасность и радиопараметры
• История изменений
• Примечания к v2.0.0-rc1

Лицензии и авторство

MeshCore и эта производная работа распространяются по лицензии MIT; исходное уведомление Scott Powell / rippleradios.com сохранено в LICENSE. Встроенные растровые варианты шрифтов созданы из Roboto Condensed под Apache License 2.0 и четырёх гарнитур под SIL Open Font License 1.1. Полный список и ссылки на тексты лицензий находятся в THIRD_PARTY_NOTICES.md.