用STM32 HAL库驱动TM1638显示板：从点亮数码管到控制LED的完整流程（附代码）

STM32 HAL库驱动TM1638显示模块实战指南

1. 初识TM1638：多功能显示控制芯片

TM1638是天微电子推出的一款集成了数码管驱动、LED控制和按键扫描功能的专用芯片。这颗芯片最大的特点就是能用最少的IO口资源实现丰富的交互功能——仅需3个GPIO引脚就能同时控制8位数码管、8个独立LED和8个按键输入。对于资源有限的STM32项目来说，这简直是性价比爆表的选择。

市面上常见的TM1638模块通常采用以下配置：

• 8位7段共阴数码管（带小数点）
• 8个独立彩色LED（通常为红色或蓝色）
• 8个轻触按键
• 标准2.54mm排针接口

模块典型引脚定义：

注意：虽然模块标称5V工作电压，但实际测试3.3V也能稳定工作，与STM32直接连接时无需电平转换。

2. 硬件连接与HAL库配置

2.1 硬件连接方案

以STM32F103C8T6（蓝莓开发板）为例，推荐以下连接方式：

// 引脚定义（根据实际电路修改） #define TM1638_STB_PIN GPIO_PIN_7 #define TM1638_STB_PORT GPIOB #define TM1638_CLK_PIN GPIO_PIN_8 #define TM1638_CLK_PORT GPIOB #define TM1638_DIO_PIN GPIO_PIN_9 #define TM1638_DIO_PORT GPIOB

对应的硬件连接：

1. TM1638的VCC接开发板5V引脚
2. GND接开发板GND
3. STB接PB7
4. CLK接PB8
5. DIO接PB9

2.2 CubeMX配置

1. 打开STM32CubeMX，选择对应型号
2. 配置PB7、PB8为GPIO_Output
3. 配置PB9为GPIO_Output（初始状态）
4. 生成代码时勾选"Generate HAL library"

// 自动生成的GPIO初始化代码片段 GPIO_InitStruct.Pin = GPIO_PIN_7|GPIO_PIN_8|GPIO_PIN_9; GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP; GPIO_InitStruct.Pull = GPIO_NOPULL; GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH; HAL_GPIO_Init(GPIOB, &GPIO_InitStruct);

3. TM1638通信协议深度解析

3.1 模拟SPI时序实现

TM1638使用类似SPI的同步串行协议，但需要特别注意以下几点：

1. 信号极性：时钟上升沿采样数据
2. 字节顺序：LSB（最低位）先传输
3. 时序要求：STB信号在命令传输期间必须保持低电平

典型写时序实现：

