百科.dev
全部条目在线工具AI 编程趋势榜开源项目技术资讯提交条目
登录
< 返回工具列表
E

esphome_aux_ac_component

> 编程语言
开源

AUX型空调机的ESPHome组件. 由ESPHome和家居助理直接对HVAC进行wifi控制. 提供HVAC状态和命令反馈.

358 stars0 点赞1 次浏览
访问官网GitHub

工具介绍

AUX型空调机的ESPHome组件. 由ESPHome和家居助理直接对HVAC进行wifi控制. 提供HVAC状态和命令反馈.

Кастомный компонент для ESPHome для управления кондиционером по Wi-Fi

English readme is here.

Управляет кондиционерами на базе AUX по Wi-Fi.

По тексту ниже для компонента используется сокращение aux_ac.

Обсудить проект можно в чате Телеграм.

Отзывы о багах и ошибках, а так же запросы на дополнительный функционал оставляйте в соответствующем разделе. Будет просто отлично, если к своему сообщению вы добавите лог и подробное описание. Для сбора логов есть специальный скрипт на Python. С его помощью вы сможете сохранить в csv-файл все пакеты, которыми обменивается Wi-Fi модуль и сплит-система. Если такой лог дополнить описанием, в какое время и что именно вы пытались включить, то это сильно ускорит исправление багов. Также есть подробная инструкция, описывающая как правильно запросить фичу.

ДИСКЛЭЙМЕР (ОТМАЗКИ)

  1. Все материалы этого проекта (программы, прошивки, схемы, 3D модели и т.п.) предоставляются "КАК ЕСТЬ". Всё, что вы делаете с вашим оборудованием, вы делаете на свой страх и риск. Автор не несет ответственности за результат и ничего не гарантирует. Если вы с абсолютной четкостью не понимаете, что именно вы делаете и для чего, лучше просто купите Wi-Fi модуль у производителя вашего кондиционера.
  2. Я не настоящий сварщик не программер. Поэтому код наверняка не оптимален и плохо оформлен (зато комментариев по коду я разместил от души), местами может быть написан небезопасно. И хоть я и старался протестировать всё, но уверен, что какие-то моменты упустил. Так что отнеситесь к коду с подозрением, ожидайте от него подвоха и если что-то увидели - пишите в багрепорт.

Поддерживаемые кондиционеры

AUX - это один из нескольких OEM-производителей кондиционеров. AUX производят кондиционеры как под собственным брендом, так и для внешних заказчиков. Поэтому есть шанс, что произведенный на их фабрике кондиционер неизвестного бренда с aux_ac так же заработает. В интернете есть такой перечень производившихся на фабриках AUX брендов: AUX, Abion, AC ELECTRIC, Almacom, Ballu , Centek, Climer, DAX, Energolux, ERISSON, Green Energy, Hyundai, IGC, Kentatsu (некоторые серии), Klimaire, KOMANCHI, LANZKRAFT, LEBERG, LGen, Monroe, Neoclima, NEOLINE, One Air, Pioneer (до 2016 года), Roda, Rovex, Royal Clima, SAKATA, Samurai, SATURN, Scarlett, SmartWay, Soling, Subtropic, SUBTROPIC, Supra, Timberk, Vertex, Zanussi. В его полноте и достоверности есть сомнения, но ничего лучше найти не удалось.

Список совместимых (протестированных) кондиционеров

Список протестированных кондиционеров размещен в отдельном файле и включает те модели, на которых aux_ac был запущен автором компонента или пользователями. Этот список постоянно пополняется, преимущественно по обратной связи от пользователей в чате Телеграм.

Если кондиционер в списке отсутствует

Если ваш кондиционер отсутствует в списке протестированных, то это еще не значит, что его не получится подключить к Wi-Fi. Вот основные "звоночки", которые могут говорить о высоких шансах на успех:

  1. Если производитель вашего кондиционера есть в списке протестированных выше, но модели нет.
  2. Если на шильдике кондиционера в строке производитель написано что-то про AUX или Аукс.
  3. Если в инструкции пользователя вашего кондиционера что-то написано про возможность управления по Wi-Fi с помощью мобильного приложения ACFreedom.
  4. Если производитель вашего кондиционера предлагает для управления Wi-Fi модуль CTTM-40X24-WIFI-AKS (слева) или такой, как на фото справа. Причем правый модуль может быть как с USB-разъемом, так и с 5-контактным разъемом.

