rbAmp
PT
Loja
Docs
Atualizado

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

  1. Selecionar. Leia FW_ACTIVE_BANK → escolha o ficheiro de versão para o outro banco. Verifique BOARD_ID contra o ficheiro; opcionalmente verifique OTA_KEYID.

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

  3. 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 para OTA_PAYLOAD → (opcional) OTA_PCRC_EXP = CRC-32 da página → comando 0x11 → consultar BUSY até 0 (aguarde até ~0.5 s).

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

  5. Após cada página verifique se OTA_STATUS continua em 1. ERROR 0xFC = a carga chegou corrompida → reescreva a carga e repita a página (um reenvio idêntico de uma página já escrita é aceite). OTA_STATUS 3 = a sessão falhou (leia OTA_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.

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

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

  8. 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:

  9. OTA_STATUS 2 — 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).

  10. 3 — recusado; OTA_DIAG indica o motivo (abaixo).

  11. 4 — versão anterior à em execução; nada foi alterado.
  12. 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, ERROR fica 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_BANK trocado, FW_VER = nova versão, SWAP_PENDING 2 → 0; se o FW_VER antigo 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.