rbAmp
RU
Магазин
Документация
Обновлено · Редактировать на GitHub (Edit on GitHub)

04 · Проводка

В этой главе описано физическое подключение модуля rbAmp к хосту Python: распиновка низковольтной стороны, требования к питанию, совместимость уровней I²C, длина шины и стандартные контакты по умолчанию для каждого типа хоста. Поддерживаемые хосты — CPython на Linux SBC и x86 + USB-I²C, а также MicroPython на ESP32 / RP2040 / STM32 / Pyboard.

Пользователь работает только с низковольтной стороной (питание + I²C + необязательный DRDY); всё, что касается сети, остаётся внутри корпуса.

Безопасность

⚠ Безопасность сети. Сетевое напряжение может убить. Отключите и заблокируйте цепь перед подключением клемм L/N или установкой клещей; подключение к сети и любые работы внутри щитка поручайте квалифицированному специалисту. Охватывайте клещами один проводник (L) — никогда весь кабель (охват L и N даёт показание около 0). Сами клещи бесконтактные.

Провод и предохранитель (подключение напряжения). Достаточно AWG26–22 — датчик напряжения потребляет очень мало тока. Предохранитель в линии L обязателен, номиналом до 0.1 A.

Распиновка низковольтной стороны

Низковольтный разъём модуля: VCC, GND, SDA, SCL и необязательный вывод DRDY, с указанием требований каждого.

Модуль работает с логикой I²C 3.3 В и терпим к 5 В на сигнальных линиях. Все выводы LV полностью гальванически изолированы от сети.

Вывод Сигнал Цель
VCC +5 V (4.5..5.5 V) Питание модуля; минимум 4.5 В для корректной работы
GND Земля Общее с хостом — обязательно
SDA SDA I²C Данные I²C
SCL I²C SCL (линия тактирования) Тактовая частота I²C
DRDY Data-ready (опционально) Открытый сток, низкий импульс ~10 мкс каждые ~100 мс

Мощность

Параметры VCC

  • Номинальное напряжение: 5 В DC
  • Допустимый диапазон: 4.5..5.5 В
  • Ток питания: ~15 мА типично, ~25 мА пик при записи во flash
  • Пульсации: < 50 мВ от пика до пика (для точности измерения)

На модуле установлен бортовой стабилизатор, RC-фильтр, керамические конденсаторы и ферритовая бусина — дополнительной фильтрации со стороны пользователя не требуется. Питать модуль можно от шины +5V или 5V0 любого хоста (Raspberry Pi, контакт 2/4; USB-5V ESP32 DevKitC; V+ Pyboard и т. д.).

Совместимость уровней I²C

  • SDA / SCL работают на логике 3.3 В (встроенные подтяжки подтягивают линии к 3.3 В).

  • Линии терпят 5 В, но все упомянутые ниже хосты (Raspberry Pi / семейство ESP32 / RP2040 / STM32 / Pyboard) уже работают на логике 3.3 В — преобразователи уровня не нужны.

  • USB-адаптер I²C pyftdi (FT232H / MCP2221) также работает на логике 3.3 В — прямое подключение.

Поведение при включении

  • Холодный старт: ~250 мс до первого корректного результата.
  • После сброса (программного или по провалу питания): около 250 мс на восстановление.
  • До первого валидного результата регистры читаются как 0, а флаг DATA_VALID = 0.

Пакет ждёт готовности модуля внутри dev.begin() — пользовательский код просто вызывает begin() (или использует контекстный менеджер with RbAmp(bus, 0x50) as dev:, который вызывает begin() в __enter__ автоматически).

Изоляция

Сам модуль целиком низковольтный — высоковольтной измерительной цепи на нём нет. Ток измеряется CT-клещами, которые связываются магнитно снаружи изолированного проводника, без электрического контакта с сетевым проводом. На вариантах с измерением напряжения (UI) единственная опорная точка сети — клеммы L–N, которые подаются на гальванически изолированный* делитель измерения; варианты только для тока не имеют подключения к сети вовсе. Следствия:

  • GND модуля не подключён к фазе или нулю сети.
  • Подключение низковольтной стороны к хосту Python безопасно — риска короткого замыкания через землю нет.
