doc/bms-ch3.sgml

changeset 325
9a8c650972ca
parent 0
033898178630
child 334
26c6f8e5d58e
--- a/doc/bms-ch3.sgml	Wed Mar 06 20:15:24 2019 +0100
+++ b/doc/bms-ch3.sgml	Fri Mar 08 11:31:06 2019 +0100
@@ -50,10 +50,13 @@
 is.</para></listitem>
 <listitem><para>NDEATH wordt verstuurd als een node offline gaat. Maar het kan ook
 ontvangen worden als de MQTT verbinding verbroken wordt met een node, het NDEATH
-bericht is ook het `last will' bericht van een node.</para></listitem>
-<listitem><para>NCMD uitwerken.</para></listitem>
+bericht is ook het `last will' bericht van een node. Maar als het echt fout gaat
+dan zal er mogenlijk nooit een NDEATH bericht gezien worden.</para></listitem>
+<listitem><para>NCMD is een commando bestemd voor een node.
+Dit kan bijvoorbeeld een reboot commando zijn.</para></listitem>
 <listitem><para>DBIRTH is een of meer berichten van een apparaat wat online komt
-en ingeschakeld is. Bij het opstarten van de node is er geen <code>device_id</code>
+en ingeschakeld is. Een apparaat is een deel van een node.
+Bij het opstarten van de node is er geen <code>device_id</code>
 omdat alle apparaten is een keer verstuurd worden. Indien er later een enkel apparaat
 ingeschakeld wordt dan is er wel een geldige <code>device_id</code> aanwezig.
 Hier ook weer, er is een payload bij opstarten en geen payload bij afsluiten om het
@@ -64,7 +67,8 @@
 uitgeschakelt wordt.</para></listitem>
 <listitem><para>DLOG is een data log. Hier bestaat de payload uit gegevens die de
 bms applicatie in de database zet.</para></listitem>
-<listitem><para>DCMD uitwerken.</para></listitem>
+<listitem><para>DCMD is een commando voor een apparaat wat op een node geinstalleerd is.
+Dit zullen voornamelijk instellingen voor dat enkele apparaat zijn.</para></listitem>
 </orderedlist>
 
 </sect1>
@@ -121,7 +125,11 @@
     "Node Control/Reboot":true
   }
 }
-
+</programlisting>
+<para>Dit commando reboot niet de computer maar de applicatie die op een
+computer zoals een Raspberry Pi geinstalleerd is. Een uitzondering zijn de
+controllers zoals Arduino's en andere eenvoudige systemen.</para>
+<programlisting>
 {
   "timestamp":1532201089,
   "metric": {
@@ -129,6 +137,10 @@
   }
 }
 </programlisting>
+<para>Dit commando zorgt er voor dat alle NBIRTH en DBIRTH berichten opnieuw
+verzonden worden alsof de computer net is opgestart. Dit kan nuttig zijn na
+een herstart van de bms applicatie zelf zodat de juiste nodes informatie weer
+beschikbaar is.</para>
 </sect1>
 
 <sect1 id="payloadfermdata">

mercurial