企业官网建设流程全解析

做小项目时需要显示时间日期，一开始想在主控芯片内部RTC上做文章，但考虑到备用电池、引脚和精度校准这些额外成本，最终还是翻出几片DS1302。这块经典的实时时钟芯片口碑一直不错，便宜、低功耗、只需要三根线就能读到年月日时分秒，非常适合当学习板上的"外设样本"。更关键的是，它的三线串口协议并不复杂，很适合自己动手从时序开始把驱动写出来，而不是无脑套库。这篇笔记就记录了我从芯片选型、硬件连接、驱动代码到实际调试踩坑的完整过程，希望能给正在折腾STM32和DS1302的同学省下一点时间。

1. 为什么是DS1302：实时时钟的选型逻辑

1.1 DS1302到底是什么

DS1302是一颗带RAM的实时时钟芯片，内部集成了秒、分、时、日、月、星期、年的计数寄存器，通过一个三线串行接口与外部通信。它只需要一个32.768kHz的晶振就能走时，典型工作电流在微安级别，主电源断电后还可以切换到备用电池继续走。芯片内部还附带了31字节的静态RAM，可以用来存一些掉电不能丢的小数据。

这个芯片不能做的事情也很明确：它没有内置温度补偿，走时精度完全取决于外部晶振以及晶振两端的负载电容匹配。常温下一般能保持月误差在几十秒到一分钟的量级，但如果环境温度变化大，误差会随之变化。所以如果你的项目需要"秒级精准"，DS1302不一定合适；但如果是做一个电子钟、数据采集带时间戳、或者练手学习底层外设，它非常合适。

1.2 和片上RTC、DS3231之间的取舍

很多STM32芯片内部就有RTC外设，但实际用过就会发现，内部RTC需要额外的备用电源引脚、外部32.768kHz晶振，而且有些型号的电源切换电路设计起来并不省心。最关键的是，如果主芯片复位或者下载程序后没做好初始化，时间可能直接回到默认值。DS1302则把时间"外包"给了独立芯片，只要电池不松，主芯片怎么复位时间都不会丢，两边的调试可以完全解耦。

和更高阶的DS3231相比，DS3231内置温补晶振，精度能到几个ppm，价格却贵好几倍还不好买。DS1302的性价比在于：足够便宜、货源充足、模块资料多。对学习笔记来说，DS1302还有一个隐藏的优势——它的三线接口是半双工双向，和标准SPI、I2C都不一样，亲手写完驱动之后，你对同步串行时序的理解会扎实很多。

2. 硬件连接与最小电路的细节

2.1 脚位分配：CE、SCLK、IO三根线的接法

DS1302对外关键引脚只有三个通信脚：CE（片选使能）、SCLK（串行时钟）、IO（数据输入输出），再加上电源和地。我用的是STM32F103系列的PA0、PA1、PA2三个引脚来模拟这三根线，接线如下：

注意VCC2和VCC1的区别：VCC2是主电源引脚，VCC1是备用电池引脚，二者电压中较高者会被内部选择器自动选中供电。正常使用时把VCC2接到3.3V，VCC1接一个CR2032电池座即可。如果只是做实验不想接电池，VCC1也可以不接，但一旦断电，时间就会丢失。另外，如果VCC2和VCC1都接3.3V芯片也正常工作，只是没有"断电保持"的意义。

晶振的接法很多人会忽略。DS1302需要的是32.768kHz晶振，典型负载电容6pF，最稳妥的做法是晶振两脚分别对地接一个6pF电容。如果直接买现成的DS1302模块，模块上通常已经焊好了晶振和负载电容，这时候直接引出三根线就行。如果自己搭芯片，一定注意晶振两根走线要尽量短，避免寄生电容过大导致不起振或走时不准。

2.2 上拉电阻、电平兼容和独立GPIO的理由

IO数据线是双向的：主机往芯片写数据时，IO是输入方向；主机从芯片读数据时，芯片在SCLK下降沿驱动IO。为了确保两个方向切换时电平稳定，建议在这根线上加一个10kΩ上拉电阻到3.3V。我用STM32内部的上拉模式也跑通过，但开启内部上拉后如果想读外部下拉信号，会稍微增加翻转难度，所以最终方案还是外部接了一个10k电阻，时序看起来更干净。

