Ding:Tradfri: Unterschied zwischen den Versionen

Aus FabLab Region Nürnberg
(coap Gruppen)
(Formating and more examples)
Zeile 1: Zeile 1:
== libcoap ==
== libcoap ==


=== Gruppenverwaltung ===
I use [https://github.com/obgm/libcoap libcoap] for all examples. Replace $GWIP with your gateway's IP-Address.


==== Abfragen ====
=== Get key for new identity ===


coap-client -m get -u $IDENT -k $PSK coaps://$GWIP:5684/15004
Since gateway version 1.1.15 you need to get a individual identity and key for all requests you make.


==== Anlage ====
#> coap-client -m post -u "Client_identity" -k <span style="color:red">SecurityCode</span> -e "{\"9090\":\"<span style="color:red">Identity</span>\"}" coaps://$GWIP:5684/15011/9063


  coap-client -m post -u $IDENT -k $PSK -e '{"9001":"<span style="color:red">Neuer Gruppenname</span>"}' coaps://$GWIP:5684/15004
  v:1 t:CON c:POST i:58a1 {} [ ]
{"9091":"A0bcDeF12g3hIJkL","9029":"1.3.0014"}


==== Geräte hinzufügen ====
The identity you choose is referred as $IDENT in all further examples. The answer 9091 has to be used as $PSK.


???
=== Devices ===


==== Löschen ====
==== List IDs ====


  coap-client -m delete -u $IDENT -k $PSK coaps://$GWIP:5684/15004/<span style="color:red">Bestehende Gruppennummer</span>
  #> 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":"<span style="color:red">New Name</span>"}' 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/<span style="color:red">Existing Group ID</span>
v:1 t:CON c:DELETE i:16be {} [ ]


== Key Reference ==
== Key Reference ==

Version vom 11. März 2018, 16:50 Uhr

libcoap

I use libcoap for all examples. Replace $GWIP with your gateway's IP-Address.

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

Quellen

https://github.com/Hypfer/node-tradfri