bahmcloud/HA-KNX-Bridge
1
0
Fork 0
mirror of https://github.com/bahmcloud/HA-KNX-Bridge.git synced 2026-04-08 09:41:13 +00:00
Code Issues Packages Projects Releases Wiki Activity

Add light port support

Browse Source
This commit is contained in:
René Bachmann
2026-02-15 18:00:55 +01:00
parent c5ab9e854c
commit 7953cd25ba
48 changed files with 6122 additions and 495 deletions
Download Patch File Download Diff File Expand all files Collapse all files

42
README.md
View File

@@ -7,6 +7,7 @@ Current minimal scope:
- Binary Sensor port (state -> KNX)
- Switch port (KNX -> HA commands, HA state -> KNX)
- Cover port (KNX -> HA commands, HA state -> KNX)
- Light port (KNX -> HA commands, HA state -> KNX)
## Requirements
- Home Assistant 2025.12 or newer (tested for compatibility with 2026.2).
@@ -47,6 +48,32 @@ Only state addresses expose an `invert outgoing` toggle to flip KNX payloads.
- `command_address` (DPT 1): KNX group address for on/off commands.
- `state_address` (DPT 1): KNX group address that receives HA on/off state.
### Light Port
- `entity_id`: the HA light to control/monitor.
- `address` (DPT 1.001): KNX group address for on/off commands.
- `state_address` (DPT 1.001): KNX group address that receives HA on/off state.
- `brightness_address` (DPT 5.001): KNX group address for brightness commands.
- `brightness_state_address` (DPT 5.001): KNX group address that receives HA brightness.
- `color_address` (DPT 232.600): KNX group address for RGB commands.
- `color_state_address` (DPT 232.600): KNX group address that receives HA RGB state.
- `rgbw_address` (DPT 251.600): KNX group address for RGBW commands.
- `rgbw_state_address` (DPT 251.600): KNX group address that receives HA RGBW state.
- `hue_address` (DPT 5.003): KNX group address for hue commands.
- `hue_state_address` (DPT 5.003): KNX group address that receives HA hue state.
- `saturation_address` (DPT 5.001): KNX group address for saturation commands.
- `saturation_state_address` (DPT 5.001): KNX group address that receives HA saturation state.
- `xyy_address` (DPT 242.600): KNX group address for XY color commands.
- `xyy_state_address` (DPT 242.600): KNX group address that receives HA XY color state.
- `color_temperature_address` (DPT 5.001/7.600/9): KNX group address for color temperature commands.
- `color_temperature_state_address` (DPT 5.001/7.600/9): KNX group address that receives HA color temperature state.
- `color_temperature_mode`: `relative` (DPT 5.001 percent), `absolute` (DPT 7.600 Kelvin), or `absolute_float` (DPT 9 Kelvin).
- `min_kelvin` / `max_kelvin`: Kelvin range used for `relative` color temperature mapping.
- Individual colors (DPT 1.001 + 5.001): `red_*`, `green_*`, `blue_*`, `white_*` on/off and brightness addresses with matching state addresses.
Notes:
- If `state_address` or `*_state_address` is empty, the command address is reused for outgoing updates.
- For XY color, the bridge sends the brightness as the Y (luminance) component.
## Notes
- For DPT 1.008 (Up/Down), the bridge treats `0 = Up/Open` and `1 = Down/Close`.
- For DPT 5.001, values are interpreted as 0-100 percent where 0 = closed and 100 = open.
@@ -61,13 +88,22 @@ Only state addresses expose an `invert outgoing` toggle to flip KNX payloads.
- Cover `position_state_address`: DPT 5.001
- Cover `angle_address`: DPT 5.001
- Cover `angle_state_address`: DPT 5.001
- Light `address` / `state_address`: DPT 1.001
- Light `brightness_address` / `brightness_state_address`: DPT 5.001
- Light `color_address` / `color_state_address`: DPT 232.600
- Light `rgbw_address` / `rgbw_state_address`: DPT 251.600
- Light `hue_address` / `hue_state_address`: DPT 5.003
- Light `saturation_address` / `saturation_state_address`: DPT 5.001
- Light `xyy_address` / `xyy_state_address`: DPT 242.600
- Light `color_temperature_address` / `color_temperature_state_address`: DPT 5.001/7.600/9
- Light `red_*`, `green_*`, `blue_*`, `white_*` brightness: DPT 5.001
- Light `red_*`, `green_*`, `blue_*`, `white_*` on/off: DPT 1.001
## Roadmap
- Optional standalone KNX connection (without requiring the HA KNX integration).
- Additional entity types (light, switch, sensor, climate).
- Additional entity types (sensor, climate).
- Advanced DPT mapping options and inversion settings.
## Versioning and Releases
- Current version: 0.0.20
- Current version: 0.0.21
- `CHANGELOG.md` lists versions with the newest entries at the top.
- Release creation is manual and only done when explicitly requested.