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

02 · Линейки модулей

Модули rbAmp выпускаются в линейках: BASIC и STANDARD (STD). Линейка модулей — это полный комплект аппаратной ревизии и прошивки, а не программный флаг. Переход между линейками требует физической смены SKU, а не обновления прошивки.

Что такое линейка модулей

Линейки модулей BASIC и STANDARD (STD) бок о бок.

С точки зрения компонента и пользовательского кода: один дескриптор и один API rbamp_* обслуживают обе выпускаемые линии модулей. rbamp_begin() определяет, является ли модуль за дескриптором BASIC или STD (rbamp_line()), а вызовы, существующие только на одной из них, на другой возвращают ESP_ERR_NOT_SUPPORTED. Различия проявляются в значениях, которые возвращает модуль, в дополнительных величинах, которые измеряет модуль STD, и в том, как прошивка обрабатывает данные (в частности — экспорт в сеть).

Текущее состояние

Модули BASIC и STANDARD (STD) выпускаются, и оба поддерживаются этим компонентом (версия 1.7.3).

Линейка модулей Статус в этом компоненте
BASIC ✅ выпускается — RBAMP_LINE_BASIC
STANDARD (STD) ✅ выпускается — RBAMP_LINE_STD

BASIC — линейка модулей учёта потребления начального уровня

Аппаратное обеспечение

Экономичный аналоговый тракт для типичных бытовых нагрузок. Модуль включает изолированный аналоговый фронтенд, встроенный стабилизатор питания и заводскую калибровку, хранящуюся во флеш.

Поведение прошивки

Логика классического механического дискового счётчика — счёт идёт только вперёд, экспорт в сеть не вычитается.

Три "слоя" значений активной мощности ведут себя по-разному:

Сигнал Значение Поведение на BASIC
rbamp_read_power(dev, ch, &p) мгновенная мощность RT, обновляется примерно каждые 100 мс знаковая — отрицательное значение видно в реальном времени (экспорт)
snap.avg_p[ch] (внутри rbamp_read_period_snapshot) средняя мощность за период каждое окно средней P по 100 мс ограничивается до max(P, 0) перед добавлением в накопитель периода
rbamp_energy_wh(dev, ch) Накопленные Wh компонентом монотонный — только потребление, экспорт не учитывается

Иными словами: пользователь видит экспорт в RT-показаниях, но счётчик Wh компонента на BASIC его не учитывает.

Типичные применения

  • Домохозяйства без собственной генерации (без солнечных панелей, ветряков, аккумуляторных систем)

  • Субсчётчики для чисто потребляющих нагрузок (водонагреватели, моторы, бытовая техника)

  • Система мониторинга потребления, где двунаправленный учёт не нужен

Двунаправленный учёт на BASIC (на стороне мастера)

Как формируется энергия на модуле BASIC (интегрируется на мастере) и на модуле STANDARD (STD) (счётчики в самом устройстве).
Если нужно отдельно учитывать экспорт в сеть на модуле BASIC,делайте это на стороне мастера. Мощность RTrbamp_read_power(dev, 0, &p)подписано, поэтому:

C
#include "esp_timer.h"
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"

static double consume_wh = 0.0;
static double export_wh  = 0.0;

void bidirectional_loop(rbamp_handle_t dev) {
    int64_t t_prev_us = esp_timer_get_time();

    while (1) {
        /* Sample RT power at 10 Hz. Slower polling loses resolution
         * on sharp load transitions; faster adds little for typical
         * mixed loads with an inverter. */
        vTaskDelay(pdMS_TO_TICKS(100));

        int64_t t_now_us = esp_timer_get_time();
        double  dt_s     = (double)(t_now_us - t_prev_us) / 1e6;
        t_prev_us = t_now_us;

        float p;
        if (rbamp_read_power(dev, 0, &p) != ESP_OK) continue;

        double dwh = (double)p * dt_s / 3600.0;
        if (p >= 0.0f) consume_wh += dwh;
        else           export_wh  += -dwh;
    }
}

Полный рабочий пример этого шаблона — в 06_examples.md, сценарий «Двунаправленный учёт на стороне мастера».

STANDARD (STD) — линейка модулей с расширенными измерениями

