STM32基于I2C驱动TM1650数码管：从寄存器到调试实践-平芜编程栈

简介：面向STM32嵌入式开发者与单片机初学者的TM1650数码管驱动资源，适用于各类基于STM32的显示需求，解决LED显示模块快速集成问题。代码包含完善的驱动层实现，覆盖GPIO初始化、串行通信时序控制、命令与数据写入等核心环节，可帮助开发者避开底层时序调试弯路。压缩包共2个文件，分别为头文件与源文件，头文件集中定义显示模式、亮度等级及命令字，源文件提供TM1650_Init、WriteCommand、WriteData等接口，整体体积仅2KB，资源包体积小巧，不依赖第三方库，适合资源受限的嵌入式环境与快速原型开发，结构精简可直接嵌入工程。目前已有4966人学习下载，适合智能仪表、小家电等需要显示温度、时间等动态数值的场景。资源经测试验证，调用封装函数即可刷新数码管显示，同时为理解TM1650数据编码与通信协议提供清晰范例，且代码风格清晰、注释明确，便于二次开发与功能扩展，具有较强的参考与复用价值。上周帮朋友调一块TM1650驱动的4位数码管模块，功能逻辑本来都写好了，结果上电就是不亮。总线波形用示波器抓了，SCL、SDA都有信号，ACK也能收到，数据看着也对，但数码管就是没反应。折腾了半天才意识到，TM1650这颗驱动芯片和很多I2C器件不太一样，寄存器要先“开显示”才肯干活，否则你写再多的段码数据它也只当没看见。这种“驱动芯片看似简单、实则细节不少”的体验，估计不少人都经历过。

这篇文章就围绕STM32和TM1650驱动程序展开，把从选型、寄存器理解、代码实现到问题排查的完整链路梳理一遍。不管你是正在调智能台灯、宿舍控制面板，还是毕业设计里需要一块数码管显示模块，只要你用的是STM32，这篇内容应该能帮你少走不少弯路。

1. 为什么选TM1650这颗芯片而不是自己扫描数码管

1.1 动态扫描方案的三个痛点

很多新手拿到4位数码管，第一反应是直接用单片机的GPIO去驱动。LED数码管本身就是一个LED阵列，8字形的每一段都是一颗LED，所以8段数码管加上小数点总共9个IO，4位就是36个IO。就算不计成本用4位一体数码管，段选和位选加起来也要12个引脚，GPIO占用已经非常夸张。

更麻烦的是动态扫描。为了省IO，最简单粗暴的方案就是用74HC595或者其他移位寄存器，把串行数据转成并行输出，段选、位选分时刷新。但动态扫描有一个绕不开的问题：人眼有视觉暂留，想要看到稳定不闪烁的数字，每一路必须在1ms到2ms内刷新一次，4位扫一遍就是4ms到8ms。这意味着单片机必须定时进入中断，把4位段码轮流送出去，而且主程序不能长时间阻塞，否则刷新间隔一旦超过20ms，人眼就会看到明显的闪烁。

我实际调过这种方案，最崩溃的不是代码本身，而是它打乱了整个程序的节奏。比如你同时在做按键消抖、I2C读取传感器、PID计算，任何一个环节卡顿，显示就会闪。尤其当你在调其他功能时，还得不断提醒自己“这个函数不能超过1ms”。这种约束在项目后期会非常烦人。

1.2 TM1650带来的改变与选型对比

第一次接触TM1650的时候，我最大的感受就是：它把“显示刷新”这个脏活累活全部接管了。你只需要通过I2C接口，把要显示的数字段码写进它的寄存器，后面的位选扫描、电流驱动、动态刷新全部由芯片自己完成。CPU彻底从扫描循环里解放出来，哪怕主循环里跑一个200ms的延时，数码管也照样稳定显示。

而且TM1650不只是LED驱动芯片，它还带键盘扫描功能。一个I2C接口，既驱动数码管又能读按键状态，在智能台灯、温控面板这种需要“显示+按键”的场景里非常合适，一路I2C全搞定，不用再额外接矩阵键盘扫描电路。

