Ding:Tradfri
Aus FabLab Region Nürnberg
libcoap
I use libcoap for all examples. Replace $GWIP with your gateway's IP-Address.
For more information on CoAP see RFC7252.
Authentication
Get key for new identity
Since gateway version 1.1.15 you need to get a individual identity and key for all requests you make.
#> coap-client -m post -u "Client_identity" -k SecurityCode -e "{\"9090\":\"Identity\"}" coaps://$GWIP:5684/15011/9063
v:1 t:CON c:POST i:58a1 {} [ ]
{"9091":"A0bcDeF12g3hIJkL","9029":"1.3.0014"}
The identity you choose is referred as $IDENT in all further examples. The answer 9091 has to be used as $PSK.
Devices
List IDs
#> coap-client -m get -u $IDENT -k $PSK coaps://$GWIP:5684/15001
v:1 t:CON c:GET i:4c5b {} [ ]
[
65574,
65576,
65586
]
Groups
List IDs
#> coap-client -m get -u $IDENT -k $PSK coaps://$GWIP:5684/15004
v:1 t:CON c:GET i:c5fb {} [ ]
[
131080,
131079,
131092
]
Create
#> coap-client -m post -u $IDENT -k $PSK -e '{"9001":"New Name"}' coaps://$GWIP:5684/15004
v:1 t:CON c:POST i:1a03 {} [ ]
Add device to group
#> ???
Delete
#> coap-client -m delete -u $IDENT -k $PSK coaps://$GWIP:5684/15004/Existing Group ID
v:1 t:CON c:DELETE i:16be {} [ ]
Key Reference
| Key | Value |
|---|---|
| 1001 | NEW_FIRMWARE_AVAILABLE |
| 1002 | SMART_TASK_TRIGGERED_EVENT |
| 1003 | GATEWAY_REBOOT_NOTIFICATION |
| 2051 | OPTION_APP_TOKEN |
| 3300 | SENSOR |
| 3311 | LIGHT |
| 3312 | PLUG |
| 5001 | LOSS_OF_INTERNET_CONNECTIVITY |
| 5601 | MIN_MSR_VALUE |
| 5602 | MAX_MSR_VALUE |
| 5603 | MIN_RNG_VALUE |
| 5604 | MAX_RNG_VALUE |
| 5605 | RESET_MIN_MAX_MSR |
| 5700 | SENSOR_VALUE |
| 5701 | UNIT |
| 5706 | COLOR |
| 5709 | COLOR_X |
| 5710 | COLOR_Y |
| 5712 | TRANSITION_TIME |
| 5750 | TYPE |
| 5751 | SENSOR_TYPE |
| 5805 | CUM_ACTIVE_POWER |
| 5820 | POWER_FACTOR |
| 5850 | ONOFF |
| 5851 | DIMMER |
| 5852 | ON_TIME |
| 9001 | NAME |
| 9002 | CREATED_AT |
| 9003 | INSTANCE_ID |
| 9009 | SCENE_LINK |
| 9014 | NOTIFICATION_STATE |
| 9015 | NOTIFICATION_EVENT |
| 9016 | SMART_TASK_TEMPLATE |
| 9017 | NOTIFICATION_NVPAIR |
| 9018 | HS_ACCESSORY_LINK |
| 9019 | REACHABILITY_STATE |
| 9020 | LAST_SEEN |
| 9023 | NTP_SERVER |
| 9024 | TIME_REMAINING_IN_SECONDS |
| 9029 | VERSION |
| 9030 | REBOOT |
| 9031 | RESET |
| 9032 | FORCE_CHECK_OTA_UPDATE |
| 9033 | SESSION_ID |
| 9034 | UPDATE_FIRMWARE |
| 9035 | GATEWAY_NAME |
| 9036 | MASTER_TOKEN_TAG |
| 9037 | OTA_UPDATE |
| 9038 | GROUP_ID |
| 9039 | SCENE_ID |
| 9040 | SMART_TASK_TYPE |
| 9041 | REPEAT_DAYS |
| 9042 | START_ACTION |
| 9043 | END_ACTION |
| 9044 | TRIGGER_TIME_INTERVAL |
| 9045 | GROUP_SETTINGS |
| 9046 | START_TIME_HR |
| 9047 | START_TIME_MN |
| 9048 | END_TIME_HR |
| 9049 | END_TIME_MN |
| 9050 | SMART_TASK_ACTION |
| 9051 | SHORTCUT_ICON_REFERENCE_TYPE |
| 9052 | GATEWAY_REBOOT_NOTIFICATION_TYPE |
| 9054 | OTA_UPDATE_STATE |
| 9055 | GATEWAY_UPDATE_PROGRESS |
| 9056 | GATEWAY_UPDATE_DETAILS_URL |
| 9057 | SCENE_INDEX |
| 9058 | SCENE_ACTIVATE_FLAG |
| 9059 | CURRENT_TIMESTAMP |
| 9061 | COMMISSIONING_MODE |
| 9063 | AUTH_PATH |
| 9064 | SESSION_LENGTH |
| 9066 | OTA_TYPE |
| 9068 | IKEA_MOODS |
| 9069 | UPDATE_ACCEPTED_TIMESTAMP |
| 9070 | USE_CURRENT_LIGHT_SETTINGS |
| 9071 | GATEWAY_TIME_SOURCE |
| 9090 | CLIENT_IDENTITY_PROPOSED |
| 9091 | NEW_PSK_BY_GW |
| 9994 | TIME_ARRAY |
| 9995 | GROUP_LINK_ARRAY |
| 15001 | DEVICES |
| 15002 | HS_LINK |
| 15004 | GROUPS |
| 15005 | SCENE |
| 15006 | NOTIFICATIONS |
| 15009 | SWITCH |
| 15010 | SCHEDULES |
| 15011 | GATEWAY |
| 15012 | GATEWAY_DETAILS |
| 15013 | LIGHT_SETTING |
