1. 项目缘起与整体设计思路

搞嵌入式开发的朋友大概率都碰过这样一个场景：手头一块STM32的板子跑得好好的，突然产品经理或者导师来一句——“这设备得能记住时间，断电也不能丢”。这时候你脑子里第一个蹦出来的方案是什么？STM32内部不是有RTC吗？对，内部RTC确实能用，但它有个让人头疼的问题：一旦主电源断了，VBAT引脚上没挂纽扣电池，时间照样归零。而且内部RTC的精度受外部晶振和温度影响比较大，在一些对时间要求稍微严格一点的场合，偏差会日积月累。

所以外挂一颗独立时钟芯片就成了很自然的选择。DS1302就是这类需求里出镜率极高的一颗芯片——便宜、好买、资料多、SPI三线接口简单粗暴。但别看它简单，真正上手写驱动的时候，坑一点都不少：时序要求微妙、寄存器是BCD码、写保护要手动解除、突发模式容易读错数据……这些问题我在不同项目里反复踩过，所以这次干脆把STM32驱动DS1302的完整过程整理成一份学习笔记，开源出来给后来人省点时间。

这份笔记适合谁看？如果你刚学完STM32的GPIO操作，想找一个“不太复杂但又有一定技术含量”的外设练手，DS1302是绝佳选择。如果你已经在做项目，需要快速集成一个可靠的掉电走时方案，这里面的代码和调试经验可以直接拿去用。我下面会从硬件连接到软件架构、从寄存器操作到调试避坑，一层层拆开讲，尽量让不同基础的朋友都能跟上。

整个方案的核心思路其实就一句话：用STM32的三个普通GPIO模拟DS1302的三线串行时序，通过精确的延时控制完成字节读写，再封装出年、月、日、时、分、秒的读写接口。为什么不用硬件SPI？因为DS1302的时序跟标准SPI并不完全兼容——它的数据是在时钟下降沿还是上升沿采样、命令字节先发LSB还是MSB、读写之间需不需要额外的空隙，这些细节跟SPI的模式0到模式3都对不上。用GPIO模拟反而更灵活，时序完全由代码掌控，移植到任何一款STM32上都不受外设资源限制。

注意：DS1302虽然常被归类为“SPI类”器件，但它实际上是自定义的三线协议，不要试图用STM32的硬件SPI去驱动，否则时序对不上，读回来的数据全是乱的。

2. 硬件连接与关键细节解析

2.1 引脚功能与接线方案

DS1302一共8个引脚，实际跟MCU打交道的只有5个：VCC2（主电源）、VCC1（备用电池）、GND、CE（使能）、I/O（数据）、SCLK（时钟）。其中VCC2接系统3.3V，VCC1接一颗CR2032纽扣电池，GND共地。CE、I/O、SCLK分别接到STM32的三个GPIO上。

这里有个细节值得展开说：VCC1和VCC2的供电切换是芯片内部自动完成的。当VCC2高于VCC1约0.2V时，芯片由VCC2供电；当VCC2掉电或低于VCC1时，自动切到VCC1。这个机制保证了主电源断开后时钟继续走。但要注意，VCC1的电压范围是2.0V到3.5V，CR2032标称3V正好合适。如果你用可充电的LIR2032，标称3.6V，虽然勉强能用，但长期看对芯片寿命不太友好，建议还是用不可充电的CR2032。

接线的时候还有一点容易被忽略：I/O引脚是开漏输出，需要外接一个上拉电阻，典型值4.7k到10k。很多模块板子上已经集成了这个电阻，如果你是自己搭电路，千万别忘了。我见过有人直接连上去，读数据时好时坏，查了半天才发现是上拉电阻没加。

2.2 晶振选型与走时精度

DS1302外接的32.768kHz晶振是决定走时精度的关键。这个频率是2的15次方，经过15级二分频正好得到1Hz的秒信号。晶振的负载电容通常选6pF，但实际焊接时PCB的寄生电容也会影响，所以如果你发现走时偏快或偏慢，可以通过调整外接的微调电容来校准。不过DS1302本身没有内置的校准寄存器，所以校准只能在硬件层面做。

