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

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

Эта глава отражает CHANGELOG.md из корня репозитория. Публичные выпуски возобновляются с версии 1.7.2; промежуточные версии выпускались только внутри компании.

1.7.3 — энергия STD остаётся на счётчиках, модели клипс 100 А и 50 А, сообщение о заблокированном модуле (2026-11-01)

Фиксировано

  • Модули STD, которые сообщают и оба банка снимков (бит возможности 8), и счётчики энергии в самом устройстве (бит 13), например образ модуля 0x0001007E: энергия и вызовы периодов теперь работают с сохранёнными счётчиками. Раньше такой модуль без какого-либо предупреждения переключался на интегрирование на хосте по банку 0. Вызовы банков снимков (rbamp_std_arm_banks, rbamp_std_latch, rbamp_std_read_latch) — отдельный инструмент, зависящий только от бита 8, и на этих модулях работают как прежде. rbamp_std_info_t.period_source показывает фактически использованный источник.

Добавлено

  • README: раздел «линия STD» с минимальной версией компонента для образа модуля 0x0001007E и вызовами банка снимков.

  • Пример std_meter взводит свой банк 1 на каждом модуле, сообщающем банки фиксации, в том числе когда энергия берётся из счётчиков.

  • Название прошивки для BASIC REG_VERSION 0x0E: rbamp_basic_fw_name() возвращает «1.4.22» (все варианты BASIC).

  • Реестр моделей датчиков: модели клипсы 2000:1 с кодами 11 (50 А) и 13 (100 А) теперь описаны (номинал 50.0 А / 100.0 А, полная шкала 62.5 А / 116.5 А, пик 88.4 А / 164.7 А). Код 12 (80 А) сохраняется для модулей, уже привязанных к нему.

Изменено

  • rbamp_set_ct_model_ch_force() на модуле BASIC класса 2 или 3 возвращает ESP_ERR_INVALID_STATE со строкой журнала, называющей заблокированную конфигурацию, когда модуль отклоняет запись (прошивка 1.4.22 и новее отклоняет записи класса и модели на заводски спаренном модуле вне режима обслуживания). Раньше отказ проявлялся как общая ошибка параметра. Путь force на таком модуле работает только в режиме обслуживания.

1.7.2 — коррекция номинала SCT-013, возобновление после простоя мастера, чтение окна одной транзакцией (2026-10-21)

Первый публичный выпуск после 1.5.0. Он объединяет 1.6.0 – 1.7.2: линейку модулей STD за тем же дескриптором, линию готовности данных, события, энергию в µWh и фазовые величины, число каналов, которое следует за модулем (1, 2, 3, 5 или 7), реестр моделей датчиков с пределами ограничения, чтение окна одной транзакцией, возобновление после отказа мастера и коррекцию номинала SCT-013 для модулей линии по току, прошивка которых сохраняет калибровку 30 А (прошивка, сообщающая о возможности самокоррекции, исправляет себя сама). Аппаратная проверка этой линии выполнена на хосте с ESP-IDF 5.4.1.