下面是三种常见数码管驱动方案的对比，我整理的时候顺便把项目里的实际体会也写进去了：

方案	占用IO	CPU工作量	按键支持	实际体验
GPIO动态扫描	12+，或加595后约3~4	高，需定时刷新，实时性要求高	无，需另外扩展	代码简单但后期调试很累
74HC595扩展	3~4	高，扫描逻辑只能自己写	无	适合入门学习，不适合复杂项目
TM1650 I2C驱动	2（SCL/SDA）	极低，写完寄存器就不用管	自带键扫	开发效率高，显示稳定

2. 看懂TM1650的寄存器模型，比抄代码重要

2.1 从机地址与读写方向

TM1650的I2C从机地址在芯片内部是固定的，不能像24C02那样通过A0/A1/A2引脚去改。它的7位从机地址是0x24，换算成8位写地址是0x48，读地址是0x49。这一点看起来简单，但确实是很多人第一个摔跤的地方。

我用STM32标准库调试时，第一次发0x48写地址，ACK应答是正常的，说明地址没写错。但读按键时如果用0x48去读，就会一直卡在读不到数据的死循环里。后来翻手册才发现，I2C读操作要发0x49。就这么一位之差，折腾了我将近一下午。

这里的一个实用经验是：不管抄谁的代码，先确认对方的“设备地址”写的是7位还是8位。很多厂商例程里写的是0x48，这其实是8位写地址；如果把它当成7位地址去处理，左移一位后发出去就变成了0x90，要么收不到ACK，要么操作了错误的从机。STM32的I2C硬件外设有些库函数需要填7位地址，有些需要填8位地址，这是最容易出bug的地方。

2.2 三个关键寄存器

TM1650的寄存器不多，玩明白三个就够用了。我把它们列成一张表，驱动代码其实就是围绕这几个寄存器打转：

寄存器地址	寄存器名称	作用说明
0x48（写）	显示模式寄存器	设置显示位数，低2位：00=4位、01=3位、10=2位、11=1位
0x24（写）	亮度/开关寄存器	bit7是显示总开关，1=开显示；bit2:0是亮度等级0~7
0x68~0x6B（写）	段码数据寄存器	依次对应数码管的第1到第4位，存放要显示的段码
0x48~0x4B（读）	键扫数据寄存器	读模式返回4个键扫数据字节，解析对应按键状态

这里重点说一下0x24寄存器。很多第一次用TM1650的人，段码数据明明写进去了，数码管却不亮，问题就出在这个寄存器上。TM1650上电后显示开关默认是关闭的，你必须先往0x24寄存器写入“开显示”的命令，段码数据寄存器里的内容才会真正被点亮。这个设计其实是为了低功耗考虑，但如果你不知道这一点，很容易陷入“波形正常、数据正常、就是不亮”的怪圈。我帮朋友排查的那个台灯项目，最后定位到的就是这个原因。

2.3 写命令与读键扫的通信时序

TM1650的I2C通信格式和普通EEPROM差异很大。写EEPROM通常是“设备地址+内存地址+数据”，一次操作可以连续写一页数据；但TM1650每次写操作都是“设备地址+寄存器地址+1字节数据”这样固定搭配，想更新多位显示内容，就得连续做多次写操作，每次发送一个寄存器地址和一个数据字节。

很多从其他I2C器件转过来的开发者，会下意识地以为TM1650内部有“地址指针”，发一次地址后可以连续写多个字节，结果发出去之后只有第一个字节生效，后面的数据全丢了。我调试的时候用逻辑分析仪一抓，才发现芯片对寄存器地址的解析方式是“读到地址就锁定目标寄存器，接下来只接受一个数据字节”。

读按键的时序更特殊。它需要先发送写地址0x48，然后发一个键扫寄存器地址0x48，之后重新发起I2C起始信号（也就是重复起始位），再发送读地址0x49，然后才能读取返回的键扫数据。这种“先写后读”的方式，在数据手册里写得很简略，我第一次实现时差点漏掉中间的重复起始信号。

