06 · Énergie et périodes
Comment obtenir l'énergie d'un module STD : compteurs cumulés, historique horaire, journal d'événements et les huit banques d'instantanés. Règles complètes : Modèle de mesure et d'énergie.
Compteurs cumulés
Le module tient des compteurs d'énergie à vie qui survivent à la mise hors tension : import actif, export et net en Wh, mWh et µWh ; import et export réactifs en varh et µvarh. Lisez-les en une seule transaction sur 0x0800–0x0843 (et 0x08D0–0x08F7 pour le jeu en fine résolution).
Rules:
-
Lisez l'énergie depuis le module ; n'intégrez jamais P·dt côté hôte. L'intégrale du module est compensée des lacunes et survit aux redémarrages.
-
Énergie d'intervalle = la différence de deux lectures aux bornes de l'intervalle. Une borne manquée fusionne deux intervalles et ne perd rien.
-
Après un redémarrage, les compteurs reprennent à partir de la dernière valeur enregistrée ; il peut manquer jusqu'à environ la dernière seconde d'énergie. Prenez la différence sous la forme
max(0, nouveau − dernier)et réancrez — ne jetez pas la période. -
LT_GEN(0x0840) avance à chaque réinitialisation ou adoption de compteur. S'il a changé, ne prenez pas la différence : rebasez et consultez le journal d'événements. -
Courant de démarrage (
CFG_START_UA, 400 µA par défaut) : en dessous de ce seuil, un canal n'ajoute aucune énergie à aucun compteur, ce qui arrête la dérive à vide. Les lectures ne sont pas affectées.
Historique horaire
Le module conserve les 7 derniers enregistrements horaires (énergie et résumé électrique pour chaque heure) en mémoire non volatile (HIST_CAP, 0x0C08, donne le nombre d'enregistrements). Les enregistrements survivent à un redémarrage ; une archive plus longue est conservée par le maître.
- Les enregistrements ne sont écrits qu'après que le maître a réglé l'heure, et le maître la règle à nouveau après chaque redémarrage du module : il n'y a pas d'horloge sauvegardée par pile (voir Premiers pas).
- Un enregistrement se clôt lorsque l'horloge du module dépasse la limite de l'heure. Un enregistrement de fin d'heure partielle (l'heure a été réglée en cours d'heure, ou le module s'est mis sous tension en cours d'heure) porte un drapeau.
- De la période de 15 minutes, seul le dernier résumé terminé est disponible (valeurs électriques, sans énergie). Il est conservé en RAM et perdu au redémarrage.
Interface de requête : carte des registres.
Journal d'événements
Le journal d'événements conserve les remises à zéro et adoptions de compteurs, les étalonnages, les mises à jour du micrologiciel et les enregistrements rejetés, avec valeurs avant/après ; videz-le périodiquement.
Banques d'instantanés
Lorsque CAPABILITIES bit 8 = 1, le module dispose de huit banques d'instantanés indépendantes : chaque maître fige la période dont il a besoin, et plusieurs consommateurs ne se perturbent pas mutuellement. Utilisez-les lorsque plusieurs modules doivent couper la même période au même instant ; pour un seul module, les différences de compteurs ci-dessus sont plus simples.
-
Armer. Écrivez
PERIOD_ARM(0x0063) : le bit b = 1 fait accumuler la banque b. Une banque nouvellement armée repart vide. -
Instantané. Écrivez
LATCH_BANK(0x0062) = b, puis la commande0x03(LATCH_PERIOD). La coupure est prise à la prochaine frontière de fenêtre ; la banque repart de zéro. Sur un bus Modbus, les mêmes écritures peuvent être envoyées en diffusion (unité 0) pour une coupure commune entre modules. -
Attendre. Après les étapes de
CMD_SEQ, attendez queWIN_SEQait avancé de 2 (environ 200 ms). - Lecture. La banque se trouve à
0x2000 + b·0x800(entrée Modbus0x7000 + b·0x100) : P / Q / S moyennés sur la période, énergie signée, nombre de fenêtres, crêtes et énergie par canal.PD_VALID: le bit b indique que la banque contient un instantané ; il reste levé et n'est pas un indicateur de fraîcheur.
Les banques sont en RAM : une réinitialisation les efface. Une banque instantanée pendant les 3 premières fenêtres après le démarrage contient des zéros avec WIN_CNT = 0. Disposition et unités : table de registres.
Dans les bibliothèques clientes
— la même tâche sans accès aux registres :
| Bibliothèque | Appel | Ce qu'il fait |
|---|---|---|
| Arduino | stdArmBanks, stdLatch, stdReadLatch, stdLatchWh |
armer les banques, prendre un instantané, le lire et le convertir en Wh ; disponible lorsque le module annonce des banques (bit 8) |
| ESP-IDF | rbamp_std_arm_banks, rbamp_std_latch, rbamp_std_read_latch, rbamp_std_latch_wh |
la même chose dans le composant ESP-IDF ; la banque 0 appartient à la bibliothèque, utilisez les banques 1 et suivantes (exemple std_meter) |
| ESPHome | period_banks:, rbamp.latch_bank |
déclarez les banques à latch dans le YAML, sur un interval: et/ou par l'action (à partir de v1.9.1) |
| Python | std_arm_banks, std_latch, std_read_latch, std_latch_wh |
les mêmes appels dans le client Python (à partir de v1.6.1) ; le drapeau « valide » d'une banque est collant, lisez une banque au moins 300 ms après l'avoir figée |
Voir Exemples.