Smart UI 0.14

Smart UI 0.14 — калибровка батареи без путаницы

Обновление текущего 0.14 от 7 октября

Теперь можно ввести известный коэффициент ADC напрямую. В USB Helper 1.8 выберите способ «Ввести коэффициент», укажите проверенное значение для своей платы и подтвердите сохранение. Помощник прочитает коэффициент обратно с ноды и только после совпадения покажет успех. Для этого способа не нужен опорный замер без USB; диапазон допустимых значений, проверка хранилища и запрет записи сохранены.

Способ «По мультиметру» остался. Результат расчёта, ошибки и подтверждение сохранения теперь находятся рядом с калибровкой, а не только в разделе подключения. Текущее сохранённое значение отделено от ещё не сохранённого расчёта. Сервисное окно остаётся дополнительной функцией, не обязательным шагом каждой калибровки.

Скачайте заново прошивку своей платы и Helper 1.8. Номер прошивки по-прежнему 0.14, но сборка обновлена: ранний 0.14 не знает команду прямого ввода. Помощник проверяет поддержку у ноды, а не угадывает её по номеру версии. Обновление UF2 или совместимого update.bin — без erase; merged.bin предназначен для чистой установки.

Если реальное напряжение аккумулятора низкое, сначала зарядите его. Не повышайте коэффициент только ради обхода защиты. Проверенный коэффициент одной платы не обязательно подходит другой.

Сервисное окно, добавленное в 0.14

Иногда нода показывает напряжение ниже настоящего: коэффициент ADC ещё не настроен или остался от прежней калибровки. Защита видит эти же неверные показания и может выключить ноду раньше, чем владелец успеет исправить коэффициент. В 0.14 добавили отдельный временный режим для такой настройки, а в USB Helper 1.8 — понятное управление им.

Это исправление сценария настройки, а не универсальное решение любых отключений. Если напряжение действительно низкое или есть аппаратная неисправность, нужна проверка питания. Порог 2,9 В в нашем текущем профиле не задан.

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

1. Кнопка сервисной калибровки в помощнике. Режим запускается только явно, после предупреждения. Он временно приостанавливает программное выключение по низкому показанию ADC, чтобы можно было сохранить правильную поправку.
2. Только при достоверно подтверждённом USB-питании и локальном USB-подключении. Одного соединения Bluetooth или Wi-Fi недостаточно. Ошибка определения питания не считается подтверждением USB. Если плата не умеет надёжно определить питание, режим недоступен; обычная калибровка остаётся.
3. Окно — до двух минут. Повторное нажатие не продлевает активный таймер. Режим завершается при отключении USB, завершении сеанса, истечении времени, ручной остановке или успешном сохранении/сбросе ADC. После перезагрузки он не включается сам. Постоянная настройка защиты не меняется.
4. Понятный статус в помощнике. Видно, включён ли режим и сколько времени осталось. Подключение, запуск режима и сохранение калибровки — разные действия; помощник не выдаёт расчёт за сохранённую настройку.
5. Сохранены все семь плат, включая отдельную Heltec V4 R8 OLED. Пресеты городов, автоанонс, звук, GPS, FEM, AGC и обычный интерфейс остаются.

Для 0.14 используйте USB Helper 1.8 из этого выпуска. Старый Helper 1.6 не понимает расширенный ответ возможностей в текстовой консоли и может не открыть настройки. Новый 1.8 поддерживает прежние 0.12–0.13; новое сервисное окно там просто недоступно.

В этом выпуске подтверждение USB для сервисного окна реализовано на nRF52840: ProMicro RA62, T096 и T114. Для V3/V4.3/V4 R8/Paper помощник не обещает такой режим без аппаратного подтверждения питания. Это не запрет обычной калибровки ADC на ESP32.

Как откалибровать ProMicro

1. Обновите ноду файлом ProMicro_RA62_UI_0.14.uf2 поверх, без FLASH_ERASE. Скачайте новый USB Helper 1.8 из этого выпуска.
   Если правильный коэффициент уже известен, выберите прямой ввод и сохраните его с подтверждением. Шаги получения опорного замера ниже нужны только для расчёта по мультиметру.
