
刚玩 Arduino 的时候,我都想过一个特别朴素的需求:让板子给我显示几个数字。温度也好,倒数也好,总得有个屏。搜了一圈发现,四位数码管是最便宜的选择,可裸接的数码管动不动就要占用十来个 IO 口,杜邦线插得满板都是,看着就头大。
后来才知道有个更聪明的办法:用带 TM1637 驱动芯片的四位数码管模块。四位数、中间还带个冒号,全程只占 Arduino 两个引脚。这篇就把接线、装库、显示数字和时钟冒号的完整流程理一遍,重点标出新手容易卡住的地方。
TM1637 是啥,为什么新手都爱它
先说背景。七段数码管就是把七个 LED 排成一个"8"字,每个 LED 叫一段,用字母 a 到 g 标记。点亮不同的段组合,就能拼出 0 到 9 的数字,讲究一点还能拼出几个字母。裸接的问题是每一段都要单独接线,四位数码管接起来就是一场接线灾难。
TM1637 模块把一块 0.36 英寸的四位七段数码管和一颗 TM1637 驱动芯片做在同一块板上,这颗芯片出自 Titan MicroElectronics。驱动芯片负责扫描刷新和段驱动,你只需要用两根信号线告诉它"显示什么",它能记住数据并自己维持显示,单片机可以去干别的事,不用一直忙着刷新。

供电范围 3.3V 到 5V,接 5V 的 Arduino 和 3.3V 的 ESP32 都行。功耗看点亮多少段和亮度设置,全段最亮时大约 80mA。模块使用自家的一种两线协议,并不是标准 I2C,不过现成的 Arduino 库把底层细节都封装好了,你完全不用操心时序。具体规格里比较关键的几条:工作电压 3.3 至 5VDC,最大电流约 80mA,模块尺寸 42mm x 24mm,字符高度 0.36 英寸。
中间那个冒号值得一提。它平时常亮着显示"00 00"会觉得很怪,但拿来显示时间正好是"12:34"的格式,所以这个模块最常见的归宿就是各种小时钟、倒计时器和计数器。
模块引脚与接线:四根线解决战斗
模块背面引出四个引脚,含义如下:
| 模块引脚 | 作用 | 接 Arduino |
|---|---|---|
| VCC | 供电,3.3V 至 5V | 5V |
| GND | 地线 | GND |
| CLK | 时钟输入 | D3 |
| DIO | 数据输入输出 | D4 |

接线没有任何玄机:两根电源,两根信号。CLK 接数字脚 3,DIO 接数字脚 4,VCC 接 5V,GND 接地,就完成了。下面这张图是完整接法,照着插就行。

