STM32驱动DS1302实时时钟芯片：三线协议、寄存器与工程实践

STM32 驱动 DS1302 这个题目，我最早是在做一个小项目时被逼出来的。当时需要一个能在断电后继续走时的时钟底座，翻了一圈元件盒，发现 DS1302 和 DS3231 都有，但 DS1302 只要几毛钱一颗，而且三线串口占用引脚少，果断选了它。驱动代码写完后陆陆续续踩了不少坑，也总结了一些规律，这篇就当成一份学习笔记整理出来，给后来者少走弯路。

DS1302 本身是一颗非常经典的实时时钟芯片，内部带涓流充电电路，可以接一颗纽扣电池或超级电容作为后备电源。主电源掉电后，它会自动切换到后备电源继续走时，这个特性在很多需要记录时间戳的嵌入式设备里非常实用。你不需要使用 STM32 内部的 RTC，也不用去搞外部 32.768kHz 晶振的校准，只要按协议读写寄存器就能拿到年月日时分秒，电源部分做好之后基本不会出大问题。

这篇笔记会从硬件连接开始，把 DS1302 的三线协议、寄存器映射、读写时序全部拆开，然后给出一套可以直接抄走的 STM32 驱动框架，最后重点讲调试时容易踩的坑。内容定位是入门到进阶之间，适合刚接触串行 RTC 芯片的同学，也适合已经驱动过其他 RTC 芯片、想快速上手 DS1302 的开发者。

1. 项目背景与整体设计思路

1.1 为什么选择 DS1302 而不是直接用 STM32 内部 RTC

很多开发者第一反应是用 STM32 自带的 RTC 外设，毕竟不用额外接线、不用花钱买芯片。但实际项目中我仍然偏向用外部 RTC 芯片，理由有这么几个。

STM32 内部 RTC 依赖 VBAT 引脚和外部 32.768kHz 晶振，这个晶振的布局、负载电容、起振条件都比较挑剔，稍不注意就会走时不准。而且内部 RTC 的配置代码在不同系列芯片上差异很大，HAL 库的函数虽然封装好了，但寄存器备份域、电源切换这些概念对初学者来说负担不小。等你把 CubeMX 生成的那一堆代码调通，时间可能已经过去大半天。

DS1302 的优势恰恰在于简单。它的协议就是一根时钟线、一根数据线、一根使能线，逻辑需要自己用 GPIO 模拟，但这反而让代码的可移植性变得极强。换任何一款 MCU，只要会操作 GPIO，半小时内就能把驱动移植过去。再加上它自带涓流充电电路，后备电池可以直接接在 VCC2 上，不需要额外的电源管理芯片，非常适合低成本项目。

另外还有一颗同系列的芯片 DS1307，很多开源项目里也能看到，但 DS1307 是 I2C 接口，而且备份电源切换和涓流充电是靠外部电路实现的，整体 BOM 成本反而高一些。DS1302 的三线接口虽然需要软件模拟，但省引脚、省外围元件，这个取舍在资源紧张的小板卡上非常划算。

1.2 硬件连接与引脚规划

先看一下 DS1302 的典型引脚分配。它一共有 8 个引脚，其中 VCC1 接备份电池或超级电容，VCC2 接主电源，GND 接地，X1 和 X2 接 32.768kHz 晶振，另外三个就是通信引脚：CE、SCLK、I/O。有些封装上还会把 CE 标成 RST，其实是一个东西，控制通信使能。

我常用的接法是 STM32 主控和 DS1302 共用 3.3V 电源，VCC1 接一颗 CR1220 纽扣电池或者 0.1F 超级电容，晶振选 6pF 负载电容的型号，并联两颗 15~20pF 的电容到地。通信引脚分配如下：

