MAX7219点阵屏Arduino接线与显示教程

2026-11-14 17:58:51 46阅读

给机器人做状态面板、给小车做计分牌、给时钟项目做显示,LED 显示始终是性价比最高的方案。而要在 Arduino 上点亮数码管或者 8x8 点阵,绕不开一颗经典芯片:MAX7219。这次我把两条很扎实的教程底子合在一起理了一遍,把接线、库、代码和几个容易翻车的点讲清楚,新手照着做应该能一次点亮。

MAX7219驱动64颗LED示意图

MAX7219 是个什么芯片

先说为什么选它。一块 8x8 点阵是 64 颗 LED,一个 8 位数码管是 64 个段,如果直接用 IO 口逐个驱动,引脚根本不够分。MAX7219 的思路是把这些 LED 全接到它自己身上,用串行接口通信——DIN、CS(也叫 LOAD)、CLK 三根信号线就够了,Arduino 只负责发指令,扫描刷新这种脏活累活芯片自己干。

按 Maxim Integrated 数据手册的标称:供电 4.0V 到 5.5V,逻辑电平兼容 3.3V 到 5.5V,单路输出电流上限 40mA、峰值 100mA,刷新率指导值 100Hz,16-DIP 封装。常见模块上还带了 8 位数码管或者 8x8 单色点阵,一颗芯片二选一都能带。要注意它上电默认是关断模式,程序里必须先"叫醒"它,这个后面代码里会看到。

接线:VCC、GND、DIN、CS、CLK 五根线

模块的引脚就五个:VCC 接 Arduino 的 5V,GND 接地,剩下三根信号线按你用的库来定。以 8 位数码管那套 max7219 库的接法为例,接线是这样的:

Arduino连接MAX7219八位数码管接线图

ArduinoMAX7219 模块
5VVCC
GNDGND
12DIN
11CS(LOAD)
10CLK

这里有个特别容易踩的坑:不同教程给 CS 和 CLK 分的引脚不一样。max7219 这套是 11 接 CS、10 接 CLK;而下面 LedControl 库的例子是 11 接 CLK、10 接 CS,正好换了个位置。两套代码两套接法,混着接就是黑屏,动手前先确认自己跑的是哪套库的代码。

LedControl 库驱动 8x8 点阵

LedControl库点阵模块接线图

点阵这边先看 LedControl 库,它是专门配合 MAX7219 的老牌库,构造函数四个参数:数据脚、时钟脚、片选脚、级联数量。Robojax 那篇教程用的是 UNO,接线是 VCC 接 5V、GND 接地、DIN 接 12、CLK 接 11、CS 接 10,代码里对应这样建对象:

LedControl lc=LedControl(12,11,10,1);

setup 里三件事是每次都要做的固定动作。MAX72XX 上电处于省电关断模式,先唤醒,再把亮度设个中间值,最后清屏:

lc.shutdown(0,false);
lc.setIntensity(0,8);
lc.clearDisplay(0);

之后就是往点阵上写内容。LedControl 的核心方法是 setRow(器件号, 行号, 行数据),行数据用一个字节的二进制直接表示这一行 8 颗灯的亮灭,比如 0 B11111100 就是高两位灭、后面六位亮。想显示一个字母,就是把它的 8x8 点阵图案拆成 8 个字节逐行写进去,写完停一下、清掉、再写下一个,看起来就是逐个跳出字符。Robojax 的示例就是用这个办法在屏上逐字显示自己的招牌字母,逐行字节都是手排好的图案。

顺便提醒一句,库的例程里构造函数注释写的是"这些引脚号在你的硬件上多半不适用",意思就是引脚随便定、代码里和实物对上就行,不用迷信例程的 12/11/10。

级联四个模块,换 Parola 库滚动文字

四块MAX7219点阵级联接线图

想拼长一点的字幕条,就把多块模块级联:第一块的 DOUT 接第二块的 DIN,信号一路串下去,Arduino 还是那三根线。DroneBot Workshop 那篇用四块 8x8 拼成 8x32,走的是硬件 SPI 引脚(DIN 接 11、CLK 接 13),CS 单独接 10 号之外的数字脚,库里靠器件数量参数自动分片。这套组合配 MD_Parola 库最舒服,文字排版、对齐、滚动都是现成的。代码原样贴在下面(唯一改动是尖括号头文件换成了引号写法,两种写法对库搜索路径等价,因为平台会把尖括号内容剥掉):

/*
  Matrix Display Demo
  matrix-display-demo.ino
  Demonstrates features of 4-element 8x8 LED matrix display

  DroneBot Workshop 2022
  https://dronebotworkshop.com
*/

// Include the required libraries
#include "MD_Parola.h"
#include "MD_MAX72xx.h"
#include "SPI.h"

// Specify display hardware type
#define HARDWARE_TYPE MD_MAX72XX::FC16_HW
//#define HARDWARE_TYPE MD_MAX72XX::GENERIC_HW

// Display Size and CS Pin
#define MAX_DEVICES 4
#define CS_PIN 10

// Create a display object
MD_Parola myDisplay = MD_Parola(HARDWARE_TYPE, CS_PIN, MAX_DEVICES);

void setup() {

  // Intialize the display object
  myDisplay.begin();

  // Set the intensity (brightness) of the display (0-15)
  myDisplay.setIntensity(5);

  // Clear the display
  myDisplay.displayClear();
}

