mirror of
https://github.com/GrKoR/esphome_aux_ac_component.git
synced 2026-02-01 07:30:33 +03:00
examples are described
This commit is contained in:
GrKoR
95
README-EN.md
95
README-EN.md
@@ -10,21 +10,21 @@ For issues or feature requests, please go to [the issue section](https://github.
|
||||
3. [Russian](https://github.com/GrKoR/esphome_aux_ac_component#readme) and English readmes are substantially identical in meaning. But in case of differences the Russian version is more significant.
|
||||
|
||||
## Short description ##
|
||||
This custom component allows you to control your air conditioner through wifi if it is made in the AUX factory.
|
||||
This custom component allows you to control your air conditioner through wifi if it is made in the AUX factory.<br />
|
||||
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 ##
|
||||
|
||||
### List of compatible ACs (tested) ###
|
||||
These ACs were tested by the author or by users.
|
||||
+ Rovex (models: ALS1)
|
||||
|
||||
|
||||
|
||||
|
||||
### List of potential compatible ACs ###
|
||||
**NOT TESTED! TRY AT YOUR OWN RISK!**
|
||||
**NOT TESTED! TRY AT YOUR OWN RISK!**<br />
|
||||
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:
|
||||
|
||||
Internet says that following air conditioners may work with `aux_ac` component:
|
||||
+ AUX
|
||||
+ Abion
|
||||
+ AC ELECTRIC
|
||||
@@ -55,26 +55,23 @@ Internet says that following air conditioners may test with `aux_ac` component:
|
||||
+ Vertex
|
||||
+ Zanussi
|
||||
|
||||
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 your AC is listed above you you should take a closer look at `aux_ac`.<br />
|
||||
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.<br />
|
||||
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.
|
||||
The best way to report about your test results is write a message [in the issue section](https://github.com/GrKoR/esphome_aux_ac_component/issues). Direct message in the telegram is possible too but probably I can miss your message among many others.
|
||||
The best way to report about your test results is write a message [in the issue section](https://github.com/GrKoR/esphome_aux_ac_component/issues). Direct message in the [telegram](https://t.me/aux_ac) is possible too but probably I can miss your message among many others.
|
||||
|
||||
|
||||
## How to use it ##
|
||||
### Hardware ###
|
||||
I tested it with an esp8266 chip (esp-12e). Minimal scheme:
|
||||
|
||||
I tested it with an esp8266 chip (esp-12e). Minimal scheme:<br />
|
||||
|
||||
|
||||
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.
|
||||
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.<br />
|
||||
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:
|
||||
|
||||
ESP-12E before DC-DC and air conditioner connected:<br />
|
||||
|
||||
|
||||
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).
|
||||
@@ -86,41 +83,33 @@ Wires:
|
||||
4. Blue: TX of air conditioner. High is +5V.
|
||||
5. Red: RX of air conditioner. High is +5V.
|
||||
|
||||
For power supply it is possible to use any kind of suitable modules. I use this:
|
||||
|
||||
For power supply it is possible to use any kind of suitable modules. I use this:<br />
|
||||
.
|
||||
|
||||
Black wire of AC's connector goes to the middle pin of the power module and to the GND pin of esp-12e.
|
||||
Yellow wire is connected to the Vin pin of the power module.
|
||||
Blue wire is connected to the RXD pin of esp-12e.
|
||||
Red wire is connected to the TXD pin of esp-12e.
|
||||
|
||||
Here is it:
|
||||
Black wire of AC's connector goes to the middle pin of the power module and to the GND pin of esp-12e.<br />
|
||||
Yellow wire is connected to the Vin pin of the power module.<br />
|
||||
Blue wire is connected to the RXD pin of esp-12e.<br />
|
||||
Red wire is connected to the TXD pin of esp-12e.<br />
|
||||
|
||||
Here is it:<br />
|
||||
|
||||
|
||||
All connections in custom 3d-printed case looks like this:
|
||||
|
||||
All connections in custom 3d-printed case looks like this:<br />
|
||||
|
||||
|
||||
Cause I haven't JST SM connector I made own:
|
||||
|
||||
Cause I haven't JST SM connector I made own:<br />
|
||||
.
|
||||
|
||||
It is made of standard 2.54mm pins and 3D-printed case.
|
||||
|
||||
It is made of standard 2.54mm pins and 3D-printed case.<br />
|
||||
All models for 3D-printing are available too: [STL-files for connector](https://github.com/GrKoR/esphome_aux_ac_component/tree/master/enclosure/JST%20SM%20connector), [models of case parts](https://github.com/GrKoR/esphome_aux_ac_component/tree/master/enclosure/case).
|
||||
|
||||
The result:
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Here is the result:<br />
|
||||
<br />
|
||||
<br />
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
### Firmware: Integration aux_ac to your configuration ###
|
||||
1. Copy aux_ac_custom_component.h to folder with your ESPHome YAML file.
|
||||
2. At the header of your YAML add include instruction like this:
|
||||
@@ -143,12 +132,14 @@ 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 or switch it off:
|
||||
```yaml
|
||||
logger:
|
||||
level: DEBUG
|
||||
# important: for avoiding collisions logger works with UART1 (for esp8266 tx = GPIO2, rx = None)
|
||||
hardware_uart: UART1
|
||||
baud_rate: 0
|
||||
# set hardware_uart to UART1 and comment out baud_rate above in case of boot crashes
|
||||
# it is suitable if you need hardware loggin
|
||||
# hardware_uart: UART1
|
||||
```
|
||||
5. Finally define climate component:
|
||||
```yaml
|
||||
@@ -162,13 +153,21 @@ climate:
|
||||
climates:
|
||||
- name: "My awesome air conditioner"
|
||||
```
|
||||
|
||||
## Example ##
|
||||
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.
|
||||
## Simple example ##
|
||||
The source code of this example is located in the [aux_ac_simple.yaml](https://github.com/GrKoR/esphome_aux_ac_component/blob/master/examples/simple/aux_ac_simple.yaml) file.
|
||||
|
||||
`ac_kitchen.yaml` and `ac_livingroom.yaml` contain specific parts of configuration: IP-addresses, device names etc.
|
||||
All settings in it is trivial. Just copy file to your local folder, specify your wifi settings and compile YAML with ESPHome.
|
||||
|
||||
|
||||
## Advanced example ##
|
||||
All sources are located [in advanced example folder](https://github.com/GrKoR/esphome_aux_ac_component/tree/master/examples/advanced).
|
||||
|
||||
This time we'll configure two relative identical air conditioners with `aux_ac` custom component.<br />
|
||||
Let's imagine we have ACs in a kitchen and in a living room. All ACs are the same brand and can be controlled by `aux_ac`.<br />
|
||||
Cause we are lazy we'll define all common configuration parts for two air conditioners in one `ac_common.yaml` file.<br />
|
||||
All specific parts of configuration are located in the `ac_kitchen.yaml` and `ac_livingroom.yaml`. Here we set `devicename` and `upper_devicename` for correct sensors and component naming. And here we specify the correct IP-address of the device from `secrets.yaml`.<br />
|
||||
**Don't forget** to specify `wifi_ip_kitchen`, `wifi_ota_ip_kitchen`, `wifi_ip_livingroom` and `wifi_ota_ip_livingroom` in the `secrets.yaml` along with the other sensitive information, such as passwords, tokens 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.
|
||||
|
||||
@@ -192,7 +191,7 @@ sensor:
|
||||
```
|
||||
|
||||
### Outdoor temperature ###
|
||||
Currently it shows weather on Mars =) Maybe it will change if we get more statistics and some smart guys for decoding.
|
||||
Currently it shows weather on Mars =) Maybe it will change if we get more statistics and some smart guys for decoding.<br />
|
||||
If in spite of everything, you still want it in your configuration, just use this code:
|
||||
```yaml
|
||||
sensor:
|
||||
@@ -239,4 +238,4 @@ text_sensor:
|
||||
text_sensors:
|
||||
name: AC firmware version
|
||||
icon: "mdi:chip"
|
||||
```
|
||||
```
|
||||
117
README.md
117
README.md
@@ -1,34 +1,28 @@
|
||||
# Компонент для ESPHome. #
|
||||
# Кастомный компонент для ESPHome для управления кондиционером по wifi #
|
||||
Readme in english [is here](README-EN.md#esphome-aux-air-conditioner-custom-component-aux_ac).
|
||||
|
||||
Управляет кондиционерами на базе AUX по wifi.<br />
|
||||
По тексту ниже для компонента используется сокращение `aux_ac`.
|
||||
|
||||
|
||||
Обсудить проект можно [в чате Телеграм](https://t.me/aux_ac).
|
||||
|
||||
Обсудить проект можно [в чате Телеграм](https://t.me/aux_ac).<br />
|
||||
Отзывы о багах и ошибках, а так же запросы на дополнительный функционал оставляйте [в соответствующем разделе](https://github.com/GrKoR/esphome_aux_ac_component/issues).
|
||||
|
||||
|
||||
## ДИСКЛЭЙМЕР ##
|
||||
|
||||
|
||||
## ДИСКЛЭЙМЕР (ОТМАЗКИ) ##
|
||||
1. Все материалы этого проекта (программы, прошивки, схемы, 3D модели и т.п.) предоставляются "КАК ЕСТЬ". Всё, что вы делаете с вашим оборудованием, вы делаете на свой страх и риск. Автор не несет ответственности за результат и ничего не гарантирует. Если вы с абсолютной четкостью не понимаете, что именно вы делаете и для чего, лучше просто купите wifi-модуль у производителя вашего кондиционера.
|
||||
2. Я ~~не настоящий сварщик~~ не программер. Поэтому код наверняка не оптимален и плохо оформлен (зато комментариев по коду я разместил от души), местами может быть написан небезопасно. И хоть я и старался протестировать всё, но уверен, что какие-то моменты упустил. Так что отнеситесь к коду с подозрением, ожидайте от него подвоха и если что-то увидели - [пишите в багрепорт](https://github.com/GrKoR/esphome_aux_ac_component/issues).
|
||||
|
||||
|
||||
|
||||
## Общее описание ##
|
||||
Этот кастомный компонент для ESPHome позволяет управлять по wifi кондиционером, сделанным на фабриках AUX.
|
||||
|
||||
Прошивка тестировалась с ESPHome 1.15.3 и сплит-системой Rovex серии ALS1. Скорее всего многие другие кондиционеры разных брендов, так же произведенные на фабриках AUX, могут управляться `aux_ac` без переделок. Но это не точно :)
|
||||
|
||||
Этот кастомный компонент для ESPHome позволяет управлять по wifi кондиционером, сделанным на фабриках AUX.<br />
|
||||
Прошивка тестировалась с ESPHome 1.15.3 и сплит-системой Rovex серии ALS1. Скорее всего многие другие кондиционеры разных брендов, так же произведенные на фабриках AUX, могут управляться `aux_ac` без переделок. Но это не точно :)<br />
|
||||
По понятным причинам протестирован ограниченный перечень кондиционеров. Полный перечень протестированных кондиционеров приведен в списке ниже.
|
||||
|
||||
|
||||
## Поддерживаемые кондиционеры ##
|
||||
|
||||
|
||||
|
||||
## Поддерживаемые кондиционеры ##
|
||||
### Список совместимых (протестированных) кондиционеров ###
|
||||
Приведенные ниже в списке кондиционеры были протестированы автором `aux_ac` или пользователями. И у нас все функции работали.
|
||||
|
||||
Отсутствие вашего кондиционера в списке не говорит о том, что `aux_ac` с ним не работает. Но и присутствие названия в списке протестированных тоже не даёт никакой гарантии, так как тест проводится такими же пользователями компонента, как и вы.
|
||||
|
||||
Приведенные ниже в списке кондиционеры были протестированы автором `aux_ac` или пользователями. И у нас все функции работали.<br />
|
||||
Отсутствие вашего кондиционера в списке не говорит о том, что `aux_ac` с ним не работает. Но и присутствие названия в списке протестированных тоже не даёт никакой гарантии, так как тест проводится такими же пользователями компонента, как и вы.<br />
|
||||
Проведенное автором или пользователями тестирование может не включать какие-то функции по причине их отсутствия в кондиционере тестировщика. Но как минимум присутствие вашего кондиционера в списке протестированных позволяет говорить, что у кого-то из пользователей компонента своим кондиционером этого бренда управлять получилось. Так что с должной осмотрительностью можно пробовать запускать у себя.
|
||||
|
||||
Протестированы:
|
||||
@@ -36,8 +30,9 @@ Readme in english [is here](README-EN.md#esphome-aux-air-conditioner-custom-comp
|
||||
|
||||
|
||||
### Список потенциально совместимых кондиционеров ###
|
||||
**НЕ ТЕСТИРОВАЛИСЬ! ИСПОЛЬЗУЙТЕ КОМПОНЕНТ НА СВОЙ СТРАХ И РИСК!**
|
||||
**НЕ ТЕСТИРОВАЛИСЬ! ИСПОЛЬЗУЙТЕ КОМПОНЕНТ НА СВОЙ СТРАХ И РИСК!**<br />
|
||||
AUX - это один из нескольких OEM-производителей кондиционеров. AUX производят кондиционеры как под собственным брендом, так и для внешних заказчиков. Поэтому есть шанс, что произведенный на их фабрике кондиционер неизвестного бренда с `aux_ac` так же заработает.
|
||||
|
||||
В интернете есть такой перечень производившихся на фабриках AUX брендов:
|
||||
+ AUX
|
||||
+ Abion
|
||||
@@ -69,24 +64,21 @@ AUX - это один из нескольких OEM-производителей
|
||||
+ Vertex
|
||||
+ Zanussi
|
||||
|
||||
Если производитель вашего кондиционера есть в списке выше, то стоит изучить вопрос. Возможно, вам тоже подойдет `aux_ac` для управления по wifi.
|
||||
|
||||
Если в инструкции пользователя вашего кондиционера что-то написано про возможность управления по wifi (особенно с помощью мобильного приложения ACFreedom), то есть весьма существенные шансы, что `aux_ac` сможет управлять и вашим кондиционером. Но будьте осмотрительны: ваш кондиционер никем не тестировался и важно четко понимать, что вы делаете. Иначе можете поломать кондиционер.
|
||||
Если производитель вашего кондиционера есть в списке выше, то стоит изучить вопрос. Возможно, вам тоже подойдет `aux_ac` для управления по wifi.<br />
|
||||
Если в инструкции пользователя вашего кондиционера что-то написано про возможность управления по wifi (особенно с помощью мобильного приложения ACFreedom), то есть весьма существенные шансы, что `aux_ac` сможет управлять и вашим кондиционером. Но будьте осмотрительны: ваш кондиционер никем не тестировался и важно четко понимать, что вы делаете. Иначе можете поломать кондиционер.<br />
|
||||
Если вы не уверены в своих силах, лучше дождитесь, пока другие более опытные пользователи протестируют вашу модель кондиционера (правда, это может не случиться никогда). Или приходите с вопросами [в телеграм-чат](https://t.me/aux_ac). Возможно, там вам помогут.
|
||||
|
||||
Если вы протестировали ваш кондиционер и он работает, напишите мне, пожалуйста. Я внесу вашу модель в список протестированных. Возможно, это упростит кому-то жизнь =)
|
||||
Лучший способ сообщить о протестированном кондиционере - написать [в разделе багрепортов и заказа фич](https://github.com/GrKoR/esphome_aux_ac_component/issues). В телеграм тоже можно, но есть шанс, что в ворохе сообщений ваше потеряется.
|
||||
|
||||
Если вы протестировали ваш кондиционер и он работает, напишите мне, пожалуйста. Я внесу вашу модель в список протестированных. Возможно, это упростит кому-то жизнь =)<br />
|
||||
Лучший способ сообщить о протестированном кондиционере - написать [в разделе багрепортов и заказа фич](https://github.com/GrKoR/esphome_aux_ac_component/issues). [В телеграм](https://t.me/aux_ac) тоже можно, но есть шанс, что в ворохе сообщений ваше потеряется.
|
||||
|
||||
## Как использовать компонент ##
|
||||
### Железо ###
|
||||
Я тестировал проект на esp8266 (esp-12e). Минимальная обвязка традиционная и выглядит так:
|
||||
|
||||
Я тестировал проект на esp8266 (esp-12e). Минимальная обвязка традиционная и выглядит так:<br />
|
||||
|
||||
|
||||
|
||||
Для прошивки esp8266 в первый раз нужно в дополнение к обвязке, показанной на схеме выше, притянуть к Земле пин IO0 (GPIO0). После этого ESPHome может быть загружена в esp8266 по UART0. Если при этом вы указали OTA в конфигурации ESPHome, то в дальнейшем пин IO0 можно подтянуть к питанию или оставить висеть в воздухе. Он никак не будет влиять на загрузку новых прошивок, потому что все апдейты можно будет делать "по воздуху" (то есть по wifi). Я никуда IO0 не подтягивал и ничего к нему не паял, потому что не вижу смысла это делать ради одного раза. Первую прошивку делал в самодельном переходнике на макетке.
|
||||
|
||||
Плата esp-12e перед подключением кондиционера и модуля питания:
|
||||
|
||||
Плата esp-12e перед подключением кондиционера и модуля питания:<br />
|
||||
|
||||
|
||||
Внутренний блок сплит-системы имеет 5-проводное подключение к модулю wifi. Коннектор [JST SM](https://www.jst-mfg.com/product/pdf/eng/eSM.pdf).
|
||||
@@ -98,40 +90,33 @@ AUX - это один из нескольких OEM-производителей
|
||||
4. Синий: TX кондиционера. Высокий уровень +5В.
|
||||
5. Red: RX кондиционера. Высокий уровень +5В.
|
||||
|
||||
Для питания ESP8266 можно использовать любой подходящий DC-DC преобразователь. Я использовал такой:
|
||||
|
||||
Для питания ESP8266 можно использовать любой подходящий DC-DC преобразователь. Я использовал такой:<br />
|
||||
.
|
||||
|
||||
Подключение:
|
||||
Черный провод (земля) подключается к земле DC-DC преобразователя и к пину GND модуля ESP8266.
|
||||
Желтый провод подключается ко входу DC-DC преобразователя (в моём случае контакт Vin).
|
||||
Синий провод подключается к пину RXD модуля esp-12e.
|
||||
Красный провод подключается к пину TXD модуля esp-12e.
|
||||
|
||||
Вот схема всех соединений:
|
||||
Подключение:<br />
|
||||
Черный провод (земля) подключается к земле DC-DC преобразователя и к пину GND модуля ESP8266.<br />
|
||||
Желтый провод подключается ко входу DC-DC преобразователя (в моём случае контакт Vin).<br />
|
||||
Синий провод подключается к пину RXD модуля esp-12e.<br />
|
||||
Красный провод подключается к пину TXD модуля esp-12e.<br />
|
||||
|
||||
Вот схема всех соединений:<br />
|
||||
|
||||
|
||||
Вот так это выглядит внутри самодельного корпуса:
|
||||
|
||||
Вот так это выглядит внутри самодельного корпуса:<br />
|
||||
|
||||
|
||||
Поскольку у меня не было под рукой коннекторов JST SM, а ехать искать их не хотелось, я сделал свой собственный из стандартных пинов с шагом 2,54 мм и нескольких напечатанных на 3D-принтере деталей:
|
||||
|
||||
Поскольку у меня не было под рукой коннекторов JST SM, а ехать искать их не хотелось, я сделал свой собственный из стандартных пинов с шагом 2,54 мм и нескольких напечатанных на 3D-принтере деталей:<br />
|
||||
.
|
||||
|
||||
Все относящиеся к проекту модели для 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).
|
||||
|
||||
Конечный результат:
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Конечный результат:<br />
|
||||
<br />
|
||||
<br />
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
### Прошивка: интеграция aux_ac в вашу конфигурацию ESPHome ###
|
||||
1. Скопируйте файл `aux_ac_custom_component.h` в папку с вашими YAML-файлами ESPHome.
|
||||
2. В заголовочной части вашего YAML-файла пропишите инструкцию `include`. Например:
|
||||
@@ -173,19 +158,28 @@ climate:
|
||||
climates:
|
||||
- name: "My awesome air conditioner"
|
||||
```
|
||||
|
||||
## Пример использования ##
|
||||
Файлы `ac_common.yaml`, `ac_kitchen.yaml` и `ac_livingroom.yaml` иллюстрируют стандартный способ использования компонента `aux_ac`. Причем для случая, когда у нас в доме два кондиционера, управляемых `aux_ac`: один расположен в кухне, второй - в гостиной.
|
||||
|
||||
`ac_common.yaml` содержит общую для двух кондиционеров часть конфигурации.
|
||||
## Простейший пример ##
|
||||
Исходный код простейшего примера можно найти в файле [aux_ac_simple.yaml](https://github.com/GrKoR/esphome_aux_ac_component/blob/master/examples/simple/aux_ac_simple.yaml).
|
||||
|
||||
`ac_kitchen.yaml` и `ac_livingroom.yaml` содержат уникальные для каждого кондиционера настройки: IP-адреса, названия устройств и т.п.
|
||||
Все настройки в нем тривиальны и подробно описаны [в официальной документации на ESPHome](https://esphome.io/index.html) и дополнены [в разделе об интеграции компонента](https://github.com/GrKoR/esphome_aux_ac_component#%D0%BF%D1%80%D0%BE%D1%88%D0%B8%D0%B2%D0%BA%D0%B0-%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D1%8F-aux_ac-%D0%B2-%D0%B2%D0%B0%D1%88%D1%83-%D0%BA%D0%BE%D0%BD%D1%84%D0%B8%D0%B3%D1%83%D1%80%D0%B0%D1%86%D0%B8%D1%8E-esphome) в ваш девайс.<br />
|
||||
Просто скопируйте yaml-файл примера и `aux_ac_custom_component.h` в локальную папку у себя на компьютере, пропишите настройки вашей сети WiFi и откомпилируйте YAML с использованием ESPHome.
|
||||
|
||||
|
||||
## Продвинутый пример ##
|
||||
Все исходники продвинутого примера лежат [в соответствующей папке](https://github.com/GrKoR/esphome_aux_ac_component/tree/master/examples/advanced).
|
||||
|
||||
В это примере мы конфигурируем два относительно одинаковых кондиционера на работу с `aux_ac`.<br />
|
||||
Вводные: представим, что у нас есть два кондея, расположенных в кухне и в гостиной. Эти кондиционеры могут и не быть одного бренда. Главное, чтобы они были совместимы с `aux_ac`.<br />
|
||||
Поскольку мы ленивы, мы пропишем все общие настройки обоих кондиционеров в общем конфигурационном файле `ac_common.yaml`.<br />
|
||||
А все параметры, специфичные для каждого конкретного устройства, вынесем в отдельные файлы. Это файлы `ac_kitchen.yaml` и `ac_livingroom.yaml`. В них мы установим значения для подстановок `devicename` и `upper_devicename`, чтобы у устройств в сети были корректные имена самого компонента и его сенсоров. И здесь же мы указываем уникальные для каждого устройства IP-адреса, спрятанные в `secrets.yaml`.<br />
|
||||
Кстати да! **Не забудьте** присвоить корректные значения `wifi_ip_kitchen`, `wifi_ota_ip_kitchen`, `wifi_ip_livingroom` и `wifi_ota_ip_livingroom` в файле `secrets.yaml` наряду с остальной "секретной" информацией (например пароли, токены и т.п.). Файл `secrets.yaml` по понятным причинам на гитхаб не выложен.
|
||||
|
||||
Если попытаться компилировать файл `ac_common.yaml`, то ESPHome выдаст ошибку. Для корректной прошивки необходимо компилировать `ac_kitchen.yaml` или `ac_livingroom.yaml`.
|
||||
|
||||
## Дополнительная функциональность ##
|
||||
Компонент `aux_ac` предоставляет три дополнительных сенсора: два значения температуры и один номер версии прошивки.
|
||||
|
||||
|
||||
### Комнатная температура ###
|
||||
Этот сенсор отдает значения комнатной температуры воздуха с внутреннего блока кондиционера. Если значение этого датчика вам нужно, пропишите подобную конфигурацию сенсора в вашем YAML-файле:
|
||||
```yaml
|
||||
@@ -203,8 +197,7 @@ sensor:
|
||||
```
|
||||
|
||||
### Уличная температура ###
|
||||
К сожалению, пока этот сенсор показывает погоду на Марсе =) Значение, обрабатываемое `aux_ac` для нужд этого сенсора точно как-то связано с уличной температурой, но полностью расшифровка значения не известна. Есть предположение, что это температура испарителя во внешнем блоке, потому что при переключении кондиционера с обогрева на охлаждение или обратно эта температура стремительно меняется. А при выключенном кондиционере в течение суток меняется похожим на уличную температуру образом. Однако всё это при теплой погоде на улице. При отрицательной температуре показывает одно и то же значение. По крайней мере при температурах в диапазоне -25..-19 градусов Цельсия.
|
||||
|
||||
К сожалению, пока этот сенсор показывает погоду на Марсе =) Значение, обрабатываемое `aux_ac` для нужд этого сенсора точно как-то связано с уличной температурой, но полностью расшифровка значения не известна. Есть предположение, что это температура испарителя во внешнем блоке, потому что при переключении кондиционера с обогрева на охлаждение или обратно эта температура стремительно меняется. А при выключенном кондиционере в течение суток меняется похожим на уличную температуру образом. Однако всё это при теплой погоде на улице. При отрицательной температуре показывает одно и то же значение. По крайней мере при температурах в диапазоне -25..-19 градусов Цельсия.<br />
|
||||
В общем, для расшифровки надо собрать больше статистики и коллективно подумать в чатике.
|
||||
|
||||
Если несмотря на сказанное вам нужно это значение в ESPHome, пропишите следующий сенсор в конфигурации:
|
||||
|
||||
Reference in New Issue
Block a user