mirror of
https://github.com/GrKoR/esphome_aux_ac_component.git
synced 2026-01-06 08:38:58 +03:00
readme changes
This commit is contained in:
GrKoR
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