qolsys-controller 0.0.44__py3-none-any.whl → 0.0.87__py3-none-any.whl

qolsys_controller/zwave_thermostat.py

@@ -1,48 +1,62 @@
 import logging
 
-from .enum_zwave import ThermostatFanMode, ThermostatMode
+from .enum_zwave import (
+    BITMASK_SUPPORTED_THERMOSTAT_FAN_MODE,
+    BITMASK_SUPPORTED_THERMOSTAT_MODE,
+    BITMASK_SUPPORTED_THERMOSTAT_SETPOINT_MODE,
+    ThermostatFanMode,
+    ThermostatMode,
+    ThermostatSetpointMode,
+    ZWaveMultilevelSensorScale,
+)
 from .zwave_device import QolsysZWaveDevice
 
 LOGGER = logging.getLogger(__name__)
 
 
 class QolsysThermostat(QolsysZWaveDevice):
-
-    def __init__(self, thermostat_dict: dict, zwave_dict: dict) -> None:
-
+    def __init__(self, thermostat_dict: dict[str, str], zwave_dict: dict[str, str]) -> None:
         super().__init__(zwave_dict)
 
-        self._thermostat_id = thermostat_dict.get("_id")
-        self._thermostat_version = thermostat_dict.get("version", "")
-        self._thermostat_opr = thermostat_dict.get("opr", "")
-        self._thermostat_partition_id = thermostat_dict.get("partition_id", "")
-        self._thermostat_name = thermostat_dict.get("thermostat_name", "")
-        self._thermostat_node_id = thermostat_dict.get("node_id", "")
-        self._thermostat_device_temp_unit = thermostat_dict.get("device_temp_unit", "")  # 'F'
-        self._thermostat_current_temp = thermostat_dict.get("current_temp", "")  # "78.0"
-        self._thermostat_target_cool_temp = thermostat_dict.get("target_cool_temp", "")  # "78"
-        self._thermostat_target_heat_temp = thermostat_dict.get("target_heat_temp", "")  # "65"
-        self._thermostat_target_temp = thermostat_dict.get("target_temp", "")
-        self._thermostat_power_usage = thermostat_dict.get("power_usage", "")
-        self._thermostat_mode = thermostat_dict.get("thermostat_mode", "")  # "2"
-        self._thermostat_mode_bitmask = thermostat_dict.get("thermostat_mode_bitmask", "")  # "7,24"
-        self._thermostat_fan_mode = thermostat_dict.get("fan_mode", "")  # "0"
-        self._thermostat_fan_mode_bitmask = thermostat_dict.get("fan_mode_bitmask", "")  # "67"
-        self._thermostat_set_point_mode = thermostat_dict.get("set_point_mode", "")
-        self._thermostat_set_point_mode_bitmask = thermostat_dict.get("set_point_mode_bitmask", "")  # "-122,1"
-        self._thermostat_created_by = thermostat_dict.get("created_by", "")
-        self._thermostat_created_date = thermostat_dict.get("created_date", "")
-        self._thermostat_updated_by = thermostat_dict.get("updated_by", "")
-        self._thermostat_last_updated_date = thermostat_dict.get("last_updated_date", "")
-        self._thermostat_mode_updated_time = thermostat_dict.get("thermostat_mode_updated_time", "")
-        self._thermostat_fan_mode_updated_time = thermostat_dict.get("fan_mode_updated_time", "")
-        self._thermostat_set_point_mode_updated_time = thermostat_dict.get("set_point_mode_updated_time", "")
-        self._thermostat_target_cool_temp_updated_time = thermostat_dict.get("target_cool_temp_updated_time", "")
-        self._thermostat_target_heat_temp_updated_time = thermostat_dict.get("target_heat_temp_updated_time", "")
-        self._thermostat_current_temp_updated_time = thermostat_dict.get("current_temp_updated_time", "")
-        self._thermostat_endpoint = thermostat_dict.get("endpoint", "")
-        self._thermostat_paired_status = thermostat_dict.get("paired_status", "")
-        self._thermostat_configuration_parameter = thermostat_dict.get("configuration_parameter", "")
+        self._thermostat_id: str = thermostat_dict.get("_id", "")
+        self._thermostat_version: str = thermostat_dict.get("version", "")
+        self._thermostat_opr: str = thermostat_dict.get("opr", "")
+        self._thermostat_partition_id: str = thermostat_dict.get("partition_id", "")
+        self._thermostat_name: str = thermostat_dict.get("thermostat_name", "")
+        self._thermostat_node_id: str = thermostat_dict.get("node_id", "")
+        self._thermostat_device_temp_unit: str = thermostat_dict.get("device_temp_unit", "")  # 'F'
+        self._thermostat_current_temp: str = thermostat_dict.get("current_temp", "")  # "78.0"
+        self._thermostat_target_cool_temp: str = thermostat_dict.get("target_cool_temp", "")  # "78"
+        self._thermostat_target_heat_temp: str = thermostat_dict.get("target_heat_temp", "")  # "65"
+        self._thermostat_target_temp: str = thermostat_dict.get("target_temp", "")
+        self._thermostat_power_usage: str = thermostat_dict.get("power_usage", "")
+        self._thermostat_mode: str = thermostat_dict.get("thermostat_mode", "")  # "2"
+        self._thermostat_mode_bitmask: str = thermostat_dict.get("thermostat_mode_bitmask", "")  # "7,24"
+        self._thermostat_fan_mode: str = thermostat_dict.get("fan_mode", "")  # "0"
+        self._thermostat_fan_mode_bitmask: str = thermostat_dict.get("fan_mode_bitmask", "")  # "67"
+        self._thermostat_set_point_mode: str = thermostat_dict.get("set_point_mode", "")
+        self._thermostat_set_point_mode_bitmask: str = thermostat_dict.get("set_point_mode_bitmask", "")  # "-122,1"
+        self._thermostat_created_by: str = thermostat_dict.get("created_by", "")
+        self._thermostat_created_date: str = thermostat_dict.get("created_date", "")
+        self._thermostat_updated_by: str = thermostat_dict.get("updated_by", "")
+        self._thermostat_last_updated_date: str = thermostat_dict.get("last_updated_date", "")
+        self._thermostat_mode_updated_time: str = thermostat_dict.get("thermostat_mode_updated_time", "")
+        self._thermostat_fan_mode_updated_time: str = thermostat_dict.get("fan_mode_updated_time", "")
+        self._thermostat_set_point_mode_updated_time: str = thermostat_dict.get("set_point_mode_updated_time", "")
+        self._thermostat_target_cool_temp_updated_time: str = thermostat_dict.get("target_cool_temp_updated_time", "")
+        self._thermostat_target_heat_temp_updated_time: str = thermostat_dict.get("target_heat_temp_updated_time", "")
+        self._thermostat_current_temp_updated_time: str = thermostat_dict.get("current_temp_updated_time", "")
+        self._thermostat_endpoint: str = thermostat_dict.get("endpoint", "")
+        self._thermostat_paired_status: str = thermostat_dict.get("paired_status", "")
+        self._thermostat_configuration_parameter: str = thermostat_dict.get("configuration_parameter", "")
+        self._thermostat_operating_state: str = thermostat_dict.get("operating_state", "")
+        self._thermostat_setpoint_capabilites = thermostat_dict.get("setpoint_capabilites", "")
+
+        self._thermostat_current_humidity: float | None = None
+
+    # -----------------------------
+    # properties + setters
+    # -----------------------------
 
     @property
     def thermostat_node_id(self) -> str:
@@ -52,44 +66,51 @@ class QolsysThermostat(QolsysZWaveDevice):
     def thermostat_name(self) -> str:
         return self._thermostat_name
 
-    @property
-    def thermostat_device_temp_unit(self) -> str:
-        return self._thermostat_device_temp_unit
-
-    @property
-    def thermostat_current_temp(self) -> str:
-        return self._thermostat_current_temp
-
-    @property
-    def thermostat_target_cool_temp(self) -> str:
-        return self._thermostat_target_cool_temp
-
-    @property
-    def thermostat_target_heat_temp(self) -> str:
-        return self._thermostat_target_heat_temp
+    @thermostat_name.setter
+    def thermostat_name(self, value: str) -> None:
+        if self._thermostat_name != value:
+            LOGGER.debug("Thermostat%s (%s) - name: %s", self.thermostat_node_id, self.thermostat_name, value)
+            self._thermostat_name = value
+            self.notify()
 
     @property
-    def thermostat_target_temp(self) -> str:
-        return self._thermostat_target_temp
+    def thermostat_operating_state(self) -> str:
+        return self._thermostat_operating_state
+
+    @thermostat_operating_state.setter
+    def thermostat_operating_state(self, value: str) -> None:
+        if self._thermostat_operating_state != value:
+            LOGGER.debug("Thermostat%s (%s) - operating_state: %s", self.thermostat_node_id, self.thermostat_name, value)
+            self._thermostat_operating_state = value
+            self.notify()
 
     @property