Модули STD поддерживаются тем же API rbamp_*; rbamp_begin() определяет их. Сверх того, что предлагает BASIC, модуль STD даёт:

  • Знаковая энергия. Импорт и экспорт — отдельные величины, а модуль хранит сохраняемые счётчики за весь срок службы (Вт·ч / вар·ч, плюс более тонкое разрешение в новой прошивке). Экспорт не обрезается: энергия периода — это разность двух показаний счётчика (rbamp_std_read_energy() / rbamp_std_energy_delta()), а rbamp_energy_wh() на таких модулях несёт знаковое нетто-значение.

  • Ещё величины: реактивная и полная мощность по каждому каналу (rbamp_read_reactive_power(), rbamp_read_apparent_power(), rbamp_std_read_channel()), итоги по фазам и общие, а после включения извлечения гармоник — THD и коэффициент смещения мощности. Трёхфазные модули также сообщают углы фаз напряжения и порядок фаз.

  • Механизмы периода: банки снимков (восемь независимых периодов, привязанных к мастеру) на модулях, которые их имеют, либо разности счётчиков на модулях, которые хранят энергию на устройстве. Механизм выбирается в rbamp_begin() (rbamp_std_info_t.period_source).

  • Модель CT — только метка. На модуле STD модель CT — лишь метка и не задаёт коэффициент усиления.

  • Часы модуля, история на устройстве и журнал событий, состояние и диагностика, обновление прошивки по I²C, сертификат устройства и аттестация.

Всё это описано в 09 · Справочник API, глава «Линия STD». Рабочий пример — examples/std_meter/ (см. 06 · Примеры, Сценарий 18).

Поведение, отличающееся от BASIC

Тема BASIC STD
Экспорт в rbamp_energy_wh() не учитывается (монотонно, только потребление) знаковое — чистое, импорт минус экспорт
Реактивная / полная мощность, THD недоступно — на BASIC реактивная мощность этой библиотекой не выводится (ESP_ERR_NOT_SUPPORTED) доступно
Источник периода снимок накопителя периода банки снимков или разности счётчиков
Часы модуля нет задайте её через rbamp_std_set_time() после каждого сброса модуля
rbamp_factory_reset() поддерживается ESP_ERR_NOT_SUPPORTED
Дайджест (rbamp_read_digest()) поддерживается на прошивке с этой возможностью ESP_ERR_NOT_SUPPORTED
Вызовы периода на модуле без банков снимков и без счётчиков — ESP_ERR_NOT_SUPPORTED

Типичные применения

  • Дома с солнечной генерацией на крыше, ветрогенераторами или аккумуляторами
  • Генерирующие нагрузки, зарядка электромобилей V2G
  • Установки, которым нужны реактивная мощность, коэффициент мощности и гармоники в дополнение к активной мощности

Как определить линейку модуля во время работы

Блок-схема для определения, какой у вас модуль: BASIC или STANDARD (STD).
Линейка продукта определяется за вас поrbamp_begin():

C
/* BASIC or STD — available after rbamp_begin() */
rbamp_line_t line = rbamp_line(dev);    /* RBAMP_LINE_BASIC / RBAMP_LINE_STD */

/* Full SKU — cached by rbamp_begin(), no bus traffic */
rbamp_variant_t variant = rbamp_variant(dev);   /* UI1 / UI2 / ... / I3 / UI5 / UI7 */

/* Voltage-sensing presence (UI* variants vs I*-only) */
bool voltage_hw = rbamp_has_voltage_hw(dev);

/* Number of current channels (1 / 2 / 3 / 5 / 7) */
uint8_t channels = rbamp_channels(dev);

/* Firmware: BASIC — REG_VERSION byte; STD — register-map version */
uint8_t fw = rbamp_firmware_version(dev);

/* STD only: identity, capabilities and the period mechanism */
rbamp_std_info_t info;
if (rbamp_line(dev) == RBAMP_LINE_STD && rbamp_std_info(dev, &info) == ESP_OK) {
    /* info.capabilities, info.n_voltage, info.n_current, info.period_source */
}
Примечание

: rbamp_line() отличает BASIC от STD. Ориентируйтесь на обозначение SKU на корпусе модуля как на источник истины для точного продукта.

Где в документации отмечены зависящие от линии детали

В тексте компонента и в каноническом документе функции, зависящие от линии, помечаются явно, например:

Только STD

— эта функция недоступна на модуле BASIC (ESP_ERR_NOT_SUPPORTED).

Или, наоборот, поведение, специфичное для BASIC:

BASIC

: счётчик rbamp_energy_wh(dev, ch) монотонен — экспорт в сеть не учитывается. Для двунаправленного учёта см. сценарий «Двунаправленный учёт на стороне мастера» в 06_examples.md или используйте модуль STD.

Что дальше


Исходники и задачи: rb-amp/rbamp-esp-idf · эта страница в репозитории: docs/02_tiers.md (v1.7.3)