Skip to content

v1.13.0 — прибор по USB-кабелю, автовыбор USB/BLE

Choose a tag to compare

@Verter73 Verter73 released this 18 Sep 21:27
· 20 commits to main since this release

v1.13.0 — прибор по USB-кабелю, автоматический выбор USB/BLE

SHA256: firmware.factory.bin c7b720d6f6a6ee1c2bdc07ae97811f94f01062083c63741915e453ebe6c0bade

SHA256: radex-gw-idf.bin 2f8d2271e650edcb242ed2fe3f3ba8f5d574fa483f1ce896001dc157ffe38447

Radex MR107ion теперь можно подключить к плате кабелем

Плата ESP32-S3-DevKitC-1 N16R8 работает USB-хостом: прибор подключается к её разъёму USB (OTG)
и читается по кабелю — без разрывов, очереди команд и дележа эфира с Wi-Fi. Разъём UART остаётся
для питания, прошивки и лога.

Для питания прибора по USB на плате нужно замкнуть (запаять) перемычку USB-OTG — по опыту проекта
atomspectra-waterfall-esp32, подробности и фото там
(INSTALL.md).
Перемычка есть на распространённых клонах ESP32-S3-DevKitC-1 (N16R8); на оригинальной плате Espressif такой
перемычки нет, питание OTG-разъёма зависит от исполнения платы. Схема — в README, раздел «Подключение прибора
по USB». Кабель — только с линиями данных; плату питать от блока 5 В / не менее 1 А.

По USB читаются:

  • текущие показания раз в 10 минут, как по BLE: ОА последнего цикла, средняя сессии прибора и её
    СКО, температура, влажность;
  • журнал прибора — та же кнопка «Прочитать журнал с прибора», последние 64 записи, в том числе через
    границу сессий прибора; сохранение в историю — как раньше;
  • часы прибора выставляются по времени платы — только после синхронизации по NTP, при расхождении
    больше 5 с и не чаще раза в 6 ч (см. предупреждение ниже).

Прибору отправляются только запросы из белого списка в шесть команд (main/radex_ekosf.c, radex_ekosf.h):
три чтения (0x0BC2 показания, 0x0C0D заголовок архива, 0x0C0E страницы архива), два позиционирования
архива (0x0C04, 0x0C05) и одна запись — установка часов (0x0006). Все прочие RPC отклоняются до
отправки; сброс, выключение, загрузчик, удаление файлов и загрузка прошивки не строятся вовсе.

Протокол разобран по USB-трассам обмена штатной программы RadexDC с прибором; разбор и кодирование
кадров покрыты хост-тестами на этих трассах (смысл параметров 0x0C04 и 0x0C05 вскрыт не полностью —
кадры повторяют трассы).

ВНИМАНИЕ: установка часов может начать новую сессию замера на приборе

По наблюдению за RadexDC (установка времени из его окна) прибор закрывает текущую сессию и открывает
новую
. Шлюз шлёт ту же команду 0x0006, и синхронизация часов включена по умолчанию: при расхождении
часов прибора и платы больше 5 с (и не чаще раза в 6 ч, после синхронизации платы по NTP) шлюз выставит часы
сам. Поэтому он может сам закрыть идущую на приборе сессию, и «средняя сессии» (radon_avg) и её СКО
начнутся заново.

Что известно честно: на плате установка часов не проверялась; поведение шлюза выведено из наблюдения за
RadexDC, а не из опыта работы шлюза.

Как отключить: параметр сборки CONFIG_RADEX_USB_CLOCK_SYNC (menuconfig → «Radex MR107ion gateway» →
«USB: выставлять часы прибора (RPC 0x0006) по NTP») — поставить CONFIG_RADEX_USB_CLOCK_SYNC=n в
firmware-idf/sdkconfig.defaults и пересобрать. В готовом образе синхронизация включена, переключателя
без пересборки нет. Порог расхождения — CONFIG_RADEX_USB_CLOCK_MAX_DRIFT_S (по умолчанию 5 с).

