Skip to content

Latest commit

 

History

History
124 lines (90 loc) · 2.58 KB

README.md

File metadata and controls

124 lines (90 loc) · 2.58 KB
Raw

Philips Hue Sensor MQTT Bridge

This should be compatible with multiple Hue bridges, but it has only been tested with one. Also, this has only been tested with Hue Dimmer.

I have noticed the best performance when running the polling interval at 500ms.

If you have any issues, please post them on GitHub.

Configuration

{
  "broker": {
    "host": "localhost",
    "username": "XXXXXXXX",
    "password": "XXXXXXXX"
  },
  "bridges": [
    {
      "host": "XXX.XXX.XXX.XXX",
      "username": "XXXXXXXX",
      "interval": 1000,
      "prefix": "hue"
    }
  ]
}

Installation

A huge thank you goes out to @LaurensBot for writing this guide.

The instructions are based on the Raspberry Pi and assume that you already have the following installed:

  • Node.js
  • Home Assistant
  • git
  • mosquitto MQTT broker
  1. Create a parent folder for hue-mqtt-bridge:
mkdir /home/pi/node
cd /home/pi/node
  1. Clone the git repository:
git clone git://github.com/dale3h/hue-mqtt-bridge.git
cd hue-mqtt-bridge
  1. Install dependencies (do not run as root):
npm install
  1. Create the config file and edit it to your liking:
cp config.sample.json config.json
nano config.json

You can find the username in the Home Assistant directory in a file named phue.conf. It is the long string of random characters.

  1. Make hue-mqtt-bridge start at boot:
sudo npm install -g pm2
pm2 startup systemd

This will give you a command that includes sudo -- run that command.

  1. Time to run hue-mqtt-bridge:
./bin/hue-mqtt-bridge

If no errors are shown, all should be working.

  1. If no errors are shown stop (Ctrl+C) the process and run:
pm2 start index.js --name hue-mqtt-bridge
pm2 save
  1. The topics in MQTT start with hue by default, so to see the output run:
mosquitto_sub -h localhost -p 1883 -u YOUR_MQTT_USERNAME -P YOUR_MQTT_PASSWORD -v -t '#'

Click a button on your Hue Dimmer or Hue Tap, or trigger your Hue Motion.

  1. Add it to Home Assistant

Running the above command showed the following output when pressing a button:

hue/hue_tap_tap1/buttonevent 34

The topic will be different so adjust the trigger below with your topic:

automation:
  - alias: hue_tap_button_1
    trigger:
      - platform: mqtt
        topic: hue/hue_tap_tap1/buttonevent
        payload: '34'
    action:
      - service: homeassistant.turn_on
        entity_id: script.todosomething