krkrkr

doc/dd2-monitoring.tex

@@ -58,7 +58,8 @@ Actuellement nous disposons d'un \texttt{RDing TEMPERHUM1V1.2}{} qui
 semble un peu étrange à interpeller, et qui sera destiné à mesurer
 l'ambiance météo du DD2\footnote{Pas de mauvais esprit, merci...}.
 
-Par la suite, nous pourrons récupérer (par liaison série ?) des données
+Par la suite, nous pourrons récupérer (par liaison série, cf p. \pageref{serial})
+des données
 en provenance de l'automate de contrôle de l'enceinte. Notre dd2monitor
 devrait donc aussi être capable d'envoyer des alertes en cas de souci,
 par exemple si des algues\footnote{ou des pleurotes.} tentent de s'échapper.
@@ -115,7 +116,7 @@ documents bourbakistes ?
 Première tentative d'utilisation le lendemain du premier apéro 2019
 du Tetalab\footnote{Jean-Yves, je vous demande de vous calmer !}.
 
-Je suis parti sur trois scripts shell, pour créer, mettre à jour et
+Je suis parti sur quelques scripts shell, pour créer, mettre à jour et
 analyser les enregistrements d'une valeur de type \textsc{gauge}.
 
 \subsection{Create}
@@ -123,7 +124,6 @@ analyser les enregistrements d'une valeur de type \textsc{gauge}.
 #!/bin/bash
 
 source ./commun.sh
-
 starttime=$(date +'%s')
 echo creating $RRDB at ${starttime}s since epoch
 rrdtool	create $RRDB			\
@@ -133,8 +133,10 @@ rrdtool	create $RRDB			\
 	RRA:AVERAGE:0.5:1:60
 \end{lstlisting}
 
-\subsection{Update}
+\subsection{Update} \index{rrdtool}
-\index{rrdtool}
+
+Une fois la base créée, il faut bien la remplir.
+
 \begin{lstlisting}
 #!/bin/bash
 
@@ -147,12 +149,15 @@ rrdtool	update $RRDB ${ctime}:${value}
 \end{lstlisting}
 
 \subsection{Analyze}
+
+Nous allons essayer d'exploiter les données dûrement acquises
+pendant les heures qui précèdent\dots
+
 \begin{lstlisting}
 #!/bin/bash
 
 source ./commun.sh
 tmpf="somevalues.dat"
-
 rrdtool fetch $RRDB LAST			|
 tr -d ':'					|
 awk	'
@@ -171,7 +176,8 @@ __EOC__
 rm ${tmpf}
 \end{lstlisting}
 
-
+Il semble bien que l'utilisation de \texttt{fetch} ne soit pas
+vraiment prévue pour ça...
 
 % -------------------------------------------------------------------
 
@@ -186,7 +192,7 @@ plus ou moins l'exemple de rrdb..
 
 % -------------------------------------------------------------------
 
-\section{Serial coms} \index{serial}
+\section{Serial coms} \index{serial} \label{serial}
 
 Il va y avoir deux liaisons série entre l'automate et le monitoring.
 La première, que nous allons juste entrevoir, passera par le port
@@ -205,7 +211,8 @@ tcsetattr(uart0, TCSANOW, &options);
 
 Et en fait, le \texttt{read} sur le \textsl{fd} du serial device
 n'est pas bloquant, \texttt{perror} annonce \emph{success}, mais
-rien ne marche. L'année 2019 va commencer sur du vaudou programming.
+rien ne marche. L'année 2019 va commencer sur du vaudou programming%
+\footnote {aka shotgun debugging.}.
 
 \textit{29 décembre 2018} : le petit grain de magie\index{magie}
 est très simple à mettre en oeuvre, mais
@@ -215,7 +222,7 @@ l'étape suivante.
 
 Laquelle étape est une tentative d'utilisation de \texttt{select(2)},
 dans l'objectif de pouvoir gérer nous-même le \textit{timeout},
-qui n'est pas du tout concluante. 
+laquelle tentative n'est pas du tout concluante. 
 
 % -------------------------------------------------------------------