Добавлено

  • SCT-013-060 и -100 принимаются (раньше на стороне клиента отклонялись как зарезервированные); границы клипирования модели датчика обновлены по измеренным значениям.
  • Переключение номинала SCT-013: модуль токового датчика класса 1 калибруется датчиком 30 А, а прошивка до 1.4.19 сохраняет эту калибровку после того, как пользователь привяжет другую модель. Теперь библиотека читает коэффициент, который модуль применяет, при rbamp_begin(), после записи модели и после каждого обнаруженного перезапуска модуля, и масштабирует ток, пиковый ток, активную мощность, среднюю мощность периода, интегрируемую энергию, дайджест и пороги событий под выбранную модель. Напряжение и коэффициент мощности не масштабируются. rbamp_sct_correction() сообщает результат по каждому каналу (rbamp_sct_correction_t: статус, модель, масштаб, применённый коэффициент), а rbamp_sct_refresh() пересчитывает по запросу. Коэффициент, всё ещё равный сырому пресету (модель переключена в этой загрузке без перезапуска), вызывает один CMD_RESET; неожиданный применённый коэффициент, неизвестная модель или сырой пресет, переживший сброс, оставляют показания без масштабирования с предупреждением. Модуль, который сообщает о возможности самокоррекции (прошивка 1.4.20 и новее), исправляет себя сам и получает масштаб 1 — определяется по возможности, а никогда по VERSION. CONFIG_RBAMP_SCT_RATING_CORRECTION (по умолчанию включено) отключает механизм.

  • rbamp_begin_resume() — rbamp_begin() без праймера фиксации. Модуль BASIC продолжает усреднять до следующей фиксации, поэтому после перезагрузки мастера или отключения первый учтённый снимок интегрирует окно самого модуля и восстанавливает энергию за время простоя. Последующие снимки используют часы мастера, как и прежде. Модули STD ведут себя ровно как с rbamp_begin().

  • rbamp_period_snapshot_t: module_window_ms (собственная длина зафиксированного окна модуля, 0 на STD; модуль считает фиксации по 100 мс на текущей прошивке и по 200 мс на прошивке до v1.2 — библиотека определяет это по самому снимку и сообщает в module_commit_ms), module_uptime_s, window_from_boot (окно началось при загрузке модуля: перезапуск или первая фиксация после загрузки) и window_long (более 6 ч, где среднее модуля теряет точность). На первом снимке после rbamp_begin_resume() module_restarted = window_from_boot.

  • rbamp_read_uptime_s() — секунды с момента загрузки модуля (BASIC и STD). Читает 0 на прошивке BASIC, которая его не публикует; тогда window_from_boot остаётся false.

  • rbamp_read_digest() — одно окно модуля BASIC одной транзакцией: статус, последовательность окна и выбранные поля (ток, напряжение, активная мощность в целых ваттах со знаком, коэффициент мощности) для каналов 0–2. Предназначено для чтения каждого опубликованного окна по линии готовности данных. rbamp_set_digest_fields() выбирает поля; библиотека записывает выбор в модуль и записывает повторно после обнаруженного перезапуска модуля. Нужна прошивка BASIC с возможностью дайджеста; на STD недоступно.

  • rbamp_basic_fw_name() — название релиза прошивки для байта версии BASIC («1.4.19» для 0x0B и так далее).

  • rbamp_read_sensor_class() — текущий класс датчика модуля.

  • rbamp_sensor_model_limits() — номинальный действующий ток модели датчика, действующий ток, при котором синусоида начинает клиппировать, и мгновенный потолок ограничения в А из сгенерированного реестра моделей (0, если неизвестно). rbamp_sensor_model_rated_a() — сокращённая форма номинала; учтите, что номинал может отличаться от ампер в названии модели.

  • Сгенерированный реестр моделей датчиков обновлён с этими пределами.

  • rbamp_set_ct_model_ch_force() — сервисный путь, который задаёт модель канала независимо от класса модуля и текущей модели. Он заменяет калибровку, которую несёт блок для этого канала, общим заводским пресетом модели; после него выполните калибровку.

