Repository navigation
v1.0.1 — вес уплотнённых точек в заключении, канон CSV, импорт истории; образы v1.0.0 отозваны
Версия исправляет обработку истории измерений: заключение о соответствии считается по взвешенному среднему, формат выгрузки приведён к постоянной арности, доступ к файлу истории синхронизирован между задачами, добавлен штатный импорт ранее выгруженной истории. Образы предыдущего релиза v1.0.0 отозваны — используйте эту сборку.
Заключение о соответствии: взвешенное среднее
История измерений хранится с уплотнением: старые записи сворачиваются в одну строку, за которой стоит несколько исходных измерений. Расчёт заключения этот вес не учитывал — свёрнутая строка входила в среднее наравне с одиночным измерением, и вклад давних суток занижался пропорционально глубине свёртки.
Введён вес строки, и вместе с ним пересмотрены три производные величины (#RADEX-177, #RADEX-178, #RADEX-179):
- шаг между отметками времени определяется числом строк, а не числом измерений: пять суточных строк дают шаг «сутки», деление на 72 измерения дало бы полтора часа — интервал, которого в файле нет;
- погрешность среднего считается как u(μ) = √( Σwᵢ(xᵢ−μ)² / ((n−1)·Σw) ). Прежняя формула принимала сумму весов за число независимых наблюдений и занижала погрешность примерно в четыре раза при пяти строках, покрывающих 72 измерения;
- аварийное прореживание при переполнении файла переносит вес отброшенной строки на следующую сохранённую. Прежде каждое срабатывание вдвое занижало и число точек, и вклад давних данных — необратимо и без каких-либо признаков в интерфейсе.
Формат выгрузки: шесть колонок постоянно
Заголовок CSV объявлял пять колонок, тогда как уплотнённые строки содержали шесть; шестое поле оставалось безымянным, и выгрузка в табличный процессор сдвигалась по столбцам (#RADEX-175). Принят канон постоянной арности: колонок всегда шесть, заголовок time,radon,radon_avg,temp,hum,n, где n — число измерений, стоящих за строкой. Для неуплотнённой строки n = 1.
Выбор в пользу постоянного числа колонок, а не заголовка, меняющегося по содержимому файла: потребитель формата, разбирающий файл однократно, не обязан пересматривать разбор в середине.
Синхронизация файла истории
Файл /data/radon.csv записывается задачей стека BLE по приходу измерения и читается задачей веб-сервера; взаимного исключения между ними не было (#RADEX-172). Доступ синхронизирован, а механизм сериализации тяжёлых файловых операций http_io_gate подключён к трём обработчикам, ранее работавшим с файлом напрямую (#RADEX-171).
Попутно устранён дефект уплотнения: единственная функция модуля держала путь к файлу зашитым вместо того, чтобы брать его из настройки (#RADEX-173). На рабочей плате это не проявлялось, поскольку зашитый путь совпадал с настроенным.
Импорт истории
Добавлен эндпоинт POST /api/history/import (#RADEX-182). Ранее выгруженный CSV возвращается на плату штатным образом; прежде выгрузка существовала без парного восстановления, и перенос истории требовал заливки образа раздела внешним инструментом.
Влажность 255 в уплотнённых строках
Значение 255 в поле влажности порождалось самим уплотнением, а не датчиком: при отсутствии показаний в группе поле заполнялось значением-заглушкой, неотличимым от результата измерения (#RADEX-176). Проверка по сырой выгрузке подтвердила, что в исходных данных таких значений нет ни одного. Отсутствующая влажность теперь остаётся пустой.
Загрузка в резервный раздел после снятия питания
После полного снятия питания плата могла загрузиться в раздел ota_1, содержащий постороннюю прошивку, оставшуюся от прежних экспериментов (#RADEX-181). Признак — отсутствие эндпоинтов /api/stats и /api/data при исправном ответе /api/system с чужим набором полей.
Причина в том, что раздел выбора загрузки не переписывался вместе с приложением. Комплект образов релиза включает ota_data_initial.bin и файл flash_args с полным перечнем смещений; заливать следует весь комплект, а не только образ приложения.
Состав релиза
| Файл | Смещение | Назначение |
|---|---|---|
radex-gw-idf.factory.bin |
0x0 | полный образ, включает загрузчик, таблицу разделов и выбор загрузки |
firmware.factory.bin |
0x0 | тот же образ под именем, которое ожидает автообновление флешера |
radex-gw-idf.bin |
0x20000 | образ приложения (для обновления по OTA) |
bootloader.bin |
0x0 | загрузчик |
partition-table.bin |
0x8000 | таблица разделов |
ota_data_initial.bin |
0xf000 | исходное состояние выбора загрузки |
flash_args |
— | перечень смещений для esptool |
sha256sums.txt |
— | контрольные суммы перечисленных файлов |
Целевая плата — ESP32-S3 с флеш-памятью 16 МБ. Первая заливка — radex-gw-idf.factory.bin на смещение 0x0. Сохранённые в энергонезависимой памяти параметры сети при этом не затрагиваются: раздел nvs (0x9000) в перечень смещений не входит.
SHA256: firmware.factory.bin 469ba0348c40395e8ec7d45749b966fb4dab5d22bb5c0dc452bce5e2d0a253c6