torque support

.coveragerc

@@ -101,6 +101,7 @@ omit =
     homeassistant/components/sensor/systemmonitor.py
     homeassistant/components/sensor/temper.py
     homeassistant/components/sensor/time_date.py
+    homeassistant/components/sensor/torque.py
     homeassistant/components/sensor/transmission.py
     homeassistant/components/sensor/twitch.py
     homeassistant/components/sensor/worldclock.py

homeassistant/components/sensor/torque.py

@@ -0,0 +1,118 @@
+"""
+homeassistant.components.sensor.torque
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Get data from the Torque OBD application.
+
+For more details about this platform, please refer to the documentation at
+https://home-assistant.io/components/sensor.torque/
+"""
+
+import re
+from homeassistant.helpers.entity import Entity
+
+
+DOMAIN = 'torque'
+DEPENDENCIES = ['http']
+SENSOR_EMAIL_FIELD = 'eml'
+DEFAULT_NAME = 'vehicle'
+HTTP_RESPONSE = 'OK'
+HTTP_VERB = 'GET'
+ENTITY_NAME_FORMAT = '{0} {1}'
+
+API_PATH = r'/api/torque'
+SENSOR_NAME_KEY = r'userFullName(\w+)'
+SENSOR_UNIT_KEY = r'userUnit(\w+)'
+SENSOR_VALUE_KEY = r'k(\w+)'
+
+PATH_MATCH = re.compile(API_PATH)
+NAME_KEY = re.compile(SENSOR_NAME_KEY)
+UNIT_KEY = re.compile(SENSOR_UNIT_KEY)
+VALUE_KEY = re.compile(SENSOR_VALUE_KEY)
+
+
+def decode(value):
+    """ Double-decode required. """
+    return value.encode('raw_unicode_escape').decode('utf-8')
+
+
+def convert_pid(value):
+    """ Convert pid from hex string to integer. """
+    return int(value, 16)
+
+
+# pylint: disable=unused-argument
+def setup_platform(hass, config, add_devices, discovery_info=None):
+    """ Set up Torque platform. """
+
+    vehicle = config.get('name', DEFAULT_NAME)
+    email = config.get('email', None)
+    sensors = {}
+
+    def _receive_data(handler, path_match, data):
+        """ Received data from Torque. """
+        handler.write_json_message(HTTP_RESPONSE)
+
+        if email is not None and email != data[SENSOR_EMAIL_FIELD]:
+            return
+
+        names = {}
+        units = {}
+        for key in data:
+            is_name = NAME_KEY.match(key)
+            is_unit = UNIT_KEY.match(key)
+            is_value = VALUE_KEY.match(key)
+
+            if is_name:
+                pid = convert_pid(is_name.group(1))
+                names[pid] = decode(data[key])
+            elif is_unit:
+                pid = convert_pid(is_unit.group(1))
+                units[pid] = decode(data[key])
+            elif is_value:
+                pid = convert_pid(is_value.group(1))
+                if pid in sensors:
+                    sensors[pid].on_update(data[key])
+
+        for pid in names:
+            if pid not in sensors:
+                sensors[pid] = TorqueSensor(
+                    ENTITY_NAME_FORMAT.format(vehicle, names[pid]),
+                    units.get(pid, None))
+                add_devices([sensors[pid]])
+
+    hass.http.register_path(HTTP_VERB, PATH_MATCH, _receive_data)
+    return True
+
+
+class TorqueSensor(Entity):
+    """ Represents a Torque sensor. """
+
+    def __init__(self, name, unit):
+        self._name = name
+        self._unit = unit
+        self._state = None
+
+    @property
+    def name(self):
+        """ Returns the name of the sensor. """
+        return self._name
+
+    @property
+    def unit_of_measurement(self):
+        """ Returns the unit of measurement. """
+        return self._unit
+
+    @property
+    def state(self):
+        """ State of the sensor. """
+        return self._state
+
+    @property
+    def icon(self):
+        """ Sensor default icon. """
+        return 'mdi:car'
+
+    def on_update(self, value):
+        """ Receive an update. """
+        self._state = value
+        self.update_ha_state()