Fri, 13 Dec 2019 20:33:38 +0100
Added ispindel logging. Updated the documentation.
0 | 1 | <!-- |
2 | vim:syntax=docbksgml | |
3 | --> | |
4 | ||
5 | <chapter id="protocols"> | |
6 | <title>Protocollen.</title> | |
7 | <para> | |
8 | De netwerk protocollen. | |
9 | </para> | |
10 | ||
11 | <sect1 id="prototopic"> | |
12 | <title>MQTT topic formaat.</title> | |
13 | <para>De topics zijn als volgt gedefinieerd:</para> | |
14 | <programlisting> | |
15 | mbv1.0/<code>group_id</code>/<code>message_type</code>/<code>edge_node</code>/<code>device_id</code> | |
16 | </programlisting> | |
17 | ||
18 | <itemizedlist> | |
19 | <listitem><para><code>group_id</code> geeft het type apparaat aan zoals <code>fermenters</code> | |
20 | en <code>brewcontrol</code>.</para></listitem> | |
21 | <listitem><para><code>message_type</code> geeft het bericht type aan zoals | |
22 | <code>NBIRTH</code>, <code>DDATA</code>.</para></listitem> | |
23 | <listitem><para><code>edge_node</code> is de hostnaam van de node die het bericht stuurt. Dit is | |
24 | de naam zonder domain toevoeging.</para></listitem> | |
25 | <listitem><para><code>device_id</code> is de verkorte naam van het apparaat module waarvan dit | |
26 | bericht komt zoals de naam van een vergisting controller. Dit is niet aanwezig met NODE berichten.</para></listitem> | |
27 | </itemizedlist> | |
28 | ||
29 | <para> | |
30 | De volgende <code>group_id</code> namen zijn gedefinieerd: | |
31 | </para> | |
32 | <orderedlist> | |
511 | 33 | <listitem><para><code>brewery</code> is voor de bms applicatie zelf. Nog uitwerken.</para></listitem> |
34 | <listitem><para><code>fermenters</code> is voor vergisting controllers.</para></listitem> | |
35 | <listitem><para><code>co2meters</code> is een drukmeter om bijvoorbeeld hergisting op de fles | |
0 | 36 | te monitoren.</para></listitem> |
568
6f3c24e21deb
Added ispindel logging. Updated the documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
530
diff
changeset
|
37 | <listitem><para><code>ispindels</code> is een electronische hydrometer die in het gistvat drijft |
6f3c24e21deb
Added ispindel logging. Updated the documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
530
diff
changeset
|
38 | en de temperatuur en sg verstuurt.</para></listitem> |
0 | 39 | </orderedlist> |
40 | ||
41 | <para>De volgende <code>message_type</code> namen zijn gedefinieerd:</para> | |
42 | <orderedlist> | |
43 | <listitem><para>NBIRTH geeft aan wanneer een node opstart en met het netwerk | |
44 | verbonden is. Dit is een zogenaamd persistent bericht, het blijft voor nieuwe | |
45 | MQTT clients altijd zichtbaar. Bij het starten van een node wordt er een payload | |
46 | verzonden, zie het payload formaat voor een node. Als een node afsluit wordt juist geen | |
47 | payload verzonden zodat het bericht verdwijnt.</para></listitem> | |
48 | <listitem><para>NDEATH wordt verstuurd als een node offline gaat. Maar het kan ook | |
49 | ontvangen worden als de MQTT verbinding verbroken wordt met een node, het NDEATH | |
325
9a8c650972ca
Update some documentation. Thermometer gauges animate easing
Michiel Broek <mbroek@mbse.eu>
parents:
0
diff
changeset
|
50 | bericht is ook het `last will' bericht van een node. Maar als het echt fout gaat |
9a8c650972ca
Update some documentation. Thermometer gauges animate easing
Michiel Broek <mbroek@mbse.eu>
parents:
0
diff
changeset
|
51 | dan zal er mogenlijk nooit een NDEATH bericht gezien worden.</para></listitem> |
9a8c650972ca
Update some documentation. Thermometer gauges animate easing
Michiel Broek <mbroek@mbse.eu>
parents:
0
diff
changeset
|
52 | <listitem><para>NCMD is een commando bestemd voor een node. |
9a8c650972ca
Update some documentation. Thermometer gauges animate easing
Michiel Broek <mbroek@mbse.eu>
parents:
0
diff
changeset
|
53 | Dit kan bijvoorbeeld een reboot commando zijn.</para></listitem> |
364 | 54 | <listitem><para>NDATA wordt verstuurd als er veranderingen zijn voor de node, |
55 | maar ook iedere vijf minuten om aan te geven dat de node nog "levend" en aanwezig | |
56 | is.</para></listitem> | |
57 | ||
0 | 58 | <listitem><para>DBIRTH is een of meer berichten van een apparaat wat online komt |
325
9a8c650972ca
Update some documentation. Thermometer gauges animate easing
Michiel Broek <mbroek@mbse.eu>
parents:
0
diff
changeset
|
59 | en ingeschakeld is. Een apparaat is een deel van een node. |
9a8c650972ca
Update some documentation. Thermometer gauges animate easing
Michiel Broek <mbroek@mbse.eu>
parents:
0
diff
changeset
|
60 | Bij het opstarten van de node is er geen <code>device_id</code> |
0 | 61 | omdat alle apparaten is een keer verstuurd worden. Indien er later een enkel apparaat |
62 | ingeschakeld wordt dan is er wel een geldige <code>device_id</code> aanwezig. | |
63 | Hier ook weer, er is een payload bij opstarten en geen payload bij afsluiten om het | |
64 | persistente bericht goed te houden.</para></listitem> | |
364 | 65 | <listitem><para>DDEATH wordt verstuurd als een node offline gaat, of als het apparaat |
66 | uitgeschakelt wordt.</para></listitem> | |
0 | 67 | <listitem><para>DDATA heeft altijd een payload, maar deze hoeft niet volledig te zijn, |
68 | enkel de gewijzigde data moet in het bericht zitten.</para></listitem> | |
69 | <listitem><para>DLOG is een data log. Hier bestaat de payload uit gegevens die de | |
70 | bms applicatie in de database zet.</para></listitem> | |
325
9a8c650972ca
Update some documentation. Thermometer gauges animate easing
Michiel Broek <mbroek@mbse.eu>
parents:
0
diff
changeset
|
71 | <listitem><para>DCMD is een commando voor een apparaat wat op een node geinstalleerd is. |
9a8c650972ca
Update some documentation. Thermometer gauges animate easing
Michiel Broek <mbroek@mbse.eu>
parents:
0
diff
changeset
|
72 | Dit zullen voornamelijk instellingen voor dat enkele apparaat zijn.</para></listitem> |
0 | 73 | </orderedlist> |
74 | ||
75 | </sect1> | |
76 | ||
77 | ||
78 | <sect1 id="payloadnode"> | |
79 | <title>Netwerk payload formaat voor een node</title> | |
80 | <para> | |
81 | De payload zoals die door een node verstuurd wordt. Het wordt in json formaat | |
511 | 82 | verzonden zonder extra spaties en opmaak zoals hieronder is te zien. Het timestamp |
83 | is de unix tijd sinds 1 januari 1970. Niet alle controllers sturen een timestamp, | |
84 | controllers zonder klok laten dit weg. De tijd wordt dan door <code>bmsd</code> | |
85 | ingevuld en is de tijd dat het bericht ontvangen wordt. | |
86 | Het `seq' nummer wordt met ieder bericht met 1 verhoogd.</para> | |
0 | 87 | <programlisting> |
88 | { | |
89 | "timestamp": 1532201089, | |
90 | "seq": 0, | |
91 | "metric": { | |
92 | "uuid": "b508f01c-1f82-4e8b-b0d2-d88ecfb53031", | |
93 | "properties": { | |
94 | "hardwaremake": "Raspberry", | |
95 | "hardwaremodel": "Unknown", | |
96 | "os": "Linux", | |
97 | "os_version": "4.1.19+", | |
98 | "FW": "0.8.2" | |
99 | }, | |
100 | "THB": { | |
101 | "temperature": 20.0, | |
102 | "humidity": 50.0, | |
103 | "barometer": 1002 | |
104 | }, | |
105 | "GPS": { | |
106 | "latitude": 1.2345, | |
107 | "longitude": 2.3456, | |
108 | "altitude": 20 | |
109 | }, | |
110 | "net": { | |
111 | "address": "10.126.151.11", | |
112 | "ifname": "eth0", | |
113 | "rssi": 0 | |
114 | } | |
115 | } | |
116 | } | |
117 | </programlisting> | |
118 | </sect1> | |
119 | ||
120 | <sect1 id="cmdnode"> | |
121 | <title>Netwerk kommando payload formaat voor nodes.</title> | |
122 | <para>De volgende kommando's kunnen gestuurd worden naar nodes:</para> | |
123 | <programlisting> | |
124 | { | |
125 | "timestamp":1532201089, | |
126 | "metric": { | |
127 | "Node Control/Reboot":true | |
128 | } | |
129 | } | |
325
9a8c650972ca
Update some documentation. Thermometer gauges animate easing
Michiel Broek <mbroek@mbse.eu>
parents:
0
diff
changeset
|
130 | </programlisting> |
9a8c650972ca
Update some documentation. Thermometer gauges animate easing
Michiel Broek <mbroek@mbse.eu>
parents:
0
diff
changeset
|
131 | <para>Dit commando reboot niet de computer maar de applicatie die op een |
9a8c650972ca
Update some documentation. Thermometer gauges animate easing
Michiel Broek <mbroek@mbse.eu>
parents:
0
diff
changeset
|
132 | computer zoals een Raspberry Pi geinstalleerd is. Een uitzondering zijn de |
9a8c650972ca
Update some documentation. Thermometer gauges animate easing
Michiel Broek <mbroek@mbse.eu>
parents:
0
diff
changeset
|
133 | controllers zoals Arduino's en andere eenvoudige systemen.</para> |
9a8c650972ca
Update some documentation. Thermometer gauges animate easing
Michiel Broek <mbroek@mbse.eu>
parents:
0
diff
changeset
|
134 | <programlisting> |
0 | 135 | { |
136 | "timestamp":1532201089, | |
137 | "metric": { | |
138 | "Node Control/Rebirth":true | |
139 | } | |
140 | } | |
141 | </programlisting> | |
325
9a8c650972ca
Update some documentation. Thermometer gauges animate easing
Michiel Broek <mbroek@mbse.eu>
parents:
0
diff
changeset
|
142 | <para>Dit commando zorgt er voor dat alle NBIRTH en DBIRTH berichten opnieuw |
9a8c650972ca
Update some documentation. Thermometer gauges animate easing
Michiel Broek <mbroek@mbse.eu>
parents:
0
diff
changeset
|
143 | verzonden worden alsof de computer net is opgestart. Dit kan nuttig zijn na |
9a8c650972ca
Update some documentation. Thermometer gauges animate easing
Michiel Broek <mbroek@mbse.eu>
parents:
0
diff
changeset
|
144 | een herstart van de bms applicatie zelf zodat de juiste nodes informatie weer |
9a8c650972ca
Update some documentation. Thermometer gauges animate easing
Michiel Broek <mbroek@mbse.eu>
parents:
0
diff
changeset
|
145 | beschikbaar is.</para> |
0 | 146 | </sect1> |
147 | ||
148 | <sect1 id="payloadfermdata"> | |
149 | <title>Netwerk payload data formaat voor vergisting controllers</title> | |
150 | <para> | |
151 | Dit is het meest uitgebreide formaat wat getoond is. Indien er bijvoorbeeld geen | |
361
9f07e2f47ec8
Moved some stuff to the real documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
334
diff
changeset
|
152 | chiller aanwezig is, dan wordt een `null' gestuurd in plaats van een json blok |
0 | 153 | met gegevens. De werkelijke uitvoering van de hardware en de configuratie daarvan |
154 | bepaald dus het uiteindelijke payload formaat. | |
155 | </para> | |
156 | <programlisting> | |
157 | { | |
158 | "uuid": "48c9ae27-3f58-41c9-ae4b-1d57b249c45a", | |
159 | "alias": "unit1", | |
160 | "product": { | |
161 | "uuid": "1eb0c7bf-bf06-491c-a086-ac5478d521b9", | |
162 | "code": "CB0001", | |
163 | "name": "Hoppy Housebeer" | |
164 | }, | |
165 | "air": { | |
166 | "address": "70d60411-3ec8-40ab-998a-81fead83025f", | |
167 | "state": "OK", | |
168 | "temperature": 21.562 | |
169 | }, | |
170 | "beer": { | |
171 | "address": "8ec36f9d-f382-4e32-a47f-732642e1018d", | |
172 | "state": "OK", | |
173 | "temperature": 22.125 | |
174 | }, | |
175 | "chiller": { | |
176 | "address": "e81265b8-07f7-4b22-96c1-6f55a4b66a83", | |
177 | "state": "OK", | |
178 | "temperature": 12.437 | |
179 | }, | |
180 | "heater": { | |
181 | "address": "d2f2d6bc-4d12-4852-9462-95f4c2476034", | |
182 | "state": 0, | |
183 | "usage": 10710793 | |
184 | }, | |
185 | "cooler": { | |
186 | "address": "a9f30140-812c-4ec1-9e98-3a9d47deff7c", | |
187 | "state": 0, | |
188 | "usage": 920504 | |
189 | }, | |
190 | "fan": { | |
191 | "address": "ae9f9887-8209-4810-9f58-ddfb34ee142f", | |
192 | "state": 100, | |
193 | "usage": 62889739 | |
194 | }, | |
195 | "light": { | |
196 | "address": "cc6353cf-9c97-41b9-b6cf-00cea312e478", | |
197 | "state": 0, | |
198 | "usage": 29647290 | |
199 | }, | |
200 | "door": { | |
201 | "address": "ad8746d1-0549-485a-a215-41e5cdde9e75", | |
202 | "state": 1 | |
203 | }, | |
204 | "psu": { | |
205 | "address": "e1bb7182-883d-4977-a1c0-76e214072fc5", | |
206 | "state": 1 | |
207 | }, | |
208 | "stage": "PRIMARY", | |
209 | "mode": "BEER", | |
210 | "setpoint": { | |
211 | "low": 21.0, | |
212 | "high": 21.0 | |
213 | }, | |
334
26c6f8e5d58e
Added webcam_url and webcam_light fields to the mon_fermenters database table. Currently these fields need to be set using phpMyAdmin or another tool. If the webcam_url field is set, then on the mon_fermenter webpage a button is added to show a webcam page.
Michiel Broek <mbroek@mbse.eu>
parents:
325
diff
changeset
|
214 | "webcam": { |
26c6f8e5d58e
Added webcam_url and webcam_light fields to the mon_fermenters database table. Currently these fields need to be set using phpMyAdmin or another tool. If the webcam_url field is set, then on the mon_fermenter webpage a button is added to show a webcam page.
Michiel Broek <mbroek@mbse.eu>
parents:
325
diff
changeset
|
215 | "url":"https://the.webcamserver.com:8090/?action=stream", |
26c6f8e5d58e
Added webcam_url and webcam_light fields to the mon_fermenters database table. Currently these fields need to be set using phpMyAdmin or another tool. If the webcam_url field is set, then on the mon_fermenter webpage a button is added to show a webcam page.
Michiel Broek <mbroek@mbse.eu>
parents:
325
diff
changeset
|
216 | "light": 1 |
26c6f8e5d58e
Added webcam_url and webcam_light fields to the mon_fermenters database table. Currently these fields need to be set using phpMyAdmin or another tool. If the webcam_url field is set, then on the mon_fermenter webpage a button is added to show a webcam page.
Michiel Broek <mbroek@mbse.eu>
parents:
325
diff
changeset
|
217 | }, |
0 | 218 | "alarm": 0, |
219 | "profile": { | |
220 | "uuid": "c93ad1bb-0446-4788-9c43-83990c5f8b82", | |
221 | "name": "Witbier methode Cellis", | |
222 | "state": "OFF", | |
223 | "percent": 0, | |
224 | "inittemp": { | |
225 | "low": 17.9, | |
226 | "high": 18.1 | |
227 | }, | |
228 | "fridgemode": 0, | |
229 | "steps": [ | |
230 | { | |
231 | "resttime": 2, | |
232 | "steptime": 0, | |
233 | "target": { | |
234 | "low": 18.0, | |
235 | "high": 18.0 | |
236 | }, | |
237 | "fridgemode": 0 | |
238 | }, | |
239 | { | |
240 | "resttime": 0, | |
241 | "steptime": 24, | |
242 | "target": { | |
243 | "low": 18.0, | |
244 | "high": 22.0 | |
245 | }, | |
246 | "fridgemode": 0 | |
247 | }, | |
248 | { | |
249 | "resttime": 48, | |
250 | "steptime": 96, | |
251 | "target": { | |
252 | "low": 26.0, | |
253 | "high": 26.0 | |
254 | }, | |
255 | "fridgemode": 0 | |
256 | } | |
257 | ] | |
258 | } | |
259 | } | |
260 | </programlisting> | |
261 | <para>Temperature states can be: OK, MISSING or ERROR.<para> | |
262 | <para>The general `mode' can be: OFF, NONE, FRIDGE, BEER or PROFILE.</para> | |
263 | <para>The profile `state' can be: OFF, PAUSE, RUN, DONE or ABORT.</para> | |
264 | </sect1> | |
265 | ||
266 | ||
267 | <sect1 id="payloadfermlog"> | |
268 | <title>Netwerk payload log formaat voor vergisting controllers</title> | |
269 | <para> | |
270 | Dit is het meest uitgebreide formaat wat getoond is. Indien er bijvoorbeeld geen | |
271 | chiller aanwezig is, dan wordt geen data hiervoor verstuurd. | |
272 | De werkelijke uitvoering van de hardware en de configuratie daarvan | |
273 | bepaald dus het uiteindelijke payload formaat. | |
274 | </para> | |
275 | <programlisting> | |
276 | { | |
277 | "timestamp": 1532201089, | |
278 | "seq": 0, | |
279 | "metric": { | |
280 | "product": { | |
281 | "uuid": "1eb0c7bf-bf06-491c-a086-ac5478d521b9", | |
282 | "code": "CB0001", | |
283 | "name": "Hoppy Housebeer" | |
284 | }, | |
285 | "stage": "PRIMARY", | |
286 | "mode": "BEER", | |
287 | "temperature": { | |
288 | "air": 20.125, | |
289 | "beer": 20.062, | |
290 | "chiller": -3.000, | |
291 | "room": 20.1 | |
292 | }, | |
293 | "setpoint": { | |
294 | "low": 19.8, | |
295 | "high": 20.1 | |
296 | }, | |
297 | "heater": { | |
298 | "power": 100, | |
299 | "usage": 1234 | |
300 | }, | |
301 | "cooler": { | |
302 | "power": 0, | |
303 | "usage": 27273 | |
304 | }, | |
305 | "fan": { | |
306 | "power": 100, | |
307 | "usage": 8273772 | |
308 | }, | |
309 | "sg": 1.023, | |
310 | "event": "Something to mark", | |
311 | "fermenter_uuid": "48c9ae27-3f58-41c9-ae4b-1d57b249c45a" | |
312 | } | |
313 | } | |
314 | </programlisting> | |
361
9f07e2f47ec8
Moved some stuff to the real documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
334
diff
changeset
|
315 | <para> |
9f07e2f47ec8
Moved some stuff to the real documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
334
diff
changeset
|
316 | De ontvangen vergisting log gegevens worden niet opgeslagen in de SQL database |
9f07e2f47ec8
Moved some stuff to the real documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
334
diff
changeset
|
317 | maar in platte tekst bestanden. Hierdoor is de gelogde informatie sneller toegankelijk. |
9f07e2f47ec8
Moved some stuff to the real documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
334
diff
changeset
|
318 | Ieder brouw product heeft zijn eigen bestand. |
9f07e2f47ec8
Moved some stuff to the real documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
334
diff
changeset
|
319 | De bestanden staan in <code>www/logs/fermentation/</code>. |
9f07e2f47ec8
Moved some stuff to the real documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
334
diff
changeset
|
320 | De bestandsnamen zijn <code>product_code\ product_name.log</code>. |
9f07e2f47ec8
Moved some stuff to the real documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
334
diff
changeset
|
321 | Het interne formaat is:</para> |
9f07e2f47ec8
Moved some stuff to the real documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
334
diff
changeset
|
322 | <programlisting> |
530
a7430eee20bd
Updated the documentation. Changed page layout.
Michiel Broek <mbroek@mbse.eu>
parents:
511
diff
changeset
|
323 | 2014-11-15 18:39:12,BEER,PRIMARY,20.312,19.750,-1.500,20.5,18.6,18.8,35,12345,0,67890,Whatsup,Fermenter |
a7430eee20bd
Updated the documentation. Changed page layout.
Michiel Broek <mbroek@mbse.eu>
parents:
511
diff
changeset
|
324 | | | | | | | | | | | | | | | | |
a7430eee20bd
Updated the documentation. Changed page layout.
Michiel Broek <mbroek@mbse.eu>
parents:
511
diff
changeset
|
325 | 0 datetime + | | | | | | | | | | | | | | |
a7430eee20bd
Updated the documentation. Changed page layout.
Michiel Broek <mbroek@mbse.eu>
parents:
511
diff
changeset
|
326 | 1 werkwijze ---------+ | | | | | | | | | | | | | |
a7430eee20bd
Updated the documentation. Changed page layout.
Michiel Broek <mbroek@mbse.eu>
parents:
511
diff
changeset
|
327 | 2 vergisting fase ---------+ | | | | | | | | | | | | |
a7430eee20bd
Updated the documentation. Changed page layout.
Michiel Broek <mbroek@mbse.eu>
parents:
511
diff
changeset
|
328 | 3 temperatuur lucht --------------+ | | | | | | | | | | | |
a7430eee20bd
Updated the documentation. Changed page layout.
Michiel Broek <mbroek@mbse.eu>
parents:
511
diff
changeset
|
329 | 4 temperatuur bier ----------------------+ | | | | | | | | | | |
a7430eee20bd
Updated the documentation. Changed page layout.
Michiel Broek <mbroek@mbse.eu>
parents:
511
diff
changeset
|
330 | 5 temperatuur koeler ---------------------------+ | | | | | | | | | |
a7430eee20bd
Updated the documentation. Changed page layout.
Michiel Broek <mbroek@mbse.eu>
parents:
511
diff
changeset
|
331 | 6 temperatuur ruimte ----------------------------------+ | | | | | | | | |
a7430eee20bd
Updated the documentation. Changed page layout.
Michiel Broek <mbroek@mbse.eu>
parents:
511
diff
changeset
|
332 | 7 instelwaarde laag ----------------------------------------+ | | | | | | | |
a7430eee20bd
Updated the documentation. Changed page layout.
Michiel Broek <mbroek@mbse.eu>
parents:
511
diff
changeset
|
333 | 8 instelwaarde hoog ---------------------------------------------+ | | | | | | |
a7430eee20bd
Updated the documentation. Changed page layout.
Michiel Broek <mbroek@mbse.eu>
parents:
511
diff
changeset
|
334 | 9 verwarming vermogen -----------------------------------------------+ | | | | | |
a7430eee20bd
Updated the documentation. Changed page layout.
Michiel Broek <mbroek@mbse.eu>
parents:
511
diff
changeset
|
335 | 10 verwarming verbruik ---------------------------------------------------+ | | | | |
a7430eee20bd
Updated the documentation. Changed page layout.
Michiel Broek <mbroek@mbse.eu>
parents:
511
diff
changeset
|
336 | 11 koeler vermogen -----------------------------------------------------------+ | | | |
a7430eee20bd
Updated the documentation. Changed page layout.
Michiel Broek <mbroek@mbse.eu>
parents:
511
diff
changeset
|
337 | 12 koeler verbruik ---------------------------------------------------------------+ | | |
a7430eee20bd
Updated the documentation. Changed page layout.
Michiel Broek <mbroek@mbse.eu>
parents:
511
diff
changeset
|
338 | 13 gebeurtenis --------------------------------------------------------------------------+ | |
a7430eee20bd
Updated the documentation. Changed page layout.
Michiel Broek <mbroek@mbse.eu>
parents:
511
diff
changeset
|
339 | 14 vergister uuid --------------------------------------------------------------------------------+ |
361
9f07e2f47ec8
Moved some stuff to the real documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
334
diff
changeset
|
340 | </programlisting> |
0 | 341 | </sect1> |
342 | ||
506
8ab0e87d579e
Added beer selection in the CO2 meter screen. Added CO2 pressure logging.
Michiel Broek <mbroek@mbse.eu>
parents:
364
diff
changeset
|
343 | <sect1 id="payloadco2log"> |
8ab0e87d579e
Added beer selection in the CO2 meter screen. Added CO2 pressure logging.
Michiel Broek <mbroek@mbse.eu>
parents:
364
diff
changeset
|
344 | <title>Netwerk payload log formaat voor CO2 meters.</title> |
511 | 345 | <para> |
346 | Voor iedere actieve CO2 meter wordt bij iedere systeemstart een logbericht | |
347 | gestuurd. Dit is ongeveer iedere 5 minuten. Omdat de CO2 meters eenvoudige | |
348 | controllers zijn is er geen tijd en product informatie beschikbaar. Deze | |
349 | ontbrekende gegevens worden aangevuld door <command>bmsd</command> | |
350 | </para> | |
351 | <programlisting> | |
506
8ab0e87d579e
Added beer selection in the CO2 meter screen. Added CO2 pressure logging.
Michiel Broek <mbroek@mbse.eu>
parents:
364
diff
changeset
|
352 | |
511 | 353 | </programlisting> |
506
8ab0e87d579e
Added beer selection in the CO2 meter screen. Added CO2 pressure logging.
Michiel Broek <mbroek@mbse.eu>
parents:
364
diff
changeset
|
354 | <para> |
8ab0e87d579e
Added beer selection in the CO2 meter screen. Added CO2 pressure logging.
Michiel Broek <mbroek@mbse.eu>
parents:
364
diff
changeset
|
355 | De ontvangen CO2 log gegevens worden niet opgeslagen in de SQL database |
8ab0e87d579e
Added beer selection in the CO2 meter screen. Added CO2 pressure logging.
Michiel Broek <mbroek@mbse.eu>
parents:
364
diff
changeset
|
356 | maar in platte tekst bestanden. Hierdoor is de gelogde informatie sneller toegankelijk. |
8ab0e87d579e
Added beer selection in the CO2 meter screen. Added CO2 pressure logging.
Michiel Broek <mbroek@mbse.eu>
parents:
364
diff
changeset
|
357 | Ieder brouw product heeft zijn eigen bestand. |
8ab0e87d579e
Added beer selection in the CO2 meter screen. Added CO2 pressure logging.
Michiel Broek <mbroek@mbse.eu>
parents:
364
diff
changeset
|
358 | De bestanden staan in <code>www/logs/co2pressure/</code>. |
8ab0e87d579e
Added beer selection in the CO2 meter screen. Added CO2 pressure logging.
Michiel Broek <mbroek@mbse.eu>
parents:
364
diff
changeset
|
359 | De bestandsnamen zijn <code>product_code\ product_name.log</code>. |
8ab0e87d579e
Added beer selection in the CO2 meter screen. Added CO2 pressure logging.
Michiel Broek <mbroek@mbse.eu>
parents:
364
diff
changeset
|
360 | Het interne formaat is:</para> |
8ab0e87d579e
Added beer selection in the CO2 meter screen. Added CO2 pressure logging.
Michiel Broek <mbroek@mbse.eu>
parents:
364
diff
changeset
|
361 | <programlisting> |
8ab0e87d579e
Added beer selection in the CO2 meter screen. Added CO2 pressure logging.
Michiel Broek <mbroek@mbse.eu>
parents:
364
diff
changeset
|
362 | 2019-10-11 16:13:33,22.250,5.964,c0ffeeee-dead-beef-caf0-3c71bffe4054 |
8ab0e87d579e
Added beer selection in the CO2 meter screen. Added CO2 pressure logging.
Michiel Broek <mbroek@mbse.eu>
parents:
364
diff
changeset
|
363 | | | | | |
8ab0e87d579e
Added beer selection in the CO2 meter screen. Added CO2 pressure logging.
Michiel Broek <mbroek@mbse.eu>
parents:
364
diff
changeset
|
364 | 0 datetime + | | | |
8ab0e87d579e
Added beer selection in the CO2 meter screen. Added CO2 pressure logging.
Michiel Broek <mbroek@mbse.eu>
parents:
364
diff
changeset
|
365 | 1 temperatuur ----------+ | | |
8ab0e87d579e
Added beer selection in the CO2 meter screen. Added CO2 pressure logging.
Michiel Broek <mbroek@mbse.eu>
parents:
364
diff
changeset
|
366 | 2 CO2 flesdruk in bar ---------+ | |
8ab0e87d579e
Added beer selection in the CO2 meter screen. Added CO2 pressure logging.
Michiel Broek <mbroek@mbse.eu>
parents:
364
diff
changeset
|
367 | 3 meter uuid -------------------------------------+ |
8ab0e87d579e
Added beer selection in the CO2 meter screen. Added CO2 pressure logging.
Michiel Broek <mbroek@mbse.eu>
parents:
364
diff
changeset
|
368 | </programlisting> |
8ab0e87d579e
Added beer selection in the CO2 meter screen. Added CO2 pressure logging.
Michiel Broek <mbroek@mbse.eu>
parents:
364
diff
changeset
|
369 | </sect1> |
0 | 370 | |
568
6f3c24e21deb
Added ispindel logging. Updated the documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
530
diff
changeset
|
371 | |
6f3c24e21deb
Added ispindel logging. Updated the documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
530
diff
changeset
|
372 | <sect1 id="ispindellog"> |
6f3c24e21deb
Added ispindel logging. Updated the documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
530
diff
changeset
|
373 | <title>Netwerk payload formaat voor de iSpindels.</title> |
6f3c24e21deb
Added ispindel logging. Updated the documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
530
diff
changeset
|
374 | <para> |
6f3c24e21deb
Added ispindel logging. Updated the documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
530
diff
changeset
|
375 | De iSpindel is een extern project en verstuurd een afwijkend en simpel |
6f3c24e21deb
Added ispindel logging. Updated the documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
530
diff
changeset
|
376 | formaat van MQTT berichten. De berichten die verstuurd worden met iedere |
6f3c24e21deb
Added ispindel logging. Updated the documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
530
diff
changeset
|
377 | update zien er als volgt uit: |
6f3c24e21deb
Added ispindel logging. Updated the documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
530
diff
changeset
|
378 | </para> |
6f3c24e21deb
Added ispindel logging. Updated the documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
530
diff
changeset
|
379 | <programlisting> |
6f3c24e21deb
Added ispindel logging. Updated the documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
530
diff
changeset
|
380 | ispindel/<node>/tilt Tilt |
6f3c24e21deb
Added ispindel logging. Updated the documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
530
diff
changeset
|
381 | ispindel/<node>/temperature 20.1250 |
6f3c24e21deb
Added ispindel logging. Updated the documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
530
diff
changeset
|
382 | ispindel/<node>/temp_units C |
6f3c24e21deb
Added ispindel logging. Updated the documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
530
diff
changeset
|
383 | ispindel/<node>/battery Volt |
6f3c24e21deb
Added ispindel logging. Updated the documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
530
diff
changeset
|
384 | ispindel/<node>/gravity Gravity |
6f3c24e21deb
Added ispindel logging. Updated the documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
530
diff
changeset
|
385 | ispindel/<node>/interval 900 |
6f3c24e21deb
Added ispindel logging. Updated the documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
530
diff
changeset
|
386 | ispindel/<node>/RSSI WiFi.RSSI() |
6f3c24e21deb
Added ispindel logging. Updated the documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
530
diff
changeset
|
387 | </programlisting> |
6f3c24e21deb
Added ispindel logging. Updated the documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
530
diff
changeset
|
388 | <para> |
6f3c24e21deb
Added ispindel logging. Updated the documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
530
diff
changeset
|
389 | Voor iedere actieve iSpindel wordt bij iedere systeemstart een bericht |
6f3c24e21deb
Added ispindel logging. Updated the documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
530
diff
changeset
|
390 | gestuurd. Dit is ongeveer iedere 15 minuten. Omdat de iSpindel eenvoudige |
6f3c24e21deb
Added ispindel logging. Updated the documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
530
diff
changeset
|
391 | controllers zijn is er geen tijd en product informatie beschikbaar. Deze |
6f3c24e21deb
Added ispindel logging. Updated the documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
530
diff
changeset
|
392 | ontbrekende gegevens worden aangevuld door <command>bmsd</command> |
6f3c24e21deb
Added ispindel logging. Updated the documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
530
diff
changeset
|
393 | </para> |
6f3c24e21deb
Added ispindel logging. Updated the documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
530
diff
changeset
|
394 | |
6f3c24e21deb
Added ispindel logging. Updated the documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
530
diff
changeset
|
395 | <para> |
6f3c24e21deb
Added ispindel logging. Updated the documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
530
diff
changeset
|
396 | De ontvangen iSpindel gegevens worden niet opgeslagen in de SQL database |
6f3c24e21deb
Added ispindel logging. Updated the documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
530
diff
changeset
|
397 | maar in platte tekst bestanden. Hierdoor is de gelogde informatie sneller toegankelijk. |
6f3c24e21deb
Added ispindel logging. Updated the documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
530
diff
changeset
|
398 | Ieder brouw product heeft zijn eigen bestand. |
6f3c24e21deb
Added ispindel logging. Updated the documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
530
diff
changeset
|
399 | De bestanden staan in <code>www/logs/ispindel/</code>. |
6f3c24e21deb
Added ispindel logging. Updated the documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
530
diff
changeset
|
400 | De bestandsnamen zijn <code>product_code\ product_name.log</code>. |
6f3c24e21deb
Added ispindel logging. Updated the documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
530
diff
changeset
|
401 | Het interne formaat is:</para> |
6f3c24e21deb
Added ispindel logging. Updated the documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
530
diff
changeset
|
402 | <programlisting> |
6f3c24e21deb
Added ispindel logging. Updated the documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
530
diff
changeset
|
403 | 2019-10-11 16:13:33,70.12,22.250,3.576,1.032,900,-45 |
6f3c24e21deb
Added ispindel logging. Updated the documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
530
diff
changeset
|
404 | | | | | | | | |
6f3c24e21deb
Added ispindel logging. Updated the documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
530
diff
changeset
|
405 | 0 datetime + | | | | | | |
6f3c24e21deb
Added ispindel logging. Updated the documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
530
diff
changeset
|
406 | 1 tilt -----------------+ | | | | | |
6f3c24e21deb
Added ispindel logging. Updated the documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
530
diff
changeset
|
407 | 2 temperatuur -----------------+ | | | | |
6f3c24e21deb
Added ispindel logging. Updated the documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
530
diff
changeset
|
408 | 3 batterij spanning -----------------+ | | | |
6f3c24e21deb
Added ispindel logging. Updated the documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
530
diff
changeset
|
409 | 4 densiteit -------------------------------+ | | |
6f3c24e21deb
Added ispindel logging. Updated the documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
530
diff
changeset
|
410 | 5 interval -------------------------------------+ | |
6f3c24e21deb
Added ispindel logging. Updated the documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
530
diff
changeset
|
411 | 6 rssi ---------------------------------------------+ |
6f3c24e21deb
Added ispindel logging. Updated the documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
530
diff
changeset
|
412 | </programlisting> |
6f3c24e21deb
Added ispindel logging. Updated the documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
530
diff
changeset
|
413 | </sect1> |
6f3c24e21deb
Added ispindel logging. Updated the documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
530
diff
changeset
|
414 | |
6f3c24e21deb
Added ispindel logging. Updated the documentation.
Michiel Broek <mbroek@mbse.eu>
parents:
530
diff
changeset
|
415 | |
0 | 416 | </chapter> |