ramses-rf 0.51.7__py3-none-any.whl → 0.51.9__py3-none-any.whl

ramses_tx/const.py

@@ -788,7 +788,7 @@ class MsgId(StrEnum):
     _7F = "7F"
 
 
-# StrEnum is intended include all known codes, see: test suite, code schema in ramses.py
+# StrEnum is intended to include all known codes, see: test suite, code schema in ramses.py
 @verify(EnumCheck.UNIQUE)
 class Code(StrEnum):
     _0001 = "0001"

ramses_tx/frame.py

@@ -65,7 +65,7 @@ class Frame:
     def __init__(self, frame: str) -> None:
         """Create a frame from a string.
 
-        Will raise InvalidPacketError if it is invalid.
+        :raises InvalidPacketError: if provided string is invalid.
         """
 
         self._frame: str = frame
@@ -123,7 +123,7 @@ class Frame:
         if not strict_checking:
             return
 
-        try:  # Strict checking: helps users avoid to constructing bad commands
+        try:  # Strict checking: helps users avoid constructing bad commands
             if addrs[0] == NON_DEV_ADDR:
                 assert self.verb == I_, "wrong verb or dst addr should be present"
             elif addrs[2] == NON_DEV_ADDR:
@@ -138,7 +138,7 @@ class Frame:
             raise exc.PacketInvalid(f"Bad frame: Invalid address set: {err}") from err
 
     def __repr__(self) -> str:
