rbAmp
FR
Boutique
Docs
Mis à jour le

05 · Interrogation temps réel

Comment lire les valeurs en direct d'un module STD sans manquer ni compter deux fois une fenêtre. Détail au niveau des registres : Modèle de mesure et d'énergie et Sortie données prêtes et événements.

La fenêtre de mesure

Les échantillons sont regroupés en fenêtres de cycles entiers du réseau les plus proches de 100 ms — 5 cycles à 50 Hz, 6 à 60 Hz. Chaque fenêtre terminée est publiée de façon atomique sous forme d'instantané complet (tous les canaux et totaux), et WIN_SEQ (0x0016) avance exactement de 1. Cela représente environ dix instantanés par seconde. Interroger plus vite renvoie les mêmes données.

Sans secteur, le module continue de publier à une cadence de repli plus lente (500 ms) qui rafraîchit l'état et l'horloge ; à cette cadence, WIN_SEQ avance, mais il n'y a pas d'impulsion DRDY.

Option 1 — interroger WIN_SEQ

  1. Lisez WIN_SEQ. S'il n'a pas changé depuis la dernière lecture, il n'y a pas de nouvel instantané.
  2. En cas de changement, lisez les blocs dont vous avez besoin — une transaction par bloc, jusqu'à 128 octets ; les champs d'une même transaction proviennent d'une seule publication et ne peuvent pas se déchirer.

Option 2 — réagir au front DRDY

DRDY est une sortie en drain ouvert sans résistance de rappel sur le module ; si vous utilisez DRDY, ajoutez une résistance de rappel côté maître — 10 kΩ vers l'alimentation logique 3.3 V du maître est recommandé. Au repos il est à l'état haut et donne une impulsion basse d'environ 10 µs pour chaque nouvelle fenêtre, après la mise à jour des registres — une lecture déclenchée par le front descendant voit toujours l'instantané frais.

  • À chaque front traité, vérifiez que WIN_SEQ a avancé exactement de 1 ; un saut plus grand signifie des fronts manqués.
  • Mode alarme : un bit d'événement positionné à la fois dans EVENT_FLAGS et EVENT_MASK maintient DRDY à BAS jusqu'à ce que le drapeau soit effacé ou démasqué. Toujours bas après ~100 µs signifie alarme — lisez EVENT_FLAGS.

Ce que donne un instantané

Par canal de tension : tension efficace RMS. Par canal de courant : courant efficace RMS, puissance active (signée ; positive = importation), puissance réactive (positive = inductive), puissance apparente, facteur de puissance (signé). Par périphérique : fréquence et totaux (k = 0 total général, k = 1..3 par phase). Les unités et échelles figurent dans la table de registres.

En dessous d'environ 20 mA, le courant publié est aussi lissé sur quelques secondes pour une lecture stable ; la puissance et l'énergie ne sont pas affectées.

Après un redémarrage

Détectez un redémarrage avec UPTIME (0x08A0, en diminution) ou BOOT_COUNT (0x00CE, qui progresse par paliers). Puis : réarmez le masque d'événements et les seuils, réglez de nouveau l'heure et réancrez vos deltas d'énergie. Juste après le démarrage, WIN_SEQ affiche 0 pendant environ une fenêtre, FREQ affiche 0 pendant ~2 s, et les ~3 premières fenêtres n'ajoutent aucune énergie ; prévoyez ~1 s avant de juger la santé.

Dans les bibliothèques clientes

readAll() renvoie un instantané cohérent unique sur les deux gammes de produits ; les bibliothèques l'apparient pour vous avec DRDY ou avec WIN_SEQ. Voir Exemples. Sur un module disposant de banques d'instantanés et de compteurs d'énergie, utilisez Arduino 1.6.2 ou ultérieure ou ESP-IDF 1.7.3 ou ultérieure.