diff --git a/README.md b/README.md index 1ec883d..765b75d 100644 --- a/README.md +++ b/README.md @@ -1,83 +1,89 @@ -Übersetzt mit ChatGPT. Ich habe es Erfolgreich mit einer TCL TAC-12CHDA eingebunden. -Wiring is as follows: +# 🌀 TCL Air Conditioner Integration for Home Assistant +> 🇩🇪 Übersetzt mit ChatGPT – erfolgreich getestet mit **TCL TAC-12CHDA** +> Einfaches DIY-Projekt mit ESP32 + USB-Kabel. Keine Cloud nötig. +## 🛠️ Was du brauchst +- **ESP32** (z. B. ESP32-C3, WROOM32, NodeMCU) +- **USB-A Stecker oder Kabel** + 👉 Ich habe diese verwendet: [AliExpress Link](https://www.aliexpress.com/item/1005005776162012.html) +- **Home Assistant mit ESPHome (ab Version 2023.3.0)** +--- +## 🔌 Verkabelung +| USB-A Pin | Kabelfarbe | → ESP32 Pin | +|-----------|------------|--------------| +| GND | Schwarz | VIN | +| D+ | Grün | GND | +| D- | Grau | RXD | +| VBUS | Rot | TXD | +### 🔍 Beispielbilder +![Wiring Example 1](https://github.com/user-attachments/assets/9b674e06-41ca-4bcf-b09b-691a5fbd8545) +![Wiring Example 2](https://github.com/user-attachments/assets/e30fadd9-19cd-47ec-baab-86f8a80410f6) -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 +## 🧠 Einrichtung in Home Assistant -USB-A plug or cable (I used these: AliExpress Link) +> Die Lösung basiert auf **ESPHome** und funktioniert nur mit Home Assistant. -Basic soldering tools (unless your unit already has a USB/serial port) +### 1. ESPHome installieren -🔌 Wiring Guide -USB-A Pin Wire Color Connect To (ESP32) -GND Black VIN -D+ Green GND -D- Grey RXD -VBUS Red TXD -📸 Example Photos +- In Home Assistant unter **Einstellungen → Add-ons → ESPHome** installieren -![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) +### 2. Neues Gerät erstellen +- Im ESPHome Dashboard → "New Device" +- Deinen ESP32-Typ auswählen, z. B. `esp32-c3-devkitm-1` oder `nodemcu-32s` -🧠 Software Setup (Using Home Assistant + ESPHome) -This solution only works with Home Assistant + ESPHome (version 2023.3.0 or later). +### 3. Konfiguration einfügen -Step-by-Step: -Install ESPHome in Home Assistant -Go to Settings → Add-ons → ESPHome → Install +#### Option A: Einfache Konfiguration +[📄 Sample_conf.yaml](https://github.com/sorz2122/tclac/blob/master/Sample_conf.yaml) -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). +#### Option B: Erweiterte Konfiguration +[📄 TCL-Conditioner.yaml](https://github.com/sorz2122/tclac/blob/master/TCL-Conditioner.yaml) -Paste the YAML configuration +📝 **Wichtig:** +- WLAN-Daten, Gerätename etc. anpassen +- Kommentare im YAML helfen beim Einrichten -Use the simplified config from this file: -Sample_conf.yaml +### 4. Auf ESP32 flashen -Or use the more detailed config: -TCL-Conditioner.yaml +- USB-Kabel anschließen oder OTA (Over-the-Air) verwenden -Adjust all fields as needed (Wi-Fi, device name, etc.) +--- -Flash the ESP32 -Use USB or OTA to flash your ESP32 with the configuration. +## ✅ Kompatible Klimaanlagen -✅ Supported AC Models (Confirmed Working) -This component supports various TCL and compatible models like: +Diese Modelle wurden erfolgreich getestet: -Axioma ASX09H1/ASB09H1 +- **TCL** TAC-07CHSA / TAC-09CHSA / TAC-12CHSA +- **Daichi** AIR20AVQ1, AIR25AVQS1R-1, DA35EVQ1-1 +- **Axioma** ASX09H1 / ASB09H1 +- **Dantex** RK-12SATI / RK-12SATIE +- ...und ähnliche Modelle -Daichi AIR20AVQ1/AIR20FV1 +⚠️ **Hinweis:** +Auch wenn die Modellbezeichnung passt, kann es Unterschiede geben (kein USB-Anschluss, kein UART auf der Platine, etc.) -Daichi AIR25AVQS1R-1/AIR25FVS1R-1 +--- -Daichi AIR35AVQS1R-1/AIR35FVS1R-1 +## 🔧 Erweiterte Konfiguration per Remote Package -Daichi DA35EVQ1-1/DF35EV1-1 +Du kannst die Konfiguration modular laden: -Dantex RK-12SATI/RK-12SATIE - -TCL TAC-07CHSA/TPG-W - -TCL TAC-09CHSA/TPG - -TCL TAC-09CHSA/DSEI-W - -TCL TAC-12CHSA/TPG - -TCL TAC-12CHDA/ - -ℹ️ Note: Even units with the same model name can differ in hardware. Some may lack USB or UART ports. +```yaml +packages: + remote_package: + url: https://github.com/I-am-nightingale/tclac.git + ref: master + files: + - packages/core.yaml # Hauptmodul + # - packages/leds.yaml # Optional + refresh: 30s