基于STM32和CH455的数码管驱动：从CubeMX配置到HAL库实现

简介：STM32Cube HAL库环境下的CH455驱动四位数码管代码，面向熟悉STM32基础、需要快速集成数码管显示功能的嵌入式开发者。压缩包内共2个文件，分别是一个C源文件和一个H头文件，C文件实现IIC读写时序和显示函数，H文件则定义引脚宏、命令字等参数，整体大小仅2KB，结构非常精简。CH455通过IIC接口驱动数码管，SDA和SCL引脚可在CubeMX中自定义，只需将引脚标签改为TUF_SDA、TUF_SCL，并同步修改头文件中注释指示的引脚宏即可完成配置，适配不同STM32型号的灵活性较强。使用时在main.c中添加TUF_DPY_Write_Cmd(CH455_SYSON)开启键盘显示，再调用TUF_DPY_SHOW_NUM(float num)即可直接显示数值，代码封装了底层时序和控制逻辑，开发者无需关心具体IIC协议细节，也便于学习HAL库下IIC外设编程。目前已有1660人学习下载，对于需要快速验证CH455驱动或希望复用这套轻量级驱动的项目而言，能明显缩短调试周期。

1. 项目概述与选型思路

1.1 为什么选择CH455这颗芯片

做单片机项目碰到数码管显示，大多数人第一反应是直接用MCU的GPIO动态扫描。但如果你用的是STM32，而且项目里已经跑着I2C、UART、ADC这些外设，再让CPU去干数码管扫描这种脏活累活，其实挺亏的。更麻烦的是，动态扫描有严格的时序要求，一旦中断响应不及时，数码管亮度就会不均匀，甚至出现肉眼可见的闪烁。

CH455是沁恒推出的一颗I2C接口数码管驱动芯片，单个芯片就能驱动4位共阴数码管，还内置了键盘扫描功能。当初我选它，理由很直接：项目里已经有一路I2C总线闲着，挂上CH455只需要占用两个引脚，MCU侧只需按格式发送显示数据，剩下的扫描工作全部由芯片内部完成。相比MAX7219这类SPI接口的驱动芯片，CH455的优势是I2C总线可以挂多个从设备，而且芯片和数码管之间不需要外接限流电阻，它内部有恒流驱动。

还有一个容易被忽略的点：CH455的价格比MAX7219便宜不少，批量采购时一颗就差好几毛钱，做产品的人会懂这个差异意味着什么。而且它对共阴数码管做了专门的扫描电流优化，亮度均匀性实测比GPIO扫描好一个档次。

1.2 本文能帮你解决什么问题

这篇文章适合两类人：一是第一次接触CH455，想快速跑通显示功能，没有耐心翻那份有点绕的数据手册的；二是已经在用STM32CubeMX和HAL库开发，但不确定I2C驱动CH455时地址怎么填、显存格式怎么转换的。

我会从CubeMX工程配置讲起，给出完整的HAL库驱动代码，再把段码转换和显示函数封装好，最后把调试过程中遇到的坑和排查方法整理成清单。你照着做，从零到数码管正常显示，半小时内应该能搞定。

2. CH455核心原理与显存格式详解

2.1 芯片引脚和I2C地址

CH455的封装是SOP16，引脚不算多，但有几个关键的要说清楚。SEG0~SEG7是段驱动输出，对应数码管的a到g和小数点dp；DIG0~DIG3是位选输出，接4位数码管的公共端。对于共阴数码管来说，DIG输出的是低电平选中，SEG输出的是高电平点亮对应段，方向感一定要先建立起来，后面查问题能省不少时间。

I2C地址是很多人第一道坎。CH455的7位从机地址由AD0、AD1引脚电平决定，默认悬空或接地时是0x24。在HAL库的HAL_I2C_Master_Transmit函数里，DevAddress参数填的是7位地址，也就是直接填0x24，HAL库内部会自动左移一位并拼上读写标志位。但网上很多老代码填的是0x48，那是8位写地址，因为在标准外设库的某些版本里需要填完整地址。如果你搬代码的时候没注意这一点，会发现I2C始终回NACK。