Изменено

  • rbamp_set_ct_model(), rbamp_set_ct_model_ch() и rbamp_configure_channels() на модуле класса 1 без возможности самокоррекции (прошивка до 1.4.19) завершаются перезапуском модуля (CMD_RESET, тот же UID проверяется, около секунды): это единственный способ, которым модуль возвращается к своему калиброванному усилению после записи модели. Библиотека заново применяет то, чем владеет (праймер фиксации, маска дайджеста при следующем использовании); накопители периода перезапускаются, как после любого сброса модуля.

  • Транспорт больше не вызывает i2c_master_bus_reset() самостоятельно перед последней попыткой неудачной транзакции. Драйвер и так сбрасывает свой автомат после каждой неудачной транзакции, а явный сброс не берёт блокировку шины: когда другая задача имеет транзакцию в полёте, он формирует STOP на живых выводах, который обработчик прерывания драйвера может принять за конец чтения и упасть в ISR (наблюдалось на хосте с горячим подключением модуля). CONFIG_RBAMP_BUS_RESET_ON_RETRY_EXHAUSTION возвращает прежнее поведение для однозадачного мастера.

  • rbamp_set_sensor_class(), rbamp_set_ct_model(), rbamp_set_ct_model_ch() и rbamp_configure_channels() сначала читают, потом пишут. Класс или модель, которые модуль уже держит, не перезаписываются (записи по шине нет): на модуле запись класса очищает модели CT даже при неизменном значении, а запись модели заново применяет общий пресет поверх собственной калибровки модуля даже при неизменной модели, поэтому раньше повторное применение сохранённой конфигурации при каждом переподключении ухудшало показания. Модуль класса 2 или 3 (поставляемый и откалиброванный вместе со своим датчиком) не перенастраивается: ESP_ERR_INVALID_STATE. rbamp_configure_channels() решает весь запрос до первой записи, поэтому на таком модуле ничего не применяется наполовину.

  • Документация latch_ms: только для диагностики, под нагрузкой может показывать меньше; окно интегрирования энергии — master_dt_ms или module_window_ms.

  • Документация и справка Kconfig теперь указывают окно публикации модуля как 100 мс для всего семейства (старые образы: 200 мс). Отстой 300 мс, который библиотека применяет после защёлки STD, описан как безопасная верхняя граница. Поведение по времени не изменилось.

Фиксировано

  • rbamp_read_all() / rbamp_read_all_ready() на модуле с более чем тремя каналами (UI5/UI7, BASIC или STD) записывали каналы 3+ за пределы трёхэлементных массивов rbamp_snapshot_t: frequency, topology и channels перезаписывались (хост тогда видел channels = 0), а последний канал попадал на четыре байта за пределы структуры — в стек вызывающего. Теперь вызов заполняет только ch0-2 (RBAMP_SNAPSHOT_CHANNELS), точно как периодный снимок; ch3+ остаются за rbamp_read_channel() / rbamp_read_all_channels(). Найдено на хосте с 7-канальным модулем. Программная симуляция всего компонента на фейковом образе регистров теперь выполняет read_all для 1/3/5/7 каналов со сторожевыми словами за структурой.

1.7.1 — число каналов следует за модулем (2026-10-18)

Фиксировано

  • rbamp_new() создавал дескриптор с числом каналов, зафиксированным на трёх, поэтому однорканальный модуль (UI1, I1) после rbamp_begin() всё ещё сообщал три канала. Конструктор по умолчанию теперь берёт число каналов и наличие напряжения из регистра варианта модуля; три канала остаются запасным вариантом только для прошивки, которая не публикует вариант. rbamp_new_with_topology() по-прежнему фиксирует число как раньше (при расхождении с модулем пишется предупреждение). Сообщено с хоста с UI1; проверено там: модуль UI1 после rbamp_begin() сообщает один канал и вариант UI1.

  • rbamp_read_variant() на линии BASIC возвращал UNKNOWN для кодов UI5 / UI7; теперь сопоставляется каждый известный код.

Добавлено

  • rbamp_variant_t rbamp_variant(rbamp_handle_t dev) — вариант, закешированный rbamp_begin(), без трафика шины. RBAMP_VARIANT_UNKNOWN до rbamp_begin() или если модуль не публикует свой вариант.

  • Модульные тесты на хосте для политики вариантов обоих конструкторов (test/host/test_std_decode.c).

1.7.0 — энергия в µWh, пусковой ток, фазовые углы и последовательность (2026-10-17)

Поддержка образа модуля версии 0x0001007A / 0x0001007B. Каждое добавление зависит от того, что сообщает модуль; более старые модули работают точно так же, как раньше.

Проверено на модулях STD с версией образа 0x0001007B в прикладной программе на хосте: чтение и запись пускового тока с обратным чтением, фазовые углы и последовательность фаз на трёхфазном модуле, флаги точной энергии, разность энергии при перезапусках модуля.