-        """Return a unambiguous string representation of this object."""
+        """Return an unambiguous string representation of this object."""
 
         if self._repr is None:
             self._repr = " ".join(  # type: ignore[unreachable]
@@ -387,7 +387,7 @@ class Frame:
 
     @property
     def _hdr(self) -> HeaderT:  # incl. self._ctx
-        """Return the QoS header (fingerprint) of this packet (i.e. device_id/code/hdr).
+        """Return the QoS header (fingerprint) of this packet (i.e. device_id|code|verb).
 
         Used for QoS (timeouts, retries), callbacks, etc.
         """

ramses_tx/gateway.py

@@ -91,7 +91,7 @@ class Engine:
         if input_file:
             self._disable_sending = True
         elif not port_name:
-            raise TypeError("Either a port_name or a input_file must be specified")
+            raise TypeError("Either a port_name or an input_file must be specified")
 
         self.ser_name = port_name
         self._input_file = input_file

ramses_tx/helpers.py

@@ -787,9 +787,9 @@ def fan_info_to_byte(info: str) -> int:
 
 def fan_info_flags(flags_list: list[int]) -> int:
     flag_res: int = 0
-    for index, shft in enumerate(range(7, 4, -1)):  # index = 7, 6 and 5
+    for index, shift in enumerate(range(7, 4, -1)):  # index = 7, 6 and 5
         if flags_list[index] == 1:
-            flag_res |= 1 << shft  # set bits
+            flag_res |= 1 << shift  # set bits
     return flag_res
 
 

ramses_tx/message.py

@@ -54,7 +54,7 @@ class MessageBase:
     def __init__(self, pkt: Packet) -> None:
         """Create a message from a valid packet.
 
-        Will raise InvalidPacketError if it is invalid.
+        :raises InvalidPacketError if message payload is invalid.
         """
 
         self._pkt = pkt
@@ -66,11 +66,15 @@ class MessageBase:
         self.dtm: dt = pkt.dtm
 
         self.verb: VerbT = pkt.verb
-        self.seqn: str = pkt.seqn
+        self.seqn: str = (
+            pkt.seqn
+        )  # the msg is part of a set for 1 Code, received in order
         self.code: Code = pkt.code
         self.len: int = pkt._len
 
-        self._payload = self._validate(self._pkt.payload)  # ? raise InvalidPacketError
+        self._payload = self._validate(
+            self._pkt.payload
+        )  # ? may raise InvalidPacketError
 
         self._str: str = None  # type: ignore[assignment]
 
@@ -92,7 +96,7 @@ class MessageBase:
 
         if self.src.id == self._addrs[0].id:  # type: ignore[unreachable]
             name_0 = self._name(self.src)
-            name_1 = "" if self.dst is self.src else self._name(self.dst)
+            name_1 = "" if self.dst == self.src else self._name(self.dst)
         else:
             name_0 = ""
             name_1 = self._name(self.src)
@@ -139,16 +143,18 @@ class MessageBase:
 
     @property
     def _has_array(self) -> bool:
-        """Return True if the message's raw payload is an array."""
+        """
+        :return: True if the message's raw payload is an array.
+        """
 
         return bool(self._pkt._has_array)
 
     @property
     def _idx(self) -> dict[str, str]:
-        """Return the domain_id/zone_idx/other_idx of a message payload, if any.
+        """Get the domain_id/zone_idx/other_idx of a message payload, if any.
+        Used to identify the zone/domain that a message applies to.
 
-        Used to identify the zone/domain that a message applies to. Returns an empty
-        dict if there is none such, or None if undetermined.
+        :return: an empty dict if there is none such, or None if undetermined.
         """
 
         # .I --- 01:145038 --:------ 01:145038 3B00 002 FCC8
@@ -229,7 +235,7 @@ class MessageBase:
             assert isinstance(self._pkt._idx, str)  # mypy hint
             return {IDX_NAMES[Code._22C9]: self._pkt._idx}
 
-        assert isinstance(self._pkt._idx, str)  # mypy check
+        assert isinstance(self._pkt._idx, str)  # mypy hint
         idx_name = SZ_DOMAIN_ID if self._pkt._idx[:1] == "F" else SZ_ZONE_IDX
         index_name = IDX_NAMES.get(self.code, idx_name)
 
@@ -237,9 +243,10 @@ class MessageBase:
 
     # TODO: needs work...
     def _validate(self, raw_payload: str) -> dict | list[dict]:  # type: ignore[type-arg]
-        """Validate the message, and parse the payload if so.
+        """Validate a message packet payload, and parse it if valid.
 
-        Raise an exception (InvalidPacketError) if it is not valid.
+        :return: a dict containing key: value pairs, or a list of those created from the payload
+        :raises an InvalidPacketError exception if it is not valid.
         """
 
         try:  # parse the payload
@@ -249,10 +256,9 @@ class MessageBase:
             if not self._has_payload and (
                 self.verb == RQ and self.code not in RQ_IDX_COMPLEX
             ):
-                # _LOGGER.error("%s", msg)
                 return {}
 
-            result = parse_payload(self)
+            result = parse_payload(self)  # invoke the code parsers
 
             if isinstance(result, list):
                 return result
@@ -353,7 +359,7 @@ def re_compile_re_match(regex: str, string: str) -> bool:  # Optional[Match[Any]
 def _check_msg_payload(msg: MessageBase, payload: str) -> None:
     """Validate the packet's payload against its verb/code pair.
 
-    Raise an InvalidPayloadError if the payload is seen as invalid. Such payloads may
+    :raises InvalidPayloadError if the payload is seen as invalid. Such payloads may
     actually be valid, in which case the rules (likely the regex) will need updating.
     """
 

ramses_tx/packet.py

@@ -104,7 +104,7 @@ class Packet(Frame):
         return f"{dtm} ... {self}{hdr}"
 
     def __str__(self) -> str:
-        """Return a brief readable string representation of this object."""
+        """Return a brief readable string representation of this object aka 'header'."""
         # e.g.: 000A|RQ|01:145038|08
         return super().__repr__()  # TODO: self._hdr
 

ramses_tx/parsers.py

@@ -1391,15 +1391,18 @@ def parser_2210(payload: str, msg: Message) -> dict[str, Any]:
             "02",  # requested by CO2 level/sensor
             "03",  # requested by humidity level/sensor
         ), f"expected req_reason (00|02|03), not {payload[20:22]}"
-        assert payload[78:80] in ("00", "02"), (
-            f"expected byte 39 (00|02), not {payload[78:80]}"
-        )
-        assert payload[80:82] in ("01", "08"), (
-            f"expected byte 40 (01|08), not {payload[80:82]}"
-        )
-        assert payload[82:] in ("00", "40"), (
-            f"expected byte 41- (00|40), not {payload[82:]}"
-        )
+        assert payload[78:80] in (
+            "00",
+            "02",
+        ), f"expected byte 39 (00|02), not {payload[78:80]}"
+        assert payload[80:82] in (
+            "01",
+            "08",
+        ), f"expected byte 40 (01|08), not {payload[80:82]}"
+        assert payload[82:] in (
+            "00",
+            "40",
+        ), f"expected byte 41- (00|40), not {payload[82:]}"
 
     except AssertionError as err:
         _LOGGER.warning(f"{msg!r} < {_INFORM_DEV_MSG} ({err})")
@@ -1909,42 +1912,57 @@ def parser_2411(payload: str, msg: Message) -> dict[str, Any]:
         "92": (4, hex_to_temp),  # 75 (0-30) (C)
     }  # TODO: _2411_TYPES.get(payload[8:10], (8, no_op))
 
