02 · Линейки модулей
Модули rbAmp выпускаются в линейках: BASIC и STANDARD (STD). Линейка модулей — это полный комплект аппаратной ревизии и прошивки, а не программный флаг. Переход между линейками требует физической смены SKU, а не обновления прошивки.
Что такое линейка модулей
С точки зрения компонента и пользовательского кода: один дескриптор и один 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 (на стороне мастера)
rbamp_read_power(dev, 0, &p)подписано, поэтому:
#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
- Установки, которым нужны реактивная мощность, коэффициент мощности и гармоники в дополнение к активной мощности
Как определить линейку модуля во время работы
rbamp_begin():
/* 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 на корпусе модуля как на источник истины для точного продукта.
Где в документации отмечены зависящие от линии детали
В тексте компонента и в каноническом документе функции, зависящие от линии, помечаются явно, например:
— эта функция недоступна на модуле BASIC (ESP_ERR_NOT_SUPPORTED).
Или, наоборот, поведение, специфичное для BASIC:
: счётчик rbamp_energy_wh(dev, ch) монотонен — экспорт в сеть не учитывается. Для двунаправленного учёта см. сценарий «Двунаправленный учёт на стороне мастера» в 06_examples.md или используйте модуль STD.
Что дальше
-
03 · Выбор токового датчика — какой SCT-013 для какой задачи
-
04 · Проводка — особенности аппаратуры
-
06 · Примеры — сценарии для BASIC, включая двунаправленный учёт на стороне мастера
-
09 · Справочник API — полный публичный API
Исходники и задачи: rb-amp/rbamp-esp-idf · эта страница в репозитории: docs/02_tiers.md (v1.7.3)