home-assistant.io/source/_components/tradfri.markdown

layout, title, description, date, sidebar, featured, comments, sharing, footer, logo, ha_category, ha_iot_class, ha_release

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.

Linux:

$ 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

macOS:

$ sudo brew install libtool
$ sudo brew install autoconf
$ sudo brew install automake
$ 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.