Skip to content
/ esphome-dlms-cosem Public

Supports DLMS/Cosem IEC IEC 62056-21 Mode E (Hdlc), session mode and passive PUSH mode readout. Подключение EspHome к счетчикам электроэнергии по протоколу СПОДЭС ГОСТ Р 58940-202 (Энергомера ce207, ce208, CE307, CE308, Меркурий, Пульсар, Милур, Мир, Нартис, РиМ и другие).

License

MIT license
25 stars 7 forks Branches Tags Activity
Star
Notifications You must be signed in to change notification settings

latonita/esphome-dlms-cosem

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

166 Commits
components/dlms_cosem
components/dlms_cosem
 
 
.gitignore
.gitignore
 
 
LICENSE
LICENSE
 
 
README.en.md
README.en.md
 
 
README.md
README.md
 
 
cosem-search.log
cosem-search.log
 
 

Repository files navigation

[Русская версия] [English version]

СПОДЭС/DLMS/COSEM • МЭК-61107/IEC-61107 • Энергомера МЭК/IEC • Энергомера CE • СПб ЗИП ЦЭ2727А • Ленэлектро ЛЕ-2 • Пульсар-М • Энергомера BLE

esphome-dlms-cosem

Подключение EspHome к счетчикам электроэнергии по протоколу DLMS/COSEM/СПОДЭС (Энергомера CE207/CE307/CE308, Милур 107S, Мир, Нартис, РиМ, Пульсар, ZPA AM375 и многие другие) через RS-485 интерфейст или через оптопорт(*).

Два режима работы - запрос-ответ и режим ожидания данных от счетчика (PUSH).

Инструкции по подключению esp32/esp8266 к счётчику можно увидеть в соседнем компоненте https://github.com/latonita/esphome-energomera-iec

(*) Через оптопорт можно работать с приборами, которые сразу работают на скорости 9600. Вариант, когда необходимо сначала подключаться на скорости 300, а потом выходить на рабочую скорость - пока не поддерживается (нужно только найти того, кто сможет протестировать).

Оглавление

Функции

Реализованы

  • Подключние по бинарному протоколу HDLC без аутентификации (NONE) и с низким уровнем (LOW - доступ с паролем)
  • Работа в режиме опроса счетчика и режиме ожидания
  • Поддержка базовых цифровых типов данных (int/float)
  • Поддержка базовых текстовых данных (octet-string)
  • Поддержка русских символов в ответах от счетчиков (Нартис И100-W112, РиМ 489 , ... )
  • Задание логического и физического адресов
  • Работа с несколькими счетчиками на одной шине

Возможные задачи на будущее

  • Работа с данными типа datetime
  • Синхронизация времени
  • Управление реле
  • Полноценная работа через оптопорт по стандартной процедуре (300 → 9600)

Если готовы помочь тестированием — пишите на anton.viktorov@live.com.

Установка

Добавьте внешний компонент в конфигурацию ESPHome:

external_components:
  - source: github://latonita/esphome-dlms-cosem
    components: [dlms_cosem]
    refresh: 1s

Требуется настроенный UART (RS‑485 через конвертер) или оптопорт.

Быстрый старт

Минимальная конфигурация хаба и одного сенсора, режим запрос-ответ:

uart:
  id: bus_1
  rx_pin: GPIO16
  tx_pin: GPIO17
  baud_rate: 9600
  data_bits: 8
  parity: NONE
  stop_bits: 1

dlms_cosem:
  client_address: 32
  server_address: 1      # см. документацию на ваш счётчик
  auth: true
  password: "12345678"
  update_interval: 60s

sensor:
  - platform: dlms_cosem
    name: Active Power
    obis_code: 1.0.1.7.0.255
    unit_of_measurement: W
    accuracy_decimals: 1
    device_class: power
    state_class: measurement

Минимальная конфигурация хаба и одного сенсора, режим PUSH:

uart:
  id: bus_1
  rx_pin: GPIO16
  tx_pin: GPIO17
  baud_rate: 9600
  data_bits: 8
  parity: NONE
  stop_bits: 1

dlms_cosem:
  push_mode: true