2.2 系统命令与显示命令

CH455的命令分成两大类，通过写入的字节来区分。系统命令用来做全局控制，比如显示使能、亮度调节、消隐、闪烁等，命令码是0x01，后面跟一个参数字节。显示命令用来加载8个字节的段数据，命令码是0x02，后面跟上8个字节的显存数据。

系统命令参数字节的位定义要记一下：bit0是显示使能，写1打开显示，写0关闭显示；bit1是消隐控制；bit2是闪烁控制；bit3是测试模式；bit5和bit4组合成两位亮度等级，00最暗，11最亮。上电之后CH455默认是显示关闭状态，很多人写完代码发现数码管没反应，其实不是驱动没写对，而是忘了发这个打开显示的系统命令。

发送方式是普通的I2C写操作，先发地址0x24，再发命令码，再发参数。完整调用HAL库就是一次HAL_I2C_Master_Transmit，把命令码和参数打包成一个数组发出去。

2.3 段优先格式的显存排列

这是CH455和很多其他驱动芯片最大的不同，也是新手最容易绕晕的地方。CH455的显存是8个字节，排列方式不是按数码管位来排的，而是按段来排的。具体说，显存第0字节对应段a，第1字节对应段b，一直到第7字节对应小数点dp；每个字节的低4位分别对应4位数码管，bit0是第1位（最左边），bit3是第4位（最右边）。

我打个比方：普通段码表是按“位”组织的，每位数码管一个字节，比特位代表段的亮灭；CH455是反过来的，按“段”组织，每段一个字节，比特位代表是哪一位数码管。所以你要显示的数字先用共阴段码表查出来，再做一个矩阵转置，把位优先的数据转换成段优先的数据，才能正确写入CH455。

这个转换逻辑用代码实现起来并不复杂，关键是要把两层循环的对应关系理清楚：外层循环遍历8个段，内层循环遍历4个数码管位，然后把每个位对应段码的那个bit取出来，填到正确的字节和位上去。

3. STM32CubeMX工程搭建

3.1 基本配置步骤

我用的是STM32F103C8T6这颗最经典的芯片，你手里如果是F4系列或者G0系列，操作路径基本一致。打开STM32CubeMX，芯片型号选STM32F103C8Tx，首先配置RCC，HSE选择Crystal/Ceramic Resonator；然后SYS选择Serial Wire，这样保留SWD调试口；接着配置I2C1，模式选I2C，速度默认100kHz可以工作，但CH455支持到400kHz，我建议直接选Fast Mode拿400kHz，显示刷新更顺滑。

时钟树不用太纠结，如果外部晶振是8MHz，直接让CubeMX自动生成72MHz主频配置就行。CH455的I2C通信对时钟精度没有苛刻要求，PLL出来多少都能正常工作，I2C外设自己会做分频和时序控制。

最后Project Manager里选择生成工程，Toolchain选MDK-ARM，如果还没装STM32CubeIDE，直接用Keil也完全没问题。如果你是刚接触STM32CubeIDE，想改中文界面的话，在安装目录里的STM32CubeIDE.ini文件加上-Duser.language=zh，重启软件就是中文菜单了，这个后面再说。

3.2 硬件连接与上拉电阻

连接关系很简单：CH455的SCL接STM32的PB6（I2C1_SCL），SDA接PB7（I2C1_SDA），VCC接3.3V或5V都可以，CH455的宽压范围是3V到5.5V，但如果MCU是3.3V系统，建议统一用3.3V供电，避免I2C电平不匹配。GND共地。AD0和AD1直接接地，拿到默认地址0x24。DIG0~DIG3分别接数码管的1到4位公共端，SEG0~SEG7接数码管的a到g和dp，这里要注意把段和数码管的引脚对应关系记好，别接反了。

