jeena/home-assistant.github.io
1
0
Fork 0
Code Issues Pull requests Projects Packages Wiki Activity Actions

Merge branch 'current' into next

Browse source
This commit is contained in:
Paulus Schoutsen 2017-05-04 21:49:24 -07:00
commit 0ac6fd0f3f
103 changed files with 1628 additions and 744 deletions
Download patch file Download diff file Expand all files Collapse all files

32
source/_components/tradfri.markdown
View file

@ -14,22 +14,44 @@ ha_iot_class: "Local Polling"
ha_release: 0.43
---
The `tradfri` component supports for the IKEA Trådfri (Tradfri) gateway. The gateway can control lights connected to it.
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:
For this to work, you need to install a modified lib-coap library.
Linux:
```bash
$ 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
$ make install
$ sudo make install
```
To enable these lights, add the following lines to your `configuration.yaml` file:
macOS:
```bash
$ 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
<p class='note'>
If you see an "Unable to connect" message, restart the gateway and try again.
</p>
The gateway can also be manually configured by adding the following lines to your `configuration.yaml` file:
```yaml
# Example configuration.yaml entry
@ -41,4 +63,4 @@ tradfri:
Configuration variables:
- **host** (*Required*): The IP address or hostname of your Trådfri gateway.
- **api_key** (*Required*): Can be found on the back of the Trådfri gateway.
- **api_key** (*Required*): Can be found listed as Security Key on the back of the Trådfri gateway.