Update document

1 files changed, 28 insertions, 25 deletions

diff --git a/notes_arduino.rst b/notes_arduino.rst
index d0d30db..9028efe 100644
--- a/notes_arduino.rst
+++ b/notes_arduino.rst
@@ -401,16 +401,16 @@ sur chacun de ses ports, en envoyant une valeur comprise entre `0` et `255`.
 Générer du son
 ==============
 
+Avec un piezzo buzzer il est possible d'ajouter une sortie sonore au programme.
+Ceux que l'on trouve dans le commerce supportent une tension allant de 3 à
+24 |V|, ce qui permet de brancher le buzzer directement en sortie de la carte.
+
 .. sidebar:: Un piezzo buzzer
 
   .. image:: content/piezzo_buzzer.jpg
     :align: center
     :width: 100%
 
-Avec un piezzo buzzer il est possible d'ajouter une sortie sonore au programme.
-Ceux que l'on trouve dans le commerce supportent une tension allant de 3 à
-24 |V|, ce qui permet de brancher le buzzer directement en sortie de la carte.
-
 Le composant permet de produire du son en fonction de la fréquence du signal de
 sortie.
 
@@ -604,8 +604,8 @@ Tension 1A  Tension 2A  Résultat
 `HIGH`      `HIGH`      Arrêt du moteur (frein électromagnétique)
 =========== =========== =============================================
 
-Voir le schéma de branchement avec deux moteurs contrôlés depuis la carte
-Arduino.
+Le schéma :raw-latex:`\ref{fig:arduino_l293d}` présente le branchement de deux
+moteurs contrôlés depuis la carte Arduino.
 
 .. figure:: content/arduino_l293d.pdf
   :width: 100%
@@ -619,9 +619,8 @@ Arduino.
   :Cable vert:  Marche arrière
   :Cable orange: Puissance du moteur
 
-.. raw:: latex
+  :raw-latex:`\label{fig:arduino_l293d}`
 
-  \pagebreak
 
 Programme
 ---------
@@ -904,10 +903,10 @@ nous obtenons :
 Contrôle théorique
 ~~~~~~~~~~~~~~~~~~
 
-Ce programme en python permet de prédire les différentes valeurs qui seront
-lues par la carte Arduino. Il reproduit (dans une certaine mesure) les erreurs
-d'arrondis qui seront susceptible d'arriver sur la carte lors du calcul des
-valeurs :
+Le programme :raw-latex:`\ref{prg:ohmPython}` permet de prédire les différentes
+valeurs qui seront lues par la carte Arduino. Il reproduit (dans une certaine
+mesure) les erreurs d'arrondis qui seront susceptible d'arriver sur la carte
+lors du calcul des valeurs.
 
 .. sidebar:: Programme
 
@@ -918,14 +917,11 @@ valeurs :
 .. admonition:: Simulateur en python
   :class: floatprogram
 
+  :raw-latex:`\label{prg:ohmPython}`
+
     .. include:: content/ohm.py
       :code: python
 
-.. raw:: latex
-
-  \pagebreak
-
-
 Il permet de construire le tableau de valeurs suivant (avec :math:`R_2` = 1000
 :math:`\Omega`, et :math:`V_\text{cc}` = 5 |V|) :
 
@@ -968,7 +964,7 @@ Le montage reste simple à mettre en place, il ne nécessite que deux résistanc
   La résistance :math:`R_2` peut être choisie avec une valeur de
   1000 :math:`\Omega` par défaut, et changée en fonction du besoin.
 
-Le programme reprend la formule que nous avons calculé ci-dessus, et affiche le
+Le programme :raw-latex:`\ref{ohmetre}` reprend la formule que nous avons calculé ci-dessus, et affiche le
 résultat sur la console.
 
 .. sidebar:: pinMode
@@ -980,6 +976,8 @@ résultat sur la console.
 .. admonition:: Ohmmètre
   :class: floatprogram
 
+  :raw-latex:`\label{ohmetre}`
+
     .. code-block:: arduino
 
       // La résistance r2 doit être connue et
@@ -1052,23 +1050,25 @@ Le schéma suivant indique comment placer les différents câbles du connecteur
   :Cable Noir: GND/Masse
   :Cable Jaune ou Blanc: Entrée Analogique `A0`
 
-Tension de sortie
-~~~~~~~~~~~~~~~~~
-
 .. sidebar:: Tension d'entrée
 
   Même si le composant supporte une tension allant jusque 7 |V|, il fonctionne de
   manière optimale avec des valeurs allant de 4,5 à 5,5 |V|.
 
 La tension de sortie, sur le fil jaune, nous indique la distance de l'objet.
-Celle-ci varie entre 0,5 |V| et 3 |V| selon la distance de l'obstacle [#]_.
+Celle-ci varie entre 0,5 |V| et 3 |V| selon la distance de l'obstacle (voir le
+schéma :raw-latex:`\ref{fig:gp2y0a21yk_e}` repris de la documentation technique
+du constructeur [#]_).
+
 
 .. [#]  http://www.sharp-world.com/products/device/lineup/data/pdf/datasheet/gp2y0a21yk_e.pdf
 
-.. image:: content/gp2y0a21yk_e.pdf
+.. figure:: content/gp2y0a21yk_e.pdf
   :width: 100%
 
-..  Mesure de la tension en fonction de la distance
+  Mesure de la tension en fonction de la distance
+
+  :raw-latex:`\label{fig:gp2y0a21yk_e}`
 
 Exemple
 ~~~~~~~
@@ -1181,7 +1181,10 @@ Résistance de tirage
 --------------------
 
 On peut imaginer le schéma similaire, en inversant la position du bouton et de
-la résistance.
+la résistance. À ce moment, le courant arrive à la broche dès que
+l'interrupteur est ouvert. Dans le programme, il faut donc considérer que le
+bouton est appuyé quand on lit `DOWN` sur la broche, et le bouton relaché dès
+que l'on lit `HIGH`.
 
 =========================
 L'alimentation du système