sensor:
  - platform: dlms_cosem
    name: Active Power
    obis_code: 1.0.1.7.0.255
    unit_of_measurement: W
    accuracy_decimals: 1
    device_class: power
    state_class: measurement

Конфигурация хаба (dlms_cosem)

dlms_cosem:
  client_address: 32
  server_address:
    logical_device: 1
    physical_device: 576
    address_length: 2
  auth: true
  password: "12345678"
  update_interval: 60s
  receive_timeout: 500ms
  delay_between_requests: 50ms
  flow_control_pin: GPIO12
  id: energo_01
  cp1251: true
  push_mode: false
  push_show_log: false
  # push_custom_pattern: TV,TC,TSU,TO    # Подробнее в разделе PUSH

Параметры:

  • client_address (Optional) — уровень доступа клиента. Для чтения часто используется 32 (требует пароль). По умолчанию: 16.
  • server_address (Optional) — HDLC‑адрес. Можно указать числом либо как объект. По умолчанию: 1.
    • logical_device (Optional) — логический адрес устройства. По умолчанию: 1.
    • physical_device (Required) — физический адрес устройства (часто зависит от серийного номера). См. инструкцию к счётчику.
    • address_length (Optional) — длина адреса (1|2|4 байта). По умолчанию: 2.
  • auth (Optional) — включить авторизацию. По умолчанию: false.
  • password (Optional) — пароль при LOW‑auth.
  • update_interval (Optional) — период опроса. По умолчанию: 60s.
  • receive_timeout (Optional) — таймаут ожидания ответа. По умолчанию: 500ms.
  • delay_between_requests (Optional) — пауза между запросами. По умолчанию: 50ms.
  • flow_control_pin (Optional) — пин управления направлением RE/DE RS‑485‑модуля.
  • id (Optional) — идентификатор хаба (укажите, если их несколько).
  • cp1251 (Optional) — конвертация cp1251 → UTF‑8 для текстовых значений. По умолчанию: true.
  • push_mode (Optional) — включить пассивный режим (Push mode), если поддерживается. В режиме PUSH большинство параметров не имеют значения. По умолчанию: false.
  • push_show_log (Optional) - в пассивном режиме (Push mode) выводить подробный лог о найденных COSEM объектах. По умолчанию: false.
  • push_custom_pattern (*Optional) - Формат Cosem объекта. По умолчанию: нет.

Адресация: client_address и server_address

  • Адреса не нужны, если используется режим PUSH.
  • Если не указать, будут использованы значения по умолчанию (16 и 1). Но лучше свериться с документацией к конкретному счётчику.
  • Часто используется client_address = 32 (требуется пароль). Уровни по СПОДЭС:
Код Уровень Операции Защита
16 Публичный клиент чтение нет
32 Считыватель показаний чтение, выборка, отдельные действия пароль
48 Конфигуратор чтение/запись/выборка/действия пароль или шифрование (*)

(*) Шифрование пока не поддерживается.

server_address обычно двухбайтный: старший байт — логический адрес, младший — физический. Детали — в инструкции к счётчику.

Пример (Милур 107S): физический адрес = (последние 4 цифры серийного номера + 16).

cp1251 и русские строки

Некоторые счётчики отдают строки в cp1251 (например, тип ПУ по 0.0.96.1.1.255). Для корректного отображения в Home Assistant включите cp1251: true на уровне хаба или конкретного текстового сенсора. Если конвертация мешает, её можно отключить глобально или точечно в сенсоре.

Сенсоры

Настройка сенсоров в режиме запрос-ответ и в пассивном режиме (Push) не отличается ничем, кроме того, что в пассивном режиме мы не всегда знаем, какие данные присылает счетчик. Для того, чтобы узнать, какие данные счетчик отправляет включите режим логирования:

dlms_cosem:
  push_mode: true
  push_show_log: true

После чего компонент будет выводить в лог опознанные Cosem объекты. Пример лога тут: cosem-search.log. После настройки сенсоров выключите лог.

Числовой сенсор (sensor)

