MAX7219 FC16 am ESP32: Verkabelung, 3,3 V, Spiegelschrift
Schließe eine MAX7219-FC16-Matrix mit fünf Kabeln an den ESP32 an, prüfe die 3,3-V-Logik und behebe Spiegelschrift mit dem passenden MD_MAX72XX-Hardwaretyp.
- Autor
Mauro Brambilla- Veroffentlicht
- Lesezeit
- 10 Min.
- Kategorie
- Projekte

Kurz gesagt
Ein MAX7219-FC16-Modul braucht fünf Kabel zum ESP32: 5 V, GND, DIN, CS und CLK. Wähle FC16_HW in MD_MAX72XX; spiegelverkehrter oder umgedrehter Text heißt, dass der Hardwaretyp nicht zu deinem Board passt.
Ein 4-in-1-Modul MAX7219 FC16 wird mit fünf Kabeln an einen ESP32 angeschlossen: 5 V, GND, DIN, CS und CLK. Du steuerst es mit der Bibliothek MD_MAX72XX an und stellst den Hardwaretyp auf FC16_HW. Erscheint der Text gespiegelt, gekippt oder in falscher Reihenfolge, passt der Hardwaretyp nicht zu deinem Board, und ihn zu ändern ist die Lösung.
Das ist die Referenz hinter dem Gizmo Ticker, der eine FC16-Matrix an einem XIAO ESP32-S3 betreibt. Die Pins und Bibliotheksversionen stammen aus seiner Firmware, die Typentabelle aus dem Quellcode von MD_MAX72XX, und die Messwerte der Bauteile aus meinen Teilenotizen. Den kompletten Aufbau samt Flashen und API-Schlüssel findest du in der Bauanleitung für den Crypto Ticker.
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
Was ist ein 4-in-1-Modul MAX7219 FC16?
Der MAX7219 ist ein Treiberchip, 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). Ein FC16-Modul ist die gängige Platine, die dir vier davon schon verkettet liefert: vier rote 8x8-Matrizen, jede mit eigenem MAX7219, auf einer langen Leiterplatte. Die Dokumentation von MD_MAX72XX sagt, dass man ein FC-16 an der Aufschrift "FC-16" auf der Leiterplatte erkennt und dass die meisten Vierersätze, die als eine Einheit verkauft werden, von diesem Typ sind (FC-16-Seite).
Bei dem Modul, das ich für den Ticker nutze, misst die Leiterplatte 132 x 32 mm, und die LED-Blöcke füllen die ganze Länge, obwohl vier Blöcke à 32 mm nur 128 mm ergeben würden. Die Händler sind sich bei der Länge uneinig (128 bis 132 mm), also miss deins nach, bevor du etwas darum herum konstruierst. Die geraden Stiftleisten ragen an jedem Ende etwa 7 mm heraus. Diese Zahlen stammen aus meinen Teilenotizen zu dieser Platine, gemessen und an den Testdrucken des Tickers bestätigt.
Wie schließt du einen ESP32 an ein MAX7219-FC16-Modul an?
Du brauchst die fünf Pins auf der Eingangsseite des Moduls: VCC, GND, DIN, CS und CLK. Die Bibliothek benennt sie so: DIN ist der serielle Dateneingang, CLK taktet die Daten, und CS (in der Dokumentation der Bibliothek LD genannt) wählt die gesamte Kette aus, wobei die Daten übernommen werden, sobald es wieder auf High geht (Anschlusshinweise der Bibliothek). Auf der anderen Seite der Platine sitzt DOUT, das das nächste Modul speist; lass es also in Ruhe.

