diff --git a/family/how-to/zont-config-compiler.md b/family/how-to/zont-config-compiler.md index 97403427..be07fce3 100644 --- a/family/how-to/zont-config-compiler.md +++ b/family/how-to/zont-config-compiler.md @@ -21,7 +21,7 @@ tags: - homeautomation title: ⚙️ ZONT Config Compiler — конвертеры .txt ⇄ .yml type: how-to -updated: 2026-09-17l +updated: 2026-09-17m --- # ⚙️ ZONT Config Compiler — конвертеры `.txt ⇄ .yml` @@ -474,14 +474,37 @@ scenarios: | `50`, неизвестные | `raw: […]` | `{id: 8548, raw: [50, 1, 0, 0, 109]}` | **Type 9 — команда (реле / контур / режим).** Формат в конфиге: `[9, '<подпись>', , '<значение>']`. -`target` разворачивается в `target_name` + `target_type`; `value` — строка (`'1'`/`'0'` или id-ссылка). +`target` разворачивается в `target_name` + `target_type`; `value` — строка (`'1'`/`'0'` или **код уставки**). Проверено: `9826`→тип 14 (реле), `8641`→тип 16 (контур `Спальня`), `8640`→тип 20 (режим `Режим отопления`), `8470`→тип 16 (`Контур ГВС`, значение `'8574'`). -⚠️ **Поле 4 (`'2968'`, `'8574'`, `'1'`) — не значение уставки, а ссылка/код** (напр. `'2968'` при -тексте «температуру 23.8»). Семантику поля 4 **Alex не подтверждал** — не выводить её из подписи. + +🔴 **Поле 4 у команды «установить температуру» — ЗАКОДИРОВАННАЯ УСТАВКА, а не ссылка** +(подтверждено 3 точками 2026-09-17): + +```text +код = (t_celsius + 273) * 10 обратно: t_celsius = (код - 2730) / 10 +``` + +| Уставка | Код | | +|---|---|---| +| 22 | 2950 | ✅ | +| 23.8 | 2968 | ✅ | +| 5.2 | 2782 | ✅ | + +В YAML: `value: '2782'` (источник истины) + `temp_c: 5.2` (раскодировано, **только** при точном +совпадении формулы). При `value == '1'/'0'` добавляется `state_on: true/false`. +⚠️ Раньше в этой доке было ошибочно записано, что поле 4 — «ссылка, семантику Alex не подтверждал». +**Теперь подтверждено.** Подробности — [[family/tech/zont-scenario-logic-11109]] §8.13. **Type 5 — действие над выходом.** Формат: `[5, '<имя>', , , …]`. -`output_id = output_ref >> 4`. Остальные непустые поля → `params`. +`output_id = output_ref >> 4` (для `9500`: `145728 >> 4 = 9108`). Остальные непустые поля → `params`. +В YAML: `{action, output, output_id, value, params?}`. + +**`objcmd "1 %0"` (type 59)** → в YAML `{script, args, target, target_name, set_value}`, +где `set_value = args[0]` — значение, записываемое в объект `target` +(напр. `objcmd 8700 …`, arg `14.5` → «Температура Детская = 14.5»). +🔴 **Питфолл имён:** у типа 1 имя в **поле 2**, не в поле 1 (`#Z8700=1,'0','Температура Детская',…`). +Использовать хелпер `_object_display_name(fields)`, иначе `target_name` = `'0'`. **Операторы type 47 (порядок UI `<, >, =, <=, >=`):** `0`=`<`, `1`=`>`, `2`=`=`, `3`=`<=`, `4`=`>=`. **Логика type 48:** `0`=`and`, `1`=`or`, `2`=`not`. @@ -522,6 +545,8 @@ scenarios: | 4 | 🔴 **Порядок сценария терялся** | `blocks` первым + `extra_links` голыми id → сценарий = список цифр | **Плоский `steps[]` вместо `blocks`/`extra_links`** | | 5 | 🔴 **Отдал артефакт, не прочитав сам** | Round-trip «байты сходятся» ≠ «читаемо». Alex открыл YAML и увидел в `8456` первым блоком `if`, а до него — список цифр | Читать глазами **главный/сложный кейс**, а не только простые 1-блочные сценарии. Питфолл 21 | | 6 | **Много `raw` в шагах** | type 9/5 рендерились как `raw: [...]` хотя поля прозрачны | Раскрыты (§5c, «Type 9 / Type 5»). raw остался только у SMS (`3`) и непонятных (`50`) | +| 7 | 🔴 **Уставка температуры принята за ссылку** | Поле 4 type 9 (`'2950'`) выглядело как id отсутствующего объекта | Это **уставка в Кельвинах×10**: `код = (t+273)*10`. **Не вшивать формулу на 2 точках** — ждать ≥3 (§8.13) | +| 8 | **`target_name` = `'0'`** | У типа 1 имя в **поле 2**, не в поле 1 | Хелпер `_object_display_name(fields)` со спец-случаем типа 1 | **Обязано сохраниться байт-в-байт (сохранено):** - порядок объектов в файле (45 идёт **после** 11, но **до** 46) @@ -734,13 +759,17 @@ https://lk.zont-online.ru/download/firmwares/H2000_PRO____.zip ✅ **Round-trip чистый на 6/6 конфигах** (включая новый локальный с 660 `#Z` и legacy 7-поле `-2`). +✅ **Уставка температуры раскодирована** — `код = (t °C + 273) × 10`, подтверждено 3 точками +(§8.13 в [[family/tech/zont-scenario-logic-11109]]). Type 9/5 и `objcmd` рендерятся читаемо. + | Файл | Статус | |---|---| -| `config-to-yml.py` | 🆕 **изменён** — парсер типов 47/48/50/59, плоский `steps[]`, триггер, type 9/5 раскрыты, raw-фоллбэк (§5c). **не закоммичено** | +| `config-to-yml.py` | 🆕 **изменён** — парсер типов 47/48/50/59, плоский `steps[]`, триггер, type 9/5 раскрыты, `temp_c`/`state_on`/`set_value`, `_object_display_name`, raw-фоллбэк (§5c). **не закоммичено** | | `yml-to-config.py` | 🆕 **изменён** — обратные `emit_*`, `emit_step` по типу, новые секции в `TYPE_ORDER` (§5c). **не закоммичено** | | `test_roundtrip.py` | ✅ в коммите `199f2b1`, без изменений | -| `zont_config/config_local_2026-09-17_16-02-18.txt` | 🆕 **34 962 байт, 686 строк** — **ПОСЛЕДНИЙ** конфиг с тестовыми сценариями (Alex пересоздал: контур `Спальня`, режим `Режим отопления`). Снят с `http://192.168.0.50/config.txt`. **не в git** | -| `zont_config/config_local_2026-09-17_16-02-18.yml` | 🆕 разобранный YAML (**финальная форма**) — round-trip ✅. **не в git** | +| `zont_config/config_local_2026-09-17_16-13-28.txt` | 🆕 **34 963 байт** — **ПОСЛЕДНИЙ** конфиг (уставка 5.2 + «Температура Детская» = 14.5). Снят с `http://192.168.0.50/config.txt`. **не в git** | +| `zont_config/config_local_2026-09-17_16-13-28.yml` | 🆕 разобранный YAML (**финальная форма**), round-trip ✅. **не в git** | +| `zont_config/config_local_2026-09-17_16-02-18.txt` / `.yml` | 34 962 байт, 686 строк — предыдущий (контур `Спальня`, режим `Режим отопления`). **не в git** | | `zont_config/config_local_2026-09-17_14-16-35.yml` | 🆕 разобранный YAML (предыдущий конфиг, 6110 строк). **не в git** | | `zont_config/config_local_2026-09-17_14-16-35.txt` | 34 907 байт, 660 `#Z` — предыдущий с тестовыми сценариями. **не в git** | | `zont_config/config_0FA7C33CC89F_…_2026-09-17_12-12-28.txt` | 32 689 байт — свежий боевой конфиг, **не в git** | @@ -749,7 +778,7 @@ https://lk.zont-online.ru/download/firmwares/H2000_PRO____.zip | `zont_api_docs/` | ✅ локальная копия доки облачного API (`zont_api_docs.html`, `.txt`, `convert.py`). **не в git** | | `read_scenarios.py` | 🆕 **читаемый дамп сценария** — дерево если/то/иначе с именами. Токенайзер `split_top()`. **не в git** | | `dump_new_types.py`, `probe_types.py`, `trace_scenarios.py` | 🆕 скрипты разбора сценарных типов. Разбор — [[family/tech/zont-scenario-logic-11109]] §8.8. **не в git** | -| `probe_sched.py`, `verify_answers.py`, `check_ops.py`, `audit_8456.py`, `audit2.py`, `chk_extra.py`, `why_raw.py` | 🆕 проверочные скрипты. **не в git** | +| `probe_sched.py`, `verify_answers.py`, `check_ops.py`, `audit_8456.py`, `audit2.py`, `chk_extra.py`, `why_raw.py`, `fit_temp.py`, `fit_temp2.py` | 🆕 проверочные скрипты (в т.ч. подбор формулы уставки). **не в git** | | `~/rasputin-tmp/zont-util/` | ✅ настроечная утилита `H1000 Programmator` 2.8.5, прошивка `.enc`, `extract.py`. Разбор — §5g-2 | | `~/rasputin-tmp/zont-{auth-probe,recon,recon2,ws-probe}.js` | ✅ скрипты разведки локального WS. **не в git** | diff --git a/family/tech/zont-scenario-logic-11109.md b/family/tech/zont-scenario-logic-11109.md index 8cb239d5..320a39f4 100644 --- a/family/tech/zont-scenario-logic-11109.md +++ b/family/tech/zont-scenario-logic-11109.md @@ -19,7 +19,7 @@ tags: - homeautomation title: 🔁 ZONT — сценарная логика и конструктор (11/46/47/48/49/50/59/45/9/5) type: tech -updated: 2026-09-17e +updated: 2026-09-17f --- # 🔁 ZONT — сценарная логика и конструктор логики @@ -579,3 +579,82 @@ scenarios: `actions`) рендерятся как YAML-якоря `*id00N` (`8195`, `9500` в `8456`) — читается хуже, но байт-точно. **Артефакт:** `zont_config/config_local_2026-09-17_14-16-35.yml` (6110 строк) — в проекте, не в `/tmp`. + +### 8.13. 🔴 УСТАВКА ТЕМПЕРАТУРЫ — формула `код = (t °C + 273) × 10` (подтверждено 3 точками, 2026-09-17) + +**Главное открытие разбора type 9.** Поле 4 команды «Установить целевую температуру» — **не ссылка, +а закодированная уставка в Кельвинах ×10** (fixed point): + +```text +код = (t_celsius + 273) * 10 обратно: t_celsius = (код - 2730) / 10 +``` + +**Три подтверждённые точки** (Alex менял температуру в UI, я сверял с конфигом): + +| Уставка в UI | Код в конфиге | Проверка | +|---|---|---| +| `22` | `2950` | `(22 + 273) * 10 = 2950` ✅ | +| `23.8` | `2968` | `(23.8 + 273) * 10 = 2968` ✅ | +| `5.2` | `2782` | `(5.2 + 273) * 10 = 2782` ✅ (предсказано заранее, совпало) | + +> **Как это выглядит в конфиге:** сам код уставки лежит в поле 4, а **человекочитаемая** +> температура — только в текстовой подписи поля 2, которую контроллер собирает сам: +> `#Z8817=9,'Установить целевую температуру 5.2 для контура Спальня',10034,'2782'`. +> 🔴 **Раньше я ошибочно считал `'2950'`/`'2968'` «ссылкой на отсутствующий объект»** — +> это была уставка, просто закодированная. +> +> ⚠️ **Питфолл метода:** на **двух** точках линейная формула подбирается бесконечно многими +> способами. Я нашёл `(t+273)*10` на 22 и 23.8, но **не вшивал её в парсер**, пока Alex не дал +> третью точку (5.2). Правило: **≥3 точки, прежде чем кодировать формулу.** + +**Что раскрыто в YAML (type 9):** + +```yaml +- id: 8817 + command: Установить целевую температуру 5.2 для контура Спальня + target: 10034 + target_name: Спальня # развёрнуто из id (тип 16 = контур) + target_type: 16 + value: '2782' # код как в конфиге (источник истины) + temp_c: 5.2 # ← раскодировано, ТОЛЬКО если формула сходится точно +- id: 9826 + command: 'Включить реле «Реле 1: Конвектор кухня»' + target: 9263 + target_name: 'Реле 1: Конвектор кухня' + target_type: 14 # 14 = реле + value: '1' + state_on: true +``` + +`temp_c` появляется **только** при точном совпадении формулы (`|round(t*10)-(код-2730)| < 0.5`); +иначе остаётся голый `value`. `state_on: true/false` — только при `value == '1'/'0'`. + +### 8.14. `objcmd "1 %0"` — запись значения в объект + +Скрипт `#Z = [59, 'objcmd "1 %0"', <значение>, 0, <флаг>]` пишет `<значение>` +в объект ``: + +```yaml +- id: 8818 + script: objcmd 8700 "1 %0" + args: [14.5, 0, 1] + target: 8700 + target_name: Температура Детская # развёрнуто из id + set_value: 14.5 # ← «= 14.5» +``` + +🔴 **Питфолл имён:** у **типа 1** (виртуальный датчик) имя лежит в **поле 2**, а не в поле 1: +`#Z8700=1,'0','Температура Детская',…`. Наивный `fields[1]` даёт `'0'`. +Использовать хелпер **`_object_display_name(fields)`** — он знает про это исключение. +Проверено: `target_name` был `'0'`, после фикса — «Температура Детская». + +### 8.15. Финальное состояние конвертеров (2026-09-17, вечер) + +| Артефакт | Путь | Состояние | +|---|---|---| +| Сырой конфиг | `zont_config/config_local_2026-09-17_16-13-28.txt` | 34 963 Б, снят с `http://192.168.0.50/config.txt` | +| YAML | `zont_config/config_local_2026-09-17_16-13-28.yml` | в проекте, round-trip ✅ | + +Round-trip чистый на **6/6** конфигах (боевой, 3 архива, `14-16-35`, `16-13-28`). +Осталось два `raw`: `8195` (SMS, тело — YAML-якорь `*id002`) и `9500` (type 5, `params` содержит якорь). +