sensor:
  - platform: dlms_cosem
    name: Phase Current
    obis_code: 1.0.11.7.0.255
    multiplier: 1.0        # предварительная мультипликация (до filters:)
    dont_publish: false    # не публиковать в шину (видно только в логах)
    unit_of_measurement: A
    accuracy_decimals: 1
    device_class: current
    state_class: measurement

Текстовый сенсор (text_sensor)

text_sensor:
  - platform: dlms_cosem
    name: Type
    obis_code: 0.0.96.1.1.255
    dont_publish: false
    # cp1251: false         # переопределение настройки хаба (опционально)
    entity_category: diagnostic
  • cp1251 — если указано у сенсора, перекрывает настройку хаба. Полезно для полей вроде 0.0.96.1.1.255 (тип ПУ на русском).

Бинарные сенсоры (binary_sensor)

binary_sensor:
  - platform: dlms_cosem
    connection:
      name: Connection      # есть связь с прибором
    session:
      name: Session         # активна сессия
    transmission:
      name: Transmission    # идёт обмен (каждый запрос)

Пример использования для индикации активности светодиодом:

binary_sensor:
  - platform: dlms_cosem
    transmission:
      name: Transmission
      on_press:
        output.turn_on: transmission_led
      on_release:
        output.turn_off: transmission_led

output:
  - platform: gpio
    id: transmission_led
    pin: GPIO04
    inverted: true

Несколько счётчиков

  • NB: В режиме PUSH может быть только один счетчик на одной шине.
uart:
  - id: bus_1
    rx_pin: GPIO16
    tx_pin: GPIO17
    baud_rate: 9600
    data_bits: 8
    parity: NONE
    stop_bits: 1

  - id: bus_2
    rx_pin: GPIO23
    tx_pin: GPIO22
    baud_rate: 9600
    data_bits: 8
    parity: NONE
    stop_bits: 1

dlms_cosem:
  - id: energo_1
    uart_id: bus_1
    client_address: 32
    server_address:
      logical_device: 1
      physical_device: 576
    auth: true
    password: "12345678"
    update_interval: 30s

  - id: energo_2
    uart_id: bus_1
    client_address: 32
    server_address:
      logical_device: 1
      physical_device: 16
    auth: true
    password: "12345678"
    update_interval: 30s

  - id: nartis_3
    uart_id: bus_2
    client_address: 32
    server_address:
      logical_device: 1
      physical_device: 17
      address_length: 2
    auth: true
    password: "00000001"

text_sensor:
  - platform: dlms_cosem
    dlms_cosem_id: energo_2
    name: Serial number
    obis_code: 0.0.96.1.0.255
    entity_category: diagnostic
    cp1251: true

sensor:
  - platform: dlms_cosem
    dlms_cosem_id: nartis_3
    name: Current
    obis_code: 1.0.11.7.0.255
    unit_of_measurement: A
    accuracy_decimals: 1
    device_class: current
    state_class: measurement

Особенности счетчиков

Нартис И100-W112

  • Передает тип ПУ на русском языке. Для текстового сенсора 0.0.96.1.1.255 необходимо установить cp1251: true

  • Иногда пароли и явки в инструкции отличаются от реальных. Пример рабочих параметро с одного из счетчиков:

    • Пароль администрирования: 0000000100000001
    • Пароль чтения: 00000001
    • Логический адрес: 1
    • Физический адрес: 17
    • Размер адреса: 2

РиМ489.38 и другие из серии

  • Передает тип ПУ на русском языке. Для текстового сенсора 0.0.96.1.1.255 необходимо установить cp1251: true

Примеры конфигураций

Однофазный счетчик (ПУ категории D)

Используется список параметров ПУ категории D из стандарта СПОДЭС. Они применяются в однофазных ПУ потребителей.

Пример файла конфигурации, протестированого на Энергомера CE207-SPds.

esphome:
  name: energomera-ce207-spds
  friendly_name: Energomera-ce207-spds

esp32:
  board: esp32dev
  framework:
    type: arduino

external_components:
  - source: github://latonita/esphome-dlms-cosem
    components: [dlms_cosem]
    refresh: 1s