这里特别提醒一句，I/O 引脚建议配成开漏输出而不是推挽输出。因为 DS1302 的数据线是双向的，主机读数据时引脚要作为输入，主机写数据时引脚要作为输出。开漏模式加上外部上拉电阻，切换输出和输入时不会出现对推的现象，也避免输出模式时两个设备同时驱动一根线的风险。如果板子空间紧张，内部上拉在 3.3V 下也能用，但寄存器读回时信号边沿会偏软，建议优先用外部 10kΩ 上拉。

1.3 数据手册里最值得反复看的三张图

DS1302 的数据手册不长，十几页，但有三张图一定要打印出来放桌上，分别是命令字节格式图、寄存器地址映射表、读写时序图。

命令字节格式图决定了你这串驱动代码怎么组织位顺序。DS1302 每个传输周期先发一个命令字节，高四位是控制码，默认固定为 100x，接着是寄存器地址，最后是读/写控制位。重点人容易忘的是，这个命令字节是按照LSB first一位一位发出的，也就是最低位先发出，后面每组数据也一样。

寄存器地址映射表列出了秒、分、时、日、月、周、年的读地址和写地址，以及写保护寄存器、涓流充电寄存器、突发模式的地址。这张表建议每个字节都手推一遍，很多人卡在“读完秒寄存器读出来是 0xFF”这个问题上，最后查出来都是地址写错了。

读写时序图则清晰展示了 CE、SCLK、I/O 三个信号之间的相位关系。后面我会单独讲，这里先记住一个原则：CE 拉高后，SCLK 的第一个上升沿传输命令字节的最低位，后续每个上升沿按位传输，写完所有位之后 CE 拉低表示一帧结束。读操作时，数据在 SCLK 的下降沿之后被 DS1302 输出，主机需要在下一次上升沿前把数据采走。

2. 核心协议与寄存器拆解

2.1 三线接口到底是怎么回事

DS1302 的三线接口由 CE、SCLK、I/O 三个信号构成，功能上类似 SPI，但并不是标准 SPI 接口。网上有些驱动直接使用 STM32 的硬件 SPI 外设去操作，我也试过，能跑通，但总觉得别扭，因为 DS1302 的时序和 SPI Mode 0 或 Mode 3 不完全一致，尤其在读数据阶段，数据输出的时刻落在 SCLK 下降沿，硬件 SPI 配置稍不留神就会采到不对的边沿。

三线接口的核心思想很简单：CE 拉高，开始一帧通信；SCLK 提供时钟脉冲；I/O 线上一位一位地传数据。所有数据都是低字节在前，发送命令字节时先发最低位。比如要读秒寄存器，命令字节是 0x81，发送时先发出 bit0，最后一个 bit 是 bit7。这个顺序千万别和习惯的 MSB first 搞混。

为了让你理解得更透彻，我们把一次读操作拆成两个阶段。第一个阶段，主机在 SCLK 的上升沿把命令字节的 8 位数据送到 I/O 线上，DS1302 在上升沿采样。第二个阶段，主机继续输出 8 个 SCLK 脉冲，但此时 I/O 方向已经切换成输入，DS1302 在 SCLK 下降沿之后把数据放到线上，主机在下一次 SCLK 上升沿时读取这个值。

这个波形结构让我想到一种场景：先把“咱们要读哪个地址”喊出去，然后对方在约定好的节拍里把内容报给你。只要节拍不乱，数据就不会错。

2.2 命令字和寄存器地址怎么算出来的

DS1302 的数据手册把寄存器地址写得比较散，初次接触很容易记混。我用一张表把它整理清楚，表和手册稍有差别，但更利于理解。

地址规律可以自己推一下。寄存器基础地址是 0x80，写入时最低位 bit0 固定为 0，读取时最低位 bit0 固定为 1。比如秒寄存器基础地址 0x80，写秒是 0x80，读秒是 0x81。你会发现写地址全是偶数、读地址全是奇数，就是因为最低位在作怪。时钟突发模式的基础地址是 0xBE，读突发地址是 0xBF。

