Atualização de firmware (protocolo do lado do anfitrião)
As atualizações de firmware correm pelo barramento de trabalho — I²C ou Modbus RTU — sem programador e sem remoção (OTA). A versão do firmware é apresentada como major.minor de FW_VER (0x0114), por exemplo o firmware STD 1.126. O dispositivo guarda dois bancos de firmware; o anfitrião escreve a nova imagem no banco inativo, o dispositivo verifica-a e arma-a, e uma ativação separada reinicia para ela. Uma imagem nova má ou que bloqueie reverte automaticamente para a versão anterior que funcionava.
A medição continua durante a atualização. A atualização cede à medição (no máximo uma escrita de página por ~250 ms); as poucas tramas de medição perdidas em cada escrita em flash são compensadas nos contadores de energia.
Ficheiros de versão
Uma versão traz imagens de banco preparadas — assinadas e cifradas no servidor de build. O anfitrião de transporte envia o ficheiro tal como está; nunca constrói, edita nem reembrulha uma imagem:
-
Dois ficheiros por versão, um por banco (A / B). Leia
FW_ACTIVE_BANK(0x0156): 0 = A em execução → envie o ficheiro B, e vice-versa. -
Compare o id de placa da versão com
BOARD_ID(0x017C) primeiro — uma imagem construída para outra placa é recusada na verificação (motivo 15). -
Uma versão estritamente inferior à em execução é recusada (anti-reversão, estado 4); a mesma versão é aceite. Voltar a uma versão antiga só é possível pelo caminho de reversão do próprio dispositivo, não enviando uma imagem antiga.
Registos
I²C (holding Modbus entre parênteses; u32 = 2 registos, palavra alta primeiro):
| Reg | Endereço | Significado |
|---|---|---|
| OTA_STATUS | 0x0140 (0x8300) | 0 inativo · 1 pronto/sessão aberta · 2 armado · 3 erro · 4 downgrade recusado |
| OTA_IDX | 0x0144 (0x8302–03, rw) | índice de página de 256 B para a próxima escrita de página |
| OTA_ACTIVE | 0x0148 (0x8306–07) | base do banco em execução (opaco) |
| OTA_BANK_SIZE | 0x014C (0x8304–05) | tamanho do banco — indicado pelo dispositivo; índice da página de cabeçalho = tamanho/256 − 1 |
| FW_STAGED_VERSION | 0x0150 (0x8308–09) | versão da imagem armada (0 = nenhuma) |
| FW_ACTIVE_BANK | 0x0156 (0x8301) | 0 = A · 1 = B |
| OTA_PCRC_EXP | 0x0170 (0x8310–11, w) | CRC-32 esperado opcional da página seguinte |
| OTA_PCRC_RX | 0x0174 (0x8312–13) | CRC-32 da página tal como recebida |
| OTA_KEYID | 0x0178 (0x8319–1A) | ID da chave da imagem que este firmware aceita |
| OTA_DIAG | 0x0180 (0x8314: motivo | estado<<8) | diagnóstico de falhas |
| OTA_PAYLOAD | 0x0500, 256 B (0x8380–0x83FF pares de bytes) | buffer de página |
| FW_VER / SWAP_PENDING | 0x0114 / 0x011C (0x8315–16 / 0x8317–18) | versão em execução / estado de troca 0 confirmado · 1 armado · 2 teste |
Comandos (COMMAND 0x0060 / holding 0x8113): 0x10 BEGIN · 0x11 BLOCK_WR · 0x12 COMMIT · 0x13 ACTIVATE · 0x14 FW_ABORT. Por Modbus, BEGIN/COMMIT/ACTIVATE/FW_ABORT são condicionados a UNLOCK; BLOCK_WR não é. Após cada comando consulte CMD_STATE (0x006A / 0x8116) até BUSY = 0 e depois leia OTA_STATUS / ERROR.
Sequência
-
Selecionar. Leia
FW_ACTIVE_BANK→ escolha o ficheiro de versão para o outro banco. VerifiqueBOARD_IDcontra o ficheiro; opcionalmente verifiqueOTA_KEYID. -
BEGIN (0x10). Abre a sessão;
OTA_STATUS= 1 de imediato. Nada é apagado antecipadamente — os setores de flash são apagados à chegada da sua primeira página, pelo que o barramento e a medição continuam a funcionar. Um BEGIN com uma imagem armada desarma-a primeiro. -
BLOCK_WR (0x11) por página, por ordem crescente. Para cada página k de 256 B não vazia do ficheiro:
OTA_IDX= k → 256 B paraOTA_PAYLOAD→ (opcional)OTA_PCRC_EXP= CRC-32 da página → comando 0x11 → consultar BUSY até 0 (aguarde até ~0.5 s). -
Envie as páginas por ordem crescente; a página 0 tem de ser a primeira página da sessão (caso contrário o COMMIT recusa com o motivo 13); ignore as páginas que são todas 0xFF. A página de cabeçalho (
OTA_BANK_SIZE/256 − 1) não tem de ser a última — a ordem crescente envia-a naturalmente no fim. -
Após cada página verifique se
OTA_STATUScontinua em 1.ERROR0xFC = a carga chegou corrompida → reescreva a carga e repita a página (um reenvio idêntico de uma página já escrita é aceite).OTA_STATUS3 = a sessão falhou (leiaOTA_DIAG; dados diferentes para uma página já escrita são uma causa) — as escritas de página seguintes são ignoradas; recomece com BEGIN. -
Limitação: o dispositivo programa no máximo uma página a cada ~250 ms (o comando fica simplesmente em BUSY até chegar a sua vez) — a medição tem prioridade. Uma imagem completa demora ~1–3 minutos.
-
Em I²C, espere alongamento de relógio até ~9 ms e tolere falhas de confirmação durante a janela de escrita (transporte I²C). O Modbus não é afetado.
-
COMMIT (0x12). Consulte BUSY com um tempo limite de ≥ 3 s: o dispositivo apaga os setores que nenhuma página tocou e depois verifica a imagem — integridade, autenticidade, versão, id de placa. Resultado:
-
OTA_STATUS2 — verificada e armada;FW_STAGED_VERSION= nova versão. O módulo continua a executar a imagem antiga. Uma falha de alimentação depois de COMMIT arranca a imagem armada (seguro — é a pretendida). -
3 — recusado;
OTA_DIAGindica o motivo (abaixo). - 4 — versão anterior à em execução; nada foi alterado.
- ACTIVATE (0x13) quando a instalação está pronta para um reinício — verifique primeiro
OTA_STATUS= 2 (não armado → o comando não faz nada,ERRORfica a 0). A energia é libertada, o módulo reinicia e reaparece em ~4 s (por Modbus a resposta a ACTIVATE pode faltar ou ser truncada). A nova imagem arranca em teste sob um watchdog de hardware e confirma-se sozinha após ~8 s de medição saudável. Qualquer reinício antes da confirmação reverte — não reinicie o módulo durante ~10 s após a ativação. Verifique depois:FW_ACTIVE_BANKtrocado,FW_VER= nova versão,SWAP_PENDING2 → 0; se oFW_VERantigo continuar em execução = houve reversão. FW_ABORT (0x14) em vez de ACTIVATE descarta a imagem armada e fecha a sessão.
Diagnóstico de falhas (OTA_DIAG 0x0180)
Byte 0 = motivo · byte 1 = estado interno · depois deslocamento, página/comprimento e valores de verificação.
| Motivo | Significado | Motivo | Significado |
|---|---|---|---|
| 1 | índice de página fora do intervalo | 9 | falhou a verificação de integridade da imagem |
| 2/3 | falhou o apagamento / falhou a verificação do apagamento | 10 | autenticação falhada |
| 4 | dados diferentes para uma página já escrita (sessão falhada — recomece por BEGIN) | 11 | redução de versão |
| 5/6 | falhou a programação / falhou a verificação | 12 | erro de registo de troca |
| 7 | cabeçalho de imagem inválido | 13 | imagem não selada / incompleta (p. ex. a página 0 ou a página de cabeçalho nunca chegou) |
| 8 | a página de cabeçalho nunca chegou | 14 | assinatura inválida |
| 15 | imagem construída para outra placa (valor de verificação = palavra de placa da imagem) |
Todas as falhas de autenticação são reportadas como OTA_STATUS 3 com o motivo aqui indicado — não existem valores de estado separados para tratar. Por Modbus só o motivo e o estado interno são espelhados (holding 0x8314); os detalhes de deslocamento/página/verificação de OTA_DIAG são legíveis por I²C.
Propriedades de segurança (em que o anfitrião pode confiar)
- Duas fases: o COMMIT nunca reinicia; o momento do reinício é decidido pelo anfitrião (janela de manutenção).
-
Um corte de energia em qualquer ponto é seguro: antes do COMMIT a imagem antiga continua a correr; após o COMMIT a imagem armada é a pretendida; um teste falhado reverte.
-
Calibração, configuração, contadores de energia, histórico, registo de eventos e identidade do dispositivo são guardados fora dos bancos de firmware — uma atualização nunca lhes toca.
-
Uma confirmação de firmware fica registada no registo de eventos com a transição de versão.