Update README.md

This commit is contained in:
sorz2122
2025-04-09 20:39:41 +02:00
committed by GitHub
parent 68f1231903
commit 4e11414c81

174
README.md
View File

@@ -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 gibts 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 gibts 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 gibts 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 gibts 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!