Добавлено

  • Энергия с разрешением мкВт·ч / мкварч в rbamp_std_energy_t: act_import_uwh, act_export_uwh, act_net_uwh, rea_import_uvarh, rea_export_uvarh, ch_import_uwh[], ch_export_uwh[], а также fine / fine_reactive. Поля заполняются на каждом модуле: из собственных µ-счётчиков модуля, когда он их публикует (версия образа модуля 0x0001007A; реактивная — с 0x0001007B), иначе масштабируются из грубых счётчиков при fine = false — вызывающий может использовать µ-поля безусловно. Читаются как согласованные снимки (одна транзакция на блок). rbamp_std_energy_delta применяет к ним те же правила (смена поколения → нет дельты, падение аптайма = перезапуск, счётчик ниже предыдущего показания → 0, нетто = импорт − экспорт). rbamp_read_period_snapshot на пути счётчиков использует разность в мкВт·ч, когда она доступна.

  • Стартовый ток для энергии: rbamp_std_get_start_current / rbamp_std_set_start_current (мкА; 0 = выключено; значение вне набора, который принимает модуль → ESP_ERR_INVALID_ARG без записи по шине; читается обратно и подтверждается; rbamp_save_user_config сохраняет его). Ниже этого тока канала модуль энергию не учитывает; показания не затрагиваются. Также в rbamp_std_config_t (start_ua, start_ua_supported). ESP_ERR_NOT_SUPPORTED без трафика шины до версии образа модуля 0x0001007B.

  • Фазовый угол напряжения: rbamp_std_voltage_t.angle_deg / angle_valid (градусы относительно входа напряжения 0; версия образа модуля 0x0001007A+, трёхфазные модули; иначе angle_valid = false). Тот же однократный пакетный запрос, что и раньше.

  • Последовательность фаз: rbamp_std_read_phase_seq → rbamp_std_phase_seq_t (RBAMP_STD_PHASE_SEQ_NA / FORWARD / REVERSE / ABNORMAL); ESP_ERR_NOT_SUPPORTED без обращения к шине для версии образа модуля ниже 0x0001007A.

  • Модульный host-тест чистых функций декодирования: test/host/run.sh (gcc, без ESP-IDF). Правила дельты энергии теперь находятся в src/rbamp_std_decode.c.

Изменено

  • rbamp_is_provisioned (линия STD) документирует маркер калибровки версии образа модуля 0x0001007A: модуль, откалиброванный под более старой прошивкой, после обновления возвращает false, пока не выполнен один rbamp_save_gains.

Заметка об обновлении

  • Структура снимка энергии (rbamp_std_energy_t) получила поля в этой версии. Если приложение сохраняет её как сырой двоичный блок (NVS, файл), записывайте только нужные поля в свой фиксированный формат; блок, сохранённый старой версией, не совпадёт по размеру с новым.

1.6.1 — Завершение команд, согласованные чтения, проверки сессии OTA (2026-10-11)

Исправления библиотеки по итогам аудита прошивки/библиотеки от 2026-10-11. Нового API нет; поведение существующих вызовов на линии STD ужесточено.

