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.

Pubblicato
Tempo di lettura
11 min
Categoria
Build
Una ragazza con lo chignon e una giacca di jeans tiene un cacciavite accanto a una matrice LED rossa a quattro moduli che mostra HELLO, collegata a una scheda ESP32.

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.

Progetto open-source ESP32 + MAX7219
Gizmo 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
Dagli un'occhiata

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.

Cinque fili dai pad della XIAO ESP32-S3 all'ingresso FC16: 5V a VCC, GND a GND, D10 a DIN, D9 a CS, D8 a CLK, con 3V3 non collegato

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 FC16Pad XIAO ESP32-S3GPIO ESP32-S3Ruolo
VCC5VnessunoAlimentazione della matrice
GNDGNDnessunoMassa
DIND10GPIO9Dati SPI in uscita (MOSI)
CSD9GPIO8Chip select
CLKD8GPIO7Clock 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:

microcontroller/src/matrix/matrix.cpp
microcontroller/src/matrix/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 matrix
Riga 3, col. 1UTF-8cpp

Due 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:

max7219_hello.ino
max7219_hello.ino
#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();
}
Riga 20, col. 1UTF-8cpp

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:

FonteParametroValoreCondizioni
Datasheet MAX7219Tensione d'ingresso logica alta (VIH), DIN, CLK, CS3,5 V minimoV+ = 5 V, più o meno 10%
Datasheet MAX7219Tensione d'ingresso logica bassa (VIL)0,8 V massimoV+ = 5 V, più o meno 10%
Datasheet MAX7219Tensione di alimentazione operativada 4,0 a 5,5 Vnessuna
Datasheet ESP32-S3 v2.2Tensione d'uscita di livello alto (VOH)0,8 x VDD minimo, 2,64 V a 3,3 VVDD = 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).

Una matrice LED a quattro moduli mostra FC16_HW? specchiato, mentre il maker tiene una lente che mostra il testo dritto

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():

Tabella dei quattro tipi hardware con nome di MD_MAX72XX e dei loro tre interruttori: FC16_HW solo cifre come righe, GENERIC_HW solo colonne invertite, PAROLA_HW cifre come righe e colonne invertite, ICSTATION_HW tutti e tre

Tipo hardwareCifre come righe (DR)Colonne invertite (CR)Righe invertite (RR)Nome strutturato
FC16_HWsìnonoDR1CR0RR0
GENERIC_HWnosìnoDR0CR1RR0
PAROLA_HWsìsìnoDR1CR1RR0
ICSTATION_HWsì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 vediQuale interruttore è probabilmente sbagliatoProva questo
Ogni lettera specchiata da sinistra a destra, ma drittaColonne invertite (CR)Passa da FC16_HW a PAROLA_HW, che differisce solo per CR
Ogni lettera capovolta dall'alto in bassoRighe invertite (RR)Usa il nome strutturato DR1CR0RR1_HW, che nella libreria non ha un alias
Ogni lettera ruotata di 180 gradiCR e RR insiemeProva ICSTATION_HW, che è FC16_HW con entrambe le inversioni aggiunte
Lettere di lato o rimescolateCifre 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 vediCausa probabileCosa controllare
Non si accende nienteNiente alimentazione, nessuna massa in comune o lato sbagliato collegato5 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 giustiCS o numero di moduli diversi dal codiceIl pin CS nel costruttore corrisponde al filo CS, e il numero di moduli è 4 per scheda
Testo molto tenueIntensità impostata bassasetIntensity() accetta da 0 a 15, e il valore predefinito del ticker è 1
Pixel casuali, sfarfallio o caratteri a casoLogica a 3,3 V al limite o alimentazione deboleLevel shifter su DIN, CS e CLK, fili più corti, un'alimentazione a 5 V stabile
Il testo è leggibile ma specchiato o capovoltoTipo hardware sbagliatoLa 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.

Pubblicato

Pronto 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.

Leggi anche

Esplora le categorie