uart:
  id: bus_1
  rx_pin: GPIO16
  tx_pin: GPIO17
  baud_rate: 9600
  data_bits: 8
  parity: NONE
  stop_bits: 1

dlms_cosem:
  id: energo_01
  client_address: 32
  server_address: 1
  auth: true
  password: "12345678"
  update_interval: 60s
  receive_timeout: 1s

sensor:
  - platform: dlms_cosem
    name: Phase Current
    obis_code: 1.0.11.7.0.255
    unit_of_measurement: A
    accuracy_decimals: 1
    device_class: current
    state_class: measurement
  - platform: dlms_cosem
    name: Neutral Current
    obis_code: 1.0.91.7.0.255
    unit_of_measurement: A
    accuracy_decimals: 1
    device_class: current
    state_class: measurement
  - platform: dlms_cosem
    name: Phase Voltage
    obis_code: 1.0.12.7.0.255
    unit_of_measurement: V
    accuracy_decimals: 1
    device_class: voltage
    state_class: measurement
  - platform: dlms_cosem
    name: Power Factor
    obis_code: 1.0.13.7.0.255
    unit_of_measurement: ''
    accuracy_decimals: 2
    device_class: power_factor
    state_class: measurement
  - platform: dlms_cosem
    name: Grid Frequency
    obis_code: 1.0.14.7.0.255
    unit_of_measurement: Hz
    accuracy_decimals: 1
    device_class: frequency
    state_class: measurement
  - platform: dlms_cosem
    name: Apparent Power
    obis_code: 1.0.9.7.0.255
    unit_of_measurement: W
    accuracy_decimals: 1
    device_class: power
    state_class: measurement
  - platform: dlms_cosem
    name: Active Power
    obis_code: 1.0.1.7.0.255
    unit_of_measurement: W
    accuracy_decimals: 1
    device_class: power
    state_class: measurement
  - platform: dlms_cosem
    name: Reactive Power
    obis_code: 1.0.3.7.0.255
    unit_of_measurement: W
    accuracy_decimals: 1
    device_class: power
    state_class: measurement
  - platform: dlms_cosem
    name: Active Energy
    obis_code: 1.0.1.8.0.255
    unit_of_measurement: kWh
    accuracy_decimals: 3
    device_class: energy
    state_class: total_increasing
    filters:
      - multiply: 0.001
  - platform: dlms_cosem
    name: Active Energy T1
    obis_code: 1.0.1.8.1.255
    unit_of_measurement: kWh
    accuracy_decimals: 3
    device_class: energy
    state_class: total_increasing
    filters:
      - multiply: 0.001
  - platform: dlms_cosem
    name: Active Energy T2
    obis_code: 1.0.1.8.2.255
    unit_of_measurement: kWh
    accuracy_decimals: 3
    device_class: energy
    state_class: total_increasing
    filters:
      - multiply: 0.001
  - platform: dlms_cosem
    name: Active Energy Export
    obis_code: 1.0.2.8.0.255
    unit_of_measurement: kWh
    accuracy_decimals: 3
    device_class: energy
    state_class: total_increasing
    filters:
      - multiply: 0.001
  - platform: dlms_cosem
    name: Reactive Energy
    obis_code: 1.0.3.8.0.255
    unit_of_measurement: kWh
    accuracy_decimals: 3
    device_class: energy
    state_class: total_increasing
    filters:
      - multiply: 0.001
  - platform: dlms_cosem
    name: Reactive Energy Export
    obis_code: 1.0.4.8.0.255
    unit_of_measurement: kWh
    accuracy_decimals: 3
    device_class: energy
    state_class: total_increasing
    filters:
      - multiply: 0.001

text_sensor:
  - platform: dlms_cosem
    name: Serial Number
    obis_code: 0.0.96.1.0.255
    entity_category: diagnostic
  - platform: dlms_cosem
    name: Type
    obis_code: 0.0.96.1.1.255
    cp1251: true
    entity_category: diagnostic
  - platform: dlms_cosem
    name: Metrology Software Version
    obis_code: 0.0.96.1.2.255
    entity_category: diagnostic
  - platform: dlms_cosem
    name: Manufacturer
    obis_code: 0.0.96.1.3.255
    entity_category: diagnostic

