Wenn ihr diesen Artikel gefunden habt, so kennt ihr höchstwahrscheinlich das AWTRIX-Projekt. Eine Firmware für ESP-Entwicklerboards, mit der sich Selbstbau-LED-Matrixen betreiben oder auch fertige Modelle wie die TC-001 von Ulanzi umpatchen lassen. Mit „AWTRIX STREAM“ habe ich nun ein kleines Projekt gestartet, welches das Ganze etwas kompakter machen und auf ein LC-Display bringen soll.
Sehr kleine 32x8er-LED-Module zu fairen Preisen und für den passenden Standart zum Betrieb der Awtrix-Firmware zu finden, ist gar nicht so einfach. So entstand die Idee, stattdessen einfach ein 320×172 Pixel großes Display zu verwenden. Mein Projekt ist am Ende keine eigenständige AWTRIX. Stattdessen spiegelt (oder „streamt“) sie sozusagen nur eine bereits in eurem Netzwerk vorhandene LED-Matrix mit laufender AWTRIX-Firmware drauf. Das läuft dann über Wifi und funktioniert erstaunlich gut und schnell.
Dokumentation
Die Dokumentation befindet sich noch im Aufbau, aber gerade wenn ihr die MQTT-Befehle nutzen wollt, die mit Version 1.1.0 mitkamen, habe ich euch die da schon Mal aufgeschrieben.
Die Teile
Um das Projekt nachzubauen benötigt ihr gar nicht viel. Löten ist optional: Nur wenn ihr die recht langen Kabel des Displays kürzen wollt, solltet ihr löten. Es geht aber auch ohne das, dann kann alles einfach zusammengesteckt werden.
- D1 Mini-Board (mit ESP8266-Chip)
- Waveshare 1.47″ LC-Display oder Noname (z.B. dieses)*
- 6x 2mm-Schrauben (z.B. 2×5 oder 2×8)
- einen 3D-Drucker**
*) Ich will betonen das ich keine Werbung für das Waveshare-Display machen will. Ich habe mich aus 3 Gründen für dieses (im Vergleich etwas teurere) Display entschieden: Zum einen ist die Platine des Boards nur minimal größer als das Display was 3D-Gehäuse kompakter werden lies. Außerdem bringt das Display auf der Rückseite direkt Muttern zum verschrauben mit und da es sich um ein „Markenprodukt“ handelt, solltet ihr beim Bestellen im besten Fall auf den Millimeter dasselbe Produkt erhalten. In der Theorie sollte auch jedes andere Display, welches einen ST7789-Chip mitbringt problemlos funktionieren wie das verlinkte Noname-Display.
**) Der 3D-Drucker ist optional. Ihr könnt das Projekt natürlich auch mit einem ganz eigenen Gehäuse oder in anderer Form nachbauen. Dann benötigt ihr nur die Hardwarekomponenten und könnt loslegen.
3D Druck
Wenn ihr das Projekt wie im Video gezeigt nachbauen möchtet, könnt ihr euch mein AWTRIX STREAM-Gehäuse drucken. Es besteht aus 3 Teilen: Einem Träger, auf dem das Display aufgeschraubt und das D1 Mini-Board aufgelegt wird. Sowie dem Hauptgehäuse und einer aufsteckbaren Front.
Zusammenbau
Im ersten Schritt solltet ihr das Display mit dem D1 Mini-Board verbinden. Die folgende Tabelle zeigt, welche Pin des Displays mit welchem Pin des Boards verbunden werden muss.
| D1 Mini Board | Waveshare 1.47″ Display | Noname 1.47″ Display |
| D5 (GPIO 14) | CLK | SCL |
| D7 (GPIO 13) | DIN | SDA |
| D1 (GPIO 5) | CS | CS |
| D4 (GPIO 2) | DC | DC |
| D6 (GPIO 12) | BL | BL |
| D3 (GPIO 0) | RST | RST |
| 3V3 | VCC | VDD |
| G | GND | GND |
Wenn ihr nicht löten möchtet und das 3D-gedruckte Gehäuse verwenden möchtet, dann müsst ihr an der Stelle nur noch das Display mit 4 Schrauben an dem Träger anbringen und das Kabel vorsichtig verwickeln. Danach den Träger einschieben und von außen festschrauben. Front vorsichtig aufklippen und das wars. Weiter geht’s mit dem Flashen der Software.
Software
Um die Software auf das Board zu bekommen, müsst ihr es zunächst via USB mit eurem Rechner verbinden. Als nächstes benötigt ihr einen Chrome-basierten Browser, als Chrome selbst, Chromium, Brave oder MS Edge. Opera funktioniert u. U. auch. Dann geht ihr auf folgende Seite, auf der ich immer die aktuelle Software-Version bereitstelle:
Wählt dort das Projekt #002: AWTRIX STREAM vx.x.x (ehemals „Awtrix Mini“) aus und folgt den Anweisungen. Solltet ihr das lieber in Bewegtbild sehen wollen: Im Video zeige ich auch diesen Schritt.
Nach der Installation stellt das ESP-Board einen WLAN-Access Point zur Verfügung:
SSID: AWTRIX STREAM-Setup
Passwort: 12345678
Sobald ihr verbunden seit, sollte sich ein Konfigurationsmenü öffnen. Wenn die Seite nicht automatisch erscheint, verbindet euch auf die IP-Adresse http://192.168.4.1. Hier könnt ihr nun euer Wlan konfigurieren. Außerdem könnt ihr dem Board noch einen Hostname vergeben und – ganz wichtig – die IP-Adresse der AWTRIX, die kopiert werden soll und von der unsere neue AWTRIX STREAM ihre Daten erhält.
Sind alle Einstellungen vorgenommen sollte sich die AWTRIX STREAM direkt mit ihrer großen Schwester verbinden. Habt ihr euch „verkonfiguriert“, so startet bitte mit der Installation der Software von vorne und wählt unbedingt „Erase Device“ aus. Dann könnt ihr frisch durchstarten.
Changelog
Um euch auf dem laufenden zu halten, was sich bei der Software so getan hat, kopiere ich euch hier die Änderungen der letzten Versionen rein.
## v1.1.0 - 20.04.2025
[FEATURE] MQTT broker support
[FEATURE] Change settings via MQTT
[FEATURE] HTTP Basic Auth configuration to access secured AWTRIX hosts
[FEATURE] Toggle display via MQTT
[FEATURE] Reboot AWTRIX STREAM via MQTT
[FEATURE] Erase all settings via MQTT to start over
[FIX] Several layout/screen optimisations and new dialogs
[FIX] Reduce Overhead on HTTP calls for better performance
[FIX] Removed FPS counter on Serial connection for better performance
[CHORE] Name change to a more fancy "AWTRIX STREAM". Yeah!
## v1.0.0 - 06.04.2025
Initial release
FAQ
Benötige ich wirklich eine „richtige“ AWTRIX oder Ulanzi TC001 mit AWTRIX-Firmware oder läuft die AWTRIX STREAM auch Standalone?
Die AWTRIX STREAM wiederholt technisch gesehen nur das, was auf einer anderen LED-Matrix angezeigt wird. Sie kann nicht standalone betrieben werden.
Gibt es einen anderen Weg die AWTRIX STREAM zu nutzen ohne erst eine LED-Matrix kaufen zu müssen?
Ja. Wenn ihr noch ein ESP32-WROOM-32D-Board rumfliegen habt, könnt ihr da die AWTRIX-Firmware draufflashen. Die läuft dann auch ohne angeschlossene LED-Panele und kann so als Host fungieren.
Ist der Sourcecode verfügbar?
Ja, ihr findet das Projekt in meinem Github Repository unter der Attribution-NonCommercial-ShareAlike 4.0 International-Lizenz.
Kann ich mehrere AWTRIX STREAN auf eine Host AWTRIX loslassen?
Theoretisch ja. Jede AWTRIX STREAM verbindet sich über das WLAN via HTTP mit der Host AWTRIX. Das generiert Last auf der Host AWTRIX und kann irgendwann dazu führen, dass sich die AWTRIX STREAM nur noch seltener aktualisieren und alles etwas holpriger wirkt. Wo da genau die Grenze ist, kann ich nicht sagen. 2-3 gleichzeitig habe ich erfolgreich getestet. Eine größere Herausforderung stellt das WLAN da: Das sollte eine gute Signalstärke sowohl für Host also auch für AWTRIX STREAM bieten.
Vielen Dank für das super Projekt!
wie groß wäre der Aufwand den Code für so ein Modul abzuändern. Durch den ESP32, wäre man etwas flexibler. Ausserdem könnte man wegen der „schmalen“ Bauform ein Gehäuse wie bei der Ulanzi machen.
https://de.aliexpress.com/item/1005007751726345.html
Gruß Steffen
Hallo Steffen,
danke für den netten Kommentar. Ich war etwas überrascht über die Resonanz auf das Projekt. Das motiviert mich, da weiter dran zu schrauben. Support für den ESP32 steht bereits auf meiner Todo. Es sollte sicher möglich sein, ist jedoch hier und da mit kleinen Anpassungen verbunden vermute ich. Das Display welches du verlinkt hast habe ich bereits hier (allerdings wieder die etwas teurere Version von Waveshare). Der Link ist hilfreich, ich denke ich werde das auch nochmal ordern da es etwas günstiger ist und dann schauen, ob ich es auf beiden Versionen ans Laufen zu bekommen. Ich hatte während der initialen Entwicklung an dem Projekt mit einem ESP32-C3 experimentiert. Der war auch deutlich schon deutlich kleiner, benötigte aber manuelle Verkabelung. Das Problem da war, dass eine verwendete Bibliothek (TFT_eSPI) mit dem C3 und dem 1.47″-Display nicht sauber arbeiten wollte. Da wurde auch bereits in deren Github zu diskutiert, aber mit Stand von vor einem Monat gab es noch keine Lösung.
Eh ja, du siehst: Ich habs im Hinterkopf. Ich plane einen Changelog unter diesem Post hier, wenn es neue Versionen der Software gibt bzw. vielleicht noch das eine oder andere kurze Video auf Youtube zu Änderungen. Wenn es denn was zu zeigen gibt. Das würde dazugehören, wird aber vermutlich noch ein bisschen dauern.
Auch von mir ein dickes Dankeschön für dieses Projekt.
Ist einfach schön, nochmal eine kleine Version zu haben 🙂
Ich habe es auf ein ESP32-C6-LCD-1.47 portiert. Schön kompakt und direkt mit aufgesetztem Display und recht günstig. Muss jetzt nur noch das Gehäuse evtl. etwas anpassen.
Viele Grüße
Wilhelm
Hallo Wilhelm,
vielen Dank! Mich würde interessieren, was du tun musstest um die Software auf dem C6 ans Laufen zu bekommen? Das steht wie oben im Kommentar geschrieben noch auf meiner Todo-Liste.
Danke und Grüße
Hi,
ich habe mir das Display hier geholt
https://de.aliexpress.com/item/1005008590212781.html
Leider zeigt das Display nach dem Flashen nichts an.
Es sollte ja zumindest der Welcome Screen kommen, oder?
Danke
Hallo Steffen,
Vielen dank! Ich hab mir diesem schönen gadget heute gelötet.
Es is sehr einfach um es mein Awtrix 3 wiederholen zu lassen.
Weil es so einfach geht, dan würde ich neugierig über die möglichheiten das display der Awtrix Stream zu personalisieren.
Zum beispiel: Wann ich es im slafzimmer aufstellen möchte, dan möchte ich gerne das nicht alle ‚apps‘ vorbei kommen.
Auch soll es toll sein die ‚brightness‘ an zu passen auf wieviel licht in der slafzimmer ist.
Ich glaube das ihren project würklich sehr nett ist! Sollt da kein möglicheit sein um die wünsch von z.b. mir zu realiseren, dann ist es immer noch ein super tolles gerät! Hertzlich dank!
Liebe grüße!