04 · Premiers pas avec STD
Les premières lectures d'un module STD sur I²C et sur Modbus RTU. Les adresses de registres sont des pointeurs I²C sur 16 bits ; les adresses Modbus sont données entre crochets. Les déroulés complets figurent dans la référence des séquences.
0. Choisir le transport
Réglez le commutateur de mode d'interface à 3 positions avant la mise sous tension : Modbus RTU (paramètres série enregistrés), Modbus par défaut (Modbus RTU en 9600 8N1, identifiant d'unité 1) ou I²C. Le commutateur n'est lu qu'au démarrage ; un changement prend donc effet après un redémarrage. Voir Matériel.
1. Identifier le module
Lisez 12 octets à 0x0000 en une seule transaction (I²C : écrivez le pointeur 16 bits 0x0000, puis lisez 12 octets) :
| Décalage | Champ | Attendu |
|---|---|---|
| 0x0000 | ID (2 octets) |
'S', 'T' |
| 0x0002 | ERROR |
résultat de la dernière commande |
| 0x0003 | VERSION |
0x36 ou plus |
| 0x0004 | CAPABILITIES (u16) |
bit 9 (adressage 16 bits) activé ; bit 8 (banques d'instantanés) activé lorsque le module en possède |
| 0x0006 | STATUS |
bit 1 capteur ok, bit 2 réseau ok |
| 0x0007 / 0x0008 | N_VOLTAGE / N_CURRENT |
STD-UI1 : 1 / 1 · STD-U3I3 : 3 / 3 |
| 0x0009 | VARIANT |
0x11 STD-UI1 · 0x63 STD-U3I3 |
| 0x000A | HW_REV |
révision matérielle |
La disposition exacte des octets est décrite dans Identité et découverte. Déterminez ce que le module peut faire à partir de N_VOLTAGE, N_CURRENT et des bits CAPABILITIES — jamais à partir de codes de variante codés en dur.
Lisez ensuite l'UID unique (0x00F4, 12 octets) pour votre base de données, et la version du micrologiciel FW_VER (0x0114, u32) : le mot de poids fort et le mot de poids faible en décimal donnent la version, par exemple 0x0001007E = micrologiciel STD 1.126.
2. Attendre les données en direct
Après la mise sous tension, prévoyez environ une seconde : WIN_SEQ (0x0016) doit être non nul et évoluer, et le bit 1 de STATUS (capteur ok) doit être activé. Voir disponibilité au démarrage.
3. Premières lectures (I²C)
Lisez les blocs temps réel en une transaction chacun (jusqu'à 128 octets, cohérents) :
- canal de tension v : base
0x0200 + v·0x20— tension efficace ; - canal de courant c : base
0x1000 + c·0x40— courant, P, Q, S, PF ; - totaux :
0x0300 + k·0x40—k = 0total général,k = 1..3par phase ; - fréquence
FREQ(0x0010, cHz).
Les dispositions complètes des blocs figurent dans la table de registres. Les valeurs sont des entiers à échelle fixe : tension en mV, courant en µA, puissance en mW / mvar / mVA.
4. Premières lectures (Modbus RTU)
Valeurs par défaut : unité 1, 9600 8N1. Le bloc de découverte est lisible en registres d'entrée à partir de 0x6000 (magic, version de carte, capacités, nombre de canaux, variante, UID). Les valeurs en direct sont dans le profil natif (entrée 0x6000+) ou, pour un onduleur ou un SCADA, dans le profil float32 (entrée 0x0000 : tension, courant et puissance par phase, puissance totale, fréquence, énergie importée et exportée). Détails : Transport Modbus.
5. Régler l'heure (facultatif mais recommandé)
Les modules ne conservent pas d'horloge sur pile. Les compteurs s'accumulent sans elle ; les enregistrements d'historique horaire ne sont écrits qu'après le réglage de l'heure. Réglez l'heure en faisant écrire par le maître l'epoch dans TIME_SET (0x08C0) puis émettre la commande 0x06. Faites-le à la découverte et chaque fois que le bit 4 de STATUS (heure valide) se lit 0 après un redémarrage.
Dans les bibliothèques clientes
Les bibliothèques font tout ce qui précède dans begin() et exposent les mêmes appels de lecture sur les modules STD et BASIC ; voir Exemples. Sur un module avec banques d'instantanés et compteurs d'énergie, utilisez Arduino 1.6.2 ou ultérieure ou ESP-IDF 1.7.3 ou ultérieure.