Трехфазный счетчик в режиме push

Работа в режиме PUSH на примере счетчика ZPA AM375.

esphome:
  name: energomera-ce207-spds
  friendly_name: Energomera-ce207-spds

esp32:
  board: esp32dev
  framework:
    type: arduino

external_components:
  - source: github://latonita/esphome-dlms-cosem
    components: [dlms_cosem]
    refresh: 1s

uart:
  id: bus_1
  rx_pin: GPIO16
  tx_pin: GPIO17
  baud_rate: 9600
  data_bits: 8
  parity: NONE
  stop_bits: 1

dlms_cosem:
  id: energo_01
  client_address: 32
  server_address: 1
  auth: true
  password: "12345678"
  update_interval: 60s
  receive_timeout: 1s

dlms_cosem:
  id: cosem1
  uart_id: bus_1
  push_mode: true

text_sensor:
  - platform: dlms_cosem
    name: Serial number
    obis_code: 0.0.96.1.1.255
    entity_category: diagnostic

  - platform: dlms_cosem
    name: Current tariff
    obis_code: 0.0.96.14.0.255
    entity_category: diagnostic

sensor:

  - platform: dlms_cosem
    id: active_energy_consumed
    name: Energy
    obis_code: 1.0.1.8.0.255
    unit_of_measurement: kWh
    accuracy_decimals: 0
    device_class: energy
    state_class: total_increasing

  - platform: dlms_cosem
    id: active_energy_consumed_t1
    name: Energy T1
    obis_code: 1.0.1.8.1.255
    unit_of_measurement: kWh
    accuracy_decimals: 0
    device_class: energy
    state_class: total_increasing

  - platform: dlms_cosem
    id: active_energy_consumed_t2
    name: Energy T2
    obis_code: 1.0.1.8.2.255
    unit_of_measurement: kWh
    accuracy_decimals: 0
    device_class: energy
    state_class: total_increasing

  - platform: dlms_cosem
    id: active_power
    name: Active power Total
    obis_code: 1.0.1.7.0.255
    unit_of_measurement: W
    accuracy_decimals: 0
    device_class: power
    state_class: measurement

  - platform: dlms_cosem
    id: active_power_l1
    name: Active power L1
    obis_code: 1.0.21.7.0.255
    unit_of_measurement: W
    accuracy_decimals: 0
    device_class: power
    state_class: measurement

  - platform: dlms_cosem
    id: active_power_l2
    name: Active power L2
    obis_code: 1.0.41.7.0.255
    unit_of_measurement: W
    accuracy_decimals: 0
    device_class: power
    state_class: measurement

  - platform: dlms_cosem
    id: active_power_l3
    name: Active power L3
    obis_code: 1.0.61.7.0.255
    unit_of_measurement: W
    accuracy_decimals: 0
    device_class: power
    state_class: measurement

Диагностика и советы

  • Нет ответа: проверьте RE/DE (flow_control_pin) и направление конвертера RS‑485
  • Таймауты: увеличьте receive_timeout и delay_between_requests
  • Адреса: перепроверьте client_address и server_address по инструкции (учитывайте адреса для оптопорта vs RS‑485)
  • Русский текст «кракозябрами»: включите cp1251: true

Лицензия

См. LICENSE в репозитории.

About

Supports DLMS/Cosem IEC IEC 62056-21 Mode E (Hdlc), session mode and passive PUSH mode readout. Подключение EspHome к счетчикам электроэнергии по протоколу СПОДЭС ГОСТ Р 58940-202 (Энергомера ce207, ce208, CE307, CE308, Меркурий, Пульсар, Милур, Мир, Нартис, РиМ и другие).

Topics

gost mercury hdlc mir han dlms cosem esphome zpa spds energomera spodes milur nartis iec-62056-21-mode-e han-evn han-nve han-efs

Resources

Readme

License

MIT license
Activity

Stars

25 stars

Watchers

3 watching

Forks

7 forks
Report repository

Releases 2

v6.1 Latest
Oct 20, 2025
+ 1 release

Contributors 2

Languages