-    assert payload[4:6] in _2411_TABLE, (
-        f"param {payload[4:6]} is unknown"
-    )  # _INFORM_DEV_MSG
-    description = _2411_TABLE.get(payload[4:6], "Unknown")
+    # Handle unknown parameters gracefully instead of asserting
+    param_id = payload[4:6]
+    try:
+        description = _2411_TABLE.get(param_id, "Unknown")
+        if param_id not in _2411_TABLE:
+            _LOGGER.warning(
+                f"2411 message received with unknown parameter ID: {param_id}. "
+                f"This parameter is not in the known parameter schema. "
+                f"Message: {msg!r}"
+            )
+    except Exception as err:
+        _LOGGER.warning(f"Error looking up 2411 parameter {param_id}: {err}")
+        description = "Unknown"
 
     result = {
-        "parameter": payload[4:6],
+        "parameter": param_id,
         "description": description,
     }
 
     if msg.verb == RQ:
         return result
 
-    assert payload[8:10] in _2411_DATA_TYPES, (
-        f"param {payload[4:6]} has unknown data_type: {payload[8:10]}"
-    )  # _INFORM_DEV_MSG
-    length, parser = _2411_DATA_TYPES.get(payload[8:10], (8, lambda x: x))
+    try:
+        assert payload[8:10] in _2411_DATA_TYPES, (
+            f"param {param_id} has unknown data_type: {payload[8:10]}"
+        )  # _INFORM_DEV_MSG
+        length, parser = _2411_DATA_TYPES.get(payload[8:10], (8, lambda x: x))
+
+        result |= {
+            "value": parser(payload[10:18][-length:]),  # type: ignore[operator]
+            "_value_06": payload[6:10],
+        }
 
-    result |= {
-        "value": parser(payload[10:18][-length:]),  # type: ignore[operator]
-        "_value_06": payload[6:10],
-    }
+        if msg.len == 9:
+            return result
 
-    if msg.len == 9:
+        return (
+            result
+            | {
+                "min_value": parser(payload[18:26][-length:]),  # type: ignore[operator]
+                "max_value": parser(payload[26:34][-length:]),  # type: ignore[operator]
+                "precision": parser(payload[34:42][-length:]),  # type: ignore[operator]
+                "_value_42": payload[42:],
+            }
+        )
+    except AssertionError as err:
+        _LOGGER.warning(f"{msg!r} < {_INFORM_DEV_MSG} ({err})")
+        # Return partial result for unknown parameters
+        result["value"] = ""
         return result
 
-    return (
-        result
-        | {
-            "min_value": parser(payload[18:26][-length:]),  # type: ignore[operator]
-            "max_value": parser(payload[26:34][-length:]),  # type: ignore[operator]
-            "precision": parser(payload[34:42][-length:]),  # type: ignore[operator]
-            "_value_42": payload[42:],
-        }
-    )
-
 
 # unknown_2420, from OTB
 def parser_2420(payload: str, msg: Message) -> dict[str, Any]:
@@ -2344,7 +2362,7 @@ def parser_3210(payload: str, msg: Message) -> PayDictT._3210:
     return {SZ_TEMPERATURE: hex_to_temp(payload[2:])}
 
 
-# opentherm_msg, from OTB (and some RND)
+# opentherm_msg, from OTB (and OT_RND)
 def parser_3220(payload: str, msg: Message) -> dict[str, Any]:
     try:
         ot_type, ot_id, ot_value, ot_schema = decode_frame(payload[2:10])