2. Измерьте напряжение непосредственно на аккумуляторе мультиметром. Если аккумулятор действительно сильно разряжен, сначала решите проблему питания; сервисное окно не делает разряженный или неисправный аккумулятор безопасным.
3. На ProMicro USB может искажать измерение ADC. Нужен свежий замер от аккумулятора: включите ноду от АКБ, дождитесь показания напряжения, затем подключите USB без перезапуска. Не ждите отключения ноды по защите. Если она уже подключена, кратко отключите USB для нового замера и подключите обратно.
4. Подключите помощник. В режиме Bluetooth/Wi-Fi ноды выберите «Настройки (консоль)», в режиме USB — «Настройки (USB-компаньон)».
5. В разделе ADC явно запустите сервисное окно и подтвердите предупреждение. Пока оно активно, не отключайте кабель.
6. Введите фактическое напряжение, нажмите расчёт, проверьте результат и отдельно сохраните калибровку. Опорный замер от АКБ допустим до двух минут, а готовый расчёт — до 60 секунд. Сервисное окно не продлевает эти сроки.
7. После сохранения проверьте результат при питании от аккумулятора. Защита уже работает в обычном режиме. Если помощник сообщает, что пригодного опорного замера нет, повторите шаг получения замера, а не подбирайте напряжение наугад.

Сервисное окно не исправляет ошибки хранилища и не снимает запрет «только для чтения». При неудачном сохранении прежний коэффициент остаётся; потеря ответа не означает, что запись точно не произошла. Перечитайте состояние.

Что не меняли

1. Обычная защита АКБ включена по умолчанию: 3,2 В. При её выключении остаётся нижний порог 2,7 В. Вне явного сервисного окна при подтверждённом USB также сохраняется порог 2,7 В. Значения берутся из калиброванного ADC, а не из мультиметра.
2. Контакты, ключ ноды, каналы и сохранённые настройки не сбрасываются обычным UF2/app-only обновлением. Неправильный, но допустимый старый коэффициент сам по себе не заменяется — его нужно откалибровать.
3. База — MeshCore 1.17.1 / PowerSaving, companion-протокол 13. Локальный CLI — CMD66/RESP29; API201 и синхронизация событий остаются в архиве 0.11. Приватная ветка не менялась.
4. Wi-Fi/TCP остаётся портом 5000 без TLS и отдельного пароля доступа: только доверенная локальная сеть, без проброса в Интернет.

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

1. T096 FEM ON — T096_UI_0.14.uf2.
2. T114 — T114_UI_0.14.uf2.
3. ProMicro RA62 — ProMicro_RA62_UI_0.14.uf2.
4. Heltec V3 OLED — Heltec_V3_UI_0.14-update.bin / Heltec_V3_UI_0.14-merged.bin.
5. Heltec V4.3 OLED R2 — Heltec_V4.3_UI_0.14-update.bin / Heltec_V4.3_UI_0.14-merged.bin.
6. Wireless Paper — Paper_UI_0.14-update.bin / Paper_UI_0.14-merged.bin.
7. Heltec V4 R8 OLED — Heltec_V4_R8_UI_0.14-update.bin / Heltec_V4_R8_UI_0.14-merged.bin.

Любой ESP32 merged — чистая установка со сбросом identity, контактов и настроек, даже без Erase Flash. Работающую совместимую ноду обновляйте update.bin по 0x10000 без очистки. Файлы R2 и R8 не взаимозаменяемы; цветной TFT R8 не поддерживается этой сборкой.

В выпуске 19 файлов: 11 прошивок, HTML и ZIP помощника 1.8, Developer Kit 0.14, примечания, два списка SHA256, манифест и общий SmartUI_0.14_all-boards.zip. Все прошивки связаны с одним исходным commit в RELEASE-MANIFEST.json.

Инструкция помощника · Команды и интеграция · Предыдущий 0.13.

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

Проверяются таймер и его переполнение, повторный запуск без продления, отказ без USB, потеря USB, прекращение сеанса, запрет записи, ошибки сохранения и восстановление обычной защиты. Сборки всех семи плат, проверки хранилища, OLED/framebuffer и тесты помощника остаются в CI.

Это программные проверки и имитация подключений. Физические испытания всех плат, батарей и схем питания не проводились. Причину конкретного отключения нельзя подтвердить без проверки устройства и питания.