MAX7219 FC16 e ESP32: collegamenti, 3,3 V, testo specchiato
Collega una matrice MAX7219 FC16 a un ESP32 con cinque fili, verifica i 3,3 V di logica e correggi il testo specchiato con il tipo hardware di MD_MAX72XX.
- Autore
Mauro Brambilla- Pubblicato
- Tempo di lettura
- 11 min
- Categoria
- Build

In breve
Un modulo MAX7219 FC16 si collega a un ESP32 con cinque fili: 5 V, GND, DIN, CS e CLK. Scegli FC16_HW in MD_MAX72XX; testo specchiato o invertito vuol dire che il tipo hardware non corrisponde alla tua scheda.
Un modulo FC16 MAX7219 4-in-1 si collega a un ESP32 con cinque fili: 5 V, GND, DIN, CS e CLK. Lo piloti con la libreria MD_MAX72XX e imposti il tipo hardware su FC16_HW. Se il testo compare specchiato, capovolto o nell'ordine sbagliato, il tipo hardware non corrisponde alla tua scheda, e cambiarlo è la soluzione.
Questo è il riferimento mirato dietro il Gizmo Ticker, che fa girare una matrice FC16 su una XIAO ESP32-S3. I pin e le versioni delle librerie vengono dal suo firmware, la tabella dei tipi viene dal sorgente di MD_MAX72XX e le misure dei componenti vengono dalle mie note sulle parti. La build completa, con flash e chiave API, è nella guida alla build del crypto ticker.
Un display per criptovalute connesso al WiFi, realizzato con ESP32, matrice LED MAX7219 e web app Nuxt 4 configurabile dal browser.
- Ticker di criptovalute in tempo reale
- Matrice LED MAX7219
- Configurazione via web
Che cos'è un modulo FC16 MAX7219 4-in-1?
Il MAX7219 è un chip driver che accende fino a 64 LED, cioè una matrice 8x8, da un breve bus seriale, e si può mettere in catena con altri MAX7219 (pagina del prodotto su Analog Devices). Un modulo FC16 è la scheda comune che ne mette in catena quattro per te: quattro matrici rosse 8x8, ognuna con il suo MAX7219, su un unico PCB lungo. La documentazione di MD_MAX72XX dice che si riconosce un FC-16 dalla scritta "FC-16" stampata sul PCB e che la maggior parte dei set da quattro moduli venduti come un pezzo unico sono di questo tipo (pagina FC-16).
Su quello che uso per il ticker, il PCB misura 132 x 32 mm e i blocchi LED coprono tutta la lunghezza, anche se quattro blocchi da 32 mm farebbero solo 128 mm. I venditori non sono d'accordo sulla lunghezza (da 128 a 132 mm), quindi misura il tuo prima di progettarci intorno qualcosa. I pin dritti sporgono di circa 7 mm a ogni estremità. Questi numeri vengono dalle mie note su questa scheda, misurati e confermati sulle stampe di prova del ticker.
Come si collega un ESP32 a un modulo MAX7219 FC16?
Ti servono i cinque pin del lato ingresso del modulo: VCC, GND, DIN, CS e CLK. La libreria li chiama così: DIN è l'ingresso dei dati seriali, CLK scandisce i dati e CS (chiamato LD nella documentazione della libreria) seleziona l'intera catena, e i dati vengono memorizzati quando torna alto (note sui collegamenti della libreria). L'altro lato della scheda ha DOUT, che alimenta il modulo successivo, quindi lascialo stare.

