# 💡 ALDIlight – Umbau der CASALUX LED-Leuchte (ALDI SÜD) mit WLED
> entwickelt im **Chaos Computer Club Mannheim (C3MA)**  
> Hardware & Firmware-Integration: Souko "Shakaru" Hiabuto

---

## 🧩 Projektüberblick

**ALDIlight** ist ein Hack-Projekt aus dem C3MA.  
Ziel: Eine handelsübliche **CASALUX-LED-Leuchte** von **ALDI SÜD**  
([Produkt-ID 665090001](https://www.aldi-sued.de/de/p.000000000665090001.html))  
wird zu einer voll steuerbaren **RGBW-WLAN-Leuchte** aufgerüstet –  
mit **ESP32-C3**, **IR-Fernbedienung** und der Open-Source-Firmware [**WLED**](https://kno.wled.ge/).

---

## ⚙️ Hauptkomponenten

| Komponente | Beschreibung |
|-------------|--------------|
| 🧠 **ESP32-C3 SuperMini** | Wird **direkt auf die Platine gelötet**, läuft mit WLED |
| ⚡ **Custom-PCB (C3MA-Design)** | Ersatzplatine mit DC/DC-Wandler, IR-Receiver-Anschluss, 3-Pin-LED-Anschluss & I²S-Pads |
| 📡 **IR-Empfänger (3-Pin)** | Vom Original übernommen, um 180 ° gedreht eingelötet |
| 🔌 **3-Pin-Kabel** | Verbindung zur **integrierten LED-Tube / LED-Strip** im Lampengehäuse |
| 🧱 **3D-Distanzring (optional)** | Kompensiert zusätzliche Bauhöhe der neuen Platine |
| 🔩 **4 Gehäuseschrauben + 5 mm länger** | Notwendig, wenn der Distanzring eingesetzt wird |

---

## 🧰 Werkzeuge & Voraussetzungen

- Lötkolben mit feiner Spitze  
- Kreuzschlitzschraubendreher  
- Pinzette & Seitenschneider  
- 3D-Drucker (für Distanzring, optional)  
- USB-Kabel (für Flash-Vorgang)  
- Chromium-basierter Browser (Chrome, Edge, Brave …)  
- Grundkenntnisse in Elektronik und Firmware-Flashen  

---

## 🧠 Entwicklung

Die Platine wurde im **C3MA (Chaos Computer Club Mannheim)** entwickelt.  
Ziel war ein **drop-in Replacement** mit stabiler 5 V-Versorgung  
und nativer Unterstützung für **WLED + IR-Remote**.

💡 Die Platine ist zusätzlich bereits für **zwei I²S-Mikrofone** vorbereitet.  
Damit lässt sich die Leuchte künftig auch als **Sound-to-Light-System** nutzen –  
z. B. mit den WLED-Audio-Reaktiven Builds oder einer Custom-Firmware.

---

## 🔧 Umbauanleitung

### 1️⃣ Gehäuse öffnen
- Vier Schrauben auf der Unterseite entfernen.  
- Bodenplatte abnehmen, Platine freilegen.  
- Kabelverbindung zur LED-Tube (integrierter LED-Streifen im Diffusor) trennen.  

![Gehäuse geöffnet](Documentation/images/IMG_20251101_001308_786.jpg)

---

### 2️⃣ Alte Platine entfernen
- Originalplatine abschrauben und ausbauen.  
- IR-Empfänger (schwarze 3-Pin-LED) und Steckbuchse auslöten.

---

### 3️⃣ Neue Platine vorbereiten
- **ESP32-C3 SuperMini** **direkt auflöten** – kein Stecksockel!  
- **IR-Empfänger** einlöten – **abgeflachte Seite nach oben!**  
  (180 ° gedreht gegenüber dem Original)

![IR richtig eingelötet](Documentation/images/IMG_20251101_001326_267.jpg)

- **Buchse** wieder an die vorgesehene Stelle löten.  

---

### 4️⃣ Einbau in die Lampe

- Neue Platine mit Schrauben fixieren.  
- 3-Pin-Kabel zur **LED-Tube** wieder anschließen.  

Die neue Platine ist durch den **integrierten DC/DC-Wandler** deutlich höher als die Originalplatine.  
Dadurch lässt sich der Boden der Leuchte nicht mehr ohne Anpassung montieren.  
Es ist also **zwingend notwendig**, den Innenraum entsprechend anzupassen:

- **Option A:** Am Metallgewicht der Leuchte etwas Material ausfräsen, damit die Platine platz hat.  
- **Option B (empfohlen):** Den **Distanzring** aus dem Ordner [`CAD/`](../CAD/) drucken.  
  - Der Ring erhöht den Abstand zwischen Boden und oberen Gehäuse um ca. **5 mm**.  
  - Verwende dafür **5 mm längere Schrauben** als im Original.  

![Distanzring](Documentation/images/IMG_20251101_001113_380.jpg)


---

## 🔌 Firmware: WLED installieren

1. **ESP32-C3 per USB anschließen**  
2. Browser öffnen: 👉 [https://install.wled.me/](https://install.wled.me/)  
3. Im Webflasher **ESP32-C3** auswählen.  
4. Flashvorgang starten.  
5. Nach dem Flashen:  
   - WLAN „`WLED-AP`“ erscheint  
   - mit `http://4.3.2.1` verbinden  
   - eigenes WLAN konfigurieren  

---

## 🧠 WLED-Konfiguration

### LED-Output

| Einstellung | Wert |
|--------------|------|
| LED-Typ | **SK6812 / WS2814 RGBW** |
| Color-Order | **BRG** |
| Swap | **W & G** |
| Data GPIO | **10** |
| LED Count | **75** |
| Auto-Calc W | **Brighter** |

![LED Settings](Documentation/images/LED_Settings.png)

---

### IR-Remote & Relais

| Einstellung | Wert |
|--------------|------|
| IR GPIO | **9** |
| Relay GPIO | **20** |
| Invert | ✅ aktiviert |
| Open Drain | ☐ deaktiviert |
| JSON-File | `WLED/38-key_ir.json` importieren |

![IR Settings](Documentation/images/LED_Settings2.png)

---

## 📁 Remote-Profil (JSON)

Im Ordner `WLED/` liegt das fertige JSON-Profil für die mitgelieferte IR-Fernbedienung.  
Einfach in WLED hochladen – danach funktionieren alle Tasten (Farben, Helligkeit, Modi).

---

## ✅ Funktionstest

Wenn alles richtig verlötet und eingestellt ist:

- ✅ Lampe reagiert auf IR-Fernbedienung  
- 🌈 WLAN-Steuerung über WLED funktioniert  
- 💾 Konfiguration bleibt nach Neustart erhalten  
- ⚙️ Netzteil bleibt kühl, DC/DC-Wandler stabil  

---

## 📂 Projektstruktur

```text
.
├── CAD/                   → 3D-Modelle & Distanzring
│   ├── Spacer AldiLight.f3d
│   └── Spacer ALDIlight.stl
├── Documentation/          → Doku & Bilder
│   └── images/
├── PCB/                   → KiCad-Projektdateien
│   ├── ALDIent-Light.kicad_pcb
│   ├── ESP32-C3-SuperMini.pretty/
│   └── …
├── WLED/                  → JSON & Config-Dateien
│   ├── 38-key_ir.json
│   └── wled_cfg.json
└── README.md              → Dieses Dokument
````

---

## 🏷️ Projektinfos

| Feld                 | Info                                          |
| -------------------- | --------------------------------------------- |
| **Projektname:**     | ALDIlight                                     |
| **Basismodell:**     | CASALUX LED-Leuchte (ALDI SÜD – ID 665090001) |
| **Organisation:**    | Chaos Computer Club Mannheim (C3MA)           |
| **Firmware:**        | [WLED](https://kno.wled.ge/)                  |
| **Hardware-Design:** | C3MA                         |
| **Autor:**           | Souko „Shakaru“ Hiabuto                       |
| **Lizenz:**          | MIT                                           |

---

## ⚠️ Haftungsausschluss

Dieses Projekt wird in der C3MA-Tradition des „Hack it yourself“ geteilt.
Der Umbau erfolgt **auf eigene Verantwortung**.
Arbeiten an elektrischen Geräten sollten nur mit Fachkenntnis erfolgen.
Kein Support für gegrillte ESPs, verschmorte LEDs oder verbrannte Finger 😼

---

© 2025 C3MA