实测下来，用普通的圆柱体晶振，常温下一天误差大概在1到2秒。如果对精度要求更高，可以考虑换用精度更好的贴片晶振，或者干脆上DS3231这种内置温补的芯片。但DS1302的优势在于成本和简单，对于大多数消费类产品，这个精度已经够用了。

提示：晶振尽量靠近DS1302的X1、X2引脚，走线要短且对称，下方不要走其他信号线，否则容易引入干扰导致走时不准甚至停振。

3. 软件架构与核心时序实现

3.1 GPIO模拟三线时序的底层逻辑

DS1302的通信协议说穿了就是一套严格的时序规则。每次通信由CE拉高开始，CE拉低结束。数据在SCLK的上升沿被写入DS1302，在下降沿被DS1302输出。命令字节和数据字节都是低位先发，这一点跟标准SPI的MSB先发正好相反，写代码的时候特别容易搞混。

一个完整的写操作流程是这样的：CE拉高，发送8位命令字节（低位在前），然后发送8位数据字节（低位在前），最后CE拉低。读操作稍微复杂一点：CE拉高，发送8位命令字节，然后把I/O引脚切换为输入模式，在接下来的8个SCLK下降沿读取数据位，最后CE拉低。

命令字节的格式也有讲究：bit0是读写标志（1为读，0为写），bit1到bit6是寄存器地址，bit7固定为1。比如要写秒寄存器（地址0x80），命令字节就是0x80；要读秒寄存器，命令字节就是0x81。这个格式在数据手册里写得很清楚，但实际写代码时，很多人会忘记bit7必须置1，导致命令发出去没反应。

// 写一个字节到DS1302 void DS1302_WriteByte(uint8_t data) { for (uint8_t i = 0; i < 8; i++) { DS1302_IO_OUT(); // 切换I/O为输出 if (data & 0x01) { DS1302_IO_HIGH(); } else { DS1302_IO_LOW(); } DS1302_SCLK_LOW(); delay_us(2); DS1302_SCLK_HIGH(); // 上升沿写入 delay_us(2); data >>= 1; // 低位先发 } } // 从DS1302读一个字节 uint8_t DS1302_ReadByte(void) { uint8_t data = 0; DS1302_IO_IN(); // 切换I/O为输入 for (uint8_t i = 0; i < 8; i++) { data >>= 1; DS1302_SCLK_LOW(); delay_us(2); DS1302_SCLK_HIGH(); // 上升沿 delay_us(2); DS1302_SCLK_LOW(); // 下降沿输出数据 delay_us(2); if (DS1302_IO_READ()) { data |= 0x80; } } return data; }

上面这段代码是整个驱动的基础，所有上层功能都建立在它之上。延时函数用微秒级的就行，DS1302的时序要求并不苛刻，SCLK的频率最高可以到2MHz左右，但实际用100kHz到500kHz都很稳。我一般用2微秒的延时，对应大概250kHz，实测非常可靠。

3.2 BCD码转换与寄存器映射

DS1302内部所有的时间寄存器都是BCD码格式，这一点跟STM32内部RTC的二进制格式完全不同。所谓BCD码，就是用4位二进制表示一个十进制数字。比如十进制数23，BCD码就是0x23，高4位是2，低4位是3。这样做的好处是显示的时候不用做除法，直接取高低4位就能分别得到十位和个位。

但写代码的时候就要多一层转换。比如你要设置秒为45秒，不能直接写45，要写成0x45。读回来的时候也要把0x45转成45。这个转换逻辑很简单，但特别容易在调试的时候搞混——你从串口打印出来看到的是0x45，以为是十六进制的69，实际上它代表的是45秒。

// 十进制转BCD uint8_t DecToBcd(uint8_t dec) { return ((dec / 10) << 4) | (dec % 10); } // BCD转十进制 uint8_t BcdToDec(uint8_t bcd) { return ((bcd >> 4) * 10) + (bcd & 0x0F); }

DS1302的寄存器地址从0x80到0x8E，涵盖了秒、分、时、日、月、周、年，还有一个写保护寄存器（0x8E）和涓流充电寄存器（0x90）。其中秒寄存器的bit7是时钟停止位（CH），上电后默认是1，表示时钟停止。所以初始化的时候必须先把这一位清零，时钟才会开始走。这个坑我踩过不止一次——初始化代码写完了，读时间发现一直是00:00:00，查了半天才发现是CH位没清。

