Skip to content

Releases

v1.14.1 — полная загрузка архива прибора по USB в историю платы

Choose a tag to compare

@Verter73 Verter73 released this 19 Sep 18:12

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 строк); если ме...

Read more

v1.13.1 — установка часов по USB выключена по умолчанию, исправлен журнал по USB

Choose a tag to compare

@Verter73 Verter73 released this 18 Sep 22:02

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_record 264), по 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

Choose a tag to compare

@Verter73 Verter73 released this 18 Sep 21:27

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: в начале этого текста.

v1.12.0 — журнал прибора по BLE, вкладка текущего замера, замечания методики, ускорение страницы

Choose a tag to compare

@Verter73 Verter73 released this 17 Sep 22:00

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 — на графике больше не подставляется приборная погрешность вместо методической

Choose a tag to compare

@Verter73 Verter73 released this 07 Sep 13:29

Плашка среднего на «Графиках» (#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 наконец работает

Choose a tag to compare

@Verter73 Verter73 released this 07 Sep 11:00

Выгрузка на 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 по проводу

Choose a tag to compare

@Verter73 Verter73 released this 05 Sep 23:03

Завершение теста — состояние, а не удаление (#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 — сходящийся доверительный интервал на «Графиках»

Choose a tag to compare

@Verter73 Verter73 released this 05 Sep 19:50

Сходящийся доверительный интервал на «Графиках»

Полоса вокруг среднего теперь сужается со временем. На вкладке «Графики» она рисовалась прямоугольником постоянной высоты — одна и та же полуширина и в первый день теста, и на 341-е сутки, то есть ровно то, чего доверительный интервал показывать не должен. Теперь для каждой точки берётся U_V(t) по её длительности от начала теста (тот же расчёт, что на «Результатах измерений»), а верхняя граница дополнительно обведена пунктиром: её пересечение с линией норматива и есть момент, когда помещение можно признать соответствующим.

Полоса строится по тому ряду, для которого плата посчитала заключение, и от той же точки отсчёта, от которой она считала продолжительность.

Период указывается конкретными датами. Вместо «— по последнюю запись» выводится дата последней записи, а продолжительность печатается всегда и первым числом даёт сутки — по ним ищется строка таблицы U_V(t)/K_p(t); привычные «мес/сут/ч» остались в скобках. Те же данные добавлены на вкладку «Заключение».

Температура и влажность. Если в показанных рядах этих величин нет — например, замер получен импортом выгрузки прибора, где есть только радон, — под легендой теперь так и написано. Раньше включение величины молча ничего не меняло, и это выглядело поломкой.

Обновление уже настроенной платы

Файлом radex-gw-idf.bin на смещение 0x20000 — сеть, привязка прибора и история сохраняются. firmware.factory.bin на 0x0 — только для первой прошивки: он стирает настройки.

v1.9.1 — цвет средней и расчётной среднегодовой по вердикту

Choose a tag to compare

@Verter73 Verter73 released this 05 Sep 19:21

Цвет средней и расчётной среднегодовой — по вердикту

«Средняя ОА радона» и «Расчётная среднегодовая ОА радона» красились по абсолютной шкале индикатора, где, например, 325 Бк/м³ при нормативе 200 попадает в оранжевую зону (красная начинается с 460) — хотя вердикт уже «не соответствует». Эти две карточки несут решение, а не мгновенное показание, поэтому их цвет теперь берётся от вердикта: красный при «не соответствует», зелёный при «соответствует», жёлтый в остальных случаях. Погрешность и единица измерения получили тот же цвет и то же жирное начертание, что число.

«Текущая ОА радона» не тронута — там цвет намеренно совпадает с положением иглы на шкале рядом.

Пока тест короче минимальной длительности (вердикта ещё нет), обе карточки красятся как раньше, по зоне: иначе одно и то же число выходило бы двумя разными цветами.

Обновление уже настроенной платы

Файлом radex-gw-idf.bin на смещение 0x20000 — сеть, привязка прибора и история сохраняются. firmware.factory.bin на 0x0 — только для первой прошивки: он стирает настройки.

v1.9.0 — расчёт по методике, согласованный интервал, выбор периода мышкой

Choose a tag to compare

@Verter73 Verter73 released this 05 Sep 18:58

Расчёт по методике и согласованный доверительный интервал

«Расчёт по методике» — раскрывающаяся вкладка под заключением на «Графиках» и на вкладке «Заключение». Внутри: режим вентиляции, 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).