mirror of
https://github.com/GrKoR/esphome_aux_ac_component.git
synced 2025-12-06 03:26:56 +03:00
readme changes
This commit is contained in:
GrKoR
28
README-EN.md
28
README-EN.md
@@ -11,7 +11,7 @@ For issues or feature requests, please go to [the issue section](https://github.
|
||||
|
||||
## Short description ##
|
||||
This custom component allows you to control your air conditioner through wifi if it is made in the AUX factory.
|
||||
Component tested with ESPHome 1.15.3 and Rovex ALS1 air conditioner. It looks like many other air conditioners can be controlled by aux_ac but this possibility isn't tested. See list of testetd ACs below for more details.
|
||||
Component tested with ESPHome 1.15.3 and Rovex ALS1 air conditioner. It looks like many other air conditioners can be controlled by `aux_ac` but this possibility isn't tested. See list of testetd ACs below for more details.
|
||||
|
||||
|
||||
## Supported air conditioners ##
|
||||
@@ -23,8 +23,8 @@ These ACs were tested by the author or by users.
|
||||
|
||||
### List of potential compatible ACs ###
|
||||
**NOT TESTED! TRY AT YOUR OWN RISK!**
|
||||
AUX is one of the OEM air conditioner manufacturers. They produce ACs for many brands.
|
||||
Internet says that following air conditioners may test with aux_ac component:
|
||||
AUX is one of the OEM air conditioner manufacturers. AUX produce ACs for many brands.
|
||||
Internet says that following air conditioners may test with `aux_ac` component:
|
||||
+ AUX
|
||||
+ Abion
|
||||
+ AC ELECTRIC
|
||||
@@ -55,7 +55,9 @@ Internet says that following air conditioners may test with aux_ac component:
|
||||
+ Vertex
|
||||
+ Zanussi
|
||||
|
||||
If the User Manual of your HVAC describes connection to wifi with mobile app ACFreedom it seems you may go deeper with aux_ac. But try all soft and hardware for your own risk. You must clearly understand what you are doing.
|
||||
If your AC is listed above you you should take a closer look at `aux_ac`.
|
||||
|
||||
If the User Manual of your HVAC describes connection to wifi with mobile app ACFreedom it seems you may go deeper with `aux_ac`. But try all soft and hardware for your own risk. You must clearly understand what you are doing.
|
||||
If you are unsure it is better to wait while other users will test your model of AC (but it may never). Or please [go to telegram-chat](https://t.me/aux_ac) with your questions. Maybe you will get help there.
|
||||
|
||||
If you have tested your air conditioner and `aux_ac` works with it please let me know about it. I'll add this info to the list of tested ACs above.
|
||||
@@ -68,12 +70,13 @@ I tested it with an esp8266 chip (esp-12e). Minimal scheme:
|
||||
|
||||
|
||||
|
||||
In real life looks minimalistic too:
|
||||
At the first time in addition to scheme above IO0 (GPIO0) must be pulled down to GND at the boot and ESPHome can be uploaded through UART0. If your ESPHome configuration contains OTA you can pull up IO0 or leave it floating. All further updates can be uploaded over-the-air.
|
||||
I leave GPIO0 in air cause I don't see any reason to solder additional components for single use.
|
||||
|
||||
ESP-12E before DC-DC and air conditioner connected:
|
||||
|
||||
|
||||
|
||||
At the first time IO0 (GPIO0) must be pulled down to GND at the boot and ESPHome can be uploaded through UART0. If your ESPHome configuration contains OTA you can pull up IO0 or leave it floating. All further updates can be uploaded over-the-air.
|
||||
|
||||
Air conditioner internal block has a 5-wire connection to the wifi-module. Connector is [JST SM](https://www.jst-mfg.com/product/pdf/eng/eSM.pdf).
|
||||
|
||||
Wires:
|
||||
@@ -136,7 +139,7 @@ uart:
|
||||
parity: EVEN
|
||||
stop_bits: 1
|
||||
```
|
||||
4. ESP8266 has two hardware UARTs: UART0 and UART1. Only UART0 suits for aux_ac cause only it has both TX and RX. In **uart:** section above we configure UART0 for aux_ac. But it used by **logger:**. So it is necessary to redefine UART for logger:
|
||||
4. ESP8266 has two hardware UARTs: UART0 and UART1. Only UART0 suits for `aux_ac` cause only it has both TX and RX. In **uart:** section above we configure UART0 for `aux_ac`. But it used by **logger:**. So it is necessary to redefine UART for logger:
|
||||
```yaml
|
||||
logger:
|
||||
level: DEBUG
|
||||
@@ -157,13 +160,16 @@ climate:
|
||||
```
|
||||
|
||||
## Example ##
|
||||
Files `ac_common.yaml`, `ac_kitchen.yaml` and `ac_livingroom.yaml` show standard way to use aux_ac custom component.
|
||||
Files `ac_common.yaml`, `ac_kitchen.yaml` and `ac_livingroom.yaml` show standard way to use `aux_ac` custom component.
|
||||
|
||||
`ac_common.yaml` contains a common configuration part for two air conditioners. One of the ACs is located in a kitchen, the second one is in a living room.
|
||||
|
||||
`ac_kitchen.yaml` and `ac_livingroom.yaml` contain specific parts of configuration: IP-addresses, device names etc.
|
||||
|
||||
If you try to compile `ac_common.yaml` it will raise errors. You need to compile `ac_kitchen.yaml` or `ac_livingroom.yaml` instead.
|
||||
|
||||
## Additional functionality ##
|
||||
Aux_ac component provides three additional sensors: two temperatures and firmware version.
|
||||
`Aux_ac` component provides three additional sensors: two temperatures and firmware version.
|
||||
|
||||
### Ambient temperature ###
|
||||
This is the current room air temperature from AC's sensor. If you need it in your configuration place this code to YAML file:
|
||||
@@ -218,7 +224,7 @@ sensor:
|
||||
```
|
||||
|
||||
### Firmware version ###
|
||||
Aux_ac component also gives information about source code version. You can add it to your config with this code:
|
||||
`Aux_ac` component also gives information about source code version. You can add it to your config with this code:
|
||||
```yaml
|
||||
text_sensor:
|
||||
- platform: custom
|
||||
|
||||
42
README.md
42
README.md
@@ -1,8 +1,8 @@
|
||||
# ESPHome AUX air conditioner custom component (aux_ac) #
|
||||
# Компонент для ESPHome. Управляет кондиционерами на базе AUX по wifi. #
|
||||
По тексту ниже используется сокращение `aux_ac`.
|
||||
По тексту ниже для компонента используется сокращение `aux_ac`.
|
||||
|
||||
Readme in english [is here](https://github.com/GrKoR/esphome_aux_ac_component/blob/master/README-EN.md).
|
||||
Readme in english [is here](https://github.com/GrKoR/esphome_aux_ac_component/blob/master/README-EN.md#esphome-aux-air-conditioner-custom-component-aux_ac).
|
||||
|
||||
Обсудить проект можно [в чате Телеграм](https://t.me/aux_ac).
|
||||
|
||||
@@ -11,27 +11,32 @@ Readme in english [is here](https://github.com/GrKoR/esphome_aux_ac_component/bl
|
||||
|
||||
## ДИСКЛЭЙМЕР ##
|
||||
1. Все материалы этого проекта (программы, прошивки, схемы, 3D модели и т.п.) предоставляются "КАК ЕСТЬ". Всё, что вы делаете с вашим оборудованием, вы делаете на свой страх и риск. Автор не несет ответственности за результат и ничего не гарантирует. Если вы с абсолютной четкостью не понимаете, что именно вы делаете и для чего, лучше просто купите wifi-модуль у производителя вашего кондиционера.
|
||||
2. Я ~~не настоящий сварщик~~ не программер. Поэтому код наверняка не оптимален и плохо оформлен (зато комментариев по коду я разместил от души), местами может быть написан небезопасно. И хоть я и старался протестировать всё, но уверен, что какие-то моменты упустил и код на 100% не протестирован. Так что отнеситесь к нему с подозрением, ожидайте от него подвоха и если что-то увидели - [пишите в багрепорт](https://github.com/GrKoR/esphome_aux_ac_component/issues).
|
||||
2. Я ~~не настоящий сварщик~~ не программер. Поэтому код наверняка не оптимален и плохо оформлен (зато комментариев по коду я разместил от души), местами может быть написан небезопасно. И хоть я и старался протестировать всё, но уверен, что какие-то моменты упустил. Так что отнеситесь к коду с подозрением, ожидайте от него подвоха и если что-то увидели - [пишите в багрепорт](https://github.com/GrKoR/esphome_aux_ac_component/issues).
|
||||
|
||||
## Общее описание ##
|
||||
Этот кастомный компонент для ESPHome позволяет управлять по wifi сделанным на фабриках AUX кондиционером.
|
||||
Этот кастомный компонент для ESPHome позволяет управлять по wifi кондиционером, сделанным на фабриках AUX.
|
||||
|
||||
Прошивка тестировалась с ESPHome 1.15.3 и сплит-системой Rovex серии ALS1. Скорее всего многие другие кондиционеры разных брендов, так же произведенные на фабриках AUX, могут управляться `aux_ac` без переделок. Но это не точно :)
|
||||
|
||||
По понятным причинам протестирован ограниченный перечень кондиционеров. Полный перечень протестированных кондиционеров приведен в списке ниже.
|
||||
|
||||
|
||||
## Поддерживаемые кондиционеры ##
|
||||
|
||||
### Список совместимых (протестированных) кондиционеров ###
|
||||
Приведенные ниже в списке кондиционеры были протестированы автором компонента или пользователями. И у нас все функции работали.
|
||||
Приведенные ниже в списке кондиционеры были протестированы автором `aux_ac` или пользователями. И у нас все функции работали.
|
||||
|
||||
Отсутствие вашего кондиционера в списке не говорит о том, что `aux_ac` с ним не работает. Но и присутствие названия в списке протестированных тоже не даёт никакой гарантии, так как тест проводится такими же пользователями компонента, как и вы.
|
||||
|
||||
Проведенное автором или пользователми тестирование может не включать какие-то функции по причине их отсутствия в кондиционере тестировщика. Но как минимум присутствие вашего кондиционера в списке протестированных позволяет говорить, что у кого-то из пользователей компонента своим кондиционером этого бренда управлять получилось. Так что с должной осмотрительностью можно пробовать запускать у себя.
|
||||
|
||||
Протестированы:
|
||||
+ Rovex (models: ALS1)
|
||||
|
||||
|
||||
### Список потенциально совместимых кондиционеров ###
|
||||
**НЕ ТЕСТИРОВАЛИСЬ! ИСПОЛЬЗУЙТЕ КОМПОНЕНТ НА СВОЙ СТРАХ И РИСК!**
|
||||
AUX - это один из нескольких OEM-производителей кондиционеров. Они производят кондиционеры как под собственным брендом, так и для внешних заказчиков. Поэтому есть шанс, что произведенный на их фабрике кондиционер неизвестного бренда с `aux_ac` так же заработает.
|
||||
AUX - это один из нескольких OEM-производителей кондиционеров. AUX производят кондиционеры как под собственным брендом, так и для внешних заказчиков. Поэтому есть шанс, что произведенный на их фабрике кондиционер неизвестного бренда с `aux_ac` так же заработает.
|
||||
В интернете есть такой перечень производившихся на фабриках AUX брендов:
|
||||
+ AUX
|
||||
+ Abion
|
||||
@@ -62,7 +67,9 @@ AUX - это один из нескольких OEM-производителей
|
||||
+ Supra
|
||||
+ Vertex
|
||||
+ Zanussi
|
||||
|
||||
|
||||
Если производитель вашего кондиционера есть в списке выше, то стоит изучить вопрос. Возможно, вам тоже подойдет `aux_ac` для управления по wifi.
|
||||
|
||||
Если в инструкции пользователя вашего кондиционера что-то написано про возможность управления по wifi (особенно с помощью мобильного приложения ACFreedom), то есть весьма существенные шансы, что `aux_ac` сможет управлять и вашим кондиционером. Но будьте осмотрительны: ваш кондиционер никем не тестировался и важно четко понимать, что вы делаете. Иначе можете поломать кондиционер.
|
||||
Если вы не уверены в своих силах, лучше дождитесь, пока другие более опытные пользователи протестируют вашу модель кондиционера (правда, это может не случиться никогда). Или приходите с вопросами [в телеграм-чат](https://t.me/aux_ac). Возможно, там вам помогут.
|
||||
|
||||
@@ -75,15 +82,15 @@ AUX - это один из нескольких OEM-производителей
|
||||
|
||||
|
||||
|
||||
В жизни так же минималистично:
|
||||
Для прошивки esp8266 в первый раз нужно в дополнение к обвязке, показанной на схеме выше, притянуть к Земле пин IO0 (GPIO0). После этого ESPHome может быть загружена в esp8266 по UART0. Если при этом вы указали OTA в конфигурации ESPHome, то вдальнейшем пин IO0 можно подтянуть к питанию или оставить висеть в воздухе. Он никак не будет влиять на загрузку новых прошивок, потому что все апдейты можно будет делать "по воздуху" (то есть по wifi). Я никуда IO0 не подтягивал и ничего к нему не паял, потому что не вижу смысла это делать ради одного раза. Первую прошивку делал в самодельном переходнике на макетке.
|
||||
|
||||
Плата esp-12e перед подключением подключением кондиционера и модуля питания:
|
||||
|
||||
|
||||
|
||||
В точном соответствии с даташитом, для прошивки esp8266 в первый раз нужно пин IO0 (GPIO0) притянуть к Земле. После этого ESPHome может быть загружена в esp8266 по UART0. Если при этом вы указали OTA в конфигурации ESPHome, то вдальнейшем пин IO0 можно подтянуть к питанию или оставить висеть в воздухе. Он никак не будет влиять на загрузку новых прошивок, потому что все апдейты можно будет делать "по воздуху" (то есть по wifi). Я никуда IO0 не подтягивал и ничего к нему не паял, потому что не вижу смысла это делать ради одного раза. Первую прошивку делал в самодельном переходнике на макетке.
|
||||
|
||||
|
||||
Внутренний блок сплит-системы имеет 5-проводное подключение к модулю wifi. Коннектор [JST SM](https://www.jst-mfg.com/product/pdf/eng/eSM.pdf).
|
||||
|
||||
Перечен проводников:
|
||||
Перечень проводников:
|
||||
1. Желтый: +14В постоянного тока. Осциллограф показал от +13.70В до +14.70В. В сервисном мануале встречалось, что питание возможно до +16В.
|
||||
2. Черный: земля.
|
||||
3. Белый: +5В постоянного тока (измерено от +4.43В до +5.63В). Для чего нужна эта линия - не понятно. У меня нет версий. Эксперименты с родным wifi-модулем сплит-системы показали, что эта линия в работе wifi не участвует. Линия идет напрямую на ножку контроллера в сплите через резистор 1 кОм.
|
||||
@@ -96,7 +103,7 @@ AUX - это один из нескольких OEM-производителей
|
||||
|
||||
Подключение:
|
||||
Черный провод (земля) подключается к земле DC-DC преобразователя и к пину GND модуля ESP8266.
|
||||
Желтый провод подключается ко входу DC-DC преобразователя (в моём случа контакт Vin).
|
||||
Желтый провод подключается ко входу DC-DC преобразователя (в моём случае контакт Vin).
|
||||
Синий провод подключается к пину RXD модуля esp-12e.
|
||||
Красный провод подключается к пину TXD модуля esp-12e.
|
||||
|
||||
@@ -108,7 +115,7 @@ AUX - это один из нескольких OEM-производителей
|
||||
|
||||
.
|
||||
|
||||
Все относящиеся к проекту модели для 3В-принтера также доступны: [STL-файлы коннектора](https://github.com/GrKoR/esphome_aux_ac_component/tree/master/enclosure/JST%20SM%20connector), [модельки частей корпуса](https://github.com/GrKoR/esphome_aux_ac_component/tree/master/enclosure/case).
|
||||
Все относящиеся к проекту модели для 3D-принтера также доступны: [STL-файлы коннектора](https://github.com/GrKoR/esphome_aux_ac_component/tree/master/enclosure/JST%20SM%20connector), [модельки частей корпуса](https://github.com/GrKoR/esphome_aux_ac_component/tree/master/enclosure/case).
|
||||
|
||||
Конечный результат:
|
||||
|
||||
@@ -142,7 +149,7 @@ uart:
|
||||
parity: EVEN
|
||||
stop_bits: 1
|
||||
```
|
||||
4. У ESP8266 два аппаратных UART: UART0 и UART1. Нам подходит только UART0, поскольку только он имеет и TX и RX. Поэтому в секции **uart:** выше мы настроили UART0 для нужд `aux_ac`. Но на том же УАРТе сидит и **logger:**. Чтобы не было коллизий, настраиваем логгер на работу с UART1, у которого есть только TX, но для нужд лолггера этого достаточно:
|
||||
4. У ESP8266 два аппаратных UART: UART0 и UART1. Нам подходит только UART0, поскольку только он имеет и TX и RX. Поэтому в секции **uart:** выше мы настроили UART0 для нужд `aux_ac`. Но на том же УАРТе сидит и **logger**. Чтобы не было коллизий, настраиваем логгер на работу с UART1, у которого есть только TX, чего для нужд логгера более чем достаточно:
|
||||
```yaml
|
||||
logger:
|
||||
level: DEBUG
|
||||
@@ -164,8 +171,11 @@ climate:
|
||||
|
||||
## Пример использования ##
|
||||
Файлы `ac_common.yaml`, `ac_kitchen.yaml` и `ac_livingroom.yaml` иллюстрируют стандартный способ использования компонента `aux_ac`. Причем для случая, когда у нас в доме два кондиционера, управляемых `aux_ac`: один расположен в кухне, второй - в гостиной.
|
||||
|
||||
`ac_common.yaml` содержит общую для двух кондиционеров часть конфигурации.
|
||||
|
||||
`ac_kitchen.yaml` и `ac_livingroom.yaml` содержат уникальные для каждого кондиционера настройки: IP-адреса, названия устройств и т.п.
|
||||
|
||||
Если попытаться компилировать файл `ac_common.yaml`, то ESPHome выдаст ошибку. Для корректной прошивки необходимо компилировать `ac_kitchen.yaml` или `ac_livingroom.yaml`.
|
||||
|
||||
## Дополнительная функциональность ##
|
||||
@@ -189,7 +199,9 @@ sensor:
|
||||
|
||||
### Уличная температура ###
|
||||
К сожалению, пока этот сенсор показывает погоду на Марсе =) Значение, обрабатываемое `aux_ac` для нужд этого сенсора точно как-то связано с уличной температурой, но полностью расшифровка значения не известна. Есть предположение, что это температура испарителя во внешнем блоке, потому что при переключении кондиционера с обогрева на охлаждение или обратно эта температура стремительно меняется. А при выключенном кондиционере в течение суток меняется похожим на уличную температуру образом. Однако всё это при теплой погоде на улице. При отрицательной температуре показывает одно и то же значение. По крайней мере при температурах в диапазоне -25..-19 градусов Цельсия.
|
||||
|
||||
В общем, для расшифровки надо собрать больше статистики и коллективно подумать в чатике.
|
||||
|
||||
Если несмотря на сказанное вам нужно это значение в ESPHome, пропишите следующий сенсор в конфигурации:
|
||||
```yaml
|
||||
sensor:
|
||||
|
||||
Reference in New Issue
Block a user