TRÅDFRI Binding

This binding integrates the IKEA TRÅDFRI gateway and devices connected to it (such as dimmable LED bulbs).

Supported Things

Beside the gateway (thing type “gateway”), the binding currently supports colored bulbs, dimmable warm white bulbs as well as white spectrum bulbs.
The binding also supports read-only data from remote controls and motion sensors (e.g. the battery status).
The TRÅDFRI controller and sensor devices currently cannot be observed right away.
We assume that they are communicating directly with the bulbs or lamps without routing their commands through the gateway.
This makes it nearly impossible to trigger events for pressed buttons.
We only can access some static data like the present status or battery level.

The thing type ids are defined according to the lighting devices defined for ZigBee LightLink (see page 24, table 2.
These are:

Device type

ZigBee Device ID

Thing type

Dimmable Light

0x0100

0100

Colour Temperature Light

0x0220

0220

Extended Colour Light

0x0210

0210

Occupancy Sensor

0x0107

0107

Non-Colour Controller

0x0820

0820

Non-Colour Scene Controller

0x0830

0830

The following matrix lists the capabilities (channels) for each of the supported lighting device types:

Thing type

Brightness

Color

Color Temperature

Battery Level

Battery Low

0100

X

0220

X

X

0210

X

X

0107

X

X

0820

X

X

0830

X

X

Thing Configuration

For first pairing - the gateway requires a host parameter for the hostname or IP address and a code, which is the security code that is printed on the bottom of the gateway.
Optionally, a port can be configured, but any standard gateway uses the default port 5684.

The code is used during the initialization for retrieving unique identity and pre-shared key from the gateway (fw version 1.2.0042 onwards) and then it’s discarded from the configuration. The newly created authentication data is stored in advanced parameters identity and preSharedKey.
On each initialization if the code is present in the thing configuration - the identity and preSharedKey are recreated and the code is again discarded.

The devices require only a single (integer) parameter, which is their instance id. Unfortunately, this is not displayed anywhere in the IKEA app, but it seems that they are sequentially numbered starting with 65537 for the first device. If in doubt, use the auto-discovered things to find out the correct instance ids.

Channels

The dimmable bulbs support the brightness channel.
The white spectrum bulbs additionally also support the color_temperature channel.

Full color bulbs support the color_temperature and color channels.
Brightness can be changed with the color channel.

The remote control and the motion sensor supports the battery_level and battery_low channels for reading the battery status.