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-маппинга + следующие шаги).