Sequências — fluxos de controlo passo a passo
Fluxos canónicos do lado do anfitrião. Cada passo indica o registo (endereço I²C; Modbus entre parênteses) e o que verificar. As regras de consulta de comandos usadas em todo o documento estão definidas uma só vez em D2.
D1 — Arranque / descoberta
-
Leia 12 bytes em 0x0000 numa só transação:
ID= 'S','T' ·VERSION≥ 0x36 ·CAPABILITIES(espere o bit 9 ativo; bit 2 de THD = 0, bit 8 de bancos de instantâneos = 1 quando há bancos, bit 13 de energia no dispositivo = 1) ·STATUS·N_VOLTAGE/N_CURRENT·VARIANT(UI1 0x11 = 1/1, 0x63 = 3/3) ·HW_REV/FW_VERSION. -
Leia
UID0x00F4 (12 B) — a identidade do dispositivo para a sua base de dados;FW_VER0x0114 (versão de imagem u32);BOARD_ID0x017C. -
Aguardar dados em tempo real:
WIN_SEQ(0x0016) ≠ 0 e a avançar,STATUSbit 1 (sensor_ok) = 1 — conte ~1 s após um arranque (prontidão no arranque). -
Se
STATUSbit 4 (time_valid) = 0 → defina o relógio (D2, SET_TIME). - Condição de saúde: cal_ok ou
CAL_SRC(0x0872) ∈ {1, 2};LTA_STATUS(0x0870) ≤ 1. - Volte a armar o estado em RAM:
EVENT_MASK(0x00C1),THRESH_I/P(0x00C4/0x00C8); confirme o arranque limpando RESET_OCCURRED — escreva 0x20 emEVENT_FLAGS(0x00C0).
Modbus: o mesmo conjunto de identidade está em input 0x6000–0x601F (espelho); FW_VER holding 0x8315–16, BOARD_ID holding 0x831B–1C.
D2 — Executar um comando
- Verificação de inatividade:
CMD_STATE(0x006A; holding 0x8116) bit 0 = 0. -
Escreva os registos de parâmetros do comando e depois o opcode em
COMMAND(0x0060; holding 0x8113 — para um opcode condicionado por Modbus envie um FC16{0x8112 = 0xA5C3, 0x8113 = opcode}; exceção 06 = ocupado, exceção 03 = opcode desconhecido ou falta de desbloqueio). -
Consulte
CMD_STATEbit 0 → 0. Tempos limite: ≥ 1 s para comandos simples e gravações · ≥ 0.5 s para escrita de página de atualização · ≥ 3 s para COMMIT de atualização. Em I²C, tolere ≥ 10 ms de alongamento de relógio; repita as leituras com falta de confirmação; nunca reenvie às cegas uma escrita de COMMAND (um duplicado seria descartado como OVERRUN, mas perde-se o rasto de qual escrita foi aceite). -
Leia
ERROR(0x0002; holding 0x8114) depois de BUSY = 0: 0x00 = OK, códigos em Comandos. Opcionalmente, verifique seCMD_SEQ(0x0067) avançou de 1 e se OVERRUN (bit 1) = 0.
Definir a hora (o comando mais comum): escreva a época u32 LE em TIME_SET 0x08C0 (Modbus FC16 0x8100 = palavra alta, 0x8101 = palavra baixa — em broadcast é uma trama própria, o comando segue como segunda trama) → COMMAND 0x06 → consultar → ERROR 0xFC = época abaixo de 1 600 000 000. STATUS bit 4 fica ativo de imediato.
D3 — Configuração
- Escreva os registos
CFG_*pretendidos (0x0070–0x0085; holding 0x8000–0x800C). -
COMMAND0x04 SAVE_CONFIG (não condicionado a UNLOCK) → D2.ERROR0xFD = valor ilegal, nada guardado · 0xF9 = limite de taxa, tente de novo após ~5 s · 0xF6 = erro de E/S do armazenamento. -
Se a alteração exigir reinício (endereço I²C, unidade/baud/trama/atraso de transmissão Modbus,
CFG_VIRTUAL_IDS):COMMAND0x02 RESET (protegido por UNLOCK no Modbus; não espere resposta Modbus ou resposta truncada) e volte a consultar o dispositivo ~1 s depois.
CFG_LED / CFG_WORD_ORDER atuam na escrita, mas são revertidos no arranque, a menos que sejam gravados. CFG_CLASS, CFG_CT_MODEL, CFG_TZ_OFFSET_MIN, CFG_TIME_AUTH, CFG_ENERGY_PERSIST_S são metadados guardados.
D4 — Alteração de endereço / série
Endereço I²C (dispositivo conhecido): CFG_I2C_ADDR 0x0073 = 0x08..0x77 → SAVE_CONFIG → BUSY 0 e ERROR 0 → RESET → aguarde ~1 s → sonde ID = 'S','T' no novo endereço.
Série Modbus: holding 0x8000 unidade (1–247) / 0x8001 baud (0–10) / 0x8002 formato de trama / 0x8003 atraso de TX (validado na escrita — exceção 03) → FC06 0x8113 = 0x0004 → consulte 0x8114 = 0 → FC16 {0x8112 = 0xA5C3, 0x8113 = 0x0002} (a resposta pode perder-se) → volte a ligar com as novas definições.
Por UID (vários módulos num mesmo endereço, em ambos os transportes):
-
I²C: uma escrita de 0x00E0: UID (12 B) + novo endereço I²C (0x00EC, ou 0) + nova unidade Modbus (0x00ED, ou 0). Modbus: FC16 0x8118–0x811E (pares de bytes do UID + 0x811E = endereço<<8 | unidade) — broadcast permitido.
-
COMMAND0x16 (FC06 0x8113 = 0x0016; broadcast permitido). -
O módulo correspondente persiste (juntamente com quaisquer valores CFG_ preparados) e reinicia; todos os outros módulos respondem
ERROR0xFC. Ambos os campos de novo endereço a 0 ou um endereço ilegal → 0xFD; limite de taxa de gravação → 0xF9. -
Sonde o módulo no seu novo endereço/unidade; identifique-o pelo UID.
D5 — Energia: ler, repor, adotar
Leitura (em cada fronteira de intervalo, pelo seu relógio):
-
Uma transação I²C ≤ 128 B sobre 0x0800–0x0843: contadores de Wh, contadores de mWh,
LT_GEN(instantâneo coerente). MaisUPTIME0x08A0. Modbus: input 0x6B00/0x6B14 + holding 0x8140. Bit 15 de capacidade: os mesmos contadores em resolução de µWh — total em 0x08D0 (3×i64; Modbus input 0x6BB0), por canal em 0x0C80 + g·0x10 (Modbus 0x6BC0 + g·8) — mesmo instantâneo dos campos de mWh (imp/exp mWh = floor(µWh/1000); líquido = imp − exp na mesma unidade), com as mesmas regras de diferença/geração/reinício. O módulo também publica o total de µvarh reativos em 0x08E8/0x08F0 (Modbus 0x6BAC/0x6BBC, não contíguos): a leitura coerente de resolução fina é uma transação sobre 0x08D0–0x08F7 (40 B). -
Energia do intervalo = diferença dos contadores de mWh (contadores de µWh quando se pretende maior resolução).
LT_GENalterado → não use a diferença; volte a ancorar (alguém reiniciou/adotou — veja o registo de eventos).UPTIMEdiminuiu → o módulo reiniciou: diferença =max(0, Δ)(pode faltar até cerca do último segundo de energia), volte a enviar a hora (D2).
Reinício (deliberado, registado): LT_KEY 0x0844 = 0x4C545253 ("LTRS"; Modbus FC16 0x8142–43, palavra alta primeiro) → de imediato COMMAND 0x0A (qualquer comando consome a chave) → D2. ERROR 0xFB = chave errada/em falta · 0xFA = FAULT do armazenamento. Não é necessário UNLOCK no Modbus — a chave é a proteção. (O opcode da família 0x07 ENERGY_RESET não é usado: 0xFE / exceção 03.)
Adoção (troca de placa / migração): preparar 4×i64 em LT_ADOPT 0x0848 (Modbus 0x8144–0x8153) na ordem importação Wh · exportação Wh · importação reativa varh · exportação reativa varh → LT_KEY = 0x4C544150 ("LTAP") → COMMAND 0x0B. Valor negativo → 0xFA. Tanto o reinício como a adoção incrementam LT_GEN e ficam registados no registo de eventos com valores antes/depois.
D6 — Histórico e registo de eventos
-
HIST_PERIOD0x0C00 (holding 0x8160): 0 = últimos 15 min (entãoHIST_BACKtem de ser 0) · 1 = anel horário · 2 = registo de eventos. -
HIST_BACK0x0C04 (holding 0x8163) = n, 0 = mais recente. COMMAND0x08 HIST_READ → D2.ERROR0xFC = sem tal registo.-
Em caso de sucesso:
HIST_FLAGS0x0C02 bit 0 = 1; leiaHIST_COUNT/HIST_RECSZ(80 histórico / 32 evento) /HIST_OLDEST/HIST_NEWESTpara mapear marcas temporais em índices. -
Leia o registo em 0x0C20 (
HIST_RECSZbytes, numa só transação; Modbus holding 0x8180+ pares de bytes). Layouts: Medição e energia. -
Itere
HIST_BACK= 0 … COUNT−1 para ler os registos; regras de diferença segundo o FLAGS do registo.
D7 — Atualização de firmware
FW_ACTIVE_BANK0x0156 (holding 0x8301) → escolha o ficheiro de versão para o outro banco.-
Condição:
BOARD_ID0x017C == a palavra de placa do ficheiro; versão do ficheiro ≥FW_VER0x0114; leiaOTA_BANK_SIZE0x014C (nunca o codifique). -
(Modbus: UNLOCK)
COMMAND0x10 BEGIN → D2 →OTA_STATUS0x0140 (holding 0x8300) = 1. -
Por cada página de 256 B não vazia, por ordem crescente, página 0 primeiro:
OTA_IDX0x0144 = k · carga → 0x0500 (Modbus: dois FC16 de 64 registos em 0x8380/0x83C0) · opcionalOTA_PCRC_EXP0x0170 = CRC-32 da página ·COMMAND0x11 (não condicionado) · consulte BUSY (≤ ~0.5 s) ·ERROR0xFC → reescreva a carga e repita a página · verifique seOTA_STATUScontinua em 1 (3 → leiaOTA_DIAG0x0180, recomece a partir de BEGIN). -
(UNLOCK)
COMMAND0x12 COMMIT → consultar BUSY ≥ 3 s →OTA_STATUS: 2 = armado (FW_STAGED_VERSION0x0150 = nova versão) · 3 = recusado (motivos 7–15 emOTA_DIAG) · 4 = versão inferior. -
Apenas quando status = 2: (UNLOCK)
COMMAND0x13 ACTIVATE — sem resposta Modbus ou resposta truncada; o módulo volta em ~4 s. Ou (UNLOCK)COMMAND0x14 FW_ABORT para descartar a imagem armada. -
Não reinicie o módulo durante ~10 s (teste + autoconfirmação) e depois verifique:
FW_ACTIVE_BANKtrocado ·FW_VER= nova versão ·SWAP_PENDING0x011C = 0. Se oFW_VERantigo estiver ativo, houve reversão — leiaOTA_DIAG.
D8 — Desbloqueio Modbus
FC06 holding 0x8112 = 0xA5C3 → válido 10 s, consumido por um comando protegido; um valor errado desativa um desbloqueio ativo; em falta/expirado → exceção 03 no comando protegido. Chave e opcode podem partilhar um FC16 em 0x8112–0x8113.
Protegidos: 0x01 · 0x02 · 0x07 · 0x10 · 0x12 · 0x13 · 0x14 · 0x15. Não protegidos: 0x04 · 0x06 · 0x08–0x0F · 0x11 · 0x16.