Smart UI 0.13

Smart UI 0.13 — выбираем город, настраиваем ноду

В этом выпуске обновили USB-помощник. Теперь меньше ручного ввода: подключили ноду, выбрали свой город, проверили параметры и применили. Автоанонс тоже можно настроить с компьютера — ровно так же, как в меню ноды.

Добавили Heltec V4 R8 OLED

В этой же 0.13 появилась отдельная сборка для WiFi LoRa 32 V4-R8 с OLED 128×64: ESP32-S3R8, 8 МБ PSRAM, 16 МБ flash. Это не переименованная прошивка обычной V4.3: у R8 другие выводы питания, LED и GPS и другой режим PSRAM. Сборка для цветного TFT в этот комплект не входит.

Сохранены общий SmartUI, пять OLED-шрифтов, клавиатура, Bluetooth/USB/Wi-Fi, ADC, GPS и FEM/LNA. Выключатель LED учитывается и при передаче радио; гашение экрана не отключает общий источник питания радиотракта. Помощник различает обычную V4.3 и R8 при проверке файла. Для R8 скачайте обновлённый Helper 1.6 из этого же выпуска.

На плату R8 нужны только файлы Heltec_V4_R8_UI_0.13-*. Файлы Heltec_V4.3_UI_0.13-* остаются для прежнего OLED-профиля R2. Первичная установка после другой прошивки требует проверки разметки; merged удаляет данные. Ранее опубликованной SmartUI 0.12 для R8 нет. Аппаратные особенности и источники.

Исправление от 7 октября

На ProMicro помощник мог отклонять правильный городской пресет с сообщением «Недопустимое значение настройки». Причина оказалась в округлении полосы радио внутри прошивки, а не в частоте города: при оптимизации сборки 62.5 превращалось в 62.5000038 и не проходило слишком строгую проверку.

Исправили преобразование полосы и частоты и для помощника, и для обычного приложения. Поддерживаемая полоса теперь передаётся радиочипу точным значением; частота на границе диапазона не отклоняется из-за округления. Неподдерживаемые значения по-прежнему отклоняются. Сохранённые настройки полосы с микроскопической погрешностью округления также принимаются корректно. Добавили проверки с оптимизацией -Ofast, используемой сборками nRF52.

Это обновление той же 0.13. Если уже скачивали её — скачайте файл своей платы заново и обновите поверх, без очистки памяти. Версия помощника остаётся 1.6; исправление пресетов находится в прошивке. Все семь плат пересобраны из одного исправленного commit, указанного в манифесте. Программное воспроизведение ошибки и проверки исправления не заменяют проверку на вашей физической плате.

Что добавили

1. Городские пресеты MeshCoreTel. Поиск города и просмотр частоты, полосы, SF и CR. Источник — публичные данные MeshCoreTel. Каталог встроен в помощник и работает без интернета; дата снимка показана рядом. Города без подтверждённых параметров не получают выдуманный пресет.
2. Применение пресета одной командой. Четыре параметра меняются вместе, после подтверждения. Мощность передачи, ретрансляция и длина хэша пути остаются прежними. При несовместимой включённой ретрансляции настройка отклоняется с пояснением, а не меняет её молча. После ответа помощник перечитывает состояние ноды.
3. Автоанонс как на самой ноде. Выключить либо выбрать интервал: 15 минут, 30 минут, 1 час, 2 часа или 3 часа. Используется существующая настройка прошивки: после отключения компьютера нода продолжает работать сама.
4. USB Helper 1.6. Переработали внешний вид и расположение элементов. Понятные разделы, поиск города, крупные кнопки, состояние подключения и результат сохранения. Сохранены звук, мелодии, ADC, LED, GPS, FEM, AGC и настройка Wi-Fi — по возможностям платы.
5. Команды для разработчиков. Локальный CLI из 0.12 расширен чтением и настройкой радио и автоанонса. Те же обработчики используются USB-консолью; второй независимой копии настроек нет. Документация.

Как пользоваться

