STM32驱动DS1302实时时钟芯片：三线时序、BCD码转换与工程避坑指南

最近在做一个带时间记录功能的小设备，需要一颗能掉电走时的时钟芯片，就把 DS1302 翻出来完整摸了一遍。从硬件接线到三线时序，从 BCD 转换到写保护，中间踩了不少坑，整理成这份 STM32 驱动 DS1302 的开源学习笔记。它适合刚接触 RTC 或者第一次做 GPIO 模拟通信的人，也适合想拿一份能直接跑的例程来改的开发者。文章把完整代码、寄存器逻辑和调试踩坑都拆开讲，按步骤就能复现。如果只想要代码，可以直接跳到第 3 节；如果想弄明白为什么这么写，建议从头看一遍，理解时序和寄存器之后再去改代码会顺手很多。

1. 为什么选 DS1302：RTC 选型的那些事儿

1.1 项目需求与三款芯片对比

做带时间记录功能的项目，时间来源一般有几种：MCU 片上 RTC、外部 RTC 芯片、GPS 对时、网络对时。片上 RTC 用起来最省外部器件，但不是所有单片机都有独立 RTC 引脚和备用电池接口，而且有些型号的晶振起振电路比较挑布局。外部 RTC 芯片里，DS1302、PCF8563、RX8025T 是大家用得比较多的三款。我当初选 DS1302，主要看中它接口简单、资料海量、采购便宜，几乎每个卖开发板的店里都有模块，出了问题也好排查。

选择 DS1302 也是一次取舍。它没有温补，走时精度完全取决于外接 32.768kHz 晶振和匹配电容，这个后面会专门讲。但对于大多数不带高精度计时要求的项目，比如电子时钟、定时器、数据记录器的时间戳，它完全够用。而且它带 31 字节非易失 RAM，虽然容量不大，但用来存一些开机次数、校准参数之类的数据很合适，省了一颗 EEPROM。

1.2 DS1302 引脚与内部结构

DS1302 常用 DIP8 和 SOP8 封装，引脚不多。VCC2 是主电源，接 MCU 的 3.3V 或者 5V；VCC1 是备用电池引脚，一般接 3V 纽扣电池；GND 接地；X1、X2 接 32.768kHz 晶振；CE（有的板子上标 RST）、SCLK、IO 是三根通信线，分别接三个 GPIO。

注意 CE 虽然被一些人叫做 RST，但它不是复位脚。这个脚是整个通信的使能开关，只有 CE 拉高之后，SCLK 和 IO 上的操作才有效。CE 拉低之后，芯片内部清零总线逻辑，为下一次通信做准备。内部结构可以简单理解成四块：振荡器分频链、控制逻辑、时间寄存器阵列、31 字节 RAM 和涓流充电控制。芯片上电后的寄存器内容不保证是有效时间，所以初始化逻辑很重要，这也是很多新手上电后读到乱七八糟数值的原因之一。

1.3 硬件接线：从裸芯片到开发板

我用的是 STM32F103C8T6 核心板，HAL 库加 MDK 环境，硬件接线如下。

VCC2 接 3.3V 还是 5V 都行，芯片支持 2.0V~5.5V，但接 3.3V 和 STM32 的引脚电平更匹配，不用考虑电平转换。晶振两个引脚之间的走线尽量短，电容靠近 DS1302 放置，否则可能起振困难。我用的是直插芯片加面包板，晶振引脚剪短一点，实测起振很稳。IO 线上串一个 1kΩ 电阻再连到 MCU，万一接线错误也能起到保护作用，不串也能工作。

工程用 CubeMX 生成的初始化代码中，PB12、PB13、PB14 全部配置成推挽输出，初始电平是低。USART1 开启，用于串口打印时间。CubeMX 里不需要把 PB14 配成输入，真正的方向切换在驱动代码里动态完成。

2. 吃透 DS1302 的通信协议与寄存器

2.1 三线时序核心要点

