05 · Опрос в реальном времени
Как читать живые значения модуля STD без пропуска или двойного учёта окна. Подробности на уровне регистров: Модель измерений и энергии и Выход готовности данных и события.
Окно измерения
Выборки объединяются в окна из целых циклов сети, ближайших к 100 ms — 5 циклов при 50 Hz, 6 при 60 Hz. Каждое завершённое окно публикуется атомарно как полный снимок (все каналы и итоги), а WIN_SEQ (0x0016) растёт ровно на 1. Это около десяти снимков в секунду. Более частый опрос возвращает те же данные.
Без сетевого питания модуль продолжает публиковать данные по более медленному резервному тику (500 ms), который обновляет статус и часы; на этом тике WIN_SEQ увеличивается, но импульса DRDY нет.
Вариант 1 — опрос WIN_SEQ
- Читайте
WIN_SEQ. Если он не изменился с последнего чтения, нового снимка нет. - Если он изменился, читайте нужные блоки — одна транзакция на блок, до 128 байт; поля одной транзакции берутся из одной публикации и не могут разойтись.
Вариант 2 — реакция на фронт DRDY
DRDY — выход с открытым стоком без подтяжки на модуле; при использовании DRDY установите подтяжку на стороне мастера — рекомендуется 10 kΩ к логическому питанию мастера 3.3 V. В покое линия высокая; на каждое новое окно выдаётся низкий импульс ~10 µs после обновления регистров — чтение по спаду всегда видит свежий снимок.
- На каждом обслуженном фронте проверяйте, что
WIN_SEQвырос ровно на 1; больший скачок означает пропущенные фронты. - Режим тревоги: бит события, установленный и в
EVENT_FLAGS, и вEVENT_MASK, удерживает DRDY низким, пока флаг не сброшен или не размаскирован. Всё ещё низкий уровень через ~100 µs означает тревогу — читайтеEVENT_FLAGS.
Что даёт снимок
Для каждого канала напряжения: RMS-напряжение. Для каждого токового канала: RMS-ток, активная мощность (со знаком; положительная = импорт), реактивная мощность (положительная = индуктивная), полная мощность, коэффициент мощности (со знаком). Для устройства: частота и итоги (k = 0 общий, k = 1..3 по фазам). Единицы и масштабы — в карте регистров.
Ниже примерно 20 mA измеряемый ток дополнительно сглаживается на несколько секунд для стабильного показания; мощность и энергия не затрагиваются.
После перезапуска
Обнаруживайте перезапуск по UPTIME (0x08A0, уменьшается) или BOOT_COUNT (0x00CE, скачок). Затем: заново задайте маску и пороги событий, снова задайте время и заново задайте точку отсчёта дельт энергии. Сразу после загрузки WIN_SEQ читается как 0 примерно одно окно, FREQ читается как 0 ~2 s, а первые ~3 окна не добавляют энергии; выдержите ~1 s, прежде чем судить о состоянии.
В клиентских библиотеках
readAll() возвращает один согласованный снимок в обеих линейках; библиотеки сами сопоставляют его с DRDY или с WIN_SEQ. См. Примеры. На модуле с банками снимков и счётчиками энергии используйте Arduino 1.6.2 или новее или ESP-IDF 1.7.3 или новее.