06 · Energía y periodos
Cómo obtener energía de un módulo STD: contadores acumulados, historial horario, registro de eventos y los ocho bancos de instantáneas. Reglas completas: Modelo de medida y energía.
Contadores acumulados
El módulo guarda contadores de energía de vida útil que sobreviven al corte de alimentación: importación activa, exportación y neta en Wh, mWh y µWh; importación y exportación reactivas en varh y µvarh. Léalos en una transacción sobre 0x0800–0x0843 (y 0x08D0–0x08F7 para el conjunto de alta resolución).
Rules:
-
Lea la energía del módulo; nunca integre P·dt en el host. La integral del módulo está compensada por huecos y sobrevive a los reinicios.
-
La energía de intervalo es la diferencia de dos lecturas tomadas en los límites del intervalo. Un límite perdido une dos intervalos, pero no se pierde nada.
-
Tras un reinicio, los contadores continúan desde el último valor guardado; puede faltar hasta aproximadamente el último segundo de energía. Tome la diferencia como
max(0, nuevo − último)y vuelva a fijar la referencia; no descarte el periodo. -
LT_GEN(0x0840) avanza en cada reinicio o adopción de contadores. Si ha cambiado, no tome la diferencia: vuelva a anclar y revise el registro de eventos. -
Corriente de arranque (
CFG_START_UA, por defecto 400 µA): por debajo de este valor, un canal no suma energía a ningún contador, lo que evita el avance en vacío. Las lecturas no se ven afectadas.
Historial horario
El módulo conserva los últimos 7 registros horarios (energía y un resumen eléctrico de cada hora) en memoria no volátil (HIST_CAP, 0x0C08, indica el número de registros). Los registros sobreviven a un reinicio; el maestro conserva un archivo más largo.
- Los registros solo se escriben después de que el maestro haya fijado la hora, y el maestro la vuelve a fijar tras cada reinicio del módulo: no hay reloj con batería (véase Primeros pasos).
- Un registro se cierra cuando el reloj del módulo pasa el límite de la hora. Un registro de media hora (la hora se ajustó a mitad de hora, o el módulo se encendió a mitad de hora) lleva una marca.
- Del periodo de 15 minutos solo está disponible el último resumen cerrado (valores eléctricos, sin energía). Se guarda en RAM y se pierde al reiniciar.
Interfaz de consulta: mapa de registros.
Registro de eventos
El registro de eventos guarda los reinicios y adopciones de contadores, los guardados de calibración, las actualizaciones de firmware y los registros rechazados, con los valores antes y después; vacíelo periódicamente.
Bancos de instantáneas
Cuando CAPABILITIES bit 8 = 1, el módulo tiene ocho bancos de instantáneas independientes: cada maestro congela el período que necesita, y varios consumidores no se molestan entre sí. Úselos cuando varios módulos deban cortar el mismo período en el mismo instante; para un solo módulo, las diferencias de contadores descritas arriba son más sencillas.
-
Armar. Escriba
PERIOD_ARM(0x0063): el bit b = 1 hace que el banco b acumule. Un banco recién armado empieza vacío. -
Instantánea. Escriba
LATCH_BANK(0x0062) = b, y luego el comando0x03(LATCH_PERIOD). El corte se toma en el siguiente límite de ventana; el banco reinicia desde cero. En un bus Modbus, las mismas escrituras pueden enviarse en difusión (unidad 0) para un único corte entre módulos. -
Espere. Tras los pasos de
CMD_SEQ, espere hasta queWIN_SEQhaya avanzado 2 (unos 200 ms). - Lectura. El banco está en
0x2000 + b·0x800(entrada Modbus0x7000 + b·0x100): P / Q / S promediados sobre el período, energía con signo, número de ventanas, picos y energía por canal.PD_VALIDbit b indica que el banco contiene una instantánea; permanece activo y no es un indicador de actualidad.
Los bancos están en RAM: un reinicio los borra. Un banco instantaneado durante las primeras 3 ventanas tras el arranque contiene ceros con WIN_CNT = 0. Estructura y unidades: mapa de registros.
En las bibliotecas cliente
— la misma tarea sin acceso a registros:
| Biblioteca | Llamada | Qué hace |
|---|---|---|
| Arduino | stdArmBanks, stdLatch, stdReadLatch, stdLatchWh |
armar bancos, tomar una instantánea, leerla y convertirla a Wh; disponible cuando el módulo informa de bancos (bit 8) |
| ESP-IDF | rbamp_std_arm_banks, rbamp_std_latch, rbamp_std_read_latch, rbamp_std_latch_wh |
lo mismo en el componente ESP-IDF; el banco 0 pertenece a la biblioteca, use los bancos 1 en adelante (ejemplo std_meter) |
| ESPHome | period_banks:, rbamp.latch_bank |
declare en YAML los bancos que se van a fijar, con un interval: y/o por acción (desde v1.9.1) |
| Python | std_arm_banks, std_latch, std_read_latch, std_latch_wh |
las mismas llamadas en el cliente Python (desde v1.6.1); el indicador de validez de un banco es persistente, lea un banco al menos 300 ms después de fijarlo |
Véanse los Ejemplos.