命令字节的最高位 bit7 是控制逻辑固定的 1。也就是说，发送的完整命令字节 = 地址右移 1 位后拼上读/写位，或者直接查表。我因为偷懒不想查表，在代码里直接写死对应宏定义，但要注意寄存器基础地址可能因 DS1302 批次不同有微小差异，买芯片时一定要核对数据手册的版本。

另外提一下，写保护寄存器是很多人调通的最后一道坎。DS1302 出厂或者某些应用场景下写保护默认使能，这时你对时间寄存器写入的数据会被忽略。所以初始化代码里第一步就是把写保护关掉，写入 0x00。否则你会发现代码怎么调，时间都是纹丝不动。

2.3 BCD 码与时间进制转换

第一次操作 DS1302 的人最容易在编码上翻车。DS1302 内部存放的时间数据不是你熟悉的二进制数字，而是 BCD 码。所谓 BCD 码，就是把十进制数的每一位分别用 4 位二进制数表示。比如 59 秒，拆成“5”和“9”，分别用 0101 和 1001 表示，合并起来就是 0x59。

你向 DS1302 写入小时寄存器时，如果直接写 int 类型的 8，发送到总线上的是 0x08，这个没错，因为 8 是一位数。但当你写入分钟 12 时，直接发送 0x0C，那就错了，DS1302 会把这个值当成十进制的 0 到 9 之外的数据，行为不可预知。正确写法应该发送 0x12。

把 0~99 的十进制数转成 BCD 码的公式很简单：

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

公式虽然简单，但一定要在驱动里封装好，不要在业务代码里到处写裸的位运算。我记得有一次在显示时间时，直接把读回来的 BCD 值当作十进制去计算，结果屏幕上出现了很多不存在的分钟数，排查了十分钟才发现是这里的问题。

3. 实操过程与代码实现

3.1 基础工程搭建与引脚配置

我使用的 MCU 是 STM32F103C8T6，开发环境是标准外设库。用 CubeMX 也可以，但本质都是把 PB12 配成推挽输出、PB13 推挽输出、PB14 开漏输出。

如果用 CubeMX，配置流程非常简单：

1. 在 System Core 里选择 GPIO。
2. 将 PB12、PB13、PB14 都配置为 GPIO_Output。
3. PB12 和 PB13 输出类型选 Push Pull，最大速率可选 Low。
4. PB14 输出类型选 Open Drain，并确认外部已经接了上拉电阻。
5. 三个引脚的初始电平都设成 Low。

如果你习惯直接操作寄存器，下面这段 GPIO 初始化代码可以直接用，我把它放在工程里对应ds1302.h的同名.c文件中：

#include "stm32f10x.h" #include "ds1302.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_CE_HIGH() GPIO_SetBits(DS1302_GPIO_PORT, DS1302_CE_PIN) #define DS1302_CE_LOW() GPIO_ResetBits(DS1302_GPIO_PORT, DS1302_CE_PIN) #define DS1302_SCLK_HIGH() GPIO_SetBits(DS1302_GPIO_PORT, DS1302_SCLK_PIN) #define DS1302_SCLK_LOW() GPIO_ResetBits(DS1302_GPIO_PORT, DS1302_SCLK_PIN) static void DS1302_IO_OUT(void) { GPIO_InitTypeDef GPIO_InitStructure; GPIO_InitStructure.GPIO_Pin = DS1302_IO_PIN; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP; GPIO_InitStructure.GPIO_Speed = GPIO_Speed_2MHz; GPIO_Init(DS1302_GPIO_PORT, &GPIO_InitStructure); } static void DS1302_IO_IN(void) { GPIO_InitTypeDef GPIO_InitStructure; GPIO_InitStructure.GPIO_Pin = DS1302_IO_PIN; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IPU; GPIO_Init(DS1302_GPIO_PORT, &GPIO_InitStructure); } void DS1302_Init(void) { GPIO_InitTypeDef GPIO_InitStructure; RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOB, ENABLE); GPIO_InitStructure.GPIO_Pin = DS1302_CE_PIN | DS1302_SCLK_PIN; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP; GPIO_InitStructure.GPIO_Speed = GPIO_Speed_2MHz; GPIO_Init(DS1302_GPIO_PORT, &GPIO_InitStructure); DS1302_IO_OUT(); DS1302_CE_LOW(); DS1302_SCLK_LOW(); DS1302_IO_LOW(); }