-    def thermostat_mode(self) -> str:
-        return self._thermostat_mode
+    def thermostat_configuration_parameter(self) -> str:
+        return self._thermostat_configuration_parameter
+
+    @thermostat_configuration_parameter.setter
+    def thermostat_configuration_parameter(self, value: str) -> None:
+        if self._thermostat_configuration_parameter != value:
+            LOGGER.debug(
+                "Thermostat%s (%s) - configuration_parameter: %s", self.thermostat_node_id, self.thermostat_name, value
+            )
+            self._thermostat_configuration_parameter = value
+            self.notify()
 
     @property
-    def thermostat_fan_mode(self) -> str:
-        return self.thermostat_fan_mode
+    def thermostat_setpoint_capabilites(self) -> str:
+        return self._thermostat_setpoint_capabilites
+
+    @thermostat_setpoint_capabilites.setter
+    def thermostat_setpoint_capabilites(self, value: str) -> None:
+        if self._thermostat_setpoint_capabilites != value:
+            LOGGER.debug("Thermostat%s (%s) - setpoint_capabilites: %s", self.thermostat_node_id, self.thermostat_name, value)
+            self._thermostat_setpoint_capabilites = value
+            self.notify()
 
     @property
-    def thermostat_set_point_mode(self) -> str:
-        return self._thermostat_set_point_mode
-
-    @thermostat_name.setter
-    def thermostat_name(self, value: str) -> None:
-        if self._thermostat_name != value:
-            LOGGER.debug("Thermostat%s (%s) - name: %s", self.thermostat_node_id, self.thermostat_name, value)
-            self._thermostat_name = value
-            self.notify()
+    def thermostat_device_temp_unit(self) -> str:
+        return self._thermostat_device_temp_unit
 
     @thermostat_device_temp_unit.setter
     def thermostat_device_temp_unit(self, value: str) -> None:
@@ -98,6 +119,10 @@ class QolsysThermostat(QolsysZWaveDevice):
             self._thermostat_device_temp_unit = value
             self.notify()
 
+    @property
+    def thermostat_current_temp(self) -> str:
+        return self._thermostat_current_temp
+
     @thermostat_current_temp.setter
     def thermostat_current_temp(self, value: str) -> None:
         if self._thermostat_current_temp != value:
@@ -105,6 +130,10 @@ class QolsysThermostat(QolsysZWaveDevice):
             self._thermostat_current_temp = value
             self.notify()
 
+    @property
+    def thermostat_target_cool_temp(self) -> str:
+        return self._thermostat_target_cool_temp
+
     @thermostat_target_cool_temp.setter
     def thermostat_target_cool_temp(self, value: str) -> None:
         if self._thermostat_target_cool_temp != value:
@@ -112,6 +141,10 @@ class QolsysThermostat(QolsysZWaveDevice):
             self._thermostat_target_cool_temp = value
             self.notify()
 