3. 软件模拟I2C驱动完整实现（标准库版）

3.1 为什么我推荐给TM1650用软件模拟I2C

STM32的硬件I2C外设功能是完整的，我用它驱动过很多传感器，稳定可靠。但在TM1650这个场景里，我更推荐软件模拟I2C，因为有两个非常实际的原因。

第一，TM1650的从机地址是固定的0x48，有时候模块厂家做PCB时会把这颗芯片和别的I2C器件挂在同一组总线上。如果你用硬件I2C，就得受限于固定的SCL、SDA引脚，板子布局不够灵活；软件模拟I2C则可以把任意两个GPIO当作SCL和SDA，想挂在哪就挂在哪，板子上哪两个引脚方便就用哪两个。

第二，TM1650的时序虽然兼容标准I2C，但它的数据手册建议波特率不需要太高。软件模拟I2C的时序完全由GPIO翻转和延时决定，遇到某些兼容性不太好的模块时，我可以把延时拉大一点让时序更“宽松”，问题往往就好转了。硬件I2C虽然也能调速率，但改起来要复位外设、重新配置寄存器，调试效率明显低很多。

另外，软件模拟I2C还有一个隐藏的好处：你可以随时用GPIO读取SDA电平，打印中间状态，排查问题的时候比硬件I2C黑盒模式直观太多。尤其对你这种需要跟TM1650打交道的项目，我很推荐先软件模拟，跑通后再考虑优化。

3.2 引脚初始化与时序基础函数

我习惯用PB6做SCL、PB7做SDA，这个组合是STM32上比较常用的模拟I2C引脚对。如果你用的开发板这两个引脚被占用了，换任意两个GPIO都行，只要记得改动宏定义和GPIO配置。

#define TM1650_SCL_H() GPIO_SetBits(GPIOB, GPIO_Pin_6) #define TM1650_SCL_L() GPIO_ResetBits(GPIOB, GPIO_Pin_6) #define TM1650_SDA_H() GPIO_SetBits(GPIOB, GPIO_Pin_7) #define TM1650_SDA_L() GPIO_ResetBits(GPIOB, GPIO_Pin_7) #define TM1650_SDA_READ() GPIO_ReadInputDataBit(GPIOB, GPIO_Pin_7) static void I2C_Delay(void) { uint8_t i = 8; while (i--); }

GPIO初始化时，SCL配置为推挽输出，SDA需要根据读写的不同阶段切换输入输出方向。一个容易被忽略的细节是：SDA在输出模式下建议用推挽输出，而不是开漏输出。原因在于软件模拟I2C时，我们完全掌握SDA的电平变化，用推挽输出可以保证高电平的上升沿干净利落，避免开漏模式下对上拉电阻的依赖。

static void SDA_SetOutput(void) { GPIO_InitTypeDef GPIO_InitStructure; GPIO_InitStructure.GPIO_Pin = GPIO_Pin_7; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP; GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; GPIO_Init(GPIOB, &GPIO_InitStructure); } static void SDA_SetInput(void) { GPIO_InitTypeDef GPIO_InitStructure; GPIO_InitStructure.GPIO_Pin = GPIO_Pin_7; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IPU; GPIO_Init(GPIOB, &GPIO_InitStructure); }

起始信号和停止信号的实现和通用软件I2C一样，我直接贴代码。需要注意的是延时函数要足够稳定，不要在中断里调用这些函数，否则时序会被打断。

static void I2C_Start(void) { SDA_SetOutput(); TM1650_SDA_H(); TM1650_SCL_H(); I2C_Delay(); TM1650_SDA_L(); I2C_Delay(); TM1650_SCL_L(); I2C_Delay(); } static void I2C_Stop(void) { SDA_SetOutput(); TM1650_SDA_L(); TM1650_SCL_H(); I2C_Delay(); TM1650_SDA_H(); I2C_Delay(); }

3.3 写寄存器与显示函数