@@ -2968,8 +2986,12 @@ _PAYLOAD_PARSERS = {
 
 
 def parse_payload(msg: Message) -> dict | list[dict]:
+    """
+    Apply the appropriate parser defined in this module to the message.
+    :param msg: a Message object containing packet data and extra attributes
+    :return: a dict of key: value pairs or a list of such dicts, e.g. {'temperature': 21.5}
+    """
     result: dict | list[dict]
-
     result = _PAYLOAD_PARSERS.get(msg.code, parser_unknown)(msg._pkt.payload, msg)
     if isinstance(result, dict) and msg.seqn.isnumeric():  # e.g. 22F1/3
         result["seqx_num"] = msg.seqn

ramses_tx/protocol.py

@@ -332,7 +332,7 @@ class _DeviceIdFilterMixin(_BaseProtocol):
         /,
         *,
         disable_warnings: bool = False,
-        strick_checking: bool = False,
+        strict_checking: bool = False,
     ) -> DeviceIdT | None:
         """Return the device_id of the gateway specified in the include_list, if any.
 
@@ -384,7 +384,7 @@ class _DeviceIdFilterMixin(_BaseProtocol):
                 f"The {SZ_KNOWN_LIST} includes exactly one gateway (HGI): {known_hgi}"
             )
 
-        if strick_checking:
+        if strict_checking:
             return known_hgi if [known_hgi] == explicit_hgis else None
         return known_hgi
 

ramses_tx/protocol_fsm.py

@@ -291,7 +291,7 @@ class ProtocolContext:
         # may want to set some instance variables, according to type of transport
         self._state.connection_made()
 
-    # TODO: Should we clear the buffer if connection is lost (and apoligise to senders?
+    # TODO: Should we clear the buffer if connection is lost (and apologise to senders?
     def connection_lost(self, err: ExceptionT | None) -> None:
         self._state.connection_lost()
 

ramses_tx/ramses.py

@@ -223,7 +223,7 @@ CODES_SCHEMA: dict[Code, dict[str, Any]] = {  # rf_unknown
         SZ_NAME: "device_info",
         I_: r"^(00|FF)([0-9A-F]{30,})?$",  # r"^[0-9A-F]{32,}$" might be OK
         RQ: r"^00$",  # NOTE: 63 seen (no RP), some devices will accept [0-9A-F]{2}
-        # RP: r"^[0-9A-F]{2}([0-9A-F]){30,}$",  # NOTE: indx same as RQ
+        # RP: r"^[0-9A-F]{2}([0-9A-F]){30,}$",  # NOTE: index same as RQ
         SZ_LIFESPAN: False,
     },
     Code._10E1: {  # device_id
@@ -480,6 +480,7 @@ CODES_SCHEMA: dict[Code, dict[str, Any]] = {  # rf_unknown
         SZ_NAME: "fan_params",
         I_: r"^(00|01|15|16|17|21)00[0-9A-F]{6}([0-9A-F]{8}){4}[0-9A-F]{4}$",
         RQ: r"^(00|01|15|16|17|21)00[0-9A-F]{2}((00){19})?$",
+        RP: r"^(00|01|15|16|17|21)00[0-9A-F]{6}[0-9A-F]{8}(([0-9A-F]{8}){3}[0-9A-F]{4})?$",
         W_: r"^(00|01|15|16|17|21)00[0-9A-F]{6}[0-9A-F]{8}(([0-9A-F]{8}){3}[0-9A-F]{4})?$",
     },
     Code._2420: {  # unknown_2420, from OTB
@@ -1220,6 +1221,7 @@ SZ_MIN_VALUE: Final = "min_value"
 SZ_MAX_VALUE: Final = "max_value"
 SZ_PRECISION: Final = "precision"
 SZ_DATA_TYPE: Final = "data_type"
+SZ_DATA_UNIT: Final = "data_unit"
 
 _22F1_MODE_ITHO: dict[str, str] = {
     "00": "off",  # not seen
@@ -1265,12 +1267,13 @@ _22F1_SCHEMES: dict[str, dict[str, str]] = {
 
 # unclear if true for only Orcon/*all* models
 _2411_PARAMS_SCHEMA: dict[str, dict[str, Any]] = {
-    "31": {  # slot 09
+    "31": {  # slot 09 (FANs produced after 2021)
         SZ_DESCRIPTION: "Time to change filter (days)",
         SZ_MIN_VALUE: 0,
         SZ_MAX_VALUE: 1800,
         SZ_PRECISION: 30,
         SZ_DATA_TYPE: "10",
+        SZ_DATA_UNIT: "days",
     },
     "3D": {  # slot 00
         SZ_DESCRIPTION: "Away mode Supply fan rate (%)",
@@ -1278,6 +1281,7 @@ _2411_PARAMS_SCHEMA: dict[str, dict[str, Any]] = {
         SZ_MAX_VALUE: 0.4,
         SZ_PRECISION: 0.005,
         SZ_DATA_TYPE: "0F",
+        SZ_DATA_UNIT: "%",
     },
     "3E": {  # slot 01
         SZ_DESCRIPTION: "Away mode Exhaust fan rate (%)",
@@ -1285,6 +1289,7 @@ _2411_PARAMS_SCHEMA: dict[str, dict[str, Any]] = {
         SZ_MAX_VALUE: 0.4,
         SZ_PRECISION: 0.005,
         SZ_DATA_TYPE: "0F",
+        SZ_DATA_UNIT: "%",
     },
     "3F": {  # slot 02
         SZ_DESCRIPTION: "Low mode Supply fan rate (%)",
@@ -1292,6 +1297,7 @@ _2411_PARAMS_SCHEMA: dict[str, dict[str, Any]] = {
         SZ_MAX_VALUE: 0.8,
         SZ_PRECISION: 0.005,
         SZ_DATA_TYPE: "0F",
+        SZ_DATA_UNIT: "%",
     },
     "40": {  # slot 03
         SZ_DESCRIPTION: "Low mode Exhaust fan rate (%)",
@@ -1299,13 +1305,15 @@ _2411_PARAMS_SCHEMA: dict[str, dict[str, Any]] = {
         SZ_MAX_VALUE: 0.8,
         SZ_PRECISION: 0.005,
         SZ_DATA_TYPE: "0F",
+        SZ_DATA_UNIT: "%",
     },
     "41": {  # slot 04
         SZ_DESCRIPTION: "Medium mode Supply fan rate (%)",
-        SZ_MIN_VALUE: 0.0,
+        SZ_MIN_VALUE: 0.1,  # Orcon FAN responds with 0.0, but I guess this should be the same as for "42"
         SZ_MAX_VALUE: 1.0,
         SZ_PRECISION: 0.005,
         SZ_DATA_TYPE: "0F",
+        SZ_DATA_UNIT: "%",
     },
     "42": {  # slot 05
         SZ_DESCRIPTION: "Medium mode Exhaust fan rate (%)",
@@ -1313,13 +1321,15 @@ _2411_PARAMS_SCHEMA: dict[str, dict[str, Any]] = {
         SZ_MAX_VALUE: 1.0,
         SZ_PRECISION: 0.005,
         SZ_DATA_TYPE: "0F",
+        SZ_DATA_UNIT: "%",
     },
     "43": {  # slot 06
         SZ_DESCRIPTION: "High mode Supply fan rate (%)",
-        SZ_MIN_VALUE: 0.0,
+        SZ_MIN_VALUE: 0.1,
         SZ_MAX_VALUE: 1.0,
         SZ_PRECISION: 0.005,
         SZ_DATA_TYPE: "0F",
+        SZ_DATA_UNIT: "%",
     },
     "44": {  # slot 07
         SZ_DESCRIPTION: "High mode Exhaust fan rate (%)",
@@ -1327,6 +1337,15 @@ _2411_PARAMS_SCHEMA: dict[str, dict[str, Any]] = {
         SZ_MAX_VALUE: 1.0,
         SZ_PRECISION: 0.005,
         SZ_DATA_TYPE: "0F",
+        SZ_DATA_UNIT: "%",
+    },
+    "4B": {  # slot 09 (FANs produced before 2021) Also check code 22F7
+        SZ_DESCRIPTION: "(Test) Bypass Valve (0=auto, 1=open, 2=closed)",
+        SZ_MIN_VALUE: 0,
+        SZ_MAX_VALUE: 2,
+        SZ_PRECISION: 1,
+        SZ_DATA_TYPE: "00",
+        SZ_DATA_UNIT: "",
     },
     "4E": {  # slot 0A
         SZ_DESCRIPTION: "Moisture scenario position (0=medium, 1=high)",
@@ -1334,13 +1353,15 @@ _2411_PARAMS_SCHEMA: dict[str, dict[str, Any]] = {
         SZ_MAX_VALUE: 1,
         SZ_PRECISION: 1,
         SZ_DATA_TYPE: "00",
+        SZ_DATA_UNIT: "",
     },
     "52": {  # slot 0B
         SZ_DESCRIPTION: "Sensor sensitivity (%)",
         SZ_MIN_VALUE: 0,
         SZ_MAX_VALUE: 25.0,
         SZ_PRECISION: 0.1,
-        SZ_DATA_TYPE: "0F",
+        SZ_DATA_TYPE: "01",
+        SZ_DATA_UNIT: "%",
     },
     "54": {  # slot 0C
         SZ_DESCRIPTION: "Moisture sensor overrun time (mins)",
@@ -1348,13 +1369,15 @@ _2411_PARAMS_SCHEMA: dict[str, dict[str, Any]] = {
         SZ_MAX_VALUE: 60,
         SZ_PRECISION: 1,
         SZ_DATA_TYPE: "00",
+        SZ_DATA_UNIT: "min",
     },
     "75": {  # slot 0D
         SZ_DESCRIPTION: "Comfort temperature (°C)",
         SZ_MIN_VALUE: 0.0,
         SZ_MAX_VALUE: 30.0,
         SZ_PRECISION: 0.01,
-        SZ_DATA_TYPE: 92,
+        SZ_DATA_TYPE: "92",
+        SZ_DATA_UNIT: "°C",
     },
     "95": {  # slot 08
         SZ_DESCRIPTION: "Boost mode Supply/exhaust fan rate (%)",
@@ -1362,6 +1385,7 @@ _2411_PARAMS_SCHEMA: dict[str, dict[str, Any]] = {
         SZ_MAX_VALUE: 1.0,
         SZ_PRECISION: 0.005,
         SZ_DATA_TYPE: "0F",
+        SZ_DATA_UNIT: "%",
     },
 }
 
@@ -1456,3 +1480,19 @@ _31DA_FAN_INFO: dict[int, str] = {
 # RAMSES_ZONES_ALL = RAMSES_ZONES.pop("ALL")
 # RAMSES_ZONES_DHW = RAMSES_ZONES[ZON_ROLE.DHW]
 # [RAMSES_ZONES[k].update(RAMSES_ZONES_ALL) for k in RAMSES_ZONES if k != ZON_ROLE.DHW]
+
+__all__ = [
+    "CODES_BY_DEV_SLUG",
+    "CODES_SCHEMA",
+    "CODE_NAME_LOOKUP",
+    "CODES_BY_DEV_SLUG",
+    "CODES_SCHEMA",
+    "HVAC_KLASS_BY_VC_PAIR",
+    "_2411_PARAMS_SCHEMA",
+    "SZ_DESCRIPTION",
+    "SZ_MIN_VALUE",
+    "SZ_MAX_VALUE",
+    "SZ_PRECISION",
+    "SZ_DATA_TYPE",
+    "SZ_DATA_UNIT",
+]

ramses_tx/schemas.py

@@ -215,6 +215,7 @@ def ConvertNullToDict() -> Callable[[_T | None], _T | dict[Never, Never]]:
 
 
 SZ_ALIAS: Final = "alias"
+SZ_BOUND_TO: Final = "bound"
 SZ_CLASS: Final = "class"
 SZ_FAKED: Final = "faked"
 SZ_SCHEME: Final = "scheme"
@@ -296,6 +297,8 @@ def sch_global_traits_dict_factory(
             vol.Optional(SZ_CLASS, default="HVC"): vol.Any(
                 None, *hvac_slugs, *(str(DEV_TYPE_MAP[s]) for s in hvac_slugs)
             ),  # TODO: consider removing None
+            # Add 'bound' trait for FAN devices
+            vol.Optional(SZ_BOUND_TO): vol.Any(None, vol.Match(DEVICE_ID_REGEX.ANY)),
         }
     )
     SCH_TRAITS_HVAC = SCH_TRAITS_HVAC.extend(

ramses_tx/transport.py

@@ -44,7 +44,7 @@ import sys
 from collections import deque
 from collections.abc import Awaitable, Callable, Iterable
 from datetime import datetime as dt, timedelta as td
-from functools import wraps
+from functools import partial, wraps
 from io import TextIOWrapper
 from string import printable
 from time import perf_counter
@@ -142,8 +142,7 @@ else:  # is linux
 
     def list_links(devices: set[str]) -> list[str]:
         """Search for symlinks to ports already listed in devices."""
-
-        links = []
+        links: list[str] = []
         for device in glob.glob("/dev/*") + glob.glob("/dev/serial/by-id/*"):
             if os.path.islink(device) and os.path.realpath(device) in devices:
                 links.append(device)
@@ -174,7 +173,7 @@ else:  # is linux
         return result
 
 
-def is_hgi80(serial_port: SerPortNameT) -> bool | None:
+async def is_hgi80(serial_port: SerPortNameT) -> bool | None:
     """Return True/False if the device attached to the port has the attrs of an HGI80.
 
     Return None if it's not possible to tell (falsy should assume is evofw3).
