mirror of
https://github.com/NickoScope/nickol-knx-mcp.git
synced 2026-09-29 19:31:12 +02:00
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:
co-authored by
Claude Opus 4.8
parent
a6a5e68444
commit
bba0b33614
@@ -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
@@ -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-маппинга + следующие шаги).
|
||||
|
||||
|
||||
Reference in New Issue
Block a user