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

11 · Журнал изменений

Полная подробная история — в CHANGELOG.md в корне репозитория; эта глава содержит короткую версию.

1.6.2 — энергия STD остаётся на счётчиках, строки реестра моделей, ошибка заблокированного модуля

  • STD, образы со счётчиками и банками защёлок: такой модуль теперь сохраняет readPeriodSnapshot() / energy() на своих сохранённых счётчиках (раньше он тихо переключался на энергию, интегрированную на хосте из банка 0). Вызовы банков stdArmBanks() / stdLatch() / stdReadLatch() остаются доступными и управляются только возможностью банков. Библиотека 1.6.2 — минимальная для такого образа; см. Источник энергии и минимальная версия библиотеки.

  • Новый пример 12_StdBanks: два периода с таймингом по мастеру на собственных банках снимков.

  • Реестр моделей датчиков: строки клещей 2000:1 на 50 А (код 11) и 100 А (код 13) принимаются.

  • setCTModelChForce() на заводски спаренном модуле BASIC вне заводского режима (прошивка 1.4.22+) возвращает RB_ERR_MODE ("configuration locked") и ничего не сохраняет; принудительная запись работает только в заводском режиме.

1.6.1 — энергия микроразрешения STD, коррекция номинала SCT-013, защита конфигурации датчика

Выпущено вместе с 1.6.0 (линия STD) как первый публичный выпуск двухлинейной библиотеки.

  • Линейка STD: счётчики энергии микроразрешения (µWh / µvarh), пусковой ток для энергии (stdSetEnergyStartCurrent() / stdReadEnergyStartCurrent()), фазовый угол напряжения (RbAmpStdVoltage::angle_deg) и порядок фаз (stdReadPhaseSequence()) — для модулей, образы которых их публикуют (образ 0x0001007B или новее); старые модули работают точно как раньше. stdEnergyDelta() покрывает новые поля.

  • Линия BASIC — коррекция номинала SCT-013: на прошивке до 1.4.19 включительно канал, переключённый на другую модель SCT-013, читается относительно усиления, которое применяет модуль. begin() читает каждый канал и масштабирует ток / мощность / мощность периода (и выведенную из них энергию); коэффициент мощности и напряжение не меняются. Новое: sctRatingRefresh(), sctRating(), sctRatingScale(), sctPresetGain(). Прошивка 1.4.20 и новее исправляет себя сама. Сеттеры модели перезапускают модуль после сохранения на той прошивке, которой это нужно (+ ~0.5 с на каждый вызов).

  • Сеттеры класса датчика и модели CT сначала читают, потом пишут (setSensorClass(), setCTModel(), configureChannels()): сохранённую конфигурацию можно применять заново при каждой загрузке, не трогая калибровку модуля. Модуль класса WiredCT / BuiltinCT не перенастраивается (RB_ERR_MODE); setCTModelChForce() — сервисный путь. Новое: readSensorClass(), RbAmp::sensorModel() / RbAmp::sensorModelRatedA() (поиск в реестре с текущими пределами модели).

  • SCT-013-060 и -100 принимаются (раньше на стороне клиента отклонялись как зарезервированные); границы клипирования модели датчика обновлены по измеренным значениям.

  • Обе линии: окно измерения / частота публикации задокументированы как 100 мс (200 мс сохранены только как примечание для старых образов); число каналов никогда не может превышать RBAMP_MAX_CHANNELS (каналы сверх него возвращают RB_ERR_PARAM); модульные тесты на хосте (extras/host_tests) запускают реальные исходники против имитации шины.

  • RbAmpStdEnergy получил новые поля в этой версии: если приложение сохраняет его как сырой двоичный блок, храните в собственном фиксированном формате только нужные поля.

1.6.0 — линия STD (16-битная регистровая модель)

