rbAmp
FR
Boutique
Docs
Mis à jour le

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.

  1. Armer. Écrivez PERIOD_ARM (0x0063) : le bit b = 1 fait accumuler la banque b. Une banque nouvellement armée repart vide.

  2. Instantané. Écrivez LATCH_BANK (0x0062) = b, puis la commande 0x03 (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.

  3. Attendre. Après les étapes de CMD_SEQ, attendez que WIN_SEQ ait avancé de 2 (environ 200 ms).

  4. Lecture. La banque se trouve à 0x2000 + b·0x800 (entrée Modbus 0x7000 + 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

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.