799fbe42f8
* First round of not using values directly * Round two * lint * Round four * Conflict * Round five * Update zwave.py * round six * Docstring * flakywakie * Fetch values in constructor * Blank line removal * Set attributes in callback * Docstring * Round seven * Ughgit add homeassistant/components/lock/zwave.py! * Sloppy code
115 lines
3.5 KiB
Python
115 lines
3.5 KiB
Python
"""
|
|
Interfaces with Z-Wave sensors.
|
|
|
|
For more details about this platform, please refer to the documentation
|
|
at https://home-assistant.io/components/sensor.zwave/
|
|
"""
|
|
import logging
|
|
# Because we do not compile openzwave on CI
|
|
# pylint: disable=import-error
|
|
from homeassistant.components.sensor import DOMAIN
|
|
from homeassistant.components import zwave
|
|
from homeassistant.const import TEMP_CELSIUS, TEMP_FAHRENHEIT
|
|
|
|
_LOGGER = logging.getLogger(__name__)
|
|
|
|
|
|
def setup_platform(hass, config, add_devices, discovery_info=None):
|
|
"""Setup Z-Wave sensors."""
|
|
# Return on empty `discovery_info`. Given you configure HA with:
|
|
#
|
|
# sensor:
|
|
# platform: zwave
|
|
#
|
|
# `setup_platform` will be called without `discovery_info`.
|
|
if discovery_info is None or zwave.NETWORK is None:
|
|
return
|
|
|
|
node = zwave.NETWORK.nodes[discovery_info[zwave.const.ATTR_NODE_ID]]
|
|
value = node.values[discovery_info[zwave.const.ATTR_VALUE_ID]]
|
|
|
|
value.set_change_verified(False)
|
|
|
|
# if 1 in groups and (NETWORK.controller.node_id not in
|
|
# groups[1].associations):
|
|
# node.groups[1].add_association(NETWORK.controller.node_id)
|
|
|
|
# Generic Device mappings
|
|
if node.has_command_class(zwave.const.COMMAND_CLASS_SENSOR_MULTILEVEL):
|
|
add_devices([ZWaveMultilevelSensor(value)])
|
|
|
|
elif node.has_command_class(zwave.const.COMMAND_CLASS_METER) and \
|
|
value.type == zwave.const.TYPE_DECIMAL:
|
|
add_devices([ZWaveMultilevelSensor(value)])
|
|
|
|
elif node.has_command_class(zwave.const.COMMAND_CLASS_ALARM) or \
|
|
node.has_command_class(zwave.const.COMMAND_CLASS_SENSOR_ALARM):
|
|
add_devices([ZWaveAlarmSensor(value)])
|
|
|
|
|
|
class ZWaveSensor(zwave.ZWaveDeviceEntity):
|
|
"""Representation of a Z-Wave sensor."""
|
|
|
|
def __init__(self, value):
|
|
"""Initialize the sensor."""
|
|
zwave.ZWaveDeviceEntity.__init__(self, value, DOMAIN)
|
|
self.update_properties()
|
|
|
|
def update_properties(self):
|
|
"""Callback on data changes for node values."""
|
|
self._state = self._value.data
|
|
self._units = self._value.units
|
|
|
|
@property
|
|
def force_update(self):
|
|
"""Return force_update."""
|
|
return True
|
|
|
|
@property
|
|
def state(self):
|
|
"""Return the state of the sensor."""
|
|
return self._state
|
|
|
|
@property
|
|
def unit_of_measurement(self):
|
|
"""Return the unit of measurement the value is expressed in."""
|
|
return self._units
|
|
|
|
|
|
class ZWaveMultilevelSensor(ZWaveSensor):
|
|
"""Representation of a multi level sensor Z-Wave sensor."""
|
|
|
|
@property
|
|
def state(self):
|
|
"""Return the state of the sensor."""
|
|
if self._units in ('C', 'F'):
|
|
return round(self._state, 1)
|
|
elif isinstance(self._state, float):
|
|
return round(self._state, 2)
|
|
|
|
return self._state
|
|
|
|
@property
|
|
def unit_of_measurement(self):
|
|
"""Return the unit the value is expressed in."""
|
|
if self._units == 'C':
|
|
return TEMP_CELSIUS
|
|
elif self._units == 'F':
|
|
return TEMP_FAHRENHEIT
|
|
else:
|
|
return self._units
|
|
|
|
|
|
class ZWaveAlarmSensor(ZWaveSensor):
|
|
"""Representation of a Z-Wave sensor that sends Alarm alerts.
|
|
|
|
Examples include certain Multisensors that have motion and vibration
|
|
capabilities. Z-Wave defines various alarm types such as Smoke, Flood,
|
|
Burglar, CarbonMonoxide, etc.
|
|
|
|
This wraps these alarms and allows you to use them to trigger things, etc.
|
|
|
|
COMMAND_CLASS_ALARM is what we get here.
|
|
"""
|
|
|
|
pass
|