Ecco la mappa dei pin che usa il Gizmo Ticker. I numeri GPIO sono quelli del chip, mentre le etichette D sono i nomi dei pad della XIAO, spiegati nella guida al pinout della XIAO ESP32-S3.
| Ingresso FC16 | Pad XIAO ESP32-S3 | GPIO ESP32-S3 | Ruolo |
|---|---|---|---|
| VCC | 5V | nessuno | Alimentazione della matrice |
| GND | GND | nessuno | Massa |
| DIN | D10 | GPIO9 | Dati SPI in uscita (MOSI) |
| CS | D9 | GPIO8 | Chip select |
| CLK | D8 | GPIO7 | Clock SPI (SCK) |
I pad accanto a 5V e GND seguono l'ordine dell'ingresso del modulo, quindi un cavo piatto va dritto da una parte all'altra e il filo 3V3 resta libero. Su qualsiasi altra scheda ESP32 scegli tre GPIO liberi qualsiasi: la libreria ha un costruttore che prende direttamente i pin dati, clock e CS, e un altro che usa l'SPI hardware della scheda. L'SPI hardware è più veloce, e la documentazione della libreria descrive la versione software come più lenta.
Ecco il vero codice di setup del ticker, da 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 matrixDue dettagli contano. Il -1 significa "niente MISO", perché il display non rimanda mai nulla indietro, e questo libera D9 perché faccia da CS. La costante HARDWARE_TYPE è MD_MAX72XX::FC16_HW, definita in config.h. Il sorgente di MD_MAX72XX 3.5.1 avvia ogni transazione SPI a 8 MHz in modalità 0, che è sotto il limite di clock di 10 MHz del datasheet del MAX7219, ma conviene tenerlo a mente se i tuoi fili sono lunghi.
Se non usi la XIAO, la stessa idea sta in poche righe. Questo sketch minimo segue il setup del ticker e l'API documentata della libreria, con i pin del ticker; non ho compilato proprio questo sketch, quindi consideralo un punto di partenza e cambia i tre numeri dei pin con quelli della tua scheda:
#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();
}Prima di festeggiare, alimenta la scheda e cerca un testo qualsiasi. Un display spento con i collegamenti giusti è un problema diverso dal testo specchiato, e le prossime sezioni li affrontano uno alla volta.
La logica a 3,3 V funziona con una scheda MAX7219 a 5 V?
Di solito sì, in pratica, ma è fuori da ciò che il datasheet garantisce. La matrice funziona a 5 V, mentre i GPIO dell'ESP32 segnalano a 3,3 V, quindi conta se un livello alto a 3,3 V venga riconosciuto come alto dal MAX7219.
I numeri, dalle fonti primarie:
| Fonte | Parametro | Valore | Condizioni |
|---|---|---|---|
| Datasheet MAX7219 | Tensione d'ingresso logica alta (VIH), DIN, CLK, CS | 3,5 V minimo | V+ = 5 V, più o meno 10% |
| Datasheet MAX7219 | Tensione d'ingresso logica bassa (VIL) | 0,8 V massimo | V+ = 5 V, più o meno 10% |
| Datasheet MAX7219 | Tensione di alimentazione operativa | da 4,0 a 5,5 V | nessuna |
| Datasheet ESP32-S3 v2.2 | Tensione d'uscita di livello alto (VOH) | 0,8 x VDD minimo, 2,64 V a 3,3 V | VDD = 3,3 V, 25 C |
Entrambi vengono dai produttori: il datasheet dell'ESP32-S3 di Espressif (tabella 5-4) e il datasheet del MAX7219 di Maxim, revisione 4. La pagina di Analog Devices dedicata al chip non si è caricata quando ho controllato questo articolo, quindi ho letto la stessa revisione da una copia ospitata da SparkFun; la pagina del prodotto su Analog Devices potrebbe indicarne una più recente.
Quindi il livello alto garantito dell'ESP32-S3 (2,64 V) è sotto il minimo garantito del MAX7219 (3,5 V). I datasheet non promettono che funzioni. Quello che fa il Gizmo Ticker si vede chiaramente dal suo repository: DIN, CS e CLK vanno direttamente dai pin a 3,3 V della XIAO alla matrice, che sta sul pad 5V, senza level shifter. Il README documenta i collegamenti e non fornisce un'analisi dei margini, e non dichiaro nessun test oltre questo. I chip veri spesso commutano sotto il livello garantito, ma non puoi contarci con un lotto diverso, un cavo lungo o un'alimentazione rumorosa.
Se vedi caratteri casuali, sfarfallio o pixel a caso, metti un level shifter sulle tre linee di segnale (DIN, CS, CLK). Basta che funzioni in una direzione sola, perché il display non risponde mai. Il rischio inverso in questo cablaggio non esiste: gli ingressi dell'ESP32-S3 tollerano al massimo VDD più 0,3 V, ma nessun filo porta dati dalla matrice all'ESP32. La stessa domanda salta fuori con un backpack I2C a 5 V in ESP32 con LCD I2C 16x2 che non funziona. Controlla anche l'alimentazione, come spiega la guida al brownout dell'ESP32.
Perché il testo del mio MAX7219 è specchiato o invertito?
Ogni scheda in stile FC16 ha gli stessi chip, ma il collegamento tra la matrice LED e il MAX7219 cambia da una famiglia di schede all'altra. La documentazione di MD_MAX72XX dice che i circuiti sono sostanzialmente gli stessi e che la differenza sta in come la matrice è cablata al chip, cosa che la libreria gestisce via software con un valore moduleType_t (pagina sull'hardware).

