doc/bms-ch8.sgml

changeset 568
6f3c24e21deb
parent 530
a7430eee20bd
child 579
1253a237b620
--- a/doc/bms-ch8.sgml	Fri Dec 13 16:49:50 2019 +0100
+++ b/doc/bms-ch8.sgml	Fri Dec 13 20:33:38 2019 +0100
@@ -34,6 +34,8 @@
 <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>
+<listitem><para><code>ispindels</code> is een electronische hydrometer die in het gistvat drijft
+en de temperatuur en sg verstuurt.</para></listitem>
 </orderedlist>
 
 <para>De volgende <code>message_type</code> namen zijn gedefinieerd:</para>
@@ -366,4 +368,49 @@
 </programlisting>
 </sect1>
 
+
+<sect1 id="ispindellog">
+<title>Netwerk payload formaat voor de iSpindels.</title>
+<para>
+De iSpindel is een extern project en verstuurd een afwijkend en simpel
+formaat van MQTT berichten. De berichten die verstuurd worden met iedere
+update zien er als volgt uit:
+</para>
+<programlisting>
+ ispindel/&lt;node&gt;/tilt Tilt
+ ispindel/&lt;node&gt;/temperature 20.1250
+ ispindel/&lt;node&gt;/temp_units C
+ ispindel/&lt;node&gt;/battery Volt
+ ispindel/&lt;node&gt;/gravity Gravity
+ ispindel/&lt;node&gt;/interval 900
+ ispindel/&lt;node&gt;/RSSI WiFi.RSSI()
+</programlisting>
+<para>
+Voor iedere actieve iSpindel wordt bij iedere systeemstart een bericht
+gestuurd. Dit is ongeveer iedere 15 minuten. Omdat de iSpindel eenvoudige
+controllers zijn is er geen tijd en product informatie beschikbaar. Deze
+ontbrekende gegevens worden aangevuld door <command>bmsd</command>
+</para>
+
+<para>
+De ontvangen iSpindel 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/ispindel/</code>.
+De bestandsnamen zijn <code>product_code\ product_name.log</code>.
+Het interne formaat is:</para>
+<programlisting>
+   2019-10-11 16:13:33,70.12,22.250,3.576,1.032,900,-45
+            |            |      |     |     |    |   |
+ 0 datetime +            |      |     |     |    |   |
+ 1 tilt -----------------+      |     |     |    |   |
+ 2 temperatuur -----------------+     |     |    |   |
+ 3 batterij spanning -----------------+     |    |   |
+ 4 densiteit -------------------------------+    |   |
+ 5 interval -------------------------------------+   |
+ 6 rssi ---------------------------------------------+
+</programlisting>
+</sect1>
+
+
 </chapter>

mercurial