简介：基于STM32的数字时钟设计工程包，面向嵌入式系统初学者及STM32编程爱好者，聚焦如何借助STM32实现计时、闹钟触发与LCD液晶显示等完整功能。工程以C源码、头文件、Keil工程配置及Proteus仿真文件为主要构成，共182个文件，压缩包约6.16MB，其中pdsprj与pdsbak用于虚拟仿真验证，uvprojx与axf/hex便于固件编译烧录，适配从代码阅读到实板调试的多个环节。目前已有10414人学习下载。内容覆盖RTC实时时钟配置、外部晶振与分频设定、LCD驱动及GPIO控制、中断服务程序编写、低功耗电源管理等关键知识点，并整合了闹钟触发和显示刷新的实战设计思路。借助Proteus仿真可先行验证逻辑和硬件交互，再结合Keil环境完成固件烧录，是理解STM32时钟系统与中断机制的完整实践参考。 做数字时钟这个项目的时候，我其实有点犹豫要不要写这篇分享。ST官方例程一抓一大把，开发板配套资料也是铺天盖地，再写一遍好像没什么意义。但真正把方案定下来、把代码调通、把各种坑踩一遍之后，我发现网上很多资料都是“能跑就行”的水平，真正把原理讲清楚、把隐藏问题点出来的内容并不多。所以这篇东西的核心思路很简单：从选型到代码到排查，按一个实际项目的完整流程走一遍，把我踩过的坑和验证过有效的做法都写出来。
我自己用的是STM32F103C8T6，也就是俗称的“蓝丸”核心板，显示部分选的是4位数码管，时间基准用STM32内部的RTC外设。整个项目做下来大概一个周末，所有代码都是基于标准库写的。如果你正准备做毕设或者想练手嵌入式，这个项目非常合适——它麻雀虽小五脏俱全，有定时器、有中断、有RTC、有按键状态机，还有显示扫描逻辑，几乎把STM32最基础的外设都串起来了。
1. 整体设计与方案选型
1.1 需求拆解：数字时钟到底要做什么
先说清楚这个项目要解决的核心问题：让一块单片机准确计量时间，并且通过人机交互接口显示出来、允许用户调整时间。听起来简单，但拆开看就三个关键点：
第一，时间从哪来。最原始的办法是主循环里延时，但这完全不可靠，因为CPU执行指令的时间会受中断、分支预测等因素影响。必须用硬件定时器或者专用RTC模块来独立计时。
第二，时间怎么显示。数码管、LCD1602、OLED都可以，但显示方式直接影响代码架构——数码管需要动态扫描，OLED走I2C或SPI，LCD1602则占用的GPIO多一些。
第三，用户怎么调时间。纯显示的话只能叫“电子钟”，不叫“数字时钟设计”。必须有按键输入，而按键就牵扯到去抖、长按短按、状态切换这些逻辑。
我这个项目的目标很明确：不用外部RTC芯片、不用网络对时，完全靠STM32内部资源实现一个能走时、能调时、能显示的数字时钟。这样做的意义在于，内部RTC是STM32最容易被忽视但实际非常有用的外设，搞懂它的配置、校准和掉电保持机制，比直接接一个DS3231模块要有价值得多。
1.2 芯片选型与显示方案对比
先说芯片。STM32F103C8T6基本是学生项目里的“万金油”了，价格便宜、资料海量、引脚够用。做数字时钟这类项目，它的资源绰绰有余。实际需要用到的外设就四个：RTC（或通用定时器）、按键用的GPIO输入、显示用的GPIO输出（或者I2C）、可选的外部中断。
显示方案我对比过几种，简单说一下取舍逻辑：
| 显示方案 | 优点 | 缺点 | 适用场景 |
|---|---|---|---|
| 4位数码管（共阴/共阳） | 成本低、亮度高、视觉效果好 | 要动态扫描、占CPU、需加限流电阻 | 本项目的最终选择 |
| OLED 0.96寸 | 显示丰富、I2C接线少 | 字库处理麻烦、刷新率有限 | 适合加菜单、显示文字 |
| LCD1602 | 显示信息量大、驱动资料多 | 引脚占用多、背光耗电 | 适合显示“星期+日期+时间” |
我最终选了数码管，原因很直接：动态扫描是嵌入式入门必须掌握的概念，而且数码管在强光下可读性远好于LCD，拍照片出来也好看。
1.3 时间基准：为什么必须用 RTC 而不是延时
这个点值得单独拿出来说。很多初学者第一次做时钟，第一反应是在主循环里写delay(1000)然后秒变量加一。这样做在仿真器里可能看不出问题，但实际跑起来你会发现两个严重问题：
一是误差累积。delay(1000)本身就有误差，如果期间发生中断，那误差更大。一天下来偏个几十秒很正常。
二是主循环被延时拖死。如果主循环里还有按键扫描和显示刷新，那整个系统的实时性会被彻底破坏——按键可能没响应，数码管刷新率降低导致闪烁。
STM32内部RTC的设计思路是：由独立的32.768kHz低速外部晶振（LSE）驱动一个32位计数器，每秒自动加一，完全不占CPU。CPU只需要在需要的时候读取这个计数器的值，再换算成年月日时分秒。这样主循环就可以自由地做按键扫描和显示刷新，时间计量完全不受影响。
这里有个非常关键的细节：为什么晶振选32.768kHz？因为2的15次方等于32768，所以只要对晶振信号做15级分频，就能精确得到1Hz的信号，正好对应秒的跳动。STM32的RTC预分频器也是按照这个思路设计的，默认配置就是32768分频得到1Hz。
2. 硬件电路设计要点
2.1 最小系统与电源注意事项
数字时钟的硬件部分其实不复杂，但有几个细节做不好会导致很隐蔽的故障。首先是电源，STM32F103的工作电压是2.0V到3.6V，开发板上一般都有AMS1117稳压芯片，所以直接用USB供电就行。但如果你是自己画板子，一定要在前端加一个100uF的电解电容和两个104瓷片电容，分别吸收低频和高频纹波，否则RTC的走时精度会受影响。
第二个重点是VBAT引脚。STM32内部RTC的供电域是独立的，VDD断了之后只要VBAT还有电，RTC仍然可以继续走时。这也是它比用通用定时器计时高明的地方。我实际测试过，用一颗CR2032纽扣电池接VBAT，断电后时钟能持续走一年以上，重新上电后读到的还是正确时间。如果你不想用纽扣电池，也至少要在VBAT脚上接一个法拉电容，否则“掉电保存时间”这个功能就是摆设。
第三是复位电路和启动模式。如果自己做板子，NRST引脚要接一个104电容到地；BOOT0和BOOT1建议通过10K电阻下拉到地，确保从Flash启动。我见过有人不接BOOT0，导致芯片一直进入ISP模式，程序怎么都跑不起来。
2.2 按键输入与去抖
按键电路在原理图上看非常简单：按键一端接地，另一端接GPIO，GPIO内部配置为上拉输入。这样按键按下时读到低电平，松开时读到高电平。
但物理按键有个绕不过去的问题：机械抖动。按键内部的金属簧片在按下和释放的瞬间并不是干净的电平变化，而是会在几毫秒到几十毫秒内反复跳变，如果不做处理，一次按下可能被识别成好几次。
硬件去抖的办法是给按键并联一个0.1uF电容，或者串一个RC低通滤波器。但在STM32这种资源充足的芯片上，我更推荐软件去抖——检测到电平变化后延时10到20毫秒再确认一次，确认还是同一个电平才算有效。这样省了几个元器件，代码量也就多三五行的样子。
2.3 数码管驱动与限流电阻
数码管本质上是发光二极管，所以必须串限流电阻，否则电流过大会烧坏段码，或者拉低单片机GPIO输出电压。我用的共阴数码管，段选接STM32的PA0-PA7，位选接PB0-PB3，每个段选引脚串一个220欧姆的电阻。这样在3.3V供电下，每段电流大约在6-8毫安，亮度适中，不会过流过载。
如果你觉得8个GPIO驱动数码管太费引脚，也可以考虑用74HC595移位寄存器，两个引脚就能串出8位段选数据。但这会引入一个额外的问题——需要自己写模拟SPI时序。项目追求简单明了，直接把GPIO怼上去更快，这也是优先保证“先跑通再优化”的思路。
3. 软件架构与核心代码实现
3.1 工程结构：标准库还是HAL库
写到代码部分，第一个要决策的就是用标准库还是HAL库。我个人的建议是：如果你只是做这一个项目，而且要在网上找大量参考资料，用标准库会更顺手，代码量更少，逻辑更直接。如果你以后想用STM32CubeMX做别的项目，那就用HAL库，从开始就适应官方推荐的抽象层。
我这个项目用的是标准库。原因倒不是因为HAL库不好，而是数字时钟的功能太简单了，标准库那几行寄存器操作比HAL库生成的一堆结构体配置更直观。特别是RTC部分的配置，标准库的做法是直接操作RTC->CRL、RTC->CNTH这些寄存器，而HAL库则要把RTC_TimeTypeDef和RTC_DateTypeDef两个结构体都初始化一遍，代码量翻倍。
3.2 RTC配置与BCD码转换
STM32F103内部RTC的配置流程分三步：开启电源时钟和备份域时钟，取消备份域写保护，然后配置预分频和计数值。
void RTC_Init(void) { // 开启PWR和BKP时钟 RCC_APB1PeriphClockCmd(RCC_APB1Periph_PWR | RCC_APB1Periph_BKP, ENABLE); // 允许访问备份域 PWR_BackupAccessCmd(ENABLE); // 如果LSE没有开启，则开启外部低速晶振 if (BKP_ReadBackupRegister(BKP_DR1) != 0xA5A5) { RCC_LSEConfig(RCC_LSE_ON); while (RCC_GetFlagStatus(RCC_FLAG_LSERDY) == RESET); // 等待LSE就绪 // 选择LSE作为RTC时钟，并设置预分频为32767（对应1Hz） RCC_RTCCLKConfig(RCC_RTCCLKSource_LSE); RCC_RTCCLKCmd(ENABLE); RTC_WaitForSynchro(); RTC_WaitForLastTask(); RTC_SetPrescaler(32767); RTC_WaitForLastTask(); // 写入初始时间：2025-01-01 00:00:00 RTC_SetCounter(0); RTC_WaitForLastTask(); // 备份寄存器做标记，防止重复初始化 BKP_WriteBackupRegister(BKP_DR1, 0xA5A5); } }注意RTC_SetPrescaler(32767)之后计数器加一的频率正好是1Hz，因为时钟源是32768Hz，分频值是32767则输出频率为32768 / (32767 + 1) = 1Hz。这里的分频值是指分频器计数到该值后归零，所以实际分频系数要加一。
读取时间时，RTC计数器返回的是一个32位整数，单位是秒。如果把这个秒数直接丢到数码管上显示，人根本看不懂。所以必须把“自1970年1月1日以来的秒数”转换成“年/月/日/时/分/秒”。转换算法有现成的库函数，标准库提供了RTC_GetCounter()，然后你需要自己实现公历转换，或者直接用C库里的函数。
void RTC_ConvertTime(uint32_t timestamp, RTC_Time_t *time) { uint8_t days_in_month[] = {31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31}; uint32_t days = timestamp / 86400; uint32_t rem = timestamp % 86400; // 时分秒直接从余数算 time->hour = rem / 3600; time->minute = (rem % 3600) / 60; time->second = rem % 60; // 年月日需要逐年减天数（注意闰年） // 这里简化，实际项目中用查表法更高效 }3.3 按键扫描与状态机
按键部分我用了经典的三段式状态机：KEY_STATE_IDLE（空闲）、KEY_STATE_DEBOUNCE（消抖确认）、KEY_STATE_TRIGGER（触发动作）。每次主循环里调用一次扫描函数，读一次GPIO电平，根据状态迁移决定是否触发按键事件。
调时逻辑我设计成：短按Mode键切换模式（显示→调时→调分→调秒→返回显示），在调时模式下，短按Add键数字加一，长按Add键数字连续加。实现长按需要记录按下持续的时间，我在定时器中断里用一个全局变量key_press_ticks递增，扫描函数判断这个值超过50就触发连续加。
这里容易踩的一个坑是：按键扫描和显示刷新放在同一个循环里，如果显示刷新的delay太长，按键响应就会变慢。我实测过，如果数码管动态扫描占用了80%的CPU时间，按键识别的延迟会明显到“按键不可用”的程度。解决办法是：显示刷新放在定时器中断里做，主循环只跑按键扫描和逻辑处理。
3.4 显示刷新逻辑
数码管动态扫描的原理是：利用人眼视觉暂留效应，快速轮流点亮每一位数码管。4位扫描频率至少要50Hz才不会闪烁，也就是说每位点亮时间不超过5毫秒。我放在TIM2中断里，每2毫秒切换一位，四轮下来正好8毫秒一轮，频率125Hz，肉眼看过去四个数字是同时亮的。
uint8_t digit_code[10] = { 0xC0, 0xF9, 0xA4, 0xB0, 0x99, // 0-4 0x92, 0x82, 0xF8, 0x80, 0x90 // 5-9 }; uint8_t display_buffer[4]; // 存放4位要显示的数字 void TIM2_IRQHandler(void) { if (TIM_GetITStatus(TIM2, TIM_IT_Update) != RESET) { TIM_ClearITPendingBit(TIM2, TIM_IT_Update); static uint8_t pos = 0; // 先关闭所有位选 GPIO_ResetBits(GPIOB, GPIO_Pin_0 | GPIO_Pin_1 | GPIO_Pin_2 | GPIO_Pin_3); // 设置当前位的段码 GPIO_Write(GPIOA, digit_code[display_buffer[pos]]); // 打开当前位的位选 GPIO_SetBits(GPIOB, (0x01 << pos)); pos = (pos + 1) & 0x03; } }这段代码有个隐蔽问题：如果GPIO_Write输出的段码和位选切换之间没有延时，可能会导致前一位的残影。实际操作中可以在切换位选前把所有位选都关掉，就像上面代码那样，先全部复位再打开当前位，就可以有效消除串位现象。
显示内容的分割逻辑也很简单：把hour * 100 + minute这个四位数拆成个十百千四位，分别放到display_buffer[0]到display_buffer[3]。秒的显示不一定需要，我加了一个每秒闪烁的冒号效果，用一个小LED接在PB4上，每秒翻转一次，作为秒脉冲指示。
4. 常见问题与排查实录
4.1 下载失败：no stm32 target found
这是我做这个项目时最常遇到的一个问题。在Keil里点下载，提示no stm32 target found!，或者Error: Flash Download failed - Target DLL has been cancelled。
排查思路按顺序来：先检查ST-Link是否被识别，再检查接线是否松动，然后看芯片供电是否正常。但有一种很隐蔽的情况是：程序里把SWDIO（PA13）或者SWCLK（PA14）引脚复用成了普通IO，导致调试器无法连接芯片。如果之前下载过这样的程序，解决办法是按住复位键不松，点下载，在下载进度开始后瞬间松开复位键，这样就可以在程序跑起来之前把Flash擦掉。
如果你用的是国产STM32兼容芯片，比如GD32、HK32，这类芯片新出厂时可能带有读保护或者调试认证，也会报同样的错。这种时候要找芯片厂家的烧录工具先解除保护。
4.2 RTC不走时或走时不准
代码下载进去，数码管亮了，但秒数一动不动。首先要排查LSE晶振有没有起振。STM32F103的LSE晶振引脚是PC14和PC15，用示波器或者万用表量晶振两端，如果电压幅度有变化说明在震荡。没有示波器的话，在调试器里读RTC->CRL的RTOFF位也可以判断。
另外常见问题是PCB布局中线太长导致晶振无法起振。STM32内部RTC的LSE振荡器对负载电容非常敏感，典型振荡电路需要在晶振两端各接一个6-12pF的负载电容，而不是直接接到GND。我之前自己画板子时漏了这两个电容，RTC就一直不走，补上之后立刻正常。
走时不准一般是频率偏差造成的，因为单片机晶振本身有误差，而且误差会受温度影响。如果想校准，可以用微调法：让时钟跑24小时，记录偏差多少秒，然后修改RTC_SetPrescaler的分频值，用稍微偏离32767的数值把偏差补偿回来。
4.3 数码管显示闪烁
显示闪烁基本上是两个原因：扫描频率太低或者主循环里做了耗时的操作阻塞了中断。中断里的刷新代码本身速度很快，但如果你在主循环里调用了delay这种阻塞式延时，TIM2中断只能等延时结束才进，扫描就被打断了。解决办法是把所有延时都改成非阻塞形式，或者直接把关键的耗时操作移到中断优先级更高的中断里。
还有一种情况是电源电压不稳导致的亮度抖动。数码管点亮瞬间电流会突然增大，如果电源滤波不良，电压就会跌落，导致整个单片机电压波动。解决办法是在数码管电源端并联大一点的电容，我实测470uF的效果就比较理想。
4.4 按键跳动不灵敏
按键识别不稳定，先看软件去抖时间是不是太短了。10-20毫秒的去抖窗口对大多数按键是够的，但如果你用的按键弹片质量差，抖动时间可能长达30毫秒以上。我建议写个测试程序，把按键按下后GPIO的电平变化记录到数组里，从串口发出来看看到底抖动多久，用数据去决定去抖窗口。
另一个容易忽略的问题是按键扫描没有做“边沿检测”。如果你的状态机只在电平变化时触发，那用户按住不放时应该不会触发第二次事件才对。这个要在状态机里加一个“已触发”标志，只有从“未按下”状态跳转到“按下”状态时才产生事件。
4.5 问题速查表
| 现象 | 可能原因 | 解决办法 |
|---|---|---|
| 下载失败 no target | SWD引脚被复用/芯片读保护 | 按复位下载、解除保护 |
| RTC不走时 | LSE没起振/晶振负载电容缺失 | 检查晶振电路，加电容 |
| 走时误差大 | 晶振频率不准 | 改预分频值校准 |
| 显示闪烁 | 扫描频率低/主循环阻塞中断 | 提高中断频率，非阻塞延时 |
| 按键乱触发 | 去抖时间太短/缺少边沿检测 | 加大去抖窗口，加状态标志 |
| 上电时间丢失 | VBAT没接电池/没做备份域写配置 | 接纽扣电池，启用BKP写保护操作 |
5. 实操心得与扩展方向
5.1 调试工具的选择
调试阶段一定要把ST-Link用上，不要一直靠串口打印——串口打印会影响时序，而且看不到寄存器的实时状态。ST-Link配合Keil的Debug窗口，可以直接观察RTC计数器值、备份寄存器内容、中断标志位，很多古怪问题一眼就能定位。
如果调试APM32或者GD32这类芯片，ST-LinkUtility也能用，但最好装官方芯片包，否则读寄存器会有偏差。我踩过的坑是：用ST-Link Utility读STM32F103的Flash，如果芯片开了读保护，软件会提示操作失败，这时候先按复位再连接基本能解决。
5.2 掉电保存与上电恢复机制
RTC的计数器和备份寄存器在VDD掉电时由VBAT供电，所以掉电后时间不会丢。但这里有个前提：你必须确保在系统初始化时，不随便修改RTC的配置。很多人的代码每次上电都重新初始化RTC，结果就是每次上电时间都被重置了。
正确的做法是用备份寄存器存一个“已经初始化过”的标记，比如BKP_DR1写入0xA5A5，每次上电先读这个标记，如果已经有了就直接跳到读取时间的步骤，而不是重头配置RTC。这也是我上面初始化代码里那个if (BKP_ReadBackupRegister(BKP_DR1) != 0xA5A5)条件的意义。
5.3 项目的后续扩展
数字时钟做完之后，如果想升级，我建议按这个顺序来：先加一个温度传感器DS18B20，显示部分改成每隔几秒切换一次时间和温度；再加闹钟功能和蜂鸣器，用RTC的中断或者定时器比较中断来触发闹钟；最后可以换一块0.96寸OLED，做一个带菜单的完整界面，把按键的短按长按双击全部用上。
低功耗也是一个方向。STM32F103的STOP模式电流可以降到微安级别，配合外部中断唤醒，就能做成一个用纽扣电池供电的桌面时钟。不过低功耗模式下RTC仍然在走，这一点要提前想清楚，因为进入STOP模式前要把数码管全部关闭，否则静态电流会非常可观。
我个人实际操作中的体会是：数字时钟这个题目看似简单，但它的知识覆盖面其实非常广。你在解决“显示闪烁”的过程中理解了动态扫描的本质，在解决“RTC不走时”的过程中搞清楚了晶振负载电容的作用，在调按键时学会了状态机的抽象。这些能力是刷多少道面试题都换不来的。如果你按照这篇文章的思路从头做一遍，把代码逐行看懂、把每个坑都亲手踩一遍，那这个项目的价值就真正到手了。
本文还有配套的精品资源，点击获取