Hier die Pinbelegung, die der Gizmo Ticker verwendet. Die GPIO-Nummern sind die des Chips selbst, und die D-Bezeichnungen sind die Pad-Namen des XIAO, erklärt in der Pinbelegung des XIAO ESP32-S3.
| FC16-Eingang | XIAO-ESP32-S3-Pad | ESP32-S3-GPIO | Funktion |
|---|---|---|---|
| VCC | 5V | keiner | Versorgung der Matrix |
| GND | GND | keiner | Masse |
| DIN | D10 | GPIO9 | SPI-Datenausgang (MOSI) |
| CS | D9 | GPIO8 | Chip Select |
| CLK | D8 | GPIO7 | SPI-Takt (SCK) |
Die Pads neben 5V und GND folgen der Reihenfolge des Moduleingangs, sodass ein Flachbandkabel einfach geradeaus läuft und das 3V3-Kabel frei bleibt. Bei jedem anderen ESP32-Board wählst du drei beliebige freie GPIOs: Die Bibliothek hat einen Konstruktor, der Daten-, Takt- und CS-Pin direkt entgegennimmt, und einen weiteren, der den Hardware-SPI des Boards nutzt. Hardware-SPI ist schneller, und die Dokumentation der Bibliothek beschreibt die Software-Variante als langsamer.
Hier der echte Setup-Code des Tickers aus matrix.cpp:
SPI.begin(CLK_PIN, -1, DATA_PIN); // The display only writes: no MISO, so its default pin stays free (MD_MAX72XX then reuses this bus)
matrix = new MD_Parola(HARDWARE_TYPE, CS_PIN, config.matrixModules);
matrix->begin(); // Start the LED matrixZwei Details sind wichtig. Die -1 bedeutet "kein MISO", weil das Display nie etwas zurückschickt, und das macht D9 als CS frei. Die Konstante HARDWARE_TYPE ist MD_MAX72XX::FC16_HW, definiert in config.h. Der Quellcode von MD_MAX72XX 3.5.1 startet jede SPI-Transaktion mit 8 MHz im Modus 0, was unter dem Taktlimit von 10 MHz im Datenblatt des MAX7219 liegt, aber bei langen Kabeln im Hinterkopf bleiben sollte.
Wenn du kein XIAO nutzt, passt dieselbe Idee in wenige Zeilen. Dieser minimale Sketch folgt dem Setup des Tickers und der dokumentierten API der Bibliothek, mit den Pins des Tickers; ich habe genau diesen Sketch nicht kompiliert, nimm ihn also als Ausgangspunkt und ändere die drei Pinnummern auf die deines Boards:
#include <MD_Parola.h>
#include <MD_MAX72xx.h>
#include <SPI.h>
constexpr MD_MAX72XX::moduleType_t HARDWARE_TYPE = MD_MAX72XX::FC16_HW;
constexpr uint8_t MODULES = 4; // one 4-in-1 board
constexpr uint8_t CS_PIN = 8;
MD_Parola display(HARDWARE_TYPE, CS_PIN, MODULES);
void setup() {
SPI.begin(7, -1, 9); // SCK, no MISO, MOSI
display.begin();
display.setIntensity(1); // 0-15
display.displayText("HELLO", PA_CENTER, 50, 1000, PA_SCROLL_LEFT, PA_SCROLL_LEFT);
}
void loop() {
if (display.displayAnimate()) display.displayReset();
}Bevor du feierst: Versorge das Board mit Strom und schau, ob überhaupt Text erscheint. Ein dunkles Display bei korrekter Verkabelung ist ein anderes Problem als Spiegelschrift, und die nächsten Abschnitte gehen beides nacheinander durch.
Funktioniert 3,3-V-Logik mit einer 5-V-MAX7219-Platine?
In der Praxis meist ja, aber es liegt außerhalb dessen, was das Datenblatt garantiert. Die Matrix läuft mit 5 V, während die GPIOs des ESP32 mit 3,3 V arbeiten, es kommt also darauf an, ob ein High mit 3,3 V für den MAX7219 als High zählt.
Die Zahlen aus den Primärquellen:
| Quelle | Parameter | Wert | Bedingungen |
|---|---|---|---|
| Datenblatt MAX7219 | Eingangsspannung Logik High (VIH), DIN, CLK, CS | mindestens 3,5 V | V+ = 5 V, plus/minus 10 % |
| Datenblatt MAX7219 | Eingangsspannung Logik Low (VIL) | höchstens 0,8 V | V+ = 5 V, plus/minus 10 % |
| Datenblatt MAX7219 | Betriebsspannung | 4,0 bis 5,5 V | keine |
| Datenblatt ESP32-S3 v2.2 | Ausgangsspannung High-Pegel (VOH) | mindestens 0,8 x VDD, 2,64 V bei 3,3 V | VDD = 3,3 V, 25 C |
Beide stammen von den Herstellern: das Datenblatt des ESP32-S3 von Espressif (Tabelle 5-4) und das Datenblatt des MAX7219 von Maxim, Revision 4. Die Seite von Analog Devices dazu ließ sich beim Prüfen dieses Beitrags nicht laden, deshalb habe ich dieselbe Revision aus einer bei SparkFun gehosteten Kopie gelesen; die Produktseite von Analog Devices führt womöglich eine neuere.
Der garantierte High-Pegel des ESP32-S3 (2,64 V) liegt also unter dem garantierten Minimum des MAX7219 (3,5 V). Die Datenblätter versprechen nicht, dass das funktioniert. Was der Gizmo Ticker macht, geht klar aus seinem Repository hervor: DIN, CS und CLK laufen direkt von den 3,3-V-Pins des XIAO zur Matrix, die am 5V-Pad hängt, ohne Pegelwandler. Die README dokumentiert die Verkabelung und liefert keine Marginalanalyse, und ich behaupte keinen Test darüber hinaus. Echte Chips schalten oft schon unter dem garantierten Pegel, aber bei einer anderen Charge, einem langen Kabel oder einer verrauschten Versorgung kannst du dich darauf nicht verlassen.
Siehst du Zeichenmüll, Flackern oder zufällige Pixel, setze einen Pegelwandler auf die drei Signalleitungen (DIN, CS, CLK). Er muss nur in eine Richtung arbeiten, denn das Display antwortet nie. Das umgekehrte Risiko gibt es bei dieser Verkabelung nicht: Die Eingänge des ESP32-S3 vertragen höchstens VDD plus 0,3 V, aber keine Leitung führt Daten von der Matrix zum ESP32. Dieselbe Frage taucht bei einem 5-V-I2C-Adapter in ESP32 I2C-LCD 16x2 funktioniert nicht auf. Prüfe auch die Versorgung, wie die Anleitung zum ESP32-Brownout erklärt.
Warum ist mein MAX7219-Text gespiegelt oder verdreht?
Jede Platine im FC16-Stil hat dieselben Chips, aber die Verdrahtung zwischen LED-Matrix und MAX7219 unterscheidet sich von einer Platinenfamilie zur nächsten. Die Dokumentation von MD_MAX72XX sagt, dass die Schaltungen im Wesentlichen gleich sind und der Unterschied darin liegt, wie die Matrix mit dem Chip verdrahtet ist, was die Bibliothek per Software mit einem moduleType_t-Wert behandelt (Hardware-Seite).