电平兼容方面，如果DS1302是3.3V供电，IO高电平就是3.3V，能和常见的3.3V单片机直接相连。如果把VCC2拉到5V，IO高电平也会接近5V，这时候直接接STM32的引脚就可能超压。因此建议全程用3.3V供电，别为了所谓"稳定"去抬高电压。

SCLK时钟也需要注意，DS1302手册里给出的最大时钟频率是2MHz左右。STM32的GPIO模拟速度完全可以满足，但不要把SPI外设直接挂在IO上。因为DS1302的时序不是标准SPI模式，它是上升沿写入、下降沿读取的单线半双工，硬接SPI外设的话还要复用来复用的，反而容易出错。我在项目中一直用普通GPIO模拟三线时序，稳得很。

2.3 上电前的硬件检查清单

把线接好之后，先别急着烧代码。我习惯先做几项简单检查：

• 用万用表测量DS1302的VCC2对地电压，确认是3.3V左右。
• 确认VCC1的电池盒正负极性没有接反，如果电池电压低于2V建议更换。
• 用示波器或万用表测量晶振两脚之间的电压，正常会有几十到几百毫伏的交流抖动；没有条件的话，也可以先上电写代码读时间，看时钟是否走动。
• 检查CE引脚在初始状态下应该是低电平，因为DS1302只有在CE从低变高时才接收指令。

硬件就绪后，就可以开始写驱动了。

3. 从数据手册到代码：三线时序的完整实现

3.1 三线协议的核心：LSB在前、上升沿写、下降沿读

DS1302的通信协议看起来和SPI有点像，但实际是"类SPI"的三线半双工协议。数据线只有一根IO，方向由SCLK边沿控制。它传输数据时是低位在前（LSB first），这点和日常习惯的高位在前完全相反，是新手最容易翻车的地方。

一次数据传输的逻辑是：先把CE拉高，然后开始发送一个控制命令字节；随后根据命令类型发送数据或接收返回数据；最后把CE拉低结束操作。命令字节的格式是最高位固定为1，中间6位是寄存器地址，最低位是读写标志。比如秒寄存器的读命令是0x81，写命令是0x80。发送字节时要从最低位开始依次送出去。

要注意，SCLK不是单纯的方波，它的边沿事件和IO电平有严格的配合：

• 写入数据时，主机在SCLK处于低电平时置好IO电平，然后将SCLK拉高，芯片在上升沿锁存该位。
• 读取数据时，主机将SCLK拉低，芯片在SCLK下降沿之后把当前位放到IO上，主机在下一个上升沿来临前把IO电平采样下来。

所以写字节函数和读字节函数的实现思路完全不同：写字节要在"拉高之前"先把IO设置好；读字节要在"拉低之后"读取IO。

3.2 寄存器地图与BCD码的坑

DS1302的时间寄存器和控制寄存器地址是固定的。常用地址如下：

所有时间数据在芯片内部都使用BCD码保存。比如23分，寄存器里的值是0x23而不是十进制的23。写进去的时候需要把十进制转成BCD，读出来的时候再把BCD转回十进制。很多同学读出来"0x56"直接打印成"56"感觉没问题，但一旦修改时间就会出各种怪毛病，因为没有意识到底层存储方式。

另外秒寄存器的最高位CH很重要：CH为1时振荡器停止，时钟不走。设置时间时必须保证CH为0。写保护寄存器的bit7也一样，置1时所有写操作被忽略，所以每次写时间之前要先清写保护，写完再设回1，防止意外误写。

3.3 一份可以直接使用的驱动代码

下面是我整理好的驱动代码，只依赖ST标准库的GPIO操作，方便移植。核心逻辑都在DS1302_WriteByte和DS1302_ReadByte两个函数里，理解了这两个函数，整个驱动就理解了一半。