Безопасность

⚠ Не вскрывайте корпус модуля — это лишает заводской калибровки.

Встроенные подтягивающие резисторы — на плате

Важно: каждый модуль rbAmp поставляется со встроенными подтягивающими резисторами 4.7 kΩ на SDA и SCL к 3.3 В. Для одного модуля на шине внешние подтяжки не нужны — подключайте хост напрямую.

Когда отключать встроенные подтяжки

Если на шине несколько модулей rbAmp (или другие устройства I²C со своими подтяжками), их параллельное подключение даёт слишком низкое эквивалентное сопротивление, что:

  • Увеличивает потребление тока шиной
  • Может превышать максимальный ток стока выходного каскада ведущего I²C
  • Добавляет ёмкостную нагрузку на длинной шине, почти не улучшая помехоустойчивость

Решение: на нижней стороне платы каждого модуля, рядом с подтягивающими резисторами, есть перемычки под пайку (шелкография Pull-Up). Перережьте их острым лезвием:

  • Оставьте подтяжки включёнными только на одном модуле (или перенесите их в одну точку рядом с хостом).

  • Перережьте перемычки на остальных модулях.

Практическое правило

Где оставлять подтягивающие резисторы I²C для одного-трёх модулей на коротком шине и для четырёх и более, и как перерезать перемычки.

Модули rbAmp на шине Подтяжки
1 Оставьте как есть (встроенные 4.7 кОм работают)
2 Держать на одном, резать на другом
3 Перережьте на всех модулях, установите одну внешнюю пару 2.7…3.3 кОм рядом с хостом
4…6 Перережьте на всех модулях, установите одну внешнюю пару 2.2…2.7 кОм рядом с хостом
7…16 Разрыв на всех модулях, один внешний пару 1.5…2.2 kΩ рядом с хостом; проверьте ёмкость шины (≤ 400 пФ), при необходимости снизьте скорость шины

Внешние значения — рекомендуемые (рассчитаны по спецификации I²C: ток стока ≤ 3 мА при 3.3 В, ёмкость шины ≤ 400 пФ). Подключайте внешние подтяжки к 3.3 В (логический уровень шины), а не к питанию VCC 5 В.

Если сомневаетесь

: измерьте сопротивление между SDA и VCC при выключенных устройствах. Оно должно быть в диапазоне 1.5..4.7 кОм. Меньше — значит, параллельно включено слишком много активных подтяжек.

Параметры шины I²C

  • Адрес по умолчанию: 0x50 (7-битный)
  • Диапазон адресов: 0x08..0x77 (переназначаемый на заводе)
  • Рекомендуемая скорость на MicroPython + ESP32: 50 кГц — снижает базовый паттерн NACK с прошивкой v1 (см. раздел ниже).

  • Рекомендуемая скорость на CPython + Linux SBC: 100 кГц (паттерн NACK не проявляется через драйвер ядра I²C — путь Linux smbus2 не имеет проблемы с повторами, описанной для ESP-IDF).

  • Многобайтный доступ: чтения могут выполняться пакетом (несколько байт в одной транзакции); записи идут побайтно, каждая с явным адресом регистра. Пакет делает это правильно сам; пользовательский код этого не видит.

Длина шины

I²C — короткая шина (около 15 см по умолчанию). Многие подключают модули проводами низкого качества, которые собирают много помех и теряют много передач, отсюда короткое ограничение. Рекомендуемые топологии для rbAmp:

Кабель Макс. длина Скорость
Стандартный JST / плоский 4-жильный до 0.15 м 100 кГц
Витая пара UTP (cat-5/5e/6) — SDA+GND и SCL+GND в отдельных парах до 1 м 100 кГц
Витая пара + буфер I²C (PCA9515 / TCA9617) до 3 м 100 кГц
Дифференциальная шина (PCA9615 / LTC4332) до 100 м 100 кГц
Безопасность

При длине более 0.15 м витая пара обязательна: SDA и SCL должны быть в разных парах, каждая со своей землёй. SDA и SCL в одной паре создают перекрёстную ёмкость, которая искажает фронты.

⚠ Внутри электрошкафа экранируйте кабель I2C. Сильные магнитные поля рядом с силовыми проводниками, контакторами и трансформаторами наводят помехи в неэкранированном кабеле. Держите кабель как можно короче и вдали от силовой проводки.

Многомодульная шина — основная топология

Основной сценарий библиотеки — несколько модулей rbAmp на одной шине I²C, которой управляет один ESP32 / Raspberry Pi / SBC через RbAmpFleet. Все правила и оптимизации ниже рассчитаны именно на эту топологию; один модуль — частный случай (тот же дескриптор, а вызовы флота вырождаются в тривиальные).

Несколько модулей на одной шине I²C со встроенными подтяжками, перерезанными, и одна внешняя пара на мастере, плюс три варианта DRDY.

Типичные развёртывания

Сценарий Конфигурация Число модулей
Канон 80%: вводной щиток дома + субсчётчики 1× UI1 (вход, учёт энергии сети) + 3-6× UI1/I1 (нагрузки) 4-7
Субпанель с разбивкой по токам 1× UI1 (вход) + 1–2× I2/I3 (ток по цепям) 3-5
Промышленный субучёт 1× UI1 (вход) + N× I2/I3 (на машину, разбивка тока) до ~16

Электрические пределы

  • Количество модулей: до ~16 (общая ёмкость шины ≤ 400 пФ при 100 кГц; при 50 кГц запас больше).
  • Подтяжки для шины флота (важно): каждый модуль поставляется со встроенными 4.7 кОм. На шине из нескольких модулей N подтяжек работают параллельно → сток перегружен, и шина не может опуститься до LOW. Начиная с 4 модулей (или раньше на шине длиннее 15 см) перережьте встроенные подтяжки на всех модулях, кроме одного — при 2–3 модулях на шине длиной до 15 см оставьте их как есть, этот случай измерен (или перережьте на всех и оставьте только внешнюю пару (2.7…3.3 кОм для 3 модулей, меньше для больших шин — см. таблицу выше) до 3.3 В в одной точке шины — рекомендуется для длинных линий, шумных условий и ESP32 в роли мастера).
  • Внутренние подтяжки ESP32 (~45 кОм) слишком слабые для шины из нескольких модулей с реальной длиной дорожек — нужны внешние подтяжки (значения см. в таблице выше). Это часть трёхуровневой защиты от зависания шины на слабой шине — см. 10 · Устранение неполадок, раздел «Скрипт зависает / падает по таймауту».

Адресация — настройка и замена в полевых условиях (допустимо в production)

Настройка модулей по одному: на шине при назначении рабочего адреса остаётся только один модуль на адресе по умолчанию.

Адрес заводского модуля по умолчанию — 0x50. Каждый новый или заменяющий модуль проходит провизионирование (один раз): смена адреса с 0x50 на рабочий адрес и, опционально, сохранение настроек (модели CT, group_id, label) во flash. Режим завода не нужен — смена адреса работает прямо в продакшене через двухфазный коммит.

Способ 1 — низкоуровневые prepare_address_change / commit_address_change (текущий API):

Python
dev.prepare_address_change(0x52)   # arms candidate, 5 s window
dev.commit_address_change()        # magic 0xA5 + CMD_COMMIT_ADDR + reset
time.sleep(0.3)                     # boot window
# dev.address is now == 0x52

Способ 2 — обёртка RbAmpFleet (рекомендуется для развёртываний из нескольких модулей):

