ESP-helper

Обновлено 2026-09-22

Heltec HRI-485X

Heltec, модель HRI-485X. 3/5 · разборка. Модуль Wi-Fi говорит со вторым микроконтроллером.

1. Название и модель

HRI-485X — плата Heltec, чтобы ESP32 говорил по RS-485. Драйвер линии — MAX3485, его питание карточка включает GPIO16. Без этого уровня на шине нет, хотя UART уже настроен. Сложность 3/5.

Пример в карточке опрашивает Modbus на 9600: передача GPIO33, приём GPIO37. Журнал с UART снимают. На борту ещё Ethernet: MDC GPIO23, MDIO GPIO18, тактовая GPIO17.

Первый светодиод на панели сидит на питании и горит всегда. Второй в примере показывает связь с Home Assistant, третий — статус ESPHome.

Адреса регистров в примере — демонстрация. Счётчик на вашей шине отвечает своими регистрами. Их берут из паспорта счётчика.

Плата Heltec HRI-485X
HRI-485X. Драйвер RS-485 питается с GPIO16. Фото: esphome/devices.esphome.io, GPL-3.0

2. Что даёт перепрошивка

  • Опрос Modbus RTU из Home Assistant без отдельного USB-адаптера
  • Питание драйвера под контролем GPIO, плату можно усыпить по шине
  • Ethernet, если Wi-Fi в щите не проходит

3. Что теряется

  • Плата не измеряет ничего сама. Сущности появятся только для тех регистров, которые вы впишете
  • Wi-Fi и Ethernet вместе ESPHome не поднимает

4. Что понадобится

  • USB для прошивки ESP32 на плате
  • Паспорт устройства на шине: адрес, скорость, карта регистров
  • Карточка HRI-485X как образец пинов, не как карта вашего счётчика

5. Разборка и пины

Программатор USB–UART подключают к модулю, который прошивают, крест-накрест:

  • Земля переходника (GND) — на землю платы. Этот провод обязателен.
  • TX переходника — на RX модуля. На плате площадка часто подписана RX, RXD или RXD0.
  • RX переходника — на TX модуля. На плате это TX, TXD или TXD0.
  • Питание логики — 3,3 В. Пять вольт на эти площадки не подают. Если плату уже кормит её блок, линию 3,3 В с переходника не подключают вторым источником.
  • Для входа в загрузчик ESP8266 и ESP32 площадку GPIO0 (IO0, BOOT) замыкают на землю и в этот момент подают питание. После старта записи землю с GPIO0 снимают.

Если у этой модели в тексте ниже другие имена площадок, прямой порядок TX–TX или прошивка по USB, делайте как написано там. Общая схема выше — для обычного модульного UART.

Паять для первого запуска не нужно, если пользуетесь штатным USB. Клеммы A/B шины RS-485 и земля — на плате, их сверяют с шелкографией Heltec.

GPIO16 должен быть включён, прежде чем ждать ответ по Modbus. В примере это выход, который питает MAX3485.

6. Прошивка

Готового файла «прошивка именно этой модели» на этом сайте нет. Её собирает ESPHome из текстового конфига YAML: туда входят Wi-Fi, пины и команды второго чипа. Чужой .bin из интернета почти наверняка собран с чужим паролем сети.

Какую программу ставить

  • ESPHome Dashboard — дополнение в Home Assistant или программа на компьютере. В ней пишут YAML, нажимают Install, и она сама собирает прошивку. Установка: дополнение для Home Assistant или команда pip install esphome.
  • ESPHome Web, сайт web.esphome.io, — загрузчик в браузере Chrome или Edge. Им записывают уже собранный .bin на ESP8266 и ESP32 через USB–UART. На BK72xx он не рассчитан.
  • esptool — программа Espressif, чтобы снять заводскую копию флеша и записать .bin, если браузер порт не видит. Репозиторий: espressif/esptool.
  • ltchiptool — то же самое для чипов Beken BK72xx (модули WB3S, WBR3, CB3S и похожие). ESPHome для них собирается через LibreTiny. Программа: libretiny-eu/ltchiptool, описание платы: компонент bk72xx.