这里用到的 Pin 定义和位带操作省略了，不同库函数版本略有差异，但思路一致。注意 CE 和 SCLK 务必先拉低，再初始化 I/O 方向，避免上电时信号线上出现毛刺导致 DS1302 误触发通信。

3.2 核心时序函数：读写一个字节

驱动 DS1302 的重头戏是三个底层函数：写命令字节、写数据字节、读数据字节。这三个函数跑通了，上面的寄存器地址只是套壳而已。

先看写一字节函数。它的原理是在每个 SCLK 上升沿之前把数据放到 I/O 线上，一个时钟一次数据。由于 DS1302 是最低位先接收，所以每次把当前位放到 I/O 线上后，需要把数据右移一位：

static void DS1302_Delay(void) { for (volatile int i = 0; i < 100; i++); } static void DS1302_WriteByte(uint8_t data) { for (int i = 0; i < 8; i++) { if (data & 0x01) DS1302_IO_HIGH(); else DS1302_IO_LOW(); DS1302_SCLK_HIGH(); DS1302_Delay(); DS1302_SCLK_LOW(); DS1302_Delay(); data >>= 1; } }

这段代码的逻辑是先把最低位放到 IO 上，然后 SCLK 拉高，DS1302 在上升沿采样，随后拉低准备下一位。延时函数里我写了一个空循环，实际项目中可以根据系统时钟换算成微秒延时，但通常 1~5 微秒就够，不需要刻意加延时。

读一个字节的函数稍微复杂，因为读字节前半段是主机继续发时钟，后半段要把 IO 切换成输入模式。网上很多实现是把读字节分成两个函数，一个读命令字节、一个读数据字节，但本质一样。我这里直接写一个函数，形参传入命令字节，返回读到的数据：

static uint8_t DS1302_ReadByte(uint8_t command) { uint8_t value = 0; uint8_t i; DS1302_CE_HIGH(); DS1302_WriteByte(command); DS1302_IO_IN(); for (i = 0; i < 8; i++) { value >>= 1; if (DS1302_IO_READ()) value |= 0x80; DS1302_SCLK_HIGH(); DS1302_Delay(); DS1302_SCLK_LOW(); DS1302_Delay(); } DS1302_IO_OUT(); DS1302_CE_LOW(); return value; }

这里有个细节：读数据时不能在 SCLK 上升沿之后才去读取 IO 电平，而应该在这个上升沿之前读走上一拍的数据。所以代码里先value >>= 1，再读取当前 IO，然后给 SCLK 一个上升沿。DS1302 数据手册上说，数据在 SCLK 下降沿之后有效，因此主机应该在 SCLK 低电平期间把 IO 采样进来，等拉高后准备下一次移位。

3.3 寄存器读写封装：单字节读、单字节写、突发模式

底层函数有了，接下来封装面向时间的寄存器操作。单字节写函数的逻辑是：CE 拉高，发送写命令，发送数据，CE 拉低。读函数则直接调用上面的 ReadByte。

static void DS1302_WriteReg(uint8_t cmd, uint8_t data) { DS1302_CE_HIGH(); DS1302_WriteByte(cmd); DS1302_WriteByte(data); DS1302_CE_LOW(); } static uint8_t DS1302_ReadReg(uint8_t cmd) { uint8_t data; DS1302_CE_HIGH(); data = DS1302_ReadByte(cmd); DS1302_CE_LOW(); return data; }

注意读寄存器时，DS1302_ReadByte内部已经做了一次 CE 拉高和拉低，所以外面不能再重复拉高。上面这段代码的DS1302_ReadByte实现里包含完整的读帧流程。如果你的实现把命令发送和数据读取分开，那就要自己保证 CE 在整个读操作期间保持高电平。