DS1302 的通信协议非常好理解，说到底就是一根时钟线带着一根双向数据线，在 CE 有效时搬运数据。它和标准 SPI 有区别：一是数据位是低位先发；二是数据线 IO 是双向的，写命令和数据时主机驱动 IO，读数据时 DS1302 驱动 IO。这就是为什么很多人第一次用硬件 SPI 驱动 DS1302 会失败，方向切换和位序都得额外处理，不如 GPIO 模拟来得直观。

一个完整通信过程的骨架如下：

1. 初始状态 CE 低、SCLK 低。
2. 拉高 CE，启动通信。
3. 发送 8 位命令字，SCLK 上升沿时 DS1302 采样 IO 线上的电平。
4. 如果是写操作，紧接着再发 8 位数据，同样上升沿采样。
5. 如果是读操作，命令字发送完毕后，由 DS1302 驱动 IO 线，主机在 SCLK 上升沿读取数据。
6. 通信结束，拉低 CE。

用个生活化的比喻：CE 就像高铁检票口，只有检票口打开，SCLK 这个节拍器才会带着 IO 数据线一节一节地往前走。每个字节都是 8 拍，低位在前。这里有个关键细节，写数据时一定要在 SCLK 拉高之前就把 IO 电平设置好，给数据一个稳定建立时间。数据手册给出的是纳秒级参数，STM32 的 GPIO 翻转速度完全够快，但为了保险起见，我在每次翻转之间加了一个微秒级延时，实测更加稳定。

2.2 命令字与寄存器地址表

DS1302 每次通信必须先发一个命令字节，告诉芯片接下来要操作哪个寄存器、是读还是写。命令字节的常见实现方式是这样的：bit7 固定为 1，bit0 作为读写标志，0 表示写、1 表示读，中间位放寄存器地址。写秒寄存器的命令是 0x80，读秒寄存器就是 0x81。这套约定在主流的 DS1302 驱动代码里都能对得上，直接用即可。

常用寄存器地址如下。

写保护寄存器是最容易被忽略的。它的最高位 WP 如果为 1，所有时钟寄存器的写入都会被拒绝，而且不会报任何错误。第一次用的时候我写完时间再读，发现数值完全没变，查了半天才意识到是写保护没关。所以任何写时间操作之前，必须先往 0x8E 写 0x00。写完时间之后，可以往 0x8E 写 0x80 把写保护重新打开，防止后续程序跑飞时误改时间。

时钟突发模式允许用一条命令读写全部 8 个字节的时间寄存器。写突发的命令是 0xBE，读是 0xBF。突发模式下数据传输是连续的，写完秒寄存器后地址自动递增，不需要每条数据重新发命令。这个模式适合一次性读取完整时间或写入初始时间，代码简洁很多。

2.3 BCD 码转换与掩码陷阱

DS1302 内部时间寄存器的存储格式是 BCD 码，不是普通的二进制。比如十进制 23 秒，在芯片里存的是 0x23，高四位是十位上的 2，低四位是个位上的 3。主机想要显示 23，就必须把 0x23 拆成 2 和 3。换算公式很简单：

static uint8_t DecToBcd(uint8_t dec) { return (dec / 10) << 4 | (dec % 10); } static uint8_t BcdToDec(uint8_t bcd) { return (bcd >> 4) * 10 + (bcd & 0x0F); }

除了 BCD 转换，寄存器里还藏着各种标志位，读取时必须做掩码处理。秒寄存器的 bit7 是 CH 暂停位，写 1 会停振，读秒的时候要把它去掉；时寄存器如果工作在 12 小时制，bit7 表示上午还是下午，bit6 是 12/24 小时制标志，统一处理的话读出来时都对高位做& 0x3F；日寄存器只用到低 6 位，月和星期则分别只用到低 5 位和低 3 位。如果不管这些掩码，在时间走到某些值的时候，读出来的数据会出现非常奇怪的跳变。

