04 · Primi passi con STD
Le prime letture da un modulo STD su I²C e su Modbus RTU. Gli indirizzi dei registri sono puntatori I²C a 16 bit; gli indirizzi Modbus sono riportati tra parentesi. I flussi completi sono nel riferimento delle sequenze.
0. Selezionare il trasporto
Impostare lo switch a 3 posizioni della modalità d'interfaccia prima dell'accensione: Modbus RTU (impostazioni seriali salvate), Modbus predefinito (Modbus RTU a 9600 8N1, id unità 1) oppure I²C. Lo switch viene letto solo all'avvio, quindi una modifica ha effetto dopo un riavvio. Vedere Hardware.
1. Identificare il modulo
Leggere 12 byte a 0x0000 in una sola transazione (I²C: scrivere il puntatore a 16 bit 0x0000, poi leggere 12 byte):
| Offset | Campo | Atteso |
|---|---|---|
| 0x0000 | ID (2 byte) |
'S', 'T' |
| 0x0002 | ERROR |
risultato dell'ultimo comando |
| 0x0003 | VERSION |
0x36 o superiore |
| 0x0004 | CAPABILITIES (u16) |
bit 9 (indirizzamento a 16 bit) impostato; bit 8 (banchi di istantanee) impostato quando il modulo li ha |
| 0x0006 | STATUS |
bit 1 sensore ok, bit 2 rete 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 |
revisione hardware |
Il formato esatto dei byte è in Identità e rilevamento. Stabilire cosa può fare il modulo da N_VOLTAGE, N_CURRENT e dai bit CAPABILITIES — mai da codici di variante codificati fissi.
Quindi leggere l'UID univoco (0x00F4, 12 byte) per il proprio database e la versione del firmware FW_VER (0x0114, u32): parola alta e parola bassa in decimale danno la versione, per esempio 0x0001007E = firmware STD 1.126.
2. Attendere i dati in tempo reale
Dopo l'accensione attendere circa un secondo: WIN_SEQ (0x0016) deve essere diverso da zero e avanzare, e il bit 1 di STATUS (sensore ok) deve essere impostato. Vedere prontezza all'avvio.
3. Prime letture (I²C)
Leggere i blocchi in tempo reale, una transazione per blocco (fino a 128 byte, coerente):
- canale di tensione v: base
0x0200 + v·0x20— tensione RMS; - canale di corrente c: base
0x1000 + c·0x40— corrente, P, Q, S, PF; - totali:
0x0300 + k·0x40—k = 0totale generale,k = 1..3per fase; - frequenza
FREQ(0x0010, cHz).
Le strutture complete dei blocchi sono nella mappa dei registri. I valori sono interi a scala fissa: tensione in mV, corrente in µA, potenza in mW / mvar / mVA.
4. Prime letture (Modbus RTU)
Predefiniti: unit 1, 9600 8N1. Il blocco di rilevamento è leggibile come registri di input da 0x6000 (magic, versione della mappa, capacità, numero di canali, variante, UID). I valori in tempo reale sono nel profilo nativo (input 0x6000+) oppure, per un inverter o un SCADA, nel profilo float32 (input 0x0000: tensione, corrente e potenza per fase, potenza totale, frequenza, energia importata ed esportata). Dettagli: Trasporto Modbus.
5. Impostare l'ora (facoltativo ma consigliato)
I moduli non conservano un orologio a batteria. I contatori si accumulano senza di esso; i record dello storico orario vengono scritti solo dopo l'impostazione dell'ora. Impostare l'ora facendo scrivere al master l'epoch in TIME_SET (0x08C0) ed emettere il comando 0x06. Farlo alla rilevazione e ogni volta che il bit 4 di STATUS (ora valida) risulta 0 dopo un riavvio.
Nelle librerie client
Le librerie fanno tutto quanto sopra in begin() ed espongono le stesse letture sui moduli STD e BASIC; vedere Esempi. Su un modulo con banchi di snapshot e contatori di energia usare Arduino 1.6.2 o successiva oppure ESP-IDF 1.7.3 o successiva.