Krypto-Ticker mit ESP32 und MAX7219: Teile, Verkabelung
Baue einen Krypto-Ticker mit ESP32 und MAX7219-Matrix: Pinbelegung, Flashen im Browser, Captive Portal und kostenloser CoinGecko-Key. Firmware auf GitHub.
- Autor
Mauro Brambilla- Veroffentlicht
- Lesezeit
- 9 Min.
- Kategorie
- Projekte

Kurz gesagt
Ein Gizmo Ticker braucht ein XIAO ESP32-S3, eine 4-in-1-FC16-MAX7219-Matrix, fünf Drähte und einen kostenlosen CoinGecko-Demo-Key. Der Bau dauert etwa 60 Minuten, die Firmware flashst du im Browser.
Ein ESP32-Krypto-Ticker ist ein Seeed Studio XIAO ESP32-S3, das mit fünf Drähten an eine 4-in-1-FC16-LED-Matrix mit MAX7219 angeschlossen ist. Seine Firmware holt alle 6 Minuten Bitcoin- oder Kaspa-Kurse von der CoinGecko-API und lässt sie über die Matrix laufen. Der Bau dauert etwa 60 Minuten und erfordert etwas Löten.
Diese Anleitung folgt dem echten Gizmo Ticker, einem Open-Source-Projekt von OpenGizmo. Die Pins, Bibliotheksversionen und Zeiten unten stammen aus seinem Firmware-Quellcode, du kannst also jede Angabe nachprüfen, und jeder Schritt sagt dir, was du sehen solltest, bevor du weitermachst.
Ein Krypto-Display mit WLAN, gebaut aus einem ESP32, einer MAX7219-LED-Matrix und einer Nuxt-4-Web-App für die Einrichtung und Konfiguration im Browser.
- Krypto-Ticker in Echtzeit
- MAX7219-LED-Matrix
- Einrichtung im Browser
Wie kommt ein Kurs auf die Matrix?
In zwei Schritten, und es hilft, sie zu kennen, bevor du etwas verkabelst. Das Board ruft CoinGecko per HTTPS aus einem Hintergrund-Task ab, hält die letzte Antwort im Speicher, und eine Schleife, die nie blockiert, lässt sie per SPI über die Matrix laufen. Das Handy gehört nicht zum Weg der Kurse: Du nutzt es nur, um Einstellungen zu ändern, die im Flash des Boards gespeichert werden.

Was brauchst du für einen ESP32-Krypto-Ticker?
Fünf Dinge, plus einen Computer mit Chrome oder Edge für das Flashen.
| Teil | Anz. | Hinweise |
|---|---|---|
| Seeed Studio XIAO ESP32-S3 | 1 | Wird mit einer FPC-Antenne geliefert. Das Board hat keine eigene Antenne |
| MAX7219 4-in-1-FC16-LED-Matrix | 1 | Vier 8x8-Module auf einer Platine, 32x8 Pixel |
| 6-adriges Flachbandkabel | 1 | Nur fünf Adern werden genutzt |
| USB-C-Datenkabel | 1 | Zum Flashen und zur Stromversorgung. Ein reines Ladekabel funktioniert nicht |
| M3-x-8-Schrauben | 4 | Nur für das gedruckte Gehäuse |
Das XIAO ESP32-S3 hat laut Seeed-Studio-Wiki einen Dual-Core-Xtensa-LX7 mit bis zu 240 MHz und 2,4-GHz-WLAN. Es ist das Board, auf dem jedes OpenGizmo-Gerät läuft. Wenn du noch nicht weißt, welches Board du nehmen sollst, hilft dir welchen ESP32 du kaufen solltest beim Vergleich.
Ein MAX7219 ist ein Treiberbaustein, der über einen kurzen seriellen Bus bis zu 64 LEDs ansteuert, also eine 8x8-Matrix, und sich mit weiteren MAX7219 verketten lässt (Produktseite von Analog Devices). Auf dem 4-in-1-FC16-Board sind vier davon schon für dich verkettet.
Wie verkabelst du den MAX7219 mit dem XIAO ESP32-S3?
Mit dem USB-C-Anschluss nach oben und den Bauteilen zu dir zeigend, steht am rechten Rand des XIAO: 5V, GND, 3V3, D10, D9, D8, D7. Das entspricht fast der Reihenfolge des Matrix-Eingangs (VCC, GND, DIN, CS, CLK), deshalb nutzt die Firmware die Pads neben 5V und GND, und ein Flachbandkabel läuft geradeaus hinüber. Der 3V3-Draht hängt einfach frei.

