Tune relative dimming steps

.idea/PROJECT_STATE.md

@@ -41,7 +41,9 @@ Completed:
 - 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.
-- Project version set to 0.0.23 and `CHANGELOG.md` maintained.
+- Light color temperature event type mapping and relative dimming decoding fixed.
+- Relative dimming step mapping tuned to avoid on/off jumps.
+- Project version set to 0.0.25 and `CHANGELOG.md` maintained.
 
 Files created:
 - `custom_components/ha_knx_bridge/__init__.py`

CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.0.25 - 2026-02-15
+- Tune light relative dimming step mapping to avoid on/off jumps.
+
+## 0.0.24 - 2026-02-15
+- Fix light color temperature event type mapping and improve relative dimming decoding.
+
 ## 0.0.23 - 2026-02-15
 - Add optional light relative dimming address (DPT 3.007).
 

README.md

@@ -73,7 +73,8 @@ Only state addresses expose an `invert outgoing` toggle to flip KNX payloads.
 
 Notes:
 - For XY color, the bridge sends the brightness as the Y (luminance) component.
-- Relative dimming (DPT 3.007) maps KNX step values to `brightness_step_pct` in Home Assistant.
+- Relative dimming (DPT 3.007) maps KNX step values to small `brightness_step_pct` changes in Home Assistant.
+- Color temperature mode must match the KNX telegram DPT: `relative` for 5.001, `absolute` for 7.600, `absolute_float` for DPT 9.
 
 ## Notes
 - For DPT 1.008 (Up/Down), the bridge treats `0 = Up/Open` and `1 = Down/Close`.
@@ -107,5 +108,5 @@ Notes:
 - Advanced DPT mapping options and inversion settings.
 
 ## Versioning and Releases
-- Current version: 0.0.23
+- Current version: 0.0.25
 - `CHANGELOG.md` lists versions with the newest entries at the top.

custom_components/ha_knx_bridge/bridge.py

@@ -1612,9 +1612,9 @@ def _light_color_temperature_event_type(mode: str) -> str | None:
     if mode == "relative":
         return "percent"
     if mode == "absolute":
-        return "7.600"
+        return "2byte_unsigned"
     if mode == "absolute_float":
-        return "9"
+        return "2byte_float"
     return None
 
 
@@ -1668,8 +1668,7 @@ def _light_uses_white_channel(port: LightPort) -> bool:
 
 
 def _relative_dimming_step(value: int) -> tuple[str, int] | None:
-    if value < 0 or value > 15:
-        return None
+    value = value & 0x0F
     if value == 0 or value == 8:
         return None
     if value <= 7:
@@ -1679,13 +1678,13 @@ def _relative_dimming_step(value: int) -> tuple[str, int] | None:
         direction = "up"
         step = value - 8
     percent_map = {
-        1: 100,
-        2: 50,
-        3: 25,
-        4: 13,
-        5: 6,
-        6: 3,
-        7: 2,
+        1: 10,
+        2: 8,
+        3: 6,
+        4: 4,
+        5: 3,
+        6: 2,
+        7: 1,
     }
     percent = percent_map.get(step)
     if percent is None:

custom_components/ha_knx_bridge/manifest.json

@@ -1,7 +1,7 @@
 {
   "domain": "ha_knx_bridge",
   "name": "HA KNX Bridge",
-  "version": "0.0.23",
+  "version": "0.0.25",
   "config_flow": true,
   "documentation": "https://github.com/bahmcloud/HA-KNX-Bridge",
   "issue_tracker": "https://github.com/bahmcloud/HA-KNX-Bridge/issues",