写寄存器的核心逻辑很简单：起始后发送写地址0x48，等待ACK，然后发送寄存器地址，等ACK，再发送数据字节，等ACK，最后发停止信号。这里的ACK等待一定要加超时机制，不可以无限等待。原因很简单，如果SDA引脚被外部拉低或者模块未接入，程序会永远卡死在等待ACK的死循环里。

我见过不少人在调I2C设备时遇到“程序卡死”，其实就是等待ACK时没有做超时处理。后面第四章调试部分我会专门展开讲这个问题，先看完整代码：

uint8_t TM1650_WriteReg(uint8_t reg_addr, uint8_t data) { uint8_t ret = 0; I2C_Start(); ret |= I2C_WriteByte(0x48); // 写地址 ret |= I2C_WriteByte(reg_addr); // 寄存器地址 ret |= I2C_WriteByte(data); // 数据 I2C_Stop(); return ret; // 0表示成功，非0表示某一步没收到ACK }

配合8段数码管共阴段码表，就能实现数字显示了。TM1650的段码顺序和常见共阴数码管一致，bit0对应a段，bit1对应b段，依次到bit7对应dp段（小数点），所以常用的0~9段码可以照搬。

const uint8_t seg_table[] = { 0x3F, // 0 0x06, // 1 0x5B, // 2 0x4F, // 3 0x66, // 4 0x6D, // 5 0x7D, // 6 0x07, // 7 0x7F, // 8 0x6F, // 9 }; void TM1650_DisplayDecimal(uint16_t value, int8_t dot_pos) { uint8_t buf[4]; buf[0] = value / 1000; // 千位 buf[1] = value / 100 % 10; // 百位 buf[2] = value / 10 % 10; // 十位 buf[3] = value % 10; // 个位 for (int8_t i = 0; i < 4; i++) { uint8_t seg = seg_table[buf[i]]; if (i == dot_pos) { seg |= 0x80; // 点亮对应位的小数点 } TM1650_WriteReg(0x68 + i, seg); } }

这里有一个关于位序的提醒：0x68对应数码管从哪边数起的第几位，不同厂家的模块定义可能不同。买的模块如果接好之后发现数字反过来了，不是芯片坏了，而是0x68~0x6B和实际物理位序的对应关系需要调整，最简单的验证方法是先只写0x68一个寄存器，看是哪一位亮了。

3.4 按键扫描与初始化流程

TM1650的按键扫描读取比显示部分复杂一点。从机读地址是0x49，你需要先发送键扫数据寄存器的起始地址（通常从0x48开始），然后发一个重复起始信号，再切到读方向。返回的数据是4个字节，分别对应芯片扫描到的按键矩阵状态。

如果只是检测某个范围内的按键，可以只读第一个字节，省一点时间。下面是读取键扫第一字节的实现：

uint8_t TM1650_ReadKey(void) { uint8_t key_data = 0xFF; I2C_Start(); if (I2C_WriteByte(0x48)) { I2C_Stop(); return 0xFF; } if (I2C_WriteByte(0x48)) { I2C_Stop(); return 0xFF; } I2C_Start(); // 重复起始 if (I2C_WriteByte(0x49)) { I2C_Stop(); return 0xFF; } key_data = I2C_ReadByte(0); // 最后一个字节回NACK I2C_Stop(); return key_data; }

返回的键扫字节中，每个bit对应一个按键，具体位对应关系需要结合模块原理图确认。比如我的模块上按键接在SEG1和GRID1之间，那么它对应键扫数据字节的bit0；按键接在SEG2和GRID1之间，就对应bit1。模块PCB上通常印有K1、K2之类的丝印，你做一个按键按下去读回来一个数据，写死到代码里就行。

初始化流程上电后建议这样做：

void TM1650_Init(void) { TM1650_WriteReg(0x48, 0x00); // 4位显示模式 TM1650_WriteReg(0x24, 0x81); // 开显示，亮度等级1 }

0x48寄存器写0x00是4位全显示。如果只需要3位，可以改成0x01。0x24寄存器写0x81，bit7是显示总开关，低3位是亮度等级。这里我故意没有用很多例程里常见的0x88写法，因为不同厂家模块对bit3的定义有细微差异，0x81既能保证显示开启，亮度又不会太高。亮度不够的话，可以改成0x82到0x87逐级往上调，反正不会烧芯片。

4. 调试实录：从“不亮”到“稳定显示”的排查过程

4.1 现象一：上电数码管全灭

我帮朋友排查的台灯项目，最开始的现象就是上电数码管全灭。我用示波器测SCL引脚，有方波输出；测SDA引脚，也有信号变化；用逻辑分析仪抓I2C数据，确认了地址0x48、寄存器地址0x68、数据0x06（数字1的段码）都正确传到了总线上。从总线层面看，完全没毛病。

关键的一步是后来我不看数据，改用电压表量TM1650的SEG和GRID引脚，量到SEG引脚电压只有零点几伏，GRID引脚也没有正常的扫描电压输出。这让我意识到芯片根本没进入显示状态，顺着这个思路去查0x24寄存器，才发现显示总开关没有打开。

回过头来分析，问题出在我沿用了之前驱动其他I2C芯片的经验，认为“写入段码数据就一定能显示”。但TM1650的设计是段码数据寄存器和显示输出之间还有一个总开关，上电默认关闭，省电优先。这个坑在TM1650的例程里经常出现，因为很多文档把0x24寄存器叫“亮度寄存器”，让人以为它只控制亮度，忘记了它还承担着显示开关的职责。

4.2 现象二：ST-Link突然连不上目标

还有一个非常吓人的问题，驱动代码写好后烧录了一次，然后ST-Link就再也连不上芯片了，软件报错大概类似“error: no stm32 target found”这样的提示。当时我第一反应是芯片锁死了，但仔细回想发现不是，问题出在GPIO复用冲突上。

我在配置GPIO时，把某几个引脚设置成了推挽输出，而其中恰好有和SWD调试接口复用的引脚。STM32的PA13是SWDIO，PA14是SWCLK，PA15是JTDI，PB3是JTDO/SWO。如果初始化代码里把这些引脚重映射为普通GPIO并使用，调试器自然就没法和内核通信了。

解决办法是把代码里和这些引脚相关的初始化部分全部注释掉，重新烧录前先按住复位键，点击烧录按钮，软件进入连接阶段瞬间再松开复位，让芯片在运行到GPIO配置之前被调试器接管。这个“按住复位再烧录”的技巧，我建议所有玩STM32的人都提前知道，尤其是你手头只有一块核心板的时候。

4.3 现象三：按键误触发与读取值错位

显示正常后，开始调按键。读回来的键扫数据和实际按下的按键对不上，比如我按K1，代码里判定的却是K3，而且有时按一下会连续触发多次。

按键值错位的原因很简单，就是模块厂家在设计PCB时，把K1、K2、K3这些丝印标号和芯片内部键扫寄存器的位没有严格对应。比如我的模块上K1实际接在SEG3和GRID2之间，而不是按顺序接在SEG1上。这就要根据原理图逐个核对，没有捷径。

按键连续触发的问题则出在采样逻辑上。键扫数据寄存器每次读取反映的是瞬时状态，你如果在主循环里不断读它，按下一次键的过程中，程序可能读到了多次“按下”状态。加一个简单的状态机或者延时消抖就能解决，基本思路是：检测到按键变化后，延时10ms再去读一次，确认状态没变才算有效。

4.4 现象四：显示乱码且偶发闪烁

最后一个典型问题是乱码和闪烁。有一次我在一个项目里把TM1650的SCL引脚接到了STM32的某个定时器PWM输出引脚附近，软件模拟I2C的延时函数在定时器中断频繁触发时不稳定，导致数据位被拉长或缩短，TM1650解析段码时就出现了乱码。

这类问题的排查思路是先排除硬件干扰，再看软件时序。我当时的做法是用外接3.3V电源单独给模块供电，排除共地干扰；然后查看GPIO配置，确认SDA和SCL都没有被复用成其他外设引脚；最后把软件模拟I2C的延时函数里的空循环改成关中断保护，确保在传输数据期间不被中断打断，问题就解决了。

另外还有一个非常容易忽略的点：TM1650模块的SDA、SCL两条信号线，必须要有合适的上拉电阻。有些模块板上没配，如果你的STM32内部上拉没有开启或者太弱，波形上升沿就特别缓慢，芯片会误判电平。我的经验是，只要发现波形上升沿超过1us，就先考虑外接一个4.7k的上拉电阻到VCC，大多数兼容性问题都能缓解。

5. 把驱动做得更顺手：扩展、移植与低功耗设计

5.1 小数点、位选与负数显示

小数点显示的方法是段码或上0x80。比如要显示数字3再加上小数点，段码就是0x4F | 0x80，等于0xCF。这个操作在上面的显示函数里已经实现了，但我想展开说的是：如果只有某一位固定需要小数点，比如电压显示“1.23V”这种固定格式，你可以在写入该位段码时固定加上0x80，不需要做成参数。

负数显示稍微有点麻烦。TM1650不带符号位，它只能控制每个数码管的8段，你如果想显示负号，就要把最左边一位的段码直接写成“负号”对应的段码，也就是g段点亮，其他全部熄灭，段码是0x40。然后在显示负数时，根据符号位确定要不要在最左边位写0x40，还是很方便的。

5.2 多片TM1650怎么接

TM1650从机地址是固定的0x48，没法通过硬件引脚去改地址，所以同一组I2C总线上直接挂两片TM1650，两片会同时响应，数据互相干扰。

如果想在一个项目里显示超过4位数字，通常有三种做法。第一种是给两片TM1650分别供电，用MOS管或三极管做电源切换，显示哪一片就给哪一片上电，这种方法功耗可以控制但电路稍复杂。第二种是找两个独立的GPIO端口分别做软件模拟I2C，一片挂一组引脚，这是最简单可靠的软件方案，代价是额外占用2个GPIO。第三种是用带地址配置引脚的同类芯片替代，比如TM1650的兄弟芯片TM1651之类的，但这个要结合实际模块看，不是所有芯片都支持改地址。

我的建议是：如果只是显示6到8位数字，直接用两个GPIO口做两路软件I2C更省事，代码复用性也好，基本不需要改驱动逻辑。

5.3 移植到HAL库和RTOS时的注意事项

如果你用的是STM32CubeMX生成的HAL库工程，移植驱动时只需要把GPIO操作部分和延时部分替换成HAL库对应API，比如GPIO_SetBits改成HAL_GPIO_WritePin。其他I2C时序逻辑不用动，毕竟软件模拟I2C的底层就是GPIO翻转和延时。

在FreeRTOS环境下，有一点必须注意：TM1650的读写操作涉及连续的时序过程，中间不能被任务调度打断。如果某个高优先级任务在TM1650数据传输过程中抢占CPU，I2C波形就乱了。最简单的做法是在TM1650_WriteReg函数开头进入临界区，等停止信号发送完再退出。如果项目里多个任务都会操作数码管，还应该加一个互斥量保护，避免两个任务同时发起显示操作导致数据互相覆盖。

5.4 低功耗场景下的处理

做电池供电的手持设备时，TM1650本身空载功耗不大，但数码管一亮起来电流就不小。4位数码管全部点亮，每个段按2mA算，一个数字最多亮7个段，再算上十进制小数点，整机显示电流轻松超过50mA。

低功耗的思路一般是这样的：进入待机前调用TM1650_WriteReg(0x24, 0x01)，把显示总开关关掉，数码管立刻熄灭；唤醒后再重新写入开显示命令。另外要注意的是，软件模拟I2C的GPIO在待机时不要保持高电平输出，这会通过SDA、SCL引脚给芯片漏电。正确做法是待机前把GPIO全部配置为模拟输入或浮空输入，这样整机电流才能压得下来。