Smart UI 0.09

Smart UI 0.09 — дополнительный AGC-сброс радиоприёмника

Публичный выпуск SmartUI 0.09 для тех же шести плат. В меню «Система» появился необязательный AGC-сброс — периодическая перекалибровка радиоприёмника. По умолчанию он выключен. Настройки через USB из 0.08 и USB-помощник 1.3 сохранены; приватная линия этим выпуском не обновляется.

Что изменилось

1. Новый пункт «AGC-сброс». AGC — автоматическая регулировка усиления приёмника. Функцию можно включить для пробной профилактики проблем с приёмом. Это не доказанное исправление зависаний или потери связи.
2. Выбор остаётся за пользователем. По умолчанию — ВЫКЛ, в том числе при переходе со старых настроек без этого параметра. Обычное обновление не требует включать AGC. Выбранное состояние сохраняется; при ошибке записи остаётся прежнее значение.
3. Интервал — 60 секунд, с отсрочкой по активности. После включения первая попытка планируется не раньше чем через минуту. Следующие попытки также разделены минимум минутой. Если идёт приём, передача или ожидание ответа, операция откладывается: это не жёсткое расписание «каждую минуту любой ценой».
4. Перезапуска ноды нет. Контакты, сообщения и настройки не сбрасываются. Работа выполняется короткими этапами; предусмотрены отмена и обработка ошибок. При самой перекалибровке есть короткое окно без приёма, поэтому полностью незаметной для радиосвязи операция не считается.
5. Исправлен выявленный по коду сценарий сохранения при нехватке места. Для случая, когда во внутреннем хранилище не помещаются сразу три копии настроек, добавлена одна повторная попытка. Перед ней прошивка проверяет чтение и синтаксис основного файла, а также наличие необходимых разделов, затем может удалить только старую резервную копию prefs.json.bak. Новый временный файл проверяется до замены основного. Форматирования нет; контакты и ключи эта процедура не удаляет.
6. Ошибки сохранения стали понятнее. При переключении AGC показывается короткий код этапа, на котором запись не удалась. Это не диагноз «память повреждена» или «место закончилось». Расшифровка — в инструкции управления.

Как включить или выключить

1. На ноде откройте Настройки → Система → AGC-сброс.
2. Один короткий щелчок листает пункты. Долгое нажатие переключает ВКЛ/ВЫКЛ и сохраняет выбор.
3. При включении появится сообщение AGC: ВКЛ, 60 с. Оно подтверждает выбранную настройку, а не улучшение связи.
4. Если не хотите использовать эту функцию, оставьте или верните ВЫКЛ. В сборках без поддержки соответствующего радиомодуля пункт скрыт.

В USB-помощнике 1.3 отдельного переключателя AGC нет: новый пункт находится в экранном меню ноды.

Как пользоваться USB-помощником

На ноде выберите Bluetooth, а к компьютеру подключите её USB-кабелем. Телефон и сопряжение Bluetooth не нужны. Bluetooth здесь — режим работы ноды; сам помощник общается по кабелю. USB-компаньон — другой режим, в нём помощник недоступен. Wi-Fi тоже подходит для плат, где он поддерживается.

1. Скачайте SmartUI_USB_Helper_1.3.html или распакуйте одноимённый ZIP. Откройте HTML в Google Chrome или Microsoft Edge на компьютере. Это страница помощника, не файл прошивки.
2. На экране ноды выберите Настройки → Подключение → Bluetooth. Подключите кабель с передачей данных. Закройте флешер, терминал и другие программы, занявшие COM-порт. Heltec V3 и Wireless Paper сначала разбудите кнопкой.
3. Нажмите Выбрать USB-порт, выберите ноду в окне браузера и дождитесь Консоль SmartUI подключена. Сам выбор порта ещё не означает, что соединение установлено.
4. Настройки прочитаются автоматически. Для повторного чтения есть кнопка Прочитать настройки. Меняйте нужное поле и нажимайте его отдельную кнопку Сохранить.
5. Если экран отсутствует, а нода работает USB-компаньоном: в 0.08 и 0.09 перезапустите её, затем сразу после запуска прошивки выполните долгое нажатие пользовательской кнопки — оно должно сработать в первые 8 секунд. Нода перейдёт в Bluetooth, если сохранение прошло успешно. Не удерживайте ESP BOOT во время перезапуска: это вход в загрузчик. Если Bluetooth уже выбран, этот шаг не нужен.

Калибровка аккумулятора, звук, общая мелодия, LED, GPS и защита АКБ работают как в 0.08, в пределах возможностей сборки. Полная инструкция помощника.

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

1. T096 FEM ON: T096_UI_0.09.uf2.
2. T114: T114_UI_0.09.uf2.
3. ProMicro RA62: ProMicro_RA62_UI_0.09.uf2.
4. Heltec V3 OLED: Heltec_V3_UI_0.09-update.bin или Heltec_V3_UI_0.09-merged.bin.
5. Heltec V4.3 OLED FEM ON: Heltec_V4.3_UI_0.09-update.bin или Heltec_V4.3_UI_0.09-merged.bin.
6. Wireless Paper: Paper_UI_0.09-update.bin или Paper_UI_0.09-merged.bin.
7. Весь комплект: SmartUI_0.09_all-boards.zip. Помощник: SmartUI_USB_Helper_1.3.html или SmartUI_USB_Helper_1.3.zip. Контрольные суммы и RELEASE-MANIFEST.json берите из этого же выпуска.

Обновление без очистки

1. T096, T114 и ProMicro: скопируйте UF2 своей платы на диск загрузчика. Отдельный Erase не нужен. Не стирайте данные только ради обновления или включения AGC.
2. Работающие V3, V4.3 и Paper обновляйте через update.bin по адресу 0x10000, без Erase, с совместимыми загрузчиком и таблицей разделов.
3. merged.bin — чистая установка по адресу 0x0. Он заменяет identity, контакты и настройки даже без Erase. Сначала сохраните нужные данные. Для включения AGC чистая установка не требуется.

Что проверяется, а что ещё требует устройства

1. Программные тесты исполняют код таймера, сохранения настройки и поэтапной работы с радио с имитацией времени и аппаратных ошибок. Проверяются состояние ВЫКЛ по умолчанию, ожидание передачи и ответа, отмена, сохранение параметров радио и восстановление после ошибок.
2. Экранные проверки используют реальные таблицы шрифтов и проверяют подпись, оба состояния переключателя и размещение на шести публичных профилях. Сборка прошивки и программные изображения не заменяют испытание платы.
3. AGC физически не проверен. Его влияние на приём, потери пакетов, дальность, ток потребления и длительную стабильность не измерялось. Прежние зависания T096 и проблемы V4.3 не объявляются исправленными.
4. Проверки не обещают устранения всех пауз радио/BLE: в том числе полная отложенная запись контактов остаётся синхронной. Частотные ограничения и требования к безопасной прошивке сохранены.
5. Исправление сохранения рассчитано на конкретный сценарий нехватки места, найденный в коде; это не универсальное восстановление повреждённой файловой системы. То, что на отдельной ноде сохранение заработало после Erase, само по себе не доказывает причину прежнего сбоя.
6. На компьютере с реальной библиотекой LittleFS и хранилищем 28 КиБ в оперативной памяти воспроизведён отказ из-за нехватки места; освобождение старой копии и повторная запись прошли проверку. Это не испытание физической платы.

Предыдущий публичный Smart UI 0.08 остаётся для отката. Для отзыва укажите плату, полное имя файла, состояние AGC и действия, после которых заметили разницу. Сравнивайте ВКЛ/ВЫКЛ при одинаковых условиях.