3.3 突发模式与单字节读写

DS1302支持一种叫“突发模式”的操作，命令字节是0xBE（写）和0xBF（读）。进入突发模式后，可以一次性连续读写秒、分、时、日、月、周、年七个寄存器，不需要每次都发命令字节。这样做的好处是保证时间数据的一致性——如果你一个一个读，读到一半的时候时钟刚好进位，就可能出现分和秒不匹配的情况。突发模式一次性把七个字节全部锁存读出，避免了这个问题。

但突发模式也有个坑：写入的时候，七个字节必须全部写完，少写一个都会导致数据错位。而且突发模式写入后，数据并不是立即生效的，需要等下一个秒信号到来才更新。所以如果你写完立刻读，读到的可能还是旧值。我的做法是写完延时10毫秒再读，确保数据已经更新。

// 突发模式读取全部时间 void DS1302_ReadTime(uint8_t *time) { DS1302_CE_HIGH(); DS1302_WriteByte(0xBF); // 突发读命令 for (uint8_t i = 0; i < 7; i++) { time[i] = DS1302_ReadByte(); } DS1302_CE_LOW(); } // 突发模式写入全部时间 void DS1302_WriteTime(uint8_t *time) { DS1302_WriteByte(0x8E); // 解除写保护 DS1302_WriteByte(0x00); DS1302_CE_HIGH(); DS1302_WriteByte(0xBE); // 突发写命令 for (uint8_t i = 0; i < 7; i++) { DS1302_WriteByte(time[i]); } DS1302_CE_LOW(); DS1302_WriteByte(0x8E); // 重新写保护 DS1302_WriteByte(0x80); }

4. 完整实操流程与调试记录

4.1 初始化与时间设置

拿到一颗全新的DS1302，第一步永远是初始化。初始化的核心任务有三个：关闭写保护、清除秒寄存器的CH位、设置一个初始时间。写保护寄存器在0x8E，bit7是WP位，默认是1，表示禁止写入。所以任何写操作之前，都要先往0x8E写0x00解除保护，写完后再写0x80恢复保护。

清除CH位就是往秒寄存器写一个BCD码的秒值，最高位为0。比如设置秒为00，就写0x00。这一步做完，时钟就开始走了。然后依次设置分、时、日、月、周、年。周的范围是1到7，具体哪一天对应星期几由你自己定义，DS1302本身不做校验。