#include "stm32f10x.h" #include "ds1302.h" #define DS1302_CE_Clr() GPIO_ResetBits(GPIOA, GPIO_Pin_0) #define DS1302_CE_Set() GPIO_SetBits(GPIOA, GPIO_Pin_0) #define DS1302_SCLK_Clr() GPIO_ResetBits(GPIOA, GPIO_Pin_1) #define DS1302_SCLK_Set() GPIO_SetBits(GPIOA, GPIO_Pin_1) #define DS1302_IO_Clr() GPIO_ResetBits(GPIOA, GPIO_Pin_2) #define DS1302_IO_Set() GPIO_SetBits(GPIOA, GPIO_Pin_2) #define DS1302_IO_Read() GPIO_ReadInputDataBit(GPIOA, GPIO_Pin_2) static void DS1302_DelayShort(void) { for(volatile int i = 0; i < 10; i++); } void DS1302_GPIO_Init(void) { GPIO_InitTypeDef GPIO_InitStructure; RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE); GPIO_InitStructure.GPIO_Pin = GPIO_Pin_0 | GPIO_Pin_1 | GPIO_Pin_2; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP; GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; GPIO_Init(GPIOA, &GPIO_InitStructure); DS1302_CE_Clr(); DS1302_SCLK_Clr(); } static void DS1302_SetIOMode_Out(void) { GPIO_InitTypeDef GPIO_InitStructure; GPIO_InitStructure.GPIO_Pin = GPIO_Pin_2; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP; GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; GPIO_Init(GPIOA, &GPIO_InitStructure); } static void DS1302_SetIOMode_In(void) { GPIO_InitTypeDef GPIO_InitStructure; GPIO_InitStructure.GPIO_Pin = GPIO_Pin_2; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IPU; GPIO_Init(GPIOA, &GPIO_InitStructure); } void DS1302_WriteByte(uint8_t data) { uint8_t mask; DS1302_SetIOMode_Out(); for(mask = 0x01; mask != 0; mask <<= 1) { DS1302_SCLK_Clr(); if(data & mask) { DS1302_IO_Set(); } else { DS1302_IO_Clr(); } DS1302_DelayShort(); DS1302_SCLK_Set(); DS1302_DelayShort(); } } uint8_t DS1302_ReadByte(void) { uint8_t mask, data = 0; DS1302_SetIOMode_In(); for(mask = 0x01; mask != 0; mask <<= 1) { DS1302_SCLK_Clr(); DS1302_DelayShort(); if(DS1302_IO_Read()) { data |= mask; } DS1302_SCLK_Set(); DS1302_DelayShort(); } return data; } static void DS1302_WriteRegister(uint8_t cmd, uint8_t data) { DS1302_CE_Clr(); DS1302_SCLK_Clr(); DS1302_CE_Set(); DS1302_WriteByte(cmd); DS1302_WriteByte(data); DS1302_CE_Clr(); } static uint8_t DS1302_ReadRegister(uint8_t cmd) { uint8_t data; DS1302_CE_Clr(); DS1302_SCLK_Clr(); DS1302_CE_Set(); DS1302_WriteByte(cmd); data = DS1302_ReadByte(); DS1302_CE_Clr(); return data; }

注意上面的写字节函数中，每次循环先把SCLK拉低，再拉高，上升沿到来前IO电平已经稳定，符合写入时序。而在读字节函数中，先在SCLK拉低后读取IO，此时芯片已经在前一个下降沿把数据放到IO上了，然后SCLK拉高让芯片准备下一位。

时间设置和读取函数实现如下：