Канал выбирается сам

Ситуация Канал
Прибор определился на USB USB, BLE на паузе (не ищет и не подключается)
USB нет (кабель вынут — через 10 с) BLE, как в v1.12.0
Bluetooth выключен в настройках и USB нет нет

Переходы — на лету, без перезагрузки платы. Активный канал виден приставкой «USB · » / «BLE · » к строке
статуса и полем transport в /api/data.

Выключатель Bluetooth — флажок в карточке «Прибор (MAC)» на вкладке «Системные» (POST /api/bt).
Хранится в памяти платы, по умолчанию включён; выключенный означает «только USB».

Надёжность веб-интерфейса

Буферы Wi-Fi и сетевого стека перенесены во внешнюю память (PSRAM). В предрелизной сборке с двумя
каналами внутренней памяти оставалось около 1 КБ (int_min 900 Б, наибольший свободный блок 1536 Б), и
страница (131 606 Б) грузилась 19–23 с либо обрывалась по таймауту 60–90 с, тогда как /api/data отвечал
за 69 мс; найдено бисекцией на плате. После исправления страница грузится за около 0,1–0,4 с в USB-режиме,
в отдельных замерах по BLE — до 2,5 с (Wi-Fi, RSSI −64…−76 dBm). Внутренняя память теперь видна
в /api/system (int_free, int_min, int_largest, dma_free).

Что и на какой сборке проверено

Публикуемый образ собран из коммита a7e760e; последующие коммиты не меняют исходников прошивки
(документация, тест-скрипт).

  • Публикуемый образ v1.13.0 (radex-gw-idf.bin, sha256 2f8d2271…) прошит на плату и проверен
    именно он: fw: "v1.13.0", канал USB, чтение без ошибок, страница / за 0,12–0,18 с, int_min 47 КБ
    (при аптайме 44 с).
  • Предыдущая сборка 81af959 (отличается от публикуемой только версией и документацией) — все сценарии:
    • переходы каналов: нет → USB, USB → BLE (через 10 с), BLE → USB, Bluetooth выкл. и нет USB → нет
      (через 10,9 с), включение Bluetooth через POST /api/bt → BLE (+20 dBm, опрос без ошибок); без
      перезагрузок;
    • показания по USB и по BLE, снятые одновременно, совпали (100,67 / 106,09 Бк/м³);
    • журнал по USB: 64 записи через границу двух сессий, status ok, значения сверены с экраном RadexDC;
    • страница / по USB — 0,18–0,24 с, int_min 17,6 КБ; по BLE — 0,37–2,5 с, int_min 21,5 КБ
      (у v1.12.0 int_min 5,9 КБ).

Известные ограничения и что не проверено

  • Не проверено на плате: установка часов прибора (0x0006) — см. предупреждение выше.
  • Не проверено на плате: чтение журнала по BLE в универсальной сборке (код BLE-журнала не менялся).
  • Не проверено на плате: включение Bluetooth флажком на странице (выключение флажком проверено;
    включение через POST /api/bt проверено).
  • Один раз при подключении прибора к OTG плата перезагрузилась по питанию (POWERON) — возможна просадка
    напряжения от тока заряда прибора, не подтверждено; отсюда рекомендация блока 5 В / не менее 1 А.
  • Порт эксклюзивен: пока прибор подключён к плате, RadexDC с ним работать не может.
  • Пока работает USB-хост, вторичная консоль USB-Serial-JTAG недоступна; лог — через разъём UART.

Прошивка

  • Настроенная плата: только приложение на 0x20000 (radex-gw-idf.bin) — сохранятся сеть, привязка к
    прибору, выключатель Bluetooth и история измерений. Таблица разделов не менялась.
  • Чистая плата: firmware.factory.bin на 0x0 (полный образ ESP-IDF-ветки).
  • Контрольные суммы — sha256sums.txt и строки SHA256: в начале этого текста.