Skip to content

Commit 2ae5261

Browse files
authored
Update README_DE.md
1 parent 90a9bf8 commit 2ae5261

File tree

1 file changed

+72
-54
lines changed

1 file changed

+72
-54
lines changed

README_DE.md

Lines changed: 72 additions & 54 deletions
Original file line numberDiff line numberDiff line change
@@ -1,122 +1,140 @@
1-
21
<p align="center">
32
<img src="https://reset42.de/reset42.svg" alt="reset42 Logo" width="180"/>
43
</p>
54

6-
# reset42 Gartensensor
5+
# reset42 Gardensensor
76

8-
**Plug & Play WLAN-Gartensensor für Maker, Bastler & Automatisierermit Raspberry Pi Pico W, BME280, VEML7700 und MQTT.**
7+
**Plug & Play WLAN-Gartensensor für Maker, Bastler und Automatisierungs-Fansbasierend auf Raspberry Pi Pico W, BME280, VEML7700 und MQTT.**
98
**Läuft mit MicroPython – lokal, modular, ohne Cloud.**
109

1110
---
1211

1312
## 🌱 Funktionen
1413

15-
- 📶 **WiFi-fähig** – inkl. Fallback-WLAN und statischer IP (optional)
16-
- 🌡️ Echtzeitdaten: Temperatur, Luftfeuchte, Luftdruck, Helligkeit (Lux)
17-
- 🔄 **Asynchrone Runtime** via `uasyncio`
18-
- 📡 **MQTT-Support** für Logging, Smart Home & Automatisierung
19-
- 💡 **Status-LED** zur Fehleranzeige
20-
- 🛠️ Vollständig modular, quelloffen & leicht erweiterbar (MIT-Lizenz)
14+
- 📶 **WLAN-fähig** – inkl. Fallback-Netzwerk und optionaler statischer IP
15+
- 🌡️ Live-Daten: Temperatur, Luftfeuchtigkeit, Luftdruck, Licht (Lux)
16+
- 🧪 **Test- & Demo-Modus:** Sensordaten und MQTT-Publishing über `config.py` simulieren (ideal für Entwicklung & Tests)
17+
- 🧩 **Flexibles MQTT-Format:** Felder & Reihenfolge konfigurierbar
18+
- 📡 **MQTT-Unterstützung** für Logging, Smart Home & Automatisierung
19+
- 💡 **Status-LED** für Fehlermeldungen
20+
- 🛠️ Vollständig modular, quelloffen & einfach erweiterbar (MIT-Lizenz)
2121

2222
---
2323

2424
## 🔧 Hardware
2525

26-
- [x] **Raspberry Pi Pico W** (MicroPython-fähig)
27-
- [x] **BME280** (I2C – Temperatur, Feuchtigkeit, Luftdruck)
28-
- [x] **VEML7700** (I2C – Lichtstärke in Lux)
29-
- [ ] **Status-LED** (ansteuerbar, optional)
30-
- [ ] **weitere I2C-Sensoren optional integrierbar**
26+
- [x] **Raspberry Pi Pico W** (MicroPython-kompatibel)
27+
- [x] **BME280** (I2C – Temperatur, Luftfeuchte, Luftdruck)
28+
- [x] **VEML7700** (I2C – Lichtintensität in Lux)
29+
- [ ] **Status-LED** (steuerbar, optional)
30+
- [ ] **Optional** zusätzliche I2C-Sensoren
3131

3232
---
3333

3434
## ⚙️ Installation
3535

