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

08 · примеры STD

Минимальные версии библиотек: Arduino 1.6.2 и ESP-IDF 1.7.3 для модуля с банками снимков и счётчиками энергии; Python 1.6.0; ESPHome 1.9.0. Вызовы банков снимков требуют Python 1.6.1 и ESPHome 1.9.1. Банки снимков в библиотеках: Arduino, ESP-IDF, ESPHome (period_banks:); в Python есть вызовы std_arm_banks, std_latch, std_read_latch, std_latch_wh.

Клиентские библиотеки читают модули STD и BASIC одними и теми же вызовами; величины, есть только у STD (реактивная и полная мощность, счётчики состояния, банки снимков), доступны за проверкой линии.

Платформа Пример Показывает
Arduino rbamp-arduino, examples/11_StdLine один скетч для обеих линеек: begin() определяет линейку; значения в реальном времени; счётчики здоровья; период, заданный мастером, на банке снимков 1
ESP-IDF rbamp-esp-idf, examples/std_meter Считывание данных счётчика STD с компонентом ESP-IDF
Python (CPython) rbamp-python, примеры пакета те же чтения на Raspberry Pi и серверах

Arduino: основа скетча

(Serial.printf, как в ядре Arduino для ESP32; на других платах используйте Serial.print.)

C++
#include 
#include 

static RbAmp dev(Wire, 0x50);

void setup() {
    Serial.begin(115200);
    Wire.begin();
    while (!dev.begin()) delay(1000);          // detects BASIC or STD
    if (dev.line() == RbAmpLine::Std) {
        dev.stdArmBanks((1u << 0) | (1u << 1)); // arm banks 0 and 1
        dev.stdLatch(1);                        // start the first period of bank 1
    }
}

void loop() {
    RbAmpSnapshot s;
    if (dev.readAll(s)) {
        Serial.printf("U=%.1f V  I=%.2f A  P=%.1f W\n", s.voltage, s.current[0], s.power[0]);
        if (dev.line() == RbAmpLine::Std)
            Serial.printf("Q=%.1f var  S=%.1f VA\n", dev.readReactivePower(0), dev.readApparentPower(0));
    }
    delay(1000);
}

Период, заданный мастером: вызовите dev.stdLatch(bank) на границе, подождите несколько длин окна, считайте его через dev.stdReadLatch(bank, L) и преобразуйте через RbAmp::stdLatchWh(...). Процедура на уровне регистров описана в Энергия и периоды.

Modbus RTU с Python (pymodbus, STD-UI1)

Чтение по UART-линиям модуля через последовательный адаптер (с внешним трансивером RS-485, где нужен). Установите переключатель режима интерфейса в Modbus по умолчанию (Modbus default) (9600 8N1, unit 1) или в Modbus RTU с вашими сохранёнными настройками. Написано для pymodbus 3.x (device_id=; более старые 3.x называют это slave=). Все многорегистровые значения — big-endian, сначала старшее слово (ABCD).

Python
import struct
from pymodbus.client import ModbusSerialClient

def i32(r, i):
    v = (r[i] << 16) | r[i + 1]
    return v - (1 << 32) if v & 0x80000000 else v

def i64(r, i):
    v = 0
    for w in r[i:i + 4]:
        v = (v << 16) | w
    return v - (1 << 64) if v & (1 << 63) else v

def f32(r, i):
    return struct.unpack(">f", struct.pack(">HH", r[i], r[i + 1]))[0]

client = ModbusSerialClient(port="/dev/ttyUSB0", baudrate=9600, parity="N", stopbits=1, bytesize=8)
client.connect()
UNIT = 1

# 1. Identity (input 0x6000): 'ST', map version, variant, status, frequency, window counter
r = client.read_input_registers(0x6000, count=33, device_id=UNIT).registers
assert r[0] == 0x5354                       # 'S','T'
print("map", hex(r[1]), "variant", hex(r[7]), "status", hex(r[9]), "f =", r[0x13] / 100, "Hz")

# 2. Voltage (input 0x6100): U_RMS, i32 mV
u = client.read_input_registers(0x6100, count=6, device_id=UNIT).registers
print("U =", i32(u, 0) / 1000, "V")

# 3. Current channel 0 (input 0x6200): I (µA), P (mW), Q (mvar), S (mVA), PF (Q10, signed)
c = client.read_input_registers(0x6200, count=9, device_id=UNIT).registers
pf = c[8] - 65536 if c[8] & 0x8000 else c[8]
print("I =", i32(c, 0) / 1e6, "A  P =", i32(c, 2) / 1000, "W  Q =", i32(c, 4) / 1000, "var  S =", i32(c, 6) / 1000, "VA  PF =", pf / 1024)

