Custom component for Hue sensors in Home-Assistant, tested up to HA 0.81
Clone or download
Latest commit 779a1e3 Nov 16, 2018

README.md

build status Coverage Status

Hue-sensors-HASS

FOR COMMUNITY SUPPORT PLEASE USE THIS THREAD

Component for Hue sensors in Home-Assistant, updated for 0.66 to be independent of the Hue hub platform.

Place the custom_components folder in your configuration directory (or add its contents to an existing custom_components folder). You need to configure your Hue bridge IP and developer key, see this link for instructions.

Hue dimmer remotes can be used for a click and long press (hold button for 2 sec and see LED blink twice).

sensor:
  - platform: hue
    ip_address: 192.168.1.1
    token: QKNg2pcBVOalc4ecJX4iVhLSQ2g08ghafs086XpG

As per this issue it is recommended to use the default naming options in the Hue app in order to ensure sensible sensor names in HA.

Front end display

To add the following group to your HA frontend, add the following to groups.yaml (obviously editing to use your sensors):

default_view:
  view: yes
  entities:
    - group.Hue

Hue:
  entities:
    - sensor.bedroom_motion_sensor
    - sensor.hall_motion_sensor
    - sensor.living_room_motion_sensor
    - sensor.living_room_temperature
    - sensor.living_room_light_level
    - sensor.living_room_lux
    - sensor.living_room_remote
    - sensor.remote_bedroom
    - sensor.robins_iphone

Temperature, light level and other data in the sensor attributes can be broken out into their own sensor using a template sensor, for example:

- platform: template
  sensors:

    living_room_temperature:
      friendly_name: 'Living room temperature'
      value_template: '{{states.sensor.living_room_motion_sensor.attributes.temperature}}'
      unit_of_measurement: °C

    living_room_light_level:
      friendly_name: 'Living room light level'
      value_template: '{{states.sensor.living_room_motion_sensor.attributes.lx}}'
      unit_of_measurement: lux

Track Updates

This custom component can be tracked with the help of custom-lovelace.

In your configuration.yaml

custom_updater:
component_urls:
  - https://raw.githubusercontent.com/robmarkcole/Hue-sensors-HASS/master/custom_updater.json

Debugging

If you get an error when using this component, the procedure for debugging is as follows.

  1. Open an issue here on Github. Include the error message, release number of the custom component.
  2. Download the Hue API response following the instructions here. Save into a .json file.
  3. Parse the json file using the hue_sensors package and report the device ID (e.g. RWL_06-02) that is causing your issue.

There are a couple of examples of this process in the debugging_issues folder.