零基础学 Arduino(二):点阵模块
上一篇学了 8 个核心 API 和 LED/按键/旋钮,这篇我们玩点阵屏——用 8×8 的 LED 点阵显示图案和动画。
1. 你手上的硬件
| 硬件 | 作用 |
|---|---|
| Arduino UNO R3 | 主控 |
| 幻尔扩展板 | 插在 UNO 上方,方便接线 |
| TM640B 8×8 点阵模块 | 本篇主角——64 颗 LED 排成 8 行 8 列 |
2. 认识点阵模块
LED点阵模块采用的是一款LED 点阵屏显示模块,具有显示亮度高,显示时无闪烁,接线方便等特点,可以显示数字、文本、图案等内容。该模块由两个红色 8x8LED灯珠组成,通过驱动控制芯片TM640B,可实现对点阵屏的控制。
接线方式如下图:
1 根4PIN线,对照上图接到扩展板对应引脚即可。
4. 安装 TM16xx 库
TM640B 兼容 TM1640 芯片协议,需要安装 TM16xx 库:
- IDE 菜单栏:工具 → 管理库
- 搜索框输入
TM16xx - 找到 “TM16xx by maxint-rd”,点击安装
装完后,文件 → 示例 → TM16xx → TM1640_basic 里能看到官方示例。
5. 核心 API(TM16xx 库)
5.1 创建对象
#include <TM1640.h>
#include <TM16xxMatrix.h>
// TM1640(数据脚, 时钟脚) —— 没有 CS 脚!
TM1640 module(12, 11);
// 包装成点阵对象(芯片对象, 列数, 行数)
TM16xxMatrix matrix(&module, 8, 8);
5.2 初始化
void setup() {
module.setupDisplay(true, 5); // 激活 + 亮度 0~7(5 中等)
matrix.setAll(false); // 清屏
}
5.3 点亮/熄灭一个灯
matrix.setPixel(列, 行, true); // 点亮 (列,行)
matrix.setPixel(列, 行, false); // 熄灭 (列,行)
// 列和行都是 0~7(不是 1~8!)
// 注意:列在前,行在后!
5.4 显示一行(自建函数)
TM16xx 没有内置 setRow,自己写一个循环即可:
void setRow(int row, byte data) {
for (int col = 0; col < 8; col++) {
bool on = bitRead(data, 7 - col); // 从高位到低位对应第 0~7 列
matrix.setPixel(col, row, on);
}
}
5.5 显示一列
void setColumn(int col, byte data) {
for (int row = 0; row < 8; row++) {
bool on = bitRead(data, 7 - row);
matrix.setPixel(col, row, on);
}
}
6. 实战示例
示例 1:点亮一个角上的灯
#include <TM1640.h>
#include <TM16xxMatrix.h>
TM1640 module(12, 11);
TM16xxMatrix matrix(&module, 8, 8);
void setup() {
module.setupDisplay(true, 5);
matrix.setAll(false);
}
void loop() {
matrix.setPixel(0, 0, true); // 左上角亮
delay(500);
matrix.setPixel(0, 0, false); // 灭
delay(500);
}
示例 2:跑马灯——一行接一行亮
#include <TM1640.h>
#include <TM16xxMatrix.h>
TM1640 module(12, 11);
TM16xxMatrix matrix(&module, 8, 8);
void setup() {
module.setupDisplay(true, 5);
matrix.setAll(false);
}
void setRow(int row, byte data) {
for (int col = 0; col < 8; col++) {
matrix.setPixel(col, row, bitRead(data, 7 - col));
}
}
void loop() {
for (int row = 0; row < 8; row++) {
setRow(row, B11111111); // 整行全亮
delay(200);
setRow(row, B00000000); // 整行灭
}
}
B11111111 是二进制写法,8 个 1 代表 8 颗 LED 全亮。试试改成 B10101010 看看效果。
示例 3:显示一个心形图案
用 8 个字节定义心形:
● ○ ○ ○ ○ ○ ○ ● → B10000001
● ● ○ ○ ○ ○ ● ● → B11000011
● ● ● ○ ○ ● ● ● → B11100111
● ● ● ● ● ● ● ● → B11111111
● ● ● ● ● ● ● ● → B11111111
○ ● ● ● ● ● ● ○ → B01111110
○ ○ ● ● ● ● ○ ○ → B00111100
○ ○ ○ ● ● ○ ○ ○ → B00011000
#include <TM1640.h>
#include <TM16xxMatrix.h>
TM1640 module(12, 11);
TM16xxMatrix matrix(&module, 8, 8);
// 心形图案,每一行用一个字节表示
byte heart[8] = {
B10000001,
B11000011,
B11100111,
B11111111,
B11111111,
B01111110,
B00111100,
B00011000
};
void setRow(int row, byte data) {
for (int col = 0; col < 8; col++) {
matrix.setPixel(col, row, bitRead(data, 7 - col));
}
}
void setup() {
module.setupDisplay(true, 5);
matrix.setAll(false);
}
void loop() {
for (int row = 0; row < 8; row++) {
setRow(row, heart[row]); // 逐行写入图案
}
}
把 heart 数组里的值改掉,就能显示你自己设计的图案。B10000001 意思就是:亮-灭-灭-灭-灭-灭-灭-亮。
示例 4:循环动画——从左到右移动的光点
#include <TM1640.h>
#include <TM16xxMatrix.h>
TM1640 module(12, 11);
TM16xxMatrix matrix(&module, 8, 8);
void setColumn(int col, byte data) {
for (int row = 0; row < 8; row++) {
matrix.setPixel(col, row, bitRead(data, 7 - row));
}
}
void setup() {
module.setupDisplay(true, 5);
matrix.setAll(false);
}
void loop() {
for (int col = 0; col < 8; col++) {
matrix.setAll(false);
setColumn(col, B11111111); // 点亮一整列
delay(100);
}
}
7. API 速查(TM16xx 库)
| API | 作用 | 示例 |
|---|---|---|
module.setupDisplay(true, n) |
激活模块 + 设置亮度 n=0~7 | module.setupDisplay(true, 5); |
matrix.setAll(false) |
清空全部 LED | matrix.setAll(false); |
matrix.setAll(true) |
全部 LED 点亮 | matrix.setAll(true); |
matrix.setPixel(c, r, 1) |
点亮第 c 列第 r 行 | matrix.setPixel(3, 2, true); |
matrix.setPixel(c, r, 0) |
熄灭第 c 列第 r 行 | matrix.setPixel(3, 2, false); |
setRow(r, data) |
整行写入(自建函数) | setRow(0, B10101010); |
setColumn(c, data) |
整列写入(自建函数) | setColumn(5, B11111111); |
注意:setPixel 先列后行(0~7),和 MAX7219 的 setLed(先行后列)顺序不同!



