zencontrol-python 0.1.6__tar.gz → 0.1.7__tar.gz

{zencontrol_python-0.1.6/zencontrol_python.egg-info → zencontrol_python-0.1.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: zencontrol-python
-Version: 0.1.6
+Version: 0.1.7
 Summary: Python implementation of the Zencontrol TPI Advanced protocol for DALI lighting controllers.
 Author: Simon Wright
 License-Expression: MIT
@@ -19,17 +19,20 @@ Classifier: Typing :: Typed
 Requires-Python: >=3.14
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: colorama>=0.4.6
+Provides-Extra: colorama
+Requires-Dist: colorama>=0.4.6; extra == "colorama"
 Provides-Extra: dev
 Requires-Dist: pytest>=6.0; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.18.0; extra == "dev"
-Requires-Dist: black>=22.0; extra == "dev"
-Requires-Dist: flake8>=4.0; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
 Requires-Dist: mypy>=0.950; extra == "dev"
+Requires-Dist: types-colorama; extra == "dev"
 Requires-Dist: build>=1.0; extra == "dev"
+Requires-Dist: colorama>=0.4.6; extra == "dev"
 Provides-Extra: mqtt
 Requires-Dist: aiomqtt>=2.1.0; extra == "mqtt"
 Requires-Dist: PyYAML>=6.0; extra == "mqtt"
+Requires-Dist: colorama>=0.4.6; extra == "mqtt"
 Dynamic: license-file
 
 # zencontrol-python

{zencontrol_python-0.1.6 → zencontrol_python-0.1.7}/examples/live/level_change_v2.py

@@ -9,7 +9,7 @@ if str(ROOT) not in sys.path:
 
 import yaml
 
-from zencontrol.api.models import ZenAddress, ZenController
+from zencontrol import ZenAddress, ZenController
 from zencontrol.api.protocol import ZenProtocol
 from zencontrol.api.types import ZenAddressType, ZenEventCode
 from zencontrol.utils import run_with_keyboard_interrupt

{zencontrol_python-0.1.6 → zencontrol_python-0.1.7}/examples/mqtt_bridge.py

@@ -10,12 +10,18 @@ import zencontrol
 from zencontrol import ZenController, ZenProtocol, ZenClient, ZenColour, ZenColourType, ZenProfile, ZenLight, ZenGroup, ZenButton, ZenMotionSensor, ZenSystemVariable, ZenTimeoutError, ZenAddressType
 from zencontrol.api.types import Const as ApiConst
 import aiomqtt
-from colorama import Fore, Back, Style
 import logging
 from logging.handlers import RotatingFileHandler
 import math
 import pickle
 import traceback
+try:
+    from colorama import Fore, Style
+except ImportError:
+    class _NoColor:
+        def __getattr__(self, _name: str) -> str:
+            return ""
+    Fore = Style = _NoColor()  # type: ignore[assignment]
 
 class RateLimiter:
     """Rate limiter to control concurrent coroutine execution"""

{zencontrol_python-0.1.6 → zencontrol_python-0.1.7}/pyproject.toml

@@ -24,22 +24,25 @@ classifiers = [
     "Topic :: Software Development :: Libraries :: Python Modules",
     "Typing :: Typed",
 ]
-dependencies = [
-    "colorama>=0.4.6",
-]
+dependencies = []
 
 [project.optional-dependencies]
+colorama = [
+    "colorama>=0.4.6",
+]
 dev = [
     "pytest>=6.0",
     "pytest-asyncio>=0.18.0",
-    "black>=22.0",
-    "flake8>=4.0",
+    "ruff",
     "mypy>=0.950",
+    "types-colorama",
     "build>=1.0",
+    "colorama>=0.4.6",
 ]
 mqtt = [
     "aiomqtt>=2.1.0",
     "PyYAML>=6.0",
+    "colorama>=0.4.6",
 ]
 # Simulator integration tests (tests/test_sim_*.py) need zencontrol-simulator
 # (pip install -e ../zencontrol-simulator, or a sibling ../zencontrol-simulator
@@ -63,24 +66,6 @@ include = ["zencontrol*", "examples*"]
 [tool.setuptools.package-data]
 zencontrol = ["py.typed"]
 
-[tool.black]
-line-length = 88
-target-version = ['py314']
-include = '\.pyi?$'
-extend-exclude = '''
-/(
-  # directories
-  \.eggs
-  | \.git
-  | \.hg
-  | \.mypy_cache
-  | \.tox
-  | \.venv
-  | build
-  | dist
-)/
-'''
-
 [tool.mypy]
 python_version = "3.14"
 warn_return_any = true
@@ -109,7 +94,13 @@ markers = [
 
 [tool.ruff]
 target-version = "py314"
-line-length = 88
+line-length = 130
+exclude = ["examples"]
 
 [tool.ruff.lint]
 select = ["ASYNC", "B", "E", "F", "I", "UP"]
+ignore = [
+    "ASYNC109", # Timeout parameters are part of the public async API.
+    "E501",     # Preserve existing protocol logging and payload formatting.
+    "E701",     # Allow readable single-line conditionals.
+]

{zencontrol_python-0.1.6 → zencontrol_python-0.1.7}/tests/test_discovery.py

@@ -6,7 +6,8 @@ from unittest.mock import AsyncMock, patch
 
 import pytest
 
-from zencontrol.api.models import DiscoveredController, ZenController
+from zencontrol import ZenController
+from zencontrol.api.models import DiscoveredController
 from zencontrol.api.protocol import ZenProtocol
 from zencontrol.io.event import ZenEvent
 
@@ -76,7 +77,7 @@ async def test_second_packet_from_same_mac_or_ip_is_ignored() -> None:
 async def test_registered_controller_is_not_discovered() -> None:
     protocol = ZenProtocol()
     ctrl = ZenController(
-        id="1",
+        id=1,
         name="known",
         label="Known",
         host="192.168.1.50",
@@ -105,7 +106,7 @@ async def test_registering_controller_forgets_identified() -> None:
     assert len(protocol.identified_controllers) == 1
 
     ctrl = ZenController(
-        id="1",
+        id=1,
         name="kitchen",
         label="Kitchen",
         host="192.168.1.50",
@@ -136,7 +137,7 @@ async def test_label_query_failure_still_remembers_controller() -> None:
 async def test_new_controller_discovered_while_one_is_registered() -> None:
     protocol = ZenProtocol()
     known = ZenController(
-        id="1",
+        id=1,
         name="known",
         label="Known",
         host="192.168.1.10",

{zencontrol_python-0.1.6 → zencontrol_python-0.1.7}/tests/test_lifecycle.py

@@ -67,7 +67,7 @@ async def test_aclose_closes_clients_and_clears_instances() -> None:
     ctrl.client = fake_client
 
     address = ZenAddress(controller=ctrl, type=ZenAddressType.ECG, number=1)
-    light = ZenLight(protocol=zen.protocol, address=address)
+    ZenLight(protocol=zen.protocol, address=address)
     assert "ctrl-a 1" in zen.protocol.entity_registry.lights
     assert "ctrl-a" in zen.protocol.entity_registry.controllers
 

{zencontrol_python-0.1.6 → zencontrol_python-0.1.7}/tests/test_sim_events.py

@@ -3,11 +3,10 @@
 from __future__ import annotations
 
 import pytest
+from helpers import LEGACY_ACK, wait_until
 
 from zencontrol import ZenColour, ZenColourType
 
-from helpers import wait_until
-
 pytestmark = pytest.mark.simulator
 
 
@@ -26,7 +25,7 @@ async def test_scene_and_colour_events_via_protocol(live_sim):
     p.set_callbacks(scene_change_callback=on_scene, colour_change_callback=on_colour)
     await p.start_event_monitoring()
 
-    assert await p.dali_scene(live_sim.ecg(0), 1) is True
+    assert await p.dali_scene(live_sim.ecg(0), 1) is LEGACY_ACK
     await wait_until(
         lambda: any(t == "ECG" and n == 0 and s == 1 for t, n, s in scenes),
         message="expected scene-change event for ECG 0 → scene 1",
@@ -61,7 +60,7 @@ async def test_group_level_event_via_protocol(live_sim):
     )
     await p.start_event_monitoring()
 
-    assert await p.dali_arc_level(live_sim.group(0), 44) is True
+    assert await p.dali_arc_level(live_sim.group(0), 44) is LEGACY_ACK
     await wait_until(
         lambda: any(n == 0 and level == 44 for n, level in group_events),
         message="expected group level-change event for group 0 → 44",
@@ -83,7 +82,7 @@ async def test_member_events_on_group_scene(live_sim):
     p.set_callbacks(scene_change_callback=on_scene, level_change_callback=on_level)
     await p.start_event_monitoring()
 
-    assert await p.dali_scene(live_sim.group(0), 1) is True
+    assert await p.dali_scene(live_sim.group(0), 1) is LEGACY_ACK
     await wait_until(
         lambda: (
             any(t == "GROUP" and n == 0 and s == 1 for t, n, s in scenes)

{zencontrol_python-0.1.6 → zencontrol_python-0.1.7}/tests/test_sim_interface.py

@@ -3,11 +3,10 @@
 from __future__ import annotations
 
 import pytest
+from helpers import LEGACY_ACK, wait_until
 
 from zencontrol import ZenColour, ZenColourType
 
-from helpers import wait_until
-
 pytestmark = pytest.mark.simulator
 
 
@@ -65,11 +64,11 @@ async def test_light_set_and_query(live_zen):
     lights = {lt.address.number: lt for lt in await zen.get_lights()}
     light = lights[1]
 
-    assert await light.set(level=50, fade=True) is True
+    assert await light.set(level=50, fade=True) is LEGACY_ACK
     assert await zen.protocol.dali_query_level(light.address) == 50
     assert live_sim.world.lights[1].level == 50
 
-    assert await light.off(fade=False) is True
+    assert await light.off(fade=False) is LEGACY_ACK
     assert await zen.protocol.dali_query_level(light.address) == 0
 
 
@@ -99,7 +98,7 @@ async def test_group_scene_and_profile_switch(live_zen):
 
     groups = await zen.get_groups()
     group = next(g for g in groups if g.address.number == 0)
-    assert await group.set_scene(1) is True
+    assert await group.set_scene(1) is LEGACY_ACK
     assert live_sim.world.groups[0].last_scene == 1
     assert live_sim.world.lights[0].level == 80
     assert live_sim.world.lights[1].level == 100
@@ -176,7 +175,7 @@ async def test_start_receives_injected_and_control_events(live_zen):
     await zen.get_profiles()
 
     lights = {lt.address.number: lt for lt in await zen.get_lights()}
-    assert await lights[1].set(level=66) is True
+    assert await lights[1].set(level=66) is LEGACY_ACK
     await wait_until(
         lambda: any(n == 1 and level == 66 for n, level, _, _ in light_events),
         message="expected light_change for ECG 1 → 66",
@@ -190,7 +189,7 @@ async def test_start_receives_injected_and_control_events(live_zen):
     )
 
     groups = {g.address.number: g for g in await zen.get_groups()}
-    assert await groups[0].set(level=55) is True
+    assert await groups[0].set(level=55) is LEGACY_ACK
     await wait_until(
         lambda: any(n == 0 and level == 55 for n, level, _, _ in group_events),
         message="expected group_change for group 0 → 55",
@@ -260,14 +259,14 @@ async def test_light_scene_and_on_off_via_interface(live_zen):
     lights = {lt.address.number: lt for lt in await zen.get_lights()}
     light = lights[0]
 
-    assert await light.set_scene(1) is True
+    assert await light.set_scene(1) is LEGACY_ACK
     assert live_sim.world.lights[0].level == 80
     assert await zen.protocol.dali_query_last_scene(light.address) == 1
 
-    assert await light.set(level=120) is True
-    assert await light.off(fade=False) is True
+    assert await light.set(level=120) is LEGACY_ACK
+    assert await light.off(fade=False) is LEGACY_ACK
     assert live_sim.world.lights[0].level == 0
-    assert await light.on(fade=False) is True
+    assert await light.on(fade=False) is LEGACY_ACK
     assert live_sim.world.lights[0].level == 120
 
 
@@ -280,11 +279,11 @@ async def test_group_scene_by_label_and_level(live_zen):
     group = groups[0]
 
     assert group.get_scene_number_from_label("Relax") == 1
-    assert await group.set_scene("Relax") is True
+    assert await group.set_scene("Relax") is LEGACY_ACK
     assert live_sim.world.groups[0].last_scene == 1
     assert live_sim.world.lights[0].level == 80
 
-    assert await group.set(level=40) is True
+    assert await group.set(level=40) is LEGACY_ACK
     assert live_sim.world.lights[0].level == 40
     assert live_sim.world.lights[1].level == 40
 
@@ -313,15 +312,15 @@ async def test_light_steps_recall_and_inhibit_via_interface(live_zen):
     live_sim.world.lights[1].max_level = 200
     live_sim.world.lights[1].min_level = 5
 
-    assert await light.set(level=10) is True
-    assert await light.dali_up() is True
+    assert await light.set(level=10) is LEGACY_ACK
+    assert await light.dali_up() is LEGACY_ACK
     assert live_sim.world.lights[1].level == 11
-    assert await light.dali_down() is True
+    assert await light.dali_down() is LEGACY_ACK
     assert live_sim.world.lights[1].level == 10
 
-    assert await light.dali_recall_max() is True
+    assert await light.dali_recall_max() is LEGACY_ACK
     assert live_sim.world.lights[1].level == 200
-    assert await light.dali_recall_min() is True
+    assert await light.dali_recall_min() is LEGACY_ACK
     assert live_sim.world.lights[1].level == 5
 
     assert await light.dali_inhibit(True) is True
@@ -350,3 +349,89 @@ async def test_button_and_sensor_interview_fields(live_zen):
     # Entrance 6-button pad should contribute multiple button instances
     entrance = [b for b in buttons if b.label == "Entrance 6-Button"]
     assert len(entrance) == 6
+
+
+@pytest.mark.asyncio
+async def test_light_fade_step_and_refresh_via_interface(live_zen):
+    zen, live_sim = live_zen
+    ctrl = zen.controllers[0]
+    await ctrl.interview()
+    lights = {lt.address.number: lt for lt in await zen.get_lights()}
+    light = lights[1]
+
+    assert await light.set(level=0, fade=False) is True
+    assert await light.dali_on_step_up() is LEGACY_ACK
+    assert live_sim.world.lights[1].level >= 1
+
+    assert await light.set(level=50, fade=False) is True
+    assert await light.dali_custom_fade(100, 5) is True
+    assert live_sim.world.lights[1].status & 0x10
+    assert await light.dali_stop_fade() is True
+    assert not (live_sim.world.lights[1].status & 0x10)
+
+    live_sim.world.lights[1].last_active_level = 88
+    assert await light.dali_go_to_last_active_level() is LEGACY_ACK
+    assert live_sim.world.lights[1].level == 88
+
+    assert await light.set(level=40, fade=False) is True
+    assert await light.dali_step_down_off() is LEGACY_ACK
+    assert live_sim.world.lights[1].level == 39
+
+    assert await light.dali_enable_dapc_sequence() is None
+    assert await light.dali_off() is LEGACY_ACK
+    assert live_sim.world.lights[1].level == 0
+
+    # Mutate controller under the entity, then refresh entity state.
+    assert await zen.protocol.dali_arc_level(light.address, 123) is LEGACY_ACK
+    light.level = None
+    await light.refresh_state_from_controller()
+    assert light.level == 123
+
+
+@pytest.mark.asyncio
+async def test_sysvar_get_value_and_refresh(live_zen):
+    zen, live_sim = live_zen
+    ctrl = zen.controllers[0]
+    await ctrl.interview()
+    assert await ctrl.is_dali_ready() is True
+
+    sysvars = await zen.get_system_variables(give_up_after=5)
+    svar = next(v for v in sysvars if v.id == 0)
+    svar._value = None
+    live_sim.world.system_variables[0].value = 55
+    assert await svar.get_value() == 55
+
+    live_sim.world.system_variables[0].value = 66
+    await svar.refresh_state_from_controller()
+    assert svar.value == 66
+
+
+@pytest.mark.asyncio
+async def test_motion_refresh_and_group_discoordination(live_zen):
+    zen, live_sim = live_zen
+    ctrl = zen.controllers[0]
+    await ctrl.interview()
+
+    sensors = await zen.get_motion_sensors()
+    porch = next(s for s in sensors if s.label == "Porch Sensor")
+    world_inst = live_sim.world.instance(10, 0)
+    assert world_inst is not None and world_inst.timers is not None
+    world_inst.timers.last_motion_at = __import__("time").time() - 5
+    assert await porch.refresh_state_from_controller() is True
+    assert porch.last_detect is not None
+    assert porch.hold_time == 60
+
+    groups = {g.address.number: g for g in await zen.get_groups()}
+    group = groups[0]
+    group.level = 40
+    group.scene = 1
+    disco: list = []
+
+    async def on_group(*, group, discoordinated=False, **kwargs):
+        if discoordinated:
+            disco.append(group.address.number)
+
+    zen.group_change = on_group
+    await group.declare_discoordination()
+    assert group.level is None and group.scene is None
+    assert 0 in disco

{zencontrol_python-0.1.6 → zencontrol_python-0.1.7}/tests/test_sim_protocol.py

@@ -3,11 +3,10 @@
 from __future__ import annotations
 
 import pytest
+from helpers import LEGACY_ACK, wait_until
 
 from zencontrol import ZenColour, ZenColourType, ZenEventMask, ZenEventMode
 
-from helpers import wait_until
-
 pytestmark = pytest.mark.simulator
 
 
@@ -73,13 +72,13 @@ async def test_arc_level_off_and_on(live_sim):
     p = live_sim.protocol
     addr = live_sim.ecg(1)
 
-    assert await p.dali_arc_level(addr, 77) is True
+    assert await p.dali_arc_level(addr, 77) is LEGACY_ACK
     assert await p.dali_query_level(addr) == 77
     assert live_sim.world.lights[1].level == 77
 
-    assert await p.dali_off(addr) is True
+    assert await p.dali_off(addr) is LEGACY_ACK
     assert await p.dali_query_level(addr) == 0
-    assert await p.dali_on_step_up(addr) is True
+    assert await p.dali_on_step_up(addr) is LEGACY_ACK
     assert await p.dali_query_level(addr) == live_sim.world.lights[1].min_level
 
 
@@ -88,7 +87,7 @@ async def test_group_arc_and_mixed_level_query(live_sim):
     p = live_sim.protocol
     g0 = live_sim.group(0)
 
-    assert await p.dali_arc_level(g0, 40) is True
+    assert await p.dali_arc_level(g0, 40) is LEGACY_ACK
     assert await p.dali_query_level(g0) == 40
     assert live_sim.world.lights[0].level == 40
     assert live_sim.world.lights[1].level == 40
@@ -103,7 +102,7 @@ async def test_scene_recall_and_queries(live_sim):
     p = live_sim.protocol
     addr = live_sim.ecg(0)
 
-    assert await p.dali_scene(addr, 1) is True
+    assert await p.dali_scene(addr, 1) is LEGACY_ACK
     assert await p.dali_query_last_scene(addr) == 1
     assert await p.dali_query_last_scene_is_current(addr) is True
     assert await p.dali_query_level(addr) == 80
@@ -123,7 +122,7 @@ async def test_group_scene_recall(live_sim):
     assert 0 in scenes and 1 in scenes
     assert await p.query_scene_label_for_group(g0, 1) == "Relax"
 
-    assert await p.dali_scene(g0, 1) is True
+    assert await p.dali_scene(g0, 1) is LEGACY_ACK
     assert live_sim.world.groups[0].last_scene == 1
     assert live_sim.world.lights[0].level == 80
     assert live_sim.world.lights[1].level == 100
@@ -197,7 +196,7 @@ async def test_level_change_event_via_protocol(live_sim):
 
     p.set_callbacks(level_change_callback=on_level)
     await p.start_event_monitoring()
-    assert await p.dali_arc_level(live_sim.ecg(1), 55) is True
+    assert await p.dali_arc_level(live_sim.ecg(1), 55) is LEGACY_ACK
     await wait_until(
         lambda: any(n == 1 and level == 55 for n, level in events),
         message="expected level-change event for ECG 1 → 55",
@@ -288,19 +287,19 @@ async def test_step_up_down_and_step_down_off(live_sim):
     addr = live_sim.ecg(1)
 
     await p.dali_arc_level(addr, 10)
-    assert await p.dali_up(addr) is True
+    assert await p.dali_up(addr) is LEGACY_ACK
     assert await p.dali_query_level(addr) == 11
-    assert await p.dali_down(addr) is True
+    assert await p.dali_down(addr) is LEGACY_ACK
     assert await p.dali_query_level(addr) == 10
 
     await p.dali_arc_level(addr, 1)
-    assert await p.dali_down(addr) is True  # stay at min
+    assert await p.dali_down(addr) is LEGACY_ACK  # stay at min
     assert await p.dali_query_level(addr) == 1
-    assert await p.dali_step_down_off(addr) is True
+    assert await p.dali_step_down_off(addr) is LEGACY_ACK
     assert await p.dali_query_level(addr) == 0
 
     # UP must not ignite from off
-    assert await p.dali_up(addr) is True
+    assert await p.dali_up(addr) is LEGACY_ACK
     assert await p.dali_query_level(addr) == 0
 
 
@@ -311,14 +310,14 @@ async def test_recall_max_min_and_last_active(live_sim):
     live_sim.world.lights[1].max_level = 200
     live_sim.world.lights[1].min_level = 5
 
-    assert await p.dali_recall_max(addr) is True
+    assert await p.dali_recall_max(addr) is LEGACY_ACK
     assert await p.dali_query_level(addr) == 200
-    assert await p.dali_recall_min(addr) is True
+    assert await p.dali_recall_min(addr) is LEGACY_ACK
     assert await p.dali_query_level(addr) == 5
 
     await p.dali_arc_level(addr, 88)
     await p.dali_off(addr)
-    assert await p.dali_go_to_last_active_level(addr) is True
+    assert await p.dali_go_to_last_active_level(addr) is LEGACY_ACK
     assert await p.dali_query_level(addr) == 88
 
 
@@ -425,7 +424,7 @@ async def test_colour_scenes_include_8_11(live_sim):
     assert levels[8] == 160
     assert levels[9] == 40
 
-    assert await p.dali_scene(addr, 8) is True
+    assert await p.dali_scene(addr, 8) is LEGACY_ACK
     assert await p.dali_query_level(addr) == 160
     queried = await p.query_dali_colour(addr)
     assert queried is not None and queried.kelvin == 4500
@@ -448,13 +447,13 @@ async def test_broadcast_arc_off_scene_and_colour(live_sim):
     p = live_sim.protocol
     bcast = live_sim.broadcast()
 
-    assert await p.dali_arc_level(bcast, 33) is True
+    assert await p.dali_arc_level(bcast, 33) is LEGACY_ACK
     assert all(lt.level == 33 for lt in live_sim.world.lights.values())
 
-    assert await p.dali_off(bcast) is True
+    assert await p.dali_off(bcast) is LEGACY_ACK
     assert all(lt.level == 0 for lt in live_sim.world.lights.values())
 
-    assert await p.dali_scene(bcast, 0) is True
+    assert await p.dali_scene(bcast, 0) is LEGACY_ACK
     assert live_sim.world.lights[0].level == 180
     assert live_sim.world.groups[0].last_scene == 0
 
@@ -469,7 +468,7 @@ async def test_broadcast_arc_off_scene_and_colour(live_sim):
 async def test_group_last_scene_and_status(live_sim):
     p = live_sim.protocol
     g0 = live_sim.group(0)
-    assert await p.dali_scene(g0, 1) is True
+    assert await p.dali_scene(g0, 1) is LEGACY_ACK
     assert await p.dali_query_last_scene(g0) == 1
     assert await p.dali_query_last_scene_is_current(g0) is True
 
@@ -540,9 +539,7 @@ async def test_readiness_flags_and_unknown_sysvars(live_sim):
     live_sim.world.startup_complete = False
     assert await p.query_controller_startup_complete(c) is not True
     live_sim.world.startup_complete = True
-    live_sim.world.dali_ready = False
-    assert await p.query_is_dali_ready(c) is not True
-    live_sim.world.dali_ready = True
+    live_sim.world.dali_ready = False  # simulator ignores — DALI always ready
     assert await p.query_is_dali_ready(c) is True
 
     assert await p.query_system_variable_name(c, 99) is None
@@ -557,3 +554,84 @@ async def test_return_to_scheduled_profile(live_sim):
     assert await p.change_profile_number(c, 3) is True
     assert await p.return_to_scheduled_profile(c) is True
     assert await p.query_current_profile_number(c) == 1
+
+
+@pytest.mark.asyncio
+async def test_dali_query_fade_running(live_sim):
+    p = live_sim.protocol
+    addr = live_sim.ecg(1)
+    await p.dali_arc_level(addr, 0)
+    assert await p.dali_query_fade_running(addr) is False
+    assert await p.dali_custom_fade(addr, 100, 5) is True
+    p.cache.clear()
+    assert await p.dali_query_fade_running(addr) is True
+    assert await p.dali_stop_fade(addr) is True
+    p.cache.clear()
+    assert await p.dali_query_fade_running(addr) is False
+
+
+@pytest.mark.asyncio
+async def test_operating_mode_and_button_led_stubs(live_sim):
+    p = live_sim.protocol
+    assert await p.query_operating_mode_by_address(live_sim.ecg(0)) == 0
+    assert await p.query_operating_mode_by_address(live_sim.ecd(0)) == 0
+
+    button = live_sim.instance(0, 0)
+    assert await p.override_dali_button_led_state(button, True) is True
+    # Sim stub always reports last-known LED off.
+    assert await p.query_last_known_dali_button_led_state(button) is False
+
+
+@pytest.mark.asyncio
+async def test_query_instance_groups(live_sim):
+    p = live_sim.protocol
+    groups = await p.query_instance_groups(live_sim.instance(0, 0))
+    assert groups == (0, 1, None)
+    motion = await p.query_instance_groups(live_sim.instance(0, 2, type_code=3))
+    assert motion == (0, None, None)
+    # Unconfigured instance → all None
+    unset = await p.query_instance_groups(live_sim.instance(1, 0))
+    assert unset == (None, None, None)
+
+
+@pytest.mark.asyncio
+async def test_query_profile_information(live_sim):
+    """PDF: header + records; bit0=disabled, bits1–2=priority (0 scheduled, 1+, …)."""
+    p, c = live_sim.protocol, live_sim.controller
+    result = await p.query_profile_information(c)
+    assert result is not None
+    state, profiles = result
+    assert state["current_active_profile"] == 1
+    assert state["last_scheduled_profile"] == 1
+    assert state["last_overridden_profile_utc"].timestamp() == 0x22334455
+    assert state["last_scheduled_profile_utc"].timestamp() == 0x44556677
+    assert set(profiles) == {1, 2, 3}
+    # Assert protocol fields (enabled/priority); labels are library niceties.
+    assert profiles[1]["enabled"] is True and profiles[1]["priority"] == 0
+    assert profiles[2]["enabled"] is True and profiles[2]["priority"] == 1
+    assert profiles[3]["enabled"] is False and profiles[3]["priority"] == 0
+
+
+@pytest.mark.asyncio
+async def test_colour_only_preserves_level(live_sim):
+    p = live_sim.protocol
+    addr = live_sim.ecg(0)
+    assert await p.dali_arc_level(addr, 77) is LEGACY_ACK
+    colour = ZenColour(type=ZenColourType.TC, kelvin=4200)
+    assert await p.dali_colour(addr, colour, level=255) is True
+    assert await p.dali_query_level(addr) == 77
+    assert live_sim.world.lights[0].level == 77
+    queried = await p.query_dali_colour(addr)
+    assert queried is not None and queried.kelvin == 4200
+
+
+@pytest.mark.asyncio
+async def test_clear_tpi_event_unicast_address(live_sim):
+    """Sim extension: omit IP/port (zeros) clears unicast targeting."""
+    p, c = live_sim.protocol, live_sim.controller
+    await p.set_tpi_event_unicast_address(c, ipaddr="127.0.0.1", port=6970)
+    await p.set_tpi_event_unicast_address(c)
+    info = await p.query_tpi_event_unicast_address(c)
+    assert info is not None
+    assert info["port"] == 0
+    assert info["ip"] == "0.0.0.0"