| MAX7219-Eingang | Pad am XIAO ESP32-S3 | GPIO am ESP32-S3 | Funktion |
|---|---|---|---|
| VCC | 5V | keiner | Strom für die Matrix |
| GND | GND | keiner | Masse |
| DIN | D10 | GPIO9 | SPI-Daten (MOSI) |
| CS | D9 | GPIO8 | Chip Select |
| CLK | D8 | GPIO7 | SPI-Takt (SCK) |
Die Firmware startet SPI ohne MISO-Pin, weil das Display nie etwas zurückschickt. Dadurch wird D9 frei, das standardmäßig das MISO-Pad ist, und kann als CS dienen. Die Pin-Konstanten stehen in config.h.
Drei Dinge, bevor du Strom gibst:
- Stecke die FPC-Antenne auf den U.FL-Anschluss, sonst verbindet sich das Board nicht mit deinem WLAN.
- Das 5V-Pad ist die USB-Versorgung, die Matrix wird also über dasselbe Kabel wie das Board mit Strom versorgt. Das Repository nennt keinen Stromwert, und die Stromaufnahme steigt mit Helligkeit und Modulzahl, also fang mit niedriger Helligkeit an.
- Die GPIOs des XIAO arbeiten mit 3,3 V, während die Matrix mit 5 V versorgt wird. Das Projekt verbindet sie direkt, ohne Pegelwandler. Das liegt unter dem Eingangspegel von 3,5 V, den das Datenblatt des MAX7219 garantiert, also ergänze einen Pegelwandler, wenn das Display Müll zeigt. MAX7219 FC16 am ESP32: Verkabelung, 3,3-V-Logik, Spiegelung hat die Zahlen.
Löte die Drähte auf der Matrix-Platine direkt an die Eingangspads statt die Stiftleisten zu benutzen, wenn du das Gehäuse drucken willst: Die geraden Stifte ragen an jedem Ende etwa 7 mm heraus (gemessen in den Teilenotizen des Projekts) und stören die Schale.
Wie flashst du die Firmware im Browser?
Du brauchst keine IDE. Die veröffentlichte Firmware wird mit ESP Web Tools geflasht, das über Web Serial mit dem Board spricht und deshalb in Chrome und Edge funktioniert.
- Stecke das XIAO mit dem USB-C-Datenkabel an deinen Computer.
- Öffne die Projektseite des Gizmo Ticker und scrolle zur Flash-Karte für die Firmware.
- Klicke auf Flash firmware, wähle den seriellen Port des Boards und warte, bis es fertig ist.
Das Board startet von selbst neu, und ein Flash von der Website behält die bereits gespeicherten Einstellungen. Der Button liest ein Manifest des neuesten Releases, du bekommst also immer die aktuellste Firmware. Nach dem Neustart lässt die Matrix Initializing... laufen, und gleich danach solltest du eine WLAN-Meldung sehen.
Willst du lieber selbst bauen? Das Repository nutzt PlatformIO mit dem Board seeed_xiao_esp32s3 und Node.js 24.21 oder neuer für die Web-App. Die Bibliotheken sind in platformio.ini festgelegt: MD_Parola 3.7.5, MD_MAX72XX 3.5.1, ESPAsyncWebServer 3.12.1, ArduinoJson 7.2.2 und die gemeinsame Bibliothek gizmo-common 2.5.1. Wenn du dich fragst, warum PlatformIO und nicht die Arduino IDE, gibt es einen Vergleich von Arduino IDE und PlatformIO.
cd webapp && npm ci && npm run build:embeddedcd ../microcontrollerpio run --target uploadpio run -e debug --target upload && pio device monitorDer letzte Befehl flasht stattdessen das Profil debug, das das serielle Log einschaltet, sodass pio device monitor zeigt, was die Firmware gerade tut. Die veröffentlichte Firmware lässt das Log aus.
Wie funktioniert die erste WLAN-Einrichtung?
Das Board kennt dein WLAN noch nicht, also erstellt es ein eigenes. Ein Captive Portal ist eine Seite, die sich von selbst öffnet, wenn du dich mit einem Hotspot verbindest, derselbe Trick wie beim WLAN im Hotel.
- Etwa 12 Sekunden nach dem Start ohne funktionierendes Netzwerk öffnet das Board einen offenen Hotspot namens Gizmo-Ticker ohne Passwort. Die Matrix lässt
Not connected to Wi-Fi. Use the 'Gizmo-Ticker' access point to enter the Wi-Fi credentials.laufen. - Verbinde dich mit ihm von deinem Handy aus. Die Einrichtungsseite sollte sich von selbst öffnen. Falls nicht, öffne im Browser eine beliebige
http://-Adresse (nichthttps://). - Wähle dein Netzwerk, gib das Passwort ein und bestätige. Die neuen Zugangsdaten werden erst gespeichert, wenn sich das Board wirklich verbunden hat.
Hotspot und Portal stammen aus der gemeinsamen Bibliothek gizmo-common, die diesen Ablauf dokumentiert. Wenn die Seite nie erscheint, geht ESP32 Captive Portal funktioniert nicht die Ursachen eine nach der anderen durch.
Verbinde dich jetzt wieder mit deinem gewohnten Netzwerk und öffne http://gizmo-ticker.local. Manche Router und Android-Versionen lösen .local-Namen nicht auf. Nimm dann die IP-Adresse des Boards aus der Clientliste deines Routers oder lies die mDNS-Fehlerbehebung.
Wie bekommst du einen CoinGecko-API-Key und trägst ihn ein?
Der Ticker zeigt API key is not present. Use the web page to insert the key and try again., bis du ihm einen Key gibst. Lege bei CoinGecko ein kostenloses Demo-Konto an und kopiere den Key aus dem Developer Dashboard.
Öffne die Seite API Key der Web-App, füge den Key ein und speichere. Das Feld nimmt bis zu 34 Zeichen und entfernt Leerzeichen aus dem eingefügten Text. Danach zeigt die Seite den Key maskiert an, und das Board speichert ihn in seinem Flash. Das Speichern eines neuen Keys löst sofort einen Abruf aus, der erste Kurs sollte also bald darauf einlaufen.
Was schickt das Board genau? Eine GET-Anfrage an https://api.coingecko.com/api/v3/coins/markets?vs_currency=usd&ids=bitcoin&price_change_percentage=24h, mit dem Key im Header x-cg-demo-api-key, den die Demo-Authentifizierungsdoku von CoinGecko dem Query-String vorzieht. Du kannst deinen Key vorher vom Computer aus testen:
curl -H "x-cg-demo-api-key: YOUR_KEY" "https://api.coingecko.com/api/v3/coins/markets?vs_currency=usd&ids=bitcoin"Zu den Limits: Im November 2026 gibt die Rate-Limit-Seite von CoinGecko dem Demo-Plan 100 Aufrufe pro Minute, und die Preisseite nennt eine Monatsobergrenze von 10.000 Aufruf-Credits. Ein Aufruf alle 6 Minuten sind 10 pro Stunde, etwa 7.200 in 30 Tagen, der Ticker bleibt also unter der Obergrenze. Die Rechnung und was bei einem 429 passiert, findest du in CoinGecko-API am ESP32: kostenlose Limits und Abfragerate.
Wie konfigurierst du den Ticker?
Sobald der Kurs läuft, steuert die Seite Ticker, was du siehst. Änderungen werden auf dem Board gespeichert, du musst also nie neu flashen, um eine Einstellung zu ändern.