Изменено

  • Завершение команды определяется регистром состояния команды модуля (флаг занятости сброшен и счётчик выполненных команд вырос), а не одним только регистром ошибок; вердикт читается только после завершения. Сохранения (rbamp_save_gains, rbamp_save_user_config), rbamp_std_cal_thd_floor, rbamp_reset, смена адреса и каждая команда OTA используют это — никаких фиксированных пауз установления на модулях, которые публикуют регистр; таймауты не меньше 1 с (3 с для фиксации OTA). Команда, записанная, пока модуль занят, сначала дожидается освобождения; команда, которую модуль сбросил (переполнение), завершается с ESP_ERR_INVALID_STATE, а не возвращает вердикт предыдущей команды.

  • Запись команды никогда не повторяется при ошибке транспорта (повтор мог бы доставить код операции дважды). Чтения и записи регистров данных повторы сохраняют.

  • Блочные чтения — одна транзакция: модуль отдаёт каждое чтение из согласованного снимка, поэтому счётчики энергии, блоки каналов и итоги больше не рассинхронизируются между пакетами. rbamp_read_all на модуле STD читает блок напряжения и каждый блок канала целиком, а не поле за полем.

  • OTA: после каждой страницы сессия должна оставаться открытой (статус 1); иначе — ESP_ERR_INVALID_STATE с причиной модуля в журнале — перезапустите с начала. Опросы во время зависания прошивки больше не сбрасывают шину. rbamp_std_ota_activate удерживается в течение пробного окна модуля ~10 с и подтверждает, что запущенный образ — подготовленная версия и что переключение больше не ожидает. rbamp_std_ota_write_image (образ, собранный на хосте и без подписи) возвращает ESP_ERR_NOT_SUPPORTED до обращения к модулю — прошивка модуля принимает только образы, подготовленные поставщиком.

  • Смена адреса (rbamp_commit_address_change, STD): сохранение конфигурации синхронное (ограничение частоты → ESP_ERR_NOT_FINISHED, повтор примерно через 5 с), а дескриптор переключается на новый адрес только после ответа модуля по нему; иначе — ESP_ERR_NOT_FOUND, и дескриптор сохраняет старый адрес.

  • rbamp_std_read_totals: поля энергии агрегированных блоков читаются как 0 (модуль их не заполняет — используйте rbamp_std_read_energy).

  • rbamp_read_frequency (STD): 0 от модуля означает отсутствие сети → ESP_ERR_INVALID_RESPONSE / NaN (rbamp_read_all помечает это как неправдоподобное).

  • rbamp_is_provisioned (STD): задокументирован как надёжный, начиная с версии образа модуля 0x00010079 (более старые образы также сообщают калибровку как валидную на коэффициентах по умолчанию).

1.6.0 — линейка модулей STD, линия готовности данных, события (2026-10-11)

Добавлено

  • Линия модулей STD (карта 16-битных регистров) за тем же дескриптором и API, что и исходная линия: rbamp_std_probe / rbamp_std_identify / rbamp_std_info, показания RT по каналам, включая реактивную и полную мощность (rbamp_read_reactive_power, rbamp_read_apparent_power, rbamp_std_read_channel, rbamp_std_read_voltage), итоги по фазам и общие (rbamp_std_read_totals), конфигурация и гармоники (rbamp_std_read_config, rbamp_std_set_harmonics, rbamp_std_cal_thd_floor).

  • Энергия на модулях без банков защёлки: источник периода выбирается по возможностям модуля при rbamp_begin (rbamp_std_info_t.period_source); энергия периода — разность двух показаний постоянных счётчиков с правилами перезапуска и сброса счётчиков. rbamp_std_read_energy (Wh / varh, плюс mWh по каналам и по группам на карте 0x36+), rbamp_std_energy_delta, rbamp_energy_add_wh, RBAMP_ENERGY_CH_TOTAL. В rbamp_period_snapshot_t добавлены avg_p_total, wh_net и module_restarted.

  • Банки фиксации на модулях, которые их имеют: rbamp_std_arm_banks, rbamp_std_latch, rbamp_std_read_latch, rbamp_std_latch_wh.

  • Часы модуля, история и журнал событий: rbamp_std_set_time, rbamp_std_read_time, rbamp_std_read_image_version, rbamp_std_hist_info, rbamp_std_hist_read, rbamp_std_hist_read_raw, rbamp_std_event_read, rbamp_std_hist_flush (часовой кольцевой буфер постоянен; 15-минутная запись — только последняя).

  • Состояние: rbamp_std_read_health расширен битами статуса, сроком службы и источниками калибровки, счётчиками кадров, аптаймом, а также причиной сброса и числом загрузок (версия образа модуля 0x00010076 и новее, RBAMP_STD_RST_*).

  • Команды и сервис: rbamp_std_command, rbamp_std_wait_idle, rbamp_std_locate, rbamp_std_read_board_id, rbamp_std_ota_board_ok (проверка платы перед потоковой передачей OTA), rbamp_std_set_address_by_uid.

  • OTA: обновление образа с двумя банками, включая подготовленные подписанные образы (rbamp_std_ota_begin … rbamp_std_ota_activate, rbamp_std_ota_write_prepared, rbamp_std_ota_write_prepared_pair, rbamp_std_ota_diag, rbamp_std_ota_staged_version, rbamp_std_ota_abort).

  • Сертификат и аттестация: rbamp_std_read_certificate, rbamp_std_attest (проверку подписи выполняет приложение).

  • Линия готовности данных (DRDY), обе линейки модулей: rbamp_set_drdy_gpio, rbamp_wait_data_ready, rbamp_read_all_ready, rbamp_read_data_seq. Одна линия с открытым стоком может делиться несколькими модулями; библиотека проверяет последовательность публикаций, считает пропущенные окна, сообщает задержку и обнаруживает удерживаемую в LOW тревогу. Запасной опрос через CONFIG_RBAMP_DRDY_POLL_MS. Модулям STD нужна версия образа 0x00010075 или новее.

  • События на обеих линиях: rbamp_read_event_mask, rbamp_set_event_mask, rbamp_set_event_thresholds, rbamp_begin_event_flags, RBAMP_EVENT_NVM_FAULT; rbamp_read_event_flags / rbamp_clear_event_flags / rbamp_has_error / rbamp_clear_error теперь охватывают линию STD.

  • Kconfig: RBAMP_I2C_SCL_WAIT_US (бюджет растягивания тактов, по умолчанию 10 мс) и RBAMP_DRDY_POLL_MS.

  • Пример std_meter.