+    @property
+    def thermostat_target_heat_temp(self) -> str:
+        return self._thermostat_target_heat_temp
+
     @thermostat_target_heat_temp.setter
     def thermostat_target_heat_temp(self, value: str) -> None:
         if self._thermostat_target_heat_temp != value:
@@ -119,6 +152,10 @@ class QolsysThermostat(QolsysZWaveDevice):
             self._thermostat_target_heat_temp = value
             self.notify()
 
+    @property
+    def thermostat_target_temp(self) -> str:
+        return self._thermostat_target_temp
+
     @thermostat_target_temp.setter
     def thermostat_target_temp(self, value: str) -> None:
         if self._thermostat_target_temp != value:
@@ -126,20 +163,82 @@ class QolsysThermostat(QolsysZWaveDevice):
             self._thermostat_target_temp = value
             self.notify()
 
+    @property
+    def thermostat_mode(self) -> ThermostatMode | None:
+        value = self._thermostat_mode.strip("[]").split(",")
+
+        if len(value) > 1:
+            LOGGER.error(
+                "Thermostat%s (%s) - thermostat_mode has multiple values: %s",
+                self.thermostat_node_id,
+                self.thermostat_name,
+                value,
+            )
+            return None
+
+        try:
+            int_value = int(value[0])
+            for mode in ThermostatMode:
+                if int_value == mode.value:
+                    return mode
+            return None
+        except ValueError:
+            LOGGER.error(
+                "Thermostat%s (%s) - thermostat_mode value is not an integer: %s",
+                self.thermostat_node_id,
+                self.thermostat_name,
+                value,
+            )
+            return None
+
     @thermostat_mode.setter
     def thermostat_mode(self, value: str) -> None:
-        if self._thermostat_mode != value:
-            LOGGER.debug("Thermostat%s (%s) - mode: %s", self.thermostat_node_id, self.thermostat_name, value)
-            self._thermostat_mode = value
+        new_value = value.strip("[]")
+        if self._thermostat_mode != new_value:
+            LOGGER.debug("Thermostat%s (%s) - mode: %s", self.thermostat_node_id, self.thermostat_name, new_value)
+            self._thermostat_mode = new_value
             self.notify()
 
+    @property
+    def thermostat_fan_mode(self) -> ThermostatFanMode | None:
+        value = self._thermostat_fan_mode.strip("[]").split(",")
+
+        if len(value) > 1:
+            LOGGER.error(
+                "Thermostat%s (%s) - thermostat_fan_mode has multiple values: %s",
+                self.thermostat_node_id,
+                self.thermostat_name,
+                value,
+            )
+            return None
+
+        try:
+            int_value = int(value[0])
+            for mode in ThermostatFanMode:
+                if int_value == mode.value:
+                    return mode
+            return None
+        except ValueError:
+            LOGGER.error(
+                "Thermostat%s (%s) - thermostat_fan_mode value is not an integer: %s",
+                self.thermostat_node_id,
+                self.thermostat_name,
+                value,
+            )
+            return None
+
     @thermostat_fan_mode.setter
     def thermostat_fan_mode(self, value: str) -> None:
-        if self._thermostat_fan_mode != value:
-            LOGGER.debug("Thermostat%s (%s) - fan_mode: %s", self.thermostat_node_id, self.thermostat_name, value)
-            self._thermostat_fan_mode = value
+        new_value = value.strip("[]")
+        if self._thermostat_fan_mode != new_value:
+            LOGGER.debug("Thermostat%s (%s) - fan_mode: %s", self.thermostat_node_id, self.thermostat_name, new_value)
+            self._thermostat_fan_mode = new_value
             self.notify()
 
+    @property
+    def thermostat_set_point_mode(self) -> str:
+        return self._thermostat_set_point_mode.strip("[]")
+
     @thermostat_set_point_mode.setter
     def thermostat_set_point_mode(self, value: str) -> None:
         if self._thermostat_set_point_mode != value:
@@ -147,93 +246,116 @@ class QolsysThermostat(QolsysZWaveDevice):
             self._thermostat_set_point_mode = value
             self.notify()
 
-    def update_thermostat(self, data: dict) -> None:  # noqa: C901, PLR0912, PLR0915
+    @property
+    def thermostat_current_humidity(self) -> float | None:
+        sensor = self.multilevelsensor_value(ZWaveMultilevelSensorScale.RELATIVE_HUMIDITY)
+
+        if not sensor:
+            return None
+
+        if len(sensor) == 1:
+            return sensor[0].value
+
+        LOGGER.error("Multiple humidity sensor present")
+        return sensor[0].value
+
+    def update_raw(self, payload: bytes) -> None:
+        pass
+
+    def update_thermostat(self, data: dict[str, str]) -> None:  # noqa: C901, PLR0912, PLR0915
         # Check if we are updating same none_id
         node_id_update = data.get("node_id", "")
-        if node_id_update != self.thermostat_node_id_node_id:
+        if node_id_update != self.thermostat_node_id:
             LOGGER.error(
                 "Updating Thermostat '%s' (%s) with Thermostat '%s' (different id)",
-                self.thermostat_node_id, self.thermostat_name, node_id_update,
+                self.thermostat_node_id,
+                self.thermostat_name,
+                node_id_update,
             )
             return
 
         self.start_batch_update()
 
         if "version" in data:
-            self._thermostat_version = data.get("version")
+            self._thermostat_version = data.get("version", "")
         if "opr" in data:
-            self._thermostat_opr = data.get("opr")
+            self._thermostat_opr = data.get("opr", "")
         if "partition_id" in data:
-            self._thermostat_partition_id = data.get("partition_id")
+            self._thermostat_partition_id = data.get("partition_id", "")
         if "thermostat_name" in data:
-            self.thermostat_name = data.get("thermostat_name")
+            self.thermostat_name = data.get("thermostat_name", "")
         if "device_temp_unit" in data:
-            self.thermostat_device_temp_unit = data.get("device_temp_unit")
+            self.thermostat_device_temp_unit = data.get("device_temp_unit", "")
         if "current_temp" in data:
-            self.thermostat_current_temp = data.get("current_temp")
+            self.thermostat_current_temp = data.get("current_temp", "")
         if "target_cool_temp" in data:
-            self.thermostat_target_cool_temp = data.get("target_cool_temp")
+            self.thermostat_target_cool_temp = data.get("target_cool_temp", "")
         if "target_heat_temp" in data:
-            self.thermostat_target_heat_temp = data.get("target_heat_temp")
+            self.thermostat_target_heat_temp = data.get("target_heat_temp", "")
         if "target_temp" in data:
-            self.thermostat_target_temp = data.get("target_temp")
+            self.thermostat_target_temp = data.get("target_temp", "")
         if "power_usage" in data:
-            self._thermostat_power_usage = data.get("power_usage")
+            self._thermostat_power_usage = data.get("power_usage", "")
         if "thermostat_mode" in data:
-            self.thermostat_mode = data.get("thermostat_mode")
+            self.thermostat_mode = data.get("thermostat_mode", "")
         if "thermostat_mode_bitmask" in data:
-            self._thermostat_mode_bitmask = data.get("thermostat_mode_bitmask")
+            self._thermostat_mode_bitmask = data.get("thermostat_mode_bitmask", "")
         if "fan_mode" in data:
-            self.thermostat_fan_mode = data.get("fan_mode")
+            self.thermostat_fan_mode = data.get("fan_mode", "")
         if "fan_mode_bitmask" in data:
-            self._thermostat_fan_mode_bitmask = data.get("fan_mode_bitmask")
+            self._thermostat_fan_mode_bitmask = data.get("fan_mode_bitmask", "")
         if "set_point_mode" in data:
-            self.thermostat_set_point_mode = data.get("set_point_mode")
+            self.thermostat_set_point_mode = data.get("set_point_mode", "")
         if "set_point_mode_bitmask" in data:
-            self._thermostat_set_point_mode_bitmask = data.get("set_point_mode_bitmask")
+            self._thermostat_set_point_mode_bitmask = data.get("set_point_mode_bitmask", "")
         if "created_by" in data:
-            self._thermostat_created_by = data.get("created_by")
+            self._thermostat_created_by = data.get("created_by", "")
         if "updated_by" in data:
-            self._thermostat_updated_by = data.get("updated_by")
+            self._thermostat_updated_by = data.get("updated_by", "")
         if "last_updated_date" in data:
-            self._thermostat_last_updated_date = data.get("last_updated_date")
+            self._thermostat_last_updated_date = data.get("last_updated_date", "")
         if "thermostat_mode_updated_time" in data:
-            self._thermostat_mode_updated_time = data.get("thermostat_mode_updated_time")
+            self._thermostat_mode_updated_time = data.get("thermostat_mode_updated_time", "")
         if "fan_mode_updated_time" in data:
-            self._thermostat_fan_mode_updated_time = data.get("fan_mode_updated_time")
+            self._thermostat_fan_mode_updated_time = data.get("fan_mode_updated_time", "")
         if "set_point_mode_updated_time" in data:
-            self._thermostat_set_point_mode_updated_time = data.get("set_point_mode_updated_time")
+            self._thermostat_set_point_mode_updated_time = data.get("set_point_mode_updated_time", "")
         if "target_cool_temp_updated_time" in data:
-            self._thermostat_target_cool_temp_updated_time = data.get("target_cool_temp_updated_time")
+            self._thermostat_target_cool_temp_updated_time = data.get("target_cool_temp_updated_time", "")
         if "target_heat_temp_updated_time" in data:
-            self._thermostat_target_heat_temp_updated_time = data.get("target_heat_temp_updated_time")
+            self._thermostat_target_heat_temp_updated_time = data.get("target_heat_temp_updated_time", "")
         if "current_temp_updated_time" in data:
-            self._thermostat_current_temp_updated_time = data.get("current_temp_updated_time")
+            self._thermostat_current_temp_updated_time = data.get("current_temp_updated_time", "")
         if "paired_status" in data:
-            self._thermostat_paired_status = data.get("paired_status")
+            self._thermostat_paired_status = data.get("paired_status", "")
         if "endpoint" in data:
-            self._thermostat_endpoint = data.get("endpoint")
+            self._thermostat_endpoint = data.get("endpoint", "")
         if "configuration_parameter" in data:
-            self._thermostat_configuration_parameter = data.get("configuration_parameter")
+            self._thermostat_configuration_parameter = data.get("configuration_parameter", "")
+        if "operating_state" in data:
+            self.thermostat_operating_state = data.get("operating_state", "")
+        if "setpoint_capabilites" in data:
+            self.thermostat_setpoint_capabilites = data.get("setpoint_capabilites", "")
 
         self.end_batch_update()
 
-    def to_dict_thermostat(self) -> dict:
+    def to_dict_thermostat(self) -> dict[str, str]:
         return {
             "_id": self._thermostat_id,
             "version": self._thermostat_version,
             "opr": self._thermostat_opr,
             "partition_id": self._thermostat_partition_id,
             "thermostat_name": self.thermostat_name,
+            "node_id": self.thermostat_node_id,
             "device_temp_unit": self.thermostat_device_temp_unit,
             "current_temp": self.thermostat_current_temp,
             "target_cool_temp": self.thermostat_target_cool_temp,
             "target_heat_temp": self.thermostat_target_heat_temp,
             "target_temp": self.thermostat_target_temp,
             "power_usage": self._thermostat_power_usage,
-            "thermostat_mode": self.thermostat_mode,
+            "thermostat_mode": self._thermostat_mode,
             "thermostat_mode_bitmask": self._thermostat_mode_bitmask,
-            "fan_mode": self.thermostat_fan_mode,
+            "fan_mode": self._thermostat_fan_mode,
             "fan_mode_bitmask": self._thermostat_fan_mode_bitmask,
             "set_point_mode": self.thermostat_set_point_mode,
             "set_point_mode_bitmask": self._thermostat_set_point_mode_bitmask,
@@ -248,59 +370,43 @@ class QolsysThermostat(QolsysZWaveDevice):
             "current_temp_updated_time": self._thermostat_current_temp_updated_time,
             "paired_status": self._thermostat_paired_status,
             "endpoint": self._thermostat_endpoint,
-            "configuration_parameter": self._thermostat_configuration_parameter,
+            "configuration_parameter": self.thermostat_configuration_parameter,
+            "operating_state": self.thermostat_operating_state,
+            "setpoint_capabilites": self._thermostat_setpoint_capabilites,
         }
 