1. Обновите ноду до 0.13. Скачайте SmartUI_USB_Helper_1.6.html или ZIP помощника. HTML открывается в браузере, его не нужно прошивать.
2. Откройте HTML в Chrome или Edge на компьютере. Нужен USB-кабель с передачей данных. Закройте флешер и другие программы, занявшие COM-порт; V3 и Paper разбудите кнопкой.
3. Если в меню ноды выбран Bluetooth или Wi-Fi, выберите в помощнике «Настройки (консоль)». Если выбран USB-компаньон — «Настройки (USB-компаньон)». В обоих случаях помощник подключается USB-кабелем.
4. Подключитесь и дождитесь чтения настроек. В разделе радио найдите город. Сверьте показанные параметры с местным сообществом, нажмите применение и подтвердите.
5. В настройке автоанонса выберите нужный интервал и сохраните. Значение должно совпасть с тем, которое помощник прочитал обратно из ноды.
6. При ошибке сохранения или обрыве перечитайте состояние после переподключения. Запись автоматически не повторяется: потерянный ответ не означает, что нода ничего не сохранила.

Полная инструкция помощника. Новые функции требуют 0.13; на прежней прошивке помощник объяснит отсутствие поддержки, а не покажет ложный успех.

Важно про пресеты

Это снимок данных MeshCoreTel на дату сборки каталога, не живая подписка. Помощник не отправляет данные ноды на сайт и не меняет частоту при подключении сам. Если город позже сменил параметры, старый HTML не узнает об этом автоматически.

На MeshCoreTel настройки выбираются по данным наблюдателей. Отсутствие наблюдателей или достоверного набора параметров — не повод подставлять настройки соседнего города. Частота, аппаратный диапазон, разрешённая мощность и правила использования остаются ответственностью владельца. Наличие пресета не означает разрешение на передачу.

Что не меняли

1. База — MeshCore 1.17.1 / PowerSaving, основной companion-протокол — 13. Локальный CLI: CMD66/RESP29, обнаружение smartui_cli:1. Удалённого управления через LoRa не добавляли.
2. Старый API 0xC9, события и синхронизация прочтения остаются в архивной 0.11. Локальные сообщения и напоминания ноды сохранены.
3. Приватная ветка не менялась. Повреждение памяти этот выпуск не объявляет исправленным; защита «только для чтения» остаётся.
4. Wi-Fi/TCP работает в доверенной локальной сети на порту 5000 без отдельного пароля и TLS. Не открывайте порт в Интернет. Реквизиты Wi-Fi меняются через BLE/USB, не через изменяемое TCP-подключение.

Какой файл скачать

1. T096 FEM ON — T096_UI_0.13.uf2.
2. T114 — T114_UI_0.13.uf2.
3. ProMicro nRF52840 + Heltec RA62 — ProMicro_RA62_UI_0.13.uf2.
4. Heltec V3 OLED — Heltec_V3_UI_0.13-update.bin или Heltec_V3_UI_0.13-merged.bin.
5. Heltec V4.3 OLED FEM ON — Heltec_V4.3_UI_0.13-update.bin или Heltec_V4.3_UI_0.13-merged.bin.
6. Heltec Wireless Paper — Paper_UI_0.13-update.bin или Paper_UI_0.13-merged.bin.
7. Heltec V4 R8 OLED FEM ON — Heltec_V4_R8_UI_0.13-update.bin или Heltec_V4_R8_UI_0.13-merged.bin.
8. Всё вместе — SmartUI_0.13_all-boards.zip. Отдельно доступны Helper 1.6 и Developer Kit 0.13.

Обновление без очистки: nRF52 — UF2 своей платы поверх через загрузчик; ESP32 — update.bin по 0x10000 при совместимой разметке. FLASH_ERASE для этого выпуска не требуется.

Любой ESP32 merged.bin по 0x0 — чистая установка: он заменяет identity, контакты и настройки даже без Erase. Не используйте merged для обычного обновления работающей ноды.

Всего 19 файлов: одиннадцать образов для семи плат, HTML и ZIP помощника, Developer Kit, примечания, две таблицы SHA-256, манифест и общий архив. Исходный commit и хеши образов указаны в RELEASE-MANIFEST.json.

Проверки и ограничения

Публикация проходит общий CI: семь сборок, совместимость общих драйверов, проверки образов и комплектов из одного commit. Новые проверки охватывают валидацию пресетов, радио и автоанонс, отказ сохранения, повторное чтение, старые прошивки и интерфейс помощника в настольном и мобильном Chromium. Для R8 дополнительно проверяются аппаратный профиль, формат памяти, защита от выбора файла R2 и общий компактный OLED-renderer.

Это программные проверки и имитация USB, не испытание всех физических плат. R8 на физической плате не проверена. Связь с реальной городской сетью, конкретный радиотракт и аппаратная стабильность не подтверждаются симуляцией. Для прежних шести плат сохранён предыдущий 0.12; для R8 его файлы не подходят.