Изменено

  • Вызовы периода на модулях без банков защёлки возвращают ESP_ERR_NOT_SUPPORTED, а не молча сообщают недопустимый период.

  • rbamp_set_ct_model_ch возвращает ESP_ERR_NOT_SUPPORTED на модулях STD, у которых карта каналов не записываемая.

  • rbamp_err_to_str покрывает ESP_ERR_NOT_FOUND, ESP_ERR_NOT_FINISHED и ESP_ERR_INVALID_CRC.

  • rbamp_period_snapshot_t и rbamp_std_health_t получили новые поля (совместимо с исходным кодом; зависимые проекты пересобрать).

  • Компоненту теперь нужен esp_driver_gpio (встроенный компонент IDF).

1.5.0 — Модель датчика тока на каждом канале (2026-09-04)

Добавлено

  • rbamp_set_ct_model_ch / rbamp_read_ct_model_ch / rbamp_configure_channels принимают любой канал до обнаруженного числа каналов (каналы 3+ в пределах окна каналов).

  • Коды моделей и дескрипторы берутся из сгенерированного rbamp_sensor_models.h (rbamp_sensor_model_lookup); неизвестные коды отклоняются модулем и передаются вызывающему.

Фиксировано

  • Класс датчика и модель CT теперь сохраняются на производственных модулях: прежняя команда сохранения не записывала во flash на производственной прошивке, поэтому привязка применялась в RAM и терялась при следующей перезагрузке. Изменений API нет, та же выдержка ~700 мс.

1.4.0 — Модули на пять и семь каналов

Добавлено

  • Топология FIVE_CH / SEVEN_CH, варианты UI5 / UI7, RBAMP_MAX_CHANNELS = 7; rbamp_read_channel, rbamp_read_all_channels, rbamp_read_commit_seq. Снимок периода интегрирует все каналы.

1.3.0 (2026-06-16) — публичный выпуск

Первый публичный выпуск компонента rbamp для ESP-IDF v5.x.