# 4. Energy (input 0x6B00): import / export / net in Wh (i64), then mWh at +0x14
e = client.read_input_registers(0x6B00, count=32, device_id=UNIT).registers
print("import", i64(e, 0), "Wh  export", i64(e, 4), "Wh  net", i64(e, 8), "Wh")

# 5. The same quantities as float32 profile values (input 0x0000)
flt = client.read_input_registers(0x0000, count=76, device_id=UNIT).registers
print("float32: V L1", f32(flt, 0x00), "I L1", f32(flt, 0x06), "P total", f32(flt, 0x34),
      "f", f32(flt, 0x46), "import kWh", f32(flt, 0x48), "export kWh", f32(flt, 0x4A))
client.close()

Коэффициент мощности имеет смысл только при рабочем токе нагрузки; без нагрузки он может показывать любое значение.

В профиле float32 однофазный модуль публикует свой канал как L1; L2 и L3 читаются как 0.0, так же как точки S и PF и каждый адрес вне списка в транспорте Modbus. Регистры конфигурации (0x8000: ID устройства, код скорости, формат кадра, виртуальные ID) читаются так же через read_holding_registers.

Modbus RTU с mbpoll (STD-UI1)

mbpoll читает модуль из командной строки. Установите переключатель режима интерфейса в Modbus default (9600 8N1, unit 1) и замените на ваш последовательный порт. Использованные опции: -0 (0-based: номера регистров, чтобы совпадать с картой регистров), -1 (one poll: один опрос), -B (порядок слов big-endian, старшее слово первым, для 32-битных значений), -o 2 (таймаут 2 s), -t 3 (входные регистры) или -t 4 (holding-регистры). Значение после -r — десятичное.

Shell
# configuration, holding 0x8000: unit id, baud code, frame format, ...
mbpoll -m rtu -b 9600 -P none -a 1 -0 -1 -o 2 -t 4 -r 32768 -c 10 

# identity, input 0x6000: 'ST', map version, variant, status, frequency, ...
mbpoll -m rtu -b 9600 -P none -a 1 -0 -1 -o 2 -t 3:hex -r 24576 -c 33 

# U_RMS, input 0x6100: one 32-bit value, mV
mbpoll -m rtu -b 9600 -P none -a 1 -0 -1 -o 2 -t 3:int -B -r 24832 -c 1 

# current channel 0, input 0x6200: I (µA), P (mW), Q (mvar), S (mVA) as four 32-bit values
mbpoll -m rtu -b 9600 -P none -a 1 -0 -1 -o 2 -t 3:int -B -r 25088 -c 4 

# float32 profile: V L1, V L2, V L3 (single-phase modules read 0 for L2/L3), I L1 (float)
mbpoll -m rtu -b 9600 -P none -a 1 -0 -1 -o 2 -t 3:float -B -r 0 -c 4 

# float32 profile: total P (float)
mbpoll -m rtu -b 9600 -P none -a 1 -0 -1 -o 2 -t 3:float -B -r 52 -c 1 

# float32 profile: frequency, import kWh, export kWh (float)
mbpoll -m rtu -b 9600 -P none -a 1 -0 -1 -o 2 -t 3:float -B -r 70 -c 3 

# energy in Wh, input 0x6B00: 64-bit values as 4 words each (import, export, ...)
mbpoll -m rtu -b 9600 -P none -a 1 -0 -1 -o 2 -t 3:hex -r 27392 -c 8 

Как выглядят ответы:

  • Конфигурация: десять регистров; на модуле с настройками по умолчанию первые три читаются как 1 (ID устройства), 2 (код скорости для 9600) и 0 (кадр 8N1).
  • Идентификация: [24576] читается как 0x5354 ('S','T'), [24577] — версия карты регистров (0x0036), [24583] — вариант (0x0011 для STD-UI1), [24585] — статус, [24595] — частота в 0.01 Hz (0x1388 = 50.00 Hz).
  • Чтения 32-битных целых (:int -B) выводят одно значение на два регистра: [24832] — напряжение в mV; [25088], [25090], [25092], [25094] — ток в µA и мощность, реактивная мощность и полная мощность в mW, mvar и mVA.
  • Чтение профиля float32 выдаёт одно значение на два регистра; точки перечислены в транспорте Modbus.
  • Энергия — 64-битное значение: mbpoll не имеет 64-битного типа, поэтому читайте четыре 16-битных слова и объединяйте их, сначала старшее.

