Skip to content

Latest commit

 

History

History
36 lines (27 loc) · 2.61 KB

Readme.legacy.md

File metadata and controls

36 lines (27 loc) · 2.61 KB
Raw

C# TradFri Library Legacy

This is a .NET Framework (4.5) library to communicate with the IKEA Trådfri (Tradfri) ZigBee-based Gateway. Using this library you can, by communicating with the gateway, control IKEA lights (including the RGB ones).

Latest version: 0.3.0.22

Latest Gateway version tested and working - 1.4.15.

  • Get information on the gateway
  • Observe lights, groups and other resources
  • Get notified when lights, groups and other resources change
  • 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 (currently only turn them on/off)
  • Restart and reset gateway

1. Usage

Clone the repository. Open the solution and then the app.config file under the TradFriGui project. Edit the values in the app.config file:

  • GatewayName is your nickname to your gateway, currently this doesn't have an effect. It is here if you have access to multiple gateways so you can easily differentiate them.
  • GatewayIP is the IP-address to your gateway.
  • GatewaySecret is written on the back of your IKEA Tradfri Gateway.

After editing app.config you can hit F5 and run the project. You should have a grid displaying devices connected to your Gateway. Upon selecting a row(s) (row!! and not cell) you can turn On or Off your selected devices. If everything works, you can proceed with investigating the code written in TradFriGui because that's the way how you will use the library.

Note - you can also download the nuget package prior to 1.0.0.0 version and use it in your project the same way I use it in a TradFriGui project.

2. TradFriGui

This project serves only as a demo project with an example on how to use the library, it is not intended to be a complete application but you can use it as a starting point for your main project.

3. TradFriLibrary

This project contains all the models and controllers needed for communication with the Gateway. You don't need to mess with this project unless you want to further investigate it or to participate in library development. For now, you can build the .dll of the project in release version and add it as a reference to your project.

4. Acknowledgements

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