void TM1638_WriteByte(uint8_t data) { // 设置为输出模式 GPIO_InitStruct.Pin = TM1638_DIO_PIN; GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP; HAL_GPIO_Init(TM1638_DIO_PORT, &GPIO_InitStruct); for(uint8_t i=0; i<8; i++) { HAL_GPIO_WritePin(TM1638_CLK_PORT, TM1638_CLK_PIN, GPIO_PIN_RESET); HAL_Delay(1); // 适当延时保证时序稳定 // 输出数据位 if(data & 0x01) { HAL_GPIO_WritePin(TM1638_DIO_PORT, TM1638_DIO_PIN, GPIO_PIN_SET); } else { HAL_GPIO_WritePin(TM1638_DIO_PORT, TM1638_DIO_PIN, GPIO_PIN_RESET); } data >>= 1; HAL_GPIO_WritePin(TM1638_CLK_PORT, TM1638_CLK_PIN, GPIO_PIN_SET); HAL_Delay(1); } }

3.2 核心命令集

TM1638通过不同的命令字实现各种功能控制：

4. 完整驱动实现与功能封装

4.1 数码管显示功能

数码管显示需要解决两个关键问题：段码转换和地址映射。TM1638采用非标准的地址分配方式：

// 共阴数码管段码表（0-9,A-F） const uint8_t segmentMap[] = { 0x3F, 0x06, 0x5B, 0x4F, 0x66, 0x6D, 0x7D, 0x07, 0x7F, 0x6F, 0x77, 0x7C, 0x39, 0x5E, 0x79, 0x71 }; // 数码管地址映射表 const uint8_t digitAddr[] = {0xC0, 0xC2, 0xC4, 0xC6, 0xC8, 0xCA, 0xCC, 0xCE};

显示函数封装示例：

void TM1638_DisplayDigit(uint8_t position, uint8_t value, bool showDot) { if(position >= 8) return; uint8_t segData = segmentMap[value & 0x0F]; if(showDot) segData |= 0x80; TM1638_StartCommand(); TM1638_WriteByte(digitAddr[position]); TM1638_WriteByte(segData); TM1638_EndCommand(); }

4.2 LED控制功能

TM1638的LED控制地址与数码管地址交错排列：

// LED地址映射表 const uint8_t ledAddr[] = {0xC1, 0xC3, 0xC5, 0xC7, 0xC9, 0xCB, 0xCD, 0xCF}; void TM1638_SetLED(uint8_t ledNum, bool state) { if(ledNum >= 8) return; TM1638_StartCommand(); TM1638_WriteByte(ledAddr[ledNum]); TM1638_WriteByte(state ? 1 : 0); TM1638_EndCommand(); }

4.3 按键扫描实现

按键扫描需要切换DIO为输入模式，并解析返回的数据：

uint8_t TM1638_ReadKeys(void) { uint8_t keys = 0; // 设置为输入模式 GPIO_InitStruct.Pin = TM1638_DIO_PIN; GPIO_InitStruct.Mode = GPIO_MODE_INPUT; GPIO_InitStruct.Pull = GPIO_PULLUP; HAL_GPIO_Init(TM1638_DIO_PORT, &GPIO_InitStruct); TM1638_StartCommand(); TM1638_WriteByte(0x42); // 读按键命令 for(uint8_t i=0; i<4; i++) { uint8_t data = TM1638_ReadByte(); if(data & 0x01) keys |= (1 << (i*2)); if(data & 0x10) keys |= (1 << (i*2+1)); } TM1638_EndCommand(); // 恢复输出模式 GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP; HAL_GPIO_Init(TM1638_DIO_PORT, &GPIO_InitStruct); return keys; }

5. 高级应用与性能优化

5.1 动态扫描优化

默认情况下，TM1638会自动进行动态扫描，但我们可以通过调整扫描频率来优化显示效果：

void TM1638_SetScanMode(uint8_t mode) { // mode: 0=6位扫描, 1=7位扫描, 2=8位扫描 TM1638_WriteCommand(0x40 | (mode & 0x03)); }

5.2 亮度调节策略

TM1638提供8级亮度控制，实际项目中可以根据环境光自动调节：

void TM1638_SetBrightness(uint8_t level) { if(level > 7) level = 7; TM1638_WriteCommand(0x88 | level); }

5.3 低功耗设计

当系统进入休眠时，可以完全关闭TM1638以节省功耗：

void TM1638_PowerDown(void) { TM1638_WriteCommand(0x80); // 关闭显示 HAL_GPIO_WritePin(TM1638_STB_PORT, TM1638_STB_PIN, GPIO_PIN_RESET); } void TM1638_PowerUp(void) { HAL_GPIO_WritePin(TM1638_STB_PORT, TM1638_STB_PIN, GPIO_PIN_SET); TM1638_WriteCommand(0x88); // 恢复显示 }

6. 项目实战：多功能显示面板

结合前面封装的函数，我们可以实现一个完整的显示控制系统：

typedef struct { uint8_t digits[8]; bool dots[8]; uint8_t leds; uint32_t lastUpdate; } DisplayPanel; void Display_Update(DisplayPanel *panel) { // 更新数码管显示 for(uint8_t i=0; i<8; i++) { TM1638_DisplayDigit(i, panel->digits[i], panel->dots[i]); } // 更新LED状态 for(uint8_t i=0; i<8; i++) { TM1638_SetLED(i, (panel->leds >> i) & 0x01); } panel->lastUpdate = HAL_GetTick(); } void Display_Clear(DisplayPanel *panel) { memset(panel->digits, 0, 8); memset(panel->dots, 0, 8); panel->leds = 0; Display_Update(panel); }

实际使用中发现，TM1638的按键扫描需要约2ms的稳定时间，建议在主循环中每50ms扫描一次即可获得良好的响应效果，同时不会占用过多CPU资源。