05 · Устранение неполадок
Эта глава — краткий справочник по распространённым проблемам и их решениям. Каждый пункт построен по схеме:
- Симптом — что замечает пользователь
- Причины — почему это может случиться
- Что проверить / сделать— конкретные действия
Шина I²C
1. NACK / нет ответа от модуля
Симптом: Wire.endTransmission() возвращает ненулевое значение; i2cdetect в Linux не показывает адрес; rb_read_u8() возвращает 0xFF.
Причины и проверки:
- ❌ Пропало или нестабильно питание модуля — измерьте VCC мультиметром; оно должно быть в пределах 4.5…5.5 В.
- ❌ Нет общей земли — самая частая ошибка. Земля мастера и земля модуля должны быть соединены.
- ❌ SDA и SCL перепутаны — сверьте с схемой подключения в hardware-connection.md.
- ❌ Нет подтяжек на шине — если встроенные подтяжки отключены на модуле и внешние не установлены, шина мертва. При полностью обесточенной системе измерьте SDA↔VCC: должно быть 1.5–4.7 кОм.
- ❌ Слишком много подтяжек параллельно — встроенные подтяжки всё ещё активны на многих модулях (четыре и больше) плюс подтяжки мастера, эквивалентное сопротивление падает ниже ~1 kΩ. Мастер не может притянуть шину к LOW. Отключите встроенные подтяжки на всех модулях, кроме одного.
- ❌ Длинный кабель без витой пары или буфера — свыше ~0.15 m параллельные провода связываются ёмкостно, и фронты скругляются. Используйте UTP cat-5 (до 1 m) или буфер PCA9515 (до 3 m). См. hardware-connection.md → Длина шины.
- ❌ Неверный адрес ведомого — модуль мог быть переадресован. Выполните сканирование I2C:
void i2c_scan() {
for (uint8_t addr = 0x08; addr < 0x78; addr++) {
Wire.beginTransmission(addr);
if (Wire.endTransmission() == 0) {
Serial.printf("Found device at 0x%02X\n", addr);
}
}
}
- ❌ Скорость I²C слишком высока для данной длины кабеля. Снизьте до 50 kHz:
Wire.setClock(50000);.
2. Периодические таймауты чтения/записи
Симптом: транзакции иногда проходят, иногда нет — особенно в электрически зашумлённой среде или рядом с индуктивными нагрузками.
Causes:
- ❌ Длинный кабель без витой пары
- ❌ Кабель проложен параллельно сетевой проводке → наводка 50 Гц / 100 Гц
- ❌ Шумная земля на стороне мастера (например, отдельный стабилизатор без буферной ёмкости)
- ❌ Паразитная ёмкость между SDA и GND > 100 pF (например, соединение с длинными отводами)
Solutions:
- Используйте витую пару (SDA + GND в одной паре, SCL + GND в другой)
- Не прокладывайте I2C параллельно силовой проводке в одном канале
- Снизьте скорость до 50 kHz / добавьте 100 nF между VCC и GND модуля рядом с разъёмом
- Для длинных трасс вне корпуса добавьте защиту от ESD (TVS-диоды на SDA и SCL)
— та же задача без доступа к регистрам:
| Библиотека | Вызов | Что делает |
|---|---|---|
| Arduino | RbAmp::retryExhaustionCount() / RbAmp::sanityRejectCount() |
исчерпаны повторы на шине, и отброшены показания |
| ESP-IDF | rbamp_retry_exhaustion_count() / rbamp_sanity_reject_count() |
исчерпаны повторы на шине, и отброшены показания |
| Python | dev.sanity_reject_count / счётчики MachineI2CBackend |
счётчик отброшенных показаний; счётчики повторов на бэкенде MicroPython |
| ESPHome | — | диагностических счётчиков нет |
3. DATA_VALID (0xCE) никогда не становится 1
Симптом: мастер читает 0xCE и всегда получает 0x00. Другие регистры также могут оставаться нулевыми.
Causes:
- ❌ Модуль ещё не завершил загрузку (это нормально в первые ~250 мс после подачи питания)
- ❌ Ошибка инициализации прошивки — прочитайте
REG_ERROR(0x02): 0xFB(ERR_FLASH_PARAMS_BAD) — блок параметров во флеш-памяти повреждён; модуль работает на значениях по умолчанию. Выполните перекалибровку / повторное provisioning.0xFA(ERR_LUT_BAD) — таблица заводской калибровки повреждена. Не критично — измерения продолжаются; точность может снизиться. Попросите поставщика провести перекалибровку.- ❌ Сбой тактирования MCU (редко) — выключите и включите питание модуля
Solutions:
- Подождите 300 мс после включения, прежде чем опрашивать
0xCE. - Если
DATA_VALID = 1не появляется через > 1 с — выключите и снова включите питание. - Если проблема сохраняется после отключения питания — проверьте питание (пульсации, просадки).
— та же задача без доступа к регистрам:
| Библиотека | Вызов | Что делает |
|---|---|---|
| Arduino | RbAmp::waitReady(timeout_ms) / RbAmp::readLastError() |
дождаться бита готовности; прочитать код ошибки устройства |
| ESP-IDF | rbamp_wait_ready() / rbamp_read_last_error() |
дождаться бита готовности; прочитать код ошибки устройства |
| Python | dev.wait_ready(timeout_ms=1000) / dev.read_last_error() |
дождитесь флага готовности (вызывает ошибку по таймауту); прочитайте код ошибки устройства |
| ESPHome | update() проверка готовности / get_last_error_str() |
показания публикуются, когда модуль сообщает о готовности; код ошибки в виде текста |
Калибровка и точность
4. I_rms близок к 0, когда нагрузка работает
Симптом: лампа горит, обогреватель тёплый, но I_rms показывает 0.001 A или прыгает между 0 и несколькими мА.
Причины (в порядке убывания частоты):
- ❌ Клещи CT не на проводе — проводник проходит рядом с клещами, а не через них.
- ❌ Клещи CT одновременно на L и N — потоки фазы и нейтрали компенсируют друг друга, датчик показывает почти ноль. См. hardware-connection.md → Датчик тока. Клещи должны охватывать один проводник (фаза/L).
- ❌ Клещи не полностью закрыты — зазор более 0.1 мм между половинками сердечника резко увеличивает магнитное сопротивление, и выход датчика заметно падает. Расстегните и защёлкните заново до щелчка. Грязь или окисел в зазоре — частая причина: протрите сопрягаемые поверхности.
- ❌ Разъём 3.5 мм болтается — выньте вилку и вставьте заново.
- ❌
REG_CT_MODELне задан — модуль не знает чувствительность датчика. См. initialization.md → Настройка класса датчика и модели CT. Регистр0x05должен содержать правильный код модели. - ❌ Записан неверный код модели — например, датчик SCT-013-030 с кодом SCT-013-010 → показываемый ток будет примерно в 3 раза ниже реального (и наоборот, слишком большой код завышает показания). Сверьте маркировку корпуса датчика с кодом модели.
- ❌ Ток ниже порога шума — для очень малых нагрузок (< ~10 мА на клещах 30 А) выход датчика близок к порогу шума. Прошивка применяет квадратурное вычитание шума:
I_corrected = √(I_raw² − NF²). ЕслиI_raw ≤ NF, результат принудительно становится 0. Это предусмотренное поведение.
5. I_rms занижен в разы
Симптом: реальная нагрузка ~10 A (по эталонному счётчику), модуль показывает 3 A или 30 A.
Causes:
- ❌ Неверный код модели CT — самый частый случай. См. #4.
- ❌ Установлена неверная модель клещей CT — кто-то поставил клещи на 100 A там, где конфигурация требует клещи на 30 A (или наоборот).
- ❌ Клещи не полностью закрыты (см. #4) — обычно показывают на 5–20 % меньше.
- ❌ Подозрение на дрейф заводской калибровки — если всё перечисленное выше исключено и расхождение сохраняется на известной эталонной нагрузке, обратитесь к поставщику модуля; перекалибровка — заводская операция.
6. Знак P_real неверен (потребление показывается как выдача)
Симптом: нагрузка явно потребляет (нагретый обогреватель, горящая лампа), но P_real < 0.
Причины и решения:
- ❌ L и N перепутаны на клеммах напряжения — самая частая причина. См. hardware-connection.md → Датчик напряжения. Поменяйте L и N местами на плате.
- ❌ Токовые клещи установлены задом наперёд — стрелка на клещах должна указывать по направлению тока к нагрузке (щит → нагрузка). Если она смотрит в обратную сторону, расстегните и переверните клещи.
- ❌ Физический переворот непрактичен — на BASIC накопитель периода (
PERIOD_AVG_P_W) обнуляет отрицательные отсчёты, поэтому при инвертированной полярности регистр энергии остаётся 0, пока физическая полярность не исправлена — инвертирование в коде мастера (p_corrected = -p_raw) исправляет только ваше собственное интегрирование RT, но никогда данные периода на модуле. Исправьте проводку.
7. Суммарная энергия расходится с эталонным счётчиком на несколько процентов
Симптом: E_Wh за час отличается от счётчика энергосбыта на 2–10 %.
Вероятные причины (в порядке убывания):
- ❌ Клещи не полностью закрыты (зазор) — обычно занижение на −5…−20 %. Самая частая причина. Расстегните, очистите сопрягаемые поверхности и защёлкните снова до полного смыкания.
- ❌ Клещи установлены на «вторичном» проводе — внутри щитка, на коротком пигтейле за автоматом. Паразитные поля соседних автоматов вносят ошибки. Перенесите клещи на главный ввод или на изолированный участок проводника.
- ❌ Близко к мощным реактивным нагрузкам — рядом с трансформаторами, асинхронными двигателями, ИБП. Магнитные поля соседних индуктивностей создают паразитный сигнал. Отодвиньте клещи на ≥ 10 см от любого ферромагнитного элемента.
- ❌ Низкий PF (≤ 0.5) — большие реактивные нагрузки требуют точной фазовой компенсации. Точность указана для резистивных нагрузок (PF ≈ 1); для сильно реактивных нагрузок она не задана. Если точность на конкретном профиле PF критична, обратитесь к поставщику модуля за рекомендацией.
- ❌ Искажённое напряжение сети (микропровалы, гармоники высокого порядка) — расчёт RMS и среднего устойчивее, чем детектирование пика, но точность не задана для сильно искажённого напряжения сети; если это важно для вашей установки, свяжитесь с поставщиком.
- ❌ Повреждённый кабель CT или разболтанный разъём — обрыв или холодная пайка внутри вилки. Проверьте мультиметром, с разъёмом, отключённым от модуля (клещи CT — понижающий трансформатор; вторичная обмотка должна показывать 50–200 Ω в зависимости от модели).
8. avg_P_W заметно ниже ожидаемого
Симптом: нагреватель 1000 W включён, RT P_real ≈ 1000 W, но PERIOD_AVG_P_W за минутный период показывает ~200 W.
Causes:
- ❌ Нагрузка фактически прерывистая (циклический термостат, импульсный нагреватель) —
avg_P_Wправильно показывает среднее по времени. Перепроверьте поPERIOD_MAX_P_W(0xE0), чтобы увидеть пик внутри любого окна измерения. - ❌ Если нагрузка стабильна, а RT
P_real ≈ avg_P_Wне выполняется: - На уровне BASIC: проверьте знак
P_realв RT. ЕслиPизредка отрицательна (например, солнечный инвертор отдаёт в сеть), отрицательные выборки исключаются изPERIOD_AVG_P_W, и среднее занижается. См. period-metering.md → уровень BASIC.
9. PERIOD_VALID = 0 после снимка
Симптом: мастер выдаёт CMD_LATCH_PERIOD, читает 0x07 и получает 0. Снимок не свежий.
Causes:
- ❌ Снимки слишком близко друг к другу — между двумя снимками не завершилось ни одного окна RT (~100 мс с v1.2; 200 мс раньше). Накопитель пуст, снимок отбрасывается.
- ❌ Гонка с фиксацией RT — редко: мастер выдал команду в тот самый момент, когда прошивка фиксировала живой накопитель. Возможно на очень быстрых мастерах.
Решение — шаблон повтора (см. period-metering.md → Базовый цикл):
if ((rb_read_u8(0x50, 0x07) & 0x01) == 0) {
delay(250); // let at least one RT window complete
rb_write_u8(0x50, 0x01, 0x27);
delay(50);
// retry read of PERIOD_VALID
}
— та же задача без доступа к регистрам:
| Библиотека | Вызов | Что делает |
|---|---|---|
| Arduino | RbAmp::isPeriodValid() / RbAmp::readPeriodSnapshot() |
проверить бит готовности снимка; взять и проверить снимок периода |
| ESP-IDF | rbamp_is_period_valid() / rbamp_read_period_snapshot() |
проверить бит готовности снимка; взять и проверить снимок периода |
| Python | dev.is_period_valid() / dev.read_period_snapshot() |
проверить бит готовности снимка; взять и проверить снимок периода |
| ESPHome | Периодный снимок недействителен | что записывает компонент, когда флаг достоверности равен 0; первый снимок после загрузки отбрасывается |
Проблемы с несколькими модулями
10. Коллизия адресов
Симптом: на шину добавлено несколько модулей — одни «пропадают» или возвращают мусор. Один и тот же адрес отвечает разными значениями.
Причина: два или более модулей имеют один адрес → арбитраж/коллизия I²C. Часто сразу после распаковки, когда все модули на заводском 0x50.
Более тонкий случай: адрес отвечает стабильно, но UID, прочитанный по 0x5C (гл. 11 §4.8), не совпадает ни с одним известным вам модулем. Два модуля отвечают одновременно — шина логически объединяет их выходы (wire-AND) в стабильный, но вымышленный UID. Если хаб видит «неизвестный UID» по адресу, который он назначил, сначала подозревайте коллизию, а не чужой модуль.
Solution:
- Отключите каждый модуль.
- Подключайте по одному — никогда не меняйте адрес при двух модулях с заводским адресом на шине; назначьте каждому уникальный адрес.
- После переадресации всех модулей подключите их параллельно и проверьте каждый адрес, прочитав его UID.
См. initialization.md → Рекомендуемый порядок работ.
— та же задача без доступа к регистрам:
| Библиотека | Вызов | Что делает |
|---|---|---|
| Arduino | RbAmpFleet::checkConflict() / RbAmpFleet::scan() |
проверьте адрес на наличие второго устройства; сканируйте шину на модули |
| ESP-IDF | rbamp_fleet_check_conflict() / rbamp_fleet_scan() |
проверьте адрес на наличие второго устройства; сканируйте шину на модули |
| Python | fleet.check_conflict(addr) / fleet.scan() |
проверьте адрес на наличие второго устройства; сканируйте шину на модули |
| ESPHome | rbamp: список |
по одному блоку на модуль, каждый со своим id и address |
11. Объединённая линия DRDY срабатывает несколько раз подряд
Симптом: при DRDY по схеме wired-OR внешнее прерывание мастера срабатывает каждые 1–5 мс несколько раз подряд.
Причина: модули не синхронизированы идеально — у каждого свой кварц, а периоды окон RT немного различаются (99.9 мс против 100.1 мс). За время охвата окон модули притягивают линию в слегка разные моменты.
Это нормально. Решения:
- Игнорируйте «двойные» срабатывания: после первого срабатывания прочитайте все модули и подавляйте дальнейшие срабатывания в течение ~10 мс.
- Используйте широковещательный снимок (см. period-metering.md → Подход 2) для точной синхронизации — но только для периодных снимков, не для RT.
- Перейдите на DRDY на каждый модуль — каждый модуль на своём GPIO.
12. Шина I²C занята, когда срабатывает DRDY
Симптом: DRDY срабатывает, пока мастер уже в транзакции с другим модулем. Обработчик EXTI запаздывает.
Это нормально. Регистры RT остаются действительными до следующей фиксации (одно окно, ~100 мс, спустя). Мастер:
- Завершает текущую транзакцию.
- Обслуживает отложенный EXTI и читает следующий модуль.
- Задержка: обычно 1–10 мс — некритично.
13. Дрейф часов нескольких модулей в длительных тестах
Симптом: накопленная энергия расходится между модулями на доли процента за неделю.
Причина: у каждого rbAmp свой кварц с дрейфом ±50 ppm (1–5 s/day).
Решение — заложено в архитектуру: мастер умножает на dt, используя собственные часы. Все модули работают с одной временной опорой, поэтому общий суммарный Втч по системе не расходится.
Чтобы проверить дрейф микросхемы для контроля качества, сравните PERIOD_LATCH_MS (0xEC) с dt мастера:
uint32_t chip_dt = rb_read_u32(0x50, 0xEC);
float ratio = (float)chip_dt / (float)master_dt;
printf("Chip drift: %.3f (1.000 = perfect)\n", ratio);
Приёмочный порог для PERIOD_LATCH_MS: занижение до 30 % под нагрузкой — норма (соотношение до ~0.70). Диагностическая временная база модуля занижает показания, когда модуль занят — это штатно. Допуск 30 % — свойство временной базы модуля, а не неисправность. Применяйте этот порог единообразно для всех исполнений и уровней.
Прежний порог 3 % из более ранней документации неверен для v1.3: он массово отбракует исправные модули; не используйте его.
Этот дрейф влияет только на диагностический регистр микросхемы; точность энергии не страдает, потому что Вт·ч вычисляется на стороне мастера как avg_P × master_dt (см. period-metering.md). Если сам master_dt уплывает (дрейф тактового генератора мастера), примените собственную коррекцию NTP/SNTP мастера — PERIOD_LATCH_MS не является подходящим эталоном.
— та же задача без доступа к регистрам:
| Библиотека | Вызов | Что делает |
|---|---|---|
| Arduino | RbAmp::readPeriodLatchMs() |
прочитать длину периода на стороне модуля (только для диагностики) |
| ESP-IDF | rbamp_read_period_latch_ms() |
прочитать длину периода на стороне модуля (только для диагностики) |
| Python | dev.read_period_latch_ms() |
прочитать длину периода на стороне модуля (только для диагностики) |
| ESPHome | — | не предоставляется |
Питание и флеш
14. Пропадание питания во время команды записи во flash → частичная запись во flash
Симптом: после перебоя питания во время команды записи во флеш (CMD_SAVE_USER_CONFIG, CMD_COMMIT_ADDR) модуль загружается с REG_ERROR = 0xFB (ERR_FLASH_PARAMS_BAD) и установленным EVENT_FLAGS.bit3.
Что произошло: прошивка обнаружила ошибку CRC в блоке пользовательской конфигурации во flash, загрузила заводские значения по умолчанию и перезаписала их.
Solution:
- Восстановлены заводские значения по умолчанию — модуль работает, но его пользовательский адрес и конфигурация датчика утрачены.
- Повторно примените конфигурацию: задайте
SENSOR_CLASS+ привяжитеCT_MODELпо каждому каналу + выполнитеCMD_SAVE_USER_CONFIG(и повторите смену адреса, если нужно). - Чтобы этого избежать в будущем: не отключайте питание как минимум на 1 секунду после любой команды записи во флеш. Само окно стирания и записи флеша — около 700 мс; оставляйте запас.
15. Модуль перегрет
Симптом: корпус заметно тёплый.
Норма: при сетевом токе до номинала (зависит от исполнения) ожидается лёгкий нагрев низковольтной стороны (LDO-стабилизатора) до ~40 °C.
Ненормально: горячий корпус (≥ 60 °C), запах гари, обесцвечивание пластика.
Causes:
- ❌ Перенапряжение на низковольтной стороне (VCC > 5.5 V) — проверьте питание.
- ❌ Внутреннее повреждение на сетевой стороне (короткое замыкание в делителе или цепи CT).
- ❌ Внешние клещи CT перегружены (ток выше диапазона датчика).
Действие: немедленно отключите питание, изолируйте модуль, обратитесь к поставщику.
Проводка датчика — критические ошибки
16. Проверка здравого смысла — что значит «подключено правильно»
После установки или переустановки модуля выполните проверку на заведомо чисто резистивной нагрузке (лампа накаливания, электрический чайник, нагревательный элемент) — например, лампа 100 Вт на 230 V.
Expected:
U_rms ≈ 220..240(зависит от местной сети)I_rms ≈ 100 W / 230 V ≈ 0.43 AP_real ≈ +100 W(положительная, потребление)PF ≈ 0.998..1.000(резистивная нагрузка)Q ≈ 0(реактивной составляющей нет)
Если P_real отрицательна: см. #6 — L/N перепутаны или CT установлен задом наперёд. Если |I_rms − expected| > 10 %: см. #5 — неверная модель CT или клещи не сомкнуты. Если |P_real − U × I| > 5 % при PF = 1: возможно, фазовая компенсация не в порядке — свяжитесь с поставщиком.
17. Чек-лист перед вводом в эксплуатацию
Перед подачей питания на модуль в производственной системе:
- [ ] L подключён к клемме L платы (не перепутан с N)
- [ ] Токовые клещи на проводе L (не на N и не на обоих сразу)
- [ ] Стрелка на токовых клещах указывает на нагрузку
- [ ] Токовые клещи полностью закрыты (без зазора и люфта — защёлкните до щелчка)
- [ ] Кабель CT цел, вилка полностью вставлена в гнездо
- [ ] Питание VCC в пределах 4.5…5.5 В, чистая земля
- [ ] Подтяжки I²C проверены (см. hardware-connection.md → Подтяжки I²C)
- [ ] Для модулей BASIC серии SCT:
REG_CT_MODELзаписан и сохранён в соответствии с установленным датчиком - [ ] Проверка на резистивной нагрузке пройдена — все пять значений (U, I, P, PF, Q) в ожидаемых пределах
Если какой-либо пункт не отмечен, ожидайте странных показаний. Самые частые причины ошибок учёта — проблемы монтажа датчиков, а не сбои прошивки или электроники.
Серия CT (заводски спаренные клещи)
- ❌ Показания по одному каналу выглядят неверно — клещи стоят не на своём канале или были заменены. Переподключите клещи с номером этого канала; клещи другого канала дают неверное значение.
- ❌ Запись класса датчика или модели возвращает
ERR_PARAM(0xFE) — ожидаемо на прошивке 1.4.22 и новее: модуль серии CT отклоняет такие записи. Не записывайте их (см. запуск без конфигурации). - ❌ Клещи или канал повреждены — их нельзя заменить в полевых условиях; обратитесь в заводской сервис.
- ❌ Ток отрицательный / энергия идёт не в ту сторону — клещи перевёрнуты: стрелка должна указывать на нагрузку.
Коды ошибок (REG_ERROR = 0x02)
| Код | Имя | Значение | Действие |
|---|---|---|---|
0x00 |
ERR_OK |
Норма — последняя запись прошла успешно | — |
0xF9 |
ERR_CLONE |
Зарезервировано — не выставляется | Если такое наблюдается, свяжитесь с поставщиком. |
0xFA |
ERR_LUT_BAD |
таблица заводской калибровки не прошла проверку CRC; модуль работает на линейной аппроксимации | Не критично. Измерения продолжаются; точность может снизиться. Попросите поставщика провести перекалибровку. |
0xFB |
ERR_FLASH_PARAMS_BAD |
Блок параметров во флеш повреждён; восстановлены значения по умолчанию | Перенастройте адрес / SENSOR_CLASS / CT_MODEL и выполните CMD_SAVE_USER_CONFIG (0x32). Нормально для чистого модуля (см. главу 11 §6.5) — не прерывайте первичную настройку из-за 0xFB. |
0xFC |
ERR_NOT_READY |
Первое окно RT ещё не завершилось после загрузки | Подождите 300 мс. |
0xFD |
ERR_SENSOR_OVERFLOW |
Ограничение входного сигнала (превышен полный диапазон) | Уменьшите ток или используйте клещи большего номинала. |
0xFE |
ERR_PARAM |
Неверный код команды или значение вне диапазона | Проверьте команду и диапазон значений. |
0xFF |
ERR_UNHANDLED |
HardFault или необработанное состояние | Отключите и снова включите питание. Если повторится, свяжитесь с поставщиком. |
Смысл — REG_ERROR НЕ липкий (v1.3)
REG_ERROR хранит результат последней транзакции записи. Каждая последующая запись — успешная или нет — его перезаписывает. Сбрасывать REG_ERROR между попытками не нужно; более того, чтение его позже, чем сразу после неудачной записи, может показать более свежий результат последующей операции.
Если нужен устойчивый сигнал об ошибке, переживающий последующие записи, используйте EVENT_FLAGS.bit3 (ERROR_OCCURRED) — он защёлкивается W1C и сбрасывается только тогда, когда мастер записывает 1 в этот бит. Полную модель ошибок см. в главе 11 §5.3.
Явный сброс (нужен редко): CMD_CLEAR_ERROR (код операции 0x31) обнуляет REG_ERROR.
— та же задача без доступа к регистрам:
| Библиотека | Вызов | Что делает |
|---|---|---|
| Arduino | RbAmp::readLastError() / RbAmp::clearError() |
прочитать код ошибки последней записи; сбросить его |
| ESP-IDF | rbamp_read_last_error() / rbamp_clear_error() |
прочитать код ошибки последней записи; сбросить его |
| Python | dev.read_last_error() / dev.clear_error() |
прочитать код ошибки последней записи; сбросить его |
| ESPHome | get_last_error_str() / write_clear_error() |
код ошибки в виде текста; сбросить ошибку |
Когда обращаться к поставщику
Симптомы, требующие обслуживания:
- Модуль не выходит из
DATA_VALID = 0после трёх циклов включения питания ERR_UNHANDLED(0xFF) повторяется- Предполагаемый дрейф калибровки — расхождение > 5 % с эталонным счётчиком на известной активной нагрузке сохраняется после выполнения диагностического чек-листа из пункта 17
- Корпус горячий или пахнет горелым
- Расхождение с эталонным счётчиком > 5 % при выполненном чек-листе из пункта 17
- Новый модуль при первом включении загружается с
ERR_LUT_BAD(0xFA)
Далее
- arduino-examples.md — примеры с обработкой ошибок
- Для интеграций с умным домом (ESPHome / Home Assistant, Python) см. таблицу клиентских библиотек в README