Fairland, тепловой насос бассейна

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

Репозиторий rstcologne/ESP-Home-Fairland-Heatpump снимает зависимость от Tuya у теплового насоса Fairland. Автор проверял IPS Pro, который продаёт Pool Systems, и пишет, что плата близка к серии InverX. Лицензия репозитория CC0.

Связь — Modbus RTU, 9600, адрес 0x0001. На плате разъём подписан B, A, G и +12V. Питание ESP берут с этих 12 В через понижающий преобразователь, который заранее выставляют на 5 В. Автор прямо пишет: преобразователь с невыставленным выходом сожжёт ESP.

Модуль MAX485 с автоматическим направлением. Если автомата нет, в YAML раскомментируют flow_control_pin: GPIO4 и сажают этот GPIO на средние контакты модуля. В опубликованном фрагменте пины UART названы RX и TX и числом не заданы. Проводка текстом: RX ESP на контакт RXD модуля, TX ESP на TXD. Это прямые подписи модуля, не перекрёст TX–RX, о котором говорит общий раздел сайта.

Регистры клапана, оттайки и ручного открытия в том же файле есть. Ниже только питание (катушка 0), режим (регистр 0) и режим мощности (регистр 1). Остальное остаётся в файле репозитория.

Автор предупреждает: плата под сетевым напряжением, рядом крупные конденсаторы. Корпус открывают при снятом питании.

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

• Включение, нагрев, охлаждение и тихий режим без приложения Tuya
• На плате уже есть разъём Modbus, штатный модуль Wi-Fi не перепаивают
• Режим Super silence, которого нет на штатной панели, описан в теме сообщества

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

• Нужно открыть корпус и подойти к силовой плате
• После включения насос часто сам встаёт в тихий режим, даже если до этого был normal
• YAML репозитория ругается на повторяющиеся записи Modbus, автор пишет, что при этом насос всё же работает

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

• ESP и модуль MAX485, лучше с автоматическим направлением
• Понижающий преобразователь с 12 В на 5 В, выставленный до подключения ESP
• Разъём JST-XH на 4 контакта под гребёнку платы

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.

Как открывает автор свой корпус: два винта снизу у клемм питания, ещё два освобождают панель блока управления, её снимают и отключают. Два винта крышки сверху и один сзади, крышку поднимают. В центре мягкий кожух, под ним плата.

На гребёнке в центре фото: B, A, G, +12V. A и B идут на A и B модуля MAX485. Земля и 12 В идут на вход преобразователя. Выход преобразователя — на 5 В и землю ESP, только после замера. 3,3 В ESP — на VCC модуля MAX485, земля ESP — на землю модуля.

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, паяльник больше не нужен.

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

ESP прошивают по USB, вне насоса. В подстановках ниже стоят GPIO3 и GPIO1 только как значения, которые нужно заменить на пины своей платы. Репозиторий эти номера не публиковал. Катушка 0 включает насос. Регистр 0: 0 авто, 1 нагрев, 2 охлаждение. Регистр 1: 0 normal, 1 silence, 2 super silence, 3 turbo.

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

# В репозитории пины названы RX и TX и числом не заданы.
# Подставьте GPIO своей платы: RX ESP на контакт RXD модуля MAX485, TX ESP на TXD.
substitutions:
  rx_pin: GPIO3
  tx_pin: GPIO1

logger:
  baud_rate: 0

uart:
  id: mod_bus
  rx_pin: ${rx_pin}
  tx_pin: ${tx_pin}
  baud_rate: 9600

modbus:
  # flow_control_pin: GPIO4
  id: modbus1

modbus_controller:
  - id: fairland
    address: 0x0001
    modbus_id: modbus1
    update_interval: 2s

switch:
  - platform: modbus_controller
    modbus_controller_id: fairland
    name: Питание
    register_type: coil
    address: 0x0

select:
  - platform: modbus_controller
    modbus_controller_id: fairland
    name: Режим
    address: 0x0
    value_type: U_WORD
    optionsmap:
      "Auto": 0
      "Heating": 1
      "Cooling": 2
  - platform: modbus_controller
    modbus_controller_id: fairland
    name: Мощность
    address: 0x1
    value_type: U_WORD
    optionsmap:
      "Normal": 0
      "Silence": 1
      "Super silence": 2
      "Turbo": 3

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

Выключатель питания и два списка придут через API. Уставку температуры автор считает отдельной формулой по регистрам 2 и 3. Её нет в коротком конфиге: в файле у нагрева и охлаждения разные диапазоны, копировать одну формулу на оба регистра нельзя.

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

• Преобразователь не выставлен на 5 В до подключения ESP
• Оставлены имена пинов RX и TX без подстановки, конфиг не собирается
• TX ESP посажен на RXD по общему правилу перекрёста, хотя автор соединяет RX с RXD и TX с TXD
• После включения режим мощности сам становится тихим

9. Источники

• GitHub rstcologne/ESP-Home-Fairland-Heatpump https://github.com/rstcologne/ESP-Home-Fairland-Heatpump
• GitHub Фрагмент YAML https://github.com/rstcologne/ESP-Home-Fairland-Heatpump/blob/main/config/esphome_snippet.yaml
• Обсуждение Тема Home Assistant про Fairland без Tuya https://community.home-assistant.io/t/controlling-a-fairland-pool-heatpump-eliminating-tuya/579467