3636
1. **MicroPython flashen**
37-
Lade das passende `.uf2`-Image für den Pico W von
37+
Passendes `.uf2`-Image für den Pico W herunterladen von:
3838
👉 [micropython.org/download/rp2-pico-w](https://micropython.org/download/rp2-pico-w)
3939

40-
2. **Dateien übertragen**
41-
- Kopiere den Inhalt von `src/lib/` in das Hauptverzeichnis des Pico W
40+
2. **Dateien hochladen**
41+
- Alles aus `src/lib/` ins Hauptverzeichnis des Pico W kopieren
4242
(z. B. mit Thonny, `rshell`, `ampy` oder WebREPL)
43-
- Kopiere `main.py` ebenfalls ins Hauptverzeichnis
43+
- Zusätzlich `main.py` ins Hauptverzeichnis kopieren
4444

4545
3. **`config.py` anpassen**
4646
- WLAN-Daten, MQTT-Broker, Sensor-Pins etc.
47+
- Sensor-Modi konfigurieren ("active", "dummy", "inactive") sowie MQTT-Felder
4748

48-
4. **Los geht's!**
49+
4. **Los gehts!**
4950
- Reboot → `main.py` startet automatisch
5051
- Status-LED blinkt bei Fehlern (siehe Troubleshooting)
5152

5253
---
5354

5455
## 🧾 Beispiel `config.py`
5556

56-
Siehe [src/lib/config.py](src/lib/config.py) im Repo für Details:
57+
Details siehe [src/lib/config.py](src/lib/config.py) im Repository:
5758

5859
```python
59-
SSID = "MeinWLAN"
60-
PASSWORD = "supergeheim"
61-
STATIC_IP = "" # leer = DHCP
60+
SSID = "MyWiFi"
61+
PASSWORD = "supersecret"
62+
STATIC_IP = "" # leer lassen für DHCP
6263

6364
MQTT_BROKER = "192.168.1.50"
6465
MQTT_PORT = 1883
6566
MQTT_CLIENT_ID = "sensor_indoor"
6667

67-
VEML_SDA = 0
68-
VEML_SCL = 1
69-
BME_SDA = 2
70-
BME_SCL = 3
71-
ONBOARD_LED = "LED"
68+
# Sensor- & MQTT-Modi
69+
VEML_MODE = "dummy" # "active", "dummy", "inactive"
70+
BME_MODE = "inactive" # "active", "dummy", "inactive"
71+
MQTT_MODE = "active" # "active", "dummy", "inactive"
72+
73+
# MQTT Payload-Felder
74+
MQTT_PAYLOAD_FIELDS = [
75+
"date",
76+
"time",
77+
"temp",
78+
"pressure",
79+
"humidity",
80+
"lux",
81+
]
7282
```
7383

7484
---
7585

76-
## 📌 Standard-Pinout
86+
## 📌 Standard-Pinbelegung
7787

78-
| Komponente | SDA | SCL |
79-
|--------------|-----|-----|
80-
| VEML7700 | GP0 | GP1 |
81-
| BME280 | GP2 | GP3 |
88+
| Komponente | SDA | SCL | VCC (Power) |
89+
|-------------|-----|-----|-------------|
90+
| VEML7700 | GP0 | GP1 | GP15 |
91+
| BME280 | GP2 | GP3 | GP14 |
8292

83-
| Funktion | Pin |
84-
|------------------|------------|
85-
| Onboard-LED | "LED" |
86-
| VEML Reset GPIO | GP15 |
93+
| Funktion | Pin |
94+
|-------------------|------------|
95+
| Onboard-LED | "LED" |
96+
| VEML Reset GPIO | GP15 |
8797

8898
---
8999

90-
## 🧠 Architektur (Kurzfassung)
100+
## 🧠 Architekturübersicht
91101

92-
- `main.py`: Zentrale Ablaufsteuerung (WLAN, MQTT, Sensoren, LED)
102+
- `main.py`: Hauptsteuerung (WLAN, MQTT, Sensoren, LED)
93103
- `lib/`:
94-
- `wifi.py`: Verbindet mit primärem oder Fallback-WLAN
95-
- `mqtt.py`: Verbindet zum Broker, sendet JSON-Daten
96-
- `sensors.py`: Liest BME280 + VEML7700, kann Reset auslösen
97-
- `leds.py`: Ansteuerung der Onboard-LED für Statusanzeigen
98-
- `config.py`: Konfiguration
99-
- `state.py`: Zustandscodes (z. B. `SUCCESS`, `FATAL_ERROR`)
104+
- `wifi.py`: Verbindung zu primärem oder Fallback-WLAN
105+
- `mqtt.py`: Verbindet mit Broker, sendet JSON, Dummy-Modus
106+
- `sensors.py`: Liest BME280 & VEML7700 (real oder simuliert)
107+
- `leds.py`: LED-Ansteuerung für Statussignale
108+
- `config.py`: Zentrale Konfiguration (WLAN, MQTT, Sensoren, Payload)
109+
- `state.py`: Rückgabecodes (SUCCESS, FATAL_ERROR, …)
110+
111+
---
112+
113+
## 🚨 Fehlersignale (LED)
114+
115+
| Problem | LED-Blinkmuster | Bedeutung |
116+
|-----------------|---------------------|----------------------------|
117+
| WLAN-Fehler | 1× langsam | Keine Verbindung möglich |
118+
| MQTT-Fehler | 2× mittel | Broker nicht erreichbar |
119+
| Sensor-Fehler | 3× schnell | Sensor antwortet nicht |
100120

101121
---
102122

103-
## 🚨 Fehlersuche
123+
## 🖼️ Gehäuse, STL & Zusammenbau
104124

105-
| Fehler | LED blinkt | Beschreibung |
106-
|--------|------------|--------------|
107-
| WiFi-Fehler | 1× langsam | Keine Verbindung zu WLAN |
108-
| MQTT-Fehler | 2× mittel | Broker nicht erreichbar |
109-
| Sensorfehler | 3× schnell | Sensorantwort fehlerhaft |
125+
- **STL-Dateien und Anleitung folgen in Kürze!**
126+
- Das Projekt richtet sich an Maker – gerne Ideen via Issue oder PR beisteuern.
110127

111128
---
112129

113130
## 🔒 Lizenz
114131

115-
reset42 Gardensensor ist Open Source und unter der **MIT-Lizenz** veröffentlicht.
116-
Nutzung für private & kommerzielle Projekte erlaubt – siehe `LICENSE`.
132+
reset42 Gardensensor ist Open Source und steht unter der **MIT-Lizenz**.
133+
Private & kommerzielle Nutzung erlaubt – siehe `LICENSE`.
117134

118135
---
119136

120-
**Projektstatus:** aktiv gepflegt – weitere Sensoren, Web-Oberfläche & Sleep-Modus geplant.
137+
**Projektstatus:** aktiv gepflegt – weitere Sensoren, Webinterface & Sleep-Modus geplant.
138+
**STL-Dateien und Montageanleitung folgen bald.**
121139

122140
Fragen, Ideen oder Feedback? → [reset42.de](https://reset42.de)

0 commit comments

Comments
 (0)