| Einstellung | Optionen | Standard |
|---|---|---|
| Coin | Bitcoin oder Kaspa | Bitcoin |
| Bereiche | Kurs, Kursänderung, Marktkapitalisierung, Tageshoch/-tief, Allzeithoch/-tief, Eröffnungskurs, Volumen | Alle sieben an |
| Zahlenformat | US- oder EU-Stil | US |
| Helligkeit | 0 bis 15 | 1 |
| Scrollgeschwindigkeit | 0 bis 15, abgebildet auf eine Scroll-Verzögerung von 100 ms (0) bis 20 ms (15) | 1 |
| Module | 4 bis 32, in Viererschritten | 4 |
Die Matrix geht die aktivierten Bereiche der Reihe nach durch, eine Meldung nach der anderen. Wenn du alle Bereiche ausschaltest, fordert sie dich auf, mindestens einen zu aktivieren. Eine Änderung der Modulzahl startet das Board neu.
Es sind nur zwei Coins eingebaut. Für einen dritten musst du die Coin-Zuordnung in market_data.cpp und die Coin-Liste in der Web-App bearbeiten und dann neu bauen.
Wie scrollt die Firmware Text, während sie Kurse abruft?
Eine blockierende HTTPS-Anfrage würde die Animation für die Dauer des Aufrufs einfrieren. Deshalb macht die Hauptschleife sie nie. Sie fragt die Bibliothek MD_Parola, ob die aktuelle Meldung fertig ist, und ein separater FreeRTOS-Task führt den Netzwerkaufruf aus.
void loop() {
// Restart the device if the web server asked for it
gizmo::manageDevice();
// Manage the WiFi connection
manageWiFiConnection();
// Wait until the current matrix animation cycle finishes before preparing the next message
if (!isLedMatrixReadyForNextMessage()) {
return;
}
...
}isLedMatrixReadyForNextMessage() endet in displayAnimate() von MD_Parola, das den Scroll ein Stück weiterschiebt und zurückgibt, ob die Meldung fertig ist. Wenn der Cache leer oder fällig ist, startet api.cpp einen marketDataFetch-Task, der mit einem ArduinoJson-Filter nur die vom Display genutzten Felder parst, das Ergebnis speichert und sich dann selbst löscht. Die Schleife zeigt in der Zwischenzeit weiter die letzten guten Daten.
Wenn die Aktualisierungen immer wieder scheitern, veralten die Daten. Nach 12 Minuten beginnt die Matrix jeden Durchlauf mit Prices from N min ago. und dem letzten Fehler. Eine ehrliche Einschränkung: Die Firmware ruft setInsecure() an ihrem HTTPS-Client auf, sie verschlüsselt den Verkehr zu CoinGecko also, prüft aber das Zertifikat des Servers nicht.
Was tust du, wenn der Ticker spinnt?
Ändere immer nur eine Sache und lass dir von den Meldungen der Matrix zeigen, welche Ebene ausfällt.
Die Matrix ist dunkel oder zeigt Müll
Prüfe zuerst die Verkabelung anhand der Tabelle: DIN, CS und CLK an D10, D9 und D8 sowie ein stabiles 5V und GND. Dann prüfe, ob die Modulzahl in den Einstellungen zu deiner Hardware passt. Eine Abweichung zwischen beiden gehört zu den ersten Dingen, die du ausschließen solltest.
Der Text ist gespiegelt oder die Module sind in der falschen Reihenfolge
Die Firmware ist in config.h auf FC16_HW eingestellt, was zu den üblichen 4-in-1-FC-16-Boards passt. Die Bibliothek MD_MAX72XX kennt außerdem PAROLA_HW, GENERIC_HW und ICSTATION_HW. Ich habe sie in diesem Projekt nicht getestet, aber die Konstante zu wechseln und neu zu bauen ist die übliche Lösung.
Das Board verbindet sich nie mit dem WLAN
Schau auf die Antenne. Das XIAO braucht seine FPC-Antenne am U.FL-Anschluss, und ohne sie verbindet sich das Board nicht. Prüfe als Nächstes, ob dein Netzwerk 2,4 GHz nutzt, denn der ESP32-S3 hat kein 5-GHz-Funkmodul.
Die Matrix zeigt "Error while calling the API" oder "Prices from N min ago"
Die Meldung nennt das Symptom, schließe die Ursache also von außen ein. Führe den curl-Test von oben mit deinem Key aus. Ein 401 bedeutet falscher Key oder Tippfehler, ein 429 bedeutet zu viele Aufrufe. Wenn curl funktioniert, liegt das Problem am Board: Speichere den Key neu oder prüfe, ob das Board Internetzugang hat.
Ich will von vorn anfangen
Halte die BOOT-Taste 10 Sekunden lang gedrückt, während das Board läuft. Es vergisst WLAN und Einstellungen und startet im Einrichtungs-Hotspot neu. BOOT und RESET sitzen oben auf dem XIAO und sind im geschlossenen Gehäuse unerreichbar: Öffne zuerst die Rückplatte.
Passt er in ein gedrucktes Gehäuse?
Ja, und das Projekt liefert eines mit. Eine weiße Schale mit einem fünflagigen, 1 mm dicken Diffusor macht aus den LEDs weiche Pixel, und eine orangefarbene Rückplatte schließt sie mit vier M3-x-8-Schrauben. Die Grundfläche beträgt 153,6 x 53,6 mm, die Höhe 28,2 mm. Die Matrix schiebt sich von hinten in ihre Tasche, und das XIAO wird von Klemmrippen gehalten, sein USB-C-Anschluss schließt bündig mit der Stirnwand ab.