-    def thermostat_mode(self) -> ThermostatMode:
-        thermostat_mode = int(self._thermostat_mode)
-        for mode in ThermostatMode:
-            if thermostat_mode == mode:
-                return mode
-        return None
-
     def available_thermostat_mode(self) -> list[ThermostatMode]:
-
-        int_list = [int(x) for x in self._thermostat_mode_bitmask.split(",")]
+        int_list = [int(x) for x in self._thermostat_mode_bitmask.strip("[]").split(",")]
         byte_array = bytes(int_list)
         bitmask = int.from_bytes(byte_array, byteorder="little")
 
-        mode_array = []
-        for mode in ThermostatMode:
-            if mode.value & bitmask:
-                mode_array.append(mode)
-
-        return mode_array
+        supported = []
+        for bit, mode in BITMASK_SUPPORTED_THERMOSTAT_MODE.items():
+            if bitmask & (1 << bit):
+                supported.append(mode)
 
-    def thermostat_fan_mode(self) -> ThermostatFanMode:
-        thermostat_fan_mode = int(self._thermostat_fan_mode)
-        for mode in ThermostatMode:
-            if thermostat_fan_mode == mode:
-                return mode
-        return None
+        return supported
 
     def available_thermostat_fan_mode(self) -> list[ThermostatFanMode]:
-
-        int_list = [int(x) for x in self._thermostat_fan_mode_bitmask.split(",")]
+        int_list = [int(x) for x in self._thermostat_fan_mode_bitmask.strip("[]").split(",")]
         byte_array = bytes(int_list)
         bitmask = int.from_bytes(byte_array, byteorder="little")
 
-        fan_mode_array = []
-        for mode in ThermostatFanMode:
-            if mode.value & bitmask:
-                fan_mode_array.append(mode)
+        supported = []
+        for bit, mode in BITMASK_SUPPORTED_THERMOSTAT_FAN_MODE.items():
+            if bitmask & (1 << bit):
+                supported.append(mode)
 
-        return fan_mode_array
+        return supported
 
-    def available_thermostat_set_point_mode(self) -> list[ThermostatMode]:
-
-        int_list = [int(x) for x in self._thermostat_set_point_mode_bitmask.split(",")]
+    def available_thermostat_set_point_mode(self) -> list[ThermostatSetpointMode]:
+        int_list = [int(x) for x in self._thermostat_set_point_mode_bitmask.strip("[]").split(",")]
         byte_array = bytes(int_list)
         bitmask = int.from_bytes(byte_array, byteorder="little")
 
-        set_point_mode_array = []
-        for mode in ThermostatMode:
-            if mode.value & bitmask:
-                set_point_mode_array.append(mode)
-
-        return set_point_mode_array
+        supported = []
+        for bit, mode in BITMASK_SUPPORTED_THERMOSTAT_SETPOINT_MODE.items():
+            if bitmask & (1 << bit):
+                supported.append(mode)
 
+        return supported

qolsys_controller-0.0.87.dist-info/METADATA

