rbAmp
PT
Loja
Docs
Atualizado

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

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

  2. Leia UID 0x00F4 (12 B) — a identidade do dispositivo para a sua base de dados; FW_VER 0x0114 (versão de imagem u32); BOARD_ID 0x017C.

  3. Aguardar dados em tempo real: WIN_SEQ (0x0016) ≠ 0 e a avançar, STATUS bit 1 (sensor_ok) = 1 — conte ~1 s após um arranque (prontidão no arranque).

  4. Se STATUS bit 4 (time_valid) = 0 → defina o relógio (D2, SET_TIME).

  5. Condição de saúde: cal_ok ou CAL_SRC (0x0872) ∈ {1, 2}; LTA_STATUS (0x0870) ≤ 1.
  6. Volte a armar o estado em RAM: EVENT_MASK (0x00C1), THRESH_I/P (0x00C4/0x00C8); confirme o arranque limpando RESET_OCCURRED — escreva 0x20 em EVENT_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

  1. Verificação de inatividade: CMD_STATE (0x006A; holding 0x8116) bit 0 = 0.
  2. 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).

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

  4. Leia ERROR (0x0002; holding 0x8114) depois de BUSY = 0: 0x00 = OK, códigos em Comandos. Opcionalmente, verifique se CMD_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

  1. Escreva os registos CFG_* pretendidos (0x0070–0x0085; holding 0x8000–0x800C).
  2. COMMAND 0x04 SAVE_CONFIG (não condicionado a UNLOCK) → D2. ERROR 0xFD = valor ilegal, nada guardado · 0xF9 = limite de taxa, tente de novo após ~5 s · 0xF6 = erro de E/S do armazenamento.

  3. Se a alteração exigir reinício (endereço I²C, unidade/baud/trama/atraso de transmissão Modbus, CFG_VIRTUAL_IDS): COMMAND 0x02 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):

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

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

  3. O módulo correspondente persiste (juntamente com quaisquer valores CFG_ preparados) e reinicia; todos os outros módulos respondem ERROR 0xFC. Ambos os campos de novo endereço a 0 ou um endereço ilegal → 0xFD; limite de taxa de gravação → 0xF9.

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

  1. Uma transação I²C ≤ 128 B sobre 0x0800–0x0843: contadores de Wh, contadores de mWh, LT_GEN (instantâneo coerente). Mais UPTIME 0x08A0. 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).

  2. Energia do intervalo = diferença dos contadores de mWh (contadores de µWh quando se pretende maior resolução).

  3. LT_GEN alterado → não use a diferença; volte a ancorar (alguém reiniciou/adotou — veja o registo de eventos).
  4. UPTIME diminuiu → 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

  1. HIST_PERIOD 0x0C00 (holding 0x8160): 0 = últimos 15 min (então HIST_BACK tem de ser 0) · 1 = anel horário · 2 = registo de eventos.

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

  3. COMMAND 0x08 HIST_READ → D2. ERROR 0xFC = sem tal registo.
  4. Em caso de sucesso: HIST_FLAGS 0x0C02 bit 0 = 1; leia HIST_COUNT / HIST_RECSZ (80 histórico / 32 evento) / HIST_OLDEST / HIST_NEWEST para mapear marcas temporais em índices.

  5. Leia o registo em 0x0C20 (HIST_RECSZ bytes, numa só transação; Modbus holding 0x8180+ pares de bytes). Layouts: Medição e energia.

  6. Itere HIST_BACK = 0 … COUNT−1 para ler os registos; regras de diferença segundo o FLAGS do registo.

D7 — Atualização de firmware

  1. FW_ACTIVE_BANK 0x0156 (holding 0x8301) → escolha o ficheiro de versão para o outro banco.
  2. Condição: BOARD_ID 0x017C == a palavra de placa do ficheiro; versão do ficheiro ≥ FW_VER 0x0114; leia OTA_BANK_SIZE 0x014C (nunca o codifique).

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

  4. Por cada página de 256 B não vazia, por ordem crescente, página 0 primeiro: OTA_IDX 0x0144 = k · carga → 0x0500 (Modbus: dois FC16 de 64 registos em 0x8380/0x83C0) · opcional OTA_PCRC_EXP 0x0170 = CRC-32 da página · COMMAND 0x11 (não condicionado) · consulte BUSY (≤ ~0.5 s) · ERROR 0xFC → reescreva a carga e repita a página · verifique se OTA_STATUS continua em 1 (3 → leia OTA_DIAG 0x0180, recomece a partir de BEGIN).

  5. (UNLOCK) COMMAND 0x12 COMMIT → consultar BUSY ≥ 3 s → OTA_STATUS: 2 = armado (FW_STAGED_VERSION 0x0150 = nova versão) · 3 = recusado (motivos 7–15 em OTA_DIAG) · 4 = versão inferior.

  6. Apenas quando status = 2: (UNLOCK) COMMAND 0x13 ACTIVATE — sem resposta Modbus ou resposta truncada; o módulo volta em ~4 s. Ou (UNLOCK) COMMAND 0x14 FW_ABORT para descartar a imagem armada.

  7. Não reinicie o módulo durante ~10 s (teste + autoconfirmação) e depois verifique: FW_ACTIVE_BANK trocado · FW_VER = nova versão · SWAP_PENDING 0x011C = 0. Se o FW_VER antigo estiver ativo, houve reversão — leia OTA_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.