Repository navigation
Releases
v1.14.1 — полная загрузка архива прибора по USB в историю платы
v1.14.1 — полная загрузка архива прибора по USB в историю платы, замена участка архивом
SHA256: firmware.factory.bin 892766494f0d471a6c7321b9a8f273c2ebbb1ff7106907daa29e667f7d742b10
SHA256: radex-gw-idf.bin 5868fa6a530ec640db361827488e066fa2c06ae11129928da09897cd9b60e2ba
Это первый публичный выпуск функции загрузки архива. Образ собран из чистой выгрузки git archive коммита
6dcaf7c88fa9cfce0bd8f8d426e3e176e8c14936, tree-хеш dc7cbf8168ffe2c46be61b103d70bd61b3b6cf1f
(git rev-parse <коммит>^{tree}). Время сборки в образе (app_desc, часы контейнера, UTC) — 15:38:33 19.09.2026,
то есть 18:38:33 по Москве, позже коммита (18:36:33 +0300). Версия в образе v1.14.1. Последующие коммиты
(до 415714f) меняют только документацию (README, KNOWN_ISSUES, CHANGELOG, INSTALL, комментарий скрипта
scripts/fix_history_csv.py); в образ они не входят: в него встраиваются только исходники main/,
web/index.html.gz и web/setup.html, состав изменений проверен git diff --stat 6dcaf7c..<коммит>.
После перезагрузки платы подождите 2–3 минуты, пока часы синхронизируются (около 150 с): до этого любая загрузка отвечает «Часы платы не синхронизированы» — это штатно, страница подсказывает то же.
Обновляется приложением на 0x20000 (radex-gw-idf.bin) — сохранятся сеть, привязка к прибору, выключатель
Bluetooth и история измерений; таблица разделов не менялась. Чистая плата — firmware.factory.bin на 0x0.
Что проверено на плате. Оператор проверил на плате 19.09.2026 предыдущую сборку v1.14.1-r2 (релизная сборка
отличается исправлениями, перечисленными в CHANGELOG в пункте «Исправлено перед выпуском (проход по коду)»): загрузка
архива и порядок истории; режим замены — подсчёт dry, затем замена: в истории удалено 518, добавлено 425, в
замере удалено 509, добавлено 419; после замены история 513 строк без нарушений порядка, без дублей меток и без
пар «живая + архивная» ближе 400 с (минимальный интервал 599 с), замер 420 строк (минимальный интервал 477 с),
«только в замере» 1 строка; повторный dry — «менять нечего» (hsame 425 / 419); обычная загрузка после замены:
новых 0, дублей 425, в файл замера добавлена 1 и убрана 1 строка; запас стека задачи radex_usb 2 680 Б из 6 144
(после замены) и 3 208 Б (после dry); минимум свободной внутренней RAM int_min 47 232 Б; потерянных живых точек
очереди 0. Часы платы после перезагрузки синхронизируются (в первом запуске около 150 с).
Проверка релизной сборки (v1.14.1-r3) на плате: на плате оператора 19.09.2026 образ запущен и проверен: строгий разбор запроса /api/archive/start (без параметров — 200; ?dry=1, ?foo=1, mode длиннее 15 символов, mode=replace&max=5 — 400); подсчёт замены dry=1 прочитал 430 записей (убрать 5 строк истории и 4 замера, добавить 5 и 5, остальное без изменений); обычная загрузка: новых 0, дублей 430; после неё история 518 строк и замер 425 строк — порядок не нарушен, дублей меток нет, пар «живая + архивная строка» с равным значением ближе 400 с нет; запас стека radex_usb 2820 Б из 6144, int_min 47 924 Б. Не проверялось на плате: ветка старта без radon.csv, восстановление после потери питания на шагах замены и hist_discard (только хост-тесты)..
Полный перечень непроверенного — в разделе «Что не проверено».
Что нового
- «Загрузить весь архив (USB)» — кнопка на вкладке «Системные» (только при канале USB). Журнал на 64 записи —
предел шлюза, а не прибора; архив читается целиком, сквозь все сессии, и вставляется в историю платы по времени:
предпросмотр (записей, сессий, что поместится) → подтверждение → чтение с прогрессом, оценкой времени и отменой →
сверка → запись. В конец, если новые строки не старше хвоста, иначе слиянием. Ничего не пишется, пока архив не
прочитан и проверен: отмена, обрыв USB, нарушение порядка, нехватка места или памяти оставляют историю
нетронутой. API:GET /api/archive,POST /api/archive/preview,POST /api/archive/start[?max=N],
POST /api/archive/cancel. По BLE — прежний журнал на 64 записи. - «Заменить участок архивом» — отдельная кнопка (
POST /api/archive/start?mode=replace;&dry=1— только
подсчёт). В границах архива (метка первой — метка последней годной записи) из истории и из файла идущего замера
убираются ВСЕ строки, которых нет среди записей архива точно такой же строкой, а на их место кладутся записи
архива с сырой ОА; совпавшие точно строки не переписываются. Снаружи границ не трогается ничего, кроме интервала
(последняя запись, последняя + lag](lag=max(цикл, опрос) + 60 с, обычно 660 с): там лежит живая точка
последнего цикла — дубль последней записи, привязанный ко времени опроса, то есть правее конца цикла. Завершённые
замеры не изменяются никогда. Отказ без записи: часы прибора не прочитаны (noclock), цепочка сессий не
сходится (chain), прочитано не столько записей, сколько в заголовке (partial), внутри границ есть запись
с недопустимым временем или значением (hole), нет годных записей (empty), не хватает места на временные
файлы (full), идёт другое задание (busy). Замена файлов — через.bak; потеря питания на любом шаге оставляет
файл прежним или новым целиком; повторный запуск подряд ничего не меняет и файлы не переписывает. Страница:
сначала подсчёт (границы, сколько строк будет убрано и добавлено), окно подтверждения («Действие необратимо —
сначала сохраните выгрузку истории (/api/export.csv)») и только после «ОК» настоящий запрос. Операция автоматически не запускается.
Обратная сторона правила проlag: живая точка, записанная в этом интервале и не имеющая записи в архиве (прибор
закрыл новый цикл уже после чтения архива), будет убрана; обычная загрузка вернёт её как новую запись. - Порядок истории — инвариант.
radon.csvи файл идущего замера остаются неубывающими по времени; нарушенный
порядок чинится слиянием даже без новых записей (fixed:true); оборванная последняя строка файла при слиянии
отсекается. - Значения.
radon— сырая ОА цикла (запись архива@8), как у живых точек;radon_avg— скользящее среднее
записи (@12), у живых точек там средняя сессии прибора — колонка неоднородна, расчёты берутradon. Журнал на
64 записи («Сохранить N точек в историю») пишет строки по возрастанию времени,radon= сырая ОА записи,radon_avg=oa. - Сопоставление с живыми точками по фазе и значению. Живая точка привязана ко времени опроса платы, запись
архива — к концу цикла; окно ±180 с при опросе 600 с давало бы дубли на фазах 181…420 с и сопоставление с
соседним циклом на 421…599 с. Кроме окна, запись сопоставляется с ближайшей не занятой строкой с тем же значением
ОА (допуск 0,006) доlag. Тот же механизм сверяет журнал и файл замера. После загрузки живая точка с тем же
значением не позже 590 с после последней строки файла не пишется. - Файл идущего замера сверяется с собственным содержимым; сглаженные строки (
radon==radon_avg) с сырой
рядом (≤ 30 с) убираются; если менять нечего — файл не переписывается. Итог —tadd,tfix. - Безопасная замена файла (
main/hist_swap.c):rename(история → .bak),rename(результат → история),
remove(.bak); при отказе исходник возвращается; дозапись в отсутствующую историю запрещена, пока рядом лежит
непринятый файл слияния; восстановление при старте — по правилам README. Так же заменяются файлы при слиянии,
прореживании, уплотнении, переносе заголовка, перестройке и импорте. - Ёмкость считается по
esp_spiffs_info(худшая строка 45 Б,HIST_ROW_BYTES_MAX) по обоим файлам, отказ —
ДО записи. При почти пустой истории: ≈ 25 800 (дописывание), ≈ 15 500 (при идущем замере), ≈ 40 800 (слияние).
Год записей (52 560) целиком не помещается; предпросмотр предлагает «последние N». - Исправлено перед выпуском (проход по коду): пустой
radon.csv(только заголовок) не считается целым — копия с
данными при восстановлении не удаляется, а при стартеradon.csvне создаётся заново, пока рядом остались.new/.bak
или восстановление не удалось; устаревшийmrg_*.newпосле отказавшейся замены убирается с повторами, а при отказе
remove— переименованием в.wip; строка запросаPOST /api/archive/startразбирается строго: неизвестный,
повторный, усечённый параметр,dryбезmode=replace,maxвместе сmode—400без запуска. - Заголовок архива читается один раз за задание, чтение идёт по нему; замена сверяет число прочитанных записей с
числом по этому заголовку (partial). При разработке повторный запрос заголовка на приборе один раз описал только
старшую сессию (прочитано 264 записи из 408); причина различия заголовков не установлена, при расхождении числа
сессий по0x0BC2и в заголовке в лог пишется предупреждение. - Живые точки на время задания копятся в очереди на 8 точек; потерянные пишутся в лог и считаются; в конце задания
в лог пишется минимальный запас стекаradex_usb.
Уже испорченная история
Если в истории остались строки от предрелизных сборок этой функции (сглаженное среднее в обеих колонках; запись
архива, легшая в конец «не по порядку»; пары «живая + архивная» с расхождением меток 196–399 с и близкие пары со
сдвигом на цикл — на плате оператора до ремонта 73 пары и около 90 близких), достаточно один раз выполнить
«Заменить участок архивом»: в границах архива такие строки заменятся сырой ОА, порядок восстановится. Замена участка
на плате выполнена (см. выше). Строки левее первой записи архива операция не трогает. Ручная процедура —
firmware-idf/scripts/fix_history_csv.py (README, «Уже испорченная история»).
Ёмкость и прореживание истории
Исправление, влияющее на все версии до 1.14.1: прежнее прореживание при 1,8 МБ вместе с временным файлом не
помещалось в раздел storage (2 МБ), и обрезанный временный файл мог подменить историю (вывод по коду и расчёту,
на плате не воспроизводилось). Теперь прореживание запускается заранее — когда свободного места меньше «половина
файла + 160 КБ» (≈ 1,17 МБ, ≈ 34 000 строк); если ме...
v1.13.1 — установка часов по USB выключена по умолчанию, исправлен журнал по USB
v1.13.1 — установка часов прибора по USB выключена по умолчанию, исправлен журнал по USB
SHA256: firmware.factory.bin 5d2f569448552ab71a2d0a32c4b0d6cccd6231111ec2297537c5f8c866d51af5
SHA256: radex-gw-idf.bin 38c629dff6c3a2dff863efa8e54c71c0227aa91dc7eadb1f54de3c5dc9bad413
Исправляющий выпуск к v1.13.0 (прибор по USB-кабелю, автовыбор USB/BLE). Обновляется приложением на
0x20000 (radex-gw-idf.bin) — сохранятся сеть, привязка к прибору, выключатель Bluetooth и история
измерений; таблица разделов не менялась. Чистая плата — firmware.factory.bin на 0x0.
Установка часов прибора выключена по умолчанию
По наблюдению за RadexDC установка времени (команда 0x0006) закрывает текущую сессию замера на приборе
и открывает новую. В v1.13.0 шлюз посылал эту команду сам по умолчанию (после NTP, при расхождении часов
больше 5 с, не чаще раза в 6 ч), и с платы она не проверялась. Начиная с v1.13.1 параметр сборки
CONFIG_RADEX_USB_CLOCK_SYNC по умолчанию выключен: код синхронизации в образ не компилируется,
запрос 0x0006 остаётся в белом списке запросов (main/radex_ekosf.c), но не вызывается. Остальные запросы
к прибору прежние: три чтения (0x0BC2, 0x0C0D, 0x0C0E) и два позиционирования архива (0x0C04,
0x0C05).
Если включить: CONFIG_RADEX_USB_CLOCK_SYNC=y в firmware-idf/sdkconfig.defaults (menuconfig →
«Radex MR107ion gateway» → «USB: выставлять часы прибора (RPC 0x0006) по NTP») и пересборка. Порог
расхождения — CONFIG_RADEX_USB_CLOCK_MAX_DRIFT_S (по умолчанию 5 с). ВНИМАНИЕ: шлюз тогда сам выставит
часы прибора, и на приборе может начаться новая сессия — «средняя сессии» (radon_avg) начнётся заново.
Поведение шлюза выведено из наблюдения за RadexDC и на плате не проверялось. Переключателя без
пересборки нет.
Исправлено: колонка «ОА» журнала по USB — скользящее среднее (как по BLE)
Прежняя сборка v1.13.0 отдавала в колонке oa журнала по USB сырую ОА цикла, тогда как по BLE в этой
колонке скользящее среднее прибора (его показывает экран). Запись журнала по BLE (24 байта) — это запись
по USB (22 байта) со сдвигом на 2 байта: oa по BLE = USB @12 (скользящее), unk_f10 = USB @8 (сырая).
Таблица журнала и кнопка «Сохранить в историю» читают oa, поэтому по USB получалась другая кривая, чем по
BLE. Теперь соответствие полей — в одной функции radex_arch_to_journal().
Как проверено: USB-запись №3 из трассы RadexDC совпадает побайтно (без 2-байтового префикса) с записью
№3 из BLE-захвата, а все поля журнала, полученные из USB-записи, — с результатом BLE-разбора; запись №264
сессии 0 на плате по BLE даёт oa 79,31 (скользящее), сырая по трассе — 97,33. Хост-тест проверен
мутационно (возврат прежнего присваивания краснит тест). На плате (образ v1.13.1, USB): запись №264
сессии 0 теперь даёт oa 79,31, №263 — 77,69 (как по BLE), сырая ОА — в unk_f10 (97,33 и 73,33).
Записи истории, импортированные из журнала, содержат сглаженные значения (oa кладётся в колонки radon и
radon_avg), точки живого опроса — сырую ОА последнего цикла; так и по BLE.
Известное поведение, не исправлялось
- Журнал по BLE читает только сессию 0 прибора: при двух сессиях
/api/journalпо BLE отдаёт старую
сессию (last_record264), по USB — последние 64 записи сквозь сессии. Поведение BLE-кода v1.12.0,
наблюдалось на плате 19.09.
Документация
Заголовки README («Альтернативная архитектура: чистый ESP-IDF») и INSTALL («Путь 3: ветка ESP-IDF») больше
не привязаны к старым версиям, исправлены ссылки-якоря на них; описание установки часов переписано.
Что проверено на плате
Переключение каналов USB/BLE, выключатель Bluetooth (через API), страница и журнал по USB проверены на
v1.13.0 (см. его release notes); чтение журнала по BLE в универсальной сборке — на v1.13.0 (64 записи,
статус ok, сессия 0). Образ v1.13.1 прошит и проверен на плате 19.09: версия v1.13.1 в /api/system,
канал ble без прибора на USB и usb с ним, страница 0,33–0,63 с, свободно внутренней памяти
21 КБ, журнал по USB 64 записи (статус ok, разрывов нет), 12 минут работы без перезагрузок, сообщений о
синхронизации часов в логе нет. Не проверено на плате: установка часов (0x0006) при включённой опции и
включение Bluetooth флажком на странице (выключатель проверялся через API).
Образ собран из коммита 49bd3b2; последующие коммиты не меняют исходников прошивки.
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:в начале этого текста.
v1.12.0 — журнал прибора по BLE, вкладка текущего замера, замечания методики, ускорение страницы
v1.12.0 — журнал прибора по BLE, вкладка текущего замера, замечания методики, ускорение страницы
Журнал прибора читается по воздуху (#RADEX-281)
Прибор хранит внутри до 64 последних записей измерений — раньше добраться до них можно было только
через приложение производителя на телефоне. Теперь это делает плата: кнопка «Прочитать журнал с прибора»
на вкладке «Системные» поднимает сеанс по Nordic UART Service, вычитывает записи и показывает их таблицей
(номер, время, ОА, температура, влажность).
Протокол разобран по HCI-логу реального клиента, а не подбором: сводка 47 00… → 81 ff…, затем
48 00 <last−1> 01 00 00 00 и по одной записи 82 ff… в порядке убывания. Запись — 24 байта, поэтому
перед сеансом согласуется MTU: при MTU < 27 сеанс не начинается вовсе, вместо молчаливой порчи данных
выводится причина. В прибор уходит только белый список команд — выключение, загрузчик и стирание
недоступны в принципе.
Прочитанное можно сохранить в историю платы (#RADEX-293): отдельная кнопка, подтверждение, дедупликация
по времени ±180 с, калибровка часов по моменту завершения сеанса (а не по моменту нажатия — между ними
произвольная задержка). Записи, уже имеющиеся в истории, повторно не добавляются.
Графики и заключение — по идущему замеру, а не по всей истории платы (#RADEX-285, #RADEX-286)
Раньше вкладка «Результаты измерений» и карточка заключения считались по всей истории флеша, куда попадали
и данные прежних приборов. Теперь ряд, число измерений и среднее берутся с начала текущего замера.
Смена прибора (#RADEX-283) сама завершает идущий замер, сохраняет его под именем с датой и MAC-суффиксом
и начинает новый — раньше это приходилось делать вручную тремя действиями, и файл прежнего замера осиротевал.
Цикл измерений прибора (#RADEX-287) определяется по промежуткам между записями текущего замера, а не по
кольцу платы, копившему промежутки без отсечки по прибору — отсюда была жалоба «врёт о цикле».
Замечания автора методики (#RADEX-267…280)
- Критерий продолжительности — 10 месяцев по §7.1.2, со сноской в заключении.
- Убран лишний норматив США из плашек.
- Средняя ОА рисуется своим цветом; фиолетовая кривая подписана как верхняя граница доверительного интервала.
- Таблица результатов переехала ниже блока заключения.
- Вкладки «Графики» и «Интеграции» поменялись местами.
- Продолжительность теста считается одной функцией: сутки — вниз, меньше суток — только часы.
- Имя замера принимает кириллицу и пробел (48 байт UTF-8, без разрыва символа).
- «Начало теста» при уже идущем тесте отвечает 409 и подтверждением на странице, а не молча перезаписывает
точку отсчёта.
Страница стала легче и перестала «тупить» (#RADEX-294)
Сжатие и кэш. Страница отдаётся gzip-сжатой: 458 КБ → 129 КБ, с ETag и 304 Not Modified на повторную
загрузку. Сжатие делается один раз при сборке прошивки — плата отдаёт готовый блок из флеша и ничего не жмёт
в рантайме.
Опрос вместо штурма. Страница больше не шлёт семь параллельных запросов каждые 30 с: круг идёт
последовательно. Веб-сервер платы — одна задача, и параллельные запросы просто выстраивались в очередь к ней же,
конкурируя с отдачей самой страницы. Вызов «перечитать сейчас» (старт замера, возврат вкладки из фона и ещё
восемь мест) во время идущего круга больше не теряется — он взводит один добавочный круг сразу по окончании
текущего.
Меньше лишних запросов. Карточка «Цикл прибора» кэшируется (ключ — последнее показание и граница текущего
замера), опрос журнала в покое идёт раз в 30 с вместо раза в 3 с, а явные события форсируют его немедленно.
Найденная и убранная регрессия. По ходу работы на плате обнаружилось, что диагностические счётчики
производительности, добавленные для разбора этой же задачи, сами замедляли отдачу страницы примерно
в десять раз. Установлено прямой бисекцией по коммитам на живой плате, дважды воспроизведено, подтверждено
контрольным повтором предыдущей версии. Счётчики (вместе с записью причины перезагрузки и разделом посмертного
дампа) из выпуска убраны.
Замеры на плате, одиночные запросы страницы: до работы — 2 из 10 загрузок доходили, максимум 82,8 с;
после — 8 из 8, стабильно 2,7–3,7 с на загрузку, ни одного таймаута.
Надёжность
- Опрос прибора больше не встаёт навсегда при отказе чтения характеристики (#RADEX-284): круг закрывается,
повтор через 30 с. Раньше при живой связи опрос и журнал молча останавливались до перезагрузки. - Старт круга опроса захватывается атомарно — две цепочки чтений одновременно больше не запускаются.
- Повторный запрос журнала во время идущего сеанса или чаще раза в минуту получает 429 с читаемым текстом.
- Большие структуры журнала (4376 байт) переехали со стека веб-сервера в статическую память.
Проверка
Хост-тесты: 8 C-наборов (разбор журнала, слежение за сеансом, метки, методика, UTF-8-имена, охрана замера,
калибровка времени, HTTP-кэш) и 2 JS-набора по исходнику страницы (41 проверка суммарно). Новый тест опроса
журнала прошёл мутационную приёмку — семь внесённых дефектов, включая снятие самого гейта периодичности,
он ловит; на исправном коде даёт ноль срабатываний.
Прошивка
- Настроенная плата: только приложение на
0x20000(radex-gw-idf.bin) — сохранятся сеть, привязка к прибору
и история измерений. - Чистая плата:
firmware.factory.binна0x0.
⚠ В этом выпуске изменилась таблица разделов (убран раздел посмертного дампа, добавлявшийся в промежуточной
сборке). Если плата шилась промежуточной сборкой с этим разделом — заливать вместе с приложением также
partition-table.bin на 0x8000 и ota_data_initial.bin на 0xf000. NVS и раздел истории при этом
не затрагиваются.
v1.11.1 — на графике больше не подставляется приборная погрешность вместо методической
Плашка среднего на «Графиках» (#RADEX-264)
В плашке стояло «среднее 107 ± 21 Бк/м³», где 21 — приборная погрешность 20 % плюс статистическая ошибка среднего. К решению о соответствии нормативу эта величина отношения не имеет: методика оперирует √(UV(t)² + U_D²). Ветка с методической полушириной в коде была, но включалась только при вердикте не too_short; на коротком тесте молча срабатывал приборный запасной путь, и два разных числа выводились под одной подписью.
Теперь, пока методика не даёт UV(t), «±» не рисуется вовсе — вместо него подпись «интервал по методике — с N сут теста». Порог N берётся из таблиц платы: нормальная вентиляция — 4 суток, ограниченная — 2. Как только длительность достигает первого узла таблицы, плашка возвращается к прежнему виду: «расчётная среднегодовая X ± Y Бк/м³».
Проверено на плате перехватом вызова отрисовки: при too_short погрешность не передаётся, при подставленных uv = 0.45 и U_D = 0.30 полуширина равна 0.5408 — ровно √(0.45² + 0.30²), а не приборные 0.20.
Прошивка
- Настроенная плата: только приложение на
0x20000(radex-gw-idf.bin) — сохранятся сеть, привязка к прибору и история. - Чистая плата:
firmware.factory.binна0x0.
v1.11.0 — выгрузка на narodmon наконец работает
Выгрузка на narodmon.ru не работала никогда (#RADEX-263)
Цикл публикаций стоял ЗА ble_radex_start(), а она управление не возвращает — её собственный while(1) опрашивает прибор каждые 100 мс. Цикл был недостижим с первого выпуска IDF-ветки, поэтому narodmon_publish() и ha_mqtt_publish() не вызывались ни разу ни на одной плате.
Снаружи это выглядело исправным: настройки сохранялись, «Включить отправку» отвечала успехом, состояние показывало enabled: true — и на сервер не уходило ничего. Публикация в Home Assistant молчала по той же причине.
- Публикации вынесены в отдельную задачу, создаётся до запуска BLE.
- В
narodmon_publish()добавлен пульс раз в ~5 минут с причиной пропуска и строка попытки отправки до сетевых операций. Прежде оба штатных выхода писались уровнем DEBUG при журнале INFO, и «не вызвано» было неотличимо от «вызвано и вышло штатно».
Интерфейс показывал не то, что сохранено на плате
- Поле MAC всегда рисовало автоподстановку MAC платы, интервал — зашитые 30 минут: ответ
/api/narodmonв поля не попадал вовсе. Из-за этого настройка выглядела верной, а отправка шла под другим адресом. - Отказ приходит как
HTTP 200 {"ok":false}, а страница смотрела только код — и рапортовала «Отправка включена» при отказе. Теперь успех определяется по телу ответа. - В журнал писалось «выгрузка ВКЛЮЧЕНА» независимо от результата. Теперь — по факту.
- Добавлены строка состояния (включено/выключено, давность последней удачной отправки, ответ сервера при ошибке) и двухпозиционная кнопка: выключить отправку из интерфейса было нельзя вовсе.
Метрика радона
RR1 вместо R1. По префиксу R narodmon.ru определял тип датчика как «радиация» и показывал объёмную активность радона в мкР/ч — 109 Бк/м³ читались как двадцатикратный фон.
Если данные не идут
Проверьте в карточке прибора на narodmon.ru поле Протокол: прошивка передаёт классическим текстовым протоколом TCP на порт 8283. При выбранном JSON сервер отвечает Protocol != JSON и пакет отбрасывает.
Прошивка
- Настроенная плата: только приложение на
0x20000(radex-gw-idf.bin) — сохранятся сеть, привязка к прибору и история. - Чистая плата:
firmware.factory.binна0x0.
v1.10.0 — завершение теста как состояние, настройка Wi-Fi по проводу
Завершение теста — состояние, а не удаление (#RADEX-200)
Замечание 9 автора методики. Кнопки теперь «Начало теста» и «Завершение теста».
- Завершённый тест сохраняется целиком: файл замера, его период и заключение остаются. После завершения в файл замера нет дозаписи, окно заключения перестаёт расти, замер уходит из активных и становится удаляемым в перечне на «Графиках».
- Начать новый тест можно только после завершения текущего — кнопка начала до тех пор заблокирована.
- Деструктивной кнопки на главной больше нет: удаление замера живёт в перечне.
- Завершение делает снимок замера тем же механизмом, что «Сохранить замер»: у теста, шедшего по умолчанию, файл появляется именно в этот момент.
Настройка Wi-Fi по проводу — Improv Serial (#RADEX-186 шаг Б)
Сеть задаётся из браузера через USB (improv-wifi.com/serial), без пересадки на точку доступа платы.
- Пара «сеть/пароль» сохраняется только после удачного подключения: непроверенная увела бы плату в несуществующую сеть после перезагрузки.
- Готовность определяется по появлению адреса, а не по флагу события: в режиме первичной настройки обработчик событий не регистрируется вовсе.
- Сканирование эфира по запросу клиента отклоняется намеренно — оно уводит радио и рвёт связь с прибором посреди измерения; имя сети вводится вручную.
Исправления
- Отказ
/api/testвыходил какHTTP 500вместо внятного сообщения: русский текст в UTF-8 вдвое длиннее и не помещался в буфер ответа. - Кадр Improv мог разорваться строкой лога посередине — вывод в порт сериализован общим замком.
Прошивка
- Настроенная плата: только приложение на
0x20000(radex-gw-idf.bin) — так сохраняются сеть, прибор и данные. - Чистая плата:
firmware.factory.binна0x0.
v1.9.2 — сходящийся доверительный интервал на «Графиках»
Сходящийся доверительный интервал на «Графиках»
Полоса вокруг среднего теперь сужается со временем. На вкладке «Графики» она рисовалась прямоугольником постоянной высоты — одна и та же полуширина и в первый день теста, и на 341-е сутки, то есть ровно то, чего доверительный интервал показывать не должен. Теперь для каждой точки берётся U_V(t) по её длительности от начала теста (тот же расчёт, что на «Результатах измерений»), а верхняя граница дополнительно обведена пунктиром: её пересечение с линией норматива и есть момент, когда помещение можно признать соответствующим.
Полоса строится по тому ряду, для которого плата посчитала заключение, и от той же точки отсчёта, от которой она считала продолжительность.
Период указывается конкретными датами. Вместо «— по последнюю запись» выводится дата последней записи, а продолжительность печатается всегда и первым числом даёт сутки — по ним ищется строка таблицы U_V(t)/K_p(t); привычные «мес/сут/ч» остались в скобках. Те же данные добавлены на вкладку «Заключение».
Температура и влажность. Если в показанных рядах этих величин нет — например, замер получен импортом выгрузки прибора, где есть только радон, — под легендой теперь так и написано. Раньше включение величины молча ничего не меняло, и это выглядело поломкой.
Обновление уже настроенной платы
Файлом radex-gw-idf.bin на смещение 0x20000 — сеть, привязка прибора и история сохраняются. firmware.factory.bin на 0x0 — только для первой прошивки: он стирает настройки.
v1.9.1 — цвет средней и расчётной среднегодовой по вердикту
Цвет средней и расчётной среднегодовой — по вердикту
«Средняя ОА радона» и «Расчётная среднегодовая ОА радона» красились по абсолютной шкале индикатора, где, например, 325 Бк/м³ при нормативе 200 попадает в оранжевую зону (красная начинается с 460) — хотя вердикт уже «не соответствует». Эти две карточки несут решение, а не мгновенное показание, поэтому их цвет теперь берётся от вердикта: красный при «не соответствует», зелёный при «соответствует», жёлтый в остальных случаях. Погрешность и единица измерения получили тот же цвет и то же жирное начертание, что число.
«Текущая ОА радона» не тронута — там цвет намеренно совпадает с положением иглы на шкале рядом.
Пока тест короче минимальной длительности (вердикта ещё нет), обе карточки красятся как раньше, по зоне: иначе одно и то же число выходило бы двумя разными цветами.
Обновление уже настроенной платы
Файлом radex-gw-idf.bin на смещение 0x20000 — сеть, привязка прибора и история сохраняются. firmware.factory.bin на 0x0 — только для первой прошивки: он стирает настройки.
v1.9.0 — расчёт по методике, согласованный интервал, выбор периода мышкой
Расчёт по методике и согласованный доверительный интервал
«Расчёт по методике» — раскрывающаяся вкладка под заключением на «Графиках» и на вкладке «Заключение». Внутри: режим вентиляции, U_V(t), U_И из настроек платы, K_p(t), длительность; оба критерия с подстановкой ваших чисел и знаком сравнения; правило 9 месяцев; итог с названной причиной решения — сработавший критерий (2) или исчерпание времени без доказанного соответствия. Свёрнута по умолчанию: в обычной работе нужен вердикт, а расчёт открывают, когда числа с чем-то не сходятся.
Инструментальная неопределённость показана отдельной плашкой. Именно её обычно и не хватает, чтобы объяснить расхождение со сторонним калькулятором: там по умолчанию 20 %, а плата берёт значение из своих настроек.
Пока тест короче 4 суток (2 при ограниченной вентиляции), вкладка объясняет, почему заключения ещё нет, вместо того чтобы исчезать.
Одно «±» вместо четырёх. Плашка на графике, полоса вокруг линии, перечень файлов и заключение показывали разные погрешности для одного ряда: статистическую ошибку среднего с инструментальной из поля страницы — против √(U_V(t)² + U_И²) по методике. Теперь плашка и полоса берут расчётную среднегодовую и её полуширину у платы (та же величина, что в заключении), из перечня «±» убрано, а при коротком тесте, где методика таких величин не даёт, остаётся среднее по точкам.
График: подпись норматива переехала в верхний ряд, напротив плашки, и больше не наползает на данные; линия расчётной среднегодовой — пунктиром, вокруг неё полоса доверительного интервала.
Перечень файлов: идущий замер больше не показывается дважды — первая строка «текущий замер» несёт его имя, объём и продолжительность, отдельной строки-снимка нет.
Нормативы: добавлен уровень действия US EPA — 148 Бк/м³ (4 pCi/L); российские планки подписаны «РФ».
Обновление уже настроенной платы
Файлом radex-gw-idf.bin на смещение 0x20000 — сеть, привязка прибора и история сохраняются. firmware.factory.bin на 0x0 — только для первой прошивки: он стирает настройки.
Ещё в этой версии
Выбор интервала мышкой: Shift + протяжка выделяет участок графика — окно становится им, заключение пересчитывается само. Сдвиг без Shift работает как прежде.
Подсказка курсора больше не обрывается: название величины показывается только когда их на графике несколько, имя ряда — короткое и только при нескольких рядах.
Имя импортируемого замера больше не теряется, если в имени файла кириллица: оно транслитерируется (PD22209010007_Подвал (11).csv → pd22209010007_podval_11).