https://github.com/graythezebra/nerd-display
ESP8266 + MD_Parola LED-Matrix mit MQTT & WebUI Steuerung
https://github.com/graythezebra/nerd-display
arduino esp8266 esp8266-arduino esp8266-projects esp8266mqtt esp8266wifi iot iot-device led-matrix led-matrix-8x8 led-matrix-controller led-matrix-displays max7219 mqtt mqtt-client parola
Last synced: about 1 month ago
JSON representation
ESP8266 + MD_Parola LED-Matrix mit MQTT & WebUI Steuerung
- Host: GitHub
- URL: https://github.com/graythezebra/nerd-display
- Owner: GrayTheZebra
- Created: 2025-08-11T11:09:24.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2025-08-11T11:54:01.000Z (2 months ago)
- Last Synced: 2025-08-11T13:14:19.360Z (2 months ago)
- Topics: arduino, esp8266, esp8266-arduino, esp8266-projects, esp8266mqtt, esp8266wifi, iot, iot-device, led-matrix, led-matrix-8x8, led-matrix-controller, led-matrix-displays, max7219, mqtt, mqtt-client, parola
- Language: C++
- Homepage: https://prokrastinerd.de/
- Size: 19.5 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Nerd-Display (ESP8266 + MD\_Parola + MQTT + WebUI)
Zeigt Texte/Werte auf einer 4x MAX7219 (FC16) Matrix an.
Konfiguration per WebUI (LittleFS) **und** MQTT.
Unterstützt globale und per-Message Ein-/Ausblendeffekte sowie individuelle Anzeigedauer (dwell) je Nachricht.
## ✨ Features
* MD\_Parola Effekte (global oder pro Nachricht einzeln)
* Individuelle **dwell-Zeiten** pro Nachricht (ms)
* MQTT:
* `set/*` (Kommandos)
* `state/*` (retained States)
* `meta/*` (Bootstrapping-Infos)
* Bootstrapping: Setzt beim ersten Connect alle Defaultwerte
* WebUI (LittleFS) für Konfiguration
* Mehrere Nachrichten in einer Schleife rotierend anzeigen
## 📂 Ordnerstruktur
```
NerdDisplay.ino
app.h / app.cpp
config_store.h / config_store.cpp
display_service.h / display_service.cpp
mqtt_service.h / mqtt_service.cpp
mqtt_topics.h
web_handlers.h / web_handlers.cpp
webui.h
```
## 📦 Abhängige Libraries
* [ESP8266 Core](https://github.com/esp8266/Arduino)
* [MD\_Parola](https://github.com/MajicDesigns/MD_Parola)
* [MD\_MAX72XX](https://github.com/MajicDesigns/MD_MAX72XX)
* [PubSubClient](https://github.com/knolleary/pubsubclient)
* [ArduinoJson](https://arduinojson.org/)
* [WiFiManager](https://github.com/tzapu/WiFiManager)
* LittleFS (integriert im ESP8266 Core)
## 📡 MQTT Beispiele
### Einzelner Text (globaler Effekt + dwell)
* **Topic:**
`/set/text`
* **Payload:**
```json
"Hallo"
```
oder
```json
{"text":"Hallo"}
```
### Mehrere Texte (globaler Effekt + dwell)
```json
["Hallo", "Zebra"]
```
oder
```json
{"messages":["Hallo", "Zebra"]}
```
### Per-Message Effekte und dwell
```json
[
{"text":"Hallo","in":"SCROLL_LEFT","out":"OPENING","dwell":1000},
{"text":"Zebra","in":"PRINT","out":"CLOSING","dwell":3000},
"Eintrag ohne Objekt nutzt globale Defaults"
]
```
* **`in`** = MD\_Parola Effektname für Einblenden (optional, leer = globaler Effekt)
* **`out`** = MD\_Parola Effektname für Ausblenden (optional, leer = globaler Effekt)
* **`dwell`** = Anzeigedauer in Millisekunden (optional, `-1` oder leer = globaler dwell)
### Objektform mit `messages`-Array
```json
{"messages":[
{"text":"A","dwell":500},
{"text":"B","in":"SCROLL_RIGHT","dwell":2000}
]}
```
## ⚙ Globale Parameter per MQTT setzen
* `/set/brightness` → 0..15
* `/set/speed` → Parola Geschwindigkeit (1..65535)
* `/set/dwell` → globaler dwell in ms
* `/set/effect_in` → globaler Einblendeffekt
* `/set/effect_out` → globaler Ausblendeffekt
* `/set/effect` → beide Effekte gleichzeitig setzen (Legacy)
## 📜 MD\_Parola Effektliste
Folgende Werte sind für `in` und `out` gültig (Großschreibung beachten):
* PRINT
* SLICE
* WIPE
* WIPE\_CURSOR
* OPENING
* OPENING\_CURSOR
* CLOSING
* CLOSING\_CURSOR
* BLINDS
* DISSOLVE
* SCROLL\_UP
* SCROLL\_DOWN
* SCROLL\_LEFT
* SCROLL\_RIGHT
* SCROLL\_UP\_LEFT
* SCROLL\_UP\_RIGHT
* SCROLL\_DOWN\_LEFT
* SCROLL\_DOWN\_RIGHT
* SCAN\_HORIZ
* SCAN\_VERT
* GROW\_UP
* GROW\_DOWN
*(Die genaue Wirkung dieser Effekte ist in der [MD\_Parola Dokumentation](https://majicdesigns.github.io/MD_Parola/class_m_d___parola.html) beschrieben.)*
## 📜 Lizenz
MIT (siehe LICENSE)