Как собрать конфиг

  1. В Dashboard нажмите New Device и выберите чип, который стоит на плате: ESP8266, ESP32 или BK72xx. Имя — латиницей, без пробелов.
  2. Пароль Wi-Fi уберите в файл secrets.yaml рядом с конфигом. В YAML оставьте ssid: !secret wifi_ssid и password: !secret wifi_password.
  3. Блок UART, модель и скорости из раздела ниже вставьте в этот файл. Полный пример, если он длинный, берите по ссылке в источниках внизу страницы, а не из гайда соседней модели.
  4. Строки api: и ota: оставьте. Без api: Home Assistant устройство не увидит. Ключ шифрования Dashboard предлагает сам, его потом спросит интеграция ESPHome.

Как залить первый раз

  1. Подключите USB–UART, как в разделе «Разборка и пины»: земля переходника на землю платы, TX переходника на RX модуля, RX переходника на TX модуля. Логика 3,3 В. Имена площадок на конкретной плате — там же.
  2. Для ESP8266 и ESP32 замкните GPIO0 (IO0, BOOT) на землю и в этот момент подайте питание. Для BK72xx ltchiptool сам просит перезапустить чип, обычно кратким отключением земли.
  3. В Dashboard: Install → Plug into this computer, выберите порт переходника. Либо Install → Manual download, сохраните .bin и откройте его на web.esphome.io. Из терминала то же самое делает esphome run имя-устройства.yaml.
  4. Когда в логе появится IP-адрес, GPIO0 от земли отпустите, провода можно отпаять. Следующие обновления идут по Wi-Fi, пункт OTA, паяльник больше не нужен.

Дальше — только то, чем эта модель отличается от общей схемы.

Блок modbus: и modbus_controller: дописывают под адрес вашего счётчика. Скорость в YAML и в счётчике должны совпасть. Регистры из чужого примера дадут нули или ошибку CRC.

Базовый конфиг этой модели с карточки или из репозитория компонента. Wi-Fi, пароль и OTA задайте как в общем разделе выше. Пароли из исходника сюда не перенесены.

esphome:
  name: heltec-modbus
  friendly_name: Heltec-Modbus

esp32:
  variant: esp32
  framework:
    type: arduino
  
# Enable logging
logger:
  level: DEBUG
  baud_rate: 0

# Enable Home Assistant API
status_led:
  pin: GPIO3

ethernet:
  type: RTL8201
  mdc_pin: GPIO23
  mdio_pin: GPIO18
  clk_mode: GPIO17_OUT
  phy_addr: 0

uart:
  - id: mod_bus
    tx_pin: GPIO33
    rx_pin: GPIO37
    baud_rate: 9600
    data_bits: 8
    parity: NONE
    stop_bits: 1

modbus:
  - uart_id: mod_bus
    id: modbus1

modbus_controller:
  - id: epever
    address: 0x1
    modbus_id: modbus1
    setup_priority: -10
    update_interval: 5s

sensor:
  - platform: modbus_controller
    modbus_controller_id: epever
    name: "Temperature"
    id: temp
    register_type: read
    address: 0x0001
    unit_of_measurement: "C"
    value_type: U_WORD
    accuracy_decimals: 1
    filters:
      - multiply: 0.1

  - platform: modbus_controller
    modbus_controller_id: epever
    name: "Humidity"
    id: hum
    register_type: read
    address: 0x0002
    unit_of_measurement: "%"
    value_type: U_WORD
    accuracy_decimals: 1
    filters:
      - multiply: 0.1

switch:
  - platform: gpio
    pin: GPIO16
    id: ModbusOnOff

  - platform: gpio
    pin: GPIO2
    id: HAOnlineLed
    inverted: true

7. Настройка в Home Assistant

Пока GPIO16 выключен, все сенсоры Modbus будут недоступны. Включите питание драйвера и только потом смотрите энергию.

8. Известные баги и как их обойти

  • GPIO16 забывают, шина мертва, UART при этом «открыт»
  • Регистры копируют из примера карточки и думают, что это их счётчик
  • Журнал занимает UART, если baud_rate логгера не ноль

9. Источники