Skip to content

v1.0.1 — вес уплотнённых точек в заключении, канон CSV, импорт истории; образы v1.0.0 отозваны

Choose a tag to compare

@Verter73 Verter73 released this 01 Sep 21:45
· 75 commits to main since this release

Версия исправляет обработку истории измерений: заключение о соответствии считается по взвешенному среднему, формат выгрузки приведён к постоянной арности, доступ к файлу истории синхронизирован между задачами, добавлен штатный импорт ранее выгруженной истории. Образы предыдущего релиза 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