Но будьте осмотрительны: ваш кондиционер никем не тестировался и важно четко понимать, что вы делаете. Иначе можете наломать дров.
Если вы не уверены в своих силах, лучше дождитесь, пока другие более опытные пользователи протестируют вашу модель кондиционера (правда, это может не случиться никогда). Или приходите с вопросами в телеграм-чат. Возможно, там вам помогут.

Если вы протестировали ваш кондиционер и он работает, напишите мне, пожалуйста. Я внесу вашу модель в список протестированных. Возможно, это упростит кому-то жизнь =)

Лучший способ сообщить о протестированном кондиционере - написать в телеграм или в разделе багрепортов и заказа фич.

Как использовать компонент

Для работы с кондиционером понадобится "железо" и прошивка. Описание электроники вынесено в отдельный файл.

Прошивка: интеграция aux_ac в вашу конфигурацию ESPHome

Для использования требуется ESPHome версией не ниже 2026.1.0.
Для компиляции с ESPHome более ранних версий используйте компонент v.0.3.2 или младше.

Установка

  1. Подключите компонент. За подробностями можно заглянуть в официальную документацию ESPHome.
yaml
external_components:
  - source:
      type: git
      url: https://github.com/GrKoR/esphome_aux_ac_component

Если требуется прошить определенную версию компонента, используйте синтаксис из примера ниже. Здесь прошивается версия 0.2.14. Список версий смотрите в тегах на гитхаб.

yaml
external_components:
  - source:
      type: git
      url: https://github.com/GrKoR/esphome_aux_ac_component
      ref: v.0.2.14
  1. Настройте UART для коммуникации с вашим кондиционером:
yaml
uart:
  id: ac_uart_bus
  # ВНИМАНИЕ! Для TX и RX на платах типа NodeMCU используйте GPIO4 (D2) и GPIO5 (D1)!
  # подробнее см. в документации: https://github.com/GrKoR/esphome_aux_ac_component/blob/master/docs/HARDWARE.md
  tx_pin: GPIO1
  rx_pin: GPIO3
  baud_rate: 4800
  data_bits: 8
  parity: EVEN
  stop_bits: 1
  1. ВАЖНО! Нужно отключить логгер ESPHome, чтобы он не отправлял в кондиционер свои данные. Отключение логгера от UART никак не затронет вывод в лог консоли или web-сервера.
yaml
logger:
    baud_rate: 0

Если по каким-то причинам вам нужен вывод логгера в UART, можно переключить его на другой UART чипа. Например, у ESP8266 два аппаратных UART: UART0 и UART1. Aux_ac подходит только UART0, поскольку только он у esp8266 имеет и TX и RX. Логгеру достаточно только TX. Такой функционал в чипе esp8266 у UART1:

yaml
logger:
    level: DEBUG
    hardware_uart: UART1

Настройка компонента

Минимальная конфигурация:

yaml
climate:
  - platform: aux_ac
    name: "AC Name"

Полная конфигурация:

…

