2.3 KiB
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, if discovery: is present in your configuration.yaml file.
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. Don't forget to assign a permanent IP to your Trådfri gateway.
{% linkable_title Configuration %}
You can add the following to your configuration.yaml file if you are not using the discovery: component:
# Example configuration.yaml entry
tradfri:
host: IP_ADDRESS
{% configuration %}
host:
description: "The IP address or hostname of your Trådfri gateway."
required: true
type: string
allow_tradfri_groups:
description: "Set this to false to stop Home Assistant from importing the groups defined on the Trådfri bridge."
required: false
type: boolean
default: true
{% endconfiguration %}
{% linkable_title Troubleshooting %}
{% linkable_title Firmware updates %}
After updating the firmware of your Trådfri gateway it might be necessary to repeat the configuration process. If you encounter problems, delete the .tradfri_psk.conf file in your .homeassistant directory, restart Home Assistant, when prompted enter the security key and click configure, just like during initial setup. Possible errors: Fatal DTLS error: code 115.
{% linkable_title Compilation issues %}
Please make sure you have autoconf installed ($ sudo apt-get install autoconf) if you want to use this component. Also, installing some dependencies might take considerable time (>1 h) on slow devices.
{% linkable_title Setting the api_key %}
Do not use the api_key variable in configuration.yaml. The API key is only needed once at initial setup and will be stored.