Repository navigation
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 строк); если места на временный файл нет, оно пропускается с предупреждением;
историю меньше 256 КБ оно не трогает. Побочный эффект: история разрежается вдвое раньше прежнего описания
(≈ 34 000 строк вместо ≈ 52 800, то есть примерно через 8 месяцев при цикле 10 минут вместо года).
Что проверено
- Хост-тесты —
pwsh -File test/host/run.ps1(gcc в образеespressif/idf:v6.1,-Werror -Wextra, c99):
16 наборов на C собраны и прошли (C-TESTS: built=16 failed=0), всего 499 проверок (332 строкиokв C-наборах и 167GREENв остальных), красных 0. Боевые резервные копии платы не публикуются: в публичном чекауте без нихtest_hist_replace.cпечатаетSKIP, шесть строк «боевой вход» пропадают, и остаётся 493 проверки (326okи 167GREEN), красных 0 (проверено запуском набора без резервных копий).
Набор архивной части:test_radex_archive.c(чтение потока до 65 536 записей, порча потока, дедуп на границах окна,
ёмкость,?max=; сценарий платы: две сессии 264 + 144, второй заголовок описывает одну сессию — старое чтение даёт 264 записи
и отказpartial, чтение по первому заголовку — 408),test_hist_merge.c(слияние по времени, внедрённые сбои, оборванный хвост, ёмкость по обоим
файлам, худшая строка ровно 45 Б),test_hist_reconcile.c(файл замера: сглаженные пары, граница 30/31 с, дубль ровно
180 с),test_hist_swap.c(замена и восстановление с обрывом питания на каждом шаге, отказыrename),
test_live_match.c(все фазы 0…период опроса с шагом 10 с для шести пар цикл/опрос: (600, 600), (600, 300),
(600, 60), (600, 10), (1200, 600), (3600, 600); файл замера — для трёх из них; защита живой точки от повтора;
перекрёстный тест одного порядка пометки в двух местах),test_hist_replace.c(режим замены: боевые копии
данных платы, синтетика, идемпотентность, сбой на каждом шаге замены, отмена, обрыв питания, 65 536 записей,
условия отказа),test_archive_ui.js(тексты и проводка страницы). - Боевой вход режима замены (только при наличии резервных копий платы, они не публикуются): копии файлов платы до ремонта (история 581 строка, файл замера 585 строк): в
границах остаются ровно записи архива (392), порядок, пар «живая + архивная» нет; вне границ (левее начала и
правее хвоста 660 с) строки на месте; повторная замена ничего не меняет и файл не переписывает.
Архив в этом тесте восстановлен по истории (сетка 600 с), а не прочитан с прибора: реального дампа архива в
тестовых данных нет, поэтому тест доказывает логику замены, а не совпадение с приборным архивом. - Мутационная проверка —
test/host/mutate.sh(в образе с gcc):МУТАЦИЙ: 57, не сработали как ожидалось: 0(запуск на чистой выгрузке коммита). Каждая порча исходника краснит
ожидаемое число проверок и только их; новые для исправления заголовка: сверка с total первого заголовка и с заявленным числом записей; новые для исправлений перед выпуском: пустая история при восстановлении, устаревший.new, строгий разбор запроса; новые для режима замены: хвост правее последней записи не убирается, убирается
лишнее слева от границ, в границах ничего не убирается, точно совпавшая строка не узнаётся, отказыchain,
partial,holeубраны, подсчёт без записи не считает новые строки; а также оборванный хвост при слиянии,
восстановление с остаточным.bak, общий порядок пометки, окно защиты живой точки, размер строки в расчёте ёмкости. - Сборка из чистой выгрузки коммита (
git archive, без локальногоsdkconfig, безbuild/), версия в образе
v1.14.1; образ собран с флагом релизной сборки (сетевых данных нет), маркера локальной сборки в образах нет. - Серийный номер прибора в образе не встречается: в образе, включая распакованные gzip-блоки, проверены четыре
подстроки (серийный номер, его латинский префикс, транслитерация слова из примера имени файла и само русское слово
с заглавной буквы; значения не публикуются) — совпадений нет. Серийный номер остаётся в старой публичной истории; переписывание истории не выполнялось. - Секрет-скан. Дельта
v1.13.1..415714f, эти примечания, а также образы и распакованные из них gzip-страницы
проверены закрытым списком шаблонов (содержит реальные значения и потому не публикуется) и эвристиками (MAC, IP,
адреса, пути, токены): в добавленных строках 34 изменённых файлов (полное содержимое каждого на коммите тоже просмотрено) совпадений нет; в полных файлах остались только совпадения, которые уже были в v1.13.1 (публичные UUID в README, адрес точки доступа портала192.168.4.1и примеры в INSTALL); в образах и распакованных gzip-блоках — адрес точки доступа портала192.168.4.1, заглушкиAA:BB:CC:DD:EE:FFи192.168.1.100, хвост WebSocket GUID из RFC 6455 в библиотекеhttpd(12 шестнадцатеричных знаков; к прибору не относится) и одно ложное совпадение короткого закрытого шаблона с шестнадцатеричным цветом в CSS страницы; авторы и коммитеры всех коммитов дельты — адресаusers.noreply.github.com. Скрипт скана с этим списком в репозиторий не кладётся. Штатный
scripts/check_binary_secrets.pyбез файлаsecrets_known.txt(он не публикуется) отвечает «Список секретов
пуст. Проверка не проводилась» — это НЕ «чисто».
Что не проверено (на плате не проверялось)
- Защита живой точки от повтора после загрузки архива; восстановление после потери питания на каждом шаге замены
файла (проверено только хост-тестом с внедрёнными сбоями). - Запас стека
httpdпри «Сохранить N точек в историю» (слияние идёт в задаче однопоточногоhttpd; время слияния
файла до 2 МБ на SPIFFS не измерено; страница на это время не отвечает). - Пик PSRAM при слиянии предельного архива (по расчёту до 6–7 МБ из 8 МБ); скорость записи и слияния в SPIFFS для
десятков тысяч строк; реальное время чтения большого архива (расчёт ≈ 0,15 с на страницу из 22 записей; для 52 560
записей — ≈ 2 390 страниц, около 6 минут). - Прибор: 2 сессии; записей было 278 на момент первой трассы, в ходе проверок 19.09 — 333, 384, 392, 401, 408, 409 и
425 (прибор копит запись раз в 10 минут); тысячи записей и поведение при заполнении истории проверить нечем. - Заголовок
0x0C0Dпо трассам RadexDC (не публикуются) занимает 486 байт и перечисляет до 26 сессий; что прибор
возвращает при большем числе сессий, не известно (у него 2). - Установка часов (
0x0006), чтение журнала по BLE в универсальной сборке, включение Bluetooth флажком — как и
раньше не проверены.
Известные ограничения
- Импорт истории пишет строки как прислали, не сортирует и не убирает дубли (порядок починит следующая загрузка
архива); живая точка добавляется по времени прихода — шаг часов назад нарушит порядок. - Повторная загрузка архива в прореженный участок восстанавливает строки с весом 1: сумма весов больше числа
измерений (режим замены заменяет участок целиком строками веса 1). - Живое значение, сдвинутое на цикл относительно архива, при обычной загрузке не сопоставляется; по данным платы
такого сдвига нет. Режим замены от этого не зависит. - Замена файла через
.bakпокрывает слияние, прореживание, уплотнение, перенос заголовка, перестройку и импорт;
remove+renameбез восстановления остался у файла подписей меток. При потере питания между двумяrename
выбор идёт по числу строк: заменённая версия с меньшим числом строк может откатиться к прежней (данные целы,
операцию надо повторить). - Колонка
radon_avgнеоднородна: у живых точек — средняя сессии, у записей архива и журнала — скользящее среднее,
у импорта — копияradon. - Время записи — часы прибора плюс поправка на момент чтения (±1 с между загрузками); если часы прибора ставились
неверно, записи старых сессий получат неверное время. - Сквозной индекс — 16 бит, не более 65 536 записей.
- Уплотнение оставляет последнюю сжатую группу в конце файла (порядок временно нарушается, отсев повтора живой точки
перестаёт работать, следующая загрузка архива идёт слиянием); импорт истории не сортирует и не убирает дубли;
уплотнение удаляет группы со средним ОА ровно 0 (как в v1.13.1). - Замена участка идёт в два шага (история, затем файл идущего замера); при отмене или потере USB между шагами получается
partial, повторный запуск довершит. Единая поправка часов прибора на все сессии: ручной перевод часов или переход на
летнее время сдвигает записи старых сессий, границы замены — от минимальной до максимальной метки по всем записям;
перед реальной заменой сверьте границы и число удаляемых строк по подсчётуdry=1. - Если не проходят ни
remove, ни переименование устаревшегоmrg_*.newв.wip, при следующем старте.newс большим
числом строк заменит историю с меньшим (в лог пишется ошибка). - Запас стека
httpdпри слиянии (Сохранить N точек в историю) не измерен (оценка по-fstack-usage:
hist_merge_commit_ex848 Б,radex_arch_read_body608 Б).