Параметры компонента:

  • name (Обязательный, строка): Имя кондиционера. Как минимум один из параметров id или name должен быть указан!

  • id (Опциональный, ID): Укажите идентификатор кондиционера чтобы обращаться к нему из кода. Как минимум один из параметров id или name должен быть указан!

  • uart_id (Опциональный, ID): Укажите ID шины UART, к которой подключен кондиционер. Если сконфигурирована одна шина, то компонент подключит её автоматически. Если шин несколько, то лучше указать вручную.

  • period (Опциональный, время, по умолчанию 7s): Период между запросами статуса кондиционера. Aux_ac получает новое состояние кондиционера только после регулярного запроса, потому что сам кондиционер об изменении параметров своей работы не уведомляет. Поэтому нужно запрашивать его, вдруг пользователь установил иной режим работы с помощью ИК-пульта.

  • show_action (Опциональный, логическое, по умолчанию true): Показывать ли текущую задачу кондиционера (экспериментальная функция). Например, в режиме HEAT_COOL кондиционер может выполнять одну из следующих задач:

    • НАГРЕВ: нагревает воздух в комнате;
    • ПРОСТОЙ: кондиционер работает в режиме вентилятора для перемешивания воздуха в комнате, поскольку целевая температура уже достигнута;
    • ОХЛАЖДЕНИЕ: кондиционер охлаждает воздух в комнате. Аналогично будут отображаться действия кондиционера и для режимов ОТОПЛЕНИЕ и ОХЛАЖДЕНИЕ. Единственная разница будет в количестве действий: ПРОСТОЙ+НАГРЕВ для режима отопления и ПРОСТОЙ+ОХЛАЖДЕНИЕ для режима охлаждения комнаты.
  • display_inverted (Опциональный, логическое, по умолчанию false): Настраивает способ управления дисплеем. Как выяснилось (issue #31), включение-выключение дисплея обрабатывается кондиционерами по разному. Кондиционеры Rovex включают дисплей по 0 в соответствующем бите команды и выключают по биту 1. Многие другие модели кондиционеров поступают наоборот.

  • timeout (Опциональный, неотрицательное целое, по умолчанию 150): Таймаут получения пакета для ресивера данных aux_ac.
    Чаще всего вам это значение никогда не понадобится. Поскольку этот параметр опционален, то его можно смело пропустить, если нет необходимости менять таймауты.
    Единственная ситуация, когда вам может пригодиться этот параметр, - это сильно загруженная ESP. Если по какой-то неподдающейся логике причине вы кроме aux_ac нагрузили свою ESP кучей дополнительных ресурсоемких задач, то у компонента может просто не хватать времени для оперативного приёма ответов от кондиционера. В этом в логе будут сообщения о том, что последовательность команд была прервана по таймауту. Чтобы это исправить, лучше, конечно, немного разгрузить ESP. Если это вам не подходит, тогда можно увеличить таймаут.
    Значение таймаута в прошивке ограничено диапазоном от 150 до 600 миллисекунд. Устанавливать значения выше можно только отредактировав исходные коды компонента. Но сильно задирать таймаут не стоит. Кондиционер периодически рассылает пакеты без запроса со стороны aux_ac и это приводит к сбою в отправке команды.

  • optimistic (Опциональный, логическое, по умолчанию true) В «оптимистичном» режиме компонент не ждёт от кондиционера изменения параметров работы, а сразу после отправки команды в кондиционер сообщает в Home Assistant о новом состоянии. Если кондиционер команду не принял, то спустя несколько секунд eps получит текущее состояние всех систем и отправит в умный дом реальное состояние кондиционера. В итоге, если подавать в кондиционер неподдерживаемые команды, они будут записываться в историю Home Assistant и спустя время сбрасываться сбрасываться.
    В «пессимистичном» режиме esp отправляет команду в кондиционер, но об изменении состояний не сообщает до тех пор, пока не получит информацию о фактическом режиме работы кондиционера.
    В большинстве случаев разница между этими режимами будет практически незаметна.

  • indoor_temperature (Опциональный): Параметры создаваемого датчика температуры воздуха, если такой датчик нужен

    • name (Обязательный, строка): Имя датчика температуры.
    • id (Опциональный, ID): Можно указать свой ID для датчика для использования в лямбдах.
    • internal (Опциональный, логическое): Пометить данный датчик как внутренний. Внутренний датчик не будет передаваться во фронтэнд (такой как Home Assistant). В противоположность стандартному поведению сенсоров этот параметр для датчика в кондиционере всегда выставлен в true за исключением случаев, когда пользователь не установил его в false. То есть по умолчанию значение сенсора н

Issues· 0 开放

查看全部 Issues在 GitHub 打开

暂无开放 Issues,或尚未同步最近议题。

> 标签

C++airconditioningesphomehvachvac-control

暂无评论,来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日
最后更新2026年9月17日
分类编程语言
定价开源

> 相关工具

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言