写时间时也要小心 CH 位。DecToBcd(second)转换出来的最高位天然是 0，所以在写入秒寄存器时芯片会保持振荡。如果某段代码为了测试停振功能写入 0x80，那时间就会彻底卡住，直到你把 CH 位清 0。

3. 从底层时序到上层调用：完整代码实现

3.1 工程初始化与引脚定义

CubeMX 生成工程后，在代码里建一个 ds1302.c 和 ds1302.h。引脚宏和寄存器宏统一放在头文件里，方便以后换引脚。

#ifndef __DS1302_H #define __DS1302_H #include "main.h" #define DS1302_GPIO_PORT GPIOB #define DS1302_CE_PIN GPIO_PIN_12 #define DS1302_SCLK_PIN GPIO_PIN_13 #define DS1302_IO_PIN GPIO_PIN_14 #define DS1302_ADDR_SEC_W 0x80 #define DS1302_ADDR_MIN_W 0x82 #define DS1302_ADDR_HOUR_W 0x84 #define DS1302_ADDR_DATE_W 0x86 #define DS1302_ADDR_MONTH_W 0x88 #define DS1302_ADDR_DAY_W 0x8A #define DS1302_ADDR_YEAR_W 0x8C #define DS1302_ADDR_WP_W 0x8E #define DS1302_ADDR_BURST_W 0xBE #define DS1302_ADDR_READ(addr) ((addr) | 0x01) typedef struct { uint8_t year; uint8_t month; uint8_t date; uint8_t week; uint8_t hour; uint8_t minute; uint8_t second; } DS1302_Time; void DS1302_SetTime(DS1302_Time *tm); void DS1302_GetTime(DS1302_Time *tm); void DS1302_WriteReg(uint8_t reg, uint8_t dat); uint8_t DS1302_ReadReg(uint8_t reg); #endif

DS1302 的 IO 脚是双向的，写操作时需要推挽输出，读操作时需要改成输入。HAL 库里的 GPIO 初始化结构体可以反复调用，代价很小，我直接在驱动文件里写了两个方向切换函数。

static void DS1302_IO_AsOutput(void) { GPIO_InitTypeDef GPIO_InitStruct = {0}; GPIO_InitStruct.Pin = DS1302_IO_PIN; GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP; GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH; HAL_GPIO_Init(DS1302_GPIO_PORT, &GPIO_InitStruct); } static void DS1302_IO_AsInput(void) { GPIO_InitTypeDef GPIO_InitStruct = {0}; GPIO_InitStruct.Pin = DS1302_IO_PIN; GPIO_InitStruct.Mode = GPIO_MODE_INPUT; GPIO_InitStruct.Pull = GPIO_NOPULL; HAL_GPIO_Init(DS1302_GPIO_PORT, &GPIO_InitStruct); }

有的老手喜欢直接操作寄存器切换方向，速度更快，但要注意 PB14 属于高端口，寄存器位在 CRH 里，不是 CRL。用 HAL 库这种方式完全够用，等跑通了再去追求寄存器级优化也不迟。

3.2 底层读写字节的实现

底层核心就是两个函数：写一个字节、读一个字节。写字节时数据位低位在前，在 SCLK 上升沿被芯片采样。

static void DS1302_DelayUs(uint32_t us) { for (volatile uint32_t i = 0; i < us * 8; i ++); } static void DS1302_WriteByte(uint8_t dat) { for (uint8_t i = 0; i < 8; i ++) { SCLK_LOW(); DS1302_IO_Write(dat & 0x01); DS1302_DelayUs(1); SCLK_HIGH(); DS1302_DelayUs(1); dat >>= 1; } }

读字节时流程反过来，命令字发送完毕后把 IO 切到输入，然后每个时钟周期先拉低 SCLK 让 DS1302 更新输出，再拉高 SCLK 让主机采样。这里的先后顺序不能反，很多首次移植的人读出来乱码，就是因为在下降沿之前就去读 IO。

