tds-node-tradfri-restapi's Introduction

Node TRÅDFRI REST-API TDS

Simple Rest API to comunicate with IKEA TRÅDFRI Gateway. Has support for the following devices, groups and scenes, Blinds

Build from a need to control my TRÅDFRI Blinds with my automation system, this allows me to control the blinds with a simple http request.

What

/tradfri/deviceids will provide an array of device ids
/tradfri/groupids will provide an array of group ids
/tradfri/devices will provide a full list of all devices including meta data
/tradfri/groups will provide a full list of all groups including devices id's and meta data
/tradfri/all will provide a full detailed list of groups and devices
/tradfri/device/:deviceid/:state will set the state of a device (on/off). E.g. /tradfri/device/17101/on
/tradfri/group/:groupid/:state will set the state of a device (on/off). E.g. /tradfri/device/11007/off
/tradfri/register will provide a PSK for defined client

First release is a bit of a quick one. Exceptions needs to be managed and include toggle as an option.

How

Setup libcoap as explained below

Setup libcoap as explained below
Rename ./config/default.json-sample to ./config/default.json and update with the IKEA hub information
Run using node >4.4.7
Register identity and put returned PSK to config, using the API request /tradfri/register

Compiling libcoap

Install libcoap as descibed below for Debian/Ubuntu/Raspbian: (credits to homebridge-tradfri)

$ apt-get install libtool git build-essential install autoconf automake
$ git clone --recursive https://github.com/obgm/libcoap.git
$ cd libcoap
$ git checkout dtls
$ git submodule update --init --recursive
$ ./autogen.sh
$ ./configure --disable-documentation --disable-shared
$ make

You'll find the coap-client binary in ./examples

Recommend Projects