Petr Polezhaev
157df4e795
- PROTOCOL.md: полная спецификация (KDF, envelope/CBC-цепочка, local_reg, key exchange, commands.json 206/200, datapoint push, тайминги, таблицы свойств шаблонов A/B/F, облачный provisioning). Факты из APK помечены [APK], проверенные живыми экспериментами на AP-WC1E — [ПРОВЕРЕНО НА ПРИБОРЕ]: mDNS только :10276; лимит 2 LAN-сессии (3-я -> 503); принудительный re-key при возрасте сессии >= ~44с (единственный механизм самолечения десинхрона — 400/401 модуль игнорирует); записи не эхируются; delete_session освобождает слот. - LEGACY_ANALYSIS.md: причины рассинхрона (keep-alive 1200с вместо 10-15с + seq_no-фильтр) и перегрузки модуля; требования к новой реализации. - PLAN_CORE_LIBRARY.md: план C++20-библиотеки fglair-core (Linux + ESP-IDF), ключ lanip_key считается статичным, ротация — только ошибка + ручной перепровижининг. - PLAN_HOME_ASSISTANT.md: pyfglair (cffi wheel) + custom component, облачный provisioning только в config flow, ключ виден в диагностике для копирования в ESPHome. - PLAN_ESPHOME.md: external component, только ESP-IDF framework. - tools/probe_reference.py: эталонный клиент протокола (проверен на приборе end-to-end); tools/probe_mdns.py — mDNS-проба. - legacy/: снимок скрипта (апстрим gyro-labs/AirCon, вложенный клон не версионируется); apk/*.apk исключены из версионирования.
5.1 KiB
5.1 KiB
aircon / FGLair local control — документация
Реконструкция LAN-протокола FGLair (Fujitsu General, платформа Ayla) и планы реализации стека локального управления кондиционером.
Состав
| Файл | Назначение |
|---|---|
PROTOCOL.md |
Спецификация LAN-протокола: шифрование, эндпоинты, машина состояний, тайминги, свойства FGLair. Для людей и агентов. Факты помечены [APK] / [LEGACY] / [ПРОВЕРЕНО НА ПРИБОРЕ] / [HYP]. |
LEGACY_ANALYSIS.md |
Разбор legacy-скрипта: что верно, баги, причины «рассинхронизации ключей» и перегрузки модуля. |
PLAN_CORE_LIBRARY.md |
План C++20-библиотеки fglair-core (Linux + ESP-IDF). |
PLAN_HOME_ASSISTANT.md |
План HA-интеграции (pyfglair wheel + custom component). |
PLAN_ESPHOME.md |
План external component для ESPHome (только ESP-IDF framework). |
../tools/probe_reference.py |
Эталонный клиент протокола (проверен на приборе). |
../tools/probe_mdns.py |
mDNS-проба (<DSN>.local, порт 10276). |
Краткая выжимка протокола
- Модуль кондиционера (порт 80) сам подключается к серверу приложения (порт 10275):
local_reg.json(keep-alive/notify) →key_exchange.json→ pollcommands.json+ pushproperty/datapoint.json. - Шифрование: AES-256-CBC (no-padding, zero-pad) + HMAC-SHA256; ключи выводятся
из облачного
lanip_keyи двух пар (random, time). CBC-цепочка непрерывна в рамках сессии. - Ключевая механика надёжности (проверено на приборе): модуль игнорирует
400/401-ответы; единственное самолечение — принудительный re-key, который
модуль делает при получении
local_regдля сессии старше ≈44 с. Поэтому keep-alive должен быть 10–15 с — тогда любая рассинхронизация живет секунды, а не 20 минут (как в legacy-скрипте с интервалом 1200 с). - Максимум 2 LAN-сессии (телефон + сервер уживаются), третья — HTTP 503.
- Записи свойств не эхируются — состояние обновляется оптимистично, подтверждение через GET.
- Свойства FGLair (шаблоны A/B/F по oem_model):
operation_mode(0..6),fan_speed(0..4),adjust_temperature(×0.1 °C),display_temperature((v−5000)/100 °C), swing/заслонки, флаги economy/powerful/…, битмаскиop_status,device_capabilities. Полные таблицы — в PROTOCOL.md §8.
Ключевые решения (по уточнениям владельца)
lanip_keyстатичен (зашит в модуль; за 5 лет ротаций не было). Облако используется только для первового provisioning'а (HA config flow или CLIfglair-discover); при несовпаденииkey_id— устойчивая ошибка, лечение правкой конфига вручную. Для ESPHome ключ копируется из диагностики HA или получается CLI-той.- ESP-IDF везде (Arduino-фреймворк ESPHome не поддерживаем), язык ядра — C++20 (без исключений/RTTI/heap после init), public API — C++-классы + extern "C" шейм для cffi-bindings HA.
Порядок реализации
fglair-core(M0–M5) — ядро, mock-тесты, эталон уже проверен на приборе.pyfglair+ HA-интеграция (H1–H4) — параллельно с E1–E2.- ESPHome-компонент (E1–E4).
- Уточнение оставшихся неизвестных (PROTOCOL.md §10) по мере эксплуатации.
Источники
- APK FGLair 3.4.3 (
apk/com.fujitsu.fglair.apk): классыcom.aylanetworks.aylasdk.lan.*,com.fujitsugeneral.aylasdk.*,com.cafbit.netlib.dns.NetThread, JS-бандлassets/www/dist/build.js. - Legacy-скрипт (
legacy/) — форк hisense_ac; вложенный клон апстрима: https://github.com/gyro-labs/AirCon (лежит вlegacy/aircon/, не версионируется). - Живые эксперименты на AP-WC1E (сентябрь 2026): сессии, re-key, 401/400,
слоты/503, delete_session, записи, mDNS. Пробы:
tools/probe_*.py(история — сессия анализа; рабочие артефакты оставлены в tools/).