void loop() {

  // Align left
  myDisplay.setTextAlignment(PA_LEFT);
  myDisplay.print("Left");
  delay(2000);

  // Align center
  myDisplay.setTextAlignment(PA_CENTER);
  myDisplay.print("Center");
  delay(2000);

  // Align right
  myDisplay.setTextAlignment(PA_RIGHT);
  myDisplay.print("Right");
  delay(2000);

  // Invert display
  myDisplay.setTextAlignment(PA_CENTER);
  myDisplay.setInvert(true);
  myDisplay.print("Invert");
  delay(2000);

  // Normal text
  myDisplay.setInvert(false);
  myDisplay.print(1234);
  delay(2000);
}

两个参数说一下。HARDWARE_TYPE 是点阵模块的内部走线类型,市面上最常见的 FC16 模块就是 FC16_HW;如果你的屏左右颠倒或者上下镜像,多半是类型选错,换 GENERIC_HW 之类的选项试。MAX_DEVICES 是级联块数,CS_PIN 要和实物接线一致。滚动显示只需在 setup 里多一行:

/*
  Matrix Display Scrolling Demo
  matrix-scroll-demo.ino
  Scrolls text on a 4-element 8x8 LED matrix display

  DroneBot Workshop 2022
  https://dronebotworkshop.com
*/

// Include the required libraries
#include "MD_Parola.h"
#include "MD_MAX72xx.h"
#include "SPI.h"

// Specify display hardware type
#define HARDWARE_TYPE MD_MAX72XX::FC16_HW
//#define HARDWARE_TYPE MD_MAX72XX::GENERIC_HW

// Display Size and CS Pin
#define MAX_DEVICES 4
#define CS_PIN 10

// Create a display object
MD_Parola myDisplay = MD_Parola(HARDWARE_TYPE, CS_PIN, MAX_DEVICES);

void setup() {

  // Intialize the display object
  myDisplay.begin();

  // Set the intensity (brightness) of the display (0-15)
  myDisplay.setIntensity(5);

  // Clear the display
  myDisplay.displayClear();

  // Display our text in a scroll
  myDisplay.displayScroll("Welcome to the Workshop!", PA_CENTER, PA_SCROLL_LEFT, 100);
}

void loop() {

  // Ensure display stays animated
  if (myDisplay.displayAnimate()) {
    myDisplay.displayReset();
  }
}

displayScroll 的四个参数是文字、起始对齐、滚动方向和速度(毫秒)。注意 loop 里必须不停调 displayAnimate(),动画才会一帧帧往下走,忘了这行屏就定格。

数码管显示与亮度、扫描寄存器

数码管和点阵共用同一颗芯片,指令集也一样。用 max7219 那套库驱动 8 位数码管时,写法非常直接,比如右对齐显示一个带小数的温度值:

max7219.DisplayText("95.67F", 1); //Right justified
delay(3000);
max7219.Clear();

第二个参数 1 是右对齐、0 是左对齐,Clear() 清屏。库还提供了 DisplayChar 按位置写单个字符,位置 7 在屏的最左端,从 0 到 7 逐位写就能拼出 HELLO12 3 这类字样。

最后说两个寄存器层面的东西,调不好显示效果的时候用得上。亮度对应的是 intensity 寄存器,LedControl 的 setIntensity(0,8) 和 Parola 的 setIntensity(5) 里那个数字都是 0 到 15 档,不是百分比——8 只是中等亮度,晚上觉得刺眼就往下调。另一个是扫描位数寄存器(scan limit),它控制芯片扫描 8 位里的前几位;如果级联后某几块屏不亮或者数码管只有部分位在显,除了检查接线,也可以往这个寄存器的配置上想。芯片靠高速分时扫描点亮 LED,数据手册给的 100Hz 刷新率就是为了让人眼看不出闪烁,这也是为什么芯片烫一点是正常的——它在不停开关所有灯。

写在最后

整套东西便宜、耐造、三根线搞定,是很适合练手的入门外设。我的建议是:单块点阵用 LedControl 理解原理,多块级联上 Parola 省事,数码管直接用现成的 8 位模块。最常见的三种故障——整屏不亮查 VCC/GND 和唤醒那句 shutdown,显示错乱查 HARDWARE_TYPE,级联断亮查 DOUT 到下一块 DIN 的那根线。按这个顺序排,基本五分钟内能定位。


作者:固件烧录仔
链接:https://www.aiddithome.com/p/163246a647eb85.html
本作版权归作者所有,未经允许请勿转载。若存在违规行为,您可以点击 “举报”。


登录 后发表评论
4条评论
拆开看看再说
1楼 · 2026-11-14 17:59:17

scan limit 这个寄存器以前一直没搞明白,原来级联后部分位不亮还跟它有关,学到了。

刷视频进来围观
2楼 · 2026-11-14 17:59:17

三根线点亮 64 个灯,这芯片确实经典,便宜又耐造,玩 Arduino 的绕不开。

触底反弹的Tony
3楼 · 2026-11-14 17:59:16

这块板子我去年给小车做过计分牌,文章里说的 CS 和 CLK 引脚两套接法不一样那个坑我踩过,当时就是照抄另一篇教程的接法跑 LedControl 的代码,结果屏全黑,排查半天发现是库和接线没对上。后来学乖了,先看代码里构造函数的引脚顺序,再回头核接线,一次点亮。另外 FC16 那个 HARDWARE_TYPE 确实关键,显示镜像颠倒基本就是它的问题。

深圳打工人Alan
4楼 · 2026-11-14 17:59:16

上周刚买了四块点阵准备拼字幕条,Parola 那段滚动代码来得正好,直接抄作业了。