rbAmp
IT
Negozio
Docs
Aggiornato il

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

  1. 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.

  2. Leggere UID 0x00F4 (12 B) — l'identità del dispositivo per il proprio database; FW_VER 0x0114 (u32 versione immagine); BOARD_ID 0x017C.

  3. Attendere i dati in tempo reale: WIN_SEQ (0x0016) ≠ 0 e in avanzamento, bit 1 di STATUS (sensor_ok) = 1 — attendere ~1 s dopo l'avvio (prontezza all'avvio).

  4. Se STATUS bit 4 (time_valid) = 0 → impostare l'orologio (D2, SET_TIME).

  5. Condizione di salute: cal_ok oppure CAL_SRC (0x0872) ∈ {1, 2}; LTA_STATUS (0x0870) ≤ 1.
  6. Riarmare lo stato in RAM: EVENT_MASK (0x00C1), THRESH_I/P (0x00C4/0x00C8); confermare l'avvio azzerando RESET_OCCURRED — scrivere 0x20 in EVENT_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

  1. Controllo di inattività: CMD_STATE (0x006A; holding 0x8116) bit 0 = 0.
  2. 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).

  3. Interrogare CMD_STATE bit 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).

  4. Leggere ERROR (0x0002; holding 0x8114) dopo BUSY = 0: 0x00 = OK, codici in Comandi. Facoltativamente verificare che CMD_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

  1. Scrivere i registri CFG_* desiderati (0x0070–0x0085; holding 0x8000–0x800C).
  2. COMMAND 0x04 SAVE_CONFIG (non subordinato a UNLOCK) → D2. ERROR 0xFD = valore non valido, nulla salvato · 0xF9 = limite di frequenza, riprovare dopo ~5 s · 0xF6 = errore di I/O dell'archivio.

  3. Se la modifica richiede un riavvio (indirizzo I²C, unit/baud/frame/ritardo-tx Modbus, CFG_VIRTUAL_IDS): COMMAND 0x02 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):

  1. 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.

  2. COMMAND 0x16 (FC06 0x8113 = 0x0016; broadcast consentito).

  3. Il modulo corrispondente rende persistenti (insieme a eventuali valori CFG_ in staging) e si riavvia; ogni altro modulo risponde ERROR 0xFC. Entrambi i campi del nuovo indirizzo a 0 o un indirizzo non valido → 0xFD; limite di frequenza di salvataggio → 0xF9.

  4. 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):

  1. Una transazione I²C ≤ 128 B su 0x0800–0x0843: contatori Wh, contatori mWh, LT_GEN (istantanea coerente). Più UPTIME 0x08A0. 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).

  2. Energia di intervallo = delta dei contatori mWh (contatori µWh dove si desidera una risoluzione più fine).

  3. LT_GEN cambiato → non prendere il delta; ri-ancorare (qualcuno ha azzerato/adottato — vedere il registro eventi).
  4. UPTIME diminuito → 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

  1. HIST_PERIOD 0x0C00 (holding 0x8160): 0 = ultimi 15 min (allora HIST_BACK deve essere 0) · 1 = anello orario · 2 = registro eventi.

  2. HIST_BACK 0x0C04 (holding 0x8163) = n, 0 = più recente.

  3. COMMAND 0x08 HIST_READ → D2. ERROR 0xFC = nessun record.
  4. In caso di successo: bit 0 di HIST_FLAGS 0x0C02 = 1; leggere HIST_COUNT / HIST_RECSZ (80 storico / 32 eventi) / HIST_OLDEST / HIST_NEWEST per mappare i timestamp sugli indici.

  5. Leggere il record in 0x0C20 (HIST_RECSZ byte, in una sola transazione; coppie di byte holding 0x8180+ su Modbus). Strutture: Misura ed energia.

  6. Scorrere HIST_BACK = 0 … COUNT−1 per leggere i record; le regole di differenza secondo i FLAGS del record.

D7 — Aggiornamento firmware

  1. FW_ACTIVE_BANK 0x0156 (holding 0x8301) → scegliere il file di rilascio per l'altro banco.
  2. Condizione: BOARD_ID 0x017C == la parola scheda del file; versione del file ≥ FW_VER 0x0114; leggere OTA_BANK_SIZE 0x014C (mai codificarla fissa).

  3. (Modbus: UNLOCK) COMMAND 0x10 BEGIN → D2 → OTA_STATUS 0x0140 (holding 0x8300) = 1.

  4. Per ogni pagina non vuota da 256 B, in ordine crescente, prima la pagina 0: OTA_IDX 0x0144 = k · payload → 0x0500 (Modbus: due FC16 da 64 registri a 0x8380/0x83C0) · facoltativo OTA_PCRC_EXP 0x0170 = CRC-32 della pagina · COMMAND 0x11 (non subordinato) · interrogare BUSY (≤ ~0.5 s) · ERROR 0xFC → riscrivere il payload, ripetere la pagina · verificare che OTA_STATUS sia ancora 1 (3 → leggere OTA_DIAG 0x0180, ripartire da BEGIN).

  5. (UNLOCK) COMMAND 0x12 COMMIT → interrogare BUSY ≥ 3 s → OTA_STATUS: 2 = armato (FW_STAGED_VERSION 0x0150 = nuova versione) · 3 = rifiutato (motivi 7–15 in OTA_DIAG) · 4 = versione inferiore.

  6. Solo con stato = 2: (UNLOCK) COMMAND 0x13 ACTIVATE — nessuna risposta o risposta troncata su Modbus; il modulo torna in ~4 s. Oppure (UNLOCK) COMMAND 0x14 FW_ABORT per scartare l'immagine armata.

  7. Non resettare il modulo per ~10 s (prova e autoconferma), poi verificare: FW_ACTIVE_BANK cambiato · FW_VER = nuova versione · SWAP_PENDING 0x011C = 0. Se FW_VER è quello vecchio, è tornato indietro — leggere OTA_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.