@@ -209,7 +208,10 @@ def is_hgi80(serial_port: SerPortNameT) -> bool | None:
 
     # otherwise, we can look at device attrs via comports()...
     try:
-        komports = comports(include_links=True)
+        loop = asyncio.get_running_loop()
+        komports = await loop.run_in_executor(
+            None, partial(comports, include_links=True)
+        )
     except ImportError as err:
         raise exc.TransportSerialError(f"Unable to find {serial_port}: {err}") from err
 
@@ -841,8 +843,6 @@ class PortTransport(_RegHackMixin, _FullTransport, _PortTransportAbstractor):  #
             self._leak_sem(), name="PortTransport._leak_sem()"
         )
 
-        self._is_hgi80 = is_hgi80(self.serial.name)
-
         self._loop.create_task(
             self._create_connection(), name="PortTransport._create_connection()"
         )
@@ -855,6 +855,8 @@ class PortTransport(_RegHackMixin, _FullTransport, _PortTransportAbstractor):  #
 
         # signature also serves to discover the HGI's device_id (& for pkt log, if any)
 
+        self._is_hgi80 = await is_hgi80(self.serial.name)
+
         async def connect_sans_signature() -> None:
             """Call connection_made() without sending/waiting for a signature."""
 

ramses_tx/version.py