Jeder Typ ist eine Kombination aus drei Schaltern, beschrieben auf der Seite der strukturierten Namen: DR (Digits als Zeilen), CR (Spalten gespiegelt) und RR (Zeilen gespiegelt). So setzt sie der Quellcode 3.5.1 in setModuleParameters():

| Hardwaretyp | Digits als Zeilen (DR) | Spalten gespiegelt (CR) | Zeilen gespiegelt (RR) | Strukturierter Name |
|---|---|---|---|---|
| FC16_HW | ja | nein | nein | DR1CR0RR0 |
| GENERIC_HW | nein | ja | nein | DR0CR1RR0 |
| PAROLA_HW | ja | ja | nein | DR1CR1RR0 |
| ICSTATION_HW | ja | ja | ja | DR1CR1RR1 |
Die Spalten- und Zeilenspiegelung wirkt jeweils auf einen 8x8-Block: Der Quellcode bildet ein Pixel auf COL_SIZE - 1 - c und ROW_SIZE - 1 - r ab, wobei beide Größen 8 sind. Sie beheben also Zeichen, die innerhalb jedes Blocks gespiegelt oder gekippt sind. Die folgende Tabelle ist meine Lesart dieser Flags, kein Test am Aufbau, nimm sie also als kurze Liste dessen, was du zuerst probieren solltest, jeweils ein Typ pro Build.
| Was du siehst | Welcher Schalter wahrscheinlich falsch steht | Probiere das |
|---|---|---|
| Jeder Buchstabe von links nach rechts gespiegelt, aber aufrecht | Spalten gespiegelt (CR) | Wechsle von FC16_HW zu PAROLA_HW, das sich nur in CR unterscheidet |
| Jeder Buchstabe von oben nach unten gekippt | Zeilen gespiegelt (RR) | Nimm den strukturierten Namen DR1CR0RR1_HW, der in der Bibliothek keinen Alias hat |
| Jeder Buchstabe um 180 Grad gedreht | CR und RR zusammen | Probiere ICSTATION_HW, das FC16_HW mit beiden Spiegelungen zusätzlich ist |
| Buchstaben liegen auf der Seite oder sind durcheinander | Digits als Zeilen (DR) | Probiere GENERIC_HW und starte dann das Beispiel HW_Mapper |
Die Reihenfolge der Module ist eine eigene Frage, getrennt von den drei Spiegelungen. Die FC-16-Seite der Bibliothek sagt, dass das Display mit der DIN-Seite rechts ausgerichtet ist, und die Seite der strukturierten Namen sagt, dass die Module von rechts nach links verkettet sind. Sie warnt außerdem, dass der auf die Leiterplatte gedruckte Text auf dem Kopf erscheinen kann, beurteile die Platine also nach dem, was die LEDs zeigen, nicht nach dem Bestückungsdruck. Meine Teilenotizen gehen beim Ticker vom selben Aufbau mit DIN rechts aus und führen ihn als noch offen: Ich habe ihn nicht auf jeder Platine bestätigt. Kommen ganze Wörter in falscher Modulreihenfolge heraus, prüfe, ob du die Eingangspads (DIN) und nicht die Ausgangspads (DOUT) angeschlossen hast und ob die Modulanzahl im Code zur tatsächlichen passt.
Funktioniert kein benannter Typ, liefert die Bibliothek ein Hilfsprogramm namens MD_MAX72xx_HW_Mapper mit: Starte es mit nur einem Modul, und es gibt aus, zu welchem Digit und Segment jedes leuchtende Pixel gehört, sodass du den richtigen Namen DR#CR#RR#_HW zusammensetzen kannst. Die Bibliothek warnt, dass Kombinationen ohne Alias nur dann zuverlässig laufen, wenn sie getestet wurden.
Lässt sich das auch per Software beheben? MD_Parola hat die Zoneneffekte PA_FLIP_UD und PA_FLIP_LR, gesetzt mit setZoneEffect(). Ihr Header sagt, PA_FLIP_UD funktioniere mit jedem Texteffekt, PA_FLIP_LR aber nicht mit SCROLL_LEFT, SCROLL_RIGHT oder SLICE, und der Ticker scrollt nach links (PA_SCROLL_LEFT in config.cpp). Bei einem scrollenden Display wird eine Links-rechts-Spiegelung durch den Hardwaretyp behoben, nicht durch einen Flip.
Beim Gizmo Ticker heißt das: Die Zeile HARDWARE_TYPE in config.h ändern und die Firmware selbst bauen. Die im Browser geflashte Version ist fest auf FC16_HW eingestellt.
Warum ist meine MAX7219-Matrix dunkel, schwach oder zeigt Zeichenmüll?
Ein dunkles oder verrauschtes FC16-Display liegt fast immer an der Stromversorgung, der Verkabelung oder daran, dass Code und Board nicht zusammenpassen, und die Reihenfolge unten geht von der billigsten Prüfung zur aufwendigsten. Ändere immer nur eine Sache.
| Was du siehst | Wahrscheinliche Ursache | Was du prüfen solltest |
|---|---|---|
| Nichts leuchtet | Keine Versorgung, keine gemeinsame Masse oder die falsche Seite angeschlossen | 5 V an VCC, GND mit dem ESP32 verbunden, Kabel an den Eingangspads, nicht an DOUT |
| Nichts leuchtet, Verkabelung sieht richtig aus | CS oder Modulanzahl weichen vom Code ab | Der CS-Pin im Konstruktor passt zum CS-Kabel, und die Modulanzahl beträgt 4 pro Platine |
| Sehr schwacher Text | Helligkeit niedrig eingestellt | setIntensity() akzeptiert 0 bis 15, und der Standardwert des Tickers ist 1 |
| Zufällige Pixel, Flackern oder Zeichenmüll | 3,3-V-Logik am Limit oder schwache Versorgung | Pegelwandler an DIN, CS und CLK, kürzere Kabel, stabile 5-V-Versorgung |
| Text ist lesbar, aber gespiegelt oder gekippt | Falscher Hardwaretyp | Die Symptomtabelle im Abschnitt zur Spiegelschrift oben, jeweils ein Typ |
Das Datenblatt des MAX7219 nennt eine Betriebsspannung von 4,0 bis 5,5 V, eine am 3V3-Pad angeschlossene Matrix liegt also unter diesem Bereich. Der Ticker lässt dieses Pad aus demselben Grund frei. Die Anleitung zum ESP32-Brownout behandelt den Fall, dass stattdessen das ganze Board neu startet.
Wie verkettest du MAX7219-Module, und wie viel Strom braucht das?
Eine Kette ist eine Schieberegisterleitung: DOUT eines Moduls geht an DIN des nächsten, während CS und CLK von allen geteilt werden. Die Anschlusshinweise der Bibliothek sagen, dass die Daten in ein 16-Bit-Register geschoben und bei der steigenden Flanke des Load-Signals übernommen werden und dass die CS-Leitung die gesamte Kette auswählt. Eine FC16-Platine verkettet ihre vier Module bereits; um das Display zu erweitern, verbinde die Ausgangspads einer Platine mit den Eingangspads der nächsten.
Du sagst der Bibliothek, wie viele 8x8-Module es gibt, und der Rest ergibt sich. Der Gizmo Ticker speichert diese Zahl im Flash und akzeptiert 4 bis 32 in Vierer-Schritten, weil die Platinen als 4-in-1 kommen. Der Standardwert ist 4, also eine Platine, und dafür ist auch das Gehäuse gezeichnet. Die Firmware startet nach der Änderung der Anzahl neu, da das Display-Objekt nur einmal beim Booten erzeugt wird.
Zum Strom habe ich keinen gemessenen Wert für die FC16-Platine. Das Repository des Tickers nennt keinen, und meine Teilenotizen führen auch keinen. Das Datenblatt des MAX7219 gibt einen Worst Case für einen Chip an: bis zu 330 mA bei eingeschalteten Segmenten mit je 40 mA, und eine FC16-Platine hat vier Chips, die Obergrenze vervielfacht sich also, aber die tatsächliche Stromaufnahme hängt von der Helligkeitseinstellung und vom stromeinstellenden Widerstand der Platine ab. Die Dokumentation der Bibliothek sagt nur, dass die Versorgung genug Strom für die angeschlossenen Module liefern muss. Was ich aus der Firmware sagen kann: Die Helligkeit ist die Einstellung setIntensity(), 0 bis 15, und der Ticker startet mit 1. Wenn du mehr Platinen verkettest, miss die Stromaufnahme bei deiner Helligkeit mit einem USB-Strommesser, bevor du dem USB-Port eines Laptops vertraust, und lies die Brownout-Anleitung, falls das Board bei hellem Display neu startet. Lange Ketten würde ich über ein ordentliches 5-V-Netzteil mit verbundenen Massen speisen, aber das ist meine Vorliebe, nichts, was ich getestet hätte.
Welche Bibliothek nimmst du für ein ESP32-MAX7219-Display?
Zwei Bibliotheken vom selben Autor, eine auf der anderen. MD_MAX72XX spricht mit den Chips und behandelt die Kette als eine einzige Pixelfläche: Pixel setzen, Bitmap zeichnen, Helligkeit ändern. MD_Parola baut darauf den Text auf: Scrollen, Ausrichtung, Pausen und Animationen, und sie braucht eine installierte MD_MAX72XX. Der Ticker nutzt MD_Parola 3.7.5 und MD_MAX72XX 3.5.1, festgelegt in der platformio.ini, weil er nur Text anzeigt.
Für Text fang mit MD_Parola an. Für Grafik, ein Spiel oder eine eigene Animation nimm MD_MAX72XX direkt. Beide nehmen dasselbe Argument moduleType_t, alles oben Gesagte gilt also für beide. Wenn du noch zwischen dieser Art Display und einem größeren Panel schwankst, vergleicht MAX7219 vs. HUB75 die beiden.
Was haben wir geprüft, und was bleibt offen?
Du hast jetzt die Fünf-Kabel-Belegung für ein FC16-Modul an einem XIAO ESP32-S3, den Code, der es startet, und eine Tabelle, die aus "mein Text ist gespiegelt" den nächsten Typ zum Ausprobieren macht. Die Pins, die festgelegten Bibliotheksversionen und die SPI-Einstellung mit 8 MHz stammen aus den Quellen des Tickers und der Bibliothek. Der Ausgangspegel von 2,64 V stammt aus dem Datenblatt von Espressif, der Eingangspegel von 3,5 V aus dem Datenblatt des MAX7219, Revision 4.
Drei Einschränkungen bleiben. Die 3,3-V-Verdrahtung funktioniert im Ticker, liegt aber unter dem vom Datenblatt garantierten Eingangspegel, ein Pegelwandler ist also die sichere Lösung, wenn es Probleme gibt. Die Symptomtabelle folgt aus den Flags der Bibliothek und wurde nicht an jeder Platinenfamilie getestet. Und Kettenlänge und Strom sind hier über eine einzelne 4-in-1-Platine hinaus ungetestet. Um das ganze Gerät rund um diese Matrix zu sehen, lies den Aufbau des Crypto Tickers, und in CoinGecko-API am ESP32: kostenlose Limits und Abfragerate, wie er seine Preise abruft. Schau dir auch was OpenGizmo ist für die anderen Projekte an.
Haufig gestellte Fragen
Finden Sie schnelle Antworten auf die haufigsten Fragen zu diesem Thema.
Nimm FC16_HW aus der Bibliothek MD_MAX72XX für die verbreiteten 4-in-1-Platinen mit der Aufschrift FC-16 auf der Leiterplatte. Die Firmware des Gizmo Ticker setzt genau diesen Typ. Erscheint der Text trotzdem gespiegelt oder auf dem Kopf, probiere PAROLA_HW, GENERIC_HW oder ICSTATION_HW nacheinander aus und baue neu.
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.







