doc/bms-ch8.sgml

branch
stable
changeset 520
d25a1b160dba
parent 511
f51630063f00
child 530
a7430eee20bd
--- a/doc/bms-ch8.sgml	Sat Sep 14 10:41:35 2019 +0200
+++ b/doc/bms-ch8.sgml	Fri Oct 18 13:12:46 2019 +0200
@@ -30,11 +30,9 @@
 De volgende <code>group_id</code> namen zijn gedefinieerd:
 </para>
 <orderedlist>
-<listitem><para>brewery is voor de bms applicatie zelf. Nog uitwerken.</para></listitem>
-<listitem><para>fermenters is voor vergisting controllers.</para></listitem>
-<listitem><para>brewcontrol is een brouw controller. Deze controller kan een deel
-of geheel brouwproces uitvoeren.</para></listitem>
-<listitem><para>pressure is een drukmeter om bijvoorbeeld hergisting op de fles
+<listitem><para><code>brewery</code> is voor de bms applicatie zelf. Nog uitwerken.</para></listitem>
+<listitem><para><code>fermenters</code> is voor vergisting controllers.</para></listitem>
+<listitem><para><code>co2meters</code> is een drukmeter om bijvoorbeeld hergisting op de fles
 te monitoren.</para></listitem>
 </orderedlist>
 
@@ -79,10 +77,11 @@
 <title>Netwerk payload formaat voor een node</title>
 <para>
 De payload zoals die door een node verstuurd wordt. Het wordt in json formaat
-verzonder zonder extra spaties en opmaak zoals hieronder is te zien. Het timestamp
-is de unix tijd sinds 1 januari 1970. Het `seq' nummer wordt met ieder bericht met 1
-verhoogd.</para>
-
+verzonden zonder extra spaties en opmaak zoals hieronder is te zien. Het timestamp
+is de unix tijd sinds 1 januari 1970. Niet alle controllers sturen een timestamp,
+controllers zonder klok laten dit weg. De tijd wordt dan door <code>bmsd</code>
+ingevuld en is de tijd dat het bericht ontvangen wordt.
+Het `seq' nummer wordt met ieder bericht met 1 verhoogd.</para>
 <programlisting>
 {
   "timestamp": 1532201089,
@@ -319,25 +318,52 @@
 De bestandsnamen zijn <code>product_code\ product_name.log</code>.
 Het interne formaat is:</para>
 <programlisting>
-   2014-11-15 18:39,BEER,PRIMARY,20.312,19.750,-1.500,20.5,18.6,18.8,35,12345,0,67890,Whatsup,Fermenter
-            |         |     |      |      |      |      |    |    |   |   |   |   |      |        |
- 0 datetime +         |     |      |      |      |      |    |    |   |   |   |   |      |        |
- 1 werkwijze ---------+     |      |      |      |      |    |    |   |   |   |   |      |        |
- 2 vergisting fase ---------+      |      |      |      |    |    |   |   |   |   |      |        |
- 3 temperatuur lucht --------------+      |      |      |    |    |   |   |   |   |      |        |
- 4 temperatuur bier ----------------------+      |      |    |    |   |   |   |   |      |        |
- 5 temperatuur koeler ---------------------------+      |    |    |   |   |   |   |      |        |
- 6 temperatuur ruimte ----------------------------------+    |    |   |   |   |   |      |        |
- 7 instelwaarde laag ----------------------------------------+    |   |   |   |   |      |        |
- 8 instelwaarde hoog ---------------------------------------------+   |   |   |   |      |        |
- 9 verwarming vermogen -----------------------------------------------+   |   |   |      |        |
-10 verwarming verbruik ---------------------------------------------------+   |   |      |        |
-11 koeler vermogen -----------------------------------------------------------+   |      |        |
-12 koeler verbruik ---------------------------------------------------------------+      |        |
-13 gebeurtenis --------------------------------------------------------------------------+        |
-14 vergister uuid --------------------------------------------------------------------------------+
+   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
+            |            |     |      |      |      |      |    |    |   |   |   |   |      |        |
+ 0 datetime +            |     |      |      |      |      |    |    |   |   |   |   |      |        |
+ 1 werkwijze ------------+     |      |      |      |      |    |    |   |   |   |   |      |        |
+ 2 vergisting fase ------------+      |      |      |      |    |    |   |   |   |   |      |        |
+ 3 temperatuur lucht -----------------+      |      |      |    |    |   |   |   |   |      |        |
+ 4 temperatuur bier -------------------------+      |      |    |    |   |   |   |   |      |        |
+ 5 temperatuur koeler ------------------------------+      |    |    |   |   |   |   |      |        |
+ 6 temperatuur ruimte -------------------------------------+    |    |   |   |   |   |      |        |
+ 7 instelwaarde laag -------------------------------------------+    |   |   |   |   |      |        |
+ 8 instelwaarde hoog ------------------------------------------------+   |   |   |   |      |        |
+ 9 verwarming vermogen --------------------------------------------------+   |   |   |      |        |
+10 verwarming verbruik ------------------------------------------------------+   |   |      |        |
+11 koeler vermogen --------------------------------------------------------------+   |      |        |
+12 koeler verbruik ------------------------------------------------------------------+      |        |
+13 gebeurtenis -----------------------------------------------------------------------------+        |
+14 vergister uuid -----------------------------------------------------------------------------------+
 </programlisting>
 </sect1>
 
+<sect1 id="payloadco2log">
+<title>Netwerk payload log formaat voor CO2 meters.</title>
+<para>
+Voor iedere actieve CO2 meter wordt bij iedere systeemstart een logbericht
+gestuurd. Dit is ongeveer iedere 5 minuten. Omdat de CO2 meters eenvoudige
+controllers zijn is er geen tijd en product informatie beschikbaar. Deze
+ontbrekende gegevens worden aangevuld door <command>bmsd</command>
+</para>
+<programlisting>
+
+</programlisting>
+<para>
+De ontvangen CO2 log gegevens worden niet opgeslagen in de SQL database
+maar in platte tekst bestanden. Hierdoor is de gelogde informatie sneller toegankelijk.
+Ieder brouw product heeft zijn eigen bestand.
+De bestanden staan in <code>www/logs/co2pressure/</code>.
+De bestandsnamen zijn <code>product_code\ product_name.log</code>.
+Het interne formaat is:</para>
+<programlisting>
+   2019-10-11 16:13:33,22.250,5.964,c0ffeeee-dead-beef-caf0-3c71bffe4054
+            |            |      |                  |
+ 0 datetime +            |      |                  |
+ 1 temperatuur ----------+      |                  |
+ 2 CO2 flesdruk in bar ---------+                  |
+ 3 meter uuid -------------------------------------+
+</programlisting>
+</sect1>
 
 </chapter>

mercurial