Python
from rbamp import RbAmpFleet

fleet = RbAmpFleet(bus)
fleet.scan()
fleet.assign_address(dev, 0x52)   # two-phase + reset + handle rebind

Протокол на проводе (для справки):

Text
1. write candidate_addr → REG_I2C_ADDRESS (0x30, in RAM)
2. write 0xA5 → REG_ADDR_COMMIT_MAGIC (0x31, armed; 5-second window)
3. issue CMD_COMMIT_ADDR (opcode 0x30 in REG_COMMAND)
4. wait ~700 ms (flash erase + write)
5. issue CMD_RESET (opcode 0x01) — CMD_COMMIT_ADDR does not auto-reset
6. wait ~300 ms; the module responds at the new address
Безопасность

✅ Чтение адреса: REG_I2C_ADDRESS (0x30) при загрузке возвращает активный адрес. После перезагрузки, которая идёт за фиксацией, чтение 0x30 показывает новый активный адрес. Во время подготовки регистр повторяет кандидата до фиксации. Библиотека гарантирует сброс состояния взведения через try/finally при частичном сбое — RbAmpTimeoutError, если окно истекло.

⚠ Дисциплина provisioning — ТОЛЬКО один девственный модуль за раз.

Самая частая причина сбоя подготовки — более одного модуля с заводским адресом 0x50 на шине. Различить их по I²C физически невозможно (открытый сток с wired-AND — оба модуля подтверждают одинаково, а чтение данных будет «смешанным»).

Поэтому правило строгое (нормативное MUST, а не рекомендация): в момент вызова prepare_address_change() на шине должен быть ровно один модуль на 0x50 (новый или возвращённый к заводским настройкам отдельным стендовым инструментом).

Путь восстановления, если подозреваете нарушение дисциплины: 1. Перезапустите питание всех модулей. 2. Физически отключите все, кроме одного «девственного» модуля. 3. Вызовите prepare_address_change() на шине с одним модулем. 4. Добавляйте остальные модули по одному, настраивая каждый отдельно.

Бюджет энергии шины

На 50 кГц одна транзакция чтения ≈ 200–400 мкс. Полный блок RT для одного канала (U + I + P + PF) ≈ 5–8 мс на канал.

Конфигурация Шина за цикл При 50 кГц Макс. частота опроса
1× UI1, блок RT ~5 мс < 5 мс 100+ Гц (но модуль обновляется с 10 Гц)
5× UI1, блок RT ~25 мс ~25 мс до 10 Гц
16× I3, RT + период ~400 мс 400 мс > 100 мс не успевает за модулем (10 Гц); в лучшем случае ~2 Гц
Примечание

Цифры — оценочные.

Правило: при 50 кГц комфортные пределы — 8–10× I3 или 15–16× UI1 при опросе 5 Гц (каждое второе окно модуля), и примерно половина этого при полных 10 Гц.

Синхронизация периодов — выравнивание периодов

Для учёта тарифов все модули должны снимать снимок за один и тот же интервал.

Одна широковещательная команда заставляет все модули сделать свой снимок периода в один и тот же момент.

Стратегия 1 — последовательный снимок + общее установление (любая прошивка):

Python
import time

# Phase 1: sequential snapshot
for m in meters:
    m.latch_period()

# Phase 2: common settle (≥ 50 ms)
time.sleep(0.050)

# Phase 3: read the snapshots with skip_latch=True
snaps = [m.read_period_snapshot(skip_latch=True) for m in meters]

Skew: 16 модулей × ~1 мс на снимок = ~16 мс относительно 60-секундного периода = 0.027%. Для типичного мониторинга пренебрежимо мало.

Стратегия 2 — широковещательный снимок General Call (требуется включить на каждом модуле):

Все модули берут снимок одним кадром I²C по адресу 0x00:

Text
addr=0x00 | A5 27      (5 bytes)

