climate.py 8.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246
  1. """
  2. Goldair WiFi Heater device.
  3. """
  4. from homeassistant.components.climate import ClimateDevice
  5. from homeassistant.components.climate.const import (
  6. ATTR_HVAC_MODE,
  7. ATTR_PRESET_MODE,
  8. HVAC_MODE_HEAT,
  9. SUPPORT_PRESET_MODE,
  10. SUPPORT_SWING_MODE,
  11. SUPPORT_TARGET_TEMPERATURE,
  12. )
  13. from homeassistant.const import ATTR_TEMPERATURE, STATE_UNAVAILABLE
  14. from ..device import TuyaLocalDevice
  15. from .const import (
  16. ATTR_ECO_TARGET_TEMPERATURE,
  17. ATTR_ERROR,
  18. ATTR_POWER_LEVEL,
  19. ATTR_POWER_MODE,
  20. ATTR_POWER_MODE_AUTO,
  21. ATTR_POWER_MODE_USER,
  22. ATTR_TARGET_TEMPERATURE,
  23. HVAC_MODE_TO_DPS_MODE,
  24. POWER_LEVEL_TO_DPS_LEVEL,
  25. PRESET_MODE_TO_DPS_MODE,
  26. PROPERTY_TO_DPS_ID,
  27. STATE_ANTI_FREEZE,
  28. STATE_COMFORT,
  29. STATE_ECO,
  30. )
  31. SUPPORT_FLAGS = SUPPORT_TARGET_TEMPERATURE | SUPPORT_PRESET_MODE | SUPPORT_SWING_MODE
  32. class GoldairHeater(ClimateDevice):
  33. """Representation of a Goldair WiFi heater."""
  34. def __init__(self, device):
  35. """Initialize the heater.
  36. Args:
  37. name (str): The device's name.
  38. device (TuyaLocalDevice): The device API instance."""
  39. self._device = device
  40. self._support_flags = SUPPORT_FLAGS
  41. self._TEMPERATURE_STEP = 1
  42. self._TEMPERATURE_LIMITS = {
  43. STATE_COMFORT: {"min": 5, "max": 35},
  44. STATE_ECO: {"min": 5, "max": 21},
  45. }
  46. @property
  47. def supported_features(self):
  48. """Return the list of supported features."""
  49. return self._support_flags
  50. @property
  51. def should_poll(self):
  52. """Return the polling state."""
  53. return True
  54. @property
  55. def name(self):
  56. """Return the name of the climate device."""
  57. return self._device.name
  58. @property
  59. def unique_id(self):
  60. """Return the unique id for this heater."""
  61. return self._device.unique_id
  62. @property
  63. def device_info(self):
  64. """Return device information about this heater."""
  65. return self._device.device_info
  66. @property
  67. def icon(self):
  68. """Return the icon to use in the frontend for this device."""
  69. hvac_mode = self.hvac_mode
  70. power_level = self._device.get_property(PROPERTY_TO_DPS_ID[ATTR_POWER_LEVEL])
  71. if hvac_mode == HVAC_MODE_HEAT and power_level != "stop":
  72. return "mdi:radiator"
  73. else:
  74. return "mdi:radiator-disabled"
  75. @property
  76. def temperature_unit(self):
  77. """Return the unit of measurement."""
  78. return self._device.temperature_unit
  79. @property
  80. def target_temperature(self):
  81. """Return the temperature we try to reach."""
  82. if self.preset_mode == STATE_COMFORT:
  83. return self._device.get_property(
  84. PROPERTY_TO_DPS_ID[ATTR_TARGET_TEMPERATURE]
  85. )
  86. elif self.preset_mode == STATE_ECO:
  87. return self._device.get_property(
  88. PROPERTY_TO_DPS_ID[ATTR_ECO_TARGET_TEMPERATURE]
  89. )
  90. else:
  91. return None
  92. @property
  93. def target_temperature_step(self):
  94. """Return the supported step of target temperature."""
  95. return self._TEMPERATURE_STEP
  96. @property
  97. def min_temp(self):
  98. """Return the minimum temperature."""
  99. if self.preset_mode and self.preset_mode != STATE_ANTI_FREEZE:
  100. return self._TEMPERATURE_LIMITS[self.preset_mode]["min"]
  101. else:
  102. return None
  103. @property
  104. def max_temp(self):
  105. """Return the maximum temperature."""
  106. if self.preset_mode and self.preset_mode != STATE_ANTI_FREEZE:
  107. return self._TEMPERATURE_LIMITS[self.preset_mode]["max"]
  108. else:
  109. return None
  110. async def async_set_temperature(self, **kwargs):
  111. """Set new target temperatures."""
  112. if kwargs.get(ATTR_PRESET_MODE) is not None:
  113. await self.async_set_preset_mode(kwargs.get(ATTR_PRESET_MODE))
  114. if kwargs.get(ATTR_TEMPERATURE) is not None:
  115. await self.async_set_target_temperature(kwargs.get(ATTR_TEMPERATURE))
  116. async def async_set_target_temperature(self, target_temperature):
  117. target_temperature = int(round(target_temperature))
  118. preset_mode = self.preset_mode
  119. if preset_mode == STATE_ANTI_FREEZE:
  120. raise ValueError("You cannot set the temperature in Anti-freeze mode.")
  121. limits = self._TEMPERATURE_LIMITS[preset_mode]
  122. if not limits["min"] <= target_temperature <= limits["max"]:
  123. raise ValueError(
  124. f"Target temperature ({target_temperature}) must be between "
  125. f'{limits["min"]} and {limits["max"]}'
  126. )
  127. if preset_mode == STATE_COMFORT:
  128. await self._device.async_set_property(
  129. PROPERTY_TO_DPS_ID[ATTR_TARGET_TEMPERATURE], target_temperature
  130. )
  131. elif preset_mode == STATE_ECO:
  132. await self._device.async_set_property(
  133. PROPERTY_TO_DPS_ID[ATTR_ECO_TARGET_TEMPERATURE], target_temperature
  134. )
  135. @property
  136. def current_temperature(self):
  137. """Return the current temperature."""
  138. return self._device.get_property(PROPERTY_TO_DPS_ID[ATTR_TEMPERATURE])
  139. @property
  140. def hvac_mode(self):
  141. """Return current HVAC mode, ie Heat or Off."""
  142. dps_mode = self._device.get_property(PROPERTY_TO_DPS_ID[ATTR_HVAC_MODE])
  143. if dps_mode is not None:
  144. return TuyaLocalDevice.get_key_for_value(HVAC_MODE_TO_DPS_MODE, dps_mode)
  145. else:
  146. return STATE_UNAVAILABLE
  147. @property
  148. def hvac_modes(self):
  149. """Return the list of available HVAC modes."""
  150. return list(HVAC_MODE_TO_DPS_MODE.keys())
  151. async def async_set_hvac_mode(self, hvac_mode):
  152. """Set new HVAC mode."""
  153. dps_mode = HVAC_MODE_TO_DPS_MODE[hvac_mode]
  154. await self._device.async_set_property(
  155. PROPERTY_TO_DPS_ID[ATTR_HVAC_MODE], dps_mode
  156. )
  157. @property
  158. def preset_mode(self):
  159. """Return current preset mode, ie Comfort, Eco, Anti-freeze."""
  160. dps_mode = self._device.get_property(PROPERTY_TO_DPS_ID[ATTR_PRESET_MODE])
  161. if dps_mode is not None:
  162. return TuyaLocalDevice.get_key_for_value(
  163. PRESET_MODE_TO_DPS_MODE, dps_mode
  164. )
  165. else:
  166. return None
  167. @property
  168. def preset_modes(self):
  169. """Return the list of available preset modes."""
  170. return list(PRESET_MODE_TO_DPS_MODE.keys())
  171. async def async_set_preset_mode(self, preset_mode):
  172. """Set new preset mode."""
  173. dps_mode = PRESET_MODE_TO_DPS_MODE[preset_mode]
  174. await self._device.async_set_property(
  175. PROPERTY_TO_DPS_ID[ATTR_PRESET_MODE], dps_mode
  176. )
  177. @property
  178. def swing_mode(self):
  179. """Return the power level."""
  180. dps_mode = self._device.get_property(PROPERTY_TO_DPS_ID[ATTR_POWER_MODE])
  181. if dps_mode == None:
  182. return None
  183. if dps_mode == ATTR_POWER_MODE_USER:
  184. dps_mode = self._device.get_property(PROPERTY_TO_DPS_ID[ATTR_POWER_LEVEL])
  185. return TuyaLocalDevice.get_key_for_value(POWER_LEVEL_TO_DPS_LEVEL, dps_mode)
  186. @property
  187. def swing_modes(self):
  188. """List of power levels."""
  189. return list(POWER_LEVEL_TO_DPS_LEVEL.keys())
  190. async def async_set_swing_mode(self, swing_mode):
  191. """Set new power level."""
  192. new_level = swing_mode
  193. if new_level not in POWER_LEVEL_TO_DPS_LEVEL.keys():
  194. raise ValueError(f"Invalid power level: {new_level}")
  195. dps_level = POWER_LEVEL_TO_DPS_LEVEL[new_level]
  196. await self._device.async_set_property(
  197. PROPERTY_TO_DPS_ID[ATTR_POWER_LEVEL], dps_level
  198. )
  199. @property
  200. def device_state_attributes(self):
  201. """Get additional attributes that HA doesn't naturally support."""
  202. error_code = self._device.get_property(PROPERTY_TO_DPS_ID[ATTR_ERROR])
  203. if error_code:
  204. error = f"Error {error_code}"
  205. else:
  206. error = "OK"
  207. return {ATTR_ERROR: error, ATTR_ERROR_CODE: error}
  208. async def async_update(self):
  209. await self._device.async_refresh()