home-assistant.github.io/source/_components/tradfri.markdown
Joeboyc2 e5f245e009 Added some clarifying information (#2481)
* Added some clarifying information

Added additional details about automatic discovery of the gateway on the network and how to configure it, found that many user have had to restart the gateway to get the configurator working, so also added a note about that

* Small changes
2017-04-23 14:12:53 +02:00

1.5 KiB

layout title description date sidebar featured comments sharing footer logo ha_category ha_iot_class ha_release
page IKEA Trådfri (Tradfri) Access and control your ZigBee-based IKEA Trådfri (Tradfri) devices. 2017-04-12 22.04 true true false true true ikea.svg Hub Local Polling 0.43

The tradfri component supports for the IKEA Trådfri (Tradfri) gateway. The gateway can control lights connected to it and Home Assistant will automatically discover its presence on your network.

For this to work, you need to install a modified lib-coap library:

$ sudo apt-get install libtool
$ sudo apt-get install autoconf

$ git clone --depth 1 --recursive -b dtls https://github.com/home-assistant/libcoap.git
$ cd libcoap
$ ./autogen.sh
$ ./configure --disable-documentation --disable-shared --without-debug CFLAGS="-D COAP_DEBUG_FD=stderr"
$ make
$ sudo make install

You will be prompted to configure the gateway through the Home Assistant interface, Enter the security key when prompted and click configure

If you see an "Unable to connect" message, restart the gateway and try again.

The gateway can also be manually configured by adding the following lines to your configuration.yaml file:

# Example configuration.yaml entry
tradfri:
  host: IP_ADDRESS
  api_key: API_KEY

Configuration variables:

  • host (Required): The IP address or hostname of your Trådfri gateway.
  • api_key (Required): Can be found listed as Security Key on the back of the Trådfri gateway.