06 · Энергия и периоды
Как получить энергию от модуля STD: накопленные за весь срок счётчики, почасовая история, журнал событий и восемь банков снимков. Полные правила: Модель измерения и энергии.
Накопительные счётчики
Модуль хранит накопленные за весь срок счётчики энергии, которые переживают отключение питания: активный импорт, экспорт и нетто в Wh, mWh и µWh; реактивные импорт и экспорт в varh и µvarh. Читайте их одной транзакцией по 0x0800–0x0843 (и 0x08D0–0x08F7 для набора с тонким разрешением).
Rules:
-
Читайте энергию из модуля; никогда не интегрируйте P·dt на хосте. Интеграл модуля компенсирует пропуски и переживает перезапуски.
-
Интервальная энергия = разность двух показаний на границах интервала. Пропущенная граница объединяет два интервала и ничего не теряет.
-
После перезапуска счётчики продолжаются с последнего сохранённого значения; может не хватать примерно последней секунды энергии. Берите разность как
max(0, new − last)и заново задавайте точку отсчёта — период не отбрасывайте. -
LT_GEN(0x0840) меняется при каждом сбросе или приёме счётчика. Если он изменился, не берите разность: заново привяжите базу и проверьте журнал событий. -
Пусковой ток (
CFG_START_UA, по умолчанию 400 µA): ниже него канал не добавляет энергии ни в один счётчик, что останавливает ползучесть без нагрузки. Показания не затрагиваются.
Почасовая история
Модуль хранит последние 7 часовых записей (энергия и электрическая сводка за каждый час) в энергонезависимой памяти (HIST_CAP, 0x0C08, даёт число записей). Записи переживают перезапуск; более длинный архив ведёт мастер.
- Записи пишутся только после того, как мастер установил время, и мастер устанавливает его снова после каждого перезапуска модуля: батарейных часов нет (см. Начало работы).
- Запись закрывается, когда часы модуля проходят границу часа. Запись за неполный час (время было задано в середине часа или модуль включился в середине часа) несёт флаг.
- Из 15-минутного периода доступна только последняя завершённая сводка (электрические величины, без энергии). Она хранится в ОЗУ и теряется при перезапуске.
Интерфейс запросов: карта регистров.
Журнал событий
Журнал событий хранит сбросы и принятия счётчиков, сохранения калибровки, обновления прошивки и отклонённые записи со значениями до и после; опустошайте его периодически.
Банки снимков
Когда CAPABILITIES бит 8 = 1, модуль имеет восемь независимых банков снимков: каждый мастер фиксирует нужный ему период, и несколько потребителей не мешают друг другу. Используйте их, когда нескольким модулям нужно отсечь один и тот же период в один момент; для одного модуля разности счётчиков выше проще.
-
Взвести. Запишите
PERIOD_ARM(0x0063): бит b = 1 заставляет банк b накапливать. Только что взведённый банк начинает пустым. -
Снимок. Запишите
LATCH_BANK(0x0062) = b, затем команду0x03(LATCH_PERIOD). Отсечка берётся на следующей границе окна; банк начинает накопление с нуля. На шине Modbus те же записи можно отправить широковещательно (unit 0) для одной отсечки по нескольким модулям. -
Подождите. После шагов
CMD_SEQдождитесь, покаWIN_SEQвырастет на 2 (около 200 ms). - Чтение. Банк находится по адресу
0x2000 + b·0x800(Modbus input0x7000 + b·0x100): P / Q / S, усреднённые за период, знаковая энергия, число окон, пики и энергия по каналам.PD_VALIDбит b сообщает, что банк содержит снимок; он остаётся установленным и не является признаком свежести.
Банки находятся в ОЗУ: сброс их очищает. Банк, снятый в первые 3 окна после загрузки, содержит нули с WIN_CNT = 0. Структура и единицы: карта регистров.
В клиентских библиотеках
— та же задача без доступа к регистрам:
| Библиотека | Вызов | Что делает |
|---|---|---|
| Arduino | stdArmBanks, stdLatch, stdReadLatch, stdLatchWh |
взвести банки, сделать снимок, прочитать его и перевести в Wh; доступно, когда модуль сообщает о банках (бит 8) |
| ESP-IDF | rbamp_std_arm_banks, rbamp_std_latch, rbamp_std_read_latch, rbamp_std_latch_wh |
то же в компоненте ESP-IDF; банк 0 принадлежит библиотеке, используйте банки 1 и выше (пример std_meter) |
| ESPHome | period_banks:, rbamp.latch_bank |
объявите банки для фиксации в YAML, по interval: и/или по действию (с v1.9.1) |
| Python | std_arm_banks, std_latch, std_read_latch, std_latch_wh |
те же вызовы в клиенте Python (с v1.6.1); флаг валидности банка залипает, читайте банк не раньше чем через 300 ms после его фиксации |
См. Примеры.