突发模式稍微特殊一点。它允许你连续读写 8 个时间寄存器，命令字节是 0xBE（写）或 0xBF（读）。写突发模式时，第一个数据字节对应秒寄存器，之后依次是分、时、日、月、周、年、控制。读突发模式的 8 个字节也对应同样的顺序。这个功能在需要一次性读取完整时间然后做显示刷新时很有用，能省下 7 次 CE 切换。

void DS1302_GetTime(DS1302_Time *time) { uint8_t buf[8]; uint8_t i; DS1302_CE_HIGH(); DS1302_WriteByte(0xBF); DS1302_IO_IN(); for (i = 0; i < 8; i++) { buf[i] = DS1302_ReadByte_Data(); } DS1302_IO_OUT(); DS1302_CE_LOW(); time->second = bcd_to_dec(buf[0] & 0x7F); time->minute = bcd_to_dec(buf[1] & 0x7F); time->hour = bcd_to_dec(buf[2] & 0x3F); time->day = bcd_to_dec(buf[3] & 0x3F); time->month = bcd_to_dec(buf[4] & 0x1F); time->week = bcd_to_dec(buf[5] & 0x07); time->year = bcd_to_dec(buf[6]); }

突发模式读的时候有另一个坑：读回的第一个字节是秒寄存器，但秒寄存器的最高位是时钟暂停标志。正常走时时这个位是 0，读出来需要buf[0] & 0x7F过滤掉，否则如果秒值超过 70，转换出来的十进制数会完全不对。小时寄存器的 bit7 是 12/24 小时制标志，所以读小时时也要屏蔽掉 bit7。日寄存器可能带 bit7 作为有效年份范围标志，也一并处理。

3.4 完整驱动框架：初始化、设置时间、读取时间

驱动整体可以封装成一个ds1302.c，对外暴露三个接口：初始化、设置时间、读取时间。上面已经给了初始化函数，下面把设置时间补齐：

