Update README.md

This commit is contained in:
sorz2122
2025-04-10 20:09:56 +02:00
committed by GitHub
parent 89401f8ba3
commit 84fd16bff5

112
README.md
View File

@@ -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 Youll 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