PyPlumIO 0.5.25__py3-none-any.whl → 0.5.27__py3-none-any.whl

{PyPlumIO-0.5.25.dist-info → PyPlumIO-0.5.27.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: PyPlumIO
-Version: 0.5.25
+Version: 0.5.27
 Summary: PyPlumIO is a native ecoNET library for Plum ecoMAX controllers.
 Author-email: Denis Paavilainen <denpa@denpa.pro>
 License: MIT License
@@ -35,14 +35,14 @@ Requires-Dist: sphinx-rtd-theme ==2.0.0 ; extra == 'docs'
 Requires-Dist: readthedocs-sphinx-search ==0.3.2 ; extra == 'docs'
 Provides-Extra: test
 Requires-Dist: codespell ==2.3.0 ; extra == 'test'
-Requires-Dist: coverage ==7.6.0 ; extra == 'test'
-Requires-Dist: mypy ==1.11.1 ; extra == 'test'
+Requires-Dist: coverage ==7.6.1 ; extra == 'test'
+Requires-Dist: mypy ==1.11.2 ; extra == 'test'
 Requires-Dist: pyserial-asyncio-fast ==0.14 ; extra == 'test'
 Requires-Dist: pytest ==8.3.2 ; extra == 'test'
-Requires-Dist: pytest-asyncio ==0.23.8 ; extra == 'test'
-Requires-Dist: ruff ==0.5.5 ; extra == 'test'
-Requires-Dist: tox ==4.16.0 ; extra == 'test'
-Requires-Dist: types-pyserial ==3.5.0.20240527 ; extra == 'test'
+Requires-Dist: pytest-asyncio ==0.24.0 ; extra == 'test'
+Requires-Dist: ruff ==0.6.3 ; extra == 'test'
+Requires-Dist: tox ==4.18.0 ; extra == 'test'
+Requires-Dist: types-pyserial ==3.5.0.20240826 ; extra == 'test'
 
 # PyPlumIO is a native ecoNET library for Plum ecoMAX controllers.
 [![PyPI version](https://badge.fury.io/py/PyPlumIO.svg)](https://badge.fury.io/py/PyPlumIO)

PyPlumIO-0.5.27.dist-info/RECORD

@@ -0,0 +1,60 @@
+pyplumio/__init__.py,sha256=ditJTIOFGJDg60atHzOpiggdUrZHpSynno7MtpZUGVk,3299
+pyplumio/__main__.py,sha256=3IwHHSq-iay5FaeMc95klobe-xv82yydSKcBE7BFZ6M,500
+pyplumio/_version.py,sha256=6ndDhm_j36uKFAa8jfkMvDlg-OkjeSfudQRWJOg10fs,413
+pyplumio/connection.py,sha256=6mUbcjGxxEhMVIbzZgCqH-Ez-fcYoRj7ZbVSzpikpNA,5949
+pyplumio/const.py,sha256=8rpiVbVb5R_6Rm6J2sgCnaVrkD-2Fzhd1RYMz0MBgwo,3915
+pyplumio/exceptions.py,sha256=Wn-y5AJ5xfaBlHhTUVKB27_0Us8_OVHqh-sicnr9sYA,700
+pyplumio/filters.py,sha256=r2DZHwHG0cPWzTcsIX1pjAH19BR3iCOQsaqJ3T106t4,11188
+pyplumio/protocol.py,sha256=VRxrj8vZ1FMawqblKkyxg_V61TBSvVynd9u0JXYnMUU,8090
+pyplumio/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pyplumio/stream.py,sha256=IVCQFKBtRafRgUkr93p_wN5mXZAD3Jw1d091dfEIK20,4479
+pyplumio/utils.py,sha256=TnBzRopinyp92wruguijxcIYmaeyNVTFX0dygI5FCMU,823
+pyplumio/devices/__init__.py,sha256=uKziGOX_pcd-MEt7eqdwyZidLk7-9Uu07_U49Hlel78,6532
+pyplumio/devices/ecomax.py,sha256=oLl6aYbgC6MtsxCiW0eLSevpXVjVOYar--fn0Qzaz9w,16878
+pyplumio/devices/ecoster.py,sha256=jNWli7ye9T6yfkcFJZhhUHH7KOv-L6AgYFp_dKyv3OM,263
+pyplumio/devices/mixer.py,sha256=VE9Kjpq-sTLGgR8F-qnQjOuN8BrD4edrvu1L2X6m4uM,3199
+pyplumio/devices/thermostat.py,sha256=1vOUWppTzY7iN6zDhNUFlb5rrqOCs4_cegn25h_bags,2609
+pyplumio/frames/__init__.py,sha256=QqghzVt0r1STmeDlYs_hriHfzZj96-hzRQsxlFdv6Ls,7497
+pyplumio/frames/messages.py,sha256=iDwZOPdVOZaIcEHYnkwtCazH_N6BjyEDtiJBjTRaePY,3570
+pyplumio/frames/requests.py,sha256=nbSuOLue2rI4WgtXslqTGfFnWBlwzLE6I9wraKC1uqg,6854
+pyplumio/frames/responses.py,sha256=Ch1AVBmD6Ek7BazoEMDDEa6ad_fUdUXf4bNssQOu0sI,6228
+pyplumio/helpers/__init__.py,sha256=H2xxdkF-9uADLwEbfBUoxNTdwru3L5Z2cfJjgsuRsn0,31
+pyplumio/helpers/data_types.py,sha256=fNQmZ-fifqNl01jDXoF0BjmBJoDKVr4spZNHBuiUVEY,9059
+pyplumio/helpers/event_manager.py,sha256=xQOfiP_nP1Pz5zhB6HU5gXyyJXjhisYshL8_HRxDgt8,6412
+pyplumio/helpers/factory.py,sha256=6ArzJDq3MiiMaRpMEP0kC6wJWsoqOqe32V1RCxg1478,1005
+pyplumio/helpers/parameter.py,sha256=iCtKkYXJI0Zj4ifU3HCwoq_qqSE03giblSP1rqsWzcY,11463
+pyplumio/helpers/schedule.py,sha256=l-dQwy8TUjlPqiMFcQaMCTxzgtAvQpyuutRIdfI06zo,5302
+pyplumio/helpers/task_manager.py,sha256=HAd69yGTRL0zQsu-ywnbLu1UXiJzgHWuhYWA--vs4lQ,1181
+pyplumio/helpers/timeout.py,sha256=JAhWNtIpcXyVILIwHWVy5mYofqbbRDGKLdTUKkQuajs,772
+pyplumio/helpers/uid.py,sha256=J7gN8i8LE0g6tfL66BJbwsQQqzBBxWx7giyvqaJh4BM,976
+pyplumio/structures/__init__.py,sha256=EjK-5qJZ0F7lpP2b6epvTMg9cIBl4Kn91nqNkEcLwTc,1299
+pyplumio/structures/alerts.py,sha256=8ievMl5_tUBlnTLCiZoIloucIngCcoAYy6uI9sSXrt0,3664
+pyplumio/structures/boiler_load.py,sha256=p3mOzZUU-g7A2tG_yp8podEqpI81hlsOZmHELyPNRY8,838
+pyplumio/structures/boiler_power.py,sha256=72qsvccg49FdRdXv2f2K5sGpjT7wAOLFjlIGWpO-DVg,901
+pyplumio/structures/ecomax_parameters.py,sha256=tV97N6uQ1VQmY88Rdtm_BhX2kR7tDGDOfGYFCpynX0A,27880
+pyplumio/structures/fan_power.py,sha256=Q5fv-7_2NVuLeQPIVIylvgN7M8-a9D8rRUE0QGjyS3w,871
+pyplumio/structures/frame_versions.py,sha256=hbcVuhuPNy5qd39Vk7w4WdPCW-TNx1cAYWzA2mXocyk,1548
+pyplumio/structures/fuel_consumption.py,sha256=_p2dI4H67Eopn7IF0Gj77A8c_8lNKhhDDAtmugxLd4s,976
+pyplumio/structures/fuel_level.py,sha256=mJpp1dnRD1wXi_6EyNX7TNXosjcr905rSHOnuZ5VD74,1069
+pyplumio/structures/lambda_sensor.py,sha256=JNSCiBJoM8Uk3OGbmFIigaLOntQST5U_UrmCpaQBlM0,1595
+pyplumio/structures/mixer_parameters.py,sha256=4PR_BgNVpeBzR3Q29GtpF9uJnHxPZ4jgyfhyysPmAUA,8919
+pyplumio/structures/mixer_sensors.py,sha256=-cN7U-Fr2fmAQ5McQL7bZUC8CFlb1y8TN0f_dqy3UK0,2312
+pyplumio/structures/modules.py,sha256=oXUIqrOAV1dZzBV5zUH3HDUSFvNOjpUSx0TF9nZVnbs,2569
+pyplumio/structures/network_info.py,sha256=kPxmIaDGm5SyLRKVFzcrODlUtB0u5JjiZqekoKSyDpA,4159
+pyplumio/structures/output_flags.py,sha256=07N0kxlvR5WZAURuChk_BqSiXR8eaQrtI5qlkgCf4Yc,1345
+pyplumio/structures/outputs.py,sha256=1xsJPkjN643-aFawqVoupGatUIUJfQG_g252n051Qi0,1916
+pyplumio/structures/pending_alerts.py,sha256=Uq9WpB4MW9AhDkqmDhk-g0J0h4pVq0Q50z12dYEv6kY,739
+pyplumio/structures/product_info.py,sha256=uiEN6DFQlzmBvQByTirFzXQShoex0YGdFS9WI-MAxPc,2405
+pyplumio/structures/program_version.py,sha256=R-medELYHDlk_ALsw5HOVbZRb7JD3yBUsGwqwVCjrkU,2550
+pyplumio/structures/regulator_data.py,sha256=wqtRWPiwC4H_98nu9g1Po5wCqqoqUMuPBE0w93vIcuI,2271
+pyplumio/structures/regulator_data_schema.py,sha256=XM6M9ep3NyogbLPqp88mMTg8Sa9e5SFzV5I5pSYw5GY,1487
+pyplumio/structures/schedules.py,sha256=YzlfgprZq4pDfl-NBHl-EblhxatmDYr0UOkkHBW0Jok,6707
+pyplumio/structures/statuses.py,sha256=wkoynyMRr1VREwfBC6vU48kPA8ZQ83pcXuciy2xHJrk,1166
+pyplumio/structures/temperatures.py,sha256=1CDzehNmbALz1Jyt_9gZNIk52q6Wv-xQXjijVDCVYec,2337
+pyplumio/structures/thermostat_parameters.py,sha256=EzJVZZhZ19beshRG7X6lw9VWDdq4mQoMFSOhWuW7_0U,8064
+pyplumio/structures/thermostat_sensors.py,sha256=8e1TxYIJTQKT0kIGO9gG4hGdLOBUpIhiPToQyOMyeNE,3237
+PyPlumIO-0.5.27.dist-info/LICENSE,sha256=m-UuZFjXJ22uPTGm9kSHS8bqjsf5T8k2wL9bJn1Y04o,1088
+PyPlumIO-0.5.27.dist-info/METADATA,sha256=Debg6o3vvo_8AbQw14KdBiUwh8xhdQaERpNPntD--18,5490
+PyPlumIO-0.5.27.dist-info/WHEEL,sha256=UvcQYKBHoFqaQd6LKyqHw9fxEolWLQnlzP0h_LgJAfI,91
+PyPlumIO-0.5.27.dist-info/top_level.txt,sha256=kNBz9UPPkPD9teDn3U_sEy5LjzwLm9KfADCXtBlbw8A,9
+PyPlumIO-0.5.27.dist-info/RECORD,,

{PyPlumIO-0.5.25.dist-info → PyPlumIO-0.5.27.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (72.1.0)
+Generator: setuptools (74.0.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

pyplumio/_version.py

@@ -12,5 +12,5 @@ __version__: str
 __version_tuple__: VERSION_TUPLE
 version_tuple: VERSION_TUPLE
 
-__version__ = version = '0.5.25'
-__version_tuple__ = version_tuple = (0, 5, 25)
+__version__ = version = '0.5.27'
+__version_tuple__ = version_tuple = (0, 5, 27)

pyplumio/devices/__init__.py

@@ -4,7 +4,6 @@ from __future__ import annotations
 
 from abc import ABC
 import asyncio
-from collections.abc import Iterable
 from functools import cache
 from typing import Any, ClassVar
 
@@ -13,7 +12,7 @@ from pyplumio.exceptions import UnknownDeviceError
 from pyplumio.frames import DataFrameDescription, Frame, Request
 from pyplumio.helpers.event_manager import EventManager
 from pyplumio.helpers.factory import create_instance
-from pyplumio.helpers.parameter import SET_RETRIES, Parameter, ParameterValueType
+from pyplumio.helpers.parameter import Parameter, ParameterValue
 from pyplumio.structures.network_info import NetworkInfo
 from pyplumio.utils import to_camelcase
 
@@ -54,9 +53,9 @@ class Device(ABC, EventManager):
     async def set(
         self,
         name: str,
-        value: ParameterValueType,
+        value: ParameterValue,
+        retries: int = 5,
         timeout: float | None = None,
-        retries: int = SET_RETRIES,
     ) -> bool:
         """Set a parameter value.
 
@@ -64,12 +63,12 @@ class Device(ABC, EventManager):
         :type name: str
         :param value: New value for the parameter
         :type value: int | float | bool | Literal["off", "on"]
-        :param timeout: Wait this amount of seconds for confirmation,
-            defaults to `None`
-        :type timeout: float, optional
         :param retries: Try setting parameter for this amount of
             times, defaults to 5
         :type retries: int, optional
+        :param timeout: Wait this amount of seconds for confirmation,
+            defaults to `None`
+        :type timeout: float, optional
         :return: `True` if parameter was successfully set, `False`
             otherwise.
         :rtype: bool
@@ -77,7 +76,7 @@ class Device(ABC, EventManager):
         :raise ValueError: when a new value is outside of allowed range
         :raise TypeError: when found data is not valid parameter
         """
-        parameter = await self.get(name, timeout=timeout)
+        parameter = await self.get(name, timeout)
         if not isinstance(parameter, Parameter):
             raise TypeError(f"{name} is not valid parameter")
 
@@ -86,9 +85,9 @@ class Device(ABC, EventManager):
     def set_nowait(
         self,
         name: str,
-        value: ParameterValueType,
+        value: ParameterValue,
+        retries: int = 5,
         timeout: float | None = None,
-        retries: int = SET_RETRIES,
     ) -> None:
         """Set a parameter value without waiting for the result.
 
@@ -96,19 +95,19 @@ class Device(ABC, EventManager):
         :type name: str
         :param value: New value for the parameter
         :type value: int | float | bool | Literal["off", "on"]
+        :param retries: Try setting parameter for this amount of
+            times, defaults to 5
+        :type retries: int, optional
         :param timeout: Wait this amount of seconds for confirmation.
             As this method operates in the background without waiting,
             this value is used to determine failure when
             retrying and doesn't block, defaults to `None`
         :type timeout: float, optional
-        :param retries: Try setting parameter for this amount of
-            times, defaults to 5
-        :type retries: int, optional
         :return: `True` if parameter was successfully set, `False`
             otherwise.
         :rtype: bool
         """
-        self.create_task(self.set(name, value, timeout, retries))
+        self.create_task(self.set(name, value, retries, timeout))
 
     async def shutdown(self) -> None:
         """Cancel device tasks."""
@@ -116,22 +115,22 @@ class Device(ABC, EventManager):
         await self.wait_until_done()
 
 
-class AddressableDevice(Device, ABC):
-    """Represents an addressable device."""
+class PhysicalDevice(Device, ABC):
+    """Represents a physical device.
+
+    Physical device have network address and can have multiple
+    virtual devices associated with them via parent property.
+    """
 
     address: ClassVar[int]
     _network: NetworkInfo
-    _setup_frames: Iterable[DataFrameDescription]
+    _setup_frames: tuple[DataFrameDescription, ...]
 
     def __init__(self, queue: asyncio.Queue[Frame], network: NetworkInfo):
-        """Initialize a new addressable device."""
+        """Initialize a new physical device."""
         super().__init__(queue)
         self._network = network
 
-    def __int__(self) -> int:
-        """Return the device address."""
-        return int(self.address)
-
     def handle_frame(self, frame: Frame) -> None:
         """Handle frame received from the device."""
         frame.sender_device = self
@@ -176,19 +175,19 @@ class AddressableDevice(Device, ABC):
         raise ValueError(f'could not request "{name}"', frame_type)
 
     @classmethod
-    async def create(cls, device_type: int, **kwargs: Any) -> AddressableDevice:
-        """Create a device handler object."""
+    async def create(cls, device_type: int, **kwargs: Any) -> PhysicalDevice:
+        """Create a physical device handler object."""
         return await create_instance(get_device_handler(device_type), cls=cls, **kwargs)
 
 
-class SubDevice(Device, ABC):
-    """Represents a sub-device."""
+class VirtualDevice(Device, ABC):
+    """Represents a virtual device associated with physical device."""
 
-    parent: AddressableDevice
+    parent: PhysicalDevice
     index: int
 
     def __init__(
-        self, queue: asyncio.Queue[Frame], parent: AddressableDevice, index: int = 0
+        self, queue: asyncio.Queue[Frame], parent: PhysicalDevice, index: int = 0
     ):
         """Initialize a new sub-device."""
         super().__init__(queue)

pyplumio/devices/ecomax.py

@@ -6,7 +6,7 @@ import asyncio
 from collections.abc import Coroutine, Generator, Iterable, Sequence
 import logging
 import time
-from typing import Any, ClassVar, Final
+from typing import Any, Final
 
 from pyplumio.const import (
     ATTR_FRAME_ERRORS,
@@ -17,7 +17,7 @@ from pyplumio.const import (
     DeviceType,
     FrameType,
 )
-from pyplumio.devices import AddressableDevice
+from pyplumio.devices import PhysicalDevice
 from pyplumio.devices.mixer import Mixer
 from pyplumio.devices.thermostat import Thermostat
 from pyplumio.filters import on_change
@@ -101,13 +101,14 @@ SETUP_FRAME_TYPES: tuple[DataFrameDescription, ...] = (
 _LOGGER = logging.getLogger(__name__)
 
 
-class EcoMAX(AddressableDevice):
+class EcoMAX(PhysicalDevice):
     """Represents an ecoMAX controller."""
 
-    address: ClassVar[int] = DeviceType.ECOMAX
-    _setup_frames: tuple[DataFrameDescription, ...] = SETUP_FRAME_TYPES
+    address = DeviceType.ECOMAX
+
     _frame_versions: dict[int, int]
     _fuel_burned_timestamp_ns: int
+    _setup_frames = SETUP_FRAME_TYPES
 
     def __init__(self, queue: asyncio.Queue[Frame], network: NetworkInfo):
         """Initialize a new ecoMAX controller."""
@@ -216,10 +217,7 @@ class EcoMAX(AddressableDevice):
                 yield self.dispatch(
                     description.name,
                     handler.create_or_update(
-                        device=self,
-                        description=description,
-                        values=values,
-                        index=index,
+                        device=self, description=description, values=values, index=index
                     ),
                 )
 
@@ -263,17 +261,16 @@ class EcoMAX(AddressableDevice):
         parameter's name and value. Events are dispatched for the
         respective mixer instance.
         """
-        if not parameters:
-            return False
-
-        await asyncio.gather(
-            *(
-                mixer.dispatch(ATTR_MIXER_PARAMETERS, parameters[mixer.index])
-                for mixer in self._mixers(indexes=parameters.keys())
+        if parameters:
+            await asyncio.gather(
+                *(
+                    mixer.dispatch(ATTR_MIXER_PARAMETERS, parameters[mixer.index])
+                    for mixer in self._mixers(indexes=parameters.keys())
+                )
             )
-        )
+            return True
 
-        return True
+        return False
 
     async def _handle_mixer_sensors(
         self, sensors: dict[int, dict[str, Any]] | None
@@ -284,17 +281,16 @@ class EcoMAX(AddressableDevice):
         sensor's name and value. Events are dispatched for the
         respective mixer instance.
         """
-        if not sensors:
-            return False
-
-        await asyncio.gather(
-            *(
-                mixer.dispatch(ATTR_MIXER_SENSORS, sensors[mixer.index])
-                for mixer in self._mixers(indexes=sensors.keys())
+        if sensors:
+            await asyncio.gather(
+                *(
+                    mixer.dispatch(ATTR_MIXER_SENSORS, sensors[mixer.index])
+                    for mixer in self._mixers(indexes=sensors.keys())
+                )
             )
-        )
+            return True
 
-        return True
+        return False
 
     async def _add_schedules(
         self, schedules: list[tuple[int, list[list[bool]]]]
@@ -332,10 +328,7 @@ class EcoMAX(AddressableDevice):
                 yield self.dispatch(
                     description.name,
                     handler.create_or_update(
-                        device=self,
-                        description=description,
-                        values=values,
-                        index=index,
+                        device=self, description=description, values=values, index=index
                     ),
                 )
 
@@ -376,29 +369,29 @@ class EcoMAX(AddressableDevice):
         parameter's name and value. Events are dispatched for the
         respective thermostat instance.
         """
-        if not parameters:
-            return False
-
-        await asyncio.gather(
-            *(
-                thermostat.dispatch(
-                    ATTR_THERMOSTAT_PARAMETERS, parameters[thermostat.index]
+        if parameters:
+            await asyncio.gather(
+                *(
+                    thermostat.dispatch(
+                        ATTR_THERMOSTAT_PARAMETERS, parameters[thermostat.index]
+                    )
+                    for thermostat in self._thermostats(indexes=parameters.keys())
                 )
-                for thermostat in self._thermostats(indexes=parameters.keys())
             )
-        )
-        return True
+            return True
+
+        return False
 
     async def _add_thermostat_profile_parameter(
         self, values: ParameterValues | None
     ) -> EcomaxNumber | None:
         """Add thermostat profile parameter to the dataset."""
-        if not values:
-            return None
+        if values:
+            return EcomaxNumber(
+                device=self, description=THERMOSTAT_PROFILE_PARAMETER, values=values
+            )
 
-        return EcomaxNumber(
-            device=self, description=THERMOSTAT_PROFILE_PARAMETER, values=values
-        )
+        return None
 
     async def _handle_thermostat_sensors(
         self, sensors: dict[int, dict[str, Any]] | None
@@ -409,18 +402,19 @@ class EcoMAX(AddressableDevice):
         sensor's name and value. Events are dispatched for the
         respective thermostat instance.
         """
-        if not sensors:
-            return False
-
-        await asyncio.gather(
-            *(
-                thermostat.dispatch(ATTR_THERMOSTAT_SENSORS, sensors[thermostat.index])
-                for thermostat in self._thermostats(indexes=sensors.keys())
-            ),
-            return_exceptions=True,
-        )
+        if sensors:
+            await asyncio.gather(
+                *(
+                    thermostat.dispatch(
+                        ATTR_THERMOSTAT_SENSORS, sensors[thermostat.index]
+                    )
+                    for thermostat in self._thermostats(indexes=sensors.keys())
+                ),
+                return_exceptions=True,
+            )
+            return True
 
-        return True
+        return False
 
     async def turn_on(self) -> bool:
         """Turn on the ecoMAX controller."""

pyplumio/devices/ecoster.py

@@ -2,13 +2,11 @@
 
 from __future__ import annotations
 
-from typing import ClassVar
-
 from pyplumio.const import DeviceType
-from pyplumio.devices import AddressableDevice
+from pyplumio.devices import PhysicalDevice
 
 
-class EcoSTER(AddressableDevice):
+class EcoSTER(PhysicalDevice):
     """Represents an ecoSTER thermostat."""
 
-    address: ClassVar[int] = DeviceType.ECOSTER
+    address = DeviceType.ECOSTER

pyplumio/devices/mixer.py

@@ -7,7 +7,7 @@ from collections.abc import Coroutine, Generator, Sequence
 import logging
 from typing import TYPE_CHECKING, Any
 
-from pyplumio.devices import AddressableDevice, SubDevice
+from pyplumio.devices import PhysicalDevice, VirtualDevice
 from pyplumio.helpers.parameter import ParameterValues
 from pyplumio.structures.mixer_parameters import (
     ATTR_MIXER_PARAMETERS,
@@ -25,11 +25,11 @@ if TYPE_CHECKING:
 _LOGGER = logging.getLogger(__name__)
 
 
-class Mixer(SubDevice):
-    """Represents an mixer."""
+class Mixer(VirtualDevice):
+    """Represents a mixer."""
 
     def __init__(
-        self, queue: asyncio.Queue[Frame], parent: AddressableDevice, index: int = 0
+        self, queue: asyncio.Queue[Frame], parent: PhysicalDevice, index: int = 0
     ):
         """Initialize a new mixer."""
         super().__init__(queue, parent, index)
@@ -85,10 +85,7 @@ class Mixer(SubDevice):
                 yield self.dispatch(
                     description.name,
                     handler.create_or_update(
-                        device=self,
-                        description=description,
-                        values=values,
-                        index=index,
+                        device=self, description=description, values=values, index=index
                     ),
                 )
 

pyplumio/devices/thermostat.py

@@ -6,7 +6,7 @@ import asyncio
 from collections.abc import Coroutine, Generator, Sequence
 from typing import TYPE_CHECKING, Any
 
-from pyplumio.devices import AddressableDevice, SubDevice
+from pyplumio.devices import PhysicalDevice, VirtualDevice
 from pyplumio.helpers.parameter import ParameterValues
 from pyplumio.structures.thermostat_parameters import (
     ATTR_THERMOSTAT_PARAMETERS,
@@ -21,11 +21,11 @@ if TYPE_CHECKING:
     from pyplumio.frames import Frame
 
 
-class Thermostat(SubDevice):
+class Thermostat(VirtualDevice):
     """Represents a thermostat."""
 
     def __init__(
-        self, queue: asyncio.Queue[Frame], parent: AddressableDevice, index: int = 0
+        self, queue: asyncio.Queue[Frame], parent: PhysicalDevice, index: int = 0
     ):
         """Initialize a new thermostat."""
         super().__init__(queue, parent, index)

pyplumio/filters.py

@@ -150,7 +150,7 @@ def on_change(callback: Callback) -> _OnChange:
     previous call.
 
     :param callback: A callback function to be awaited on value change
-    :type callback: Callable[[Any], Coroutine[Any, Any, Any]]
+    :type callback: Callback
     :return: A instance of callable filter
     :rtype: _OnChange
     """
@@ -197,7 +197,7 @@ def debounce(callback: Callback, min_calls: int) -> _Debounce:
     across multiple filter calls.
 
     :param callback: A callback function to be awaited on value change
-    :type callback: Callable[[Any], Coroutine[Any, Any, Any]]
+    :type callback: Callback
     :param min_calls: Value shouldn't change for this amount of
         filter calls
     :type min_calls: int
@@ -244,7 +244,7 @@ def throttle(callback: Callback, seconds: float) -> _Throttle:
 
     :param callback: A callback function that will be awaited once
         filter conditions are fulfilled
-    :type callback: Callable[[Any], Coroutine[Any, Any, Any]]
+    :type callback: Callback
     :param seconds: A callback will be awaited at most once per
         this amount of seconds
     :type seconds: float
@@ -284,7 +284,7 @@ def delta(callback: Callback) -> _Delta:
 
     :param callback: A callback function that will be awaited with
         difference between values in two subsequent calls
-    :type callback: Callable[[Any], Coroutine[Any, Any, Any]]
+    :type callback: Callback
     :return: A instance of callable filter
     :rtype: _Delta
     """
@@ -336,7 +336,7 @@ def aggregate(callback: Callback, seconds: float) -> _Aggregate:
 
     :param callback: A callback function to be awaited once filter
         conditions are fulfilled
-    :type callback: Callable[[Any], Coroutine[Any, Any, Any]]
+    :type callback: Callback
     :param seconds: A callback will be awaited with a sum of values
         aggregated over this amount of seconds.
     :type seconds: float
@@ -378,7 +378,7 @@ def custom(callback: Callback, filter_fn: Callable[[Any], bool]) -> _Custom:
 
     :param callback: A callback function to be awaited when
         filter function return true
-    :type callback: Callable[[Any], Coroutine[Any, Any, Any]]
+    :type callback: Callback
     :param filter_fn: Filter function, that will be called with a
         value and should return `True` to await filter's callback
     :type filter_fn: Callable[[Any], bool]

pyplumio/frames/__init__.py

@@ -26,7 +26,7 @@ ECONET_VERSION: Final = 5
 struct_header = struct.Struct("<BH4B")
 
 if TYPE_CHECKING:
-    from pyplumio.devices import AddressableDevice
+    from pyplumio.devices import PhysicalDevice
 
 
 def bcc(data: bytes) -> int:
@@ -65,6 +65,9 @@ class DataFrameDescription:
     provides: str
 
 
+FrameT = TypeVar("FrameT", bound="Frame")
+
+
 class Frame(ABC):
     """Represents a frame."""
 
@@ -80,9 +83,9 @@ class Frame(ABC):
     )
 
     recipient: DeviceType
-    recipient_device: AddressableDevice | None
+    recipient_device: PhysicalDevice | None
     sender: DeviceType
-    sender_device: AddressableDevice | None
+    sender_device: PhysicalDevice | None
     econet_type: int
     econet_version: int
     frame_type: ClassVar[FrameType]
@@ -234,9 +237,6 @@ class Frame(ABC):
         """Decode frame message."""
 
 
-FrameT = TypeVar("FrameT", bound=Frame)
-
-
 class Request(Frame):
     """Represents a request."""
 

pyplumio/frames/messages.py

@@ -3,7 +3,7 @@
 from __future__ import annotations
 
 from contextlib import suppress
-from typing import Any, ClassVar
+from typing import Any
 
 from pyplumio.const import (
     ATTR_SENSORS,
@@ -37,7 +37,7 @@ class RegulatorDataMessage(Message):
 
     __slots__ = ()
 
-    frame_type: ClassVar[FrameType] = FrameType.MESSAGE_REGULATOR_DATA
+    frame_type = FrameType.MESSAGE_REGULATOR_DATA
 
     def decode_message(self, message: bytearray) -> dict[str, Any]:
         """Decode a frame message."""
@@ -49,7 +49,7 @@ class SensorDataMessage(Message):
 
     __slots__ = ()
 
-    frame_type: ClassVar[FrameType] = FrameType.MESSAGE_SENSOR_DATA
+    frame_type = FrameType.MESSAGE_SENSOR_DATA
 
     def decode_message(self, message: bytearray) -> dict[str, Any]:
         """Decode a frame message."""