Modbus-счётчик электроэнергии в Home Assistant: как подключить через RS-485 и ESPHome

Зачем вообще подключать электросчётчик по Modbus

Обычный бытовой счётчик используется прежде всего для коммерческого учёта электроэнергии. Но отдельный измерительный прибор с Modbus в щите может работать как источник телеметрии для Home Assistant, HEMS, инвертора или локальной автоматики.

Эти данные можно использовать для графиков, Energy Dashboard, контроля выделенной мощности, динамической зарядки EV, оценки работы солнечного инвертора и автоматического управления нагрузкой.

RS-485 и Modbus — это не одно и то же

RS-485 определяет электрический интерфейс линии связи: дифференциальную передачу данных по паре проводников. Modbus определяет структуру запросов, ответов, адреса устройств, function codes и представление регистров.

Поэтому надписи «RS-485» на приборе недостаточно. Нужно знать, какой протокол работает поверх него, параметры последовательного порта и register map.

Что такое карта регистров Modbus

Modbus-счётчик не передаёт Home Assistant готовую сущность «мощность дома». Клиент должен знать, по какому адресу лежит значение, какой function code используется, сколько регистров нужно прочитать и как интерпретировать байты.

Три способа подключить счётчик к Home Assistant

Официальная документация Home Assistant прямо рекомендует сначала искать vendor-specific integration. Она обычно проще в настройке и обслуживании, потому что детали register map уже реализованы разработчиком интеграции.

Прямое подключение через Home Assistant Modbus

Встроенная интеграция Home Assistant Modbus поддерживает serial RTU, TCP и UDP. Для обычного RS-485 счётчика чаще используется serial connection либо Ethernet/RS-485 gateway.

modbus:
  - name: energy_meter
    type: serial
    port: /dev/ttyUSB0
    baudrate: 9600
    bytesize: 8
    parity: N
    stopbits: 1

    sensors:
      - name: "Grid Voltage"
        slave: 1
        address: 0
        input_type: input
        data_type: uint16
        scale: 0.1
        precision: 1
        unit_of_measurement: V

Это пример структуры, а не конфигурация конкретной модели счётчика. Адрес регистра, function type, data type и scale нужно брать из официальной документации прибора.

Когда прямой Modbus удобен

• Home Assistant сервер расположен рядом с RS-485 gateway;
• register map стабильна и понятна;
• не нужен отдельный ESP32;
• соединение должно обслуживаться централизованно.

Когда это неудобно

USB-RS485 адаптер привязывает физическую линию к серверу Home Assistant. При переносе сервера, виртуализации, проблемах USB passthrough или большом расстоянии до щита такая архитектура может быть менее удобной.

Modbus-счётчик через ESPHome

ESPHome позволяет разместить микроконтроллер непосредственно возле щита или оборудования. ESP32 работает с RS-485 через внешний transceiver и сам опрашивает счётчик.

Базовая структура выглядит так:

uart:
  id: uart_modbus
  tx_pin: GPIO17
  rx_pin: GPIO16
  baud_rate: 9600
  parity: NONE
  stop_bits: 1

modbus:
  id: modbus_bus
  uart_id: uart_modbus

modbus_controller:
  - id: meter
    address: 1
    modbus_id: modbus_bus
    update_interval: 5s

sensor:
  - platform: modbus_controller
    modbus_controller_id: meter
    name: "Grid Voltage"
    register_type: read
    address: 0x0000
    value_type: U_WORD
    filters:
      - multiply: 0.1
    unit_of_measurement: "V"

Что изменил новый ESPHome modbus_client

В ESPHome 2026.8 появился отдельный компонент modbus_client для ad-hoc запросов. Он не заменяет modbus_controller, а решает другую задачу.

Для электросчётчика основной телеметрический поток по-прежнему удобнее строить через modbus_controller. Новый modbus_client полезен, когда нужно по событию прочитать нестандартный диапазон регистров, выполнить единичную команду или сформировать специальный PDU.

on_...:
  - modbus_client.send:
      address: 0x01
      pdu: [0x03, 0x00, 0x10, 0x00, 0x01]
      on_response:
        - lambda: |-
            ESP_LOGI("modbus", "Response: %u bytes",
                     response.size());

