doc/bms-ch8.sgml

changeset 847
dc9281501ca6
parent 720
b6a616372a26
child 851
b15fa90a9af5
--- a/doc/bms-ch8.sgml	Sun Mar 05 12:44:33 2023 +0100
+++ b/doc/bms-ch8.sgml	Sat Aug 19 15:11:35 2023 +0200
@@ -52,8 +52,10 @@
 <listitem><para>NCMD is een commando bestemd voor een node.
 Dit kan bijvoorbeeld een reboot commando zijn.</para></listitem>
 <listitem><para>NDATA wordt verstuurd als er veranderingen zijn voor de node,
-maar ook iedere vijf minuten om aan te geven dat de node nog "levend" en aanwezig
-is.</para></listitem>
+maar ook regelmatig om aan te geven dat de node nog "levend" en aanwezig
+is. Deze tijd is voor ieder node type verschillend. Indien twee maal de ingestelde
+tijd plus enkele seconden geen NDATA bericht is gezien dan wordt de node als
+offline beschouwd. Indien deze waarde niet aanwezig is wordt 300 seconden aangehouden.</para></listitem>
 
 <listitem><para>DBIRTH is een of meer berichten van een apparaat wat online komt
 en ingeschakeld is. Een apparaat is een deel van een node.
@@ -85,14 +87,20 @@
 ingevuld en is de tijd dat het bericht ontvangen wordt.
 Het `seq' nummer wordt met ieder bericht met 1 verhoogd.
 Ook dit nummer is niet altijd aanwezig.</para>
+<para>Deze payload wordt verstuurd als een node start, <code>message_type NBIRTH</code>.
+Het wordt ook vertuurd als er iets wijzigd, bijvoorbeeld de temperatuur en op vaste
+intervals. In die gevallen is het <code>message_type NDATA</code>.</para>
 <para>In de `metric' groep is de `interval' optioneel. Dit wordt bijvoorbeeld
 verstuurd door iSpindels en is de ingestelde update interval tijd in seconden.
 Indien dit niet aanwezig is dan wordt 300 seconden als standaard waarde gebruikt.
 Deze waarde wordt gebruikt om een apparaat als offline te markeren indien het langer
 als twee maal deze tijd niet wordt gezien.</para>
+<para>Alle object groepen binnen het metric object kunnen maar hoeven niet aanwezig te zijn.
+Dit geld ook voor de diverse items in de groepen.</para>
 <programlisting>
 {
   "timestamp": 1532201089,
+  "sec": 1234,
   "metric": {
     "uuid": "b508f01c-1f82-4e8b-b0d2-d88ecfb53031",
     "interval":300,

mercurial