Skew = 0 (атомарно). Предварительная настройка (один раз на каждом модуле флота):

  1. dev.write_reg(0x27, 0x01) (устанавливает флаг GC_ENABLE регистра FLEET_CONFIG)
  2. dev.save_user_config()
  3. dev.reset() (ожидание ~300 мс)

Подтверждение: для каждого ожидаемого ведомого прочитайте REG_PERIOD_VALID (0x07). !=1 → переход к стратегии 1.

Безопасность

⚠ Включение GC (C.10): если GC выключен на всём флоте, адрес GC получает NACK. Мастер получает жёсткую ошибку (а не тихий сброс) — это обнаруживается, а не является багом.

Фильтрация по группе GC (шина с несколькими арендаторами)

REG_GROUP_ID (0x28) позволяет иметь несколько доменов GC на одной шине:

  • group = 0x00 → вызов всех.
  • group = N → снимок берут только модули с REG_GROUP_ID = N.

Пример использования — разделение тарифных групп.

Режимы сбоя

Симптом Причина Что делать
i2c bus scan показывает несколько модулей по одному адресу после добавления в установку Новый модуль на 0x50 конфликтует Сначала переназначьте его отдельно, потом добавьте
Один модуль отвечает NACK чаще остальных Обрыв кабеля / провал VCC Проверьте VCC под нагрузкой
После кадра GC один модуль не делает снимок GC_ENABLE в FLEET_CONFIG выключен или группа не совпадает Проверьте REG_FLEET_CONFIG и REG_GROUP_ID

Подробные многомодульные сценарии — в 06 · Examples.

Хосты CPython (Linux SBC + x86)

Raspberry Pi (любая модель)

Шина I²C 1 выведена на 40-контактный разъём. На большинстве моделей (1B+ / 2 / 3 / 4 / 5) выводы одинаковы:

rbAmp 40-контактный разъём RPi GPIO (BCM)
VCC контакт 2 (+5V) —
GND пин 6 (или любой GND) —
SDA пин 3 GPIO 2 (SDA1)
SCL контакт 5 GPIO 3 (SCL1)
DRDY (optional) любой свободный GPIO с поддержкой прерываний

Включите драйвер I²C ядра: sudo raspi-config → 3 Interface Options → I2C → Yes. Или отредактируйте /boot/firmware/config.txt (/boot/config.txt в старых выпусках Raspberry Pi OS) вручную:

Text
dtparam=i2c_arm=on
dtparam=i2c_arm_baudrate=100000   # 100 kHz (default 100 kHz)

Установите утилиту сканирования и разрешите своему пользователю открывать шину (после этого выйдите из системы и войдите снова), затем проверьте, отвечает ли модуль:

Shell
sudo apt install i2c-tools
sudo usermod -aG i2c $USER
i2cdetect -y 1        # should show 0x50

Использование из Python:

Python
from smbus2 import SMBus
from rbamp import RbAmp

with SMBus(1) as bus:
    with RbAmp(bus, 0x50) as dev:
        print(dev.voltage, "V")

Установка smbus2: pip install smbus2 (или системный sudo apt install python3-smbus).

Orange Pi 5 / Rock Pi 5 / другие Linux SBC

Тот же smbus2.SMBus(N), где N — номер шины из /dev/i2c-N. Обычно /dev/i2c-1 или /dev/i2c-0. Проверьте:

Shell
ls /dev/i2c-*
i2cdetect -y 1     # should show 0x50

Распиновка зависит от конкретной платы — смотрите её даташит.

x86 / Windows / macOS — через USB-I²C адаптер

На хостах x86 нативного I²C нет. Решение — USB-адаптер I²C (FT232H, MCP2221, Bus Pirate v4, CH341). pyftdi.i2c.I2cController сам по себе не имеет ни сигнатуры, совместимой с smbus2 (read_byte_data / write_byte_data), ни сигнатуры MicroPython (readfrom_mem / writeto_mem), поэтому передать его напрямую в RbAmp(...) нельзя; автоопределение шины выбросит RbAmpParamError.

