最近翻出一个 DS1302 模块顺手把它接在 STM32F103C8T6 最小系统板上写了一份开源学习笔记。DS1302 是一款很老的三线实时时钟芯片但直到现在课程设计、工业小面板、物联网节点里还能看到它的身影。这篇文章不是把数据手册翻译一遍而是从实际接线、时序分析、驱动代码、调试过程和校准经验完整走一遍适合刚跑通 GPIO、想正经玩一个外设通信协议的同学参考。整个工程的代码我会以开源方式整理大家可以直接对照着改。1. 为什么在 202x 年还要学 DS13021.1 一块 RTC 芯片能省下多少主控资源如果你做过不带外部 RTC 的单片机计时应该体会过这种痛苦用定时器中断维护一个“秒计数”要处理 6 个计时寄存器要判断大小月、闰年还要担心主控重启后时间清零。更麻烦的是掉电保持时间通常需要主控进入低功耗模式或者给主控的备份域单独供电这对很多入门项目来说太复杂了。DS1302 这种专用 RTC 芯片把“走时”这件事从主控身上彻底拆了下来。主控只需要在要读时间或写时间的时候通过三根线访问它的寄存器其他时间完全不用管。DS1302 内部有振荡电路和分频链外接一个 32.768kHz 晶振就能自己走时主电源断电后还能靠 VCC1 引脚上的电池继续维持。从资源占用上看它的接口是典型的 SPI 变体一根 CE片选使能、一根 SCLK时钟、一根 I/O数据比 I2C 的两线多一根片选但协议更直观没有地址应答、没有总线仲裁比 SPI 标准四线又少一根数据输出线。对于刚接触通信协议的人来说这是一个非常合适的“中间难度”外设。1.2 DS1302 的定位够用、便宜、但别指望它精确DS1302 的价格通常是几块钱很多模块还直接帮你焊好了晶振和电池座买回来就能用。它支持秒、分、时、日、月、周、年寄存器还额外带一个涓流充电寄存器可以给可充电电池或法拉电容充电。这些功能听起来很全但有一个短板必须提前说清楚它的走时精度完全取决于晶振质量和工作温度没有内置温补。我在实际测试中同样标称 20ppm 的 32.768kHz 晶振在不同温度下日误差能差出好几秒。所以 DS1302 适合对时间精度要求不那么苛刻的场景比如电子钟、定时开关、数据日志里的时间戳。如果你想做高精度授时或长时间累积计时建议直接上带温度补偿的 DS3231 之类后面我单独讲。2. 硬件接线与电平配合先别急着焊2.1 引脚功能与典型接法DS1302 最常见的封装是 DIP-8引脚不算多但新手最容易栽在 VCC1 和 VCC2 上。这两个电源引脚的分工是VCC2 接主电源VCC1 接后备电池。当 VCC2 电压高于 VCC1 时芯片使用 VCC2当 VCC2 掉电且 VCC1 还有电时自动切换到电池供电。不是让你把两个电源并联。典型接法如下引脚编号名称接法1VCC2主电源 3.3V 或 5V2X132.768kHz 晶振3X232.768kHz 晶振4GND公共地5CE接 STM32 GPIO串 1kΩ 电阻可选6I/O接 STM32 GPIO双向数据7SCLK接 STM32 GPIO串 1kΩ 电阻可选8VCC1后备电池正极常用 CR2032晶振两端需要接 6pF 左右的负载电容到地。模块上通常已经焊好自己搭电路的话别忘了不然晶振可能不起振或误差很大。CE、SCLK、I/O 三根线建议分别接一个 1kΩ 到 10kΩ 的上拉电阻模块一般也带了但你从零开始做板子时容易漏掉。2.2 3.3V 主控和 5V 模块之间的电平问题STM32F103 的 GPIO 耐压是 5V 容忍的但 DS1302 的 I/O 引脚输出高电平会接近 VCC2。如果你把 VCC2 接到 5V而 STM32 的 GPIO 配置成带上拉/下拉的输入模式虽然不至于烧芯片但长期跑还是存在风险尤其是某些模块的 I/O 线上还直接连到了 VCC 上拉电阻。我的建议是主控是 3.3V就直接把 VCC2 也接 3.3V。DS1302 的工作电压范围是 2.0V 到 5.5V3.3V 供电完全没问题而且 I/O 高电平也是 3.3V 级跟 STM32 天然匹配。如果你拿到的模块已经焊死了 5V 供电路径那就需要在 I/O、SCLK、CE 三根线上做分压。最简单的做法是每个信号串一个 330Ω 电阻再在 STM32 侧对地并一个 2kΩ 电阻把高电平拉到 3.3V 以下。如果你用的是 5V 供电的 Arduino反过来更要注意DS1302 输出高电平接近 5V接到 5V 单片机没问题但如果单片机是 3.3V一定要先确认模块上拉的电源是不是 3.3V。我说句不好听的网上很多“接上就能用”的教程根本没提这一点结果不少人换了一个模块就出现乱码。2.3 备用电池与涓流充电的正确姿势VCC1 接电池时优先用 CR2032 一类的不可充锂电池。这里有个很容易混淆的点DS1302 的充电寄存器默认是关的但某些模块上预留了涓流充电电路如果你把充电寄存器打开然后接的是 CR2032那就有安全隐患。CR2032 不能涓流充电会鼓包漏液。所以我的经验是除非确认自己接的是镍氢充电电池或者法拉电容否则不要碰 0x90 寄存器。初始化代码里也不要想着“顺手把充电打开”。很多模块上的二极管和电阻只是预留不代表你必须用它。另外电池座的焊盘和模块布局也会影响功耗。有些模块为了兼容充电在 VCC1 回路里串了二极管反向漏电流很小有些山寨模块则直接硬连电池消耗很快。实测发现同一个电池放在不同模块上有的能撑一两年有的几个月就没了。选模块时可以留意一下 VCC1 到电池座之间有没有二极管或电阻没有的尽量别买。3. 三段式时序协议上升沿写、下降沿读3.1 命令字节的位结构为什么 bit0 是读写方向DS1302 没有寄存器编号直接暴露在总线上每次访问都要先发一个命令字节。这个命令字节的格式很整齐bit7bit6bit5bit4bit3bit2bit1bit0固定 1固定 0寄存器地址 A4-A0读写方向bit0 为 1 表示读为 0 表示写。bit7 固定为 1bit6 固定为 0像是访问许可位如果你把位序搞反芯片不会有任何回应。以秒寄存器为例它内部地址是 0x00写命令就是 0x80读命令就是 0x81。常用寄存器命令如下寄存器写命令读命令位说明秒0x800x81bit7 是时钟暂停标志 CH分0x820x83高三位一般不用时0x840x85bit7 是 12/24 小时制选择日0x860x87bit7-bit6 不用低 6 位有效月0x880x89高三位不用周0x8A0x8B低 3 位表示星期 1-7年0x8C0x8D00-99无世纪写保护0x8E0x8Fbit7 为 1 时禁止写其他寄存器充电0x900x91按需配置默认关闭这里最容易忽略的是写保护寄存器。每次写时间之前必须先把写保护寄存器 0x8E 写入 0x00写完再写 0x80 把写保护重新打开。否则你会发现初始化代码看起来什么都执行了时间却一动不动。3.2 一次完整读写的时间窗口DS1302 的三线时序可以拆成三个窗口启动、发送命令、读写数据。启动阶段CE 保持低电平SCLK 保持低电平然后把 CE 拉高。接下来 SCLK 才开始产生脉冲。结束的时候SCLK 停在低电平然后 CE 拉低。这个“先 CE 后时钟”的顺序很关键如果你 CE 还没拉高就让 SCLK 跳变状态机会乱。发送命令阶段每个数据位在 SCLK 上升沿被 DS1302 采样。所以主控要先在 I/O 上准备好这一位的电平然后把 SCLK 从低拉高产生上升沿芯片把当前 I/O 电平锁存进去。写数据阶段和发送命令阶段完全一致。读数据阶段有一个“方向切换”动作。命令字节的最后一位发送完后I/O 线不再由主控驱动而是要让 DS1302 接管输出。此时主控必须把对应 GPIO 从输出模式切换成输入模式。之后每个数据位在 SCLK 下降沿之后出现在 I/O 线上主控应该在 SCLK 为低电平的时间窗口内读取 I/O 电平。我经常跟别人形容这个过程写入是“先摆数据再给上升沿”读取是“先给下降沿再读数据”。这两个方向正好相反写代码时如果套用同一个循环大概率读回来的第一位就错。3.3 为什么我不用标准 SPI 外设而是用 GPIO 模拟DS1302 的时序和 SPI Mode 0 很像空闲时时钟低电平数据在上升沿采样。但它的控制逻辑有些私有化比如命令字节里的固定位、读方向后的 GPIO 切换、CE 并非标准的片选信号。你确实可以在 STM32 的 SPI 外设上通过半双工模式加片选控制来模拟但调试成本不低。GPIO 模拟的好处是你不需要去翻 STM32 参考手册里的 SPI 配置、DMA 中断、极性设置只需要把三条线的电平变化按时间顺序写出来。对于学习通信协议来说先把位级时序跑通比调用一个封装好的外设更有价值。实际项目中如果 DS1302 只是偶尔读一次时间GPIO 模拟完全够用如果对时序稳定性有更高要求再考虑换标准 SPI 或者直接上 DS3231 这类 I2C 器件。4. 驱动代码落地寄存器、BCD 和接口封装4.1 底层引脚宏定义与方向切换我用的是 STM32F103C8T6PB12 接 CEPB13 接 SCLKPB14 接 I/O。GPIO 初始化用标准库或 HAL 都可以关键是读写字节函数里要能快速切换 I/O 方向。HAL 的 GPIO_Init 函数太慢不建议在每读一位时调用。直接用寄存器操作会更干净/* PB12 CE */ #define RTC_CE_H() (GPIOB-BSRR GPIO_BSRR_BS12) #define RTC_CE_L() (GPIOB-BSRR GPIO_BSRR_BR12) /* PB13 SCLK */ #define RTC_SCK_H() (GPIOB-BSRR GPIO_BSRR_BS13) #define RTC_SCK_L() (GPIOB-BSRR GPIO_BSRR_BR13) /* PB14 I/O */ #define RTC_IO_H() (GPIOB-BSRR GPIO_BSRR_BS14) #define RTC_IO_L() (GPIOB-BSRR GPIO_BSRR_BR14) #define RTC_IO_GET() ((GPIOB-IDR GPIO_IDR_ID14) ? 1 : 0) #define RTC_IO_IN() (GPIOB-MODER ~(3U 28)) #define RTC_IO_OUT() (GPIOB-MODER (GPIOB-MODER ~(3U 28)) | (1U 28))注意PB14 是第 14 号引脚MODER 寄存器里每个引脚占 2 bit所以位移是 14 * 2 28。RTC_IO_IN() 把这两位清零RTC_IO_OUT() 先把原来的位清掉再设置为通用输出模式。这样切换方向只需要两条语句不会产生多余的库函数调用。4.2 字节读写与寄存器访问写字节函数的核心是“先摆数据再给上升沿”static void DS1302_WriteByte(uint8_t dat) { uint8_t i; RTC_IO_OUT(); for (i 0; i 8; i) { if (dat 0x01) { RTC_IO_H(); } else { RTC_IO_L(); } RTC_SCK_L(); __NOP(); RTC_SCK_H(); __NOP(); dat 1; } }为什么每次置位前要先拉低 SCLK因为如果上一次循环结束后 SCLK 是高电平下一次置位后立刻产生上升沿时序就不干净了。先把 SCLK 拉低再设置 I/O再拉高才能保证上升沿来的时候数据线已经稳定。读字节函数的方向相反重点在“给下降沿再读数据”static uint8_t DS1302_ReadByte(void) { uint8_t i, dat 0; RTC_IO_IN(); for (i 0; i 8; i) { RTC_SCK_H(); __NOP(); RTC_SCK_L(); __NOP(); dat 1; if (RTC_IO_GET()) { dat | 0x80; } } return dat; }这段代码里每读一位后把 dat 右移再把新读到的位置到 bit7。循环 8 次后最先读到的 bit0 会被移到最低位最终拼成一个完整字节。如果你把顺序写反就会得到位序颠倒的数据。寄存器访问函数static void DS1302_WriteReg(uint8_t cmd, uint8_t dat) { RTC_CE_L(); RTC_SCK_L(); RTC_CE_H(); DS1302_WriteByte(cmd); DS1302_WriteByte(dat); RTC_SCK_L(); RTC_CE_L(); } static uint8_t DS1302_ReadReg(uint8_t cmd) { uint8_t dat; RTC_CE_L(); RTC_SCK_L(); RTC_CE_H(); DS1302_WriteByte(cmd); dat DS1302_ReadByte(); RTC_SCK_L(); RTC_CE_L(); return dat; }这里有个很隐蔽的坑读字节前I/O 已经切换成输入模式但是命令字节最后一位是在 SCLK 上升沿被采样的这个上升沿之后 I/O 线才真正交给 DS1302。所以 RTC_IO_IN() 必须放在 WriteByte 函数外部、ReadByte 函数开头不能放在命令字节发送过程中。否则 DS1302 可能还没准备好输出主控就已经读走一个无效位。4.3 时间结构体、BCD 转换与 Set/Get 接口DS1302 内部存的是 BCD 码0x59 表示 59 秒不是十进制 59。所以需要两个转换函数static uint8_t BCD2DEC(uint8_t bcd) { return (bcd 4) * 10 (bcd 0x0F); } static uint8_t DEC2BCD(uint8_t dec) { return ((dec / 10) 4) (dec % 10); }时间结构体定义如下typedef struct { uint8_t year; /* 00-99 */ uint8_t month; /* 1-12 */ uint8_t day; /* 1-31 */ uint8_t week; /* 1-7 */ uint8_t hour; /* 0-23 */ uint8_t minute; /* 0-59 */ uint8_t second; /* 0-59 */ } DS1302_Time;写时间接口void DS1302_SetTime(DS1302_Time *tm) { DS1302_WriteReg(0x8E, 0x00); /* 关闭写保护 */ DS1302_WriteReg(0x80, DEC2BCD(tm-second) 0x7F); /* CH 位清 0 */ DS1302_WriteReg(0x82, DEC2BCD(tm-minute)); DS1302_WriteReg(0x84, DEC2BCD(tm-hour) 0x3F); DS1302_WriteReg(0x86, DEC2BCD(tm-day)); DS1302_WriteReg(0x88, DEC2BCD(tm-month)); DS1302_WriteReg(0x8A, DEC2BCD(tm-week) 0x07); DS1302_WriteReg(0x8C, DEC2BCD(tm-year)); DS1302_WriteReg(0x8E, 0x80); /* 开启写保护 */ }读时间接口void DS1302_GetTime(DS1302_Time *tm) { tm-second BCD2DEC(DS1302_ReadReg(0x81) 0x7F); tm-minute BCD2DEC(DS1302_ReadReg(0x83) 0x7F); tm-hour BCD2DEC(DS1302_ReadReg(0x85) 0x3F); tm-day BCD2DEC(DS1302_ReadReg(0x87) 0x3F); tm-month BCD2DEC(DS1302_ReadReg(0x89) 0x1F); tm-week BCD2DEC(DS1302_ReadReg(0x8B) 0x07); tm-year BCD2DEC(DS1302_ReadReg(0x8D)); }掩码不是可有可无的。秒寄存器 bit7 是 CH 位小时寄存器 bit7 是 12/24 小时制标志日期、月、周的高位都有保留位。如果不做掩码读出来的数据可能在某个范围内跳变比如把星期几读成 15 这种诡异数字。最后在 main 里循环打印即可。开源工程里我会把 DS1302.c 和 DS1302.h 单独拆出来不掺杂具体业务逻辑这样以后换主控芯片只要把宏定义里的引脚改一下再改一下 GPIO 初始化驱动部分基本可以无缝迁移。5. 调试实录秒不走、乱码、掉时间按这个顺序查5.1 读回全是 0xFF 或 0x00先从电气和方向找原因我刚开始调这块芯片时ReadReg 读秒寄存器返回的不是 0xFF 就是 0x00。用示波器看 I/O 线发现读写方向切换后I/O 线一直是低电平数据根本没有从 DS1302 输出。排查过程是这样的先检查了 VCC2 和 VCC1 的电压都正常再用万用表量 I/O 线上拉电阻发现模块上的上拉电阻连到了 VCC2而 VCC2 接的是 3.3V上拉没问题最后怀疑是 GPIO 输入模式配置不对把 RTC_IO_IN() 里的 MODER 位清 0 后没有确认方向切换生效。实际上问题就出在读字节函数我在发完命令字之后才切换输入模式但切换语句是在 WriteByte 函数结束之后才执行的里面还带着 RTC_IO_OUT()。结果命令字节的最后一个位刚被采样I/O 又被设置成输出模式DS1302 想输出也拉不动。修复办法是把 RTC_IO_IN() 放到写命令和读数据之间最好单独封装一个“切换输入”函数让代码意图更明显。如果你也遇到 0xFF先别怀疑芯片坏了。用万用表分别测 I/O 线在 CE 拉高前后的电平如果 DS1302 已经被选中且处于读模式I/O 线应该有微弱的高电平输出能力。始终读 0xFF通常是上拉太强或者输入模式没切换成功始终读 0x00通常是写命令方向位不对或者 I/O 一直处于输出模式被主控钳位。5.2 秒寄存器不走先看 CH 位和晶振初始化正常后我遇到第二个问题是秒寄存器能读到值但永远不变。第一反应是晶振没起作用于是用示波器看 X1/X2 引脚发现 32.768kHz 正弦波很干净说明晶振已经起振。问题不在晶振而在秒寄存器的 bit7。DS1302 的秒寄存器 bit7 是时钟暂停标志写成 1 会让振荡器停振时间冻结但寄存器还能被读写。我的初始化代码里直接写了DEC2BCD(tm-second)当时秒是 0转换结果是 0x00bit7 是 0按理说没问题。但是后来一遍遍调用 SetTime某次传入的 second 恰好是 0x80 以上比如 128转换结果被错误地写进了 bit7时钟就停了。这不是正常调用会遇到的但调试时为了测试我确实传过超范围值。所以代码里最好显式 0x7F并且在上层调用时做范围校验。另一个检查方法是手动把秒寄存器写 0x00隔一秒再读如果还是不变化再检查 CE 和 SCLK 的 GPIO 初始化为推挽输出别配置成开漏并忘了上拉。5.3 日期小时乱码是掩码和 12/24 小时制在捣乱小时寄存器偶尔读出来变成 0xA4 这种值日期在 1 到 31 之间乱跳。这个问题的根源是小时寄存器的 bit7。如果 bit7 为 1芯片工作在最容易被误解的 12 小时制模式bit5 表示上午或下午低 5 位才是小时数。这时你读取 0x84得到的不再是 0-23 的完整小时而是需要拆分 AM/PM。DS1302 数据手册写得很清楚默认上电时小时寄存器的 bit7 可能是 0 也可能是 1取决于芯片批次。解决方法是写小时寄存器时先把值 0x3F强制 bit7 为 0使用 24 小时制。读的时候同样 0x3F。如果实际项目需要 12 小时制显示那就得单独处理 bit5 和 bit7不要直接转 BCD。至于日期乱跳多半是没做掩码。比如月份寄存器的高位可能因为内部状态残留变成 0x12不掩码就显示成 18 月。读取时一律 0x1F日期 0x3F星期 0x07可以消除 90% 的“随机乱码”。5.4 掉电后时间回退问题大多在电池和模块漏电流这个现象很典型开发板通电时DS1302 时间正常拔掉主电源过几个小时再上电时间退回到上次断电的时刻。说明电池根本没有维持走时或者电池电压已经低于 DS1302 的最低工作电压。我先量了电池CR2032 空载电压 3.0V正常。但如果电池座接触不良或者模块上 VCC1 路径里的二极管压降太大实际加到 DS1302 的电压可能只有 2.3V。DS1302 数据手册给出的最小工作电压是 2.0V接近临界点时振荡器容易停振。另外有些模块在 VCC1 和 VCC2 之间没有做隔离主电源掉电时VCC1 不仅要供 DS1302还被其他电路拉电流。解决方法是把模块背面的排针断开单独给 VCC1 供电用万用表测掉电后 VCC1 的电流。正常情况下应该是微安级如果变成毫安级说明模块设计有问题直接换一块。6. 校准与后续把日误差压到几秒的可操作思路6.1 24 小时误差测试怎么做才可靠判断 DS1302 走时准不准不能只开机看一分钟。我的标准流程是先把时间设置成整点然后记录当前 Unix 时间戳或手机时间运行至少 24 小时后再读一次用误差秒数除以运行小时数再乘 24得到日误差。测试环境要尽量贴近实际使用场景。如果设备放在室内恒温环境误差会比较稳定如果放在户外或机箱里温度变化会直接影响晶振频率。最好把测试拆成两个阶段常温 24 小时测试和高温/低温环境各 2 小时测试。不要只相信标称 ppm晶振的实际谐振频率和负载电容匹配度对最终误差影响很大。我的模块第一次测出来每天快 7 秒。这个误差不算离谱但想改善也简单检查晶振两端负载电容是否与模块设计匹配。有些模块使用的是 12pF 电容实际要求 6pF快慢会差很多。如果你手头有不同容值的贴片电容可以换 6pF、10pF、12pF 各测一轮找到误差最小的一组。没有精密的频率计就靠 24 小时误差读数反推。6.2 软件补偿的基本原则和局限软件补偿的逻辑并不复杂如果时钟每天快 7 秒那就让系统每过 86400 / 7 ≈ 12343 秒把时间往回拨 1 秒。但问题在于DS1302 本身没有秒级微调寄存器你不能像调晶振一样直接改变内部计数节奏。补偿只能放在主控读取时间或主控自己维护时间戳的层面。我试过一个土办法主控每读到一次时间就加上一个累积补偿量。比如启动时记录当前实际时间然后设置一个定时器每 12343 秒触发一次在一个全局变量里累加误差秒数。读取时间时把 DS1302 返回的时间加上这个误差换算成可显示的本地时间。这个方案在恒温环境下有效但温度一变误差率也会变补偿秒数就需要动态调整。另一个做法是定期用网络时间同步比如 WiFi 模块每小时对时一次。DS1302 在这种方案里只承担“断电记忆”功能对稳定性要求没那么高。如果你做的是离线设备又要求日误差在几秒以内DS1302 的软件补偿会很费劲这时候直接换带温补晶振的 RTC 芯片才是正道。6.3 什么时候升级到 DS3231 这类温补时钟DS3231 现在的模块价格也不贵多了两线 I2C、内置晶振和温度补偿典型精度是 ±2ppm换算成日误差大约 0.17 秒。对大多数单片机项目来说DS3231 的精度已经“一劳永逸”了。但它的接口协议复杂一点点I2C 总线上可能还有其他器件需要处理地址和应答。升级前还要考虑功耗。DS3231 比 DS1302 功耗略高电池供电时虽然也能撑很久但 DS1302 的微安级待机确实更有优势。如果你的场景是“设备常年不插电只靠电池计时偶尔被唤醒读时间”DS1302 仍然值得用如果场景是“设备在线时间精度要求高断电保持只是保险”DS3231 更合适。还有一个中间选项是 RX8025T自带温补晶振走 I2C 接口功耗也比较低。不过它的命令寄存器和 DS1302 完全不同不是引脚级替换。所以我的建议很简单学习协议和做低成本原型DS1302 依旧是最好的入门选择做量产产品且精度要求高别在这里省几块钱的差价。最后分享一个小习惯拿到任何一块 DS1302 模块先不要写完整驱动先写一个最简测试程序只配置 GPIO然后循环读秒寄存器观察 10 秒。这一步能排除一半的硬件和接线问题。等秒数能稳定递增再逐步加日历功能、写保护和电池处理。把大问题拆成小问题来调比一次写一大堆再猜错误点要快得多。