有个好消息:这俩信号脚不挑位置,接别的数字脚也能用。唯一的要求是改了接线之后,代码里的引脚号要跟着改。新手最容易栽在"接线改了、代码没改"上,屏幕不亮先别怀疑模块坏了。
装库:认准 Avishay Orpaz 的 TM1637
和 TM1637 通信需要装一个库,最常用的是 Avishay Orpaz 写的 TM1637Display。安装步骤:打开 Arduino IDE,点左侧的库管理器图标,在搜索框输入 tm1637,找到作者为 Avishay Orpaz 的 TM1637 库,点安装。装完就能在示例里看到它的测试程序。
顺手说一句版本选择的事:有资料提到这个库虽然好几年没更新了,但用在 ESP32 上照样稳定,属于典型的"老而靠谱"型库,放心用。
第一个测试程序:一次把数字玩明白
下面的测试程序把常用功能都走了一遍:全亮、0 到 9 计数、负数、补零、指定位显示、中间带冒号的时间,还有自定义段拼符号。可以直接整段复制上传,两分钟左右就能把模块的能力全看一遍。头文件按编译等价写法用双引号引入,效果和尖括号写法一致。
// Include the library
#include "TM1637Display.h"
// Define the connections pins
#define CLK 3
#define DIO 4
// Create a display object of type TM1637Display
TM1637Display display = TM1637Display(CLK, DIO);
// Create an array that turns all segments ON
const uint8_t allON[] = { 0xff, 0xff, 0xff, 0xff };
// Create an array that turns all segments OFF
const uint8_t allOFF[] = { 0x00, 0x00, 0x00, 0x00 };
// Create an array that sets individual segments per digit to display the word "dOnE"
const uint8_t done[] = {
SEG_B | SEG_C | SEG_D | SEG_E | SEG_G, // d
SEG_A | SEG_B | SEG_C | SEG_D | SEG_E | SEG_F, // O
SEG_C | SEG_E | SEG_G, // n
SEG_A | SEG_D | SEG_E | SEG_F | SEG_G // E
};
// Create degree celsius symbol
const uint8_t celsius[] = {
SEG_A | SEG_B | SEG_F | SEG_G, // Degree symbol
SEG_A | SEG_D | SEG_E | SEG_F // C
};
void setup() {
// Set the brightness to 5 (0=dimmest 7=brightest)
display.setBrightness(5);
// Set all segments ON
display.setSegments(allON);
delay(2000);
display.clear();
// Show counter 0-9
int i;
for (i = 0; i < 10; i++) {
display.showNumberDec(i);
delay(50);
}
delay(2000);
display.clear();
display.showNumberDec(-12); // Prints _-12
delay(2000);
display.clear();
display.showNumberDec(-999); // Prints -999
delay(2000);
display.clear();
display.showNumberDec(31, false); // Prints __31
delay(2000);
display.clear();
display.showNumberDec(31, true); // Prints 0031
delay(2000);
display.clear();
display.showNumberDec(14, false, 2, 1); // Prints _14_
delay(2000);
display.clear();
display.showNumberDec(-5, false, 2, 1); // Prints _-5_
delay(2000);
display.clear();
// Prints 12:34
display.showNumberDecEx(1234, 0b01000000, false, 4, 0);
delay(2000);
display.clear();
// Prints 15°C
int temperature = 15;
display.showNumberDec(temperature, false, 2, 0);
display.setSegments(celsius, 2, 2);
delay(2000);
display.clear();
// Prints dOnE
display.setSegments(done);
}
void loop() {
}程序开头几行是套路化的:引入库头文件,用 define 定好 CLK 和 DIO 两个引脚,再创建一个 TM1637Display 对象,创建时把两个引脚号传进去。
#include "TM1637Display.h"
#define CLK 3
#define DIO 4
TM1637Display display = TM1637Display(CLK, DIO);重点认识四个函数。setBrightness 控制亮度,取值 0 到 7,0 最暗 7 最亮。setSegments 用来点亮自定义的段组合,可以指定更新几位、从哪一位开始,位置 0 是最左边的数字,位置 3 是最右边。showNumberDec 是最常用的显示函数,签名是四个参数:数字、是否补前导零、更新几位、从哪位开始。补零这个参数很实用,设 true 时显示 0031,设 false 时只显示空空 31。
display.showNumberDec(31, false); // Prints __31
display.showNumberDec(31, true); // Prints 0031负数它会自己处理减号的位置,比如 -12 显示成"_-12",-999 显示成"-999"。想把数字居中放在屏幕中间,就用后两个参数控制长度和起点,比如 14 从位置 1 开始显示两位,出来的效果就是"_14_"。
点亮冒号:把它变成一个时钟
显示时间靠的是 showNumberDecEx,它是 showNumberDec 的增强版,多出来的第二个参数专门控制冒号和小数点。想显示"12:34",就是把小时乘 100 加上分钟凑成一个四位数 1234,再把冒号位掩码 0b01000000 传进去:
// Prints 12:34
display.showNumberDecEx(1234, 0b01000000, false, 4, 0);这个掩码是个二进制数,每一位对应屏幕上一个点位。不同模块点位排布不一样,对照着用:
| 掩码 | 点亮 | 效果示例 |
|---|---|---|
| 0b10000000 | 第 1 个点 | 1.234 |
| 0b01000000 | 中间点/冒号 | 12.34 或 12:34 |
| 0b00100000 | 第 3 个点 | 123.4 |
| 0b11100000 | 三个点全亮 | 1.2.3.4 |
如果你的模块是冒号型,0b01000000 点亮的就是中间那个冒号;如果是小数点型,点亮的就是中间的点。买模块的时候留意一下描述,冒号版做时钟更顺眼。另外想实现秒闪效果也有现成思路:每秒翻转一次冒号掩码,有冒号和无冒号交替传给 showNumberDecEx,时钟就一闪一闪地走了,这个做法在不少玩家的 NTP 时钟例程里都能见到。
亮度也是玩时钟时经常要动的参数。夜里嫌刺眼就调低,白天看不清就调高。还有个冷门用法:setBrightness(5, false) 的第二个参数传 false 会直接关屏,虽然你传了个亮度值进去,屏幕却是灭的,别被这个组合迷惑。
新手最容易踩的坑
最后把查资料过程中反复出现的几个坑归拢一下,动手前扫一眼能省不少调试时间:
- 接线先查两头。模块不亮时,先确认 VCC 和 GND 没接反、CLK 和 DIO 与代码里的引脚号一致,这是新手问题里占比最高的两类。
- 亮度档位是 0 到 7,不是 0 到 100。写个 50 进去不会报错,但显示会不正常,记住一共就八档。
- 冒号掩码的位置容易搞混。0b01000000 是中间位,别写成 0b10000000,后者点亮的是最左边的点,屏幕上会出现"1.234"而不是"12:34"。
- 供电在 3.3V 到 5V 之间都行,但全段最亮要吃大约 80mA,几个模块一起上的时候别全挤在开发板 3.3V 脚上,必要时用外部供电。
- 六位的数码管模块不是这个玩法。六位款需要换别的库,而且有玩家反馈不少六位模块出厂就有故障,新手第一块模块还是老老实实买四位带冒号的。
整套流程走下来你会发现,TM1637 模块是入门显示器件里门槛最低的一类:四根线、一个库、四个函数,数字和时间就都显示出来了。等这块屏玩熟了,再去折腾 OLED 和点阵屏,心里就有底多了。











亮度只有 0 到 7 这点太真实了,我当年写了 setBrightness(50) 调了半天,还以为模块坏了。
冒号掩码写成 0b10000000 的问题我也踩过,屏幕出来 1.234 蒙了半天,看了这篇才明白点位排布。
这个模块真是新手福音,我第一个小时钟就是用它做的。补充一个细节:showNumberDecEx 的冒号掩码 0b01000000 只对四位带冒号的模块有效,我后来买的点阵版要用 0b11100000 才能全亮三个点,掩码表那张图建议存下来,每次写代码都得翻。
负数显示那段有用,一直以为要自己拼减号,原来 showNumberDec 会自动处理位置。