rbAmp
RU
Магазин
Документация
Обновлено

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, модуль имеет восемь независимых банков снимков: каждый мастер фиксирует нужный ему период, и несколько потребителей не мешают друг другу. Используйте их, когда нескольким модулям нужно отсечь один и тот же период в один момент; для одного модуля разности счётчиков выше проще.

  1. Взвести. Запишите PERIOD_ARM (0x0063): бит b = 1 заставляет банк b накапливать. Только что взведённый банк начинает пустым.

  2. Снимок. Запишите LATCH_BANK (0x0062) = b, затем команду 0x03 (LATCH_PERIOD). Отсечка берётся на следующей границе окна; банк начинает накопление с нуля. На шине Modbus те же записи можно отправить широковещательно (unit 0) для одной отсечки по нескольким модулям.

  3. Подождите. После шагов CMD_SEQ дождитесь, пока WIN_SEQ вырастет на 2 (около 200 ms).

  4. Чтение. Банк находится по адресу 0x2000 + b·0x800 (Modbus input 0x7000 + 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 после его фиксации

См. Примеры.