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.
-
Armar. Escreva
PERIOD_ARM(0x0063): o bit b = 1 faz o banco b acumular. Um banco recém-armado começa vazio. -
Instantâneo. Escreva
LATCH_BANK(0x0062) = b, depois o comando0x03(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. -
Aguarde. Depois dos passos de
CMD_SEQ, aguarde atéWIN_SEQter avançado 2 (cerca de 200 ms). - Leitura. O banco está em
0x2000 + b·0x800(entrada Modbus0x7000 + b·0x100): P / Q / S médios no período, energia com sinal, contagem de janelas, picos e energia por canal.PD_VALIDbit 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
— 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.