1. 为什么一个老掉牙的时钟芯片还值得单独写一篇笔记
DS1302 这颗芯片的年纪比很多刚入行的朋友都大，它最早是达拉斯半导体推出的涓流充电时钟芯片，后来产线几经辗转，如今市面上流通的模块大多是国产兼容版本。很多人第一次接触它是在某宝几块钱买回来的那种带纽扣电池座的小板子上，正面印着 DS1302，背面一排五个针脚：VCC、GND、CLK、DAT、RST。看起来简单得不能再简单，但真正把它接到 STM32 上跑起来，能一次点亮的人并不多。
我之所以愿意花时间整理这篇笔记，是因为这颗芯片身上集中体现了嵌入式开发里一个非常典型的矛盾：时序要求死板，但接口资源极省。它用的是三线制串行接口，严格来说不算标准 SPI，因为数据线是双向的，时钟极性也有自己的脾气。你如果拿标准 SPI 外设去硬套，大概率会翻车。而如果你用普通 GPIO 去模拟时序，又必须把微秒级的延时和采样窗口算清楚。这个过程中涉及的知识点——GPIO 模式切换、时序图阅读、字节收发顺序、BCD 码转换、掉电保护——几乎覆盖了单片机驱动外设的完整链路。
所以这篇内容适合三类人：第一类是刚学完 GPIO 点灯、想找个简单外设练手的初学者；第二类是做项目时需要一颗独立走时的 RTC，但主控自带的 RTC 要么精度不够要么引脚被占用的工程师；第三类是想理解“软件模拟时序”到底该怎么写才稳的老手。我会从硬件连接到代码落地，把每一步的取舍理由讲清楚，尤其是那些教程里通常一笔带过、但实际调试时能卡你半天的细节。
需要提前说明的是，DS1302 的精度依赖外部 32.768kHz 晶振的质量和负载电容匹配，它本身没有温度补偿，所以别指望它能做到秒级年误差。如果你的场景对时间精度要求极高，应该考虑带温补的 RTC 芯片或者直接用主控 RTC 加校准。但如果你只是需要一个能记住“大概时间”、掉电不丢、成本极低的方案，DS1302 依然是很多量产产品里的常客。
2. 三线接口的电气脾气与硬件连接里容易忽略的坑
2.1 引脚功能再认识：CE 到底该叫 RST 还是 CE
市面上大多数模块和教程都把 DS1302 的使能脚标为 RST，但翻原厂数据手册会发现它正式的名字是 CE，也就是 Chip Enable。这两个叫法指向同一个物理引脚，但理解成 RST 容易让人误以为它是复位信号，从而在时序里把它当成低电平有效。实际上 CE 是高电平有效，而且它承担的不只是“选中芯片”这么简单——CE 拉高还负责启动内部移位寄存器，CE 拉低则终止本次通信并复位接口逻辑。
这个细节为什么重要？因为如果你在发送完一个字节后忘记把 CE 拉低，芯片会认为通信还在继续，下一次你想读数据时，移位寄存器的状态就是乱的。我见过不少人调试时发现读出来的秒数永远是 0x80 或者 0xFF，最后查出来就是 CE 没有在字节之间正确翻转。正确的做法是：每次完整的寄存器读写操作，都以 CE 拉高开始、CE 拉低结束，中间不要随意释放。
2.2 上拉电阻不是可选项而是必选项
DS1302 的 DAT 引脚是开漏输出结构，这意味着它只能主动拉低，不能主动拉高。如果你直接把 DAT 接到 STM32 的 GPIO 上，当 DS1302 输出高电平时，引脚实际处于高阻态，STM32 读到的电平是不确定的。所以DAT 线上必须接一个上拉电阻，典型值 4.7kΩ 到 10kΩ 之间。
很多模块板子上已经集成了这个电阻，但如果你是自己用裸芯片搭电路，这一步绝对不能省。我实测过，不加上拉电阻时，读出来的数据偶尔正确偶尔全错，而且错误没有规律，非常难排查。另外 CLK 和 CE 是单向输入，理论上不需要上拉，但如果你走线较长或者环境噪声大，给 CLK 加一个弱上拉也能提高稳定性。
2.3 晶振和负载电容的匹配问题
DS1302 需要外接一个 32.768kHz 的圆柱晶振，通常还配两个 6pF 左右的负载电容。这里有个常见误区：很多人以为随便找个 32.768kHz 晶振焊上去就能走。实际上晶振的负载电容参数必须和电路上的电容匹配，否则频率会偏移。偏移多少呢？如果负载电容不匹配，一天差个几秒到几十秒都很正常。
我的经验是，优先选用数据手册推荐的 6pF 负载电容晶振，配套电容也用 6pF。如果你手头只有 12.5pF 的晶振，那电容值要相应调整，具体算法是：CL = (C1 * C2) / (C1 + C2) + Cstray，其中 Cstray 是 PCB 杂散电容，一般估 2pF 到 3pF。这个计算不复杂，但能帮你省下反复换电容的时间。另外晶振尽量靠近芯片放置，走线越短越好，底下不要走其他信号线。
2.4 备用电池与涓流充电的取舍
DS1302 有个涓流充电功能，可以通过寄存器配置给备用电池充电。听起来很美好，但实际使用时要谨慎。如果你用的是不可充电的纽扣电池（比如 CR2032），必须关闭涓流充电，否则电池会漏液甚至鼓包。只有使用可充电的 LIR2032 或者超级电容时，才应该开启充电功能。
配置涓流充电涉及寄存器地址 0x90，通过写入特定的二极管和电阻选择位来控制充电电流。我一般建议初学者直接关闭这个功能，用一颗 CR2032 供电，正常情况能撑好几年。等你有明确需求时再去研究充电配置，没必要一开始就引入这个变量。
3. 用 GPIO 模拟时序：从时序图到可运行代码的完整推导
3.1 先读懂时序图里的三个关键时间参数
DS1302 的通信时序并不复杂，但有几个时间参数必须满足。翻数据手册可以看到：CLK 周期最小 1μs，也就是说时钟频率最高 1MHz 左右；数据在 CLK 上升沿被写入，在 CLK 下降沿被读出；CE 拉高到第一个 CLK 上升沿之间需要至少 4μs 的建立时间。
这些数字看起来宽松，STM32 随便跑跑都能满足。但问题在于，如果你用 HAL 库的 HAL_GPIO_WritePin 函数去翻转引脚，每次调用都有函数开销，实际波形可能比你想象的慢很多。我建议在时序关键的地方直接用寄存器操作，比如用 BSRR 寄存器来置位和复位，这样能精确控制翻转时刻。
具体来说，写一个字节的流程是：CE 拉高，延时几微秒，然后循环 8 次，每次先把数据位放到 DAT 上，再把 CLK 拉高，延时，拉低，延时。注意数据必须在 CLK 上升沿之前就稳定，所以放数据的操作要放在拉高 CLK 之前。读字节则相反，先把 CLK 拉低，延时，拉高，延时，然后在上升沿之后读取 DAT 上的电平。
3.2 字节收发顺序：低位在前还是高位在前
这是 DS1302 最容易搞错的地方之一。它规定数据传输是低位在前，也就是先发 bit0，最后发 bit7。而很多 SPI 设备是高位在前，如果你习惯了 SPI 的思维，很容易写反。写反的后果是地址和数据全部错位，读出来的值完全不对。
我在代码里通常这样处理：写字节时，循环变量 i 从 0 到 7，每次取 (byte >> i) & 0x01 放到数据线上。读字节时，同样循环 8 次，每次把读到的电平左移到对应位置累加。这样写逻辑清晰，也不容易出错。
3.3 GPIO 模式动态切换的必要性
STM32 的 GPIO 可以配置为输入或输出，但 DS1302 的 DAT 线在写操作时是输出，在读操作时是输入。所以在读写切换时，必须动态改变 GPIO 的方向。如果你用的是标准库，可以调用 GPIO_Init 重新配置；如果用 HAL 库，可以用 HAL_GPIO_DeInit 再 Init，但这样开销较大。
更高效的做法是直接操作寄存器。对于 STM32F1 系列，配置 CRL 或 CRH 寄存器就能改变引脚方向。对于 F4 系列，操作 MODER 寄存器。我一般会封装两个宏或者内联函数，一个把 DAT 设为输出，一个设为输入，切换时只改几个位，速度很快。注意设为输入时，要不要开启内部上拉？如果外部已经有上拉电阻，内部上拉可以不开；如果外部没有，那必须开启内部上拉，否则读不到高电平。
3.4 微秒延时的实现方式选择
DS1302 的时序里需要微秒级延时，比如 CE 建立时间、CLK 高低电平保持时间。在 STM32 上实现微秒延时，常见的有三种方式：用 SysTick 定时器、用 DWT 周期计数器、用简单的循环空转。
SysTick 通常被 HAL 库用来做毫秒延时，如果你再去改它的配置，可能会影响 HAL_Delay。DWT 是个好选择，它自带一个周期计数器，精度高且不影响其他外设。但 DWT 在有些低端型号上不可用。最简单的是循环空转，但循环次数需要根据主频校准，换一个主频就要重新调。
我的建议是：如果主频固定，用循环空转最省事；如果主频会变，用 DWT 或者自己用一个定时器专门做微秒延时。不管用哪种，延时时间宁可稍长一点，也不要短于数据手册要求的最小值。因为 DS1302 对最大时序没有严格限制，你慢一点它也能工作，但快了就可能出错。
4. 寄存器操作与 BCD 码：数据读写背后的编码逻辑
4.1 寄存器地址的规律与读写位
DS1302 内部有 12 个寄存器，包括秒、分、时、日、月、周、年，以及写保护、涓流充电等控制寄存器。这些寄存器的地址不是连续的，但有一定规律：秒寄存器地址是 0x80，分是 0x82，时是 0x84，依次类推，每次加 2。最低位是读写方向位，0 表示写，1 表示读。所以写秒是 0x80，读秒是 0x81。
这个规律记住之后，操作起来就很方便。我通常会定义一个枚举或者宏，把常用寄存器的写地址和读地址都列出来，代码里直接引用，避免每次去翻手册。另外要注意，写操作之前必须先解除写保护，也就是向地址 0x8E 写入 0x00。写完数据后再把写保护打开，写入 0x80。如果你忘记解除写保护，数据是写不进去的，但读操作不受影响，所以会出现“能读不能写”的怪现象。
4.2 BCD 码转换：为什么 0x23 代表 23 秒
DS1302 内部存储的时间数据是 BCD 码格式，也就是用四个二进制位表示一个十进制数字。比如秒数 23，在寄存器里存的是 0x23，高四位是 2，低四位是 3。这种编码方式对硬件电路友好，但对软件来说就需要转换。
从 BCD 转十进制很简单：十位等于 (bcd >> 4) * 10，个位等于 bcd & 0x0F，两者相加即可。反过来，从十进制转 BCD：十位等于 dec / 10，个位等于 dec % 10，然后 (十位 << 4) | 个位。这两个转换函数我建议单独封装，因为读写每个时间寄存器都要用到，写成一个函数反复调用，代码会干净很多。
需要注意的是，小时寄存器有一位是 12/24 小时制选择位。如果你用 24 小时制，这一位要清零。另外秒寄存器的最高位是时钟停止位，上电后如果这一位是 1，说明时钟没在走，需要先清零启动时钟。很多人第一次读秒发现一直是 0x80，就是因为没有处理这个停止位。
4.3 写保护寄存器的正确使用姿势
写保护寄存器地址是 0x8E，写入 0x80 开启保护，写入 0x00 关闭保护。保护开启时，除了写保护寄存器本身，其他寄存器都不可写。这个机制是为了防止意外修改时间数据。
我的习惯是在初始化阶段关闭写保护，把所有时间寄存器配置好，然后再打开写保护。后续如果需要修改时间，再临时关闭，改完立刻打开。不要一直让写保护处于关闭状态，否则如果程序跑飞或者有干扰，时间数据可能被意外改写。这个习惯在量产产品里尤其重要，因为现场环境复杂，多一层保护就少一分风险。
4.4 时钟启动与初始化流程
完整的初始化流程应该是这样的：首先延时一段时间让 DS1302 上电稳定，然后拉低 CE，给 CLK 一些初始脉冲，确保接口逻辑复位。接着关闭写保护，写入秒、分、时、日、月、周、年等寄存器，注意秒寄存器的最高位要清零以启动时钟。最后打开写保护，拉低 CE 结束通信。
如果你希望每次上电时如果时钟已经在走就不重新配置，可以在初始化前先读秒寄存器的最高位，如果为 0 说明时钟在走，就跳过配置。这样可以避免每次断电重启都把时间重置。这个逻辑在实际产品里很常用，因为用户可能已经手动校准过时间，你不应该覆盖它。
5. 调试过程中那些让人抓狂的典型故障与排查路径
5.1 读出来全是 0xFF 或者 0x00
这是最常见的故障现象。读秒寄存器返回 0xFF，说明数据线一直处于高电平，芯片可能根本没有响应。排查顺序应该是：先确认 CE 是否正常拉高拉低，用示波器或者逻辑分析仪看波形最直接；再确认 CLK 有没有输出，如果 CLK 没动，那肯定是 GPIO 配置问题；然后检查 DAT 线在上拉电阻作用下是否能为高电平，如果一直是低，可能引脚配置成了开漏但没有上拉。
如果读出来全是 0x00，说明数据线一直低。这时候要检查 DS1302 的 VCC 是否正常供电，以及晶振有没有起振。晶振不起振的话，芯片内部逻辑不工作，自然读不到数据。可以用示波器探头靠近晶振引脚，看有没有 32.768kHz 的正弦波。如果没有，检查晶振和电容的焊接，或者换一个晶振试试。
5.2 时间走得快或者走得慢
时间不准通常和晶振有关。如果每天差几秒，那是正常的，DS1302 的精度就是这样。但如果每天差几分钟甚至几十分钟，那肯定是晶振频率偏了。原因可能是负载电容不匹配，或者晶振质量差，或者 PCB 走线引入了额外电容。
我的排查方法是：先换一个已知良好的晶振和匹配电容，看是否改善。如果还是偏，用频率计测量晶振实际频率，和 32.768kHz 对比，算出偏差比例。如果偏差在几十 ppm 以内，可以通过软件补偿，比如每隔一段时间对秒数进行微调。但补偿逻辑比较复杂，一般项目里不如直接换更好的晶振。
5.3 写入后读出来不变
写进去的数据读出来还是旧值，说明写操作没有生效。首先检查写保护是否已经关闭，这是最常见的原因。其次检查 CE 时序，写操作是否在 CE 高电平期间完成。还要注意，写操作和读操作之间需要给芯片一点处理时间，虽然数据手册没明确要求，但实际测试中发现，写完立刻读有时会读到旧值，延时几个微秒再读就正常了。
另外，如果你用的是硬件 SPI 而不是 GPIO 模拟，那问题可能出在 SPI 模式配置上。DS1302 不是标准 SPI，它的时钟极性和相位和标准模式都不太一样，用硬件 SPI 很难调通。所以我一直建议用 GPIO 模拟，虽然代码多一点，但可控性强，出了问题也容易定位。
5.4 掉电后时间丢失
掉电丢时间，说明备用电池没有起作用。检查电池是否装好，电压是否正常，电池座接触是否良好。如果电池没问题，那可能是涓流充电配置错误，导致电池被过度放电。前面说过，不可充电电池必须关闭涓流充电，否则电池很快就会被放空。
还有一个容易忽略的点：DS1302 的 VCC1 是备用电池输入，VCC2 是主电源输入。有些模块把这两个引脚标反了，或者用户接反了，导致主电源掉电时芯片没有切换到电池供电。确认模块原理图，确保 VCC1 接电池，VCC2 接系统电源。如果芯片内部电源切换电路损坏，那只能换芯片了。
6. 从能跑到好用：稳定性优化与项目集成建议
6.1 通信失败时的重试机制
在实际产品里，I2C 或者 SPI 通信偶尔失败是正常的，DS1302 也一样。如果读时间失败一次就直接返回错误，用户体验会很差。我的做法是在读写函数里加一个重试计数，比如连续读三次，如果三次结果一致就认为有效，否则再试。如果重试多次仍然失败，才上报错误。
这个机制能过滤掉大部分偶发干扰。但要注意，重试不能无限循环，否则如果芯片真的坏了，程序会卡死。一般设置 3 到 5 次重试就够了。另外，在读时间之前可以先读一个固定的寄存器（比如读秒寄存器的高位），确认通信正常后再读完整时间，这样能减少无效操作。
6.2 时间数据的缓存与刷新策略
如果你的系统需要频繁读取时间，比如每毫秒都要用，那每次都去读 DS1302 是不现实的，因为三线接口速度有限。更好的做法是在 RAM 里维护一份时间副本，每隔一秒钟从 DS1302 同步一次，其他时候都读 RAM。这样既保证了时间的准确性，又不会拖慢系统。
同步的时机可以选择在秒中断里，或者用一个定时器每秒触发一次。同步时要注意原子操作，避免在更新 RAM 的过程中被其他任务读到半截数据。如果用的是 RTOS，可以用互斥锁保护；如果是裸机，可以关中断再更新。
6.3 与主控 RTC 的配合使用
有些 STM32 型号自带 RTC，但可能因为引脚冲突或者精度问题不想用。这时候可以让 DS1302 作为主时钟源，主控 RTC 作为辅助。比如系统上电时从 DS1302 读取时间，然后设置到主控 RTC 里，之后系统运行期间用主控 RTC 走时，每隔一段时间再和 DS1302 校准一次。
这样做的好处是读取时间速度快，而且主控 RTC 可以在低功耗模式下继续走时。但要注意，主控 RTC 的精度可能不如 DS1302，所以校准周期不能太长。我一般设置每小时校准一次，如果发现偏差较大，再缩短周期。
6.4 代码分层与移植性考虑
最后说一点代码组织上的经验。DS1302 的驱动最好分成两层：底层是 GPIO 操作和时序模拟，上层是寄存器读写和时间转换。底层函数只负责收发字节，不关心字节的含义；上层函数负责 BCD 转换、寄存器地址拼接、时间结构体填充。这样分层之后，如果换一个主控，只需要改底层 GPIO 操作，上层代码完全不用动。
我在多个项目里用这套结构，从 STM32F1 换到 F4，从标准库换到 HAL 库，上层代码几乎原封不动。另外，把延时函数也抽象出来，底层调用一个统一的 delay_us，具体实现可以根据平台替换。这种写法虽然前期多花一点时间，但后期维护和移植的成本会低很多。
7. 写在最后：一些零散但实用的经验碎片
调试 DS1302 的过程中，我踩过的坑远不止上面这些。比如有一次发现时间偶尔会跳变，查了很久才意识到是电源纹波太大，导致芯片内部逻辑误动作，在 VCC 引脚旁边加了一个 0.1μF 的去耦电容就解决了。还有一次是 CE 引脚走线太长，引入了干扰，把走线缩短并远离时钟线之后，通信稳定性明显提升。
另外，如果你用逻辑分析仪抓波形，建议把采样率设高一点，至少 10MHz 以上，这样才能看清 CLK 和数据线的细节。我见过有人用 1MHz 采样率去抓，结果波形全是锯齿，根本看不出上升沿和下降沿的位置。工具用对了，排查效率能提高好几倍。
还有一点关于焊接的提醒：DS1302 的封装有直插和贴片两种，直插的引脚比较脆弱，反复弯折容易断。如果你用模块，一般不用担心；如果是自己焊裸片，建议用贴片封装，焊完之后用放大镜检查一下有没有虚焊，尤其是晶振那两个脚，虚焊会导致不起振，而且很难发现。
这颗芯片虽然老，但把它调通的过程能让你对时序、GPIO 操作、数据编码这些基础概念有更扎实的理解。后面再遇到其他三线或者两线接口的芯片，你会发现思路是相通的。
