diff options
author | Trygve Laugstøl <trygvis@inamo.no> | 2015-10-15 18:34:07 +0200 |
---|---|---|
committer | Trygve Laugstøl <trygvis@inamo.no> | 2015-10-15 18:34:07 +0200 |
commit | 6d04ada06ce29868338face2fbbec8ab72c48dd2 (patch) | |
tree | 537ea335a906f7b8ef177ac435433a40b3731b50 /diller/README.md | |
parent | d9da54abcc784ecca5e1c0c415820a32e68c2296 (diff) | |
download | esp-playground-6d04ada06ce29868338face2fbbec8ab72c48dd2.tar.gz esp-playground-6d04ada06ce29868338face2fbbec8ab72c48dd2.tar.bz2 esp-playground-6d04ada06ce29868338face2fbbec8ab72c48dd2.tar.xz esp-playground-6d04ada06ce29868338face2fbbec8ab72c48dd2.zip |
wip
Diffstat (limited to 'diller/README.md')
-rw-r--r-- | diller/README.md | 53 |
1 files changed, 22 insertions, 31 deletions
diff --git a/diller/README.md b/diller/README.md index 322ec45..72d5778 100644 --- a/diller/README.md +++ b/diller/README.md @@ -14,69 +14,60 @@ Is registration required? Can't the firmware just send an update without a value /name (retained) /description (retained) /type TODO: remove? + /status TODO: remove? type specified what the message looks like /firmware For updating the device's firmware -## Device registration flow - - sub: /registration/<random id> - pub: /registration {} - # Diller serial API ## Network settings Request: -Update network settings. If no paramters are given, no changes are done. +Update or query network settings. If no paramters are given, no changes are done. If ip is set to a blank string, it will use DHCP. - network [ip=..] [gateway=..] [ssid=..] + network [ip=..] [gateway=..] [netmask=..] Response: -The command will always return the current values. If the ssid was recently set, the ip, gateway and netmask fields may be missing. +The command will always return the current values. - ok ip=.. gateway=.. netmask=.. ssid=.. + ok ip=.. gateway=.. netmask=.. netmask=.. -## Register property +## Wlan settings Request: - register-property id=.. type=.. name=.. description=.. +Update or query wlan settings. If no paramters are given, no changes are done. -Type examples: - -* `temperature` -* `switch` - boolean switches -* `humidity` -* `rtc` + wlan [ssid=..] [password=..] Response: - ok - -## Publish property value - -Request: - - set-property id=.. [value=..] [name=..] [description=..] +The command will always return the current values. + + ok ssid=.. -Response: +## Set property value - ok +TODO: Implement description? A longer string describing the sensor. -The value might not be updated directly, but may be buffered on the device if it is not yet connected. +Request: -## Publish raw MQTT message + set-property id=.. [value=..] [name=..] -Request: +Type examples: - publish topic=.. [qos=..] [retain=..] - <next lines are payload. Double EOL completes payload> +* `temperature` +* `switch` - boolean switches +* `humidity` +* `rtc` Response: ok +The value might not be updated directly, but may be buffered on the device if it is not yet connected. + ## Reset the device Request: |