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

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

История версий внешнего компонента rbamp для ESPHome. Эта страница повторяет CHANGELOG.md в репозитории, который является каноническим источником.

Публичные релизы продолжаются с v1.9.0; промежуточные версии ниже выпускались только внутренне.

Contents:


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 (с любой более ранней версии)

  1. Задайте ref: v1.9.0 в external_components:.
  2. Изменения YAML не требуются. Один и тот же YAML работает для обеих линеек модулей; компонент определяет подключённый модуль при загрузке. topology: не нужен.
  3. Если вам нужны итоги энергии по всем каналам на модуле STANDARD (STD), добавьте energy_total / energy_exported_total / energy_net (см. 09 §2.3).
  4. Если в YAML указаны sensor_class: или ct_model: для модуля, поставляемого откалиброванным вместе с установленным датчиком, компонент теперь отказывает в изменении и пишет об этом в лог. Для таких модулей удалите эти ключи.
  5. Если вы переключили номинал SCT через ct_model:, показания теперь остаются точными; перезапуск модуля во время переключения нормален на прошивке до 1.4.19.
  6. ct_model_force: true — только служебная опция; схема отклоняет её без ct_model: / ct_models:.
  7. Значения энергии по каналам в NVS сохраняются при обновлении; новые датчики общего итога стартуют с 0 при первой загрузке и затем накапливают (их слот NVS отдельный).

Начиная с v1.3 / v1.4

  1. Обновите ref:.
  2. SCT_013_100 (код 5) и SCT_013_060 (код 7) принимаются.
  3. При необходимости добавьте fleet_gc_enable: / group_id: для синхронизированных снимков в установке из нескольких модулей (модули BASIC).

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