plugwise 0.37.1__tar.gz → 0.37.2__tar.gz

{plugwise-0.37.1 → plugwise-0.37.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: plugwise
-Version: 0.37.1
+Version: 0.37.2
 Summary: Plugwise Smile (Adam/Anna/P1) and Stretch module for Python 3.
 Home-page: https://github.com/plugwise/python-plugwise
 Author: Plugwise device owners
@@ -42,11 +42,8 @@ Requires-Python: >=3.11.0
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: aiohttp
-Requires-Dist: async_timeout
-Requires-Dist: crcmod
 Requires-Dist: defusedxml
 Requires-Dist: munch
-Requires-Dist: pyserial
 Requires-Dist: python-dateutil
 
 # Plugwise python module

{plugwise-0.37.1 → plugwise-0.37.2}/plugwise/constants.py

@@ -121,21 +121,20 @@ P1_LEGACY_MEASUREMENTS: Final[dict[str, UOM]] = {
 # radiator_valve: 'uncorrected_temperature', 'temperature_offset'
 
 DEVICE_MEASUREMENTS: Final[dict[str, DATA | UOM]] = {
-    # HA Core thermostat current_temperature
-    "temperature": UOM(TEMP_CELSIUS),
-    # HA Core thermostat setpoint
-    "thermostat": DATA("setpoint", TEMP_CELSIUS),
-    # Specific for an Anna
-    "illuminance": UOM(UNIT_LUMEN),
+    "humidity": UOM(PERCENTAGE),  # Specific for a Jip
+    "illuminance": UOM(UNIT_LUMEN),  # Specific for an Anna
+    "temperature": UOM(TEMP_CELSIUS),  # HA Core thermostat current_temperature
+    "thermostat": DATA("setpoint", TEMP_CELSIUS),  # HA Core thermostat setpoint
+    ########################################################
     # Specific for an Anna with heatpump extension installed
     "cooling_activation_outdoor_temperature": UOM(TEMP_CELSIUS),
     "cooling_deactivation_threshold": UOM(TEMP_CELSIUS),
-    # Specific for a Lisa a Tom/Floor
+    ##################################
+    # Specific for a Lisa or Tom/Floor
     "battery": UOM(PERCENTAGE),
     "temperature_difference": UOM(DEGREE),
     "valve_position": UOM(PERCENTAGE),
-    # Specific for a Jip
-    "humidity": UOM(PERCENTAGE),
+    #####################
     # Specific for a Plug
     "electricity_consumed": UOM(POWER_WATT),
     "electricity_produced": UOM(POWER_WATT),
@@ -144,39 +143,43 @@ DEVICE_MEASUREMENTS: Final[dict[str, DATA | UOM]] = {
 
 # Heater Central related measurements
 HEATER_CENTRAL_MEASUREMENTS: Final[dict[str, DATA | UOM]] = {
+    "boiler_state": DATA(
+        "flame_state", NONE
+    ),  # Legacy Anna: similar to flame-state on Anna/Adam
     "boiler_temperature": DATA("water_temperature", TEMP_CELSIUS),
+    "central_heating_state": DATA(
+        "c_heating_state", NONE
+    ),  # For Elga (heatpump) use this instead of intended_central_heating_state
+    "central_heater_water_pressure": DATA("water_pressure", PRESSURE_BAR),
+    "compressor_state": UOM(NONE),  # present with heatpump
+    "cooling_enabled": UOM(
+        NONE
+    ),  # Available with the Loria and Elga (newer Anna firmware) heatpumps
+    "cooling_state": UOM(NONE),
     "domestic_hot_water_mode": DATA("select_dhw_mode", NONE),
     "domestic_hot_water_setpoint": UOM(TEMP_CELSIUS),
     "domestic_hot_water_state": DATA("dhw_state", NONE),
     "domestic_hot_water_temperature": DATA("dhw_temperature", TEMP_CELSIUS),
     "elga_status_code": UOM(NONE),
+    "intended_boiler_state": DATA(
+        "heating_state", NONE
+    ),  # Legacy Anna: shows when heating is active, we don't show dhw_state, cannot be determined reliably
+    "flame_state": UOM(
+        NONE
+    ),  # Also present when there is a single gas-heater
     "intended_boiler_temperature": UOM(
         TEMP_CELSIUS
     ),  # Non-zero when heating, zero when dhw-heating
-    "central_heating_state": DATA(
-        "c_heating_state", NONE
-    ),  # For Elga (heatpump) use this instead of intended_central_heating_state
     "intended_central_heating_state": DATA(
         "heating_state", NONE
     ),  # This key shows in general the heating-behavior better than c-h_state. except when connected to a heatpump
     "modulation_level": UOM(PERCENTAGE),
     "return_water_temperature": DATA("return_temperature", TEMP_CELSIUS),
-    # Used with the Elga heatpump - marcelveldt
-    "compressor_state": UOM(NONE),
-    "cooling_state": UOM(NONE),
-    "thermostat_supports_cooling": UOM(NONE),
-    # Available with the Loria and Elga (newer Anna firmware) heatpumps
-    "cooling_enabled": UOM(NONE),
-    # Next 2 keys are used to show the state of the gas-heater used next to the Elga heatpump - marcelveldt
-    "slave_boiler_state": UOM(NONE),
-    "flame_state": UOM(NONE),  # Also present when there is a single gas-heater
-    "central_heater_water_pressure": DATA("water_pressure", PRESSURE_BAR),
-    # Legacy Anna: similar to flame-state on Anna/Adam
-    "boiler_state": DATA("flame_state", NONE),
-    # Legacy Anna: shows when heating is active, we don't show dhw_state, cannot be determined reliably
-    "intended_boiler_state": DATA("heating_state", NONE),
-    # Outdoor temperature from APPLIANCES - present for a heatpump
-    "outdoor_temperature": DATA("outdoor_air_temperature", TEMP_CELSIUS),
+    "outdoor_temperature": DATA(
+        "outdoor_air_temperature", TEMP_CELSIUS
+    ),  # Outdoor temperature from APPLIANCES - present for a heatpump
+    "slave_boiler_state": DATA("secondary_boiler_state", NONE),
+    "thermostat_supports_cooling": UOM(NONE),  # present with heatpump
 }
 
 OBSOLETE_MEASUREMENTS: Final[tuple[str, ...]] = (
@@ -253,22 +256,22 @@ ApplianceType = Literal[
 ]
 
 BinarySensorType = Literal[
-    "cooling_enabled",
     "compressor_state",
+    "cooling_enabled",
     "cooling_state",
     "dhw_state",
     "flame_state",
     "heating_state",
     "plugwise_notification",
-    "slave_boiler_state",
+    "secondary_boiler_state",
 ]
 BINARY_SENSORS: Final[tuple[str, ...]] = get_args(BinarySensorType)
 
 LIMITS: Final[tuple[str, ...]] = (
+    "lower_bound",
     "offset",
-    "setpoint",
     "resolution",
-    "lower_bound",
+    "setpoint",
     "upper_bound",
 )
 
@@ -329,8 +332,8 @@ SENSORS: Final[tuple[str, ...]] = get_args(SensorType)
 
 SPECIAL_PLUG_TYPES: Final[tuple[str, ...]] = (
     "central_heating_pump",
-    "valve_actuator",
     "heater_electric",
+    "valve_actuator",
 )
 
 SpecialType = Literal[
@@ -350,14 +353,14 @@ SwitchType = Literal[
 ]
 SWITCHES: Final[tuple[str, ...]] = get_args(SwitchType)
 
-SWITCH_GROUP_TYPES: Final[tuple[str, ...]] = ("switching", "report")
+SWITCH_GROUP_TYPES: Final[tuple[str, ...]] = ("report", "switching")
 
 THERMOSTAT_CLASSES: Final[tuple[str, ...]] = (
     "thermostat",
+    "thermostatic_radiator_valve",
     "thermo_sensor",
     "zone_thermometer",
     "zone_thermostat",
-    "thermostatic_radiator_valve",
 )
 
 ToggleNameType = Literal[
@@ -392,25 +395,25 @@ class ModelData(TypedDict):
     """The ModelData class."""
 
     contents: bool
-    vendor_name: str | None
-    vendor_model: str | None
-    hardware_version: str | None
     firmware_version: str | None
-    zigbee_mac_address: str | None
+    hardware_version: str | None
     reachable: bool | None
+    vendor_model: str | None
+    vendor_name: str | None
+    zigbee_mac_address: str | None
 
 
 class SmileBinarySensors(TypedDict, total=False):
     """Smile Binary Sensors class."""
 
-    cooling_enabled: bool
     compressor_state: bool
+    cooling_enabled: bool
     cooling_state: bool
     dhw_state: bool
     flame_state: bool
     heating_state: bool
     plugwise_notification: bool
-    slave_boiler_state: bool
+    secondary_boiler_state: bool
 
 
 class SmileSensors(TypedDict, total=False):
@@ -482,9 +485,9 @@ class ThermoLoc(TypedDict, total=False):
     """Thermo Location class."""
 
     name: str
-    master: str | None
-    master_prio: int
-    slaves: set[str]
+    primary: str | None
+    primary_prio: int
+    secondary: set[str]
 
 
 class ActuatorData(TypedDict, total=False):

{plugwise-0.37.1 → plugwise-0.37.2}/plugwise/data.py

@@ -125,7 +125,7 @@ class SmileData(SmileHelper):
         self._device_data_switching_group(device, data)
         # Adam data
         self._device_data_adam(device, data)
-        # Skip obtaining data for non master-thermostats
+        # Skip obtaining data for (Adam) secondary thermostats
         if device["dev_class"] not in ZONE_THERMOSTATS:
             return data
 
@@ -164,7 +164,7 @@ class SmileData(SmileHelper):
             ):
                 data["binary_sensors"]["heating_state"] = self._heating_valves() != 0
 
-            # Show the allowed regulation modes and gateway_modes
+            # Show the allowed regulation_modes and gateway_modes
             if device["dev_class"] == "gateway":
                 if self._reg_allowed_modes:
                     data["regulation_modes"] = self._reg_allowed_modes
@@ -173,7 +173,7 @@ class SmileData(SmileHelper):
                     data["gateway_modes"] = self._gw_allowed_modes
                     self._count += 1
 
-            # Control_state, only for Adam master thermostats
+            # Control_state, only available for Adam primary thermostats
             if device["dev_class"] in ZONE_THERMOSTATS:
                 loc_id = device["location"]
                 if ctrl_state := self._control_state(loc_id):

{plugwise-0.37.1 → plugwise-0.37.2}/plugwise/helper.py

@@ -813,7 +813,7 @@ class SmileHelper(SmileCommon):
         """Helper-function for smile.py: get_all_devices().
 
         Update locations with thermostat ranking results and use
-        the result to update the device_class of slave thermostats.
+        the result to update the device_class of secondary thermostats.
         """
         self._thermo_locs = self._match_locations()
 
@@ -828,11 +828,11 @@ class SmileHelper(SmileCommon):
             for dev_id, device in self.gw_devices.items():
                 self._rank_thermostat(thermo_matching, loc_id, dev_id, device)
 
-        # Update slave thermostat class where needed
+        # Update secondary thermostat class where needed
         for dev_id, device in self.gw_devices.items():
             if (loc_id := device["location"]) in self._thermo_locs:
                 tl_loc_id = self._thermo_locs[loc_id]
-                if "slaves" in tl_loc_id and dev_id in tl_loc_id["slaves"]:
+                if "secondary" in tl_loc_id and dev_id in tl_loc_id["secondary"]:
                     device["dev_class"] = "thermo_sensor"
 
     def _match_locations(self) -> dict[str, ThermoLoc]:
@@ -845,7 +845,7 @@ class SmileHelper(SmileCommon):
             for appliance_details in self.gw_devices.values():
                 if appliance_details["location"] == location_id:
                     location_details.update(
-                        {"master": None, "master_prio": 0, "slaves": set()}
+                        {"primary": None, "primary_prio": 0, "secondary": set()}
                     )
                     matched_locations[location_id] = location_details
 
@@ -860,29 +860,29 @@ class SmileHelper(SmileCommon):
     ) -> None:
         """Helper-function for _scan_thermostats().
 
-        Rank the thermostat based on appliance_details: master or slave.
+        Rank the thermostat based on appliance_details: primary or secondary.
         """
         appl_class = appliance_details["dev_class"]
         appl_d_loc = appliance_details["location"]
         if loc_id == appl_d_loc and appl_class in thermo_matching:
-            # Pre-elect new master
-            if thermo_matching[appl_class] > self._thermo_locs[loc_id]["master_prio"]:
-                # Demote former master
-                if (tl_master := self._thermo_locs[loc_id]["master"]) is not None:
-                    self._thermo_locs[loc_id]["slaves"].add(tl_master)
+            # Pre-elect new primary
+            if thermo_matching[appl_class] > self._thermo_locs[loc_id]["primary_prio"]:
+                # Demote former primary
+                if (tl_primary:= self._thermo_locs[loc_id]["primary"]) is not None:
+                    self._thermo_locs[loc_id]["secondary"].add(tl_primary)
 
-                # Crown master
-                self._thermo_locs[loc_id]["master_prio"] = thermo_matching[appl_class]
-                self._thermo_locs[loc_id]["master"] = appliance_id
+                # Crown primary
+                self._thermo_locs[loc_id]["primary_prio"] = thermo_matching[appl_class]
+                self._thermo_locs[loc_id]["primary"] = appliance_id
 
             else:
-                self._thermo_locs[loc_id]["slaves"].add(appliance_id)
+                self._thermo_locs[loc_id]["secondary"].add(appliance_id)
 
     def _control_state(self, loc_id: str) -> str | bool:
         """Helper-function for _device_data_adam().
 
         Adam: find the thermostat control_state of a location, from DOMAIN_OBJECTS.
-        Represents the heating/cooling demand-state of the local master thermostat.
+        Represents the heating/cooling demand-state of the local primary thermostat.
         Note: heating or cooling can still be active when the setpoint has been reached.
         """
         locator = f'location[@id="{loc_id}"]'

{plugwise-0.37.1 → plugwise-0.37.2}/plugwise/legacy/data.py

@@ -6,7 +6,7 @@ from __future__ import annotations
 
 # Dict as class
 # Version detection
-from plugwise.constants import NONE, ZONE_THERMOSTATS, DeviceData
+from plugwise.constants import NONE, DeviceData
 from plugwise.legacy.helper import SmileLegacyHelper
 from plugwise.util import remove_empty_platform_dicts
 
@@ -57,8 +57,8 @@ class SmileLegacyData(SmileLegacyHelper):
         # Switching groups data
         self._device_data_switching_group(device, data)
 
-        # Skip obtaining data for non master-thermostats
-        if device["dev_class"] not in ZONE_THERMOSTATS:
+        # Skip obtaining data when not a thermostat
+        if device["dev_class"] != "thermostat":
             return data
 
         # Thermostat data (presets, temperatures etc)

{plugwise-0.37.1 → plugwise-0.37.2}/plugwise.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: plugwise
-Version: 0.37.1
+Version: 0.37.2
 Summary: Plugwise Smile (Adam/Anna/P1) and Stretch module for Python 3.
 Home-page: https://github.com/plugwise/python-plugwise
 Author: Plugwise device owners
@@ -42,11 +42,8 @@ Requires-Python: >=3.11.0
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: aiohttp
-Requires-Dist: async_timeout
-Requires-Dist: crcmod
 Requires-Dist: defusedxml
 Requires-Dist: munch
-Requires-Dist: pyserial
 Requires-Dist: python-dateutil
 
 # Plugwise python module

{plugwise-0.37.1 → plugwise-0.37.2}/plugwise.egg-info/requires.txt

@@ -1,7 +1,4 @@
 aiohttp
-async_timeout
-crcmod
 defusedxml
 munch
-pyserial
 python-dateutil

{plugwise-0.37.1 → plugwise-0.37.2}/pyproject.toml

@@ -1,10 +1,10 @@
 [build-system]
-requires = ["setuptools~=69.0", "wheel~=0.42.0"]
+requires = ["setuptools~=69.0", "wheel~=0.43.0"]
 build-backend = "setuptools.build_meta"
 
 [project]
 name            = "plugwise"
-version         = "0.37.1"
+version         = "0.37.2"
 license         = {file = "LICENSE"}
 description     = "Plugwise Smile (Adam/Anna/P1) and Stretch module for Python 3."
 readme          = "README.md"
@@ -28,11 +28,8 @@ maintainers = [
 requires-python = ">=3.11.0"
 dependencies    = [
         "aiohttp",
-        "async_timeout",
-        "crcmod",
         "defusedxml",
         "munch",
-        "pyserial",
         "python-dateutil",
 ]
 

{plugwise-0.37.1 → plugwise-0.37.2}/tests/test_init.py

@@ -944,13 +944,12 @@ class TestPlugwise:  # pylint: disable=attribute-defined-outside-init
             log_msg = f" # Assert version matching '{smile_version}"
             parent_logger.info(log_msg)
             assert smile.smile_version == smile_version
-        if smile_version:
-            log_msg = f" # Assert legacy {smile_legacy}"
-            parent_logger.info(log_msg)
-            if smile_legacy:
-                assert smile.smile_legacy
-            else:
-                assert not smile.smile_legacy
+        log_msg = f" # Assert legacy {smile_legacy}"
+        parent_logger.info(log_msg)
+        if smile_legacy:
+            assert smile.smile_legacy
+        else:
+            assert not smile.smile_legacy
 
     class PlugwiseTestError(Exception):
         """Plugwise test exceptions class."""