Mirror/AI-on-the-edge-device-docs
1
0
Fork 0
mirror of https://github.com/jomjol/AI-on-the-edge-device-docs.git synced 2025-12-09 21:17:09 +03:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #33 from danube/patch-1

Browse Source 
Update MQTT-API.md
This commit is contained in:
Frank Haverland
2023-04-19 17:10:54 +02:00
committed by GitHub
parent d66be0c77b c4690c686c
commit d04cd986e3
1 changed files with 25 additions and 41 deletions
Download Patch File Download Diff File Expand all files Collapse all files

66
docs/MQTT-API.md
View File

@@ -17,53 +17,37 @@ The following parameters have to be defined:
## Published topics ## Published topics
### Status ### Status
`MainTopic`/{status topic}, e.g. `watermeter/status`
* #### Connection The following overhead data are available under the main topic (i.e. `watermeter`):
* #### Interval Topic | Description
-|-
* #### MAC `watermeter/MAC` | The MAC address of the ESP module.
`watermeter/IP` | The IP address of the ESP module.
* #### IP `watermeter/Hostname` | The network host name of the ESP module.
`watermeter/Interval` | The round interval as configured during setup or in [Parameters -> Interval](https://jomjol.github.io/AI-on-the-edge-device-docs/Parameters/#section-autotimer).
* #### Hostname `watermeter/Connection` | Network connection status.
`watermeter/Uptime` | Seconds up since last boot.
* #### Uptime `watermeter/FreeMem` | Free memory in kB.
`watermeter/wifiRSSI` | Quality of WiFi signal.
* #### FreeMem `watermeter/CPUTemp` | Temperature of the ESP CPU in degrees celsius.
* #### WifiRSSI
* #### CPUTemp
* #### Status
### Result ### Result
`MainTopic`/{NumberName}/{result topic}, e.g. `watermeter/main/value`
* #### Value The following calculation data are available under the sup-topic `main` (i.e. `watermeter/main`):
* #### Raw Topic | Description
-|-
* #### Error `watermeter/main/error` | Informs about the flow status. On success, the value is `no error`.
`watermeter/main/raw` | The value **before** performing [post processing](https://jomjol.github.io/AI-on-the-edge-device-docs/Parameters/section-postprocessing).
* #### JSON `watermeter/main/value` | The value **after** performing [post processing](https://jomjol.github.io/AI-on-the-edge-device-docs/Parameters/section-postprocessing).
`watermeter/main/rate` | How much flow was consumed in one minute.
* #### Rate `watermeter/main/rate_per_time_unit` | How much flow was consumed in one minute. The time unit gets set with the Home Assistant Discovery, e.g. `h` (hours) or `m` (minutes).
`watermeter/main/changeabsolut` | Difference between the previous and actual read value.
* #### Rate_per_time_unit `watermeter/main/rate_per_digitalization_round` | How much flow was consumed in one minute.
The time Unit gets set with the Home Assistant Discovery, e.g. `h` or `m` (minutes) `watermeter/main/timestamp` | Timestamp of the actual message.
`watermeter/main/Status` | Informs about the last performed step of the watermeter (i.e. `Flow finished`).
* #### Rate_per_digitalization_round `watermeter/main/json` | This is a JSON formatted object containing the following values: `value`, `raw`, `pre`, `error`, `rate`, `timestamp`.
The `interval` defines when the next round gets triggered
* #### Changeabsolut
* #### Timestamp
* #### JSON
All relevant results in JSON syntax
### GPIO ### GPIO
`MainTopic`/{GPIO topic}, e.g. `watermeter/GPIO/GPIO12` `MainTopic`/{GPIO topic}, e.g. `watermeter/GPIO/GPIO12`