# 📡 Crumbforest Microcontroller-Netz – WLAN-Zugang für Krümeleinheiten

**🗓️ Datum:** 2025-05-31
**🫠 Crew:** Branko, Grootixer Foo, Eule, Robot

---

## 🌿 Ziel

Krümeleinheiten (z. B. Kinder mit TTYD-Terminal) sollen über den Browser und WLAN-basierte Kommunikation auf **ESP32-Controller** oder ähnliche Microcontroller zugreifen können, die sich im **gleichen WLAN** befinden ("crumbforest.net").

---

## ✅ Technische Voraussetzungen

| Komponente           | Anforderung                                                                   |
| -------------------- | ----------------------------------------------------------------------------- |
| 🌐 Netzwerk          | Gemeinsames WLAN (`crumbforest.net` oder `CF-Net`) mit IP-Adressierung        |
| 📶 ESP32             | Konfiguriert als **DHCP-Client** im Crumbforest-Netzwerk                      |
| 🌍 ESP32-Interface   | HTTP/Webserver oder TCP-Port offen (z. B. `/status`, `/led`, MQTT, Websocket) |
| 🔧 Crumbforest Build | `ttyd`-Shell mit `curl`, `ping`, `mosquitto_sub`, `netcat`, evtl. `telnet`    |
| 🔒 Sicherheit        | Nur definierte Ports (z. B. 1883 für MQTT, 80/443 für HTTP) werden genutzt    |

---

## 🧠 KRM-Modell & pädagogischer Bezug

| Dimension                                 | Umsetzung                                                                                       |
| ----------------------------------------- | ----------------------------------------------------------------------------------------------- |
| **Krümel** (Neugier, Spiel)               | Der Microcontroller wird als „Magisches Wesen“ im Wald vorgestellt (z. B. ein Baum, der blinkt) |
| **Resonanz** (Reaktion, Feedback)         | Der ESP32 antwortet auf Ping, Web-Abfragen oder MQTT-Nachrichten                                |
| **Menschlichkeit** (Verbindung, Fürsorge) | Krümel übernehmen Verantwortung für das „Lichtwesen“ oder den „Sensorbaum“                      |

---

## 🚀 Beispiel-Kommandos im Terminal (ttyd)

```bash
ping 192.168.42.20
curl http://192.168.42.20/status
mosquitto_pub -h 192.168.42.20 -t 'wald/baum1/led' -m 'on'
```

Diese Kommandos können durch die Eule erklärt und von Fridolin oder Balu in Missionen eingebaut werden.

---

## 📢 Integration in Build & System

### ToDo für Build-Erweiterung

* [ ] WLAN-Subnetz für crumbforest.net konfigurieren (`192.168.42.0/24`)
* [ ] ESP32-Doku für Lehrer\:innen und Eltern (WLAN & Portfreigaben)
* [ ] Ports (80, 1883, 5000) in der internen Firewall des Docker-Hosts freigeben
* [ ] Terminal-Mission "🧹 Der Sensorbaum erwacht" mit Kindern testen
* [ ] `MicrocontrollerController.php` (CakePHP) zur Steuerung als API vorbereiten

---

## ✨ Abschlussgedanke

> "Ein Baum, der antwortet, wenn du flüsterst – das ist kein Wunder, das ist Resonanz."

Wuuuuhuuu 🌱 – und weiter mit Licht & Bit im Wald.