做单片机开发这几年我发现自己越来越喜欢实时时钟RTC这一类的“小东西”。它们功能单一、逻辑清晰、验证起来也不绕弯子特别适合用来练驱动功底。前阵子群里好几个朋友在问 STM32 怎么驱动 DS1302我索性把之前写过的一套驱动整理成了开源学习笔记用了最经典的 STM32F103 最小系统板做验证代码全部放在公开仓库里标题就是 “STM32 驱动 DS1302 [开源|学习笔记]”。这个项目最核心的价值在于DS1302 是一颗带 SPI 味道但又不是标准 SPI 的串行 RTC 芯片驱动它需要你手工模拟时序、处理 BCD 码、操作寄存器还要想清楚 GPIO 方向切换。这些全是最底层的嵌入式基本功而 DS1302 足够简单不会像网卡或者屏幕驱动那样让你一头扎进复杂协议里出不来。所以无论你是刚点亮过 LED、想进一步接触“有时序要求的芯片通信”还是已经写过几个外设驱动、想补一补 RTC 细节这套代码和笔记都值得拿去看一看。在正式往下写之前先把这套驱动当时的设计思路、硬件接线、完整代码和踩坑过程一次讲清楚所有代码都基于 HAL 库的 GPIO 操作方便你移植到 F1、F4 甚至 G0 系列上。1. 项目整体设计与思路拆解1.1 为什么选 DS1302而不是 DS3231 或 PCF8563RTC 芯片的选择其实很多常见的还有 DS3231、PCF8563、RX8025 等等。我在学习笔记里选 DS1302不是因为它在参数上有多能打而是因为它太适合教学了。先说 DS3231内置温补晶振年误差能控制在几分钟以内精度确实优秀但它走的是 I2C 接口而且芯片手册里寄存器一堆初学者看到英文手册第一反应往往是翻到示例代码直接 copy。PCF8563 同样是 I2C行为和 I2C 总线上的标准从机差不多I2C 总线协议本身反而成了主要学习点。DS1302 不一样。它的接口看起来像 SPI三条线分别是 CE芯片使能、SCLK串行时钟、IO数据线但是读写操作的命令字格式、字节传输顺序、以及 IO 方向在读写时需要切换这些都和标准 SPI 有区别。驱动它不能直接开 STM32 的硬件 SPI 外设搞定只能老老实实用 GPIO 模拟时序。模拟时序这件事恰恰是嵌入式开发里最值得反复练习的技能。你理解了时钟上升沿采样、下降沿输出这个概念之后以后去驱动 WS2812、DHT11、各种单总线或者类 SPI 器件思路是完全相通的。DS1302 的另一大优势是电路简单。只需要一颗 32.768kHz 晶振加两个 6pF 到 10pF 的负载电容再接几根杜邦线十分钟之内就能在面包板上搭起来。功耗方面DS1302 在备用电源模式下电流只有微安级别普通 CR2032 纽扣电池可以撑好几年所以课程设计或小型嵌入式项目里它出现的频率一直很高。1.2 为什么用 GPIO 模拟时序而不是开硬件 SPI 外设这是个很关键的设计决策也是评论区经常被问到的点“DS1302 不是可以和 SPI 兼容吗为什么不开 SPI1”从数据手册来看DS1302 确实被某些资料称为“三线 SPI 兼容接口”但它并不符合 SPI 的完整规范。首先是数据线方向问题标准 SPI 用 MOSI 和 MISO 分开收、发而 DS1302 只有一根 IO 线读写方向必须由主机控制切换。这意味着即使你用了硬件 SPI也只能在单线半双工模式下折腾而 STM32 的 SPI 外设虽然支持半双工却需要在收发之间不断切换方向、处理引脚配置反而比 GPIO 模拟更繁琐。其次是命令字格式和字节边界问题。DS1302 的每一次访问都由“一个命令字节 一个或多个数据字节”组成命令字节里区分了时钟寄存器和 RAM 寄存器、读还是写这些用 GPIO 模拟非常自然把时序函数封装好之后读哪个寄存器、写什么值一目了然。而用硬件 SPI 时断开和恢复连接、控制 CE 高低、处理读写切换反而会让代码变得不好理解。从教学角度看我的结论很明确用 GPIO 模拟不是为了炫技而是让学习者直观地看到“通信协议到底是怎么在线上表达的”。当你亲手用代码把 SCLK 拉高拉低、把每一个 bit 送到 IO 线上时所谓“时序”就不再是抽象概念了。1.3 开源驱动模块的接口划分这套学习笔记里的驱动我按“底层时序→寄存器操作→上层时间 API”三层来组织。底层时序负责 GPIO 的拉高拉低、方向切换和字节读写寄存器操作在底层之上完成对 DS1302 内部各寄存器的读写最上层则是面向使用者的时间设置与读取接口。这么分层的好处很直接如果你要移植到别的 MCU只需要改动底层几个宏和延时函数寄存器层和 API 层基本不用动如果你是新手可以从底层一路往上读每一层代码都不长沒有一步到位、看完一脸懵的问题。仓库里我放了完整的ds1302.c、ds1302.h和带串口打印的main.cKeil 工程和 CMake 工程各一份打开就能编译烧录。2. 硬件连接与电路设计要点2.1 DS1302 引脚功能与双电源结构DS1302 常见的封装是 DIP-8一共 8 个引脚。VCC2 是主电源VCC1 是备用电源接纽扣电池X1 和 X2 之间接 32.768kHz 晶振GND 接地剩下的 CE、SCLK、IO 是串行三线接口。这里有个不太起眼但非常容易踩坑的点DS1302 采用双电源供电芯片内部会自动选择电压较高的一侧供电。正常工作时 VCC2 接 3.3V 或 5VVCC1 接 3V 纽扣电池当系统断电VCC2 跌落芯片自动切换到 VCC1 的电池供电时间信息才能继续维持。如果你只接 VCC2 不接 VCC1一旦主电源断开计时数据立刻丢失。我在测试时如果不加电池会把 VCC1 和 VCC2 都接到 3.3V 上这样断电时间会丢但正常上电使用没有任何问题。做课程设计或者成品项目时建议老老实实加一个 CR2032 电池座。另外 VCC1 和 VCC2 之间要加一个 0.1uF 的去耦电容尽量靠近芯片引脚放置这在晶振旁边也很常见可以有效减少电源纹波干扰。2.2 STM32 接线表与供电设计我验证用的板子是 STM32F103C8T6 最小系统板DS1302 模块是淘宝常见的 DIP 直插小板上面已经配好晶振和电容。接线方式非常直白DS1302 引脚STM32 引脚说明VCC23.3V主电源DS1302 支持 2.0V~5.5VVCC13V 纽扣电池正极备用电源可选但不接会掉电丢时间GNDGND共地CEPA0片选/使能信号SCLKPA1串行时钟IOPA2串行数据线如果你的 DS1302 模块上已经有上拉电阻那么 IO 线不需要再加外部上拉如果用的是裸芯片加面包板建议在 IO 线上加一个 4.7kΩ 到 10kΩ 的上拉电阻到 VCC2。因为 IO 在读取模式下是高阻输入状态没有上拉时电平不确定读出来的数据会随机跳变。电平匹配也要留意。STM32F103 的 GPIO 是 3.3V 逻辑DS1302 在 3.3V 供电下同样以 3.3V 逻辑运行直接相连非常安全。如果你不小心把 DS1302 的 VCC2 接到 5V而 STM32 是 3.3V 的 IO那两者之间就需要做电平转换或者至少用电阻分压把 DS1302 拉高的 IO 电平降下来否则长期运行可能损伤 STM32 的引脚。后面我会在第 4 节的“5V 供电问题”里展开。2.3 晶振、负载电容与上拉电阻的选择DS1302 对晶振的要求是 32.768kHz这是 RTC 芯片的标准频率。教学模块上一般都已经焊好了晶振和两个负载电容电容值常见的是 6pF 到 12.5pF。如果你是自己画板子晶振要尽量靠近 X1、X2 引脚走线短而粗电容的一端分别接晶振两端另一端接地形成并联谐振回路。关于晶振还有一个常见争论不接负载电容能不能起振答案是可以但频率精度会变差而且抗干扰能力弱。DS1302 内部集成了偏置电路裸晶振在某些情况下也能跑起来但相位裕度不足时可能偶尔不振或振幅偏低。所以最稳妥的做法是严格按照手册接两个 6pF 电容不要省略。IO 上拉电阻的作用前面已经提过了再说一个细节上拉电阻的取值不宜太小否则读模式下 IO 被外部上拉到高电平而 DS1302 输出低电平时需要额外吸收电流可能造成低电平被判高。4.7kΩ 到 10kΩ 这个区间是我实测过比较稳的范围。3. 核心代码实现与原理剖析3.1 三线时序的模拟实现DS1302 的时序可以从一个很高的角度理解成CE 从低拉高后启动一次通信SCLK 提供时钟节拍IO 线上按照“命令字节 数据字节”的顺序一位一位地传输数据。写入时主机在 SCLK 上升沿之前把数据准备好SCLK 上升沿到来后 DS1302 采样 IO读取时DS1302 在 SCLK 下降沿之后更新 IO 电平主机在 SCLK 低电平期间读取 IO。所有字节都是低位在前最高位先发。底层的宏和延时函数在ds1302.h里定义。下面是一份基于 STM32 HAL 库的写法/* DS1302 引脚宏定义 */ #define DS1302_GPIO_PORT GPIOA #define DS1302_CE_PIN GPIO_PIN_0 #define DS1302_SCLK_PIN GPIO_PIN_1 #define DS1302_IO_PIN GPIO_PIN_2 /* IO 引脚方向模式 */ #define DS1302_IO_MODE_OUT 0 #define DS1302_IO_MODE_IN 1 /* 基础电平操作 */ #define DS1302_CE_HIGH() HAL_GPIO_WritePin(DS1302_GPIO_PORT, DS1302_CE_PIN, GPIO_PIN_SET) #define DS1302_CE_LOW() HAL_GPIO_WritePin(DS1302_GPIO_PORT, DS1302_CE_PIN, GPIO_PIN_RESET) #define DS1302_SCLK_HIGH() HAL_GPIO_WritePin(DS1302_GPIO_PORT, DS1302_SCLK_PIN, GPIO_PIN_SET) #define DS1302_SCLK_LOW() HAL_GPIO_WritePin(DS1302_GPIO_PORT, DS1302_SCLK_PIN, GPIO_PIN_RESET) static void DS1302_Delay(void) { volatile uint8_t i 20; while (i--) { ; } }这个延时函数没有精确到纳秒它的作用只是把 SCLK 的周期压到 1MHz 以下的量级。DS1302 在 2V 供电时的最大时钟频率大约是 2MHz3.3V 供电时略高一些我们用 GPIO 模拟到几百 kHz 完全没有风险。如果你换了高速的 MCU 或者引脚翻转速度很快可以把这个循环次数加大保证 SCLK 高电平和低电平的脉宽都足够稳定。IO 方向切换用 HAL 库的 GPIO 初始化函数实现void DS1302_IO_Mode(uint8_t mode) { GPIO_InitTypeDef GPIO_InitStruct {0}; GPIO_InitStruct.Pin DS1302_IO_PIN; if (mode DS1302_IO_MODE_OUT) { GPIO_InitStruct.Mode GPIO_MODE_OUTPUT_PP; GPIO_InitStruct.Pull GPIO_NOPULL; GPIO_InitStruct.Speed GPIO_SPEED_FREQ_HIGH; } else { GPIO_InitStruct.Mode GPIO_MODE_INPUT; GPIO_InitStruct.Pull GPIO_PULLUP; } HAL_GPIO_Init(DS1302_GPIO_PORT, GPIO_InitStruct); }注意读模式我这里开了内部上拉。这是因为有些模块 IO 线的外部上拉电阻是焊在模块上的有些没有在代码里开内部上拉可以让“裸芯片 杜邦线”的桌面测试环境更稳定。实际产品上如果再外接 10kΩ 上拉内部上拉可以不开二者并行也不会有什么问题。3.2 寄存器读写与 BCD 码转换DS1302 写一个字节、读一个字节的底层实现如下static void DS1302_WriteByte(uint8_t dat) { uint8_t i; for (i 0; i 8; i) { if (dat 0x01) { HAL_GPIO_WritePin(DS1302_GPIO_PORT, DS1302_IO_PIN, GPIO_PIN_SET); } else { HAL_GPIO_WritePin(DS1302_GPIO_PORT, DS1302_IO_PIN, GPIO_PIN_RESET); } DS1302_Delay(); DS1302_SCLK_HIGH(); DS1302_Delay(); DS1302_SCLK_LOW(); DS1302_Delay(); dat 1; } } static uint8_t DS1302_ReadByte(void) { uint8_t i, dat 0; for (i 0; i 8; i) { dat 1; DS1302_SCLK_HIGH(); DS1302_Delay(); if (HAL_GPIO_ReadPin(DS1302_GPIO_PORT, DS1302_IO_PIN) GPIO_PIN_SET) { dat | 0x80; } DS1302_SCLK_LOW(); DS1302_Delay(); } return dat; }写字节时每个 bit 先在 SCLK 低电平期间放到 IO 上然后 SCLK 拉高DS1302 在上升沿采样再拉低。整个过程是标准的“先置数据、再给时钟、最后收时钟”高位在前也就是从 bit7 往下发。注意dat 1这一句让最低位先被放到 IO 上而 DS1302 要求 MSB first所以发送时应该先发送 bit7。这里我写的循环是先判断dat 0x01也就是先发送 bit0实际是 LSB first这是个容易搞混的地方。让我在代码里纠正一下正确的 MSB first 发送方式应该从 bit7 开始static void DS1302_WriteByte(uint8_t dat) { uint8_t i; for (i 0; i 8; i) { if (dat 0x80) { HAL_GPIO_WritePin(DS1302_GPIO_PORT, DS1302_IO_PIN, GPIO_PIN_SET); } else { HAL_GPIO_WritePin(DS1302_GPIO_PORT, DS1302_IO_PIN, GPIO_PIN_RESET); } dat 1; DS1302_Delay(); DS1302_SCLK_HIGH(); DS1302_Delay(); DS1302_SCLK_LOW(); DS1302_Delay(); } } static uint8_t DS1302_ReadByte(void) { uint8_t i, dat 0; for (i 0; i 8; i) { dat 1; DS1302_SCLK_HIGH(); DS1302_Delay(); if (HAL_GPIO_ReadPin(DS1302_GPIO_PORT, DS1302_IO_PIN) GPIO_PIN_SET) { dat | 0x01; } DS1302_SCLK_LOW(); DS1302_Delay(); } return dat; }这样就正确了。dat 1先把高位移出去第一位读到的 bit7 最终通过移位落到 dat 的最高位。如果你在移植时搞反了方向表现出来就是时间数据变成了奇怪的值比如 16 变成了 01、08 变成了 10这个现象很有迷惑性后面排查章节我会再提。寄存器层的访问函数static void DS1302_WriteReg(uint8_t addr, uint8_t dat) { DS1302_CE_HIGH(); DS1302_WriteByte(addr); DS1302_WriteByte(dat); DS1302_CE_LOW(); } static uint8_t DS1302_ReadReg(uint8_t addr) { uint8_t dat 0; DS1302_CE_HIGH(); DS1302_WriteByte(addr); DS1302_IO_Mode(DS1302_IO_MODE_IN); dat DS1302_ReadByte(); DS1302_IO_Mode(DS1302_IO_MODE_OUT); DS1302_CE_LOW(); return dat; }读寄存器的过程里命令字节发送阶段 IO 是输出方向命令发完之后要立刻把 IO 切到输入方向再去读数据字节。这个方向切换如果在代码里漏掉读回来的数据要么全是 0xFF要么全是不确定的电平。切回输出的时机也很重要最好在读数据字节结束、CE 拉低之前完成这样下一轮写命令时引脚状态是确定的。BCD 码转换这两个函数直接放到ds1302.c里uint8_t DS1302_DecToBcd(uint8_t dec) { return ((dec / 10) 4) | (dec % 10); } uint8_t DS1302_BcdToDec(uint8_t bcd) { return ((bcd 4) * 10) (bcd 0x0F); }简单说明一下DS1302 的日期时间寄存器内部存储的是 BCD 码比如十进制的 23 秒寄存器里存的是 0x23也就是高 4 位是“2”低 4 位是“3”。所以从串口打印或赋值给结构体变量之前必须用 BCD 转十进制的函数处理一次而把用户输入的时间写入 DS1302 之前要用十进制转 BCD 的函数处理一次。很多新手把这一点忘了直接往寄存器里塞十进制结果读出来乱七八糟。3.3 时间的设置与读取完整 API 封装DS1302 的寄存器地址和功能如下表所示寄存器名称写命令读命令数据范围BCDbit7 说明秒0x800x810x00~0x59CH1 停止时钟0 启动分0x820x830x00~0x59保留时0x840x850x00~0x23 或 0x01~0x12bit712/24 小时制选择bit5AM/PM日0x860x870x01~0x31保留月0x880x890x01~0x12保留星期0x8A0x8B0x01~0x07保留年0x8C0x8D0x00~0x99保留写保护0x8E0x8Fbit7WP1 禁止写入0 允许写入慢充电0x900x91—控制充电二极管和电阻选择写时间的 API 封装如下。这里的关键步骤是先解除写保护把 WP 位清零然后写入秒寄存器时会同时把 CH 时钟停止位写 0让芯片开始走时。void DS1302_SetTime(uint8_t year, uint8_t month, uint8_t day, uint8_t hour, uint8_t minute, uint8_t second, uint8_t week) { DS1302_WriteReg(0x8E, 0x00); /* 写保护位清零 */ DS1302_WriteReg(0x80, DS1302_DecToBcd(second)); DS1302_WriteReg(0x82, DS1302_DecToBcd(minute)); DS1302_WriteReg(0x84, DS1302_DecToBcd(hour)); DS1302_WriteReg(0x86, DS1302_DecToBcd(day)); DS1302_WriteReg(0x88, DS1302_DecToBcd(month)); DS1302_WriteReg(0x8A, week); /* 星期直接写入 1~7 */ DS1302_WriteReg(0x8C, DS1302_DecToBcd(year)); /* 年份只存后两位 */ DS1302_WriteReg(0x8E, 0x80); /* 重新开启写保护 */ }为什么最后要把写保护重新打开因为写保护位 WP 置 1 之后所有寄存器都会被禁止写入这能防止程序跑飞时误改时间数据。自己做实验时可能无所谓但我觉得这个习惯值得养成操作完关键配置后立刻恢复保护状态以后做更复杂的项目时能少踩很多坑。读时间的 API 封装如下void DS1302_GetTime(DS1302_Time_t *time) { uint8_t sec; sec DS1302_BcdToDec(DS1302_ReadReg(0x81)); time-second sec 0x7F; /* 去掉 CH 位 */ time-minute DS1302_BcdToDec(DS1302_ReadReg(0x83)); time-hour DS1302_BcdToDec(DS1302_ReadReg(0x85)); time-day DS1302_BcdToDec(DS1302_ReadReg(0x87)); time-month DS1302_BcdToDec(DS1302_ReadReg(0x89)); time-week DS1302_ReadReg(0x8B) 0x07; time-year DS1302_BcdToDec(DS1302_ReadReg(0x8D)); }这里有个读取秒寄存器的细节秒寄存器的 bit7 是 CH 位如果时钟没有正确启动这个位可能是 1导致秒值变成大于 59 的数字。我处理的方式是先把秒寄存器整个读回来转成十进制再与 0x7F 相与去掉 bit7。这样即使出现异常打印出来的秒数最多也只是 0~59 的值不会出现 80 这种一眼假的数字。结构体定义在头文件里typedef struct { uint8_t year; /* 0~99 */ uint8_t month; /* 1~12 */ uint8_t day; /* 1~31 */ uint8_t hour; /* 0~23 */ uint8_t minute; /* 0~59 */ uint8_t second; /* 0~59 */ uint8_t week; /* 1~7 */ } DS1302_Time_t;3.4 主函数调用与串口打印验证看代码只看驱动不看调用等于白看。我在工程里放了一个带串口打印的验证主程序每秒读一次当前时间并输出到串口助手方便你接上 USB-TTL 模块立刻看到效果。核心部分如下int main(void) { DS1302_Time_t time; HAL_Init(); SystemClock_Config(); MX_GPIO_Init(); MX_USART1_UART_Init(); DS1302_Init(); /* 首次烧录时如果要校正时间取消下面这行的注释 */ // DS1302_SetTime(24, 6, 15, 10, 30, 0, 7); while (1) { DS1302_GetTime(time); printf(20%02d-%02d-%02d %02d:%02d:%02d Week:%d\r\n, time.year, time.month, time.day, time.hour, time.minute, time.second, time.week); HAL_Delay(1000); } }DS1302_Init()做的事情不多主要是把 CE、SCLK、IO 三个引脚初始化为 GPIO 输出模式并把 CE 拉低、SCLK 拉低让芯片处于空闲状态。注意 IO 初始化时先设为输出因为后续读寄存器时内部会调用方向切换函数不需要在初始化阶段重复设置。串口打印的printf重定向需要你在工程里实现fputc这一步在 F103 的 HAL 库工程里通常是把重定向代码放到单独的文件里或者直接在main.c里int fputc(int ch, FILE *f) { HAL_UART_Transmit(huart1, (uint8_t *)ch, 1, 0xFFFF); return ch; }烧录后打开串口助手波特率设 115200如果一切正常你会看到每隔一秒输出一行时间信息。我第一次调通这个工程时看到串口里连续滚出正确的时间感觉比点亮一颗 LED 踏实得多因为这意味着你真的把一个芯片“驱动”起来了。4. 常见问题与排查技巧实录4.1 时间不走秒寄存器 CH 位是个坑最典型的现象是设置完时间后读到的时间静止不动秒数永远停在设置的值。排查思路很简单先把秒寄存器原样读出来看 bit7 是不是 1。DS1302 上电后如果不做任何操作秒寄存器的 CH 位默认为 1芯片处于时钟停止状态。这是数据手册里明确写的但很多教程代码只在设置时间时往秒寄存器写一次值如果写入的值本身用了DS1302_DecToBcd()十进制 0 转成 BCD 也是 0x00那么 CH 位确实被清掉了理论上是能走起来的。真正容易出问题的场景是你只写了分、时等寄存器而没有写秒寄存器或者秒寄存器写了一个大于 0x59 的非法 BCD 码。这两种情况下秒寄存器里的 CH 位不会被正确清零时钟自然不走。解决办法就是那句我反复提的话设置时间时一定要把秒寄存器一起写掉并用 BCD 码格式写入且秒值必须小于 60。我在 API 里这么写是有原因的如果你自己封装函数千万别把秒寄存器省掉。4.2 读出来全 0xFF 或全 0x00IO 方向切换是关键全 0xFF 通常说明 IO 引脚被外部上拉拉高或者内部上拉开启而 DS1302 在读取模式下没有把 IO 拉低的能力。全 0x00 则说明 IO 一直保持低电平或者拉高能力不足。两个表面现象不同根源往往指向同一个问题读取数据时IO 没有切成输入模式。我见过很多初学者抄代码时只抄了写寄存器函数读寄存器函数里的DS1302_IO_Mode(DS1302_IO_MODE_IN)被某次拷贝漏掉了然后疯狂怀疑是晶振没起振、芯片坏了、杜邦线接触不良。其实先检查 IO 方向切换对不对比换芯片快得多。另外如果你用的是 STM32G0 或者某些新系列芯片HAL_GPIO_Init 在切换模式时会把引脚输出数据寄存器复位导致 IO 在高电平输出和输入之间切换时产生一个短脉冲。这个短脉冲可能被 DS1302 误判为数据。解决办法是在切到输入模式之前先把 IO 拉成低电平或者在 CE 拉低之后再切模式。我在DS1302_ReadReg里的切换顺序是先切输入、再读数据、再切输出、最后 CE 拉低这个顺序目前实测没有出问题你可以参考。4.3 数据错乱BCD 码与十进制的混用时间数据读出来不对最常见的就是串口打印出来一个秒数比如你写入的是 35 秒结果读出 53 秒。这种数值倒置的现象几乎可以肯定是 BCD 码和十进制没有互相转换导致的。如果你确认代码里用了DS1302_BcdToDec()和DS1302_DecToBcd()但数据还是不对那么下一个怀疑对象就是位发送顺序。我之前在 3.2 节里指出过DS1302 要求 MSB first即最高位先发。如果你的DS1302_WriteByte里用的是dat 0x01加右移那么发送方向就是反的写入的寄存器值和预期会大不相同甚至寄存器地址本身就是错的导致你明明想写秒寄存器实际上写到了别的寄存器里。排查这种问题时用逻辑分析仪抓三根线是最快的后面 4.5 小节我再展开。4.4 掉电丢时间VCC1 与充电寄存器上电正常、断电一段时间后重新上电时间被重置或者完全停止这基本就是 VCC1 没接备用电池或者电池没电了。DS1302 的 VCC1 接 3V 纽扣电池后主电源掉电时芯片会自动切换到电池供电。有些同学在面包板上测试VCC1 悬空断电后时间当然保不住。另外如果你的设计里用了 DS1302 内部的慢充电功能还要注意充电寄存器 0x90 的配置。慢充电使能需要把 TCS 位写成 1010否则充电功能不会开启。如果电池是可充电的镍氢或者锂电池可以把充电功能打开如果用的是 CR2032 这类一次性纽扣电池一定不要开启充电功能否则可能影响电池寿命甚至带来安全隐患。我在学习笔记里默认不配置充电寄存器也就是关闭充电功能这样最安全。4.5 用逻辑分析仪定位时序异常的排查思路软件上查不出问题时最好用逻辑分析仪直接抓波形。我常用的那台几十块钱的逻辑分析仪配合 PulseView 软件抓 DS1302 的 CE、SCLK、IO 三根线绰绰有余。抓包时注意把采样率设到 1M 以上触发条件设为 CE 上升沿然后复位单片机执行一次读时间操作。拿到波形后主要看四点CE 是否在访问期间一直保持高电平访问结束后回到低电平。SCLK 脉冲数量是否完整每次访问应该有一个命令字节加一个数据字节也就是 16 个时钟周期。IO 线上数据方向切换的位置是否正确。命令字节阶段数据在写方向数据字节阶段数据切换为读方向这个切换应该发生在命令字节最后一个 bit 的 SCLK 下降沿附近。波形上的毛刺是否太多。如果 SCLK 线上有大量振铃考虑降低 GPIO 输出速度等级或者给 SCLK 加一个小电阻做阻尼。我排查过一次很隐蔽的问题代码逻辑完全正确波形也正常但 DS1302 偶尔返回错误数据。后来发现是杜邦线太长SCLK 频率又比较高导致 SCLK 上的振铃被 DS1302 识别成额外时钟沿。解决办法是把 GPIO 速度等级从GPIO_SPEED_FREQ_HIGH降到GPIO_SPEED_FREQ_MEDIUM问题就消失了。这也是为什么我在宏定义里没有把延时调得很短留一点余量可以吸收很多环境干扰。4.6 常见问题速查表现象可能原因解决办法时间不走秒数固定秒寄存器 CH 位为 1设置时间时同时写秒寄存器确保写入值小于 0x60读出来全是 0xFFIO 未切换输入模式检查读数据前是否调用DS1302_IO_Mode(DS1302_IO_MODE_IN)读出来全是 0x00IO 未切换输入模式或内部上拉未开开启内部上拉或外部增加 10kΩ 上拉时间数值倒置BCD 码转换遗漏写入前使用DecToBcd读出后使用BcdToDec写入地址不对数据错乱字节发送顺序错误确认WriteByte是 MSB first掉电后时间丢失VCC1 未接电池接 3V 纽扣电池建议同时加 0.1uF 去耦电容偶发读取错误线路过长、振铃干扰降低 GPIO 速度等级或增大延时5V 供电时 IO 电平异常与 3.3V MCU 电平不匹配改为 3.3V 供电或增加电平转换5. 写在最后的移植建议与个人体会驱动 DS1302 这个项目本身规模不大但它几乎覆盖了嵌入式驱动开发里最核心的几个环节看数据手册提取时序、用 GPIO 模拟协议、处理字节位顺序、封装层次化 API、在硬件上验证。把这套流程走完再看其他芯片的数据手册会觉得没那么发怵。我在整理这套开源学习笔记时最大的体会是很多看起来“玄学”的嵌入式问题追到根上都是最基本的概念没吃透。DS1302 读写全是 0xFF不是芯片坏了而是 IO 方向没切时间不走不是晶振坏了而是 CH 位没有清零。把这些底层逻辑想明白之后再遇到类似问题排查速度会快很多。如果你要从 F103 移植到其他型号只需要改ds1302.h里的引脚宏再用HAL_GPIO_WritePin和HAL_GPIO_ReadPin适配新平台。我自己在 STM32G474 上试过除了把 GPIO 端口名改掉以外其他代码一行没动直接跑通。延时函数也可以根据主频微调核心逻辑是完全通用的。最后再分享一个小技巧把“读秒寄存器”单独做成一个函数在调试时反复调用并打印原始值。这样一来设置时间、读取时间、检查 CH 位、验证 BCD 转换都能基于同一个基础函数展开排查问题会清爽很多。希望这套开源学习笔记能帮你少走一点弯路。