Sequenze — flussi di controllo passo-passo
Flussi canonici lato host. Ogni passo indica il registro (indirizzo I²C; Modbus tra parentesi) e che cosa verificare. Le regole di interrogazione dei comandi usate ovunque qui sono definite una volta sola in D2.
D1 — Accensione / rilevamento
-
Leggere 12 byte a 0x0000 in una sola transazione:
ID= 'S','T' ·VERSION≥ 0x36 ·CAPABILITIES(atteso bit 9 impostato; THD bit 2 = 0, bit 8 banchi di istantanee = 1 quando sono presenti i banchi, bit 13 energia on-device = 1) ·STATUS·N_VOLTAGE/N_CURRENT·VARIANT(UI1 0x11 = 1/1, 0x63 = 3/3) ·HW_REV/FW_VERSION. -
Leggere
UID0x00F4 (12 B) — l'identità del dispositivo per il proprio database;FW_VER0x0114 (u32 versione immagine);BOARD_ID0x017C. -
Attendere i dati in tempo reale:
WIN_SEQ(0x0016) ≠ 0 e in avanzamento, bit 1 diSTATUS(sensor_ok) = 1 — attendere ~1 s dopo l'avvio (prontezza all'avvio). -
Se
STATUSbit 4 (time_valid) = 0 → impostare l'orologio (D2, SET_TIME). - Condizione di salute: cal_ok oppure
CAL_SRC(0x0872) ∈ {1, 2};LTA_STATUS(0x0870) ≤ 1. - Riarmare lo stato in RAM:
EVENT_MASK(0x00C1),THRESH_I/P(0x00C4/0x00C8); confermare l'avvio azzerando RESET_OCCURRED — scrivere 0x20 inEVENT_FLAGS(0x00C0).
Modbus: lo stesso insieme di identità è in input 0x6000–0x601F (specchio); FW_VER holding 0x8315–16, BOARD_ID holding 0x831B–1C.
D2 — Esecuzione di un comando
- Controllo di inattività:
CMD_STATE(0x006A; holding 0x8116) bit 0 = 0. -
Scrivere i registri parametro del comando, poi il codice operativo in
COMMAND(0x0060; holding 0x8113 — per un codice operativo Modbus protetto inviare un unico FC16{0x8112 = 0xA5C3, 0x8113 = codice operativo}; eccezione 06 = occupato, eccezione 03 = codice operativo sconosciuto o sblocco mancante). -
Interrogare
CMD_STATEbit 0 → 0. Timeout: ≥ 1 s per comandi semplici e salvataggi · ≥ 0.5 s per la scrittura di pagina di aggiornamento · ≥ 3 s per COMMIT dell'aggiornamento. Su I²C tollerare un clock stretching ≥ 10 ms; ripetere le letture NACKed; non rinviare mai alla cieca una scrittura COMMAND (un duplicato verrebbe scartato come OVERRUN, ma si perde traccia di quale scrittura abbia avuto effetto). -
Leggere
ERROR(0x0002; holding 0x8114) dopo BUSY = 0: 0x00 = OK, codici in Comandi. Facoltativamente verificare cheCMD_SEQ(0x0067) sia avanzato di 1 e che OVERRUN (bit 1) = 0.
Impostazione dell'ora (il comando più comune): scrivere l'epoch u32 LE in TIME_SET 0x08C0 (Modbus FC16 0x8100 = parola alta, 0x8101 = parola bassa — in broadcast è un frame a sé, il comando segue come secondo frame) → COMMAND 0x06 → interrogare → ERROR 0xFC = epoch sotto 1 600 000 000. STATUS bit 4 si imposta subito.
D3 — Configurazione
- Scrivere i registri
CFG_*desiderati (0x0070–0x0085; holding 0x8000–0x800C). -
COMMAND0x04 SAVE_CONFIG (non subordinato a UNLOCK) → D2.ERROR0xFD = valore non valido, nulla salvato · 0xF9 = limite di frequenza, riprovare dopo ~5 s · 0xF6 = errore di I/O dell'archivio. -
Se la modifica richiede un riavvio (indirizzo I²C, unit/baud/frame/ritardo-tx Modbus,
CFG_VIRTUAL_IDS):COMMAND0x02 RESET (protetto da UNLOCK su Modbus; attendersi nessuna risposta o risposta troncata) e interrogare di nuovo il dispositivo dopo ~1 s.
CFG_LED / CFG_WORD_ORDER agiscono alla scrittura ma tornano al valore precedente all'avvio se non salvati. CFG_CLASS, CFG_CT_MODEL, CFG_TZ_OFFSET_MIN, CFG_TIME_AUTH, CFG_ENERGY_PERSIST_S sono metadati memorizzati.
D4 — Modifica di indirizzo / seriale
Indirizzo I²C (dispositivo noto): CFG_I2C_ADDR 0x0073 = 0x08..0x77 → SAVE_CONFIG → BUSY 0 e ERROR 0 → RESET → attendere ~1 s → sondare ID = 'S','T' al nuovo indirizzo.
Seriale Modbus: holding 0x8000 unità (1–247) / 0x8001 baud (0–10) / 0x8002 formato / 0x8003 ritardo TX (validato in scrittura — eccezione 03) → FC06 0x8113 = 0x0004 → interrogare 0x8114 = 0 → FC16 {0x8112 = 0xA5C3, 0x8113 = 0x0002} (la risposta può andare persa) → riconnettersi con le nuove impostazioni.
Tramite UID (più moduli su un indirizzo, entrambi i trasporti):
-
I²C: una scrittura di 0x00E0: UID (12 B) + nuovo indirizzo I²C (0x00EC, oppure 0) + nuova unità Modbus (0x00ED, oppure 0). Modbus: FC16 0x8118–0x811E (coppie di byte UID + 0x811E = indirizzo<<8 | unità) — broadcast consentito.
-
COMMAND0x16 (FC06 0x8113 = 0x0016; broadcast consentito). -
Il modulo corrispondente rende persistenti (insieme a eventuali valori CFG_ in staging) e si riavvia; ogni altro modulo risponde
ERROR0xFC. Entrambi i campi del nuovo indirizzo a 0 o un indirizzo non valido → 0xFD; limite di frequenza di salvataggio → 0xF9. -
Sondare il modulo al nuovo indirizzo/unità; identificarlo tramite UID.
D5 — Energia: lettura, reset, adozione
Lettura (a ogni confine di intervallo, con il vostro orologio):
-
Una transazione I²C ≤ 128 B su 0x0800–0x0843: contatori Wh, contatori mWh,
LT_GEN(istantanea coerente). PiùUPTIME0x08A0. Modbus: input 0x6B00/0x6B14 + holding 0x8140. Bit 15 delle capacità: gli stessi contatori a risoluzione µWh — totale a 0x08D0 (3×i64; input Modbus 0x6BB0), per canale a 0x0C80 + g·0x10 (Modbus 0x6BC0 + g·8) — stessa istantanea dei campi mWh (imp/exp mWh = floor(µWh/1000); netto = imp − exp nella stessa unità), stesse regole di delta/generazione/riavvio. Il modulo pubblica anche l'energia reattiva totale in µvarh a 0x08E8/0x08F0 (Modbus 0x6BAC/0x6BBC, non contigui): la lettura coerente a risoluzione fine è una transazione su 0x08D0–0x08F7 (40 B). -
Energia di intervallo = delta dei contatori mWh (contatori µWh dove si desidera una risoluzione più fine).
LT_GENcambiato → non prendere il delta; ri-ancorare (qualcuno ha azzerato/adottato — vedere il registro eventi).UPTIMEdiminuito → modulo riavviato: delta =max(0, Δ)(possono mancare fino all'ultimo secondo circa di energia), reimpostare l'ora (D2).
Reset (deliberato, registrato): LT_KEY 0x0844 = 0x4C545253 ("LTRS"; Modbus FC16 0x8142–43, prima la parola alta) → immediatamente COMMAND 0x0A (qualsiasi comando consuma la chiave) → D2. ERROR 0xFB = chiave errata/mancante · 0xFA = FAULT dell'archivio. Non serve alcun UNLOCK Modbus — la chiave è la protezione. (Il codice di famiglia 0x07 ENERGY_RESET non è usato: 0xFE / eccezione 03.)
Adozione (scambio scheda / migrazione): mettere in staging 4×i64 in LT_ADOPT 0x0848 (Modbus 0x8144–0x8153) nell'ordine importazione Wh · esportazione Wh · importazione reattiva varh · esportazione reattiva varh → LT_KEY = 0x4C544150 ("LTAP") → COMMAND 0x0B. Valore negativo → 0xFA. Sia reset sia adozione incrementano LT_GEN e finiscono nel registro eventi con valori prima/dopo.
D6 — Storia e registro eventi
-
HIST_PERIOD0x0C00 (holding 0x8160): 0 = ultimi 15 min (alloraHIST_BACKdeve essere 0) · 1 = anello orario · 2 = registro eventi. -
HIST_BACK0x0C04 (holding 0x8163) = n, 0 = più recente. COMMAND0x08 HIST_READ → D2.ERROR0xFC = nessun record.-
In caso di successo: bit 0 di
HIST_FLAGS0x0C02 = 1; leggereHIST_COUNT/HIST_RECSZ(80 storico / 32 eventi) /HIST_OLDEST/HIST_NEWESTper mappare i timestamp sugli indici. -
Leggere il record in 0x0C20 (
HIST_RECSZbyte, in una sola transazione; coppie di byte holding 0x8180+ su Modbus). Strutture: Misura ed energia. -
Scorrere
HIST_BACK= 0 … COUNT−1 per leggere i record; le regole di differenza secondo i FLAGS del record.
D7 — Aggiornamento firmware
FW_ACTIVE_BANK0x0156 (holding 0x8301) → scegliere il file di rilascio per l'altro banco.-
Condizione:
BOARD_ID0x017C == la parola scheda del file; versione del file ≥FW_VER0x0114; leggereOTA_BANK_SIZE0x014C (mai codificarla fissa). -
(Modbus: UNLOCK)
COMMAND0x10 BEGIN → D2 →OTA_STATUS0x0140 (holding 0x8300) = 1. -
Per ogni pagina non vuota da 256 B, in ordine crescente, prima la pagina 0:
OTA_IDX0x0144 = k · payload → 0x0500 (Modbus: due FC16 da 64 registri a 0x8380/0x83C0) · facoltativoOTA_PCRC_EXP0x0170 = CRC-32 della pagina ·COMMAND0x11 (non subordinato) · interrogare BUSY (≤ ~0.5 s) ·ERROR0xFC → riscrivere il payload, ripetere la pagina · verificare cheOTA_STATUSsia ancora 1 (3 → leggereOTA_DIAG0x0180, ripartire da BEGIN). -
(UNLOCK)
COMMAND0x12 COMMIT → interrogare BUSY ≥ 3 s →OTA_STATUS: 2 = armato (FW_STAGED_VERSION0x0150 = nuova versione) · 3 = rifiutato (motivi 7–15 inOTA_DIAG) · 4 = versione inferiore. -
Solo con stato = 2: (UNLOCK)
COMMAND0x13 ACTIVATE — nessuna risposta o risposta troncata su Modbus; il modulo torna in ~4 s. Oppure (UNLOCK)COMMAND0x14 FW_ABORT per scartare l'immagine armata. -
Non resettare il modulo per ~10 s (prova e autoconferma), poi verificare:
FW_ACTIVE_BANKcambiato ·FW_VER= nuova versione ·SWAP_PENDING0x011C = 0. SeFW_VERè quello vecchio, è tornato indietro — leggereOTA_DIAG.
D8 — Sblocco Modbus
FC06 holding 0x8112 = 0xA5C3 → valido 10 s, consumato da un solo comando protetto; un valore errato annulla uno sblocco attivo; chiave mancante/scaduta → eccezione 03 sul comando protetto. Chiave e opcode possono stare in un unico FC16 a 0x8112–0x8113.
Protetti: 0x01 · 0x02 · 0x07 · 0x10 · 0x12 · 0x13 · 0x14 · 0x15. Non protetti: 0x04 · 0x06 · 0x08–0x0F · 0x11 · 0x16.