Ogni tipo è una combinazione di tre interruttori, descritti nella pagina dei nomi strutturati: DR (cifre come righe), CR (colonne invertite) e RR (righe invertite). Così li imposta il sorgente 3.5.1 in setModuleParameters():

| Tipo hardware | Cifre come righe (DR) | Colonne invertite (CR) | Righe invertite (RR) | Nome strutturato |
|---|---|---|---|---|
| FC16_HW | sì | no | no | DR1CR0RR0 |
| GENERIC_HW | no | sì | no | DR0CR1RR0 |
| PAROLA_HW | sì | sì | no | DR1CR1RR0 |
| ICSTATION_HW | sì | sì | sì | DR1CR1RR1 |
Le inversioni di colonne e righe agiscono su un blocco 8x8 alla volta: il sorgente mappa un pixel su COL_SIZE - 1 - c e ROW_SIZE - 1 - r, dove entrambe le dimensioni valgono 8. Quindi correggono i glifi specchiati o capovolti dentro ogni blocco. La tabella qui sotto è la mia lettura di quei flag, non un test al banco, quindi trattala come una breve lista di cose da provare per prime, un tipo per ogni build.
| Cosa vedi | Quale interruttore è probabilmente sbagliato | Prova questo |
|---|---|---|
| Ogni lettera specchiata da sinistra a destra, ma dritta | Colonne invertite (CR) | Passa da FC16_HW a PAROLA_HW, che differisce solo per CR |
| Ogni lettera capovolta dall'alto in basso | Righe invertite (RR) | Usa il nome strutturato DR1CR0RR1_HW, che nella libreria non ha un alias |
| Ogni lettera ruotata di 180 gradi | CR e RR insieme | Prova ICSTATION_HW, che è FC16_HW con entrambe le inversioni aggiunte |
| Lettere di lato o rimescolate | Cifre come righe (DR) | Prova GENERIC_HW, poi lancia l'esempio HW_Mapper |
L'ordine dei moduli è una questione separata dalle tre inversioni. La pagina FC-16 della libreria dice che il display è orientato con il lato DIN a destra, e la pagina dei nomi strutturati dice che i moduli sono in catena da destra a sinistra. Avverte anche che il testo stampato sul PCB può apparire capovolto, quindi giudica la scheda da ciò che mostrano i LED, non dalla serigrafia. Le mie note sulle parti danno per buono lo stesso layout con DIN a destra per il ticker e lo segnano come ancora aperto: non l'ho confermato su ogni scheda. Se intere parole escono nell'ordine sbagliato dei moduli, controlla di aver collegato i pad d'ingresso (DIN) e non quelli d'uscita (DOUT), e che il numero di moduli nel codice corrisponda a quello reale.
Se nessun tipo con nome funziona, la libreria include un'utility chiamata MD_MAX72xx_HW_Mapper: lanciala con un solo modulo e ti stampa a quale cifra e segmento appartiene ogni pixel acceso, così puoi costruire il nome DR#CR#RR#_HW giusto. La libreria avverte che le combinazioni senza alias non sono garantite se non vengono provate.
Si può correggere via software? MD_Parola ha gli effetti di zona PA_FLIP_UD e PA_FLIP_LR, impostati con setZoneEffect(). Il suo header dice che PA_FLIP_UD funziona con ogni effetto di testo, ma PA_FLIP_LR non funziona con SCROLL_LEFT, SCROLL_RIGHT o SLICE, e il ticker scorre verso sinistra (PA_SCROLL_LEFT in config.cpp). Per un display a scorrimento, lo specchio da sinistra a destra si risolve con il tipo hardware, non con un flip.
Nel Gizmo Ticker questo significa modificare la riga HARDWARE_TYPE in config.h e compilare il firmware da solo. La release da flashare dal browser è fissa su FC16_HW.
Perché la mia matrice MAX7219 è spenta, fioca o mostra caratteri a caso?
Un display FC16 spento o rumoroso è quasi sempre un problema di alimentazione, di collegamenti o di mancata corrispondenza tra codice e scheda, e l'ordine qui sotto va dal controllo più economico a quello più laborioso. Cambia una cosa alla volta.
| Cosa vedi | Causa probabile | Cosa controllare |
|---|---|---|
| Non si accende niente | Niente alimentazione, nessuna massa in comune o lato sbagliato collegato | 5 V su VCC, GND unita a quella dell'ESP32, fili sui pad d'ingresso, non su DOUT |
| Non si accende niente, ma i collegamenti sembrano giusti | CS o numero di moduli diversi dal codice | Il pin CS nel costruttore corrisponde al filo CS, e il numero di moduli è 4 per scheda |
| Testo molto tenue | Intensità impostata bassa | setIntensity() accetta da 0 a 15, e il valore predefinito del ticker è 1 |
| Pixel casuali, sfarfallio o caratteri a caso | Logica a 3,3 V al limite o alimentazione debole | Level shifter su DIN, CS e CLK, fili più corti, un'alimentazione a 5 V stabile |
| Il testo è leggibile ma specchiato o capovolto | Tipo hardware sbagliato | La tabella dei sintomi nella sezione sullo specchio qui sopra, un tipo alla volta |
Il datasheet del MAX7219 indica una tensione di alimentazione operativa da 4,0 a 5,5 V, quindi una matrice collegata al pad 3V3 è sotto il suo intervallo. Il ticker tiene libero quel pad proprio per questo. La guida al brownout dell'ESP32 copre il caso in cui a resettarsi è l'intera scheda.
Come si mettono in catena i moduli MAX7219, e quanta corrente serve?
Una catena è una linea di shift register: DOUT di un modulo va a DIN del successivo, mentre CS e CLK sono condivisi da tutti. Le note sui collegamenti della libreria dicono che i dati vengono spostati in un registro a 16 bit e memorizzati sul fronte di salita del segnale di load, e che la linea CS seleziona l'intera catena. Una scheda FC16 mette già in catena i suoi quattro moduli; per allungare il display, collega i pad d'uscita di una scheda ai pad d'ingresso della successiva.
Dici alla libreria quanti moduli 8x8 ci sono, e il resto viene da sé. Il Gizmo Ticker salva quel numero nella flash e accetta da 4 a 32 a passi di 4, perché le schede arrivano da 4-in-1. Il valore predefinito è 4, una scheda, che è anche quello per cui è disegnato il case. Il firmware si riavvia dopo che cambi il numero, perché l'oggetto display viene creato una sola volta all'avvio.
Sulla corrente non ho un numero misurato per la scheda FC16. Il repository del ticker non ne riporta nessuno, e nemmeno le mie note sulle parti. Il datasheet del MAX7219 dà un caso peggiore per un chip: fino a 330 mA con ogni segmento acceso a 40 mA, e una scheda FC16 ha quattro chip, quindi il tetto si moltiplica, ma l'assorbimento reale dipende dall'impostazione di luminosità e dalla resistenza di regolazione della corrente della scheda stessa. La documentazione della libreria dice solo che l'alimentazione deve fornire corrente sufficiente per i moduli collegati. Quello che posso dire dal firmware: la luminosità è l'impostazione setIntensity(), da 0 a 15, e il ticker parte da 1. Se metti in catena più schede, misura l'assorbimento con un misuratore USB alla tua luminosità prima di fidarti della porta di un portatile, e leggi la guida al brownout se la scheda si resetta quando il display diventa luminoso. Alimenterei le catene lunghe con un vero alimentatore a 5 V con le masse unite, ma è una mia preferenza, non qualcosa che ho testato.
Quale libreria scegliere per un display MAX7219 su ESP32?
Due librerie dello stesso autore, una sopra l'altra. MD_MAX72XX parla con i chip e tratta la catena come un'unica superficie di pixel: imposti un pixel, disegni una bitmap, cambi l'intensità. MD_Parola costruisce il testo sopra: scorrimento, allineamento, pause e animazioni, e richiede che MD_MAX72XX sia installata. Il ticker usa MD_Parola 3.7.5 e MD_MAX72XX 3.5.1, bloccate in platformio.ini, perché mostra solo testo.
Per il testo, parti da MD_Parola. Per grafica, un gioco o un'animazione personalizzata, usa direttamente MD_MAX72XX. Entrambe accettano lo stesso argomento moduleType_t, quindi tutto quanto detto sopra vale per l'una e per l'altra. Se stai ancora scegliendo tra questo tipo di display e un pannello più grande, MAX7219 vs HUB75 li confronta.
Che cosa abbiamo verificato, e che cosa resta aperto?
Ora hai la mappa a cinque fili per un modulo FC16 su una XIAO ESP32-S3, il codice che lo avvia e una tabella che trasforma "il mio testo è specchiato" nel prossimo tipo da provare. I pin, le versioni bloccate delle librerie e l'impostazione SPI a 8 MHz vengono dai sorgenti del ticker e della libreria. Il livello d'uscita di 2,64 V viene dal datasheet di Espressif, e il livello d'ingresso di 3,5 V dal datasheet del MAX7219, revisione 4.
Restano tre limiti. Il cablaggio a 3,3 V funziona nel ticker ma sta sotto il livello d'ingresso garantito dal datasheet, quindi un level shifter è la soluzione sicura quando fa i capricci. La tabella dei sintomi deriva dai flag della libreria e non è stata provata su ogni famiglia di schede. E lunghezza della catena e corrente non sono state testate qui oltre una singola scheda 4-in-1. Per vedere l'intero dispositivo costruito attorno a questa matrice, leggi la build del crypto ticker, e API CoinGecko su ESP32: limiti gratuiti e frequenza di polling per come ne recupera i prezzi. Dai un'occhiata anche a che cos'è OpenGizmo per gli altri progetti.
Domande frequenti
Trova risposte rapide alle domande più comuni su questo argomento.
Usa FC16_HW nella libreria MD_MAX72XX per le comuni schede 4-in-1 con la scritta FC-16 sul PCB. Il firmware del Gizmo Ticker imposta proprio quello. Se il testo risulta comunque specchiato o capovolto, prova uno alla volta PAROLA_HW, GENERIC_HW o ICSTATION_HW e ricompila.
Autore
Mauro BrambillaPronto a costruire il tuo gizmo?
Scegli un progetto ESP32 open source e segui la sua guida passo passo, dalla lista dei componenti e dai collegamenti fino al firmware e al primo avvio.







