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 <noreply@anthropic.com>
This commit is contained in:
Nikolay Miroshnichenko
2026-06-30 20:46:02 +02:00
co-authored by Claude Opus 4.8
parent a6a5e68444
commit bba0b33614
2 changed files with 13 additions and 4 deletions
+11 -3
View File
@@ -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
+2 -1
View File
@@ -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-маппинга + следующие шаги).