PyViCare 2.55.0__tar.gz → 2.56.0__tar.gz

{pyvicare-2.55.0 → pyvicare-2.56.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyViCare
-Version: 2.55.0
+Version: 2.56.0
 Summary: Library to communicate with the Viessmann ViCare API.
 License: Apache-2.0
 License-File: LICENSE

{pyvicare-2.55.0 → pyvicare-2.56.0}/PyViCare/PyViCareFuelCell.py

@@ -192,9 +192,9 @@ class FuelCell(HeatingDevice):
         return self.getProperty("heating.fuelCell.power.production")["properties"]["year"]["value"][0]
 
     @handleNotSupported
-    def getFuelCellOperatingPhase(self):
+    def getFuelCellOperatingPhase(self) -> str:
         # Returns current operating phase as string, e.g. "standby" or "generation"
-        return self.getProperty("heating.fuelCell.operating.phase")["properties"]["value"]["value"]
+        return str(self.getProperty("fuelCell.operating.phase")["properties"]["value"]["value"])
 
     @handleNotSupported
     def getFuelCellPowerProductionCurrentUnit(self):
@@ -257,39 +257,39 @@ class FuelCell(HeatingDevice):
         return self.getProperty("heating.power.sold.cumulative")["properties"]["value"]["value"]
 
     @handleNotSupported
-    def getFuelCellFlowReturnTemperatureUnit(self):
+    def getFuelCellFlowReturnTemperatureUnit(self) -> str:
         # Returns flow return temperature unit, e.g. "celsius"
-        return self.getProperty("heating.fuelCell.sensors.temperature.return")["properties"]["value"]["unit"]
+        return str(self.getProperty("fuelCell.sensors.temperature.return")["properties"]["value"]["unit"])
 
     @handleNotSupported
-    def getFuelCellFlowReturnTemperature(self):
+    def getFuelCellFlowReturnTemperature(self) -> float:
         # Returns flow return temperature at the fuel cell as float
-        return self.getProperty("heating.fuelCell.sensors.temperature.return")["properties"]["value"]["value"]
+        return float(self.getProperty("fuelCell.sensors.temperature.return")["properties"]["value"]["value"])
 
     @handleNotSupported
-    def getFuelCellFlowSupplyTemperatureUnit(self):
+    def getFuelCellFlowSupplyTemperatureUnit(self) -> str:
         # Returns flow supply temperature unit, e.g. "celsius"
-        return self.getProperty("heating.fuelCell.sensors.temperature.supply")["properties"]["value"]["unit"]
+        return str(self.getProperty("fuelCell.sensors.temperature.supply")["properties"]["value"]["unit"])
 
     @handleNotSupported
-    def getFuelCellFlowSupplyTemperature(self):
+    def getFuelCellFlowSupplyTemperature(self) -> float:
         # Returns flow supply temperature at the fuel cell as float
-        return self.getProperty("heating.fuelCell.sensors.temperature.supply")["properties"]["value"]["value"]
+        return float(self.getProperty("fuelCell.sensors.temperature.supply")["properties"]["value"]["value"])
 
     @handleNotSupported
-    def getFuelCellOperationHours(self):
+    def getFuelCellOperationHours(self) -> int:
         # Returns the operation hours of the fuel cell
-        return self.getProperty("heating.fuelCell.statistics")["properties"]["operationHours"]["value"]
+        return int(self.getProperty("fuelCell.statistics")["properties"]["operationHours"]["value"])
 
     @handleNotSupported
-    def getFuelCellProductionHours(self):
+    def getFuelCellProductionHours(self) -> int:
         # Returns the production hours of the fuel cell
-        return self.getProperty("heating.fuelCell.statistics")["properties"]["productionHours"]["value"]
+        return int(self.getProperty("fuelCell.statistics")["properties"]["productionHours"]["value"])
 
     @handleNotSupported
-    def getFuelCellProductionStarts(self):
+    def getFuelCellProductionStarts(self) -> int:
         # Returns the number of production starts of the fuel cell
-        return self.getProperty("heating.fuelCell.statistics")["properties"]["productionStarts"]["value"]
+        return int(self.getProperty("fuelCell.statistics")["properties"]["productionStarts"]["value"])
 
     @handleNotSupported
     def getFuelCellGasConsumptionUnit(self):

{pyvicare-2.55.0 → pyvicare-2.56.0}/PyViCare/PyViCareGateway.py

@@ -9,5 +9,5 @@ class Gateway(Device):
         return self.getProperty("gateway.devices")["gatewayId"]
 
     @handleNotSupported
-    def getWifiSignalStrength(self):
-        return self.getProperty("gateway.wifi")["properties"]["strength"]["value"]
+    def getWifiSignalStrength(self) -> int:
+        return int(self.getProperty("gateway.wifi")["properties"]["strength"]["value"])

{pyvicare-2.55.0 → pyvicare-2.56.0}/PyViCare/PyViCareHeatPump.py

@@ -34,6 +34,13 @@ class HeatPump(HeatingDevice, VentilationDevice):
     def getEvaporator(self, evaporator) -> Evaporator:
         return Evaporator(self, evaporator)
 
+    @property
+    def inverters(self) -> List[Inverter]:
+        return [self.getInverter(x) for x in self.getAvailableCompressors()]
+
+    def getInverter(self, inverter) -> Inverter:
+        return Inverter(self, inverter)
+
     @handleNotSupported
     def getBufferMainTemperature(self):
         return self.getProperty("heating.bufferCylinder.sensors.temperature.main")["properties"]['value']['value']
@@ -356,6 +363,10 @@ class Compressor(HeatingDeviceWithComponent):
     def getPhase(self):
         return self.getProperty(f"heating.compressors.{self.compressor}")["properties"]["phase"]["value"]
 
+    @handleNotSupported
+    def getSpeed(self) -> int:
+        return int(self.getProperty(f"heating.compressors.{self.compressor}.speed.current")["properties"]["value"]["value"])
+
     @handleNotSupported
     def getHeatProductionCurrent(self) -> float:
         return float(self.getProperty(f"heating.compressors.{self.compressor}.heat.production.current")["properties"]["value"]["value"])
@@ -392,46 +403,111 @@ class Compressor(HeatingDeviceWithComponent):
     def getPowerConsumptionTotalUnit(self) -> str:
         return str(self.getProperty(f"heating.compressors.{self.compressor}.power.consumption.total")["properties"]["year"]["unit"])
 
+    #TODO: remove deprecated method in 03.2026 release
     @handleNotSupported
+    @deprecated(reason="renamed, use getOutletPressureUnit", version="2.55.1")
     def getCompressorOutletPressureUnit(self) -> str:
+        return str(self.getOutletPressureUnit())
+
+    @handleNotSupported
+    def getOutletPressureUnit(self) -> str:
         # Shows the unit of measurement of the outlet pressure.
         return str(self.getProperty(f"heating.compressors.{self.compressor}.sensors.pressure.outlet")["properties"]["value"]["unit"])
 
+    #TODO: remove deprecated method in 03.2026 release
     @handleNotSupported
+    @deprecated(reason="renamed, use getOutletPressure", version="2.55.1")
     def getCompressorOutletPressure(self) -> float:
+        return float(self.getOutletPressure())
+
+    @handleNotSupported
+    def getOutletPressure(self) -> float:
         # Shows the outlet pressure of the compressor.
         return float(self.getProperty(f"heating.compressors.{self.compressor}.sensors.pressure.outlet")["properties"]["value"]["value"])
 
+    #TODO: remove deprecated method in 03.2026 release
     @handleNotSupported
+    @deprecated(reason="renamed, use getInletPressureUnit", version="2.55.1")
     def getCompressorInletPressureUnit(self) -> str:
+        return str(self.getInletPressureUnit())
+
+    @handleNotSupported
+    def getInletPressureUnit(self) -> str:
         # Shows the unit of measurement of the inlet pressure.
         return str(self.getProperty(f"heating.compressors.{self.compressor}.sensors.pressure.inlet")["properties"]["value"]["unit"])
 
+    #TODO: remove deprecated method in 03.2026 release
     @handleNotSupported
+    @deprecated(reason="renamed, use getInletPressure", version="2.55.1")
     def getCompressorInletPressure(self) -> float:
+        return float(self.getInletPressure())
+
+    @handleNotSupported
+    def getInletPressure(self) -> float:
         # Shows the inlet pressure of the compressor.
         return float(self.getProperty(f"heating.compressors.{self.compressor}.sensors.pressure.inlet")["properties"]["value"]["value"])
 
+    #TODO: remove deprecated method in 03.2026 release
     @handleNotSupported
+    @deprecated(reason="renamed, use getOutletTemperatureUnit", version="2.55.1")
     def getCompressorOutletTemperatureUnit(self) -> str:
+        return str(self.getOutletTemperatureUnit())
+
+    @handleNotSupported
+    def getOutletTemperatureUnit(self) -> str:
         # Shows the unit of measurement of the outlet temperature.
         return str(self.getProperty(f"heating.compressors.{self.compressor}.sensors.temperature.outlet")["properties"]["value"]["unit"])
 
+    #TODO: remove deprecated method in 03.2026 release
     @handleNotSupported
+    @deprecated(reason="renamed, use getOutletTemperature", version="2.55.1")
     def getCompressorOutletTemperature(self) -> float:
+        return float(self.getOutletTemperature())
+
+    @handleNotSupported
+    def getOutletTemperature(self) -> float:
         # Shows the outlet temperature of the compressor.
         return float(self.getProperty(f"heating.compressors.{self.compressor}.sensors.temperature.outlet")["properties"]["value"]["value"])
 
+    #TODO: remove deprecated method in 03.2026 release
     @handleNotSupported
+    @deprecated(reason="renamed, use getInletTemperatureUnit", version="2.55.1")
     def getCompressorInletTemperatureUnit(self) -> str:
+        return str(self.getInletTemperatureUnit())
+
+    @handleNotSupported
+    def getInletTemperatureUnit(self) -> str:
         # Shows the unit of measurement of the inlet temperature.
         return str(self.getProperty(f"heating.compressors.{self.compressor}.sensors.temperature.inlet")["properties"]["value"]["unit"])
 
+    #TODO: remove deprecated method in 03.2026 release
     @handleNotSupported
+    @deprecated(reason="renamed, use getInletTemperature", version="2.55.1")
     def getCompressorInletTemperature(self) -> float:
+        return float(self.getInletTemperature())
+
+    @handleNotSupported
+    def getInletTemperature(self) -> float:
         # Shows the inlet temperature of the compressor.
         return float(self.getProperty(f"heating.compressors.{self.compressor}.sensors.temperature.inlet")["properties"]["value"]["value"])
 
+    @handleNotSupported
+    def getOilTemperature(self) -> float:
+        # Shows the oil temperature of the compressor.
+        return float(self.getProperty(f"heating.compressors.{self.compressor}.sensors.temperature.oil")["properties"]["value"]["value"])
+
+    def getMotorChamberTemperature(self) -> float:
+        # Shows the motor chamber temperature of the compressor.
+        return float(self.getProperty(f"heating.compressors.{self.compressor}.sensors.temperature.motorChamber")["properties"]["value"]["value"])
+
+    def getAmbientTemperature(self) -> float:
+        # Shows the ambient temperature of the compressor.
+        return float(self.getProperty(f"heating.compressors.{self.compressor}.sensors.temperature.ambient")["properties"]["value"]["value"])
+
+    def getOverheatTemperature(self) -> float:
+        # Shows the overheat temperature of the compressor.
+        return float(self.getProperty(f"heating.compressors.{self.compressor}.sensors.temperature.overheat")["properties"]["value"]["value"])
+
 
 class Evaporator(HeatingDeviceWithComponent):
 
@@ -439,23 +515,47 @@ class Evaporator(HeatingDeviceWithComponent):
     def evaporator(self) -> str:
         return self.component
 
+    #TODO: remove deprecated method in 03.2026 release
     @handleNotSupported
+    @deprecated(reason="renamed, use getLiquidTemperatureUnit", version="2.55.1")
     def getEvaporatorLiquidTemperatureUnit(self) -> str:
+        return str(self.getLiquidTemperatureUnit())
+
+    @handleNotSupported
+    def getLiquidTemperatureUnit(self) -> str:
         # Shows the unit of measurement of the liquid temperature of the evaporator.
         return str(self.getProperty(f"heating.evaporators.{self.evaporator}.sensors.temperature.liquid")["properties"]["value"]["unit"])
 
+    #TODO: remove deprecated method in 03.2026 release
     @handleNotSupported
+    @deprecated(reason="renamed, use getLiquidTemperature", version="2.55.1")
     def getEvaporatorLiquidTemperature(self) -> float:
+        return float(self.getLiquidTemperature())
+
+    @handleNotSupported
+    def getLiquidTemperature(self) -> float:
         # Shows the liquid temperature of the evaporator.
         return float(self.getProperty(f"heating.evaporators.{self.evaporator}.sensors.temperature.liquid")["properties"]["value"]["value"])
 
+    #TODO: remove deprecated method in 03.2026 release
     @handleNotSupported
+    @deprecated(reason="renamed, use getOverheatTemperatureUnit", version="2.55.1")
     def getEvaporatorOverheatTemperatureUnit(self) -> str:
+        return str(self.getOverheatTemperatureUnit())
+
+    @handleNotSupported
+    def getOverheatTemperatureUnit(self) -> str:
         # Shows the unit of measurement of the overheat temperature of the evaporator.
         return str(self.getProperty(f"heating.evaporators.{self.evaporator}.sensors.temperature.overheat")["properties"]["value"]["unit"])
 
+    #TODO: remove deprecated method in 03.2026 release
     @handleNotSupported
+    @deprecated(reason="renamed, use getOverheatTemperature", version="2.55.1")
     def getEvaporatorOverheatTemperature(self) -> float:
+        return float(self.getOverheatTemperature())
+
+    @handleNotSupported
+    def getOverheatTemperature(self) -> float:
         # Shows the overheat temperature of the evaporator.
         return float(self.getProperty(f"heating.evaporators.{self.evaporator}.sensors.temperature.overheat")["properties"]["value"]["value"])
 
@@ -466,22 +566,65 @@ class Condensor(HeatingDeviceWithComponent):
     def condensor(self) -> str:
         return self.component
 
+    #TODO: remove deprecated method in 03.2026 release
     @handleNotSupported
+    @deprecated(reason="renamed, use getSubcoolingTemperatureUnit", version="2.55.1")
     def getCondensorSubcoolingTemperatureUnit(self) -> str:
-        # Shows the unit of measurement of the subcooling temperature of the condensor.
+        return str(self.getSubcoolingTemperatureUnit())
+
+    @handleNotSupported
+    def getSubcoolingTemperatureUnit(self) -> str:
+        # Shows the unit of measurement of the subcooling temperature of the condenser.
         return str(self.getProperty(f"heating.condensors.{self.condensor}.sensors.temperature.subcooling")["properties"]["value"]["unit"])
 
+    #TODO: remove deprecated method in 03.2026 release
     @handleNotSupported
+    @deprecated(reason="renamed, use getSubcoolingTemperature", version="2.55.1")
     def getCondensorSubcoolingTemperature(self) -> float:
-        # Shows the subcooling temperature of the condensor.
+        return float(self.getSubcoolingTemperature())
+
+    @handleNotSupported
+    def getSubcoolingTemperature(self) -> float:
+        # Shows the subcooling temperature of the condenser.
         return float(self.getProperty(f"heating.condensors.{self.condensor}.sensors.temperature.subcooling")["properties"]["value"]["value"])
 
+    #TODO: remove deprecated method in 03.2026 release
     @handleNotSupported
+    @deprecated(reason="renamed, use getLiquidTemperatureUnit", version="2.55.1")
     def getCondensorLiquidTemperatureUnit(self) -> str:
-        # Shows the unit of measurement of the liquid temperature of the condensor.
+        return str(self.getLiquidTemperatureUnit())
+
+    @handleNotSupported
+    def getLiquidTemperatureUnit(self) -> str:
+        # Shows the unit of measurement of the liquid temperature of the condenser.
         return str(self.getProperty(f"heating.condensors.{self.condensor}.sensors.temperature.liquid")["properties"]["value"]["unit"])
 
+    #TODO: remove deprecated method in 03.2026 release
     @handleNotSupported
+    @deprecated(reason="renamed, use getLiquidTemperature", version="2.55.1")
     def getCondensorLiquidTemperature(self) -> float:
-        # Shows the liquid temperature of the condensor.
+        return float(self.getLiquidTemperature())
+
+    @handleNotSupported
+    def getLiquidTemperature(self) -> float:
+        # Shows the liquid temperature of the condenser.
         return float(self.getProperty(f"heating.condensors.{self.condensor}.sensors.temperature.liquid")["properties"]["value"]["value"])
+
+
+class Inverter(HeatingDeviceWithComponent):
+
+    @property
+    def inverter(self) -> str:
+        return self.component
+
+    @handleNotSupported
+    def getCurrent(self) -> float:
+        return float(self.getProperty(f"heating.inverters.{self.inverter}.sensors.power.current")["properties"]["value"]["value"])
+
+    @handleNotSupported
+    def getPower(self) -> float:
+        return float(self.getProperty(f"heating.inverters.{self.inverter}.sensors.power.output")["properties"]["value"]["value"])
+
+    @handleNotSupported
+    def getTemperature(self) -> float:
+        return float(self.getProperty(f"heating.inverters.{self.inverter}.sensors.temperature.powerModule")["properties"]["value"]["value"])

{pyvicare-2.55.0 → pyvicare-2.56.0}/PyViCare/PyViCareHeatingDevice.py

@@ -36,6 +36,10 @@ class HeatingDevice(Device):
     Note that currently, a new token is generated for each run.
     """
 
+    @handleNotSupported
+    def getWifiSignalStrength(self) -> int:
+        return int(self.getProperty("tcu.wifi")["properties"]["strength"]["value"])
+
     @property
     def circuits(self) -> List[Any]:
         return list([self.getCircuit(x) for x in self.getAvailableCircuits()])

{pyvicare-2.55.0 → pyvicare-2.56.0}/PyViCare/PyViCareVentilationDevice.py

@@ -12,6 +12,10 @@ class VentilationDevice(Device):
     Note that currently, a new token is generated for each run.
     """
 
+    @handleNotSupported
+    def getWifiSignalStrength(self) -> int:
+        return int(self.getProperty("tcu.wifi")["properties"]["strength"]["value"])
+
     @handleNotSupported
     def getVentilationDemand(self) -> str:
         return str(self.getProperty("ventilation.operating.state")["properties"]["demand"]["value"])

{pyvicare-2.55.0 → pyvicare-2.56.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "PyViCare"
-version = "2.55.0"
+version = "2.56.0"
 description = "Library to communicate with the Viessmann ViCare API."
 authors = [
   "Simon Gillet <mail+pyvicare@gillet.ninja>"