Update README.md

README.md

@@ -3,17 +3,60 @@ Wiring is as follows:
 
 
 
-![IMG_0778](https://github.com/user-attachments/assets/9b674e06-41ca-4bcf-b09b-691a5fbd8545)
 
+
+
+
+
+
+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
+
+![IMG_0778](https://github.com/user-attachments/assets/9b674e06-41ca-4bcf-b09b-691a5fbd8545)
 ![image](https://github.com/user-attachments/assets/e30fadd9-19cd-47ec-baab-86f8a80410f6)
 
 
+🧠 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.
+Paste the YAML configuration
-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:
+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!
+TCL TAC-12CHDA/
-
-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!
-
-
-
-
-
-
-
 
+ℹ️ Note: Even units with the same model name can differ in hardware. Some may lack USB or UART ports.