Почему значение в регистре часто получается неправильным

Самые частые ошибки Modbus связаны не с RS-485, а с интерпретацией данных.

Пример

Если register map говорит: Voltage = unsigned 16-bit, register 0x0000, scale 0.1, сырое значение 2307 интерпретируется как 230,7 В.

Как добавить Modbus-счётчик в Energy Dashboard

Home Assistant Energy Dashboard требует не просто датчик мгновенной мощности в ваттах, а подходящую энергетическую сущность с корректной единицей измерения и статистикой.

Если счётчик отдаёт накопленную импортированную энергию, это лучший источник:

Если прибор отдаёт только мощность, энергию можно рассчитывать интегрированием мощности во времени, но прямой накопительный energy register обычно предпочтительнее: он переживает перезагрузку Home Assistant и меньше зависит от пропусков телеметрии.

Как правильно собрать RS-485 линию

ESPHome рекомендует использовать RS-485 transceiver и оконечные резисторы 120 Ом на концах шины согласно требованиям линии. Некоторые адаптеры и приборы уже имеют встроенную или отключаемую терминацию.

• используйте витую пару для A/B;
• соблюдайте рекомендованную топологию bus;
• не делайте длинные случайные ответвления;
• назначайте уникальные Modbus addresses;
• все устройства сегмента должны иметь совместимые baud/parity/stop bits;
• учитывайте требования к GND/reference конкретного оборудования;
• не соединяйте экран кабеля произвольно с PE на обоих концах без понимания системы уравнивания потенциалов.

Почему счётчик лучше сначала использовать только для чтения

Многие Modbus-устройства имеют не только измерительные, но и конфигурационные holding registers. Через них иногда можно изменить адрес, скорость интерфейса, коэффициенты, режимы, выходы или параметры оборудования.

Для энергетического мониторинга почти всегда достаточно read-only работы. Если запись действительно требуется, сначала проверяют руководство, допустимый диапазон, единицы, подтверждение изменения и безопасное поведение при ошибке.

Особенно осторожно нужно работать с инверторами, EVSE, тепловыми насосами и промышленными контроллерами: один и тот же Modbus-интерфейс может одновременно отдавать телеметрию и принимать команды управления мощностью.

Почему Modbus не работает: порядок диагностики

1. 1

   Проверить питание

   Счётчик и RS-485 transceiver должны быть исправно запитаны.

2. 2

   Проверить A/B

   Если нет ответа, одна из первых проверок — соответствие обозначений линии документации обоих устройств.

3. 3

   Проверить serial parameters

   Baud rate, parity, stop bits должны совпадать.

4. 4

   Проверить slave address

   Клиент должен обращаться к реальному адресу устройства.

5. 5

   Проверить function code и register

   Ответ Modbus exception часто прямо указывает на неподдерживаемую функцию или адрес.

6. 6

   Снизить частоту опроса

   Слишком агрессивный polling нескольких устройств может создавать очередь и timeouts.

7. 7

   Проверить терминацию

   Особенно на длинной линии или при нескольких устройствах.

8. 8

   Проверить данные отдельно

   Используйте диагностический Modbus-клиент, чтобы отделить проблему шины от ошибки Home Assistant/ESPHome.

Что выбрать для дома: Home Assistant Modbus или ESPHome

Для одного домашнего счётчика рядом со щитом ESPHome является удобным мостом между RS-485 и Home Assistant. Для большого дома с котельной, инверторами, вентиляцией и десятками Modbus-устройств лучше заранее проектировать общую шину и контроллерную архитектуру.

Что учесть в электрощите

Modbus-связь не отменяет обычные требования к монтажу счётчика и электрощита. Силовая часть выбирается по паспорту прибора, схеме измерения, току, сечению проводников, назначению аппарата и условиям эксплуатации.

• измерительный прибор не должен ухудшать надёжность силовой цепи;
• трансформаторы тока устанавливаются с правильным направлением и коэффициентом;
• RS-485 и силовые трассы организуются с учётом помех и требований изготовителей;
• клеммы должны оставаться доступными для обслуживания;
• приборы и проводники в щите маркируются;
• для коммерческого учёта действуют отдельные требования к допуску и эксплуатации прибора.