Одна библиотека, обе линейки продуктов: begin() определяет, говорит ли модуль на BASIC (8 бит) или STD (16 бит, фиксированная точка) регистровой модели, и внутри направляет каждый вызов — набор методов одинаков на обеих линейках.

  • line() (RbAmpLine::Basic / RbAmpLine::Std); единые функции чтения на STD (readVoltage(phase), readCurrent(), readPower() …) плюс новые readReactivePower() / readApparentPower() (только STD).

  • API блока STD: stdInfo(), stdReadChannel(), stdReadTotals(), stdReadVoltage(), stdReadHealth(), stdReadConfig(), stdSetHarmonics(), stdCalThdFloor(); банки защёлок (stdArmBanks(), stdLatch(), stdReadLatch(), stdLatchWh()); счётчики за всё время (stdReadEnergy(), stdEnergyDelta()).

  • Источник периода выбирается по возможностям модуля (банки защёлок или сохранённые счётчики); энергия защёлки переживает сброс модуля; снимок периода получил avg_p_total, wh_net, module_restarted.

  • Идентичность, часы, история: stdIdentify(), RbAmp::stdProbe(), stdReadImageVersion(), stdReadBoardId(), stdSetTime() / stdReadTime(), stdHistInfo() / stdHistRead() / stdHistReadRaw() / stdEventRead() / stdHistFlush(), stdCommand() / stdWaitIdle() / stdLocate(), RbAmp::stdSetAddressByUid().

  • Конфигурация и команды работают на STD (setSensorClass(), setCTModel(), configureChannels(), saveUserConfig(), saveGains(), смена адреса); каждая команда ждёт, пока модуль сообщит о завершении, и проверяет вердикт. На STD модель CT — только справочная метка.

  • Обновление прошивки по I²C: stdOtaBegin() → stdOtaWritePage() → stdOtaCommit() → stdOtaActivate(), stdOtaWritePreparedImage() (образы, подготовленные производителем), stdOtaDiag(), stdOtaAbort(), stdOtaBoardOk().

  • Линия готовности данных и события на обеих линиях: setDrdyPin(), waitDataReady(), readAllReady(), readDataSeq(), beginEventFlags(), setEventMask() / readEventMask(), setEventThresholds(); readEventFlags() / clearEventFlags() / hasError() работают на модулях STD, которые предоставляют блок событий.

  • Вызовы только для BASIC (factoryReset(), General-Call и хелперы меток, readCapability(), readCommitSeq(), readPeriodLatchMs()) возвращают RB_ERR_NOT_IMPLEMENTED на экземпляре STD. Изменений API BASIC нет.

  • Пример 11_StdLine.

1.5.0 — модели CT по каналам + реестр моделей датчиков

  • setCTModel(channel, code) / configureChannels() привязывают любой канал, включая каналы 3+ старших SKU (через окно каналов); каждая запись подтверждается обратным чтением, а модель, которую модуль не принимает, сообщается как RB_ERR_PARAM (канал сохраняет предыдущую модель).

  • readCTModelCh() охватывает все каналы.

  • Сгенерированный реестр моделей датчиков RbAmpSensorModels.h (define RBAMP_CT_*, описатели, rbamp_sensor_model_lookup()); проверка модели ТТ ведётся по реестру (клиент отклоняет только коды, которых нет в реестре — решение о принятии принимает модуль). RbAmpCTModel — замороженный псевдоним для семи кодов SCT-013.

  • Настройка модели CT / класса датчика теперь сохраняется на серийных модулях (CMD_SAVE_USER_CONFIG).

  • Пример 10_PerChannelModels.

1.4.0 — поддержка старших артикулов (UI5/UI7)

Добавляет поддержку 7-канальных модулей старших артикулов (UI5, UI7) и обновляет пример широковещания GC. Проверено на кремнии на разнородном флоте (UI1/UI2/UI3/UI5/UI7), контракт прошивки bd2ad8e.

Добавлено

  • Пример 09_SeniorSku — опрос 7 каналов + интегрирование энергии для модулей UI5/UI7.

  • readCommitSeq() — чтение счётчика коммитов прошивки.

Изменено

  • RBAMP_MAX_CHANNELS повышен с 3 до 7. Существующие скетчи, использующие массивы RbAmpSnapshot, станут больше — нужна перекомпиляция (правки исходников не нужны, если вы не зашивали размеры массивов в код).

  • 03_MultiModuleBroadcast переписан под широковещательную защёлку General-Call v1.3 (согласованная синхронизация одним кадром заменяет прежнюю последовательную защёлку по устройствам).

  • Регенерированные заголовки регистров (контракт v1.4.0).

  • Энергия/снимок: расширение массивов для старших артикулов и диспетчеризация по числу каналов.

