Repository navigation
Smart UI 0.08
Smart UI 0.08 — настройки ноды через USB, даже без экрана
Публичный выпуск SmartUI 0.08 и USB-помощник 1.3. Теперь для калибровки батареи и основных настроек не нужно листать меню на маленьком дисплее. Подключите ноду USB-кабелем и откройте помощник на компьютере.
Важно: какой режим выбрать на ноде
Для USB-помощника выберите на ноде «Настройки → Подключение → Bluetooth». При этом помощник работает через USB-кабель. Телефон и сопряжение по Bluetooth не нужны.
Не выбирайте «USB» / «USB-компаньон» ради настройки через помощник. Этот режим нужен для подключения приложения MeshCore по кабелю. В нём помощник не получает ответов и не включает свои кнопки. Это два разных назначения одного USB-порта.
Что нового простыми словами
- Калибровка батареи. Помощник показывает напряжение, которое видит нода. Измерьте напряжение на аккумуляторе мультиметром, введите результат и посмотрите предложенную поправку. Она применяется только после отдельного подтверждения. Можно вернуть только заводскую калибровку — контакты и остальные настройки не стираются.
- Звук и уведомления. Через USB можно выбрать общую мелодию, громкость, включить или выключить звук и общий беззвучный режим. Кнопка проверки запускает уведомление с выбранными настройками. Проверка уважает беззвучный режим: сама его не отключает.
- Светодиоды и GPS. LED платы и LED уведомлений подписаны отдельно. GPS и вибрация доступны только там, где их поддерживает аппаратный профиль. Помощник не обещает зуммер или GPS на плате, на которой их нет; подключённый внешний модуль всё равно должен соответствовать распайке.
- Защита аккумулятора. Её можно настроить без экрана. По умолчанию — 3,2 В. При выключении защиты остаётся нижняя программная отсечка 2,7 В. Это не замена аппаратной защите аккумулятора.
- Без дисплея работа не заканчивается. При недоступном экране продолжают обслуживаться уведомления и проверка батареи. Уже включённая ночная тишина снимается утром при достоверном времени; отсутствие экрана больше не оставляет её включённой навсегда. Для сборки из исходников есть явные
SmartUI_*_headlessпрофили: они не запускают дисплей, но сохраняют необходимую фоновую логику. Это те же схемы шести плат, не универсальная прошивка для любого nRF52 или ESP32. - Обновлён USB-помощник. Понятные разделы, состояние подключения, доступность функций конкретной ноды и подтверждение сохранения. Настройка Wi-Fi, быстрые ответы и проверка файлов прошивки сохранены. Утилита работает локально, без сервера и отправки паролей в Интернет.
- Сохранение без ложного успеха. При ошибке записи изменение откатывается. Если связь оборвалась до ответа, помощник не заявляет, что всё сохранено: нужно переподключиться и перечитать состояние. Устаревшую калибровку повторно применить нельзя.
Исправления публичного 0.07 сохранены: отложенное сохранение маршрута контакта и понятный экран выключения Wireless Paper. Приватная линия этим выпуском не обновляется.
Как подключить помощник — по шагам
- Убедитесь, что на ноде установлена SmartUI 0.08. В 0.07 новых USB-настроек ещё нет. Если 0.08 уже установлена, повторно прошивать и очищать память не нужно.
- На ноде откройте Настройки → Подключение → Bluetooth и подтвердите выбор. Даже если будете пользоваться только USB-помощником, здесь нужен именно Bluetooth. Уже настроенный Wi-Fi тоже оставляет помощнику доступ к USB.
- Скачайте SmartUI_USB_Helper_1.3.html. Либо скачайте ZIP с инструкцией и снимками интерфейса и распакуйте его. HTML — это программа-помощник, не прошивка; загружать его в веб-флешер не надо.
- Откройте HTML-файл в Google Chrome или Microsoft Edge на компьютере. Ничего устанавливать и входить в аккаунт не нужно. Работа на телефоне не заявлена.
- Подключите ноду исправным USB-кабелем с передачей данных. На V3 и Wireless Paper сначала разбудите ноду коротким нажатием пользовательской кнопки.
- Закройте веб-флешер, другие помощники и программы, которые могут занимать порт ноды. Одновременно с одним портом работает только одна такая программа.
- В помощнике нажмите «Выбрать USB-порт». В окне браузера выберите свою ноду и подтвердите подключение. Номер может быть COM6, COM7 или другим — единого номера для всех нет.
- Дождитесь надписи «Консоль SmartUI подключена». Сам по себе выбранный COM-порт ещё не означает успешную связь. После подтверждения появятся версия, плата и доступные настройки.
Как менять настройки
- Прокрутите до блока «Настройки устройства». Значения считываются с ноды автоматически. Для повторного чтения нажмите «Прочитать настройки».
- Измените нужное поле и нажмите «Сохранить» рядом с ним. У каждого параметра своя кнопка; общая кнопка сохранения всей страницы не нужна.
- Дождитесь сообщения о сохранении. Помощник сначала получает подтверждение, затем читает значение обратно с ноды. Просто изменить поле — ещё не значит сохранить настройку.
- Для проверки звука и индикации нажмите «Проверить уведомление». Используются уже сохранённые настройки. Если включена общая тишина или выключен звук, помощник сам их не отключает.
- GPS, зуммер и вибрация доступны только при поддержке конкретной сборки и соответствующего оборудования. Отсутствие такого пункта не означает неисправность помощника.
- Для калибровки измерьте мультиметром напряжение на аккумуляторе, не 5 В USB. Введите, например,
4,12, нажмите «Рассчитать поправку», проверьте результат и отдельно подтвердите «Сохранить калибровку». Расчёт действует 60 секунд. Ошибочная калибровка влияет на показания батареи и защиту питания.
Выбрал порт, но ничего не работает
- Проверьте режим на ноде в первую очередь. Если там USB / USB-компаньон, смените его на Bluetooth. Обычное обновление прошивки сохраняет выбранный режим — повторная прошивка сама по себе эту ситуацию не исправит.
- Нажмите «Отключить», если кнопка доступна, затем обновите страницу помощника и снова выберите порт. При необходимости закройте остальные вкладки помощника и веб-флешера.
- Если написано «Порт открыт; консоль не подтверждена», долго висит «Выполняется операция…» или подключение заканчивается «Нода не подключена», обмен с прошивкой не подтверждён. Причина не обязательно в кабеле: проверьте режим, версию 0.08, помощник 1.3 и правильность выбранного порта.
- Если порт вообще не появляется, попробуйте другой кабель с передачей данных и USB-разъём. Кабель только для зарядки не подходит.
- На V3/Paper после долгого бездействия снова разбудите ноду кнопкой и повторите подключение.
- Если после этих шагов не заработало, пришлите модель платы, версию прошивки и снимок сообщения помощника. Стирать память для этой проверки не нужно.
Если у ноды нет дисплея
- Если выбран Bluetooth, просто подключайте помощник по USB. Специальный вход не нужен.
- Если сохранён USB-компаньон, в SmartUI 0.08 есть выход без экрана: перезапустите ноду и после запуска прошивки, в первые 8 секунд, выполните долгое нажатие пользовательской кнопки. При успешном сохранении включится Bluetooth, а USB освободится для помощника. Контакты и настройки не стираются.
- Нужна именно пользовательская кнопка UI, не Reset. На ProMicro это кнопка, подключённая по схеме целевого профиля; если её нет, этот способ входа недоступен.
- Не удерживайте BOOT на ESP32 во время перезапуска: так включается загрузчик. Для описанного входа нажимайте кнопку уже после запуска прошивки. Если сохранить смену режима не удалось, прежний USB-режим остаётся.
Полная инструкция USB-помощника. Старые прошивки поддерживают только прежние функции помощника; один HTML-файл не добавляет новые команды в прошивку.
Какой файл скачать
- T096 FEM ON:
T096_UI_0.08.uf2. - T114:
T114_UI_0.08.uf2. - ProMicro RA62:
ProMicro_RA62_UI_0.08.uf2. - Heltec V3 OLED:
Heltec_V3_UI_0.08-update.binилиHeltec_V3_UI_0.08-merged.bin. - Heltec V4.3 OLED FEM ON:
Heltec_V4.3_UI_0.08-update.binилиHeltec_V4.3_UI_0.08-merged.bin. - Wireless Paper:
Paper_UI_0.08-update.binилиPaper_UI_0.08-merged.bin. - Весь комплект:
SmartUI_0.08_all-boards.zip. Помощник:SmartUI_USB_Helper_1.3.htmlили одноимённый ZIP с инструкцией. Контрольные суммы иRELEASE-MANIFEST.jsonберите из этого же выпуска.
Обновление без очистки
- T096, T114 и ProMicro: скопируйте свой UF2 на диск загрузчика. Отдельный Erase не нужен.
- V3, V4.3 и Paper: для работающей ноды используйте
update.binпо адресу0x10000, без Erase, с совместимыми загрузчиком и таблицей разделов. merged.bin— только чистая установка по адресу0x0. Он заменяет identity, контакты и настройки даже без Erase. Сначала сохраните нужные данные.
Что проверяется, а что ещё требует устройства
- Публикация разрешена после сборки шести релизных профилей, проверки девяти образов и их принадлежности одному commit. Также выполняются сборки представителей без дисплея, native-тесты и прежние экранные симуляции с реальными таблицами шрифтов.
- Новые тесты исполняют C++-код настроек, калибровки и основного UI-цикла с отсутствующим экраном. Проверяются неверные значения, отказ сохранения, устаревшая калибровка, беззвучный режим и пороги батареи.
- USB-помощник проверяется в изолированном браузере с имитацией последовательного порта. Скриншоты — программные, не фотографии физических устройств.
- Тесты не измеряют реальный ток, громкость зуммера, точность делителя ADC или надёжность конкретной платы. Долгая аппаратная проверка всех шести плат не заявляется. Прежние зависания T096 и проблемы V4.3 не объявляются исправленными этим выпуском.
- Настройка через USB не добавляет экранные меню в официальное мобильное приложение и не меняет частотные ограничения публичной прошивки. Wi-Fi/TCP по-прежнему использует порт 5000 без отдельного TLS/пароля: только доверенная локальная сеть, без проброса в Интернет.
Предыдущий публичный Smart UI 0.07 сохранён для отката. В отзыве укажите плату, полное имя файла и последовательность действий.