rbAmp
FR
Boutique
Docs
Mis à jour le

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 = 0 total général, k = 1..3 par 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.

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.