typedef struct { uint8_t year; // 00~99 uint8_t month; // 01~12 uint8_t day; // 01~31 uint8_t week; // 01~07 uint8_t hour; // 00~23 uint8_t minute; // 00~59 uint8_t second; // 00~59 } DS1302_Time; void DS1302_SetTime(const DS1302_Time *time) { DS1302_WriteReg(0x8E, 0x00); // 关闭写保护 DS1302_WriteReg(0x80, ((time->second / 10) << 4) | (time->second % 10)); DS1302_WriteReg(0x82, ((time->minute / 10) << 4) | (time->minute % 10)); DS1302_WriteReg(0x84, ((time->hour / 10) << 4) | (time->hour % 10)); DS1302_WriteReg(0x86, ((time->day / 10) << 4) | (time->day % 10)); DS1302_WriteReg(0x88, ((time->month / 10) << 4) | (time->month % 10)); DS1302_WriteReg(0x8A, time->week); DS1302_WriteReg(0x8C, ((time->year / 10) << 4) | (time->year % 10)); DS1302_WriteReg(0x8E, 0x80); // 恢复写保护 }

设置时间时，我习惯在写完数据之后就立即恢复写保护。虽然接下来不会立刻再写，但这个习惯能在后续代码维护时避免无意中覆盖时间。设置时间的顺序没有什么严格要求，因为 DS1302 内部寄存器是独立的，写入秒寄存器不会影响分寄存器。

初始化函数里可以加一个“首次上电检测”的逻辑。读一次秒寄存器，如果读出来的值大于等于 0x80，说明时钟处于暂停状态。此时可以用一个默认编译时间把时钟初始化好。但这个逻辑要小心，因为如果用户断电后电池没电，重新上电也会触发这个判断，而默认编译时间可能不是用户预期的当前时间。我一般做法是：预留一个用户在初始化前手动调时间的接口，让上层决定要不要覆盖。

3.5 主程序调用示例与 UART 打印

主程序里使用这个驱动很简单。先定义时间结构体，设置一次初始时间，然后循环读取并打印：

int main(void) { DS1302_Time now_time; DS1302_Init(); USART1_Init(); now_time.year = 24; now_time.month = 5; now_time.day = 18; now_time.week = 6; now_time.hour = 21; now_time.minute = 30; now_time.second = 00; DS1302_SetTime(&now_time); while (1) { DS1302_GetTime(&now_time); printf("20%02d-%02d-%02d %02d:%02d:%02d Week:%d\r\n", now_time.year, now_time.month, now_time.day, now_time.hour, now_time.minute, now_time.second, now_time.week); delay_ms(1000); } }

打印输出会每秒更新一次，说明驱动已经正常工作。如果你用的是半主机模式，记得在工程里重定向fputc或者直接用串口发送函数，这里不再展开。

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

4.1 时间不走，读回的时间和写入时一模一样

这个问题很多人遇到过，包括我自己第一次调的时候也栽了跟头。表象是写入某个时间后，读回来确实是你写的值，但等几秒再读，数据完全没变，时间根本没有流逝。

先不要怀疑晶振，先查“时钟暂停位”。秒寄存器 bit7 是时钟暂停标志，这一位为 1 时时钟停止走时。如果初始化时写入的是十进制转 BCD 的秒值，而秒值超过了 59 或者转换函数写错，把 bit7 置上去了，芯片自然不走。

如果是这样，读回来的秒值要么是大于 59 的 BCD 值，要么会和写入值一直保持一致。检查方法很简单：连续读两次秒寄存器，间隔 1 秒，看数值变不变。如果完全不变，再查软件里是否只用0x80命令写了秒寄存器最高位。正常情况下，往秒寄存器写入 0x80 是停止时钟，写入 0x00 是启动时钟。我建议设置时间的代码强制让秒寄存器最高位为 0，比如((second / 10) << 4) | (second % 10)这个公式无论如何都没把最高位置 1，所以不会误停钟。

排除完暂停标志，再看晶振。用示波器量 X2 引脚，能看到 32.768kHz 的方波说明晶振在振荡。没有示波器的话，可以用耳机放大电路去听晶振频率，但这招太老土了。更实际的判断是看读回来的秒值变化快慢，比如每秒钟走两秒，那大概率是晶振频率偏了，或者负载电容配得不对。DS1302 对晶振的负载电容要求比较宽松，但太小会导致不起振，太大会导致走时偏慢，一般 6pF 到 12.5pF 都能正常工作。

另一个容易忽略的地方是后备电池。如果 VCC1 电压过低，DS1302 在掉电切换时可能进入异常状态，主电源恢复后时钟也不走。这种问题在开发板上不常见，但在使用超级电容的场合特别容易出现，超级电容充满后电压只有 2.5V 左右，低于 DS1302 的最低工作电压 2.0V 时系统仍然能走，但时间精度会掉。

4.2 读出来全是 0xFF 或者 0x00

读出来是 0xFF，往往是 IO 引脚配置或者延时不够的问题。读数据阶段，主机已经把 IO 切换成输入，DS1302 会在 SCLK 下降沿把数据放到 IO 上，如果主机在 SCLK 高电平期间才读取 IO，这时 DS1302 已经释放总线了，读到的就可能是悬空电平。解决方法是把读时序改成“先读数据，再拉高 SCLK”的顺序。

读出来是 0x00 时，大概率是命令字节没发对。CE 拉高后第一发的是命令字节，如果你发送命令字节时把地址和读写位拼错了，DS1302 会直接忽略后面的数据时钟，返回的字节就全是 0。我建议在驱动里加一个DS1302_ReadReg(0x8F)的测试，读出的写保护寄存器如果等于 0x80 或 0x00，说明通信链路是通的。如果不通，优先检查三个 GPIO 是不是真的配置成了对应的模式，尤其是开漏输出和上拉输入这两种状态是否切换正确。

很多国产 STM32 开发板把 DS1302 的 IO 引脚默认接了一个 LED 或者电容负载，也会导致电平读不准。排查这类问题，用一根杜邦线外接一个 10kΩ 上拉电阻，通常就能缓解。如果上拉电阻的位置离 DS1302 太远，线长超过 20cm，三线信号之间还会出现串扰，这时可以把 SCLK 和 IO 的布线距离拉开，或者把 SCLK 的频率放慢一点。

4.3 写入失败，写保护寄存器关不掉

DS1302 的写保护寄存器地址是 0x8E，写 0x00 才能关闭写保护。但有个容易出错的地方：写保护寄存器本身也是受写保护控制的。也就是说，如果你当前时间设置操作在一个已经启用了写保护的状态下进行，那么你连写保护寄存器都改不了。所以驱动里最好先专门执行一次DS1302_WriteReg(0x8E, 0x00)，然后再写时间，而不是在某些条件下才去关写保护。

另一个写失败的常见原因是你把写地址和读地址搞反了。DS1302 的秒写地址是 0x80，读地址是 0x81。如果你写秒用 0x81，那芯片会把它当作读操作，数据根本进不去。查这个问题可以直接用二进制计算，或者对照我上面那张表逐项核对。

写保护之外，时间写入还可能因为分钟或秒寄存器写入不完整而失败。DS1302 内部在某一秒开始的时候会把秒寄存器的计数写入寄存器，如果你恰好在进位瞬间写入数据，可能产生一帧数据的部分丢失。这个问题概率极低，但为了避免驱动在实时系统中出现偶发问题，常见做法是写入前关闭秒中断，写入后再恢复。

4.4 与 STM32 低功耗模式、看门狗的冲突

DS1302 的驱动本身很简单，但放进真实项目时还会和系统其他部分打架。

第一个坑是低功耗模式。STM32 进入 Stop 模式后，GPIO 的推挽输出会保持电平，但如果 IO 配置成了开漏且内部上拉关闭，它可能变成浮空，导致 DS1302 误认为有通信。解决办法是进入低功耗前把 CE、SCLK、IO 全部拉低，并确保 IO 处于输出模式。退出低功耗后重新初始化这三个引脚。

第二个坑是看门狗。有些看门狗复位周期很短，而 DS1302 的写操作必须保证在 CE 拉高到 CE 拉低这一整段时间内不被中断。如果看门狗在全速运行时复位了 MCU，DS1302 的通信状态机会卡在一个半途状态，下次通信就会异常。建议把 DS1302 读写函数设计成原子操作，在进入读写之前关掉中断，退出后恢复中断。这个措施看起来粗暴，但在实时性要求不高的场合很实用。

第三个坑是打印调试时用阻塞式 UART。如果你在循环里读取 DS1302 时间后立即调用阻塞式串口打印，串口速度很低时整个循环周期会被拉长，但你延时函数仍然按 1000ms 计算，时间显示的刷新间隔会变得不规律。这个不是 DS1302 的错，而是调试方式的坑，用中断方式发送或者把打印频率降低到每 5 秒一次就能观察出真实走时情况。

4.5 常见问题速查表

最后分享一个我实际用下来的小技巧

驱动 DS1302 这类三线串行芯片，不要上来就写完整代码，先把读写一个字节的底层函数用 GPIO 翻转的简单例程验证到位。底层没问题，再往上封装寄存器操作，这样排查速度最快。还有一个经验是 DS1302 的 CE 拉低后要留一小段高阻时间，连续两次通信之间最好有几个微秒的间隔，否则第二次通信的第一位很容易被上一次的电平残留干扰。

我习惯在代码里把 CE、SCLK、IO 三个宏单独抽出来，方便扩展到其他 MCU。以后从 STM32F1 换到 GD32、AT32 或者其它国产 Cortex-M 内核芯片，只需要改宏定义和延时函数即可，驱动主体完全不用动。这个设计思路同样适用于 DS1307 和三线温湿度传感器，遇到类似器件时可以完全复用。