mirror of
https://github.com/skoelle/m5stack-dashboard.git
synced 2026-09-17 16:50:23 +00:00
78 lines
1.9 KiB
Markdown
78 lines
1.9 KiB
Markdown
# M5Stack Core Dashboard
|
|
|
|
Wetter-, Kalender- und MVG-Abfahrten-Dashboard für den M5Stack Core (ESP32),
|
|
gesteuert über die 3 eingebauten Buttons (A, B, C).
|
|
|
|
Details zu Funktionsumfang, API-Formaten und Design-Entscheidungen stehen in
|
|
`SPEC.md` im Space. Umsetzungsschritte stehen in `PLAN.md` und `TODO.md`.
|
|
|
|
## Setup
|
|
|
|
1. PlatformIO CLI installieren:
|
|
```
|
|
pip install -U platformio
|
|
```
|
|
|
|
2. WLAN-Zugangsdaten eintragen:
|
|
```
|
|
cp include/secrets.h.example include/secrets.h
|
|
```
|
|
Dann in `include/secrets.h` `WIFI_SSID` und `WIFI_PASSWORD` anpassen.
|
|
Die drei API-URLs sind bereits vorbefüllt.
|
|
|
|
3. Gerät per USB anschließen.
|
|
|
|
## Build & Flash
|
|
|
|
```
|
|
./scripts/deploy.sh
|
|
```
|
|
|
|
Falls mehrere serielle Geräte angeschlossen sind und die automatische
|
|
Port-Erkennung fehlschlägt, kann der Port explizit übergeben werden:
|
|
|
|
```
|
|
./scripts/deploy.sh /dev/ttyUSB0
|
|
```
|
|
|
|
Das Skript baut nur und flasht, es öffnet keinen seriellen Monitor.
|
|
|
|
Falls du den Monitor separat sehen willst:
|
|
|
|
```
|
|
pio device monitor
|
|
```
|
|
|
|
## Bedienung
|
|
|
|
| Button | Funktion |
|
|
|---|---|
|
|
| A | Wechselt zwischen Wetter-Detail und Kalender-Detail |
|
|
| B | Zurück zur Hauptseite |
|
|
| C | MVG-Abfahrtsseite |
|
|
|
|
Nach 5 Minuten ohne Tastendruck springt das Gerät automatisch zurück zur
|
|
Hauptseite. Die Hauptseite aktualisiert sich alle 10 Minuten, die
|
|
MVG-Seite jede Minute.
|
|
|
|
## Icons
|
|
|
|
Die Icons (Sonne, Wolke, Regen, U-/S-Bahn-Badges, Kalender, Fehler-Symbol)
|
|
werden aktuell prozedural mit M5Stack-Grafikprimitiven gezeichnet
|
|
(`src/icons/icons.h`), um den Flash-Speicher zu schonen. Für echte
|
|
Pixel-Art-Bitmaps können die Funktionskörper später durch
|
|
`M5.Lcd.drawBitmap(...)`-Aufrufe mit RGB565-Arrays ersetzt werden.
|
|
|
|
## Git
|
|
|
|
Dieses Projekt ist bewusst noch nicht als Git-Repository initialisiert.
|
|
Sobald gewünscht:
|
|
|
|
```
|
|
git init
|
|
git add .
|
|
git commit -m "Initial M5Stack dashboard"
|
|
```
|
|
|
|
`include/secrets.h` ist bereits in `.gitignore` ausgeschlossen.
|