ESPHome: I²C (STD-UI1)

Внешний компонент rbamp из rbamp-esphome читает модуль по I²C (компонент помещается в components/ рядом с YAML). При запуске он сообщает версию карты регистров, вариант, каналы и источник энергии. Датчики публикуются каждые 10 s.

YAML
esphome:
  name: std-ui1-i2c

esp32:
  board: esp32dev
  framework:
    type: arduino

logger:

i2c:
  sda: GPIO25
  scl: GPIO26
  frequency: 50kHz

external_components:
  - source:
      type: local
      path: components
    components: [rbamp]

rbamp:
  id: meter1
  address: 0x50
  update_interval: 10s

sensor:
  - platform: rbamp
    rbamp_id: meter1
    voltage:
      name: "Voltage"
    current:
      name: "Current"
    power:
      name: "Power"
    energy_total:
      name: "Energy import"
    energy_exported_total:
      name: "Energy export"

energy_total и energy_exported_total считают энергию, увиденную с момента запуска компонента (они восстанавливаются после перезапусков ESP). Это не счётчики полного срока службы модуля; читайте их с модуля (см. Энергия и периоды). Скорость шины 50 kHz рекомендуется для хостов ESP32.

ESPHome: Modbus RTU (STD-UI1)

Стандартный modbus_controller читает модуль по его UART-линиям: установите переключатель режима интерфейса в Modbus по умолчанию (Modbus default) (9600 8N1, unit 1). Подключите TX мастера к контакту 3 (SDA, RX модуля), а RX мастера — к контакту 4 (SCL, TX модуля) разъёма модуля — модуль принимает на контакте 3 и передаёт на контакте 4 — поэтому tx_pin — провод к контакту 3, а rx_pin — провод к контакту 4. Идентификатор контроллера не должен быть std: он конфликтует с пространством имён C++, и сборка падает.

YAML
esphome:
  name: std-ui1-modbus

esp32:
  board: esp32dev
  framework:
    type: arduino

logger:

uart:
  id: mod_bus
  tx_pin: GPIO25        # to the module's pin 3 (SDA, module RX)
  rx_pin: GPIO26        # from the module's pin 4 (SCL, module TX)
  baud_rate: 9600
  parity: NONE
  stop_bits: 1

modbus:
  id: modbus1
  uart_id: mod_bus

modbus_controller:
  - id: std_meter
    address: 1
    modbus_id: modbus1
    update_interval: 10s

sensor:
  # float32 profile points (input registers, ABCD)
  - platform: modbus_controller
    modbus_controller_id: std_meter
    name: "Voltage L1"
    register_type: read
    address: 0x0000
    value_type: FP32
    unit_of_measurement: V
    accuracy_decimals: 1
  - platform: modbus_controller
    modbus_controller_id: std_meter
    name: "Current L1"
    register_type: read
    address: 0x0006
    value_type: FP32
    unit_of_measurement: A
    accuracy_decimals: 3
  - platform: modbus_controller
    modbus_controller_id: std_meter
    name: "Power total"
    register_type: read
    address: 0x0034
    value_type: FP32
    unit_of_measurement: W
    accuracy_decimals: 1
  - platform: modbus_controller
    modbus_controller_id: std_meter
    name: "Frequency"
    register_type: read
    address: 0x0046
    value_type: FP32
    unit_of_measurement: Hz
    accuracy_decimals: 2
  - platform: modbus_controller
    modbus_controller_id: std_meter
    name: "Energy import (float profile)"
    register_type: read
    address: 0x0048
    value_type: FP32
    unit_of_measurement: kWh
    accuracy_decimals: 3
  - platform: modbus_controller
    modbus_controller_id: std_meter
    name: "Energy export (float profile)"
    register_type: read
    address: 0x004A
    value_type: FP32
    unit_of_measurement: kWh
    accuracy_decimals: 3
  # Native map: import energy in Wh, i64 big-endian (input 0x6B00)
  - platform: modbus_controller
    modbus_controller_id: std_meter
    name: "Energy import (native)"
    register_type: read
    address: 0x6B00
    value_type: S_QWORD
    unit_of_measurement: Wh
    accuracy_decimals: 0

Точки профиля float32 и нативный отчёт импортной энергии показывают одну и ту же энергию. Если ваш последовательный адаптер — RS-485, поставьте внешний трансивер между UART мастера и модулем (см. Аппаратная часть).

Без библиотеки

По Modbus любой стек Modbus может читать родную карту модуля или точки профиля float32 (input 0x0000); см. Начало работы.