简介本资源是一个面向嵌入式初学者的STM32智能电子时钟实战项目基于STM32F1系列微控制器使用Keil MDK开发环境与HAL库实现RTC实时时钟、LCD显示、按键交互及蜂鸣器提示等核心功能帮助学习者系统掌握GPIO、TIM、RTC、I2C/SPI外设驱动及中断编程等关键技能。压缩包共含198个文件涵盖40个C源文件、40个头文件.h、27个目标文件.o及工程配置文件.uvproj、可执行镜像.hex、链接脚本.sct等完整呈现从代码编写、编译构建到烧录调试的全流程工程结构。目前已有2982人下载学习资源包含touch_key、tm1640、lm75a、buzzer、usart等模块化驱动代码便于理解外设抽象与分层设计思想同时提供可直接编译运行的Keil工程显著降低入门门槛并支持快速验证与二次开发。 看到网盘里这个“基于stm32电子时钟.zip”的时候我第一反应是又一个经典的STM32入门项目。电子时钟硬要说难度确实不大但它是那种“看起来简单、做起来全是细节”的项目。一旦你把RTC、显示、按键、掉电保持这些问题全部真正搞明白后面再做任何带时间戳、带交互界面的项目都会特别有底气。这篇我把这类项目的完整思路和实操过程讲一遍包括我实际踩过的坑和解决方法。适合刚学完STM32基础外设、想从“点亮LED”过渡到“做一个完整小产品”的朋友也适合拿到别人工程后不知道怎么改、不知道从哪里下手的人。阅读之前你需要准备一块STM32F103C8T6最小系统板、一个0.96寸OLED、两个到三个按键、一颗CR1220纽扣电池或者杜邦线以及一台装了Keil或STM32CubeIDE的电脑。剩下的跟着下文走就行。1. 项目整体设计与思路拆解1.1 电子时钟为什么值得自己完整写一遍很多人觉得电子时钟太简单没什么技术含量。但说句实在话把时间显示做到“关电不丢、按键可调、常年走时误差可控”这三个要求已经能刷掉一大批半途而废的初学者了。STM32电子时钟最大的价值不是代码量而是它天然覆盖了一个嵌入式系统最核心的几个维度时钟源配置、外设驱动、人机交互、低功耗和可靠性设计。以经典配置为例系统硬件只需要四块主控STM32F103C8T6、显示模块、按键输入、电池备份。主控负责读RTC和刷新屏幕OLED负责显示时间日期按键负责进入设置和调整时间电池接在VBAT引脚上保证主电源断开后RTC继续走时。这个结构把一个“完整产品”所需的最小硬件单元都包含了又没有复杂到劝退新人。我见过不少人拿到类似的zip工程后第一件事就是打开Keil直接编译烧录看到屏幕亮了就认为自己会了。这种操作没有任何问题但如果你真的想借这个项目涨功我建议先做一件事把需求写清楚。是只显示时分秒还是带日期和星期要不要闹钟断电后时间要不要保持一天走时误差在多少秒内能接受需求不同方案差别非常大。比如只要“亮起来给人看”那用内部LSI时钟源就够了少焊一个晶振但如果要“能当真正的时钟用”外部32.768kHz晶振和电池供电就是刚需。1.2 显示方案怎么选OLED、数码管还是LCD电子时钟的显示方案是第一个需要做选择的地方。把这个选型思路想清楚比直接抄代码有用得多。OLED 0.96寸I2C接口只需两根线显示内容灵活能显示汉字和图形体积小、功耗低。缺点是价格比数码管贵一点需要自己取字模。数码管动态扫描占用定时器和GPIO资源走线多、驱动代码烦一些但数字大、远距离看得清适合做“床头大屏时钟”。LCD1602/LCD2004字符型液晶显示内容不需要取模自带英文字库程序也简单但晚上需要背光对比度在低温下会变差。我个人的推荐是优先用OLED。原因不是OLED性能碾压而是它在嵌入式调试里通用性最强。你会写SSD1306驱动之后后面做仪表、传感器采集、菜单界面都能复用同一套代码框架。而且I2C总线同时还能挂温度传感器、EEPROM一个项目能把总线通信练扎实这是数码管方案给不了的。这里顺带说一个选型原则基础项目里优先选择“能复用”的模块。STM32的学习路径本来就是外设驱动的复用过程你今天写的OLED驱动明天就能用在平衡车的调试界面上今天写的按键状态机后天就能用在智能锁的密码输入上。这才是“项目”和“作业”的区别。2. RTC与显示方案时钟项目的灵魂2.1 为什么有的代码一烧录就卡死RTC时钟源的选择RTC是电子时钟项目里最容易出幺蛾子的部分。STM32F103的RTC模块本身是一个独立的BCD定时器可以由三种时钟源驱动LSE外部32.768kHz晶振、LSI内部40kHz RC振荡器、HSE分频时钟。三者的关系我用一个生活例子说明LSE是机械表里的瑞士机芯准但需要额外硬件LSI是电子表里的普通晶振免维护但走时精度一般HSE像拿墙上挂钟的机芯去驱动秒表虽然频率高但掉电就停所以一般不作为RTC时钟源。时钟源频率精度硬件成本适用场景LSE32768Hz高温漂小需外接晶振和负载电容正规时钟产品、需要长期走时的场合LSI约40kHz低温漂明显无额外硬件只做演示、能接受每天偏差几十秒的情况HSE分频8MHz分频较高无额外硬件但掉电即停不推荐用作RTC我踩过的坑是这样的手头有一块STM32F103C8T6最小系统板板子上没焊LSE晶振但CubeMX里默认勾选了LSE。结果程序一运行就卡死在HAL_RTC_Init里面串口打印没有任何输出LED也不闪。排查了半个多小时才发现是初始化代码在等待LSE起振时永远超时了。所以拿到不熟悉的板子第一步先确认有没有32.768kHz晶振。没有晶振就别在CubeMX里开LSE直接用LSI先跑通功能等后面买了带晶振的板子再切到LSE提高走时精度。还有一个折中方案是焊接一个外置晶振模块但注意F103的OSC32_IN和OSC32_OUT引脚在有些最小系统板上没引出来需要飞线焊接难度稍高新手谨慎操作。这里多说一句F103的RTC和备份寄存器都在备份域里由VBAT引脚供电。也就是说主电源VDD掉了没关系只要VBAT上还挂着电池RTC就会继续走。很多人把纽扣电池的正极接到3.3V引脚上这是错的。3.3V那一路在系统断电后同样没电RTC照样丢数据。正确的接法是电池正极接VBATGND接GND。2.2 OLED驱动要点I2C时序和显存刷新OLED屏最常见的驱动芯片是SSD13060.96寸128x64分辨率。它的接口有多种最流行的I2C只有SCL和SDA两根线接线简单但代价是通信速率和刷新吞吐受限。F103的硬件I2C外设被不少人吐槽过网上“硬件I2C卡死”的帖子一堆。虽然本质上是使用姿势问题但为了少折腾很多工程干脆用GPIO模拟I2C速度慢一点但时序完全可控、稳定不卡死。如果你打算用硬件I2C需要注意的是上拉电阻。I2C总线要求SCL和SDA都有上拉电阻大多数OLED模块上已经集成了4.7k或10k上拉电阻所以直接用杜邦线连STM32就可以。如果自己搭的电路记得补上拉。没有上拉的总线表现为初始化偶尔成功、读取时好时坏、逻辑分析仪能看到波形但设备无响应。SSD1306内部有一块1KB的GRAM对应128x64像素点阵。驱动的基本流程是初始化SSD1306寄存器序列设置显存寻址模式然后把要显示的内容写入GRAM。注意SSD1306的GRAM和屏幕像素不是“一个字节对应一个像素”而是列地址和页地址交错排列的。8页每页8行像素。所以写入一屏数据需要128x81024字节。工程中显示性能和闪烁问题基本都出在“刷屏策略”上。如果你每秒全屏刷新一次I2C在100kHz模式下传输1024字节需要大约80毫秒期间主循环被占用按键响应就会变卡。更糟糕的是整屏清空再重绘时肉眼能看到明显闪烁。我的做法是维护一个显存缓冲数组所有绘图操作先在缓冲区里完成最后统一提交到SSD1306。提交时只提交变化的部分比如每秒只更新秒位所在的那几个字节。这样屏幕稳定不闪主循环也不会被I2C通信拖死。2.3 时间显示、冒号闪烁和按键状态机一个电子时钟界面最少要显示“时:分:秒”。如果追求实用再加上日期和星期。OLED显示中文需要字模取模软件推荐PCtoLCD2002字体推荐12号或16号宋体或者自己看着舒服的字体。取模时选“横向取模”“字节正序”“每行不足8位补0”这几个选项跟常见OLED库的默认格式才匹配。冒号闪烁的实现很多人一问就会每秒钟把冒号状态翻转一次。但具体怎么写能看出代码水平。初级做法是在主循环里检测秒数是否变化变化了就翻转一个标志位高级一点的做法是用RTC闹钟中断每秒触发一次在中断里翻转标志位主循环只负责把标志同步到屏幕上。中断方式的好处是即使主循环在忙按键处理时间刷新也不会被延误。按键处理是整个项目里最容易“控制不住”的部分。常见需求是短按切换设定项小时/分钟/秒长按数值加一两个按键同时按保存退出。如果用简单延时消抖代码写起来最快但长按、连按、误触这些场景全失控。我习惯用一个可复用的按键状态机每个按键维护一个状态变量定时器每10毫秒扫描一次读取电平变化区分出“按下”“释放”“长按触发”三个事件。主循环只消费事件不直接处理电平。3. 从CubeMX到代码完整实操过程3.1 工程初始化配置一套可以直接照抄的CubeMX参数我推荐用STM32CubeMX HAL库的方式搭建工程相比标准库省去了大量寄存器配置的重复工作而且生成的外设初始化代码结构清晰后续扩展也方便。如果你手里已经有一个现成的Keil工程也可以对照下面的配置检查哪里不对。CubeMX里的配置要点芯片选择STM32F103C8T6如果你用F103RCT6或F407引脚和RTC外设配置会有些差异RCCHSE选Crystal/Ceramic Resonator这样外部8MHz晶振才能作为系统时钟源时钟树HSE 8MHzPLL×9得到SYSCLK72MHzAPB1分频器设为/2APB1外设时钟36MHz这是F103最常见的一套配置LSE如果板子有32.768kHz晶振选Crystal/Ceramic Resonator没有就保持DisabledRTC勾选Activate Clock Source使能RTCLSE没开启就选LSI作为RTC时钟源I2C1Standard Mode速度100kHz。如果你用硬件I2C驱动OLED这里就要配置好USART1115200-8-N-1用作调试打印GPIOPC13接一个LED做运行指示PB0/PB1/PB2接三个按键配置为输入模式内部上拉NVIC使能RTC全局中断如果需要闹钟功能还要使能RTC闹钟中断CubeMX生成的代码默认在主函数里初始化所有外设。RTC部分比较特殊如果你开了LSE但板子上没有晶振HAL_RTC_Init会卡住。这块前面说过解决办法就是别开LSE或者确认晶振确实焊接好了。3.2 核心代码读时间、刷屏幕、处理按键CubeMX生成工程之后代码分三块写时间读取、OLED显示、按键交互。下面列一段我最常用的时间读取函数RTC_TimeTypeDef sTime; RTC_DateTypeDef sDate; void Clock_GetTime(void) { HAL_RTC_GetTime(hrtc, sTime, RTC_FORMAT_BIN); HAL_RTC_GetDate(hrtc, sDate, RTC_FORMAT_BIN); }这里有个很隐蔽的坑HAL库要求GetTime之后必须调用GetDate。因为HAL_RTC_GetTime读取的是影子寄存器一旦读取日期寄存器就会被锁存直到读取日期寄存器才会解锁。如果只读时间不读日期第二次GetTime可能拿到上一次锁存住的旧数据。很多人的时钟界面出现“分钟跳两下”或者“秒数偶尔不走”的现象就是少了这句GetDate。OLED显示部分核心是把时间格式化到显存缓冲区。比如12号字体下每个数字是12x16像素正好占两页显示“12:34:56”需要动态拼接字模数组。我建议先写一个底层函数把单个字符的字模拷贝到显存缓冲区的指定坐标再用sprintf把时、分、秒格式化到字符串逐字符绘制。按键状态机的核心结构大致是这样typedef enum { KEY_STATE_NORMAL, KEY_STATE_PRESSED, KEY_STATE_LONG_PRESS } KeyState; typedef enum { MENU_NORMAL, MENU_SET_HOUR, MENU_SET_MINUTE, MENU_SET_SECOND } MenuState;按键扫描用定时器中断每10毫秒进入一次读取三个按键的电平经过滤波判定后更新按键事件标志。主循环根据当前菜单状态消费这些事件完成“短按切换设定项”“长按数字加一”“同时按保存退出”整套逻辑。3.3 硬件连接参考如果你用的是裸屏和ST-Link接线参考如下OLED引脚STM32引脚说明VCC3.3VOLED供电不要接5VGNDGND共地SCLPB6I2C1_SCL硬件I2C的SCL模拟I2C可换别的IOSDAPB7I2C1_SDAI2C数据线按键STM32引脚接法KEY1PB0按键一端接PB0另一端接GND内部上拉KEY2PB1同上KEY3PB2同上注意PB2是BOOT1引脚个别板子引出可能有干扰电池引脚说明CR1220正极VBAT纽扣电池座焊到VBAT和GND之间CR1220负极GND共地即可OLED模块通常已经有上拉电阻不需要额外焊接。ST-Link的SWD接线是SWDIO、SWCLK、GND、3.3V四根线连上就能烧录调试。如果你用的是ST-Link Utility刷写hex记得先把Boot0跳线帽跳到1再上电刷完再跳回0复位。4. 调试实录从zip到能跑的必经之路4.1 卡在HAL_RTC_Init怎么快速定位前面提到的卡死问题我再补充一个排查方法。程序烧录后如果不确定卡在哪里第一步在main函数开头加一句串口打印确认程序是否进入主循环。第二步在HAL_RTC_Init前后各加一句打印如果卡在初始化里基本就是时钟源起振失败。更快的判断方式是看RTC初始化函数的返回值。HAL_RTC_Init内部会调用HAL_RTC_MspInit接着等待时钟源就绪。如果返回HAL_TIMEOUT说明等待超时。这时你去检查CubeMX里RTC时钟源选的是什么和板子上实际晶振是否匹配大概率能找到问题。还有一种情况板子上有LSE晶振但程序里的LSE驱动能力配置不合适。CubeMX的RTC配置页面有一个LSEDrive选项有Low和High两档。部分晶振需要High驱动能力才能稳定起振。启动慢或者偶尔不起振把这一项改成High再试试。4.2 一断电时间就回到初始值问题出在哪这个现象几乎每个做RTC项目的新手都会遇到。最直接的原因是VBAT没有供电。有一部分“极简开发板”连VBAT引脚都没引出来或者引出来了但没有电池座那断电丢时间是必然的。你先用万用表量一下VBAT引脚电压断电状态下应该是2V到3.6V之间。另一个原因来自代码逻辑。很多教程代码是这样的初始化RTC之后直接调用HAL_RTC_SetTime写入一个默认时间。这意味着无论电池是否供电每次上电程序都会把时间覆盖成代码里写的值。正确做法是引入一个“首次上电”标志写在RTC备份寄存器里。if (HAL_RTCEx_BKUPRead(hrtc, RTC_BKP_DR0) ! 0xA5A5) { // 第一次上电需要设置初始时间 HAL_RTC_SetTime(hrtc, sTime, RTC_FORMAT_BIN); HAL_RTCEx_BKUPWrite(hrtc, RTC_BKP_DR0, 0xA5A5); }备份寄存器的特点是断电后由VBAT供电保存内容主程序复位和重新上电都不会清空。把它当“是否初始化过”的标记是嵌入式时钟项目的标准做法。4.3 走时误差大怎么分析和校准如果用的是LSI时钟源一天的误差可能是几十秒甚至上百秒。这是因为LSI本质是RC振荡器频率受温度和电压影响很大出厂精度也没有保证。如果对走时精度有要求必须换LSE外置晶振然后做软件校准。我的校准流程是这样的先把系统跑起来对照手机时间记录24小时后的偏差。假设一天快了10秒说明RTC时钟源的实际频率略高于标称值。这时可以做一个软件补偿每隔一定时间减去相应的秒数。最简单的做法是启用RTC的闹钟中断每天零点触发一次在中断里对时间执行“修正逻辑”。不过注意HAL库设置时间会带来瞬间的秒跳变如果定时器在同一时刻改写秒值可能造成显示跳变所以校准放在凌晨三点比较稳妥这个细节常被忽略。还有一种常见的高精度方案是外接DS3231这种带温度补偿的RTC芯片年误差只有一两分钟普通LSE晶振根本比不了。但DS3231的接线多两根I2C线价格也贵不少适合做“真正产品级”的项目日常练手用LSE校准就够了。4.4 按键失灵、OLED闪烁这些小毛病怎么治按键失灵通常不是引脚接错而是配置漏了内部上拉。F103的GPIO在浮空输入模式下按键没按下时引脚电平不确定程序会随机触发。按键一端接GND、另一端接GPIOGPIO要配置成上拉输入这样没按下时读到高电平按下读到低电平。OLED闪烁的问题前面说了一半另一半是很多人为了省事每秒钟把整屏清空再重画。清空再重画必然带来闪动因为你先“删掉”了整幅画面再慢慢“画”上去。正确的做法是双缓冲所有绘图操作写进局部缓冲最后统一刷到屏幕并且只刷变化区域。我习惯把更新时间区域单独做比如只刷新秒位、日期变化时刷新日期、冒号变化时单独画冒号。这样整个屏幕没有任何肉眼可见的闪烁刷新时间占用也极低。4.5 常见问题速查表现象常见原因处理方法程序卡死在HAL_RTC_InitLSE晶振没有或未起振改用LSI作为RTC时钟源或焊接LSE晶振上电时间回退到默认值VBAT无电池或代码每次覆盖时间接VBAT电池用备份寄存器标志判断首次上电OLED不亮无字符I2C地址不符、接线错误、无上拉确认0x3C/0x3D地址检查SCL/SDA确认3.3V供电OLED只有背光无显示SSD1306初始化失败检查I2C时钟速率降低到100kHz再试时间一天快几十秒用了LSI时钟源或晶振负载电容不合适换LSE做软件校准或调整电容按键按下无响应GPIO配置成浮空输入没上拉配置为内部上拉输入按键后数字连续跳多个消抖不彻底增加20ms延时消抖或定时器扫描滤波秒数显示跳动异常HAL_RTC_GetTime后没调用GetDate补上HAL_RTC_GetDate即可屏幕频繁闪烁整屏清空重绘、无局部刷新改用显存缓冲只刷新变化区域5. 扩展让电子时钟从“能亮”变成“好用”5.1 低功耗与闹钟唤醒做到真正“挂在墙上”电子时钟如果插着USB线供电功耗无所谓。但如果你想做成一个电池供电的桌面小钟就必须考虑低功耗。F103在待机模式下整机电流可以降到微安级别RTC保持运行闹钟中断可以唤醒芯片。设计思路是主循环在没按键操作时进入STOP模式或Standby模式。RTC闹钟每秒触发一次唤醒或者每秒钟唤醒一次刷新显示按键中断也会唤醒系统处理交互。注意在进入低功耗前把不用的GPIO全部配置为模拟输入或高阻态否则引脚漏电会让功耗飙升。我在这个项目里实测过待机模式下系统电流大约5微安一节CR2032纽扣电池可以支撑RTC走时非常长时间。唤醒后的显示刷新也有讲究不要用HAL_Delay来延时延时期间CPU空转既浪费电又卡其他事件。HAL库的DWT延时方案可以替代HAL_Delay我建议在工程里直接把延时库换成DWT实现时间长了你就会感激这个决定。5.2 温度传感器、自动亮度和上位机校准扩展方向里最实用的三个功能是温度显示、自动亮度和串口校时。温度传感器推荐DS18B20单总线协议只占一根GPIO代码量也不大。显示在OLED顶部一行跟日期放在一起信息密度增加但屏幕不拥挤。自动亮度用一个光敏电阻配合ADC实现。光敏电阻和固定电阻分压后接到STM32的ADC通道根据光照强度调整OLED的对比度寄存器值。注意SSD1306的对比度范围和屏幕型号有关一般调解到中等亮度就能获得不错的视觉效果太亮反而不省电。上位机校时是一个很出彩的功能。通过串口接收不定长数据比如发送“T 09:30:00”这样的字符串STM32用串口空闲中断接收完整帧后解析时间并写入RTC。这样就不用手动按键调时间了电脑上开个串口助手一键同步。这里会用到串口空闲中断DMA接收正好把STM32串口接收不定长数据的经典套路再练一遍。顺带说一句如果以后你想接ESP8266做网络校时这套串口解析框架直接复用就行只需要把数据来源从串口助手换到WiFi模块。5.3 从裸机到FreeRTOS什么时候值得重构项目做到一定程度你会发现主循环里塞的东西越来越多OLED刷新、按键扫描、RTC读取、温度采集、串口解析……所有任务挤在一个while循环里互相抢占时间代码越来越难维护。这时候就值得引入FreeRTOS了。在FreeRTOS版本里任务拆分非常自然一个显示任务负责按固定周期刷新OLED一个按键任务负责扫描并投递事件一个RTC任务负责读取时间和处理校准。每个任务都是独立的while循环通过队列和信号量通信。OLED刷新任务使用软件定时器控制周期按键任务用二值信号量唤醒整体结构清晰很多。移植环境方面如果你还在用Keil直接加FreeRTOS源码就能编译如果习惯用VSCode开发STM32可以配EIDE插件或CMake工程体验都不错。我个人觉得电子时钟这种小型项目不上RTOS完全没问题但如果你后面要做四轴飞行器、桌面机器人这类多任务系统提前在时钟项目里把FreeRTOS跑熟能少走很多弯路。最后再分享一个小技巧无论你的时钟代码写得多严谨我都建议在工程里留一个“强制恢复出厂时间”的入口。比如两个按键同时长按5秒把RTC时间重置为编译时写入的默认时间。这个功能在调试和测试阶段特别有用因为当你反复调整走时精度、频繁烧录程序之后备份寄存器里的时间可能已经被改乱了没有一个快速恢复手段只能干瞪眼。电子时钟这项目做到“别人觉得简单、你知道不简单”的程度才算是真正上道了。本文还有配套的精品资源点击获取 STM32电子时钟实战：从RTC配置到OLED显示与掉电保持
简介本资源是一个面向嵌入式初学者的STM32智能电子时钟实战项目基于STM32F1系列微控制器使用Keil MDK开发环境与HAL库实现RTC实时时钟、LCD显示、按键交互及蜂鸣器提示等核心功能帮助学习者系统掌握GPIO、TIM、RTC、I2C/SPI外设驱动及中断编程等关键技能。压缩包共含198个文件涵盖40个C源文件、40个头文件.h、27个目标文件.o及工程配置文件.uvproj、可执行镜像.hex、链接脚本.sct等完整呈现从代码编写、编译构建到烧录调试的全流程工程结构。目前已有2982人下载学习资源包含touch_key、tm1640、lm75a、buzzer、usart等模块化驱动代码便于理解外设抽象与分层设计思想同时提供可直接编译运行的Keil工程显著降低入门门槛并支持快速验证与二次开发。 看到网盘里这个“基于stm32电子时钟.zip”的时候我第一反应是又一个经典的STM32入门项目。电子时钟硬要说难度确实不大但它是那种“看起来简单、做起来全是细节”的项目。一旦你把RTC、显示、按键、掉电保持这些问题全部真正搞明白后面再做任何带时间戳、带交互界面的项目都会特别有底气。这篇我把这类项目的完整思路和实操过程讲一遍包括我实际踩过的坑和解决方法。适合刚学完STM32基础外设、想从“点亮LED”过渡到“做一个完整小产品”的朋友也适合拿到别人工程后不知道怎么改、不知道从哪里下手的人。阅读之前你需要准备一块STM32F103C8T6最小系统板、一个0.96寸OLED、两个到三个按键、一颗CR1220纽扣电池或者杜邦线以及一台装了Keil或STM32CubeIDE的电脑。剩下的跟着下文走就行。1. 项目整体设计与思路拆解1.1 电子时钟为什么值得自己完整写一遍很多人觉得电子时钟太简单没什么技术含量。但说句实在话把时间显示做到“关电不丢、按键可调、常年走时误差可控”这三个要求已经能刷掉一大批半途而废的初学者了。STM32电子时钟最大的价值不是代码量而是它天然覆盖了一个嵌入式系统最核心的几个维度时钟源配置、外设驱动、人机交互、低功耗和可靠性设计。以经典配置为例系统硬件只需要四块主控STM32F103C8T6、显示模块、按键输入、电池备份。主控负责读RTC和刷新屏幕OLED负责显示时间日期按键负责进入设置和调整时间电池接在VBAT引脚上保证主电源断开后RTC继续走时。这个结构把一个“完整产品”所需的最小硬件单元都包含了又没有复杂到劝退新人。我见过不少人拿到类似的zip工程后第一件事就是打开Keil直接编译烧录看到屏幕亮了就认为自己会了。这种操作没有任何问题但如果你真的想借这个项目涨功我建议先做一件事把需求写清楚。是只显示时分秒还是带日期和星期要不要闹钟断电后时间要不要保持一天走时误差在多少秒内能接受需求不同方案差别非常大。比如只要“亮起来给人看”那用内部LSI时钟源就够了少焊一个晶振但如果要“能当真正的时钟用”外部32.768kHz晶振和电池供电就是刚需。1.2 显示方案怎么选OLED、数码管还是LCD电子时钟的显示方案是第一个需要做选择的地方。把这个选型思路想清楚比直接抄代码有用得多。OLED 0.96寸I2C接口只需两根线显示内容灵活能显示汉字和图形体积小、功耗低。缺点是价格比数码管贵一点需要自己取字模。数码管动态扫描占用定时器和GPIO资源走线多、驱动代码烦一些但数字大、远距离看得清适合做“床头大屏时钟”。LCD1602/LCD2004字符型液晶显示内容不需要取模自带英文字库程序也简单但晚上需要背光对比度在低温下会变差。我个人的推荐是优先用OLED。原因不是OLED性能碾压而是它在嵌入式调试里通用性最强。你会写SSD1306驱动之后后面做仪表、传感器采集、菜单界面都能复用同一套代码框架。而且I2C总线同时还能挂温度传感器、EEPROM一个项目能把总线通信练扎实这是数码管方案给不了的。这里顺带说一个选型原则基础项目里优先选择“能复用”的模块。STM32的学习路径本来就是外设驱动的复用过程你今天写的OLED驱动明天就能用在平衡车的调试界面上今天写的按键状态机后天就能用在智能锁的密码输入上。这才是“项目”和“作业”的区别。2. RTC与显示方案时钟项目的灵魂2.1 为什么有的代码一烧录就卡死RTC时钟源的选择RTC是电子时钟项目里最容易出幺蛾子的部分。STM32F103的RTC模块本身是一个独立的BCD定时器可以由三种时钟源驱动LSE外部32.768kHz晶振、LSI内部40kHz RC振荡器、HSE分频时钟。三者的关系我用一个生活例子说明LSE是机械表里的瑞士机芯准但需要额外硬件LSI是电子表里的普通晶振免维护但走时精度一般HSE像拿墙上挂钟的机芯去驱动秒表虽然频率高但掉电就停所以一般不作为RTC时钟源。时钟源频率精度硬件成本适用场景LSE32768Hz高温漂小需外接晶振和负载电容正规时钟产品、需要长期走时的场合LSI约40kHz低温漂明显无额外硬件只做演示、能接受每天偏差几十秒的情况HSE分频8MHz分频较高无额外硬件但掉电即停不推荐用作RTC我踩过的坑是这样的手头有一块STM32F103C8T6最小系统板板子上没焊LSE晶振但CubeMX里默认勾选了LSE。结果程序一运行就卡死在HAL_RTC_Init里面串口打印没有任何输出LED也不闪。排查了半个多小时才发现是初始化代码在等待LSE起振时永远超时了。所以拿到不熟悉的板子第一步先确认有没有32.768kHz晶振。没有晶振就别在CubeMX里开LSE直接用LSI先跑通功能等后面买了带晶振的板子再切到LSE提高走时精度。还有一个折中方案是焊接一个外置晶振模块但注意F103的OSC32_IN和OSC32_OUT引脚在有些最小系统板上没引出来需要飞线焊接难度稍高新手谨慎操作。这里多说一句F103的RTC和备份寄存器都在备份域里由VBAT引脚供电。也就是说主电源VDD掉了没关系只要VBAT上还挂着电池RTC就会继续走。很多人把纽扣电池的正极接到3.3V引脚上这是错的。3.3V那一路在系统断电后同样没电RTC照样丢数据。正确的接法是电池正极接VBATGND接GND。2.2 OLED驱动要点I2C时序和显存刷新OLED屏最常见的驱动芯片是SSD13060.96寸128x64分辨率。它的接口有多种最流行的I2C只有SCL和SDA两根线接线简单但代价是通信速率和刷新吞吐受限。F103的硬件I2C外设被不少人吐槽过网上“硬件I2C卡死”的帖子一堆。虽然本质上是使用姿势问题但为了少折腾很多工程干脆用GPIO模拟I2C速度慢一点但时序完全可控、稳定不卡死。如果你打算用硬件I2C需要注意的是上拉电阻。I2C总线要求SCL和SDA都有上拉电阻大多数OLED模块上已经集成了4.7k或10k上拉电阻所以直接用杜邦线连STM32就可以。如果自己搭的电路记得补上拉。没有上拉的总线表现为初始化偶尔成功、读取时好时坏、逻辑分析仪能看到波形但设备无响应。SSD1306内部有一块1KB的GRAM对应128x64像素点阵。驱动的基本流程是初始化SSD1306寄存器序列设置显存寻址模式然后把要显示的内容写入GRAM。注意SSD1306的GRAM和屏幕像素不是“一个字节对应一个像素”而是列地址和页地址交错排列的。8页每页8行像素。所以写入一屏数据需要128x81024字节。工程中显示性能和闪烁问题基本都出在“刷屏策略”上。如果你每秒全屏刷新一次I2C在100kHz模式下传输1024字节需要大约80毫秒期间主循环被占用按键响应就会变卡。更糟糕的是整屏清空再重绘时肉眼能看到明显闪烁。我的做法是维护一个显存缓冲数组所有绘图操作先在缓冲区里完成最后统一提交到SSD1306。提交时只提交变化的部分比如每秒只更新秒位所在的那几个字节。这样屏幕稳定不闪主循环也不会被I2C通信拖死。2.3 时间显示、冒号闪烁和按键状态机一个电子时钟界面最少要显示“时:分:秒”。如果追求实用再加上日期和星期。OLED显示中文需要字模取模软件推荐PCtoLCD2002字体推荐12号或16号宋体或者自己看着舒服的字体。取模时选“横向取模”“字节正序”“每行不足8位补0”这几个选项跟常见OLED库的默认格式才匹配。冒号闪烁的实现很多人一问就会每秒钟把冒号状态翻转一次。但具体怎么写能看出代码水平。初级做法是在主循环里检测秒数是否变化变化了就翻转一个标志位高级一点的做法是用RTC闹钟中断每秒触发一次在中断里翻转标志位主循环只负责把标志同步到屏幕上。中断方式的好处是即使主循环在忙按键处理时间刷新也不会被延误。按键处理是整个项目里最容易“控制不住”的部分。常见需求是短按切换设定项小时/分钟/秒长按数值加一两个按键同时按保存退出。如果用简单延时消抖代码写起来最快但长按、连按、误触这些场景全失控。我习惯用一个可复用的按键状态机每个按键维护一个状态变量定时器每10毫秒扫描一次读取电平变化区分出“按下”“释放”“长按触发”三个事件。主循环只消费事件不直接处理电平。3. 从CubeMX到代码完整实操过程3.1 工程初始化配置一套可以直接照抄的CubeMX参数我推荐用STM32CubeMX HAL库的方式搭建工程相比标准库省去了大量寄存器配置的重复工作而且生成的外设初始化代码结构清晰后续扩展也方便。如果你手里已经有一个现成的Keil工程也可以对照下面的配置检查哪里不对。CubeMX里的配置要点芯片选择STM32F103C8T6如果你用F103RCT6或F407引脚和RTC外设配置会有些差异RCCHSE选Crystal/Ceramic Resonator这样外部8MHz晶振才能作为系统时钟源时钟树HSE 8MHzPLL×9得到SYSCLK72MHzAPB1分频器设为/2APB1外设时钟36MHz这是F103最常见的一套配置LSE如果板子有32.768kHz晶振选Crystal/Ceramic Resonator没有就保持DisabledRTC勾选Activate Clock Source使能RTCLSE没开启就选LSI作为RTC时钟源I2C1Standard Mode速度100kHz。如果你用硬件I2C驱动OLED这里就要配置好USART1115200-8-N-1用作调试打印GPIOPC13接一个LED做运行指示PB0/PB1/PB2接三个按键配置为输入模式内部上拉NVIC使能RTC全局中断如果需要闹钟功能还要使能RTC闹钟中断CubeMX生成的代码默认在主函数里初始化所有外设。RTC部分比较特殊如果你开了LSE但板子上没有晶振HAL_RTC_Init会卡住。这块前面说过解决办法就是别开LSE或者确认晶振确实焊接好了。3.2 核心代码读时间、刷屏幕、处理按键CubeMX生成工程之后代码分三块写时间读取、OLED显示、按键交互。下面列一段我最常用的时间读取函数RTC_TimeTypeDef sTime; RTC_DateTypeDef sDate; void Clock_GetTime(void) { HAL_RTC_GetTime(hrtc, sTime, RTC_FORMAT_BIN); HAL_RTC_GetDate(hrtc, sDate, RTC_FORMAT_BIN); }这里有个很隐蔽的坑HAL库要求GetTime之后必须调用GetDate。因为HAL_RTC_GetTime读取的是影子寄存器一旦读取日期寄存器就会被锁存直到读取日期寄存器才会解锁。如果只读时间不读日期第二次GetTime可能拿到上一次锁存住的旧数据。很多人的时钟界面出现“分钟跳两下”或者“秒数偶尔不走”的现象就是少了这句GetDate。OLED显示部分核心是把时间格式化到显存缓冲区。比如12号字体下每个数字是12x16像素正好占两页显示“12:34:56”需要动态拼接字模数组。我建议先写一个底层函数把单个字符的字模拷贝到显存缓冲区的指定坐标再用sprintf把时、分、秒格式化到字符串逐字符绘制。按键状态机的核心结构大致是这样typedef enum { KEY_STATE_NORMAL, KEY_STATE_PRESSED, KEY_STATE_LONG_PRESS } KeyState; typedef enum { MENU_NORMAL, MENU_SET_HOUR, MENU_SET_MINUTE, MENU_SET_SECOND } MenuState;按键扫描用定时器中断每10毫秒进入一次读取三个按键的电平经过滤波判定后更新按键事件标志。主循环根据当前菜单状态消费这些事件完成“短按切换设定项”“长按数字加一”“同时按保存退出”整套逻辑。3.3 硬件连接参考如果你用的是裸屏和ST-Link接线参考如下OLED引脚STM32引脚说明VCC3.3VOLED供电不要接5VGNDGND共地SCLPB6I2C1_SCL硬件I2C的SCL模拟I2C可换别的IOSDAPB7I2C1_SDAI2C数据线按键STM32引脚接法KEY1PB0按键一端接PB0另一端接GND内部上拉KEY2PB1同上KEY3PB2同上注意PB2是BOOT1引脚个别板子引出可能有干扰电池引脚说明CR1220正极VBAT纽扣电池座焊到VBAT和GND之间CR1220负极GND共地即可OLED模块通常已经有上拉电阻不需要额外焊接。ST-Link的SWD接线是SWDIO、SWCLK、GND、3.3V四根线连上就能烧录调试。如果你用的是ST-Link Utility刷写hex记得先把Boot0跳线帽跳到1再上电刷完再跳回0复位。4. 调试实录从zip到能跑的必经之路4.1 卡在HAL_RTC_Init怎么快速定位前面提到的卡死问题我再补充一个排查方法。程序烧录后如果不确定卡在哪里第一步在main函数开头加一句串口打印确认程序是否进入主循环。第二步在HAL_RTC_Init前后各加一句打印如果卡在初始化里基本就是时钟源起振失败。更快的判断方式是看RTC初始化函数的返回值。HAL_RTC_Init内部会调用HAL_RTC_MspInit接着等待时钟源就绪。如果返回HAL_TIMEOUT说明等待超时。这时你去检查CubeMX里RTC时钟源选的是什么和板子上实际晶振是否匹配大概率能找到问题。还有一种情况板子上有LSE晶振但程序里的LSE驱动能力配置不合适。CubeMX的RTC配置页面有一个LSEDrive选项有Low和High两档。部分晶振需要High驱动能力才能稳定起振。启动慢或者偶尔不起振把这一项改成High再试试。4.2 一断电时间就回到初始值问题出在哪这个现象几乎每个做RTC项目的新手都会遇到。最直接的原因是VBAT没有供电。有一部分“极简开发板”连VBAT引脚都没引出来或者引出来了但没有电池座那断电丢时间是必然的。你先用万用表量一下VBAT引脚电压断电状态下应该是2V到3.6V之间。另一个原因来自代码逻辑。很多教程代码是这样的初始化RTC之后直接调用HAL_RTC_SetTime写入一个默认时间。这意味着无论电池是否供电每次上电程序都会把时间覆盖成代码里写的值。正确做法是引入一个“首次上电”标志写在RTC备份寄存器里。if (HAL_RTCEx_BKUPRead(hrtc, RTC_BKP_DR0) ! 0xA5A5) { // 第一次上电需要设置初始时间 HAL_RTC_SetTime(hrtc, sTime, RTC_FORMAT_BIN); HAL_RTCEx_BKUPWrite(hrtc, RTC_BKP_DR0, 0xA5A5); }备份寄存器的特点是断电后由VBAT供电保存内容主程序复位和重新上电都不会清空。把它当“是否初始化过”的标记是嵌入式时钟项目的标准做法。4.3 走时误差大怎么分析和校准如果用的是LSI时钟源一天的误差可能是几十秒甚至上百秒。这是因为LSI本质是RC振荡器频率受温度和电压影响很大出厂精度也没有保证。如果对走时精度有要求必须换LSE外置晶振然后做软件校准。我的校准流程是这样的先把系统跑起来对照手机时间记录24小时后的偏差。假设一天快了10秒说明RTC时钟源的实际频率略高于标称值。这时可以做一个软件补偿每隔一定时间减去相应的秒数。最简单的做法是启用RTC的闹钟中断每天零点触发一次在中断里对时间执行“修正逻辑”。不过注意HAL库设置时间会带来瞬间的秒跳变如果定时器在同一时刻改写秒值可能造成显示跳变所以校准放在凌晨三点比较稳妥这个细节常被忽略。还有一种常见的高精度方案是外接DS3231这种带温度补偿的RTC芯片年误差只有一两分钟普通LSE晶振根本比不了。但DS3231的接线多两根I2C线价格也贵不少适合做“真正产品级”的项目日常练手用LSE校准就够了。4.4 按键失灵、OLED闪烁这些小毛病怎么治按键失灵通常不是引脚接错而是配置漏了内部上拉。F103的GPIO在浮空输入模式下按键没按下时引脚电平不确定程序会随机触发。按键一端接GND、另一端接GPIOGPIO要配置成上拉输入这样没按下时读到高电平按下读到低电平。OLED闪烁的问题前面说了一半另一半是很多人为了省事每秒钟把整屏清空再重画。清空再重画必然带来闪动因为你先“删掉”了整幅画面再慢慢“画”上去。正确的做法是双缓冲所有绘图操作写进局部缓冲最后统一刷到屏幕并且只刷变化区域。我习惯把更新时间区域单独做比如只刷新秒位、日期变化时刷新日期、冒号变化时单独画冒号。这样整个屏幕没有任何肉眼可见的闪烁刷新时间占用也极低。4.5 常见问题速查表现象常见原因处理方法程序卡死在HAL_RTC_InitLSE晶振没有或未起振改用LSI作为RTC时钟源或焊接LSE晶振上电时间回退到默认值VBAT无电池或代码每次覆盖时间接VBAT电池用备份寄存器标志判断首次上电OLED不亮无字符I2C地址不符、接线错误、无上拉确认0x3C/0x3D地址检查SCL/SDA确认3.3V供电OLED只有背光无显示SSD1306初始化失败检查I2C时钟速率降低到100kHz再试时间一天快几十秒用了LSI时钟源或晶振负载电容不合适换LSE做软件校准或调整电容按键按下无响应GPIO配置成浮空输入没上拉配置为内部上拉输入按键后数字连续跳多个消抖不彻底增加20ms延时消抖或定时器扫描滤波秒数显示跳动异常HAL_RTC_GetTime后没调用GetDate补上HAL_RTC_GetDate即可屏幕频繁闪烁整屏清空重绘、无局部刷新改用显存缓冲只刷新变化区域5. 扩展让电子时钟从“能亮”变成“好用”5.1 低功耗与闹钟唤醒做到真正“挂在墙上”电子时钟如果插着USB线供电功耗无所谓。但如果你想做成一个电池供电的桌面小钟就必须考虑低功耗。F103在待机模式下整机电流可以降到微安级别RTC保持运行闹钟中断可以唤醒芯片。设计思路是主循环在没按键操作时进入STOP模式或Standby模式。RTC闹钟每秒触发一次唤醒或者每秒钟唤醒一次刷新显示按键中断也会唤醒系统处理交互。注意在进入低功耗前把不用的GPIO全部配置为模拟输入或高阻态否则引脚漏电会让功耗飙升。我在这个项目里实测过待机模式下系统电流大约5微安一节CR2032纽扣电池可以支撑RTC走时非常长时间。唤醒后的显示刷新也有讲究不要用HAL_Delay来延时延时期间CPU空转既浪费电又卡其他事件。HAL库的DWT延时方案可以替代HAL_Delay我建议在工程里直接把延时库换成DWT实现时间长了你就会感激这个决定。5.2 温度传感器、自动亮度和上位机校准扩展方向里最实用的三个功能是温度显示、自动亮度和串口校时。温度传感器推荐DS18B20单总线协议只占一根GPIO代码量也不大。显示在OLED顶部一行跟日期放在一起信息密度增加但屏幕不拥挤。自动亮度用一个光敏电阻配合ADC实现。光敏电阻和固定电阻分压后接到STM32的ADC通道根据光照强度调整OLED的对比度寄存器值。注意SSD1306的对比度范围和屏幕型号有关一般调解到中等亮度就能获得不错的视觉效果太亮反而不省电。上位机校时是一个很出彩的功能。通过串口接收不定长数据比如发送“T 09:30:00”这样的字符串STM32用串口空闲中断接收完整帧后解析时间并写入RTC。这样就不用手动按键调时间了电脑上开个串口助手一键同步。这里会用到串口空闲中断DMA接收正好把STM32串口接收不定长数据的经典套路再练一遍。顺带说一句如果以后你想接ESP8266做网络校时这套串口解析框架直接复用就行只需要把数据来源从串口助手换到WiFi模块。5.3 从裸机到FreeRTOS什么时候值得重构项目做到一定程度你会发现主循环里塞的东西越来越多OLED刷新、按键扫描、RTC读取、温度采集、串口解析……所有任务挤在一个while循环里互相抢占时间代码越来越难维护。这时候就值得引入FreeRTOS了。在FreeRTOS版本里任务拆分非常自然一个显示任务负责按固定周期刷新OLED一个按键任务负责扫描并投递事件一个RTC任务负责读取时间和处理校准。每个任务都是独立的while循环通过队列和信号量通信。OLED刷新任务使用软件定时器控制周期按键任务用二值信号量唤醒整体结构清晰很多。移植环境方面如果你还在用Keil直接加FreeRTOS源码就能编译如果习惯用VSCode开发STM32可以配EIDE插件或CMake工程体验都不错。我个人觉得电子时钟这种小型项目不上RTOS完全没问题但如果你后面要做四轴飞行器、桌面机器人这类多任务系统提前在时钟项目里把FreeRTOS跑熟能少走很多弯路。最后再分享一个小技巧无论你的时钟代码写得多严谨我都建议在工程里留一个“强制恢复出厂时间”的入口。比如两个按键同时长按5秒把RTC时间重置为编译时写入的默认时间。这个功能在调试和测试阶段特别有用因为当你反复调整走时精度、频繁烧录程序之后备份寄存器里的时间可能已经被改乱了没有一个快速恢复手段只能干瞪眼。电子时钟这项目做到“别人觉得简单、你知道不简单”的程度才算是真正上道了。本文还有配套的精品资源点击获取