Для x86-адаптеров нужен тонкий класс-обёртка, реализующий интерфейс бэкенда с утиной типизацией (read_byte / write_byte / register_acks / now_ms — см. 09 · API Reference, раздел «Bus autodetect»). Для других адаптеров напишите свою обёртку по образцу _io_smbus.py / _io_micropython.py.

Хосты MicroPython

ESP32 / ESP32-S2 / ESP32-S3 / ESP32-C3

Python
from machine import I2C, Pin
from rbamp import RbAmp

# ESP32 DevKitC default I²C pinning
i2c = I2C(0, scl=Pin(22), sda=Pin(21), freq=50_000)   # 50 kHz recommended on ESP32
with RbAmp(i2c, 0x50) as dev:
    print(dev.voltage, "V")
Чип SDA / SCL по умолчанию (рекомендуется) Порт I²C
ESP32 (оригинальный / WROOM / DevKitC) GPIO 21 / GPIO 22 I2C(0, ...)
ESP32-S2 GPIO 21 / GPIO 22 (то же соглашение) I2C(0, ...)
ESP32-S3 GPIO 8 / GPIO 9 (по умолчанию для платы N16R8) I2C(0, ...)
ESP32-C3 GPIO 5 / GPIO 6 I2C(0, ...)

Для других чипов проверьте прошивку MicroPython вашего ESP32 (mpremote eval 'help(machine.I2C)').

Raspberry Pi Pico / Pico W (RP2040)

Python
from machine import I2C, Pin
from rbamp import RbAmp

# Pico — two hardware I²C blocks (I2C0 and I2C1)
i2c = I2C(0, scl=Pin(1), sda=Pin(0), freq=100_000)   # 100 kHz OK on RP2040
with RbAmp(i2c, 0x50) as dev:
    print(dev.voltage, "V")

Pico не страдает от базового паттерна NACK — MachineI2CBackend автоматически определяет RP2040 и понижает значение повторов по умолчанию до 1 попытки.

STM32 / Pyboard / Nucleo (через MicroPython)

Python
from machine import I2C
from rbamp import RbAmp

# Pyboard — soft-I²C or hardware I²C block
i2c = I2C(1, freq=100_000)   # bus 1 — X9/X10 on the Pyboard
with RbAmp(i2c, 0x50) as dev:
    print(dev.voltage, "V")

STM32 не страдает от базового паттерна NACK — MachineI2CBackend снижает число повторов по умолчанию до 1 попытки на этих платах.

Базовый паттерн NACK на MicroPython ESP32 — 50 кГц

При работе под MicroPython на ESP32 текущая прошивка rbAmp демонстрирует частые NACK на 100 кГц, заметно реже на 50 кГц. Это относится к стеку I²C ESP-IDF, на котором работает MicroPython для ESP32. На других портах MicroPython (RP2040 / STM32 / Pyboard) проблема не проявляется.

Пакет закрывает это двумя уровнями:

  1. Скорость по умолчанию 50 кГц — рекомендуется передавать freq=50_000 в machine.I2C(...) на ESP32.

  2. Повтор на уровне байта в MachineI2CBackend — по умолчанию 3 попытки с паузой 5 мс. Настраивается через расширенный API:

Python
from rbamp._io_micropython import MachineI2CBackend
from rbamp import RbAmp

backend = MachineI2CBackend(i2c, retry_attempts=5, retry_gap_ms=5)
dev = RbAmp(backend, 0x50)   # the address is a parameter of RbAmp, not of the backend

Подробнее о диагностике проблем на уровне шины — см. 10 · Troubleshooting. Счётчики MachineI2CBackend.retry_exhaustion_count и RbAmp.sanity_reject_count доступны для наблюдения при длительных прогонах.

DATA_READY (DRDY)

