rbAmp
PT
Loja
Docs
Atualizado

06 · Energia e períodos

Como obter energia de um módulo STD: contadores acumulados, histórico horário, registo de eventos e os oito bancos de instantâneos. Regras completas: Modelo de medição e energia.

Contadores acumulados

O módulo mantém contadores de energia de vida útil que sobrevivem ao corte de energia: importação ativa, exportação e líquido em Wh, mWh e µWh; importação e exportação reativas em varh e µvarh. Leia-os numa transação sobre 0x0800–0x0843 (e 0x08D0–0x08F7 para o conjunto de resolução fina).

Rules:

  • Leia a energia do módulo; nunca integre P·dt no anfitrião. O integral do módulo é compensado de falhas e sobrevive a reinícios.

  • A energia do intervalo é a diferença entre duas leituras nas fronteiras do intervalo. Uma fronteira perdida junta dois intervalos e não se perde nada.

  • Após um reinício os contadores continuam a partir do último valor guardado; pode faltar até cerca do último segundo de energia. Tome a diferença como max(0, novo − último) e volte a ancorar — não descarte o período.

  • LT_GEN (0x0840) avança em cada reinício ou adoção de contadores. Se mudou, não calcule a diferença: volte a ancorar e verifique o registo de eventos.

  • Corrente de arranque (CFG_START_UA, predefinido 400 µA): abaixo deste valor um canal não acrescenta energia a nenhum contador, o que evita a deriva em vazio. As leituras não são afetadas.

Histórico horário

O módulo guarda os últimos 7 registos horários (energia e um resumo elétrico de cada hora) em memória não volátil (HIST_CAP, 0x0C08, indica o número de registos). Os registos sobrevivem a um reinício; um arquivo mais longo é guardado pelo mestre.

  • Os registos só são escritos depois de o mestre definir a hora, e o mestre volta a defini-la após cada reinício do módulo: não existe relógio com bateria (ver Primeiros passos).
  • Um registo fecha quando o relógio do módulo passa a fronteira da hora. Um registo de parte da hora (a hora foi definida a meio da hora, ou o módulo ligou a meio da hora) traz um sinalizador.
  • Do período de 15 minutos só está disponível o último resumo concluído (valores elétricos, sem energia). Fica em RAM e perde-se no reinício.

Interface de consulta: mapa de registos.

Registo de eventos

O registo de eventos guarda reposições e adoções de contadores, gravações de calibração, atualizações de firmware e registos rejeitados, com valores antes/depois; esvazie-o periodicamente.

Bancos de instantâneos

Quando CAPABILITIES bit 8 = 1, o módulo tem oito bancos de instantâneos independentes: cada mestre congela o período de que precisa, e vários consumidores não se perturbam mutuamente. Use-os quando vários módulos devem cortar o mesmo período no mesmo instante; para um só módulo, as diferenças dos contadores acima são mais simples.

  1. Armar. Escreva PERIOD_ARM (0x0063): o bit b = 1 faz o banco b acumular. Um banco recém-armado começa vazio.

  2. Instantâneo. Escreva LATCH_BANK (0x0062) = b, depois o comando 0x03 (LATCH_PERIOD). O corte é feito na próxima fronteira de janela; o banco recomeça do zero. Num barramento Modbus, as mesmas escritas podem ser enviadas em broadcast (unidade 0) para um corte único entre módulos.

  3. Aguarde. Depois dos passos de CMD_SEQ, aguarde até WIN_SEQ ter avançado 2 (cerca de 200 ms).

  4. Leitura. O banco está em 0x2000 + b·0x800 (entrada Modbus 0x7000 + b·0x100): P / Q / S médios no período, energia com sinal, contagem de janelas, picos e energia por canal. PD_VALID bit b indica que o banco contém um instantâneo; permanece ativo e não é um indicador de atualidade.

Os bancos estão em RAM: um reset limpa-os. Um banco instantaneado durante as primeiras 3 janelas após o arranque tem zeros com WIN_CNT = 0. Layout e unidades: mapa de registos.

Nas bibliotecas cliente

Nas bibliotecas cliente

— a mesma tarefa sem acesso a registos:

Biblioteca Chamada O que faz
Arduino stdArmBanks, stdLatch, stdReadLatch, stdLatchWh armar bancos, tirar um instantâneo, lê-lo e convertê-lo em Wh; disponível quando o módulo comunica bancos (bit 8)
ESP-IDF rbamp_std_arm_banks, rbamp_std_latch, rbamp_std_read_latch, rbamp_std_latch_wh o mesmo no componente ESP-IDF; o banco 0 pertence à biblioteca, use os bancos 1 em diante (exemplo std_meter)
ESPHome period_banks:, rbamp.latch_bank declare os bancos a fixar em YAML, num interval: e/ou pela ação (a partir da v1.9.1)
Python std_arm_banks, std_latch, std_read_latch, std_latch_wh as mesmas chamadas no cliente Python (a partir da v1.6.1); a flag de validade de um banco é persistente, leia um banco pelo menos 300 ms depois de o fixar

Ver Exemplos.