static uint8_t DS1302_ReadByte(void) { uint8_t dat = 0; DS1302_IO_AsInput(); for (uint8_t i = 0; i < 8; i ++) { SCLK_LOW(); DS1302_DelayUs(1); SCLK_HIGH(); DS1302_DelayUs(1); dat >>= 1; if (DS1302_IO_Read()) dat |= 0x80; } return dat; }

读函数内部的DS1302_IO_AsInput()每次都会被调用，所以外部代码不需要重复切换方向。读完数据之后，CE 拉低之前 IO 保持输入状态没问题，但下一次要发送命令字之前必须确保 IO 切回输出。这个我放到了写命令的入口处统一处理。

3.3 时间写入与读取函数

时间写入我用突发模式。突发写命令 0xBE 发出后，紧接着连续发送 8 个字节，分别是秒、分、时、日、月、星期、年、控制寄存器。第 8 个字节我写 0x00，保证写保护处于打开前的状态，最后再单独关一次写保护。

void DS1302_SetTime(DS1302_Time *tm) { DS1302_CE_HIGH(); DS1302_WriteByte(DS1302_ADDR_WP_W); DS1302_WriteByte(0x00); /* WP = 0，解除写保护 */ DS1302_CE_LOW(); DS1302_CE_HIGH(); DS1302_WriteByte(DS1302_ADDR_BURST_W); /* 时钟突发写命令 */ DS1302_WriteByte(DecToBcd(tm->second)); DS1302_WriteByte(DecToBcd(tm->minute)); DS1302_WriteByte(DecToBcd(tm->hour)); DS1302_WriteByte(DecToBcd(tm->date)); DS1302_WriteByte(DecToBcd(tm->month)); DS1302_WriteByte(DecToBcd(tm->week)); DS1302_WriteByte(DecToBcd(tm->year)); DS1302_WriteByte(0x00); /* 控制寄存器，WP = 0 */ DS1302_CE_LOW(); DS1302_CE_HIGH(); DS1302_WriteByte(DS1302_ADDR_WP_W); DS1302_WriteByte(0x80); /* WP = 1，重新上锁 */ DS1302_CE_LOW(); }

读取时间同样用突发读命令 0xBF，一次性把 8 个字节都读回来，再逐个做掩码和 BCD 转十进制。第 8 个字节是控制寄存器，不参与时间结构体赋值，读完丢弃即可。

void DS1302_GetTime(DS1302_Time *tm) { uint8_t buf[8]; DS1302_CE_HIGH(); DS1302_WriteByte(DS1302_ADDR_BURST_W | 0x01); /* 0xBF，突发读 */ for (uint8_t i = 0; i < 8; i ++) { buf[i] = DS1302_ReadByte(); } DS1302_CE_LOW(); tm->second = BcdToDec(buf[0] & 0x7F); tm->minute = BcdToDec(buf[1] & 0x7F); tm->hour = BcdToDec(buf[2] & 0x3F); tm->date = BcdToDec(buf[3] & 0x3F); tm->month = BcdToDec(buf[4] & 0x1F); tm->week = BcdToDec(buf[5] & 0x07); tm->year = BcdToDec(buf[6]); }

这里的时寄存器掩码0x3F注意要理解。如果你在写入时明确不使用 12 小时制，读出小时数就是正常的 0~23。但万一芯片寄存器里残留了 12 小时制标志，不做掩码处理会显示出一个让人困惑的值，所以我习惯统一清掉高两位。

单字节操作函数我也写了，调试和读写 RAM 的时候会用到：

void DS1302_WriteReg(uint8_t reg, uint8_t dat) { DS1302_IO_AsOutput(); DS1302_CE_HIGH(); DS1302_WriteByte(reg); DS1302_WriteByte(dat); DS1302_CE_LOW(); } uint8_t DS1302_ReadReg(uint8_t reg) { uint8_t dat; DS1302_IO_AsOutput(); DS1302_CE_HIGH(); DS1302_WriteByte(reg | 0x01); dat = DS1302_ReadByte(); DS1302_CE_LOW(); DS1302_IO_AsOutput(); return dat; }

