v/wideq
1
0
Fork 0
mirror of https://github.com/no2chem/wideq.git synced 2025-06-01 06:50:15 -07:00
Code Issues Projects Releases Wiki Activity

Improve docstrings

Browse Source
This commit is contained in:
Adrian Sampson 2018-06-17 10:41:14 -04:00
parent 4cde35597a
commit 708da5c9ef
1 changed files with 14 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

24
wideq.py
View File

@ -821,12 +821,14 @@ class ACDevice(Device):
self.set_celsius(self.f2c[f]) self.set_celsius(self.f2c[f])
def set_zones(self, zones): def set_zones(self, zones):
"""Set the device's zones to on/off. """Turn off or on the device's zones.
zones arg is a list of the format below
zone_no is a number indexed from 1 typed as string The `zones` parameter is a list of dicts with these keys:
enabled is a 1/0 typed as string - "No": The zone index. A string containing a number,
isOpen is a 1/0 typed as string starting from 1.
[{'No':zone_no, 'Cfg':enabled, 'State':isOpen},] - "Cfg": Whether the zone is enabled. A string, either "1" or
"0".
- "State": Whether the zone is open. Also "1" or "0".
""" """
# Ensure at least one zone is enabled: we can't turn all zones # Ensure at least one zone is enabled: we can't turn all zones
@ -840,15 +842,17 @@ class ACDevice(Device):
self._set_control('DuctZone', zone_cmd) self._set_control('DuctZone', zone_cmd)
def get_zones(self): def get_zones(self):
"""Gets the status of the zones, including whether a zone is configured. """Get the status of the zones, including whether a zone is
Result is a list of dicts with the same format as set_zones() configured.
The result is a list of dicts with the same format as described in
`set_zones`.
""" """
return self._get_config('DuctZone') return self._get_config('DuctZone')
def set_fan_speed(self, speed): def set_fan_speed(self, speed):
"""Sets the fan speed according to the WindStrength operation """Set the fan speed to a value from the `ACFanSpeed` enum.
Speed arg is a value of the ACFanSpeed enum
""" """
speed_value = self.model.enum_value('WindStrength', speed.value) speed_value = self.model.enum_value('WindStrength', speed.value)