Aprender

Uma matriz de LEDs MAX7219 no Arduino, com uma bola quicando nela

Intermediário

Ou veja todas as aulas.

  • 526componentes na bancada
  • 46placas rodando agora
  • 1.00xtempo real, em todas as placas
Arduino Uno: bola na matriz com um MAX7219ao vivo0.000 s 0.00x
Clique para abrir no editor
O exemplo da bola na matriz em um ATmega328P simulado. A bola quica, e cada parede que ela atinge acende por um quadro.

Sessenta e quatro LEDs precisariam de sessenta e quatro pinos se você os ligasse um por um, e um Arduino Uno tem vinte. O MAX7219 é o chip que resolve isso: ele fica na parte de trás dos módulos baratos de matriz vermelha 8x8, recebe três fios da placa e faz a varredura dos sessenta e quatro LEDs sozinho. O circuito acima é um Uno quicando um ponto de dois por dois em uma dessas matrizes, rodando no seu navegador com o mesmo sketch que você pode ler abaixo.

Cada vez que a bola bate em uma parede, essa borda inteira acende por um quadro e o brilho aumenta, então o quique é algo que você vê, e não algo em que só acredita. Abra no editor e você pode mudar a velocidade, o tamanho da bola ou o que ela desenha.

O que você precisa

  • Um Arduino Uno
  • Um módulo de matriz de LEDs 8x8 com um MAX7219 atrás (do tipo vermelho comum)
  • Cinco fios jumper, fêmea para macho se o módulo tiver pinos de cabeçalho
  • Uma protoboard para os trilhos de alimentação (opcional)

Ligação

Componente e pinoVai paraNota
VCC do módulo5 VO MAX7219 precisa de 4 a 5,5 volts, então use 5 V, não 3,3 V
GND do móduloGNDCompartilhado com a placa
DIN do móduloPino 11Entrada de dados serial
CS do móduloPino 10Marcado LOAD em alguns módulos; sua borda de subida trava um pacote
CLK do móduloPino 13O clock de deslocamento
Módulo DOUTDIN do próximo móduloUsado apenas quando você encadeia uma segunda matriz

Como o MAX7219 desenha uma imagem

O chip guarda oito registradores de oito bits cada, um registrador por linha da matriz. Um bit 1 é um LED aceso e um bit 0 é um apagado, com o bit 7 como a coluna mais à esquerda. Então a imagem inteira são oito bytes, e mudar uma linha do display é escrever um byte em um registrador. O chip então acende as linhas uma de cada vez, rápido o bastante para o seu olho ver todas as oito de uma vez.

A comunicação com ele é um pacote de dezesseis bits: baixe CS, envie um endereço de registrador e um byte de dados por DIN e CLK, e levante CS. A borda de subida de CS é o que faz o chip agir sobre o pacote. Os registradores 1 a 8 são as linhas; os outros definem o brilho (dezesseis níveis), quantas linhas escanear, se decodifica dígitos e se o chip está desligado.

Esse último pega todo mundo uma vez. Na inicialização todo registrador é zero, o que significa desligado, uma linha escaneada e brilho mínimo. Uma matriz que fica apagada quase sempre é um sketch que nunca escreveu nos registradores Shutdown, Scan Limit e Intensity. A chamada begin() no sketch faz exatamente isso.

O sketch, quadro a quadro

O driver mantém os oito bytes das linhas na RAM do Uno. O loop move a bola um pixel, quica em qualquer parede que ela alcançou, limpa o buffer, desenha a bola com fillRect, desenha uma linha ao longo de qualquer parede que foi atingida e chama show(), que envia todas as oito linhas ao chip. Depois espera 90 milissegundos, então a bola se move cerca de onze vezes por segundo.

Manter a imagem na RAM e enviá-la de uma vez é o padrão que toda biblioteca de matriz usa. Isso significa que desenhar é só definir bits em um array, e a parte lenta, a transferência serial, acontece uma vez por quadro em vez de uma vez por pixel.

A parte de desenho do loop, do exemplo Matrix ball
matrix.clear();
if (flash & 0x01) matrix.fillRect(0, 0, 8, 1, true);  // top wall
if (flash & 0x02) matrix.fillRect(7, 0, 1, 8, true);  // right wall
if (flash & 0x04) matrix.fillRect(0, 7, 8, 1, true);  // bottom wall
if (flash & 0x08) matrix.fillRect(0, 0, 1, 8, true);  // left wall
matrix.fillRect(x, y, BALL, BALL, true);
matrix.show();

// A bounce is also a flicker of brightness, which costs one packet.
matrix.setIntensity(flash ? 15 : 8);
delay(FRAME_MS);

