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_VERSION0x0E: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)