Python package to communicate with the IKEA Trådfri (Tradfri) ZigBee Gateway compatible with ZigBee Light Link products. By using this library you can communicate with the gateway and control IKEA's lights and wall plugs.
Some of the features include:
Table of contents:
You might have to use superuser privileges (sudo) for some commands to work when installing.
For asynchronous applications you will need to install
pytradfri[async], for instance using the requirements file:
pip install pytradfri[async]. Please note that install might take considerable time on slow devices. Use examples/example_async.py when testing this.
Security best practice is to not store the security code that is printed on the gateway permanently in your application. Please always use the PSK when communicating with the gateway.
|IKEA Gateway (E1526)||1.8.25|
|TRADFRI bulb E14 WS opal 400lm||1.2.217|
|TRADFRI bulb E27 WS opal 980lm||1.2.217|
|TRADFRI bulb E27 W opal 1000lm||1.2.214|
|TRADFRI remote control||1.2.214|
|TRADFRI motion sensor||1.2.214|
|TRADFRI wall plug||2.0.022|
If you want to test this library stand-alone in a command-line interface:
$ python3 -i -m pytradfri IP
Where IP is substituted by the IP-address to your gateway.
The first time running pytradfri you will be asked to input the 'Security Code' found on the back of your IKEA gateway.
List all lights:
Set the brightness of item 1 to 50 in lights list:
Observe a light for changes:
def change_listener(device): print(device.name + " is now " + str(device.light_control.lights.state)) api(lights.observe(change_listener))
Please see the example files.
There is a Docker script available to bootstrap a dev environment. Run
./script/dev_docker and you will build and launch a container that is ready to go for both sync and async. After launching, follow the above instructions to test the library stand-alone.
The working directory of the Docker image is
/usr/src/app. The checked out version of this repo is added there and installed as a Python dependency for easy development and testing. When you want to use the latest stable version from pip, you only have to change to another working directory.
We are aware of issues some users face with their gateways. Anecdotal evicence suggests sending many requests (spamming) the gateway, or an unreliable network connection can be the culprit. As a first solution, try to limit the number of requests, and move the Gateway closer to the device running pytradfri on the nework. Other than that, there is unfortunately not anything this project can do to support or resolve these issues at this time. As this progresses, we will ensure the project is kept up-to-date.
Paulus Schoutsen (@balloob) made a working Python library of the initial code concept. Lewis Juggins (@lwis) added support for asyncio and improved management of dependencies and consistency around return types. Many others have contributed too.