O auxiliar, e a biblioteca que você usaria em um Uno real

O exemplo inclui mokxi_max7219.h, um pequeno driver que acompanha o Mokxi: Max7219 matrix(DIN, CS, CLK, blocks), depois begin(), setPixel(), fillRect(), text() e show(). Em uma placa real a escolha usual é a biblioteca LedControl do Gerenciador de Bibliotecas do Arduino, que o Mokxi também inclui como LedControl.h, ou MD_MAX72XX para texto rolante em vários módulos.

Com LedControl a mesma configuração é LedControl lc(11, 13, 10, 1), depois lc.shutdown(0, false), lc.setIntensity(0, 8) e lc.clearDisplay(0) em setup(), e lc.setLed(0, row, column, true) ou lc.setRow(0, row, value) para desenhar. Note a ordem dos pinos: LedControl recebe dados, clock e depois CS, enquanto o driver do Mokxi recebe dados, CS e depois clock. Errar essa ordem é o motivo mais comum de um primeiro sketch de matriz não mostrar nada.

Os pinos 11 e 13 também são os pinos de hardware SPI do Uno (MOSI e SCK), e é por isso que a maioria dos diagramas de ligação os usa. Uma biblioteca que usa hardware SPI precisa de DIN no 11 e CLK no 13; CS pode ser qualquer pino.

Experimente no editor

Mude FRAME_MS de 90 para 30 e a bola acelera. Mude BALL para 1 e ela se torna um único pixel que alcança todos os quadrados.

Substitua a bola por texto: matrix.text(0, 0, "A") desenha uma letra da fonte 5x7 incluída. Depois tente uma carinha como oito bytes, um por linha, escritos com setPixel em dois loops.

Defina a propriedade count do módulo como 4 e o último argumento do construtor como 4, e o mesmo código ganha um letreiro de 32 por 8 para trabalhar, que é o que são os módulos quatro em um vendidos para texto rolante.

Onde comprar os componentes

O módulo de matriz vermelha pronto com o MAX7219 já na parte de trás é vendido sob muitas marcas genéricas, geralmente em pacotes, nos grandes marketplaces on-line. Se você preferir montar, a Adafruit vende o chip MAX7219CNG sozinho e uma matriz vermelha miniatura de 8x8 que o acompanha. SparkFun e DigiKey também têm matrizes de LED e chips de driver; procure MAX7219 nos catálogos deles. Os links para as páginas da Adafruit estão nas fontes abaixo. Essas são lojas dos EUA, citadas como exemplos. Os preços e o estoque variam por país, então fora dos EUA procure o mesmo nome de componente em uma loja de eletrônica local ou em uma loja on-line que entregue no seu endereço.

Erros comuns

Matriz apagada após o upload. O chip liga desativado e com brilho mínimo. Confira se o seu setup escreve Shutdown como desligado, um scan limit de 7 e uma intensidade.

A imagem espelhada ou girada. Os módulos são fabricados em orientações diferentes. Inverta a coordenada x ou y no seu código em vez de religar os fios.

CS e CLK trocados. A ordem dos pinos no construtor varia entre bibliotecas, como acima.

Alimentar vários módulos pelo pino de 5 V do Uno. Um módulo com brilho moderado funciona bem; uma cadeia de quatro com muitos LEDs acesos pode puxar mais do que o regulador da placa ou uma porta USB deve fornecer. Dê a uma cadeia longa uma fonte própria de 5 V com o terra compartilhado.

Abra este circuito no editor. Arduino Uno: bolinha em matriz com MAX7219, ligado como aparece rodando no topo desta página. Troque um componente ou um valor e rode de novo.

Abrir o circuito

Perguntas

Quantos pinos uma matriz MAX7219 precisa em um Arduino?

Três pinos de sinal (DIN, CS e CLK), além de 5 V e terra. Mais módulos se encadeiam nesses mesmos três pinos, do DOUT de um para o DIN do próximo.

Qual biblioteca devo usar para um MAX7219 em um Arduino de verdade?

LedControl é a mais simples para pixels individuais e linhas. MD_MAX72XX, com MD_Parola por cima, é a escolha habitual para texto rolante em vários módulos. O Mokxi usa seu próprio cabeçalho pequeno, mokxi_max7219.h, e também inclui o LedControl.h.

O Mokxi mostra a multiplexação do MAX7219?

Não. Um chip real acende uma linha por vez a cerca de 800 Hz; o modelo mostra todas as linhas ativadas de uma vez, e a intensidade funciona como brilho em vez de corrente. Os registradores, o estado ao ligar e o encadeamento são os do chip.

Monte isto de verdade

Abra o editor, mude um valor e veja o número mudar junto. Nada para instalar, e não precisa de conta.