Update README.md
This commit is contained in:
sorz2122
GitHub
167
README.md
167
README.md
@@ -3,17 +3,60 @@ Wiring is as follows:
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
TCL Air Conditioner Integration with Home Assistant (Tested on TAC-12CHDA)
|
||||
Translated with ChatGPT – successfully tested on a TCL TAC-12CHDA unit.
|
||||
Wiring guide and setup instructions below.
|
||||
|
||||
🛠 What You’ll Need
|
||||
ESP32 microcontroller
|
||||
|
||||
USB-A plug or cable (I used these: AliExpress Link)
|
||||
|
||||
Basic soldering tools (unless your unit already has a USB/serial port)
|
||||
|
||||
🔌 Wiring Guide
|
||||
USB-A Pin Wire Color Connect To (ESP32)
|
||||
GND Black VIN
|
||||
D+ Green GND
|
||||
D- Grey RXD
|
||||
VBUS Red TXD
|
||||
📸 Example Photos
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
🧠 Software Setup (Using Home Assistant + ESPHome)
|
||||
This solution only works with Home Assistant + ESPHome (version 2023.3.0 or later).
|
||||
|
||||
Step-by-Step:
|
||||
Install ESPHome in Home Assistant
|
||||
Go to Settings → Add-ons → ESPHome → Install
|
||||
|
||||
Create a new device
|
||||
Use the ESPHome dashboard to add a new device and choose your ESP32 board type (e.g., esp32-c3-devkitm-1 or nodemcu-32s).
|
||||
|
||||
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.
|
||||
Trotzdem – mit oder ohne Löten – wurden folgende Klimaanlagen erfolgreich getestet:
|
||||
Paste the YAML configuration
|
||||
|
||||
Use the simplified config from this file:
|
||||
Sample_conf.yaml
|
||||
|
||||
Or use the more detailed config:
|
||||
TCL-Conditioner.yaml
|
||||
|
||||
Adjust all fields as needed (Wi-Fi, device name, etc.)
|
||||
|
||||
Flash the ESP32
|
||||
Use USB or OTA to flash your ESP32 with the configuration.
|
||||
|
||||
✅ Supported AC Models (Confirmed Working)
|
||||
This component supports various TCL and compatible models like:
|
||||
|
||||
Axioma ASX09H1/ASB09H1
|
||||
|
||||
@@ -35,118 +78,6 @@ 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:
|
||||
board: esp01_1m
|
||||
Und so sieht es für das Hommyn-Modul HDN/WFN-02-01 aus dem ersten Artikel aus:
|
||||
|
||||
yaml
|
||||
Kopieren
|
||||
Bearbeiten
|
||||
esp32:
|
||||
board: esp32-c3-devkitm-1
|
||||
framework:
|
||||
type: arduino
|
||||
Die Plattform kann auch über den Haupt-Config-Block eingebunden werden. Ein Beispiel von einem Alpha-Tester für ESP32 WROOM32:
|
||||
|
||||
yaml
|
||||
Kopieren
|
||||
Bearbeiten
|
||||
esphome:
|
||||
platform: ESP32
|
||||
board: nodemcu-32s
|
||||
Und hier ein Beispiel für den Wemos D1 Mini (ESP12F):
|
||||
|
||||
yaml
|
||||
Kopieren
|
||||
Bearbeiten
|
||||
esphome:
|
||||
platform: ESP8266
|
||||
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
|
||||
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.
|
||||
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
|
||||
Kopieren
|
||||
Bearbeiten
|
||||
packages:
|
||||
remote_package:
|
||||
url: https://github.com/I-am-nightingale/tclac.git
|
||||
ref: master
|
||||
files:
|
||||
# v – Zeilen müssen exakt hier ausgerichtet sein, sonst gibt’s Fehler!
|
||||
- packages/core.yaml # Das Herzstück
|
||||
# - packages/leds.yaml
|
||||
refresh: 30s
|
||||
Alle eingebundenen Dateien stehen unter dem Abschnitt files:. Für den Betrieb ist mindestens die folgende Datei notwendig:
|
||||
|
||||
yaml
|
||||
Kopieren
|
||||
Bearbeiten
|
||||
- packages/core.yaml # Das Herzstück
|
||||
Alle weiteren Module sind optional (deren Beschreibung findest du im selben Verzeichnis).
|
||||
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:
|
||||
remote_package:
|
||||
url: https://github.com/I-am-nightingale/tclac.git
|
||||
ref: master
|
||||
files:
|
||||
# v – Zeilen müssen exakt hier ausgerichtet sein, sonst gibt’s Fehler!
|
||||
- packages/core.yaml # Das Herzstück
|
||||
- packages/leds.yaml
|
||||
refresh: 30s
|
||||
So ist es falsch:
|
||||
|
||||
yaml
|
||||
Kopieren
|
||||
Bearbeiten
|
||||
packages:
|
||||
remote_package:
|
||||
url: https://github.com/I-am-nightingale/tclac.git
|
||||
ref: master
|
||||
files:
|
||||
# v – Zeilen müssen exakt hier ausgerichtet sein, sonst gibt’s Fehler!
|
||||
- packages/core.yaml # Das Herzstück
|
||||
- packages/leds.yaml
|
||||
refresh: 30s
|
||||
Wenn du willst, kann ich auch gleich die README.md im Repo für dich anlegen oder übersetzen. Sag einfach Bescheid!
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
TCL TAC-12CHDA/
|
||||
|
||||
ℹ️ Note: Even units with the same model name can differ in hardware. Some may lack USB or UART ports.
|
||||
|
||||
Reference in New Issue
Block a user