Update README.md
This commit is contained in:
174
README.md
174
README.md
@@ -1,111 +1,141 @@
|
|||||||
Внешний компонент кондиционеров TCL и аналогов для Home Assistant, используя ESPHome.
|
Übersetzt mit ChatGPT. Ich habe es Erfolgreich mit einer TCL TAC-12CHDA eingebunden.
|
||||||
Поддерживаются кондиционеры типа TAC-07CHSA и подобные. Увы, предположить точно получится подключить кондиционер или нет практически
|
|
||||||
невозможно из-за огромного разбега в комплектациях: даже одна и та же модель, буквально буква-в-букву может, например, не иметь
|
|
||||||
родного модуля WiFI, не иметь провода с USB разъемом или вовсе на плате управления может не быть впаян разъем UART.
|
|
||||||
Однако, в целом, с пайкой или без, проверены следующие кондиционеры:
|
|
||||||
- Axioma ASX09H1/ASB09H1
|
|
||||||
- Daichi AIR20AVQ1/AIR20FV1
|
|
||||||
- Daichi AIR25AVQS1R-1/AIR25FVS1R-1
|
|
||||||
- Daichi AIR35AVQS1R-1/AIR35FVS1R-1
|
|
||||||
- Daichi DA35EVQ1-1/DF35EV1-1
|
|
||||||
- Dantex RK-12SATI/RK-12SATIE
|
|
||||||
- TCL TAC-07CHSA/TPG-W
|
|
||||||
- TCL TAC-09CHSA/TPG
|
|
||||||
- TCL TAC-09CHSA/DSEI-W
|
|
||||||
- TCL TAC-12CHSA/TPG
|
|
||||||
|
|
||||||
Компоненту требуется HomeAsistant и ESPHome версии не ниже 2023.3.0 !
|
Externe Komponente für Klimaanlagen von TCL und ähnlichen Modellen für Home Assistant unter Verwendung von ESPHome.
|
||||||
____
|
Unterstützt werden Klimaanlagen vom Typ TAC-07CHSA und ähnliche. Leider ist es nahezu unmöglich, im Voraus genau zu sagen, ob eine bestimmte Klimaanlage kompatibel ist, da es enorme Unterschiede in der Ausstattung gibt: Selbst exakt gleiche Modellbezeichnungen können z.B. kein integriertes WLAN-Modul haben, kein Kabel mit USB-Anschluss besitzen oder auf der Steuerplatine gar keinen eingelöteten UART-Anschluss aufweisen.
|
||||||
Это все для работы ИСКЛЮЧИТЕЛЬНО с HomeAsistant и ESPHome. Если Вас интересует другие варианты или возможность подключить кондиционер
|
Trotzdem – mit oder ohne Löten – wurden folgende Klimaanlagen erfolgreich getestet:
|
||||||
как-то иначе к каким-то другим системам, то мне есть что предложить:
|
|
||||||
[Вариант для подключения через MQTT](https://github.com/pavel211/TCL-TAC-07-WiFi)
|
|
||||||
____
|
|
||||||
Статья по проекту находится [в моем канале на Дзене](https://dzen.ru/a/ZmdoyUNswXWnulhg)
|
|
||||||
|
|
||||||
Все работает, даже стабильно. Какие глюки видел- устранил, какие желания были- реализовал. Конечно, не все, хотелось бы еще спорткар..
|
Axioma ASX09H1/ASB09H1
|
||||||
Используя компонент прямо сейчас Вы уже не рискуете душевным здоровьем, но внезапные глюки вполне могут напасть. Если вдруг такое
|
|
||||||
случиться именно с Вами- прошу сообщить мне на Дзене, приму меры.
|
|
||||||
Подробное описание будет постепенно появляться [в моем канале на Дзене](https://dzen.ru/a/ZmdoyUNswXWnulhg) , сюда буду выкладывать
|
|
||||||
самое важное по мере сил.
|
|
||||||
____
|
|
||||||
Образец для конфигурации ESPHome в файле TCL-Conditioner.yaml , упрощенный вариант конфигурации- Sample_conf.yaml . Скачайте к себе
|
|
||||||
и используйте в ESPHome, или просто скопируйте из него всю конфигурацию и вставьте вместо своей, однако, не забыв отредактировать
|
|
||||||
все поля. В файле есть подсказки по каждому полю.
|
|
||||||
|
|
||||||
Вопрос может возникнуть с 2 моментами: платформа (чип или модуль) и подгружаемые файлы. Попробую объяснить.
|
Daichi AIR20AVQ1/AIR20FV1
|
||||||
|
|
||||||
## Настройка платформы
|
Daichi AIR25AVQS1R-1/AIR25FVS1R-1
|
||||||
Платформа настраивается точно так же, как ей и полагается настраиваться в ESPHome. Например, так выглядит кусок кода для ESP-01S:
|
|
||||||
```yaml
|
Daichi AIR35AVQS1R-1/AIR35FVS1R-1
|
||||||
|
|
||||||
|
Daichi DA35EVQ1-1/DF35EV1-1
|
||||||
|
|
||||||
|
Dantex RK-12SATI/RK-12SATIE
|
||||||
|
|
||||||
|
TCL TAC-07CHSA/TPG-W
|
||||||
|
|
||||||
|
TCL TAC-09CHSA/TPG
|
||||||
|
|
||||||
|
TCL TAC-09CHSA/DSEI-W
|
||||||
|
|
||||||
|
TCL TAC-12CHSA/TPG
|
||||||
|
|
||||||
|
Die Komponente erfordert Home Assistant und ESPHome in der Version mindestens 2023.3.0!
|
||||||
|
|
||||||
|
Diese Lösung funktioniert AUSSCHLIESSLICH mit Home Assistant und ESPHome. Falls du an anderen Varianten oder Systemen interessiert bist, habe ich auch dazu etwas:
|
||||||
|
Alternative MQTT-Anbindung
|
||||||
|
|
||||||
|
Einen Artikel zum Projekt findest du auf meinem Kanal bei Dzen
|
||||||
|
|
||||||
|
Das Ganze funktioniert – sogar stabil. Bugs, die ich gefunden habe, sind behoben, Wünsche, die geäußert wurden, größtenteils umgesetzt. Natürlich nicht alle – ein Sportwagen fehlt leider noch...
|
||||||
|
Wenn du diese Komponente nutzt, riskierst du keine geistige Gesundheit mehr, aber spontane Glitches könnten trotzdem passieren. Wenn dir so etwas passiert – bitte melde dich bei mir auf Dzen, ich kümmere mich drum.
|
||||||
|
Eine ausführlichere Beschreibung wird nach und nach auf meinem Dzen-Kanal veröffentlicht – die wichtigsten Infos stelle ich auch hier ein.
|
||||||
|
|
||||||
|
Ein Beispiel für die ESPHome-Konfiguration findest du in der Datei TCL-Conditioner.yaml, eine vereinfachte Version in Sample_conf.yaml. Lade sie dir herunter und nutze sie in ESPHome – oder kopiere den Inhalt und ersetze deine Konfiguration damit. Aber denk dran, alle Felder anzupassen! In der Datei findest du Hinweise zu jedem Feld.
|
||||||
|
|
||||||
|
Es können zwei Fragen auftauchen: Plattform (also Chip/Modul) und eingebundene Dateien. Ich erkläre beide kurz.
|
||||||
|
|
||||||
|
Plattform-Konfiguration
|
||||||
|
Die Plattform wird genau so konfiguriert, wie es in ESPHome üblich ist. Hier ein Beispiel für den ESP-01S:
|
||||||
|
|
||||||
|
yaml
|
||||||
|
Kopieren
|
||||||
|
Bearbeiten
|
||||||
esp8266:
|
esp8266:
|
||||||
board: esp01_1m
|
board: esp01_1m
|
||||||
```
|
Und so sieht es für das Hommyn-Modul HDN/WFN-02-01 aus dem ersten Artikel aus:
|
||||||
А вот так выглядит кусок кода для модуля Hommyn HDN/WFN-02-01 из первой статьи про кондиционер:
|
|
||||||
```yaml
|
yaml
|
||||||
|
Kopieren
|
||||||
|
Bearbeiten
|
||||||
esp32:
|
esp32:
|
||||||
board: esp32-c3-devkitm-1
|
board: esp32-c3-devkitm-1
|
||||||
framework:
|
framework:
|
||||||
type: arduino
|
type: arduino
|
||||||
```
|
Die Plattform kann auch über den Haupt-Config-Block eingebunden werden. Ein Beispiel von einem Alpha-Tester für ESP32 WROOM32:
|
||||||
Можно подключать платформу и через основной конфиг. Вот, предложенный [испытателем альфа-версии](https://github.com/kai-zer-ru), пример для Esp32 WROOM32:
|
|
||||||
```yaml
|
yaml
|
||||||
|
Kopieren
|
||||||
|
Bearbeiten
|
||||||
esphome:
|
esphome:
|
||||||
platform: ESP32
|
platform: ESP32
|
||||||
board: nodemcu-32s
|
board: nodemcu-32s
|
||||||
```
|
Und hier ein Beispiel für den Wemos D1 Mini (ESP12F):
|
||||||
А это уже пример для wemos D1 Mini nodemcu esp12f:
|
|
||||||
```yaml
|
yaml
|
||||||
|
Kopieren
|
||||||
|
Bearbeiten
|
||||||
esphome:
|
esphome:
|
||||||
platform: ESP8266
|
platform: ESP8266
|
||||||
board: esp12e
|
board: esp12e
|
||||||
```
|
Im Grunde ist alles wie gewohnt – die passende Plattform findest du leicht online.
|
||||||
В общем- все то же самое, как и обычно, вариант под свою платформу легко ищется в интернете.
|
|
||||||
|
|
||||||
**!Важно не забыть закомментировать или удалить строки других платформ!**
|
Wichtig: Entferne oder kommentiere die Zeilen für andere Plattformen aus, sonst gibt’s Probleme!
|
||||||
|
|
||||||
## Настройка подгружаемых файлов
|
Einbindung externer Dateien
|
||||||
Для добавления или удаления определенных частей конфига я решил использовать подгружаемые файлы- они загружаются ESPHome автоматически,
|
Zum Hinzufügen oder Entfernen bestimmter Teile der Konfiguration habe ich mich für eingebundene Dateien entschieden – ESPHome lädt sie automatisch herunter, wenn der Home Assistant-Server mit dem Internet verbunden ist.
|
||||||
если у сервера с Home Assistant есть доступ в интернет. Такой подход позволяет редактировать и обновлять не весь конфиг куском,
|
Das hat den Vorteil, dass nicht immer die komplette Konfig bearbeitet werden muss – nur einzelne Teile können ausgetauscht werden, ohne funktionierende Abschnitte zu stören.
|
||||||
а частями, не трогая то, что работает.
|
Ein weiterer Vorteil: Kein lästiges Kommentieren oder Entkommentieren von ellenlangen Codeblöcken, keine YAML-Formatierungsschmerzen, keine Sorgen wegen Leerzeichen etc. Einfach Links zu Dateien einfügen oder entfernen.
|
||||||
Еще один плюс- не нужно километровые куски кода комментировать или раскомментировать, не нужно знать разметку, нет необходимости считать
|
So sieht der Block für eingebundene Dateien aus:
|
||||||
проклятые пробелы и прочее. Все делается добавлением или удалением ссылок на файлы. Итак, вот так выглядит блок подгружаемых файлов:
|
|
||||||
```yaml
|
yaml
|
||||||
|
Kopieren
|
||||||
|
Bearbeiten
|
||||||
packages:
|
packages:
|
||||||
remote_package:
|
remote_package:
|
||||||
url: https://github.com/I-am-nightingale/tclac.git
|
url: https://github.com/I-am-nightingale/tclac.git
|
||||||
ref: master
|
ref: master
|
||||||
files:
|
files:
|
||||||
# v - равнение строк с опциями вот по этой позиции, иначе глючить будет
|
# v – Zeilen müssen exakt hier ausgerichtet sein, sonst gibt’s Fehler!
|
||||||
- packages/core.yaml # Ядро всего сущего
|
- packages/core.yaml # Das Herzstück
|
||||||
# - packages/leds.yaml
|
# - packages/leds.yaml
|
||||||
refresh: 30s
|
refresh: 30s
|
||||||
```
|
Alle eingebundenen Dateien stehen unter dem Abschnitt files:. Für den Betrieb ist mindestens die folgende Datei notwendig:
|
||||||
Все подгружаемые файлы указываются в секции **files:**. Для работы необходимо, чтобы был хотя-бы
|
|
||||||
```yaml
|
yaml
|
||||||
- packages/core.yaml # Ядро всего сущего
|
Kopieren
|
||||||
```
|
Bearbeiten
|
||||||
Все остальные модули по желанию (их описание в том же файле чуть выше). **Важно**, чтобы все строки с файлами были выровнены по
|
- packages/core.yaml # Das Herzstück
|
||||||
импровизированной метке, которую я специально указал, иначе у ESPHome возникнет много вопросов к Вам. Например, **должно быть так:**
|
Alle weiteren Module sind optional (deren Beschreibung findest du im selben Verzeichnis).
|
||||||
```yaml
|
Wichtig: Alle Dateizeilen müssen an der gleichen Position wie die Markierung ausgerichtet sein – sonst stellt ESPHome viele unangenehme Fragen.
|
||||||
|
So ist es korrekt:
|
||||||
|
|
||||||
|
yaml
|
||||||
|
Kopieren
|
||||||
|
Bearbeiten
|
||||||
packages:
|
packages:
|
||||||
remote_package:
|
remote_package:
|
||||||
url: https://github.com/I-am-nightingale/tclac.git
|
url: https://github.com/I-am-nightingale/tclac.git
|
||||||
ref: master
|
ref: master
|
||||||
files:
|
files:
|
||||||
# v - равнение строк с опциями вот по этой позиции, иначе глючить будет
|
# v – Zeilen müssen exakt hier ausgerichtet sein, sonst gibt’s Fehler!
|
||||||
- packages/core.yaml # Ядро всего сущего
|
- packages/core.yaml # Das Herzstück
|
||||||
- packages/leds.yaml
|
- packages/leds.yaml
|
||||||
refresh: 30s
|
refresh: 30s
|
||||||
```
|
So ist es falsch:
|
||||||
А вот так уже **не правильно:**
|
|
||||||
```yaml
|
yaml
|
||||||
|
Kopieren
|
||||||
|
Bearbeiten
|
||||||
packages:
|
packages:
|
||||||
remote_package:
|
remote_package:
|
||||||
url: https://github.com/I-am-nightingale/tclac.git
|
url: https://github.com/I-am-nightingale/tclac.git
|
||||||
ref: master
|
ref: master
|
||||||
files:
|
files:
|
||||||
# v - равнение строк с опциями вот по этой позиции, иначе глючить будет
|
# v – Zeilen müssen exakt hier ausgerichtet sein, sonst gibt’s Fehler!
|
||||||
- packages/core.yaml # Ядро всего сущего
|
- packages/core.yaml # Das Herzstück
|
||||||
- packages/leds.yaml
|
- packages/leds.yaml
|
||||||
refresh: 30s
|
refresh: 30s
|
||||||
```
|
Wenn du willst, kann ich auch gleich die README.md im Repo für dich anlegen oder übersetzen. Sag einfach Bescheid!
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user