1. 项目缘起与整体设计思路搞嵌入式的人都有一个共识RTCReal-Time Clock实时时钟这东西看着简单真到用的时候坑特别多。STM32 内部虽然集成了一个 RTC 外设但它对晶振精度要求高、备份域配置繁琐而且一旦主电源掉电靠那颗小小的纽扣电池能不能稳住走时很多时候是要打个问号的。所以在外挂 RTC 芯片这条路上DS1302一直是很多人的入门首选——便宜、好买、SPI 三线接口、资料铺天盖地。这个项目的核心目标很明确用 STM32 去驱动 DS1302实现时间的读写、走时保持并且把整套驱动代码整理成可复用的开源学习笔记。它解决的问题其实就三个第一让 STM32 能通过三根线跟 DS1302 通信第二把 BCD 码和十进制之间的转换封装好让上层调用不用关心底层时序第三把读写、初始化、时间设置这些操作做成清晰的 API方便移植到别的工程里。适合谁来参考我觉得有三类人最合适。一类是刚学完 STM32 GPIO 操作、想找个外设练手的初学者DS1302 的时序不算复杂正好拿来练“软件模拟时序”这个基本功第二类是做小项目需要独立走时功能的开发者比如做个电子钟、定时开关、数据记录仪不想被 STM32 内部 RTC 的配置折磨第三类是想复习三线通信协议的老手DS1302 的协议跟标准 SPI 有区别值得单独拎出来讲清楚。我先把整体设计思路摆出来。为什么用软件模拟时序而不是硬件 SPI这是第一个要解释清楚的选择。DS1302 的通信协议虽然长得像 SPI但它不是标准 SPI——它是“命令字节 数据字节”的结构读写方向由命令字节的最低位控制而且数据是低位先行LSB First跟标准 SPI 默认的 MSB First 正好相反。如果你硬要用 STM32 的硬件 SPI 外设去驱动就得处理位序反转、命令字节拼接、CE 使能时序这些额外逻辑反而比软件模拟更绕。所以绝大多数成熟方案都是用普通 GPIO 软件模拟时序三个引脚CE/RST、SCLK、I/O随便选移植性极强。第二个设计考量是分层。我把代码分成三层最底层是 GPIO 操作和微秒级延时中间层是字节读写和命令收发最上层是时间读写 API读秒、读分、设置时间等。这样分层的好处是换一个 MCU 平台你只需要改最底层的 GPIO 宏定义和延时函数中间层和上层几乎不用动。这也是我把它整理成学习笔记的原因——驱动代码的价值不在于跑通一次而在于能反复复用。第三个点是数据格式。DS1302 内部所有时间寄存器都是BCD 码存储的比如“23 分”存的是 0x23而不是十进制的 23。很多新手第一次读出来发现数值不对就是栽在这里。所以我在设计时专门封装了BCD_TO_DEC和DEC_TO_BCD两个宏所有对外接口都用十进制内部转换避免上层调用时反复踩坑。提示DS1302 的 I/O 引脚是准双向的写的时候 MCU 输出读的时候要切换成输入。如果你用的是 STM32 的推挽输出模式读之前必须把引脚切成浮空输入或上拉输入否则读回来的数据永远是错的。这是新手最容易忽略的一点。2. DS1302 核心细节与硬件连接要点2.1 引脚定义与最小系统连接DS1302 一般是 8 脚封装DIP-8 或 SOP-8核心引脚就这几个VCC2主电源、VCC1备用电池、X1/X232.768kHz 晶振、CE也叫 RST使能、I/O数据线、SCLK串行时钟、GND。这里有几个细节必须说清楚。VCC2 和 VCC1 的关系是很多人搞混的地方。VCC2 接主电源比如 3.3VVCC1 接备用纽扣电池一般是 3V 的 CR2032。DS1302 内部有个电源切换电路主电源在的时候用 VCC2主电源掉了自动切到 VCC1而且切换过程中走时不会中断。这就是它比 STM32 内部 RTC 省心的地方——你不需要配置什么备份域、不需要管 VBAT 引脚硬件层面就帮你搞定了。晶振必须用 32.768kHz这个频率不是随便选的。32768 是 2 的 15 次方经过 15 级二分频正好得到 1Hz 的秒信号这是 RTC 芯片的经典设计。晶振旁边一般要配两个 6pF 左右的负载电容具体值看晶振规格书。我实测下来如果电容选得不对走时一天能差好几秒所以这一步别偷懒。跟 STM32 的连接我一般这样分配DS1302 引脚STM32 引脚说明VCC23.3V主电源VCC1CR2032 正极备用电池GNDGND共地CEPA4使能软件控制SCLKPA5时钟软件控制I/OPA6数据双向选 PA4/PA5/PA6 没什么特别的理由就是方便你换成任意三个普通 GPIO 都行。但有一点要注意这三个脚不要选带特殊功能的复用脚比如某些芯片的 PA13/PA14 是 SWD 调试口占用了会连不上调试器。2.2 命令字节的结构解析DS1302 的通信核心是命令字节一个字节 8 位结构是这样的bit0 是读写方向0 写、1 读bit1 到 bit6 是寄存器地址bit7 固定为 1这是 DS1302 的“启动位”必须为 1否则命令无效。举个例子秒寄存器的地址是 0那么写秒的命令字节就是0x801000 0000读秒的命令字节就是0x811000 0001。分寄存器地址是 1写分是0x82读分是0x83。以此类推时是0x84/0x85日是0x86/0x87月是0x88/0x89星期是0x8A/0x8B年是0x8C/0x8D。这里有个关键细节命令字节是低位先行发送的也就是先发 bit0最后发 bit7。而数据字节也是低位先行。这一点跟标准 SPI 的 MSB First 完全相反如果你用硬件 SPI必须配置成 LSB First 模式否则读出来的数据位序全乱。还有一个写保护寄存器地址 0x8E这个必须重点讲。DS1302 上电后默认是写保护开启的也就是说你直接写时间寄存器是写不进去的。必须先往 0x8E 写 0x00 解除写保护改完时间后再写 0x80 重新开启保护。很多新手第一次调发现时间怎么都设不进去八成就是忘了这一步。注意写保护寄存器本身不受写保护影响任何时候都能写。但改完时间后强烈建议重新开启保护否则一旦有干扰误写时间就乱了。2.3 时序要求与延时计算DS1302 的时序不算快但对延时还是有要求的。翻一下手册关键参数有这么几个SCLK 时钟周期最小 1μs也就是最高 1MHzCE 建立时间最小 4μs数据建立时间最小 0.2μs。这些数字看着很宽松但实际写代码时如果你用 HAL 库的HAL_Delay做延时那肯定不行——HAL_Delay最小单位是毫秒太粗了。所以必须自己写微秒级延时。在 STM32 上实现微秒延时常见的有三种方案一是用 SysTick 定时器做计数二是用 DWTData Watchpoint and Trace周期计数器三是用定时器硬件。我个人最推荐DWT 方案因为它精度高、代码简单、不占用额外定时器资源。DWT 延时的原理是利用 Cortex-M 内核自带的周期计数器 CYCCNT它每个时钟周期加一。假设主频 72MHz那么 1μs 就是 72 个周期。延时函数大概长这样void delay_us(uint32_t us) { uint32_t start DWT-CYCCNT; uint32_t ticks us * (SystemCoreClock / 1000000); while ((DWT-CYCCNT - start) ticks); }用之前要先使能 DWT在main开头加几行初始化就行。实测下来这个延时精度能到几十纳秒级别驱动 DS1302 绰绰有余。如果你不想用 DWTSysTick 方案也行但要注意 SysTick 通常被 HAL 库占用了做 1ms 中断你得小心别冲突。定时器方案最稳但要多占一个硬件资源看你的项目取舍。3. 驱动代码实现与关键环节拆解3.1 GPIO 底层封装与方向切换底层这块我习惯用宏定义把 GPIO 操作包起来这样换平台只改宏。核心是三个操作拉高/拉低 CE、拉高/拉低 SCLK、读写 I/O。前两个简单重点是 I/O 的方向切换。DS1302 的 I/O 是单根双向线写的时候 MCU 输出读的时候 MCU 输入。在 STM32 上切换方向有两种做法一是改 GPIO 的 MODER 寄存器把引脚在输出和输入之间切二是利用开漏输出 外部上拉这样不用切方向写 1 时释放总线读的时候直接读。第二种更优雅但需要外部上拉电阻一般 4.7k 到 10k。我一般用第一种因为不用加外部元件。切换代码大概是这样#define DS1302_IO_OUT() { GPIOA-MODER (GPIOA-MODER ~(3 12)) | (1 12); } #define DS1302_IO_IN() { GPIOA-MODER (GPIOA-MODER ~(3 12)) | (0 12); }这里3 12是因为 PA6 对应 MODER 的第 12、13 位。输出模式是 01输入模式是 00。用寄存器操作比 HAL 库快得多在时序敏感的场合更稳。写一个字节的流程是CE 拉高然后循环 8 次每次先把 I/O 设成输出根据当前位是 0 还是 1 设置电平然后 SCLK 拉高再拉低产生一个时钟脉冲最后 CE 拉低。注意低位先行所以循环里取的是data 0x01然后data 1。读一个字节的流程类似但每次循环要先把 I/O 设成输入然后拉高 SCLK 再拉低在 SCLK 的上升沿或下降沿读取 I/O 电平。DS1302 是在时钟下降沿输出数据所以你在拉低 SCLK 之后读比较稳。读到的位要左移或右移拼起来因为是低位先行所以是data | bit i。实操心得读字节的时候循环里第一次读之前建议先把 I/O 拉低一小会儿再释放给总线一个明确的起始状态。我踩过的坑是如果上一次通信刚结束I/O 还残留高电平直接读可能读到脏数据。3.2 时间读写 API 的封装中间层搞定后上层 API 就清爽了。我一般封装这么几个函数DS1302_Init、DS1302_SetTime、DS1302_GetTime、DS1302_WriteReg、DS1302_ReadReg。DS1302_WriteReg的逻辑是先发命令字节地址 | 0x80方向位为 0再发数据字节。DS1302_ReadReg是先发命令字节地址 | 0x81方向位为 1然后读一个字节回来。DS1302_SetTime接收一个结构体里面是年、月、日、时、分、秒、星期全部是十进制。函数内部先把每个字段转成 BCD 码然后依次写寄存器。注意写之前要先解除写保护写完再开启。DS1302_GetTime反过来依次读寄存器把 BCD 转成十进制填进结构体返回。这里有个容易忽略的点DS1302 的秒寄存器 bit7 是CHClock Halt位为 1 时时钟停止。上电后这个位默认可能是 1所以初始化时必须先写秒寄存器把 CH 位清零时钟才会走。我见过不少人调了半天发现时间不走就是 CH 位没清。void DS1302_Init(void) { DS1302_WriteReg(0x8E, 0x00); // 解除写保护 DS1302_WriteReg(0x80, 0x00); // 秒寄存器写0清CH位启动时钟 DS1302_WriteReg(0x8E, 0x80); // 开启写保护 }3.3 BCD 码转换的实现细节BCD 码转换看着简单但有个坑BCD 码的每个半字节只能是 0 到 9如果出现 0x0A 到 0x0F 这种值说明数据有问题。所以转换函数最好加个范围检查或者至少心里有数。十进制转 BCDbcd ((dec / 10) 4) | (dec % 10)。比如 23(23/10)4 0x2023%10 3合起来0x23。BCD 转十进制dec ((bcd 4) * 10) (bcd 0x0F)。比如 0x23(0x234)*10 200x23 0x0F 3合起来 23。这两个宏我一般直接写成宏避免函数调用开销#define DEC_TO_BCD(dec) (((dec) / 10) 4 | ((dec) % 10)) #define BCD_TO_DEC(bcd) (((bcd) 4) * 10 ((bcd) 0x0F))注意年份的处理。DS1302 的年份寄存器只有 8 位能表示 00 到 99也就是 2000 到 2099 年。如果你要显示完整年份读出来之后加 2000 就行。这个设计在 2100 年之前都没问题之后就得换芯片了不过那时候估计也没人用 DS1302 了。4. 常见问题排查与避坑经验实录4.1 时间读不出来或全是 0xFF这是最高频的问题。读出来全是 0xFF说明 I/O 线一直是高电平MCU 根本没读到有效数据。排查顺序我一般这样走第一步确认硬件连接。用万用表量一下 CE、SCLK、I/O 三根线跟 STM32 的对应引脚是不是通的有没有虚焊。DS1302 是插在面包板上的话接触不良很常见。第二步确认电源。量一下 VCC2 是不是 3.3VVCC1 电池是不是有电。如果 VCC1 没电主电源掉电后时间就丢了但主电源在的时候应该还能读。如果主电源在都读不出来那问题不在电池。第三步确认时序。用示波器或者逻辑分析仪抓一下 SCLK 和 I/O 的波形看看有没有时钟脉冲数据线有没有变化。如果没有示波器可以先把延时加大比如把delay_us(1)改成delay_us(10)如果加大延时就能读出来说明是时序太快了。第四步确认方向切换。读之前有没有把 I/O 切成输入如果一直是输出模式读回来的就是你自己输出的电平不是 DS1302 的。提示我遇到过一次读出来全是 0xFF查了半天发现是 I/O 引脚被别的外设复用了。所以选引脚的时候一定要查一下复用表别跟其他功能冲突。4.2 时间写不进去写不进去九成是写保护没解除。DS1302 上电默认写保护开启你必须先往 0x8E 写 0x00。我建议在DS1302_Init里就把这一步做了别等到设置时间的时候才想起来。还有一种可能是命令字节发错了。写操作的命令字节 bit0 必须是 0如果你发成了 1那就变成读操作了自然写不进去。检查一下你的地址宏定义写地址和读地址是不是搞混了。另外CE 使能时序也要注意。CE 必须在发命令字节之前拉高在整个通信过程中保持高通信结束后才能拉低。如果 CE 中途掉了DS1302 会认为通信中断数据就丢了。4.3 走时不准走时不准基本是晶振和负载电容的问题。32.768kHz 晶振的精度直接决定走时精度便宜的晶振一天差几秒很正常。如果你对精度要求高建议选 ±20ppm 以内的晶振负载电容按规格书配。还有一个因素是温度。晶振频率会随温度漂移这是物理特性没法完全消除。如果应用场景温度变化大可以考虑用带温度补偿的 RTC 芯片但那就不是 DS1302 了。我实测下来用普通晶振 6pF 电容室温下一天大概差 1 到 2 秒。如果只是做个电子钟这个精度够了如果要做数据记录仪可能得定期校准。4.4 常见问题速查表现象可能原因排查方法读出全 0xFFI/O 方向没切换 / 硬件断线检查方向切换代码量通断读出全 0x00CE 没拉高 / 电源问题量 CE 电平量 VCC时间写不进写保护没解除检查 0x8E 是否写 0x00时间不走CH 位没清检查秒寄存器 bit7走时不准晶振精度 / 负载电容换晶振调电容数据位序错乱用了 MSB First改成 LSB First偶尔读错时序太快 / 干扰加大延时加滤波电容4.5 几个我踩过的坑第一个坑是延时函数用错。我一开始图省事用了HAL_Delay(1)结果 DS1302 完全没反应。后来才反应过来HAL_Delay是毫秒级而 DS1302 需要的是微秒级。换成 DWT 延时后立马就好了。第二个坑是忘记清 CH 位。初始化的时候只解除了写保护没管秒寄存器结果时间一直停在初始值。后来在初始化里加了一句写秒寄存器 0x00问题解决。第三个坑是I/O 引脚模式。我一开始把 I/O 配成了推挽输出读的时候没切输入读回来全是自己输出的高电平。后来改成读之前切浮空输入就正常了。第四个坑是电池没装。调试的时候只接了主电源没装纽扣电池断电后时间全丢。这个不算 bug但调试时容易忽略以为程序有问题。5. 代码移植与扩展思路5.1 移植到其他平台的注意事项这套驱动移植到别的 MCU 平台比如 STM32 的另一个系列、或者别的品牌的芯片需要改的地方其实很少。核心就是三块GPIO 操作宏、微秒延时函数、引脚定义。GPIO 操作宏如果你用的是寄存器操作换平台要改寄存器地址如果用 HAL 库改起来更简单把HAL_GPIO_WritePin的端口和引脚改一下就行。我建议用宏包一层这样上层代码完全不用动。微秒延时函数DWT 方案在 Cortex-M 内核的芯片上都能用换平台基本不用改。如果是别的内核可能得用定时器方案。引脚定义这个最简单改几个宏就行。移植完之后建议先用一个简单的读写测试验证一下比如写一个值到某个寄存器再读回来看是否一致。确认底层通了再往上调时间读写。5.2 可以扩展的功能基础驱动跑通后可以往上加不少实用功能。比如闹钟功能DS1302 本身支持两个闹钟寄存器可以设置每天定时触发配合 STM32 的中断做定时任务。再比如掉电检测通过检测主电源电压在掉电前把关键数据写进 DS1302 的 RAMDS1302 有 31 字节的静态 RAM上电后再读回来。还可以做时间同步比如通过串口接收上位机发来的时间自动校准 DS1302。或者加个按键调时功能用几个按键配合 OLED 显示做成一个完整的桌面时钟。如果要做产品建议加一个看门狗防止程序跑飞导致时间读写异常。DS1302 本身没有看门狗得靠 MCU 的。5.3 代码组织建议最后说一下代码组织。我习惯把驱动分成两个文件ds1302.c和ds1302.h。.h里放引脚定义、宏、结构体声明、函数原型.c里放具体实现。这样别的工程要用直接把这两个文件拷过去改一下.h里的引脚定义就行。结构体我一般这样定义typedef struct { uint8_t year; // 00-99 uint8_t month; // 1-12 uint8_t day; // 1-31 uint8_t hour; // 0-23 uint8_t min; // 0-59 uint8_t sec; // 0-59 uint8_t week; // 1-7 } DS1302_Time_t;所有字段都是十进制上层调用不用关心 BCD 转换。这样接口清晰别人接手也容易看懂。我个人在实际操作中的体会是DS1302 这个芯片虽然老但胜在简单可靠、资料多、成本低。把它的驱动写扎实了对理解三线通信协议、时序控制、BCD 码处理这些基础概念特别有帮助。而且这套代码框架换成别的类似芯片比如 DS3231、PCF8563改改时序和寄存器地址就能用算是嵌入式入门的一个很好的练手项目。