mirror of
https://github.com/bahmcloud/HA-KNX-Bridge.git
synced 2026-04-06 16:51:14 +00:00
67 lines
3.1 KiB
Markdown
67 lines
3.1 KiB
Markdown
# Project State: HA KNX Bridge
|
|
|
|
## Project Description
|
|
HA KNX Bridge is a Home Assistant custom integration that mirrors Home Assistant entities
|
|
to KNX group addresses and accepts KNX actions to control Home Assistant entities.
|
|
It is installed via HACS and configured through the Home Assistant UI (config flow).
|
|
The integration should:
|
|
- Reuse an existing Home Assistant KNX integration entry when available.
|
|
- Allow users to add "Ports" that bind a single HA entity to KNX group addresses.
|
|
- Auto-select appropriate KNX DPTs and request only the group addresses needed.
|
|
- Ignore missing/empty group addresses without errors.
|
|
|
|
Target compatibility: Home Assistant 2025.12 with forward compatibility to 2026.2.
|
|
|
|
Project rules:
|
|
- Keep `README.md` updated for user-relevant changes after each new version.
|
|
- Maintain `CHANGELOG.md` with newest entries at the top.
|
|
- Releases are created only when explicitly requested.
|
|
- Version number must match everywhere it is referenced (manifest, changelog, README, HACS if used).
|
|
|
|
## Current State (as of 2026-02-15)
|
|
Completed:
|
|
- Repo initialized with `main` branch and pushed to GitHub.
|
|
- HACS metadata (`hacs.json`) and base integration scaffold created.
|
|
- Config flow created with subentries ("Ports") for:
|
|
- Binary Sensor
|
|
- Cover
|
|
- KNX group address validation and normalization in subentry flows.
|
|
- Options flow skeleton added (no options yet).
|
|
- `bcs.yaml` metadata file added for BCS store listing.
|
|
- Switch port support added (KNX command + state).
|
|
- Per-address invert toggles added for incoming/outgoing payloads.
|
|
- DPT auto-selection centralized for KNX event registration.
|
|
- Port devices and enable switches added for quick overview and toggling.
|
|
- Bridge manager implements:
|
|
- Binary sensor state -> KNX send (DPT 1)
|
|
- Cover KNX incoming commands -> HA services
|
|
- Cover HA state -> KNX percent updates (DPT 5.001)
|
|
- README includes initial DPT mapping and roadmap.
|
|
- Incoming invert toggles removed; outgoing inversion remains only for state addresses.
|
|
- Light port support added with full KNX color/temperature mappings and individual color channels.
|
|
- Light port keys renamed to avoid conflicts; outgoing updates now only target light state addresses.
|
|
- Light port optional relative dimming address (DPT 3.007) added.
|
|
- Light color temperature event type mapping and relative dimming decoding fixed.
|
|
- Relative dimming step mapping tuned to avoid on/off jumps.
|
|
- Relative dimming now repeats steps until a stop telegram is received.
|
|
- Relative color temperature steps (DPT 3.007) added for lights.
|
|
- Project version set to 0.0.27 and `CHANGELOG.md` maintained.
|
|
|
|
Files created:
|
|
- `custom_components/ha_knx_bridge/__init__.py`
|
|
- `custom_components/ha_knx_bridge/bridge.py`
|
|
- `custom_components/ha_knx_bridge/config_flow.py`
|
|
- `custom_components/ha_knx_bridge/const.py`
|
|
- `custom_components/ha_knx_bridge/manifest.json`
|
|
- `custom_components/ha_knx_bridge/strings.json`
|
|
- `hacs.json`
|
|
- `README.md`
|
|
- `CHANGELOG.md`
|
|
- `.gitignore`
|
|
|
|
Open items / next steps:
|
|
- Add optional option flow for future settings.
|
|
- Expand entity coverage (light, switch, sensor, climate).
|
|
- Add tests (config flow, KNX mapping).
|
|
- Improve DPT auto-selection logic per entity features.
|