TM1637 四位数码管接 Arduino:显示数字与时间

2026-11-10 13:11:43 85阅读 所属项目:ESP32 开发板

TM1637 四位数码管模块与 Arduino 实拍

刚玩 Arduino 的时候,我都想过一个特别朴素的需求:让板子给我显示几个数字。温度也好,倒数也好,总得有个屏。搜了一圈发现,四位数码管是最便宜的选择,可裸接的数码管动不动就要占用十来个 IO 口,杜邦线插得满板都是,看着就头大。

后来才知道有个更聪明的办法:用带 TM1637 驱动芯片的四位数码管模块。四位数、中间还带个冒号,全程只占 Arduino 两个引脚。这篇就把接线、装库、显示数字和时钟冒号的完整流程理一遍,重点标出新手容易卡住的地方。

TM1637 是啥,为什么新手都爱它

先说背景。七段数码管就是把七个 LED 排成一个"8"字,每个 LED 叫一段,用字母 a 到 g 标记。点亮不同的段组合,就能拼出 0 到 9 的数字,讲究一点还能拼出几个字母。裸接的问题是每一段都要单独接线,四位数码管接起来就是一场接线灾难。

TM1637 模块把一块 0.36 英寸的四位七段数码管和一颗 TM1637 驱动芯片做在同一块板上,这颗芯片出自 Titan MicroElectronics。驱动芯片负责扫描刷新和段驱动,你只需要用两根信号线告诉它"显示什么",它能记住数据并自己维持显示,单片机可以去干别的事,不用一直忙着刷新。

TM1637 驱动芯片特写

供电范围 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 至 5V5V
GND地线GND
CLK时钟输入D3
DIO数据输入输出D4

TM1637 模块引脚定义图

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

TM1637 模块与 Arduino 接线图

有个好消息:这俩信号脚不挑位置,接别的数字脚也能用。唯一的要求是改了接线之后,代码里的引脚号要跟着改。新手最容易栽在"接线改了、代码没改"上,屏幕不亮先别怀疑模块坏了。

装库:认准 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 和点阵屏,心里就有底多了。


作者:菜鸟也想玩
链接:https://www.aiddithome.com/p/4a61755446aa6.html
本作版权归作者所有,未经允许请勿转载。若存在违规行为,您可以点击 “举报”。


登录 后发表评论
4条评论
拆开看看再说
1楼 · 2026-11-10 13:12:27

亮度只有 0 到 7 这点太真实了,我当年写了 setBrightness(50) 调了半天,还以为模块坏了。

修啥都行二哥
2楼 · 2026-11-10 13:12:27

冒号掩码写成 0b10000000 的问题我也踩过,屏幕出来 1.234 蒙了半天,看了这篇才明白点位排布。

老张装机
3楼 · 2026-11-10 13:12:26

这个模块真是新手福音,我第一个小时钟就是用它做的。补充一个细节:showNumberDecEx 的冒号掩码 0b01000000 只对四位带冒号的模块有效,我后来买的点阵版要用 0b11100000 才能全亮三个点,掩码表那张图建议存下来,每次写代码都得翻。

板砖搬不动
4楼 · 2026-11-10 13:12:26

负数显示那段有用,一直以为要自己拼减号,原来 showNumberDec 会自动处理位置。