I2C总线需要外接上拉电阻的事我得多说一句。STM32的I2C引脚内部有弱上拉，但驱动强度不够，多设备共总线或者线长了容易通信不稳定。我在面包板调试时就吃过这个亏，SCL、SDA各接一个4.7k欧电阻到3.3V，问题立刻消失。时序不稳定表现很随机，有时候是偶尔显示错乱，有时候是第一次上电能行，复位后就不行了，非常折腾人，先把上拉电阻接上再说。

4. HAL库驱动CH455完整实现

4.1 驱动头文件与基础函数

驱动代码不用写得很花哨，核心就是几个函数：初始化、写系统命令、写显存数据、显示数字、清屏。我直接把代码贴出来，每个函数的注释都标注清楚。

// ch455.h #ifndef __CH455_H #define __CH455_H #include "main.h" #define CH455_I2C_ADDR 0x24 // 7位I2C地址，AD0/AD1接地 #define CH455_CMD_SYS_CTRL 0x01 // 系统控制命令 #define CH455_CMD_DISP_DATA 0x02 // 显存数据加载命令 // 系统控制参数位定义 #define CH455_DISP_ON 0x01 // 显示使能 #define CH455_DISP_OFF 0x00 // 显示关闭 #define CH455_BLANKING 0x02 // 消隐 #define CH455_FLICKER 0x04 // 闪烁 #define CH455_TEST_MODE 0x08 // 测试模式 #define CH455_BRIGHTNESS_0 0x00 // 亮度最低 #define CH455_BRIGHTNESS_1 0x10 #define CH455_BRIGHTNESS_2 0x20 #define CH455_BRIGHTNESS_3 0x30 // 亮度最高 void CH455_Init(void); void CH455_WriteSysCmd(uint8_t param); void CH455_WriteDisplay(uint8_t seg_data[8]); void CH455_ShowNumber(uint16_t value, uint8_t dot_mask); void CH455_Clear(void); #endif

这里有个设计上的小考虑：写系统命令时命令码固定是0x01，所以我把命令码封装进到函数内部，只对外暴露参数。调用方只需要关心要设置成什么状态，不用每次记得命令码是多少。显示数据加载命令同理，CH455_WriteDisplay函数内部会把命令码0x02和8字节数据拼成一个数组。

4.2 初始化与显存写入

// ch455.c #include "ch455.h" #include "i2c.h" // 共阴数码管段码表：0~9, A~F static const uint8_t SEG_CODE[16] = { 0x3F, 0x06, 0x5B, 0x4F, 0x66, 0x6D, 0x7D, 0x07, 0x7F, 0x6F, 0x77, 0x7C, 0x39, 0x5E, 0x79, 0x71 }; static void CH455_WriteBuf(uint8_t *buf, uint8_t len) { HAL_I2C_Master_Transmit(&hi2c1, CH455_I2C_ADDR, buf, len, 100); } static void CH455_WriteSysCmd(uint8_t param) { uint8_t buf[2]; buf[0] = CH455_CMD_SYS_CTRL; buf[1] = param; CH455_WriteBuf(buf, 2); } static void CH455_WriteDisplay(uint8_t seg_data[8]) { uint8_t buf[9]; buf[0] = CH455_CMD_DISP_DATA; for (uint8_t i = 0; i < 8; i++) { buf[i + 1] = seg_data[i]; } CH455_WriteBuf(buf, 9); } void CH455_Init(void) { // 打开显示，设置亮度为最高档 CH455_WriteSysCmd(CH455_DISP_ON | CH455_BRIGHTNESS_3); } void CH455_Clear(void) { uint8_t zero[8] = {0}; CH455_WriteDisplay(zero); }

重点看CH455_WriteDisplay，一次I2C传输把9个字节（1个命令码加8个数据字节）全发出去，中间不需要Stop再Start。CH455的设计允许在单次传输中连续加载全部显存，效率很高。HAL库的HAL_I2C_Master_Transmit天然支持这种多字节传输，你不需要手动控制起始停止条件，它内部会处理好。