static uint8_t bin2bcd(uint8_t n) { return ((n / 10) << 4) | (n % 10); } static uint8_t bcd2bin(uint8_t n) { return (n >> 4) * 10 + (n & 0x0F); } void DS1302_SetTime(DS1302_Time *time) { uint8_t cmd = 0; DS1302_WriteRegister(0x8E, 0x00); // 关闭写保护 cmd = 0x80; DS1302_WriteRegister(cmd++, bin2bcd(time->sec)); DS1302_WriteRegister(cmd++, bin2bcd(time->min)); DS1302_WriteRegister(cmd++, bin2bcd(time->hour)); DS1302_WriteRegister(cmd++, bin2bcd(time->date)); DS1302_WriteRegister(cmd++, bin2bcd(time->month)); DS1302_WriteRegister(cmd++, bin2bcd(time->week)); DS1302_WriteRegister(cmd++, bin2bcd(time->year)); DS1302_WriteRegister(0x8E, 0x80); // 打开写保护 } void DS1302_GetTime(DS1302_Time *time) { uint8_t cmd = 0x81; time->sec = bcd2bin(DS1302_ReadRegister(cmd++)); time->min = bcd2bin(DS1302_ReadRegister(cmd++)); time->hour = bcd2bin(DS1302_ReadRegister(cmd++)); time->date = bcd2bin(DS1302_ReadRegister(cmd++)); time->month = bcd2bin(DS1302_ReadRegister(cmd++)); time->week = bcd2bin(DS1302_ReadRegister(cmd++)); time->year = bcd2bin(DS1302_ReadRegister(cmd++)); }

上面GetTime里读秒的那一次很关键：秒寄存器读出来后会顺带把CH位也读进来，如果直接用bcd2bin会得到不对的数字。所以我通常会在主程序里单独处理，或者把秒寄存器的bit7强制清掉。简单做法是读取秒寄存器的原始值后，只取低7位：

time->sec = DS1302_ReadRegister(0x81) & 0x7F;

这样即使CH位因为某种原因被置1，读回来的秒值也是正常的。当然，如果你期望芯片正常走时，还是要在写秒寄存器时保证CH为0。

主程序里初始化和读取的流程就是：

DS1302_GPIO_Init(); DS1302_Time now = {0}; now.sec = 30; now.min = 12; now.hour = 15; now.date = 28; now.month = 6; now.week = 7; now.year = 25; DS1302_SetTime(&now); while(1) { DS1302_GetTime(&now); printf("20%02d-%02d-%02d %02d:%02d:%02d\n", now.year, now.month, now.date, now.hour, now.min, now.sec); delay_ms(500); }

注意年份只需要写低两位。比如2025年，就写25。如果想让秒寄存器不要受CH位干扰，可以在SetTime里先读回原值再处理，不过这里为了代码清晰就略过了。

4. 调试实录：几个让人头大的现象和最终原因

4.1 读出全0xFF：方向、时序和晶振轮流排查

第一次上电运行时，发现所有时间数据读出来都是0xFF。当时第一反应是驱动代码有问题，翻来覆去检查命令字和IO方向切换都没发现明显毛病。后来用逻辑分析仪抓波形，才发现SCLK上升沿之前IO电平根本就没建立起来——原来我在GPIO输出模式下又给IO赋了一个值，但赋值之后没有加延时就直接拉高了SCLK，数据建立时间不足。

解决办法是在每次拉高SCLK之前加入一个短暂的延时，让IO输出稳定。另一个常见原因是IO线没有上拉，读模式下IO内部上拉没有开启，芯片还没来得及驱动IO就已经被读走了，自然读出来全是1。检查了自己的代码，确实在ReadByte开头没有把IO配置为输入上拉，修好之后0xFF的问题立刻消失。

如果你的代码里没犯这些错但依然是0xFF，那就去查晶振。我遇到过晶振引脚接触不良导致芯片完全不工作的案例，换了一块模块就正常了。

4.2 时间停在写入值附近不走：CH位和晶振问题并存

设置完时间后，秒数经常停在启动时刻附近不动。排查过程分两步：第一步，检查秒寄存器原始值，发现最高位确实被置1了。我用工具直接读取0x81，一看bit7是1，说明芯片的振荡器在初始化时没有被启动。DS1302默认上电时秒寄存器的CH位并不保证是0，所以写入秒值时必须显式把这个位清零。

第二步，清掉CH位后发现有些板卡走时，有些板卡仍然不走。把两片DS1302互换后，不走的现象跟着芯片走，怀疑晶振匹配有问题。用示波器观察，不走的那片晶振引脚波形非常微弱，最后更换了标称负载电容为6pF的晶振并短接走线，走时正常了。这个经历再次证明，晶振必须匹配芯片要求的负载电容，不能随便拿一颗32768就往上焊。

4.3 读出来的时间像乱码：BCD码转换忘了做

有段时间读出来的分、秒直接是"50"、"60"这种数，看起来像乱码。其实这就是典型的BCD码没有转换的结果。比如BCD的0x59代表59秒，如果你不把它转成十进制，直接用串口打印0x59会显示89，因为0x59的十进制就是89。解决方式就是前面代码里的bcd2bin函数，取出寄存器值后除以高4位和低4位再组合。

这个坑很小，但因为它影响的是"显示层"而不是"时序层"，很容易被忽略。后来我给驱动加了一个测试接口，直接打印寄存器原始值和转换后的值，对比一眼就能发现问题。

4.4 断电后时间丢回初始值：备用电池和写保护的双重陷阱

实验板每次拔掉USB重新上电，时间都会回到某个固定初始值。我的第一反应是电池没接好，检查VCC1电压正常，于是怀疑芯片坏了。后来仔细看设置代码才发现，我在SetTime里每次都会先关写保护，写完日期后忘了重新打开写保护。这样看似没什么问题，但断电瞬间如果电源跌落期间芯片收到了干扰，就可能在非写保护状态下误写寄存器，导致时间丢失。

更重要的是，如果VCC1没有接电池，主电源一断，芯片时间肯定全丢。这是DS1302的工作方式决定的，不是bug。所以做实验时先确认电池极性，再确认代码里写保护状态。正确的流程是：设置时间前关闭写保护，设置完成后立即打开，并把它放在一个单独的函数里，避免每次偏差都不一样。

5. 驱动封装、移植和开源笔记的整理建议

5.1 把驱动变成可复用的模块

写完Demo后，为了方便以后移植到其他单片机，我把驱动拆成了独立文件。头文件里只暴露初始化、设置时间和读取时间三个接口，所有GPIO操作通过宏定义隔离。换芯片时只需要修改宏定义的引脚和初始化函数里的GPIO时钟，核心的时序代码可以原封不动搬走。

建议你也这样做，因为你很难保证下一块板子还恰好用PA0工作。模块化的好处还在于可以让代码直接被其他项目引用，时间读取放在某个后台定时器里刷新，前台业务逻辑完全不用关心底层协议。

5.2 扩展玩法：OLED显示、串口校准和误差补偿

驱动稳定之后，我陆续加了不少周边功能。最基本的做法是接一个OLED显示屏，每秒钟刷新一次当前时间，变成一个桌面电子钟。更进一步，可以在串口接收一个约定好的格式字符串，比如"TIME 2025-06-28 15:30:00"，然后在串口中断里解析并调用DS1302_SetTime，这样就能方便的用手在上位机校准时间。

DS1302的走时精度比较随缘，如果项目要求高，可以每隔一段时间通过串口从主机获得准确时间，再对DS1302做校准。我试过用内部分频计数器的辅助测量晶振误差，但实际工程里更稳妥的办法是进行周期校时：每天从授时源同步一次时间写入DS1302，误差积累就被切断了。这个方案简单可靠，比折腾外部晶振的微调电容省心得多。

5.3 写学习笔记时，哪些信息最值得记录

如果你打算像我一样把这次项目整理成开源学习笔记，别只贴源码和接线图。我翻看过网上很多开源笔记，发现最容易让人卡住的是时序细节和踩坑过程。你可以在笔记里明确写出这三个关键信息：命令字节从低位开始传输；写时序是"先置IO、后拉高SCLK"，读时序是"先拉低SCLK、后读IO"；秒寄存器最高位CH默认可能为1，必须显式清零。

另外把你调试验证用的逻辑分析仪截图也放进去，哪怕是手机拍的简陋图片都行。别人看到波形图和代码一一对应，比自己纯看文字理解快得多。调试过程遇到的现象和隐性坑，比如"读出来全0xFF"和"时间不走"，一定要写清楚。我后来回看这些记录时发现，有价值的不是最终跑通的代码，而是那些当时让我卡了半小时的细节。

我认为，做这类开源学习笔记的核心思路是：让别人看完之后，就算手头只有一块最小系统板和几片DS1302，也能百分之百复现你的结果。这样的笔记才有真正的价值。

最后再分享一个小经验：我在调试三线时序时，临时加了一个调试函数，每次调用DS1302_WriteByte后，把写进去的每一个比特都通过串口打印出来，对照数据手册的命令字逐位核对。这样能在不依赖示波器的情况下，快速定位是哪一位时序出了问题。这个笨办法在多个驱动调试场景里都救过我，推荐你试一下。