Repository navigation
v1.13.0 — прибор по USB-кабелю, автовыбор USB/BLE
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, sha2562f8d2271…) прошит на плату и проверен
именно он:fw: "v1.13.0", канал USB, чтение без ошибок, страница/за 0,12–0,18 с,int_min47 КБ
(при аптайме 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_min17,6 КБ; по BLE — 0,37–2,5 с,int_min21,5 КБ
(у v1.12.0int_min5,9 КБ).
- переходы каналов: нет → USB, USB → BLE (через 10 с), BLE → USB, Bluetooth выкл. и нет USB → нет
Известные ограничения и что не проверено
- Не проверено на плате: установка часов прибора (
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:в начале этого текста.