Skip to content

v1.0.0 — шлюз на чистом ESP-IDF: корневой фикс BLE-переподключения. Рациональный критерий оценки соответствия по НРБ-99/2009

Choose a tag to compare

@Verter73 Verter73 released this 01 Sep 16:07
· 79 commits to main since this release

Бинарные образы этого релиза отозваны и удалены. Используйте
v1.0.1,
собранный из того же исходного кода. Скачивавшим v1.0.0 — обновиться.

Текст релиза ниже оставлен без изменений.


v1.0.0 — шлюз на чистом ESP-IDF: корневой фикс BLE-переподключения. Рациональный критерий оценки соответствия по НРБ-99/2009

Пять предыдущих релизов этой ветки собраны на ESPHome. В firmware-idf/ — независимая
реализация того же шлюза Radex MR107ion, написанная напрямую на C поверх ESP-IDF, без
ESPHome как прослойки между кодом и BLE-стеком Bluedroid.

Почему смена архитектуры

ESPHome не экспонирует в конфигурацию управление фичесетом контроллера Bluetooth —
именно там лежал корневой дефект переподключения, разобранный в KNOWN_ISSUES.md
(INC-BLE50-001): при одновременно включённых наборах BLE 4.2 и BLE 5.0 стек Bluedroid
после разрыва связи молча переключает следующую попытку esp_ble_gattc_open() с LEGACY
на EXTENDED create-connection (opcode 0x2043), а контроллер, однажды увидевший разрыв,
отвечает на этот opcode Cmd Disallowed навсегда — восстанавливается только сбросом
питания. ESP-IDF даёт доступ к sdkconfig напрямую, и фикс — исключение набора функций
BLE 5.0 из сборки (CONFIG_BT_BLE_50_FEATURES_SUPPORTED=n), а не обход симптома.

Фикс применён и проверен на живой плате тестового стенда (лог контроллера подтверждает
BLE_50:0, строка is_aux auto-set to true в собранном образе отсутствует, символ
btsnd_hcic_ble_ext_create_conn не слинкован). Живьём воспроизведён и вылечен разрыв
класса неудачи установления соединения (rsn=0x3e) — восстановление прошло без единого
Cmd Disallowed. Честная граница проверки: исходный сценарий жалобы — разрыв уже
установленного соединения (rsn=0x8) — за время наблюдения на стенде не повторился и
специально не провоцировался; подтверждение по нему косвенное (расширенный путь
соединения не слинкован в образ вообще). Watchdog остаётся второй линией защиты
независимо от исхода этой гипотезы: серия подряд неудачных открытий соединения приводит
к программной перезагрузке.

Совместимость с прошивкой прибора 1.8

Прибор с прошивкой 1.8 требует от центрального устройства двух условий, без которых связь
не работает или рвётся через 5-12 секунд. Оба выполнены в этой сборке.

Первое: отключение автоматического service discovery Bluedroid
(BTA_GATTC_AutoDiscoverEnable(0), вызывается из обработчика ESP_GATTC_REG_EVT). Стек
запускает discovery на каждом соединении независимо от кода приложения; на MR107ion он не
завершается, и запросы чтения встают в очередь позади него. Симптом выглядит как отказ
прибора, хотя запросов он не получает.

Второе: включённый GATT-сервер на стороне шлюза (CONFIG_BT_GATTS_ENABLE=y). Прибор не
обслуживает запросы, пока не получит ответ на собственный Exchange MTU Request.

Разбор — KNOWN_ISSUES.md, INC-FW18-001. Первоначальный вывод о несовместимости самой
прошивки 1.8 не подтвердился: причина была на стороне шлюза, прибор исправен.

Что ещё входит

  • Рациональный критерий оценки соответствия по НРБ-99/2009 — отдельная вкладка Web UI:
    выбор норматива (200 или 400 Бк/м³), формула суммарной неопределённости, заключение о
    соответствии, синхронизированное между вкладками «Показания» и «Рациональный метод».
    Методика радиационного контроля радона (Цапалов и др.) публикуется вместе с прошивкой.
  • Watchdog — независимая от корневого фикса линия защиты на случай непредвиденного
    зависания BLE-стека.
  • Кнопка программной перезагрузки в Web UI.
  • Множество вкладок вместо одной плоской таблицы, полноэкранный график с
    hover-подсказкой, адаптация раскладки под мобильный экран.

Установка

Готовый образ — для платы ESP32-S3-DevKitC-1 N16R8 (16 МБ flash, 8 МБ PSRAM).

  • radex-gw-idf-v1.0.0-factory.bin — полный образ (bootloader + таблица разделов +
    приложение), заливать на смещение 0x0.
  • radex-gw-idf-v1.0.0-app.bin — только приложение, для платы с уже установленным
    загрузчиком, заливать на смещение 0x20000.
  • sha256sums.txt — контроль целостности обоих файлов.

Сборка из исходников — Docker-образ espressif/idf:v6.1, подробности в README раздела
«Альтернативная архитектура: чистый ESP-IDF».

SHA256: radex-gw-idf-v1.0.0-app.bin 0dd8f47db412a64069ac4c0e7ff0f1c2b9c9c8c9fb4e09079e6950c4aab61c15
SHA256: radex-gw-idf-v1.0.0-factory.bin 6764430cfcb00bc1df7a0d9d3785c783f0f6f7193e245f5d9202e95e9accb554