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(defineRBAMP_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:
WireArduino-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)