From bba0b33614bb80e083db831cffa4889bdc0b3ee0 Mon Sep 17 00:00:00 2001 From: Nikolay Miroshnichenko Date: Tue, 30 Jun 2026 20:46:02 +0200 Subject: [PATCH] docs(readme): document colour/climate assembly + GA-intent noise reduction Root README + RU now list the Track A/D capabilities: GA-intent classification (reserve/logic/scratch kept out of error & missing-status checks), colour light assembly (RGBW/RGB/CCT) and climate entity generation, with the real 685-GA Zennio validation figure (false errors 29 -> 6). Co-Authored-By: Claude Opus 4.8 --- README.md | 14 +++++++++++--- README.ru.md | 3 ++- 2 files changed, 13 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 1b84e06..7d791da 100644 --- a/README.md +++ b/README.md @@ -103,9 +103,17 @@ The recommended full setup is four layers; only one needs to be built from scrat tokens rather than by middle-group adjacency). - **Catches DPT problems**: missing DPT, mismatch between a Communication Object and its GA, and the same logical name carrying different DPTs. -- **Generates Home Assistant KNX YAML** — category by category, conservatively: covers → lights → - switches → sensors/binary. Ambiguous items (e.g. DPT 5.001 — brightness vs blind position) are - **not guessed**; they go into a `review` list instead. +- **Classifies GA purpose to cut noise** — every group address is tagged `functional` / `reserve` / + `logic` / `scratch`. Intentional non-functional GAs (spare "Reserve" placeholders, internal logic + signals, scratch leftovers) are kept out of the error and missing-status checks, so the report + doesn't cry wolf on real projects (e.g. a 685-GA Zennio project: false errors 29 → 6). +- **Generates Home Assistant KNX YAML** — category by category, conservatively: covers → + **colour / dimmable lights** → switches → **climate** → sensors/binary. Multi-address entities are + **assembled**: lights gather on/off + brightness + **RGBW / RGB / colour-temperature** + their + statuses; `climate` entities gather current temp, target-temp status, operation/controller mode and + valve command-value (emitted only when the HA-required keys are present, else sent to review). + Ambiguous items (e.g. DPT 5.001 — brightness vs blind position) are **not guessed**; they go into a + `review` list instead. - **Generates ETS-importable** group addresses in **XML** (the recommended `knx.org/xml/ga-export/01` schema) and **CSV** (ETS's native layout). - **Writes a Markdown report** (inventory + 🔴🟡🔵 findings + HA-mapping preview + next steps) for diff --git a/README.ru.md b/README.ru.md index 0368d8e..65b372a 100644 --- a/README.ru.md +++ b/README.ru.md @@ -75,7 +75,8 @@ KNX Community в мае 2026 прямо просит такую интеграц - **Проверяет именование** по 3-уровневой структуре и регэкспу. - **Находит отсутствующие статусные адреса** — приоритетно по ролям из ETS Functions, как fallback — по парности имён (token-overlap). - **Ловит проблемы DPT**: отсутствующий DPT, рассогласование DPT между Communication Object и GA, одинаковое имя с разными DPT. -- **Генерирует Home Assistant KNX YAML** — категорийно, консервативно. Неоднозначные элементы уходят в список `review`, а не угадываются вслепую. +- **Классифицирует назначение GA, чтобы убрать шум** — каждый адрес помечается `functional` / `reserve` / `logic` / `scratch`. Намеренно нефункциональные GA (запасные «Резерв», внутренние логические сигналы, мусорные остатки) исключаются из проверок ошибок и missing-status, чтобы отчёт не «кричал волки» на реальных проектах (на боевом 685-GA Zennio: ложных ошибок 29 → 6). +- **Генерирует Home Assistant KNX YAML** — категорийно, консервативно: обложки → **цветной / диммируемый свет** → выключатели → **климат** → датчики. Многоадресные сущности **собираются**: свет — вкл/выкл + яркость + **RGBW / RGB / цветовая температура** + их статусы; `climate` — текущая t°, статус уставки, режим (operation/controller) и % клапана (эмитится только при наличии обязательных HA-ключей, иначе → в `review`). Неоднозначные элементы уходят в `review`, а не угадываются вслепую. - **Генерирует ETS-импортируемые** group addresses: **XML** (схема `knx.org/xml/ga-export/01`) и **CSV** (родная раскладка ETS). - **Пишет Markdown-отчёт** (инвентаризация + находки 🔴🟡🔵 + превью HA-маппинга + следующие шаги).