3.4 主程序逻辑与串口输出

主程序里先读一次时间，判断寄存器内容是否合理。如果秒值大于 59 或者所有时间都是 0 的空状态，说明芯片里没有有效初值，这时才写入初始时间。这个判断避免了每次上电都覆盖用户已经调好的时间。

int main(void) { HAL_Init(); SystemClock_Config(); MX_GPIO_Init(); MX_USART1_UART_Init(); DS1302_Time now; DS1302_GetTime(&now); if (now.second > 59 || now.minute > 59 || (now.year == 0 && now.month == 0 && now.date == 0)) { now.year = 25; now.month = 6; now.date = 14; now.week = 6; now.hour = 23; now.minute = 59; now.second = 55; DS1302_SetTime(&now); } while (1) { DS1302_GetTime(&now); printf("20%02d-%02d-%02d %02d:%02d:%02d Week:%d\r\n", 2000 + now.year, now.month, now.date, now.hour, now.minute, now.second, now.week); HAL_Delay(1000); } }

注意 printf 重定向需要实现fputc，否则串口没有输出。我是直接在工程里用微库方式重定向到串口的，烧录后打开串口助手就能看到每秒刷新一行时间。

实测效果：正常走时后，串口每一秒输出一组时间，断电重启后时间不被清零，继续从之前的位置走。

4. 调试实录：常见问题排查与避坑技巧

4.1 读出来全是 0xFF 或 0x00 怎么办

读数据全 0xFF 和全 0x00 是两种完全不同的情况。全 0xFF 大概率是 IO 方向切换出了问题。DS1302 读数据时，IO 应该由芯片驱动，如果主机一直保持推挽输出，读到的就是 GPIO 寄存器里上一次写出去的电平，也就是 FF。我看到很多初学者在刚接触这个芯片时卡在这里，因为 STM32 的 GPIO 默认是推挽输出，他们只在读函数里拉高 SCLK 和 CE，却没有把 IO 配置成输入。

排障顺序建议如下：

1. 量 VCC2 和 GND 电压，确认芯片供电正常。
2. 用万用表通断档检查 CE、SCLK、IO、GND 四根线是否接反。
3. 确认 IO 在 ReadByte 前已经切到输入模式。
4. 用逻辑分析仪抓三根线，对比时序图。

全 0x00 则更像是芯片压根没工作。最常见的坑是 32.768kHz 晶振没起振。没有示波器的话可以先测晶振两脚对地电压，正常时会有零点几伏的压差，如果两脚电压都是 0，基本就是晶振没工作。这时候检查晶振是否焊好、负载电容是否匹配。

4.2 时间不走、秒卡住、分钟不动

时间不走，先检查秒寄存器读出来的值三百六十度转一转，如果一直停在某一个数不动，可能是 CH 暂停位被置 1 了。CH 是秒寄存器最高位，芯片在工作状态会把这一位保持为 0。一旦写入了 0x80 或更高位的秒值，振荡器停振，时间就不再前进。

解决方法是重新写入一个合法的秒值，DecToBcd(second)转换后最高位是 0，写入即恢复。如果用了突发写，要确保第 1 个字节确实是合法的秒寄存器值，不要把结构体里的字段顺序搞错。

另一个隐蔽问题是读时间时把结构体字段赋值顺序写乱。DS1302 突发读返回的顺序是秒、分、时、日、月、星期、年，如果你按年、月、日去对应，就会看到分钟不动、小时乱跳的诡异现象。我在拿到新芯片时习惯先在调试器里连续读 8 个字节，核对每个位置的内容，确认对应关系后再写解析代码。

4.3 写入无效？先查写保护

写入时间后读出来还是旧值，这是写保护没关闭的典型症状。DS1302 的写保护寄存器地址 0x8E，最高位 WP 为 1 时禁止写入。很多贴片的 DS1302 模块上电后 WP 默认状态不确定，所以写时间前必须先写 0x8E、0x00。