Необязательный вывод для оптимизации опроса. Если приложение опрашивает модуль не чаще раза в 100 мс, DRDY можно не подключать.

Электрические параметры

  • Тип выхода: открытый сток (без активной подтяжки к VCC)
  • Уровень покоя: HIGH (нужен подтягивающий резистор на стороне хоста — встроенный pull-up GPIO или внешний резистор; рекомендуется 10 kΩ к 3.3 В)

  • Импульс готовности: LOW примерно на 10 мкс после обновления регистров RT свежими данными

  • Частота импульсов: ~10 Гц (один импульс на окно RT ~100 мс)

Семантика

Спадающий фронт на DRDY гарантирует, что все регистры RT синхронизированы и опубликованы (прошивка атомарно обновляет их в ISR перед тем, как опустить вывод). После спадающего фронта мастер может читать блок RT без риска получить расщеплённую выборку.

Шаблон с прерыванием на MicroPython

Python
from machine import Pin
import uasyncio as asyncio
from rbamp import RbAmp

DRDY_PIN = 15
drdy_event = asyncio.Event()

def drdy_irq(pin):
    drdy_event.set()   # ISR-safe — Event.set() is atomic on uPy

async def bidir_task(dev):
    while True:
        await drdy_event.wait()
        drdy_event.clear()
        try:
            p = dev.read_power(0)
            # ...integrate + publish...
        except Exception as e:
            print("read failed:", e)

# In main:
drdy = Pin(DRDY_PIN, Pin.IN, Pin.PULL_UP)
drdy.irq(trigger=Pin.IRQ_FALLING, handler=drdy_irq)
asyncio.run(bidir_task(dev))

Шаблон на CPython (Linux SBC)

На Raspberry Pi через gpiozero или RPi.GPIO:

Python
from gpiozero import Button
from threading import Event
from rbamp import RbAmp

drdy_event = Event()
drdy = Button(15, pull_up=True, bounce_time=None)   # GPIO 15 as an example
drdy.when_pressed = lambda: drdy_event.set()       # falling edge

while True:
    drdy_event.wait()
    drdy_event.clear()
    try:
        p = dev.read_power(0)
        # ...integrate + publish...
    except Exception as e:
        print("read failed:", e)

DRDY — необязательный вывод: опрос с любой частотой ≤ 10 Гц работает и без него. Пакет ни в одном пути не зависит от DRDY.

Модули STANDARD (STD)

Модули STD используют ту же проводку I²C, те же соображения о подтяжках, тот же адрес (по умолчанию 0x50) и те же параметры шины, что описаны в этой главе, и тот же конструктор RbAmp(bus, addr). Библиотека определяет линейку модуля в begin(); никакой дополнительной проводки или настройки не требуется.

  • Вызовы только для STD (энергия на устройстве, углы напряжений, пусковой ток, …) выбрасывают RbAmpNotSupportedError на модуле BASIC.

  • Некоторым возможностям STD нужен достаточно свежий образ модуля; на старом образе вызов возбуждает RbAmpNotSupportedError ("not available").

  • Учёт энергии на устройстве, угла и пускового тока проверены на CPython (smbus2). Путь MicroPython для 16-битных регистров реализован, но ещё не проверен на оборудовании — для этих функций предпочтительнее хост на CPython (Raspberry Pi и другие Linux SBC, см. выше), пока заметка о выпуске не скажет иное.

См. 09 · API Reference.

  • 05 · Быстрый старт — первый рабочий скрипт для обоих бэкендов

  • 06 · Примеры — рабочие сценарии (включая многомодульную шину и асинхронную потоковую передачу)

  • 09 · API Reference — детали бэкенда и доступ к счётчикам повторов и проверок

  • 10 · Устранение неполадок — отладка на уровне шины, шаблон NACK, дисциплина повторов и фильтра достоверности


Исходники и вопросы: rb-amp/rbamp-python · эта страница в репозитории: docs/04_hardware.md (v1.6.1)