Some doc

content/etalonnage-mono.md

@@ -12,11 +12,14 @@ Le taux du flux d'impulsions pour le matériel en cours de test peut être ajust
 
 ## {term}`CT` *grille/réseau*
 
-Lors de l'étalonnage d'un nouvel ensemble de matériel, la première étape consiste à étalonner le canal **CT1**. À cette fin, le matériel en cours de test doit exécuter le programme cal_CT1_v_meter.ino, qui est disponible sur la page de téléchargements.
+Lors de l'étalonnage d'un nouvel ensemble de matériel, la première étape consiste à étalonner le canal **CT1**. À cette fin, le matériel en cours de test doit exécuter le programme ```cal_CT1_v_meter.ino```, qui est disponible sur la page de téléchargements.
 
-Pour chaque unité d'énergie mesurée au point de connexion au réseau via **CT1**, une impulsion sera générée au port de sortie. Le taux des impulsions peut être modifié en changeant la valeur de powerCal_grid. Un flux d'impulsions similaire sera visible au compteur.
+Pour chaque unité d'énergie mesurée au point de connexion au réseau via **CT1**, une impulsion sera générée au port de sortie.  
+Le taux des impulsions peut être modifié en changeant la valeur de ```powerCal_grid```. Un flux d'impulsions similaire sera visible au compteur.
 
-Pour avancer un flux d'impulsions par rapport à l'autre, un second chemin pour le courant devra passer à travers **CT1**. La puissance consommée par n'importe quel petit appareil fera l'affaire — un seul de ses cœurs actifs doit passer à travers **CT1** — et le courant peut circuler dans les deux sens. Lorsque l'appareil est éteint, le fil supplémentaire n'aura aucun effet sur les performances du CT, car aucun courant ne le traverse.
+Pour avancer un flux d'impulsions par rapport à l'autre, un second chemin pour le courant devra passer à travers **CT1**.  
+La puissance consommée par n'importe quel petit appareil fera l'affaire — un seul de ses cœurs actifs doit passer à travers **CT1** — et le courant peut circuler dans les deux sens.  
+Lorsque l'appareil est éteint, le fil supplémentaire n'aura aucun effet sur les performances du CT, car aucun courant ne le traverse.
 
 Lorsque la valeur correcte a été trouvée pour ```powerCal_grid```, cette même valeur peut être utilisée avec n'importe quel croquis de routeur Mk2PVRouter qui doit être exécuté sur le **même matériel**.
 

content/etalonnage-tri.md