@@ -0,0 +1,89 @@
+Metadata-Version: 2.4
+Name: qolsys-controller
+Version: 0.0.87
+Summary: A Python module that emulates a virtual IQ Remote device, enabling full local control of a Qolsys IQ Panel
+Project-URL: Homepage, https://github.com/EHylands/QolsysController
+Project-URL: Issues, https://github.com/EHylands/QolsysController/issues
+Project-URL: Repository, https://github.com/EHylands/QolsysController.git
+Author: Eric Hylands
+License-Expression: MIT
+License-File: LICENSE
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Home Automation
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+
+# Qolsys Controller - qolsys-controller
+
+[![Build](https://github.com/EHylands/QolsysController/actions/workflows/build.yml/badge.svg)](https://github.com/EHylands/QolsysController/actions/workflows/build.yml)
+
+A Python module that emulates a virtual IQ Remote device, enabling full **local control** of a Qolsys IQ Panel over MQTT — no cloud access required.
+
+## QolsysController
+- ✅ Connects directly to the **Qolsys Panel's local MQTT server as an IQ Remote**
+- 🔐 Pairs by only using **Installer Code** (same procedure as standard IQ Remote pairing)
+- 🔢 Supports **4-digit user codes**
+- ⚠️ Uses a **custom local usercode database** — panel's internal user code verification process is not yet supported
+
+## ✨ Functionality Highlights
+
+| Category               | Feature                              | Status |
+|------------------------|--------------------------------------|--------|
+| **Panel**              | Diagnostic Sensors                   | ✅     |
+|                        | Panel Scenes                         | ✅     |
+|                        | Weather Forecast                     | ✅     |
+|                        | (Alarm.com Weather to Panel)         |        |
+| **Partition**          | Arming Status                        | ✅     |
+|                        | Alarm State                          | ✅     |
+|                        | Home Instant Arming                  | ✅     |
+|                        | Home Silent Disarming (Firmware 4.6.1)| ✅     |
+|                        | Set Exit Sounds                      | ✅     |
+|                        | Set Entry Delay                      | ✅            |
+|                        | TTS                                  | 🛠️     |
+| **Zones**              | Sensor Status                        | ✅     |
+|                        | Tamper State                         | ✅     |
+|                        | Battery Level                        | ✅     |
+|                        | Temperature (supported PowerG device)| ✅     |
+|                        | Light (supported PowerG device)      | ✅     |
+|                        | Average dBm                          | ✅     |
+|                        | Latest dBm                           | ✅     |
+| **Z-Wave Devices**     | Battery Level                        | ✅     |
+|                        | Node Status                          | ✅     |
+|                        | Control Generic Devices              | TBD    |
+| **Z-Wave Dimmers**     | Binary Switch                        | ✅     |
+|                        | Multi Level Dimmer                   | ✅     |
+| **Z-Wave Door Locks**  | Lock, Unlock                         | ✅     |
+| **Z-Wave Thermostats** | Read device status                   | ✅     |
+|                        | Write device status                  | ✅     |
+| **Z-Wave Garage Doors**|                                      | 🛠️     |
+| **Z-Wave Outlets**     |                                      | 🛠️     |
+
+
+## ⚠️ Certificate Warning
+
+During pairing, the main panel issues **only one signed client certificate** per virtual IQ Remote. If any key files are lost or deleted, re-pairing may become impossible. 
+
+A new PKI, including a new private key, can be recreated under specific circumstances, though the precise conditions remain unknown at this time.
+
+**Important:**  
+Immediately back up the following files from the `pki/` directory after initial pairing:
+
+- `.key` (private key)
+- `.cer` (certificate)
+- `.csr` (certificate signing request)
+- `.secure` (signed client certificate)
+- `.qolsys` (Qolsys Panel public certificate)
+
+Store these files securely.
+
+## 📦 Installation
+
+```bash
+git clone https://github.com/EHylands/QolsysController.git
+cd qolsys_controller
+pip3.12 install -r requirements.txt
+
+# Change panel_ip and plugin_in in main.py file
+python3.12 example.py
+```