@@ -1,4 +1,4 @@
 """RAMSES RF - a RAMSES-II protocol decoder & analyser (transport layer)."""
 
-__version__ = "0.51.7"
+__version__ = "0.51.9"
 VERSION = __version__

ramses_rf-0.51.7.dist-info/RECORD

@@ -1,55 +0,0 @@
-ramses_cli/__init__.py,sha256=uvGzWqOf4avvgzxJNSLFWEelIWqSZ-AeLAZzg5x58bc,397
-ramses_cli/client.py,sha256=vbKS3KVPiGsDWLp5cR3SVBtXrs-TinzlxSbTgcb4G2k,19724
-ramses_cli/debug.py,sha256=vgR0lOHoYjWarN948dI617WZZGNuqHbeq6Tc16Da7b4,608
-ramses_cli/discovery.py,sha256=81XbmpNiCpUHVZBwo2g1eRwyJG-wZhpSsc44G3hHlFA,12972
-ramses_cli/utils/cat_slow.py,sha256=AhUpM5gnegCitNKU-JGHn-DrRzSi-49ZR1Qw6lxe_t8,607
-ramses_cli/utils/convert.py,sha256=D_YiCyX5na9pgC-_NhBlW9N1dgRKUK-uLtLBfofjzZM,1804
-ramses_rf/__init__.py,sha256=zONFBiRdf07cPTSxzr2V3t-b3CGokZjT9SGit4JUKRA,1055
-ramses_rf/binding_fsm.py,sha256=uZAOl3i19KCXqqlaLJWkEqMMP7NJBhVPW3xTikQD1fY,25996
-ramses_rf/const.py,sha256=L3z31CZ-xqno6oZp_h-67CB_5tDDqTwSWXsqRtsjMcs,5460
-ramses_rf/database.py,sha256=ZZZgucyuU1IHsSewGukZfDg2gu8KeNaEFriWKM0TUHs,10287
-ramses_rf/dispatcher.py,sha256=JGkqSi1o-YhQ2rj8tNkXwYLLeJIC7F061xpHoH8sSsM,11201
-ramses_rf/entity_base.py,sha256=V9m_Q5SOLP5ko3sok0NDvyz3YdYch1QsxM6tHCIE7cA,39212
-ramses_rf/exceptions.py,sha256=rzVZDcYxFH7BjUAQ3U1fHWtgBpwk3BgjX1TO1L1iM8c,2538
-ramses_rf/gateway.py,sha256=WdIIGgs87CYfXwSCSVb2YzqOgLC7W4bkpulWQb7PFNw,20564
-ramses_rf/helpers.py,sha256=TNk_QkpIOB3alOp1sqnA9LOzi4fuDCeapNlW3zTzNas,4250
-ramses_rf/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-ramses_rf/schemas.py,sha256=mYOUZOH5OIDNBxRM2vd8POzDWEEmLhxh5UtqjTpFNek,13287
-ramses_rf/version.py,sha256=4EfbWfYC4nSL7JCP_xnhFTpV6Yt5Vc4kNosAUW-CKNs,125
-ramses_rf/device/__init__.py,sha256=sUbH5dhbYFXSoM_TPFRutpRutBRpup7_cQ9smPtDTy8,4858
-ramses_rf/device/base.py,sha256=WGkBTUNjRUEe-phxdtdiXVCZnTi6-i1i_YT6g689UTM,17450
-ramses_rf/device/heat.py,sha256=2sCsggySVcuTzyXDmgWy76QbhlU5MQWSejy3zgI5BDE,54242
-ramses_rf/device/hvac.py,sha256=H_PUfG_jrrvJgtnu6Bco6PLxHn7CHALwebZzZI1ygFo,23917
-ramses_rf/system/__init__.py,sha256=uZLKio3gLlBzePa2aDQ1nxkcp1YXOGrn6iHTG8LiNIw,711
-ramses_rf/system/faultlog.py,sha256=GdGmVGT3137KsTlV_nhccgIFEmYu6DFsLTn4S-8JSok,12799
-ramses_rf/system/heat.py,sha256=3jaFEChU-HlWCRMY1y7u09s7AH4hT0pC63hnqwdmZOc,39223
-ramses_rf/system/schedule.py,sha256=Ts6tdZPTQLV5NkgwA73tPa5QUsnZNIIuYoKC-8VsXDk,18808
-ramses_rf/system/zones.py,sha256=9AH7ooN5QfiqvWuor2P1Dn8aILjQb2RWL9rWqDH1IjA,36075
-ramses_tx/__init__.py,sha256=4FsVOzICJ4H80LJ0MknZCN0_V-g0k1nMkHUQ0IdrJW8,3161
-ramses_tx/address.py,sha256=5swDr_SvOs1CxBmT-iJpldf8R00mOb7gKPMiEnxLz84,8452
-ramses_tx/command.py,sha256=y69y9NYgQHuPbm7h6xC0osf3e1YIKY9jwmsfPiJ8N6U,58348
-ramses_tx/const.py,sha256=QmwSS4BIN3ZFrLUiiFScP1RCUHuJ782V3ycRPQTtB_c,30297
-ramses_tx/exceptions.py,sha256=FJSU9YkvpKjs3yeTqUJX1o3TPFSe_B01gRGIh9b3PNc,2632
-ramses_tx/fingerprints.py,sha256=nfftA1E62HQnb-eLt2EqjEi_la0DAoT0wt-PtTMie0s,11974
-ramses_tx/frame.py,sha256=9lUVh8gAMXNRAolfFw2WuWANjn24AWkmscuM9Tm5imE,22036
-ramses_tx/gateway.py,sha256=TXLYwT6tFpmSokD29Qyj1ze7UGCxKidooeyP557Jfoo,11266
-ramses_tx/helpers.py,sha256=0VAJ505kpq4K9b9ZeskWI1o2sWwyCbdnKOKZviKFdgY,32913
-ramses_tx/logger.py,sha256=qYbUoNPnPaFWKVsYvLG6uTVuPTdZ8HsMzBbGx0DpBqc,10177
-ramses_tx/message.py,sha256=hl_gLfwrF79ftUNnsgNt3XGsIhM2Pts0MtZZuGjfaxk,13169
-ramses_tx/opentherm.py,sha256=58PXz9l5x8Ou6Fm3y-R_UnGHCYahoi2RKIDdYStUMzk,42378
-ramses_tx/packet.py,sha256=NGunaGCkEjhTp9t4mARK5e7kbqT-Z_JKCH7ibMYMJXU,7357
-ramses_tx/parsers.py,sha256=PVTbPqcYPUko3BKDaOQoFDwIo4LWAUx5kfRb2KURAMI,109917
-ramses_tx/protocol.py,sha256=ifj3qwcQivjQDaQUwM94xp-U8Pmef6zwSH7mav8DLWA,28867
-ramses_tx/protocol_fsm.py,sha256=YhHkTqbl8w-myimsOjV50uIFgg9HiApwPU7xA_jg5nU,26827
-ramses_tx/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-ramses_tx/ramses.py,sha256=9R-JrInORWUNMPklrAPQWwtr_2aaruQmFqQPw5mFkrE,52223
-ramses_tx/schemas.py,sha256=h2AcArVROy1_C4n6F0Crj4e-2BxXxH74xogFlc6nKHI,12769
-ramses_tx/transport.py,sha256=MwPnkQ0L-2qJt4mIJy3-C9XmHwBDjT7Kg-1LthPByVw,58331
-ramses_tx/typed_dicts.py,sha256=w-0V5t2Q3GiNUOrRAWiW9GtSwbta_7luME6GfIb1zhI,10869
-ramses_tx/typing.py,sha256=eF2SlPWhNhEFQj6WX2AhTXiyRQVXYnFutiepllYl2rI,5042
-ramses_tx/version.py,sha256=hWp2I2S7p1_tlItYBqDNAFpsM7kL_J8xYU-6mC2e_Ws,123
-ramses_rf-0.51.7.dist-info/METADATA,sha256=w3QiOIRJncgPc3R3h1MaxjMDOjzm0NYBHFEoeAr6o6A,3909
-ramses_rf-0.51.7.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-ramses_rf-0.51.7.dist-info/entry_points.txt,sha256=NnyK29baOCNg8DinPYiZ368h7MTH7bgTW26z2A1NeIE,50
-ramses_rf-0.51.7.dist-info/licenses/LICENSE,sha256=-Kc35W7l1UkdiQ4314_yVWv7vDDrg7IrJfMLUiq6Nfs,1074
-ramses_rf-0.51.7.dist-info/RECORD,,