@@ -21,4 +21,85 @@ Ensemble des composants constituants la prise de mesure. Elle part de l'Arduino
 Les pinces doivent être installées sur chaque phase correspondante par rapport à l'alimentation du routeur.
 ```
 
-## {term}`CT`s *grille/réseau*
+## Principe de base
+Cet étalonnage peut être réalisé selon plusieurs méthodes, selon que l'on possède ou non certains appareils de mesure (ampèremètre, wattmètre, voltmètre).
+
+Pour simplifier la procédure, peu importe la méthode utilisée, il faudra veiller, si possible, à avoir une consommation constante pendant la phase d'étalonnage (brancher par exemple un radiateur électrique, une bouilloire, et débrancher tout le reste, y compris votre/vos système·s de production d'électricité).  
+L'utilisation d'un appareil purement résistif, donc sans ventilateur ni autre chose qu'une résistance, simplifiera grandement l'étalonnage.
+
+## Méthode avec le compteur de distribution
+Cette méthode ne nécessite aucun appareil de mesure, mais n'est pas la plus rapide à réaliser.
+
+### À l'aide des flash du compteur (1 flash = 1Wh consommé)
+La plupart des compteurs génèrent un flux d'impulsions optiques pour montrer le taux auquel l'énergie est consommée. En installant un {term}`CT` autour de l'un des câbles d'alimentation entrants et en exécutant le logiciel approprié sur le matériel testé, un flux similaire d'impulsions optiques peut être généré.
+
+Le débit du flux d'impulsions pour le matériel testé peut être ajusté en modifiant la valeur ```f_powerCal``` correspondante. Lorsque les deux flux d'impulsions sont synchronisés, un étalonnage correct a été réalisé.
+
+Il faudra aller par tâtonnement. Si le flash du routeur est plus rapide que celui du compteur, il faut diminuer ```f_powerCal``` sinon l'augmenter.
+
+### À l'aide de l'affichage du compteur (plus simple et plus rapide)
+Il est possible également de relever la consommation affichée par le compteur sur la phase en cours d'étalonnage.  
+Il faudra alors faire correspondre la puissance affichée par le routeur dans le Moniteur Série de l'Arduino IDE avec celle affichée par le compteur.  
+D'où l'intérêt de ne pas avoir d'appareils qui vont se mettre en route sporadiquement (réfrigérateur, …).
+
+L'affichage dans le Moniteur Série se présente de comme ceci :
+```
+1797.67, P:-21, P1:368, P2:-113, P3:-276, V1:233.24, V2:233.82, V3:233.84, (minSampleSets/MC 32, #ofSampleSets 8014)
+1793.61, P:-18, P1:367, P2:-110, P3:-275, V1:233.46, V2:233.93, V3:233.99, (minSampleSets/MC 32, #ofSampleSets 8013)  
+1780.56, P:-18, P1:374, P2:-116, P3:-276, V1:233.09, V2:233.53, V3:233.67, (minSampleSets/MC 32, #ofSampleSets 8014)  
+1804.21, P:-24, P1:371, P2:-118, P3:-277, V1:233.04, V2:233.48, V3:233.55, (minSampleSets/MC 32, #ofSampleSets 8015)
+```
+
+```P1```, ```P2```, ```P3``` représentent les puissances moyennées sur 5 secondes sur chaque phase. ```P``` est la puissance totale moyenne totale sur 5 secondes.  
+Si j'étalonne la phase **L1**, alors **P1** devra afficher la même valeur que celle affichée par le compteur pour cette même phase.
+
+```{Hint}
+Les numéros de phase sont purement arbitraires, la phase **L1** du routeur correspondant à la phase branchée sur le connecteur **L1**, mais ce n'est pas forcément la phase branchée sur le bornier **L1** du compteur.
+```
+
+#### Comment trouver le bon ```f_powerCal``` du premier coup
+Avant de télécharger le sketch d'étalonnage, je veille à définir les valeurs comme ceci :
+```cpp
+constexpr float f_powerCal[NO_OF_PHASES]{0.05000f, 0.05000f, 0.05000f};
+```
+
+Supposons que le compteur affiche **2250**, et que le log du routeur affiche **2000**.
+On aura alors :
+```{math}
+f_{powerCal} = {0.05000 * 2250} \over 2000 = 0.05625
+```
+
+En triphasé, il faudra répéter l'opération sur chacune des phases.
+Une ligne de mesure comprend TOUS les composants en partant de la pince jusqu'au convertisseur analogique du microcontrôleur.
+
+```{Important}
+Chaque pince devra alors être marquée pour savoir à quelle ligne elle correspond.
+```
+
+#### Méthode avec un appareil de mesure annexe
+Cette méthode nécessite un appareil de mesure, type wattmètre ou un autre compteur.
+
+```{danger}
+**ALERTE SÉCURITÉ**  
+Potentiellement, selon l'appareil utilisé, il faudra modifier le câblage électrique. Avant toutes manipulations, il est impératif de couper l'alimentation au tableau électrique et de vérifier à l'aide d'un testeur de tension l’absence effective de tension.
+Dans le doute, couper le disjoncteur principal.
+```
+
+Pour cette méthode, le simple sera d'utiliser le chauffe-eau lui-même comme appareil d'étalonnage. Sur le même principe que la première méthode, on va brancher l'appareil de mesure sur la ligne du chauffe-eau ainsi que l'une des pinces du routeur.
+
+```{attention}
+La phase doit correspondre. Si j'étalonne la phase **L1**, le chauffe-eau DOIT être branché sur **L1** et la pince du routeur DOIT être celle qui correspond à la phase **L1**.
+```
+
+Selon que l'appareil affiche une puissance instantanée ou produit des flashs tous les Wh consommés, on appliquera la première méthode.
+
+```{admonition} Chauffe-eau triphasé
+Dans cette situation, on déplacera l'appareil de mesure sur chacune des phases, et on prendra la pince du routeur associée à la bonne phase. Il ne sera pas nécessaire de décâbler le chauffe-eau.
+```
+
+Comme précédemment, il faudra répéter l'opération sur chacune des phases (décâbler le chauffe-eau sur une autre phase, …).
+Une ligne de mesure comprend TOUS les composants en partant de la pince jusqu'au convertisseur analogique du microcontrôleur.
+
+```{Important}
+Chaque pince devra alors être marquée pour savoir à quelle ligne elle correspond.
+```