1.3.0 — флот + протокол v1.3

Приводит библиотеку Arduino в соответствие с контрактом провода rbAmp v1.3 и кросс-платформенной эталонной моделью (STM32 HAL / ESP-IDF / Python). Проверено на аппаратуре на разнородном флоте (UI1 + I2 + I3) через публичный API с эталоном по сырым регистрам (набор 38/38 с полным покрытием + расширенный прогон app-WDT).

Добавлено

  • RbAmpFleet — менеджер нескольких модулей: scan() шины (с обнаружением коллизий), пакетный pollAll(), суммарные по флоту totalPower() / totalEnergyWh() / pollErrors(), синхронизация General-Call (enableGcAll() / gcLatch() / checkSync()), assignAddress(), checkConflict() и provision() для подключения нового заводского модуля к шине.

  • Идентичность / возможности: readVariant(), readCapability(), readProductId(), readUid().

  • Канал событий: readEventFlags(), clearEventFlags(), hasError(), clearError(), readLastError().

  • Конфигурация CT по каналам: configureChannels() (пакетом, одно сохранение во флеш) и readCTModelCh() (зеркальное чтение применённой модели).

  • Примитивы флота на самом модуле: enableGc(), setGroupId(), readGroupId(), readGcTick(), readFleetConfig(), readLabel(), writeLabel(), saveUserConfig(), статический broadcastLatchGroup().

  • Пример 08_FleetSync (сканирование → синхронизация GC → агрегация).

  • Поле RbAmpSnapshot.implausible по полям: поле, не прошедшее фильтр физической корректности, устанавливается в NaN и помечается, а остальной снимок остаётся пригодным (полное чтение падает только при сбое транспорта).

Изменено

  • Энергия интегрируется по настенным часам мастера, никогда по диагностическому latch_ms микросхемы (диагностический таймер модуля, для энергии не предназначен). При устаревшем якоре периода интегрирование удерживается — следующее корректное окно не недосчитывается.

  • Коды моделей CT следуют принятому набору v1.3 по классам — Sct013 принимает {005, 010, 030, 050, 100, 020, 060}. REG_CT_MODEL — чистый staging: привязка через побканальную команду, привязки нескольких каналов не зависят от порядка и никогда не затирают канал 0.

  • Смена адреса — двухфазная фиксация (magic commit), допустимая в production; режим заводской настройки не требуется.

  • Определение варианта читает REG_HW_VARIANT; подсказка топологии конструктора теперь — запасной вариант для прошивки старше v1.3. Подсказка по умолчанию — Single (безопасно: нет ложных показаний отсутствующих каналов).

  • Записи I²C теперь используют ту же дисциплину повторов NACK, что и чтение (запись конфигурации, которая молча пропадает на занятой шине, иначе не видна).

  • setSensorClass() отвергает классы вне enum на стороне клиента (прошивка молча принимает неверный класс, поэтому защита клиента — единственный барьер).

Примечания

  • AVR: double — 32-битный (== float) в классическом тулчейне AVR, поэтому накопитель Wh теряет точность при долгом журналировании — сбрасывайте его периодически или используйте ядро с 32/64-битным double (ESP32, SAMD, STM32, RP2040).

  • Пограничная шина / ESP32: Wire Arduino-ESP32 оборачивает драйвер, который может зависнуть на занятой шине ниже уровня библиотеки. Используйте внешние подтяжки ~4.7 кОм, не используйте отладчик / NRST в продукции и включите прикладной сторожевой таймер задачи на задаче опроса как путь восстановления.

1.0.0 — первый выпуск

Учёт RT на одном устройстве (RMS U / I / P / PF / частота), интегрирование периодической энергии (Wh), настройка модели ТТ и класса датчика, смена адреса I²C.


Исходники и задачи: rb-amp/rbamp-arduino · эта страница в репозитории: docs/11_changelog.md (v1.6.2)