Ключевые возможности

  • Менеджер парка: управление группой модулей на одной шине I²C через один дескриптор rbamp_fleet_t. Обнаружение с выявлением конфликтов и канарейкой зависания уровня 2, устойчивый к пропускам _poll_all, агрегация суммарной мощности / суммарной энергии / ошибок, широковещательная защёлка для жёсткой синхронности. См. главу 09 · Справочник API, раздел «Менеджер парка».

  • Провизионинг: rbamp_provision — сценарий одним вызовом для переназначения чистого модуля на его рабочий адрес с необязательным сохранением конфигурации во flash. Дисциплина: один чистый модуль на шине за раз (обязательное требование).

  • Конфигурация нескольких каналов: rbamp_configure_channels — атомарная настройка моделей CT по каждому каналу одной операцией с одним завершающим циклом записи во флеш (бережно для флеша).

  • Модель ошибок v1.3: разделяет результат последней записи (REG_ERROR (0x02) — синхронный канал, проверяемый сеттерами) и устойчивый асинхронный сигнал (EVENT_FLAGS.bit3 — липкий, для фактов времени выполнения). Соответствующие функции: rbamp_read_last_error, rbamp_has_error, rbamp_clear_error, rbamp_read_event_flags.

  • Идентификация / определение возможностей: rbamp_read_variant, rbamp_read_capability (карта возможностей), rbamp_has_voltage, rbamp_read_product_id, rbamp_read_uid, rbamp_is_provisioned.

Канон, отражённый в документации

  • Топология с несколькими модулями — основной режим работы библиотеки. Сценарий «один модуль на шине» — минимальный случай, а не канон. Каноническое развёртывание — модуль сети на вводе плюс N модулей на отдельных нагрузках, все на одной шине I²C под одним дескриптором парка.

  • Поддерживаемые SKU на текущем оборудовании: UI1 (счётчик сети: напряжение + ток + мощность + PF + энергия), I1 / I2 / I3 (субсчётчики: только ток, по каналам). UI2 / UI3 появятся в более поздних прошивках.

  • Энергия и мощность вычисляются только на вариантах UI (у которых есть входной каскад напряжения). На вариантах I rbamp_read_power / _power_factor возвращают 0.0f; агрегация парка по суммарной мощности / энергии корректно суммирует и игнорирует нулевые вклады.

  • Привязка CT — чистая подготовка (канон v1.3): запись REG_CT_MODEL НЕ применяет значение автоматически; привязка происходит через поканальный CMD_SET_CT_MODEL_CHn. Порядок привязки произвольный (аномалии «восходящий/нисходящий порядок» из версий до v1.3 удалены).

  • Смена адреса допустима в производстве: двухфазная фиксация + магический код + сброс работают в производстве (заводской режим не нужен).

  • Часы мастера = канонический таймбейс для Wh: программный таймер чипа PERIOD_LATCH_MS (0xEC) — только для диагностики; не используйте его для энергии. Мастер использует собственный esp_timer_get_time() или настенные часы.

Документация — новые / переработанные главы

  • 01_overview — вступление переработано в сторону многомодульности; добавлена ASCII-схема сценария 80%.

  • 03_sensor_selection — свип по порядку CT; новый раздел «Многоканальные модули — I2 и I3 (только ток)» с шаблоном разделения UI1+I3.

  • 04_hardware — раздел «Шина с несколькими модулями — основная топология» поднят до основного режима работы; явное требование внешних подтяжек ~4.7 кОм на шине парка; процесс ввода в эксплуатацию через rbamp_provision.

  • 09_api_reference — добавлены разделы: «Идентификация и подготовка», «Модель ошибок v1.3», «Конфигурация нескольких каналов», «Менеджер парка — управление несколькими модулями», «Конфигурация парка по устройствам».

  • 10_troubleshooting — добавлены разделы «i2c_master IDF зависает на шине с маргинальными подтяжками — трёхуровневое смягчение» (с таблицей частоты зависаний, проверенной на аппаратуре), «Парк: модуль оказался исключённым», «Парк: rbamp_fleet_scan вернул INVALID_STATE», «Парк: rbamp_provision вернул ошибку».

  • 11_changelog — этот файл.


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