另外要注意 CE 时序。一次通信就是一个完整的 CE 高电平区间，命令字和数据必须待在同一个使能窗口内。如果发了命令字之后 CE 掉到低电平，再拉高发数据，芯片会认为这是两次独立的通信，写入自然不会生效。我调试时遇到过模块接触不良导致 CE 抖动，现象也是写入无效，焊牢之后就好了。

4.4 时间误差、晶振电容与软件补偿

DS1302 走时精度完全看晶振。它不像带温补的 RTC 芯片，内部已经有校准逻辑，所以误差主要来自两个方面：晶振本身精度和负载电容匹配。

晶振规格书上通常会标注一个负载电容值，比如最常见的 12.5pF。DS1302 数据手册建议在 X1、X2 引脚对地各接一个电容，电容值按晶振规格选择。我一开始随手用了两个 20pF，结果一天能快十几秒。后来换成 12pF，误差明显缩小，在室内温度稳定的环境下每天偏差能控制在 2 秒以内，完全满足大多数项目的需求。

如果项目对走时精度有更高要求，又不想换温补芯片，可以在软件里做误差补偿。先把设备跑一天，测出现在的一天快慢秒数，然后在定时任务里调整时钟校准的间隔。比如固定每天快 3 秒，就每走 23 小时 59 分 57 秒把时间拨快 3 秒？不对，反了，应该是每天慢 3 秒，就每次整点校准的时候加 3 秒。这些补偿逻辑比较简单，适合定性校准，真正要求严格的场景还是要选带温补的方案。

4.5 备用电池与掉电保持

DS1302 的 VCC1 引脚接 3V 纽扣电池后，主电源断电时时间可以继续走。检查这个功能时，先确认电池正极接 VCC1、负极接 GND，然后直接断开 VCC2 量 DS1302 的功耗，正常应该只有微安级。

特别注意：涓流充电寄存器千万管好。DS1302 支持给可充电镍氢电池或超级电容涓流充电，但这个功能绝不适用于普通一次性纽扣电池。如果不小心配置了涓流充电寄存器，会给不可充电电池持续充电，轻则缩短寿命，重则漏液损坏电路板。驱动代码里我保持该寄存器默认 0x00，只有在你确认自己接了可充电备份电源时，才需要翻阅手册配置对应的充电参数。

我踩过一次这个坑。之前为了让电池在断电时给模块供电，接了一颗可充电的镍氢纽扣电池，又顺手配了涓流充电。结果电池温度明显升高，赶紧拆下来检查，发现充电电流比预估大不少。后来我改用法拉电容做备份电源，再配合涓流充电才放心。如果你也用普通 CR2032，就记住一个字：关。

4.6 一个冷门但很坑的细节：方向切换时机

最后分享一个调试中发现的细节。DS1302 的 IO 在读取结束后，如果主机没有及时切回输出模式，下一次写命令时 IO 状态可能与芯片输出打架。我在最初的代码里是读完字节立即把 IO 切回输出，但时机放在 CE 拉低之前，结果偶发读到错误数据。后来把方向切换放到下一次写命令入口，也就是 CE 拉高之前统一切回输出，问题就消失了。

实际上，DS1302 的 IO 是推挽三态输出，主机不强驱它就能正确读数据。所有方向切换最好避开 CE 高电平的有效通信区间，在 CE 为低的时候切换才是安全的。

最后再讲一点个人体会。DS1302 是一颗很老的芯片，没有温补、没有 I2C、寄存器还是 BCD 格式，技术上没什么酷炫的地方。但它特别适合用来练习嵌入式里的底层基本功：读时序图、做 GPIO 模拟、理解寄存器掩码、处理双向 IO。我建议你把代码跑通之后，用逻辑分析仪抓一次 CE、SCLK、IO 的波形，对照时序图看一遍。这个过程比抄十遍代码都有用，以后再去驱动任何带时序要求的传感器，心里都有底。