Die Konstruktionsregeln dahinter stehen in Konstruktionsregeln für 3D-gedruckte ESP32-Gehäuse, die passen.
Was hast du gebaut, und wo liegen die Grenzen?
Jetzt hast du ein XIAO ESP32-S3, das in dein WLAN geht, alle 6 Minuten Bitcoin- oder Kaspa-Daten von CoinGecko holt und sie auf einer MAX7219-Matrix laufen lässt, alles vom Handy aus einstellbar. Diese Details habe ich dem Firmware-Quellcode und der Herstellerdokumentation entnommen. Das Repository dokumentiert die Verkabelung nur für ein einzelnes 4-in-1-Board, längere Ketten und den Strom, den sie brauchen, musst du also selbst ausprobieren.
Für einen genaueren Blick auf die Display-Seite beginne mit der Verkabelungsanleitung für den MAX7219 FC16. Wenn du ein anderes Gadget auf dieselbe Weise bauen willst, nutzt einen Reolink-NVR mit einem ESP32 steuern dasselbe Board und denselben Einrichtungsablauf, oder lies, was OpenGizmo ist.
Haufig gestellte Fragen
Finden Sie schnelle Antworten auf die haufigsten Fragen zu diesem Thema.
In der Firmware des Gizmo Ticker geht der DIN-Pin des MAX7219 an D10 (GPIO9, MOSI), CS an D9 (GPIO8) und CLK an D8 (GPIO7, SCK). VCC kommt an das 5V-Pad und GND an GND. Das 3V3-Pad bleibt frei, und das Display empfängt nur Daten, es gibt also keinen MISO-Draht.
Autor
Mauro BrambillaLust, dein eigenes Gizmo zu bauen?
Such dir ein Open-Source-Projekt mit dem ESP32 aus und folge der Schritt-für-Schritt-Anleitung, von der Teileliste und der Verkabelung bis zur Firmware und zum ersten Start.







