Sensor state callbacks

After provisioning, the Konnected device will begin reporting sensor state by calling back to a HTTP endpoint derived from the endpoint setting. When using the REST/HTTP communication type, the sensor state data is sent as a JSON payload in a PUT request to the endpoint. The endpoint's URI is automatically appended /device/DEVICE_ID where DEVICE_ID is the 12-character MAC address.

In the case of Amazon Web Services (AWS) IoT, the sensor state data is published to a topic konnected/DEVICE_ID/PIN where DEVICE_ID is the 12-character MAC address of the device and PIN is the pin number (see Pin Mapping).

Examples

Assume that you've set endpoint to http://192.168.1.200/api/konnected in the provisioning step. A device with MAC address 60:01:94:8B:CD:53 would call back to:

http://192.168.1.200/api/konnected/device/6001948bcd53

Binary sensor payload

{"pin":1, "state":1}

The sensor loop on pin 1 is open.

DHT sensor payload

{"pin":1, "temp":"20.900", "humi":"48.500"}

The DHT sensor on pin 1 reported 20.9 degrees Celcius and 48.5% relative humidity.

DS18B20 sensor payload

{"pin":1, "temp":"20.900", "addr":"XXXXXXXXXXXXXXXXXXXXXXXXXXXX"}

The ds18b20 sensor on pin 1 with address XXXXXXXXXXXXXXXXXXXXXXXXXXXX reported 20.9 degrees Celcius.

Response and Automatic Retry

Konnected expects a success response from your application's server (200 or 201 response code). If a successful response is not received, the device will automatically retry the state update up to 10 times before rebooting in a failsafe procedure.