超时参数我填的是100毫秒，对这个应用来说足够了。I2C总线400kHz下传9个字节大约只需要0.2毫秒，100毫秒的超时余量非常充足，就算总线被其他设备阻塞也能等一阵子才报错。我不建议为了显得精简把超时设成1或10，万一总线上有其他设备临时拉低时钟，超时太短容易返回错误码，排查起来又得看代码。

4.3 数字显示与段码转换

显示数字是核心应用逻辑，这里要把前面讲的段优先显存格式用代码实现出来。

void CH455_ShowNumber(uint16_t value, uint8_t dot_mask) { uint8_t digit[4]; uint8_t seg_data[8] = {0}; uint8_t code[4]; // 拆分为4位数字，digit[0]是千位，digit[3]是个位 digit[0] = (value / 1000) % 10; digit[1] = (value / 100) % 10; digit[2] = (value / 10) % 10; digit[3] = value % 10; // 查段码表 for (uint8_t i = 0; i < 4; i++) { code[i] = SEG_CODE[digit[i]]; } // 段优先转换：seg_data[0]对应段a，bit0对应第1位 for (uint8_t seg = 0; seg < 8; seg++) { for (uint8_t pos = 0; pos < 4; pos++) { if (code[pos] & (1 << seg)) { seg_data[seg] |= (1 << pos); } } } // 处理小数点：dot_mask的bit0对应第1位（千位），bit3对应第4位（个位） for (uint8_t pos = 0; pos < 4; pos++) { if (dot_mask & (1 << pos)) { seg_data[7] |= (1 << pos); } } CH455_WriteDisplay(seg_data); }

我详细解释一下这个转换过程，因为这里最容易出错。假设你要显示数字1234，无小数点。先查段码表得到4个字节：1的段码0x06、2的段码0x5B、3的段码0x4F、4的段码0x66。现在进入双重循环，seg=0的时候处理的是段a：第1位数字1的段码0x06的bit0是0，所以不置位；第2位数字2的段码0x5B的bit0是1，所以seg_data[0]的bit1置1；第3位数字3的段码0x4F的bit0是1，所以bit2置1；第4位数字4的段码0x66的bit0是0，不置位。这样seg_data[0] = 0b00000110，表示段a点亮的是第2位和第3位。这个结果和实际数字2、3的段a都需要点亮完全一致。

小数点单独处理在seg_data[7]，也就是dp段，bit位置关系和数字位一一对应。dot_mask这个参数设计成位掩码的好处是调用起来直观，比如想在千位显示小数点就传0x01，想全部显示小数点就传0x0F。

4.4 负数与特殊字符处理

CH455_ShowNumber只处理了无符号整数，实际项目中经常会遇到负数和带符号的数据。处理思路也不复杂，先把负号映射成段码0x40，也就是g段单独点亮，然后根据数值大小决定显示格式。

void CH455_ShowSigned(int16_t value, uint8_t dot_mask) { uint8_t digit[4]; uint8_t code[4] = {0}; if (value < 0) { // 千位显示负号，其余位显示绝对值 digit[1] = (abs(value) / 100) % 10; digit[2] = (abs(value) / 10) % 10; digit[3] = abs(value) % 10; code[0] = 0x40; // 负号就是g段点亮 } else if (value >= 1000) { // 超过1000直接显示4位数字 digit[0] = (value / 1000) % 10; digit[1] = (value / 100) % 10; digit[2] = (value / 10) % 10; digit[3] = value % 10; } else { // 小于1000时高位消隐，更美观 digit[0] = 0; digit[1] = (value / 100) % 10; digit[2] = (value / 10) % 10; digit[3] = value % 10; } for (uint8_t i = 0; i < 4; i++) { if (digit[i] < 10) { code[i] = SEG_CODE[digit[i]]; } } uint8_t seg_data[8] = {0}; for (uint8_t seg = 0; seg < 8; seg++) { for (uint8_t pos = 0; pos < 4; pos++) { if (code[pos] & (1 << seg)) { seg_data[seg] |= (1 << pos); } } } for (uint8_t pos = 0; pos < 4; pos++) { if (dot_mask & (1 << pos)) { seg_data[7] |= (1 << pos); } } CH455_WriteDisplay(seg_data); }

高位消隐这个细节比较实用。显示温度比如23度，如果直接补0显示成0023，观感上不够专业；消隐掉前导零后只显示两位数，看起来清爽多了。这里还有个约束：负号占了千位，所以负数的可显示范围是-999到-1，绝对值超过999就溢出显示不下了，适合的应该考虑调整单位，比如显示成-1.23k这样的格式。

5. 应用层实现与效果扩展

5.1 温度监测显示完整案例

驱动层写完后，应用层用起来就非常简单了。我拿一个实际的温度监测项目举例：STM32的ADC采集NTC热敏电阻分压值，换算成温度后送给CH455显示，同时当一个开关量触发时，让数码管闪烁提示。

ADC采集和温度换算不是本文重点，直接给出调用部分：

// 假设adc_value已经通过HAL_ADC_GetValue获取 float temp = NTC_GetTemperature(adc_value); // 返回实际温度，比如26.3 int16_t temp_int = (int16_t)(temp * 10); // 变成263 uint8_t dot = 0x02; // 希望显示"26.3"，小数点在十位 CH455_ShowSigned(temp_int, dot); // 需要闪烁告警时，通过系统命令控制 if (over_temp_flag) { CH455_WriteSysCmd(CH455_DISP_ON | CH455_FLICKER | CH455_BRIGHTNESS_2); } else { CH455_WriteSysCmd(CH455_DISP_ON | CH455_BRIGHTNESS_3); }

亮度和闪烁可以直接通过系统命令动态切换，这个灵活性是GPIO扫描方案不好实现的。GPIO扫描想实现闪烁，要么在定时器中断里翻转消隐标志，要么在循环里延时，都是占用CPU的做法。CH455只要一条I2C命令，芯片自己就把闪烁周期控制好了。

5.2 倒计时器与数码管轮询

再举一个倒计时器的例子。用一个16位变量存剩余秒数，定时器中断里每秒自减，主循环里调用显示函数刷新。CH455的显存不会自动清零，所以每次进入中断只更新显存数据，显示结果一直保持，CPU可以安心去处理其他任务，不用担心数码管亮度闪烁。这和GPIO动态扫描比起来，优势是质的飞跃。

如果你需要显示的位数超过4位，比如6位或8位，可以把两个CH455挂到同一根I2C总线上，AD0和AD1配成不同地址即可。分时刷新两片芯片不会有冲突，HAL库的I2C调用天然保证了总线互斥。实测刷新频率在100Hz以上不会有视觉闪烁感，应用上完全够用。

5.3 驱动移植到其他STM32系列

这套驱动代码的移植性做得比较干净，和具体芯片相关的只有hi2c1这个句柄和I2C初始化。如果你的项目用的是I2C2，把ch455.c里引用的hi2c1改成hi2c2，然后在CubeMX里把I2C2配置好就行。如果你是PY32F003这类国产Cortex-M0+芯片，只要它的HAL库兼容ST的API风格，驱动代码同样可以复用。

我之前在PY32F003上移植过一次，碰到的唯一问题是I2C时钟频率配置。PY32的I2C外设时钟源和STM32不完全一样，CubeMX生成的初始化代码在RCC配置上略有差异，但驱动层的调用方式完全一致。如果遇到I2C通信不稳定，第一步检查时钟树，第二步检查上拉电阻，不要急着怀疑驱动代码。

6. 排查实录与避坑指南

6.1 I2C通信类问题

I2C通信异常是最常见的，我按崩溃概率排序整理了一张排查表。

排查I2C问题时我的做法是先写一个扫描函数，把0x24到0x27全部发一遍地址字节，看看哪个能收到ACK。这一步能快速排除地址错误问题。如果全部NACK，再用示波器或逻辑分析仪看SCL、SDA波形，确认起始条件、地址字节、ACK位是否正常。

一个隐蔽的坑是芯片焊接问题，特别是SOP16这种引脚间距不大的封装，手工焊接时相邻引脚容易桥连。CH455的SCL和SDA如果被锡桥短路，I2C怎么调都通不了，用万用表蜂鸣档测引脚间阻值，能快速发现桥连。

6.2 显示异常和亮度问题

显示全亮或者全灭，先检查是不是系统命令没把显示使能打开。我在代码里CH455_Init做了这个操作，但如果你把Init函数放在I2C还没初始化好的地方调用，命令发不出去，数码管自然不亮。调用顺序必须是CubeMX生成的MX_I2C1_Init()先执行，然后才能调用CH455_Init()。

显示乱码通常就是段码转换关系的bit错位。比如把共阴段码表误用了共阳的，数字会显示得杂乱无章。有一个快速判断方法：单独把seg_data[0]设为0x0F，如果4位数字的a段全亮，说明段对应关系正确；如果亮的不是a段，检查SEG0~SEG7的接线是否对应数码管的a到g。

亮度不理想的时候，先看系统命令的亮度位是不是设在最高档。CH455的亮度调节分成4级，从0到3，如果觉得最高档还是不够亮，检查数码管是不是共阴的——这个芯片只能驱动共阴，接共阳数码管只会得到一团糟或者完全不亮。另外CH455内部集成了恒流驱动，不需要外部限流电阻，如果你额外串了电阻反而会拖暗显示，这也是个容易被忽视的操作误区。

注意：CH455只能驱动共阴数码管，接共阳数码管无法正常工作。选型时务必确认数码管极性。

6.3 开发环境的小坑

和STM32开发环境相关的几个问题也顺便提醒一下。如果用的是STM32CubeIDE，第一次烧录需要安装ST-Link驱动，这个去ST官网下载STM32 ST-LINK Utility或者直接装CubeIDE自带的驱动包就行。很多人在Win10/Win11上发现设备管理器里ST-Link显示未知设备，就是因为驱动没装好，而不是调试器坏了。

CH340或CP2102这类USB转串口驱动也经常出问题。CH340的驱动去沁恒官网下载，CP2102去Silicon Labs官网下，不要装那些来路不明的驱动管理软件。装完驱动后如果串口无法打开，检查设备管理器的COM口号是否正确，很多时候是COM号被系统重新分配了。

串口调试和I2C调试共用一个工程时，注意USART的波特率要和实际晶振匹配。如果用的不是标准8MHz晶振，CubeMX自动计算的波特率可能存在误差，串口打印乱码就从这里排查。

7. 扩展思考：CH455的键盘扫描能力

CH455这颗芯片还有一个经常被忽略的功能：内置4x4键盘扫描。它的读操作可以返回按键状态，和显示共用I2C总线，不需要额外引脚和扫描逻辑。如果你的项目里既要显示又要按键输入，一颗CH455能同时搞定，硬件设计可以简洁不少。

读键盘的HAL库操作和写数据不同，要用HAL_I2C_Master_Receive。CH455收到读命令后会返回按键状态字节，具体位定义在数据手册里有详细说明。不过要注意，CH455的键盘扫描和显示驱动不能同时进行，读取键盘期间数码管会短暂停顿，但因为扫描周期很短，肉眼完全感觉不到。

我实际测试过，按键响应速度在毫秒级别，对绝大多数HMI场景都够用。关键是你省掉了一个独立键盘扫描芯片或者一组GPIO，尤其是在引脚紧张的封装上，这个优势会放大。如果后续项目需要更复杂的人机交互，可以考虑把CH455的键盘读取做成中断驱动，按键触发时快速读取并清标志，这样就不会占用主循环的轮询时间了。

最后分享一个我在实际项目中养成的习惯：驱动类代码尽量独立成模块，不跟业务逻辑耦合。CH455驱动就管显示，ADC就管采集，按键就管输入，每个模块暴露几个接口，上层逻辑只调接口。这样做的好处是，项目后期换MCU平台或者换显示方案，驱动层重写一遍就行，业务逻辑完全不用动。这个习惯帮我省掉的返工时间，已经远远超出当初写驱动代码所花的时间了。

本文还有配套的精品资源，点击获取