/Hue-sensors-HASS

Stable release is 0.8. Current is experimental

Primary LanguageJupyter Notebook

Code style: black

Hue-sensors-HASS

FOR COMMUNITY SUPPORT PLEASE USE THIS THREAD

The latest stable release is 0.8. Only use a later release if you are a developer or someone who wants to help out by testing the latest changes. I don't own all the hardware so rely on community assistance for testing

Place the custom_components folder in your configuration directory (or add its contents to an existing custom_components folder). You need to set up Hue bridge first.

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

binary_sensor:
  - platform: hue
device_tracker:
  - platform: hue
sensor:
  - platform: hue

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:
    - binary_sensor.bedroom_motion_sensor
    - binary_sensor.hall_motion_sensor
    - binary_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
    - device_tracker.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: '{{state_attr("binary_sensor.living_room_motion_sensor", "temperature")}}'
      unit_of_measurement: °C

    living_room_light_level:
      friendly_name: 'Living room light level'
      value_template: '{{state_attr("binary_sensor.living_room_motion_sensor", "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.