42b / pytradfri Goto Github PK

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:

• Get information on the gateway
• Observe lights, groups and other resources and get notified when they change
• Control wall plugs
• List all devices connected to gateway
• List all lights and get attributes of lights (name, state, color temp, dimmer level etc)
• Change attribute values of lights (name, state, color temp, dimmer level etc)
• Restart and reset the gateway
• List smart tasks (wake up, on/off and not home) and their attributes
• Alter values in smart tasks (some of these features not available in app yet)

Table of contents:

1. Installation
2. Verified Device Compatibility
3. Stand-alone use (command-line interface)
4. Implement in your own Python platform
5. Docker support
6. Acknowledgements

You might have to use superuser privileges (sudo) for some commands to work when installing.

To use the library in a synchronous application, you first need to install libcoap using this script. Use examples/example_sync.py when testing this.

For asynchronous applications you will need to install pytradfri[async], for instance using the requirements file: shell 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.

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:

lights

Set the brightness of item 1 to 50 in lights list:

api(lights[1].light_control.set_dimmer(50))

Observe a light for changes:

def change_listener(device):
  print(device.name + " is now " + str(device.light_control.lights[0].state))

api(lights[0].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.

This is an implementation based on analysis I found here by vidarlo.

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.