11 · Журнал изменений
История версий внешнего компонента rbamp для ESPHome. Эта страница повторяет CHANGELOG.md в репозитории, который является каноническим источником.
Публичные релизы продолжаются с v1.9.0; промежуточные версии ниже выпускались только внутренне.
Contents:
- v1.9.1 — 2026-11-01
- v1.9.0 — 2026-10-21
- v1.8.1 — 2026-10-18
- v1.8.0 — 2026-10-17
- v1.7.0 — 2026-09-30
- v1.6.0 — 2026-09-04
- v1.5.0 — 2026-08 (только внутренний выпуск)
- v1.4.0
- v1.3.0
- Политика устаревания
- Руководство по обновлению
v1.9.1 — 2026-11-01
Банки снимков STD в YAML, модели клипс 50 A и 100 A и понятное сообщение, когда модуль с заводской парой отклоняет запись конфигурации.
Добавлено
-
Банки снимков (
period_banks:) для модулей, которые их объявляют (16-битная линейка, образ 0x7E и новее): средняя мощность за период, энергия, пики и длительность периода по любому из восьми банков модуля, фиксируются поinterval:и/или новым действиемrbamp.latch_bank. Энергия за период — это значения за период (state_class: measurement), а не счётчики. Первая фиксация после загрузки или перезапуска модуля только запускает период. Пример:example/std_banks.yaml. -
Тесты логики банков на хосте:
tests/host/test_std_bank.cpp(обычныйg++, без фреймворка). -
Реестр моделей датчиков: коды 11 (50 A, 33 Ω) и 13 (100 A, 20 Ω) теперь охарактеризованы и принимаются без подсказки «reserved».
Фиксировано
- На прошивке 1.4.22 и новее модуль, поставляемый в паре (класс
WIRED_CT/BUILTIN_CT), отказывает в записи класса и модели при обычной работе, даже сct_model_force: true(принудительная запись работает только в заводском режиме). Компонент теперь сообщает «factory-paired module: configuration locked» вместо общей ошибки параметра, а отклонённая одиночная записьct_model:больше не сохраняется и не сопровождается коррекцией номинала.
v1.9.0 — 2026-10-21
Публичные релизы возобновляются с этой версии; промежуточные версии выпускались только внутренне.
Переключение номинала SCT без потери заводской точности (линейка 8 бит), плюс защитные исправления из выпусков 1.8.x, вошедшие в этот публичный релиз.
Добавлено
- SCT-013-060 и -100 принимаются (раньше на стороне клиента отклонялись как зарезервированные); границы клипирования модели датчика обновлены по измеренным значениям.
-
Коррекция переключения номинала SCT (модули с классом датчика SCT-013, прошивка ≤ 1.4.19). Каждый модуль SCT откалиброван на заводе датчиком -030; выбор другого
ct_model:раньше оставлял ток/мощность/энергию в шкале -030. Теперь компонент завершает запись модели перезапуском модуля, который требует процедура (сохранение → сброс → повторное определение с проверкой UID), считывает коэффициент, который модуль реально применяет, и масштабирует ток, активную и реактивную мощность и интеграцию энергии под номинал выбранного датчика — заводская поправка на конкретный экземпляр сохраняется. Напряжение и коэффициент мощности не затрагиваются. Перезапуск модуля (собственный или внешний) обнаруживается, и коррекция пересчитывается автоматически. Если применённый коэффициент выходит за ±5 % от значения калибровочной модели, компонент выдаёт предупреждение и не масштабирует. Изменений YAML не требуется. -
Прошивка 1.4.20+ выполняет переключение номинала на устройстве и сообщает об этом — компонент это определяет и не меняет показания (обычная запись модели, без перезапуска).
-
Проверка на хосте логики решения о коррекции:
tests/host/test_sct_rating.cpp(обычныйg++, без фреймворка).
v1.8.1 — 2026-10-18
Фиксировано
-
Защита заводской калибровки для
sensor_class:/ct_model:(линейка 8 бит). Прошивка сбрасывает модели каналов и формы линейности при любой записи класса датчика (даже неизменённого значения) и заново применяет общий пресет при любой записи модели ТТ — компонент теперь никогда не записывает значение, которое устройство уже имеет, и отклоняет изменения класса/модели из YAML на модуле, откалиброванном парой с встроенным датчиком (классыWIRED_CT/BUILTIN_CT), с явной записью в журнал. Новая опция службыct_model_force: trueосознанно переприменяет пресет; схема отклоняет её без ключа модели, поэтому она не может «сработать» из YAML. -
Чтение за границами массива на модулях 5/7 каналов (UI5/UI7): цикл публикации восстановления при загрузке индексировал 3-слотовые экспортные массивы до канала 6 и мог опубликовать мусорное значение в соседний датчик. Исправлено той же проверкой каналов, что уже была в остальных точках экспорта; размеры массивов теперь закреплены ассертами на этапе компиляции.
-
Документация/комментарии выровнены по окну измерения семейства 100 мс (прошивка v1.2+; 200 мс только на старых образах).
v1.8.0 — 2026-10-17
Суммарная энергия на устройстве для 16-битной линейки.
Добавлено
-
Энергия из собственных счётчиков устройства (модули с 16-битной картой, которые объявляют их в битовой карте возможностей): компонент перестаёт интегрировать Вт·ч сам и накапливает собственные счётчики модуля — итоги переживают перезапуски и ESP32, и модуля, без дрейфа интеграции. Микроразрешение (µWh/µvarh) на прошивке, которая его публикует, иначе автоматический грубый откат. Каждый снимок читается одной согласованной транзакцией I²C, а опубликованные суммы остаются монотонными при перезапусках модуля и сбросах счётчиков.
-
Новые датчики суммарной энергии:
energy_total,energy_exported_total,energy_net(импорт − экспорт, может уменьшаться),reactive_energy,reactive_energy_exported. -
Ключ конфигурации
start_current_ua:(0 = выкл., 10..2540 с шагом 10 µA): ниже этого тока канал не накапливает энергию — без нагрузки измеренная мощность — это шум любого знака, который иначе попадал бы и в импорт, и в экспорт. Показания не затрагиваются. Проверяется схемой, сохраняется на устройстве с проверенной записью. -
Трёхфазные поверхности:
voltage_angle_b/voltage_angle_c(градусы относительно фазы A) иphase_sequence(1 прямой · 2 обратный · 3 аномальный), публикуются на прошивке, которая их предоставляет; иначе «unknown». -
Функции-аксессоры в lambda:
get_std_image_version(),get_phase_sequence_str(),read_start_current_ua().
v1.7.0 — 2026-09-30
Поддержка новой линейки модулей с 16-битной картой регистров, определяется автоматически по тому же YAML.
Добавлено
-
Поддержка двух линеек: при загрузке проверка идентичности определяет модули с 16-битной картой и переключает транспорт (указатель big-endian, пакетные чтения с автоинкрементом). Число каналов, вариант и возможности берутся из блока обнаружения устройства —
topology:и количество слотов в YAML больше не нужны для определения набора сущностей. 8-битные модули работают точно как раньше. -
Датчики реального времени на 16-битной линейке публикуются из фиксированных регистров устройства; энергия использует атомарные снимки фиксации устройства с интеграцией по часам мастера и тем же сохранением в NVS.
-
Ключи конфигурации (
sensor_class:,ct_model:,new_address:) работают на 16-битной линейке через её поэтапный блок конфигурации с синхронно проверенным сохранением. Моделиct_models:по каналам на этой линейке требуют, чтобы устройство объявляло постоянные карты по каналам (бит возможности); компонент громко отказывает, а не теряет запись молча. -
Автоматическое восстановление после перезапуска модуля в процессе работы: компонент обнаруживает потерю взведённого накопителя, взводит и заново подготавливает его, пропуская одно окно вместо тихой остановки накопления энергии.
-
Сброс NVS при чистом выключении (перезагрузка/OTA больше не теряет до последнего интервала сохранения энергии).
v1.6.0 — 2026-09-04
Модели ct_models: по каналам для всех каналов (0..15), реестр моделей датчиков и исправление сохранения. Требуется прошивка v1.4.18+ для старших каналов 3+.
v1.5.0 — 2026-08 (только внутренний выпуск)
Добавлено
- Поддержка старших артикулов UI5/UI7: каналы 3–6 читаются через окно доступа к каналам (показатели реального времени и энергия по каналам за период), слоты энергии NVS расширены до 7 каналов.
Добавлено
-
Модели CT для каждого канала на всех каналах.
ct_models:в YAML теперь принимает до 16 записей. Количество применяемых записей определяет распознавание варианта модуля; лишние записи дают предупреждение, а не ошибку. -
Реестр моделей датчиков — список моделей берётся из единого реестра. Два жёстко заданных списка (словарь
CT_MODELSиCT_MODEL_ALLOWED_PER_CLASS) заменены единым поиском в реестре. Добавление нового артикула CT теперь — правка реестра, без выпуска библиотеки.
Фиксировано
- v1.6.0 добавляет SAVE после цикла применения. Прежние версии использовали путь сохранения, закрытый заводским режимом, для модели CT и класса датчика — на производственном модуле привязка применялась в RAM, но терялась при перезагрузке. v1.6.0 сохраняет через
CMD_SAVE_USER_CONFIG(без ограничений). Пользователи прежних версий в промышленной эксплуатации молча теряли привязку модели CT при каждой перезагрузке — обновитесь до отгрузки устройств.
v1.4.0
Распознавание старших артикулов (варианты с 5/7 каналами), окно доступа к каналам для метрик реального времени и необязательный ключ latch_interval:, который отвязывает частоту фиксации/энергии от частоты чтения (update_interval:). Энергия остаётся монотонной и точной: интеграция использует фактическое время настенных часов между событиями фиксации.
v1.3.0
Первый публичный релиз. Многоканальный и многомодульный парк с синхронизацией защёлки общего вызова (fleet_gc_enable: + group_id:), двухфазная фиксация адреса (производственно-готово, без режима заводской настройки), загрузка с записью «чтение-сравнение-запись», обнаружение функций по возможностям, поверхность идентификации для lambda (get_variant_str(), get_uid_hex(), ...), сохранение энергии в NVS.
Политика устаревания
Что компонент обещает не ломать без предупреждения и что он может менять:
| Поверхность | Стабильность | Что мы обещаем |
|---|---|---|
Ключи YAML блока rbamp: |
Стабильно | Удаление или переименование возможно только при мажорном обновлении. Предупреждение об устаревании появляется в журнале до удаления. broadcast_latch: и topology: сохранены в схеме для обратной совместимости. |
Ключи YAML sensor.platform: rbamp (слоты) |
Стабильно | Те же правила. Имена voltage/current/power/energy/frequency/power_factor зафиксированы как контракт с панелью энергии HA. |
Набор сущностей HA и их device_class / state_class |
Стабильно | Мы не будем менять это без объявления; это влияет на entity_id в HA. |
Методы RbAmpComponent::*, доступные из lambda |
Нестабильно | Это может меняться в минорных релизах. Если вы пишете действия lambda против них, зафиксируйте версию компонента (ref: в external_components:). |
| Формат структуры NVS | Версионирование | Изменения сопровождаются повышением версии раскладки — старые данные отбрасываются и никогда не читаются неверно. |
Имена и поведение блока i2c: |
Внешняя | Это ядро ESPHome, не наше — следуйте вышестоящей политике. |
Руководство по обновлению
До v1.9.0 (с любой более ранней версии)
- Задайте
ref: v1.9.0вexternal_components:. - Изменения YAML не требуются. Один и тот же YAML работает для обеих линеек модулей; компонент определяет подключённый модуль при загрузке.
topology:не нужен. - Если вам нужны итоги энергии по всем каналам на модуле STANDARD (STD), добавьте
energy_total/energy_exported_total/energy_net(см. 09 §2.3). - Если в YAML указаны
sensor_class:илиct_model:для модуля, поставляемого откалиброванным вместе с установленным датчиком, компонент теперь отказывает в изменении и пишет об этом в лог. Для таких модулей удалите эти ключи. - Если вы переключили номинал SCT через
ct_model:, показания теперь остаются точными; перезапуск модуля во время переключения нормален на прошивке до 1.4.19. ct_model_force: true— только служебная опция; схема отклоняет её безct_model:/ct_models:.- Значения энергии по каналам в NVS сохраняются при обновлении; новые датчики общего итога стартуют с 0 при первой загрузке и затем накапливают (их слот NVS отдельный).
Начиная с v1.3 / v1.4
- Обновите
ref:. SCT_013_100(код 5) иSCT_013_060(код 7) принимаются.- При необходимости добавьте
fleet_gc_enable:/group_id:для синхронизированных снимков в установке из нескольких модулей (модули BASIC).
Исходный код и задачи: rb-amp/rbamp-esphome · эта страница в репозитории: docs/11_changelog.md (v1.9.1)