https://github.com/hardillb/tradfri2mqtt

MQTT Bridge for IKEA TRÅDFRI Light Gateway
https://github.com/hardillb/tradfri2mqtt

coap ikea mqtt

Last synced: about 2 months ago
JSON representation

MQTT Bridge for IKEA TRÅDFRI Light Gateway

• Host: GitHub
• URL: https://github.com/hardillb/tradfri2mqtt
• Owner: hardillb
• License: apache-2.0
• Created: 2017-04-08T09:05:32.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2020-10-12T22:00:53.000Z (about 4 years ago)
• Last Synced: 2024-10-13T16:11:33.660Z (2 months ago)
• Topics: coap, ikea, mqtt
• Language: Java
• Homepage: https://www.hardill.me.uk/wordpress/2017/04/06/fist-pass-tradfri-mqtt-bridge/
• Size: 47.9 KB
• Stars: 81
• Watchers: 19
• Forks: 12
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Invocation

java -jar TRADFRI2MQTT-X.X.X-SNAPSHOT.jar -ip {gateway IP} -psk {gateway secret} -broker {MQTT broker URL} [-retained]

The optional `-retained` configures the MQTT topics as retained.

e.g.

`java -jar TRADFRI2MQTT-X.X.X-SNAPSHOT.jar -ip 192.168.1.XXX -psk xxxxxxxxxxxxxxxx -broker tcp://localhost`

Publishes state messages on topics like this:

 - TRÅDFRI/bulb/Living Room Light/state/on

 - TRÅDFRI/bulb/Living Room Light/state/dim

 - TRÅDFRI/bulb/Living Room Light/state/temperature

 - TRÅDFRI/room/Living Room/state/on

 - TRÅDFRI/room/Living Room/state/dim

Subscribes to control messages on topics like this:

 - TRÅDFRI/bulb/Living Room Light/control/on

 - TRÅDFRI/bulb/Living Room Light/control/dim

 - TRÅDFRI/bulb/Living Room Light/control/temperature

 - TRÅDFRI/room/Living Room/control/on

 - TRÅDFRI/room/Living Room/control/dim

 - TRÅDFRI/room/Living Room/control/mood

publish 0/1 to the `on` topic to turn the light off/on respectively

publish 0-254 to the `dim` topic to change the brightness

publish "cold" / "normal" / "warm" to the `temperature` topic to change temperatures.

This only works on individual bulbs.

publish the name of a mood (case-sensitive) to the `mood` topic of a room to adapt that mood.

IKEA predefined moods are internally uppercase-only for some reason: "EVERYDAY" / "FOCUS" / "RELAX".

Your self-defined moods have to be spelled like in the Trådfri App.

At the moment, only control is implemented and state is not.

# MQTT broker example

An easy-to-use MQTT broker is [mosquitto](https://mosquitto.org/).

After installation run it locally with `mosquitto`.

Then submit commands like this:

`mosquitto_pub -t "TRÅDFRI/bulb/LivingRoomBulb1/control/temperature" -m warm`

or subscribe like this:

`mosquitto_sub -t "TRÅDFRI/room/LivingRoom/state/on"`

# Installation on Docker

Optionally, TRADFRI2MQTT can be installed and run within a Docker image using the following instructions:

1. Clone this GIT repository.

2. Build the tradfri2mqtt docker image like so:

  `docker build -t tradfri2mqtt .`

3. Run tradfri2mqtt within a docker container:

  `docker run -rm tradfri2mqtt -ip [gateway ip] -psk [gateway secret] -broker [mqtt broker url]`