void DS1302_Init(void) { // GPIO初始化省略 DS1302_WriteByte(0x8E, 0x00); // 解除写保护 DS1302_WriteByte(0x80, 0x00); // 秒=00，CH=0，时钟启动 DS1302_WriteByte(0x82, 0x30); // 分=30 DS1302_WriteByte(0x84, 0x12); // 时=12 DS1302_WriteByte(0x86, 0x15); // 日=15 DS1302_WriteByte(0x88, 0x06); // 月=06 DS1302_WriteByte(0x8A, 0x03); // 周=3 DS1302_WriteByte(0x8C, 0x24); // 年=24 DS1302_WriteByte(0x8E, 0x80); // 恢复写保护 }

上面这段代码设置的时间是2024年6月15日12:30:00，星期三。注意所有值都是BCD码格式。写完之后，你可以读回来验证一下。如果读回来的值跟写入的一致，说明通信正常。如果读回来全是0xFF或者0x00，那就要检查硬件连接和时序了。

4.2 时间读取与格式转换

读取时间用突发模式最省事，一次把七个字节全部读出来，然后逐个转换成十进制。转换的时候要注意，秒寄存器的bit7是CH位，读回来之后要屏蔽掉。小时寄存器如果用的是12小时制，bit7是AM/PM标志，bit6是12/24选择位，处理起来稍微麻烦一点。我一般直接用24小时制，省去这些麻烦。

typedef struct { uint8_t year; uint8_t month; uint8_t day; uint8_t week; uint8_t hour; uint8_t minute; uint8_t second; } DateTime; void DS1302_GetTime(DateTime *dt) { uint8_t raw[7]; DS1302_ReadTime(raw); dt->second = BcdToDec(raw[0] & 0x7F); // 屏蔽CH位 dt->minute = BcdToDec(raw[1]); dt->hour = BcdToDec(raw[2] & 0x3F); // 24小时制 dt->day = BcdToDec(raw[3]); dt->month = BcdToDec(raw[4]); dt->week = BcdToDec(raw[5]); dt->year = BcdToDec(raw[6]); }

读出来的时间可以进一步格式化输出，比如通过串口打印成“2024-06-15 12:30:00 星期三”这样的字符串。这一步没什么难度，但要注意年份只有两位，需要自己补上“20”前缀。另外星期的数字到中文的映射也要自己定义，DS1302不管这个。

4.3 掉电走时测试与验证

驱动写完了，最关键的验证就是掉电走时。测试方法很简单：设置好时间，然后断开主电源，等几分钟再上电，读回来的时间应该跟实际时间一致。如果时间归零了，说明备用电池没接好或者VCC1电压不够。如果时间走得明显偏快或偏慢，那就是晶振的问题。

我实测过好几颗不同批次的DS1302模块，发现一个规律：便宜的模块上用的晶振精度参差不齐。有的模块一天误差不到1秒，有的能差十几秒。如果你对精度有要求，建议买好一点的晶振自己换上去，或者干脆在软件层面做校准——比如每天固定时间往秒寄存器里加或减一个补偿值。不过这种做法比较粗糙，只适合对精度要求不高的场景。

注意：测试掉电走时的时候，一定要确保备用电池有电。CR2032的空载电压应该在3.2V以上，如果低于2.5V，芯片可能就无法正常切换到备用电源了。

5. 常见问题与排查技巧实录

5.1 读回来全是0xFF或0x00

这是最常遇到的问题，基本上90%的情况是硬件连接或者时序问题。排查顺序建议这样：先用万用表量一下VCC2和VCC1的电压是否正常，然后检查CE、SCLK、I/O三根线有没有接反或者虚焊。如果硬件没问题，就用示波器或者逻辑分析仪抓一下时序波形，看看SCLK的频率和占空比是否正常，数据线上的电平变化是否符合预期。

没有逻辑分析仪怎么办？可以用一个笨办法：在写字节的函数里加一个计数器，每写一位就翻转一个LED。如果LED闪烁的频率跟你预期的一致，说明程序在跑；如果不闪，说明卡在某个循环里了。这个方法虽然原始，但在没有专业仪器的时候特别管用。

5.2 时间不走或者走时不准

时间不走，首先检查秒寄存器的CH位是不是1。很多人初始化的时候只写了时间，忘了清CH位，结果时钟一直停着。其次检查晶振有没有起振，可以用示波器探头碰一下X1引脚，正常应该有32.768kHz的正弦波。如果没有波形，可能是晶振坏了或者负载电容不匹配。

走时不准的问题前面提过，主要是晶振精度和温度漂移。DS1302没有温度补偿，所以在温差大的环境里误差会明显增大。如果应用场景对时间精度要求高，建议换DS3231，内置TCXO，精度能到±2ppm，一年误差不到一分钟。但DS3231的价格是DS1302的好几倍，怎么选就看你的预算和需求了。

5.3 写入后读出来不对

写入后读出来不对，最常见的原因是写保护没解除。DS1302上电后写保护是默认开启的，任何写操作都会被忽略。所以每次写之前都要先往0x8E写0x00，写完后再写0x80恢复。如果你用的是突发模式写入，也要在突发写之前解除保护，突发写之后再恢复。

另一个可能的原因是BCD码转换错误。比如你想写23分，结果写成了0x17（十进制23的十六进制表示），读回来转换成十进制就是17，跟预期不符。这种错误在调试的时候很容易发现，因为读回来的值跟写入的值总是不一样，而且差值没有规律。

5.4 突发模式读取数据错乱

突发模式读取的时候，如果发现秒、分、时的数据对不上，比如秒是59，分是00，时是12，但实际时间应该是12:59:59，那可能是读取过程中时钟刚好进位了。虽然突发模式设计上是为了保证一致性，但如果读取速度太慢，还是有可能在读取过程中发生进位。解决办法是读两次，如果两次结果一致就采用，不一致就再读一次。这个技巧在要求高的场合很实用。

另外，突发模式读取的时候，CE必须在整个读取过程中保持高电平，读完之后才能拉低。如果中间不小心拉低了CE，通信就会中断，读回来的数据就是残缺的。这个问题在代码逻辑复杂的时候容易发生，比如在读取循环里调用了其他函数，而那个函数又操作了CE引脚。

6. 驱动封装与项目集成建议

6.1 接口分层与移植性设计

一份好的驱动代码应该做到“底层跟硬件相关，上层跟硬件无关”。我的做法是把驱动分成两层：底层是ds1302_hal.c，里面只有GPIO操作和字节读写函数，这些函数直接依赖具体的STM32型号和引脚定义；上层是ds1302.c，里面是时间读写、BCD转换、初始化等逻辑，这些函数只调用底层的字节读写接口，不关心具体是哪个引脚。

这样分层的好处是移植特别方便。比如你从STM32F103换到STM32F407，只需要改ds1302_hal.c里的GPIO初始化代码，上层逻辑一行都不用动。再比如你想把DS1302换成DS3231，也只需要重写底层，上层接口保持不变。这种设计思路在嵌入式开发里非常实用，值得养成习惯。

// ds1302_hal.h - 底层硬件接口 void DS1302_GPIO_Init(void); void DS1302_WriteByte(uint8_t data); uint8_t DS1302_ReadByte(void); // ds1302.h - 上层应用接口 void DS1302_Init(void); void DS1302_SetTime(DateTime *dt); void DS1302_GetTime(DateTime *dt);

6.2 与RTOS的配合使用

如果你的项目跑了RTOS，比如FreeRTOS，那DS1302的读写操作要注意临界区保护。因为DS1302的通信过程是“CE拉高—发命令—读写数据—CE拉低”这样一个完整的过程，中间不能被其他任务打断。如果两个任务同时操作DS1302，数据肯定乱套。解决办法有两种：一是用互斥锁保护整个通信过程，二是把DS1302的操作放在一个独立的任务里，其他任务通过队列发送请求。

我一般用第一种方法，简单直接。在DS1302_ReadTime和DS1302_WriteTime函数的开头获取互斥锁，结尾释放。这样即使多个任务同时调用，也能保证每次通信的完整性。需要注意的是，互斥锁的获取和释放要成对出现，中间如果有return语句，别忘了先释放锁。

6.3 低功耗场景下的注意事项

DS1302本身功耗很低，维持走时只需要几百纳安。但在低功耗应用里，STM32的GPIO状态会影响整体功耗。如果STM32进入睡眠模式，而连接DS1302的GPIO还保持输出高电平，可能会有漏电流。正确的做法是在进入睡眠前把CE、SCLK、I/O都配置成模拟输入或者浮空输入，避免电流从STM32灌到DS1302或者反过来。

另外，DS1302的涓流充电功能可以给备用电池充电，但只适合可充电电池。如果你用的是CR2032这种不可充电的电池，一定要确保涓流充电寄存器（0x90）是关闭的，否则可能损坏电池甚至引发安全问题。这个寄存器上电默认是关闭的，但如果你之前不小心写过，最好在初始化的时候显式地写0x00关闭它。

提示：在低功耗产品里，建议把DS1302的VCC2直接接到系统的常电上，而不是受MCU控制的电源轨。这样即使MCU断电，DS1302也能由VCC2或VCC1供电，保证时间不丢。

7. 写在最后的一些实操体会

DS1302这颗芯片我用了很多年，从学生时代的课程设计到后来的实际产品，它一直是个“够用且便宜”的选择。但每次用都会遇到一些新的小问题，有时候是时序的细微偏差，有时候是硬件上的疏忽。这份笔记里记录的坑，大部分都是我亲自踩过的，希望能帮你少走点弯路。

如果你刚开始学STM32，我建议你不要直接用现成的库，而是自己从头写一遍GPIO模拟的时序。写完之后用逻辑分析仪抓一下波形，对照数据手册一个位一个位地核对。这个过程虽然有点枯燥，但能让你对串行通信的理解深入一大截。以后遇到其他三线或两线器件，比如DS18B20、DHT11，你会发现思路都是相通的。

代码我已经整理好放在项目里了，注释写得比较详细，关键的地方都标了注意事项。如果你在移植或者调试的过程中遇到问题，可以先对照上面的排查表过一遍，大部分情况都能解决。实在搞不定的，也欢迎一起讨论。嵌入式这条路就是这样，一个人踩坑是坑，一群人踩坑就是路。