从买来那块 DS1302 模块到把它在 STM32 上彻底调通我前后折腾了两天。网上关于 DS1302 的代码确实不少但很多都是 51 平台直接复制过来的要么没讲时序要么对 STM32 的 GPIO 模式切换一笔带过。这篇学习笔记把整个驱动从零写一遍包括为什么用 GPIO 模拟时序、命令字节的坑、BCD 码换算、写保护和时钟暂停位把你可能遇到的坑提前踩平。适合正在学 STM32、想搞懂串行时序、或者需要给手头项目加一个掉电不丢时间的实时时钟的开发者参考。1. 思路先行为什么用 GPIO 模拟 DS1302而不是硬件 SPI1.1 DS1302 是什么这个项目能学到什么DS1302 是一颗非常经典的实时时钟芯片内部自带秒、分、时、日、月、星期、年的寄存器还有 31 字节的非易失性静态 RAM。它的典型应用就是给嵌入式系统提供“掉电后继续走”的时间基准主电源 VCC2 正常供电时芯片工作外部断电后由 VCC1 上的纽扣电池或大电容维持计时。这种机制对很多需要记录事件时间戳、定时任务、电子钟表、数据记录仪之类的项目非常有用。驱动 DS1302 对你理解 STM32 的 GPIO 操作也很有帮助。它用的是三线串行接口CE、SCLK、IO看起来像 SPI但实际时序有自己的一套。手写这套驱动你会把“时序图怎么读”“命令字节怎么组织”“双向 IO 怎么处理”“BCD 码怎么换算”这些问题一次性过一遍。这些基本功在以后驱动传感器、存储器、显示屏时都会反复用到。从我自己的角度看这个项目特别适合作为“学习笔记”的素材因为它的逻辑不复杂但每个环节都能挖出细节。只要认真走一遍以后再遇到类似的串行器件上手速度会快很多。1.2 GPIO 模拟 vs 硬件 SPI我为什么这样选DS1302 的三线接口在某些代码里被归类成“类 SPI”也有人直接用硬件 SPI 去驱动过。但从数据手册的时序来看它跟标准 SPI 并不是一回事DS1302 需要 CE 拉高作为一次传输的开始数据按 LSB 先发命令字节带有固定的高位标志位而且 IO 是半双工双向口。用硬件 SPI 不是不行但你需要额外处理 IO 方向切换、调整时钟极性和相位还可能被 SPI 外设的字节长度、片选控制等问题困扰。折腾半天最后发现还是 GPIO 模拟更干净。GPIO 模拟的好处是每个时钟沿、每个电平变化都在你自己手里。出问题时可以用逻辑分析仪抓波形一步一步对时序图定位非常快。DS1302 的时钟频率上限大约是 2MHz实际应用里我们通常给它 1us 级别的半周期延时这个速度对 GPIO 来说毫无压力完全不用担心模拟方式跑不动。这个选择也符合我自己的习惯能用简单方案把事情做稳就不用复杂方案。特别是学习阶段每行代码都看得懂、每个状态都测得出来远比“外设配置对但说不清为什么”有价值。2. 时序与寄存器最容易翻车的三个关键细节2.1 命令字节、LSB 和读写时序的关键点DS1302 的每次操作都是从 CE 拉高开始然后主机通过 IO 发送一个命令字节再要么写一个数据字节要么读一个数据字节最后 CE 拉低。命令字节的格式是固定的bit7 固定为 1bit6 用于区分操作对象0 表示操作时钟寄存器1 表示操作内部 RAMbit5 到 bit1 是寄存器地址bit0 表示读或写0 写、1 读。另一个容易忽略的地方是数据是 LSB first也就是低位在前。很多从 SPI 转过来的人习惯性先发高位结果一上来就读到完全错乱的数据。写一个字节时每次先把当前 bit 放到 IO 上然后产生一个 SCLK 上升沿芯片在这个上升沿采样数据。读一个字节时芯片会在 SCLK 下降沿之后把数据放到 IO 上所以主机应该在 SCLK 高电平期间读取 IO或者下降沿后稍作延时再读。我实测在 SCLK 高电平期间读是稳定的前提是 IO 方向已经切对。还有一个细节很关键读命令发送完最后一个 bit 之后IO 要立刻从输出转为输入。如果切换慢了芯片开始输出数据时你的引脚还在驱动总线两边打架轻则读到错误数据重则可能损伤 IO。这也是我为什么在底层函数里把“释放 IO”放在读字节循环前面。2.2 寄存器地址表与 BCD 码换算DS1302 的时钟寄存器从秒到年写地址和读地址相差 1规律非常明显。我整理了一张常用地址表寄存器写地址读地址说明秒0x800x81bit7 是时钟暂停位 CH分0x820x83无特殊标志位时0x840x85bit7 是 12/24 小时模式标志日0x860x87无特殊标志位月0x880x89无特殊标志位星期0x8A0x8B取值范围 1 到 7年0x8C0x8D两位年份如 24 表示 2024写保护0x8E0x8Fbit7 置 1 禁止写入涓流充电0x900x91用于给备份电容充电时钟突发0xBE0xBF一次连续读写全部时钟寄存器RAM 突发0xFE0xFF一次连续读写 31 字节 RAM芯片内部的时间数据全部用 BCD 码保存也就是说一个字节的高四位表示十位低四位表示个位。比如秒寄存器里存 0x45就代表 45 秒而不是十进制的 45 对应的 0x2D。所以读写时间时必须有十进制到 BCD、BCD 到十进制的转换函数。这个换算本身不难但漏掉任何一个方向都会让你调半天。2.3 写保护位、时钟暂停位和 24 小时模式的坑写保护是新手第一个容易踩的坑。DS1302 上电后写保护位不一定处于关闭状态如果你不先把写保护位寄存器0x8E的 bit7 清零那么所有写入操作都会被忽略时间怎么都写不进去。很多人调了很久“写不进去”最后发现就是少了这一句。第二个坑是秒寄存器里的 bit7也就是时钟暂停位。当这个位为 1 时芯片内部振荡器被关闭秒数根本不会走。如果你发现模块能读到时间但秒数一直不变十有八九是这个位没清。初始化时读秒寄存器把 bit7 清掉再写回去时钟才会真正跑起来。第三个坑比较隐蔽是小时寄存器的掩码处理。秒、分寄存器读出来时通常用 0x7F 把最高位清掉小时寄存器却有人用 0x3F。问题在于 24 小时制下小时十位的 2 存储在 bit6如果你用 0x3F 去掩码会把 20 点到 23 点的数据直接变成 0 点到 3 点。正确做法是设置时间时用 0x7F 清除 12/24 模式的 bit7读取时也用 0x7F 保留 bit6。这个细节不踩一次很难意识到我在日志里看到 20 点读成 00 点的时候还纳闷了很久。3. 驱动代码实现从底层字节读写到时间封装3.1 引脚定义与 GPIO 初始化开漏模式的便利我先说 GPначала引脚分配。以 STM32 的 GPIOB 为例PB0 接 CEPB1 接 SCLKPB2 接 IO。芯片的 VCC2 接 3.3VGND 接地IO 线上加一个 4.7k 欧姆上拉电阻到 3.3VVCC1 我接了一个纽扣电池座。32.768kHz 晶振的两端按模块设计接好通常模块上已经预留了电容位置。初始化 GPIO 时我对三个引脚用了不同策略。CE 和 SCLK 是主机输出配置成推挽输出。IO 是双向口我选择了开漏输出模式并开启内部上拉配合外部 4.7k 上拉电阻。为什么用开漏因为 STM32 的开漏输出模式下输出数据寄存器写 1 时引脚处于释放状态此时可以把这个引脚当输入用直接读 GPIO 的输入数据寄存器就能拿到外部电平。这样 IO 方向切换不再需要重新配置 GPIO 模式写数据时写 0 和写 1读数据时写 1 释放总线然后读稳定又干净。如果使用推挽输出理论上写数据更快但读取前必须把引脚从输出模式切换到输入模式切换时机不对很容易产生毛刺。对比下来开漏加外部上拉更合适尤其适合 DS1302 这种低速半双工接口。#include main.h #include stdint.h #define DS1302_CE_PORT GPIOB #define DS1302_CE_PIN GPIO_PIN_0 #define DS1302_SCLK_PORT GPIOB #define DS1302_SCLK_PIN GPIO_PIN_1 #define DS1302_IO_PORT GPIOB #define DS1302_IO_PIN GPIO_PIN_2 #define DS1302_CE_LOW() HAL_GPIO_WritePin(DS1302_CE_PORT, DS1302_CE_PIN, GPIO_PIN_RESET) #define DS1302_CE_HIGH() HAL_GPIO_WritePin(DS1302_CE_PORT, DS1302_CE_PIN, GPIO_PIN_SET) #define DS1302_SCLK_LOW() HAL_GPIO_WritePin(DS1302_SCLK_PORT, DS1302_SCLK_PIN, GPIO_PIN_RESET) #define DS1302_SCLK_HIGH() HAL_GPIO_WritePin(DS1302_SCLK_PORT, DS1302_SCLK_PIN, GPIO_PIN_SET) #define DS1302_IO_WRITE(v) HAL_GPIO_WritePin(DS1302_IO_PORT, DS1302_IO_PIN, (v) ? GPIO_PIN_SET : GPIO_PIN_RESET) #define DS1302_IO_READ() HAL_GPIO_ReadPin(DS1302_IO_PORT, DS1302_IO_PIN) static void ds1302_gpio_init(void) { GPIO_InitTypeDef gpio {0}; __HAL_RCC_GPIOB_CLK_ENABLE(); gpio.Pin DS1302_CE_PIN | DS1302_SCLK_PIN; gpio.Mode GPIO_MODE_OUTPUT_PP; gpio.Pull GPIO_NOPULL; gpio.Speed GPIO_SPEED_FREQ_LOW; HAL_GPIO_Init(GPIOB, gpio); gpio.Pin DS1302_IO_PIN; gpio.Mode GPIO_MODE_OUTPUT_OD; gpio.Pull GPIO_PULLUP; HAL_GPIO_Init(GPIOB, gpio); DS1302_CE_LOW(); DS1302_SCLK_LOW(); DS1302_IO_WRITE(1); }初始化最后那三行不是摆设。CE 低电平让芯片处于待机状态SCLK 低电平保证没有时钟沿触发误动作IO 写 1 释放总线避免复位后引脚状态不确定拖住总线。3.2 底层读写一个字节实现和原理看代码前先明确一下 DS1302 的位时序。写字节时主机把当前位放到 IO 上然后 SCLK 拉高形成上升沿芯片采样再拉低准备下一位。读字节时芯片在 SCLK 下降沿之后更新输出所以主机可以在 SCLK 高电平期间读取 IO。static void ds1302_delay_us(uint32_t us) { for (uint32_t i 0; i us; i) { for (volatile uint32_t j 0; j 16U; j) { __NOP(); } } } static void ds1302_write_byte(uint8_t dat) { uint8_t i; for (i 0; i 8; i) { DS1302_IO_WRITE(dat 0x01); DS1302_SCLK_HIGH(); ds1302_delay_us(1); DS1302_SCLK_LOW(); ds1302_delay_us(1); dat 1; } } static uint8_t ds1302_read_byte(void) { uint8_t i, dat 0; DS1302_IO_WRITE(1); for (i 0; i 8; i) { dat 1; DS1302_SCLK_HIGH(); ds1302_delay_us(1); if (DS1302_IO_READ()) { dat | 0x80; } DS1302_SCLK_LOW(); ds1302_delay_us(1); } return dat; }读函数里每次循环先把 dat 右移一位再根据 IO 电平决定要不要置最高位相当于在收集一个反转的移位寄存器。为什么不在循环开始直接读 IO 再移位也可以但要保证第 0 位落在 bit0而不是最后变成反序。我习惯先移位再置位配合 LSB first 的特性最后自然得到正确的字节。延时 1us 是故意的。DS1302 的 SCLK 最快大概到 2MHz半个周期就是 250ns 左右不延时也能跑。但实测中如果 STM32 主频较高、代码优化开得激进没有延时的时钟沿翻转容易超出芯片规格导致偶发读取错误。加 1us 延时后时序余量很充足又不影响实际体验属于“花小钱买个稳”。3.3 寄存器读写与时间结构封装底层写好之后寄存器读写就很直白了。注意我的接口约定所有寄存器参数统一使用偶数地址也就是手册里的“写地址”函数内部把 bit0 改成 0 或 1。void ds1302_write_reg(uint8_t reg, uint8_t val) { reg 0xFE; DS1302_CE_HIGH(); ds1302_write_byte(reg); ds1302_write_byte(val); DS1302_CE_LOW(); } uint8_t ds1302_read_reg(uint8_t reg) { uint8_t val; reg | 0x01; DS1302_CE_HIGH(); ds1302_write_byte(reg); val ds1302_read_byte(); DS1302_CE_LOW(); return val; }每次传输 CE 都要经历一次拉低拉高。CE 拉低是固定的结束标志不要省略。如果没有在读完最后一个 bit 后把 CE 拉低芯片不会正常结束本次传输下一次操作时序会乱。这个坑我在调试突发模式时踩过后面会细说。接下来是 BCD 转换和时间结构。typedef struct { uint8_t year; uint8_t month; uint8_t day; uint8_t week; uint8_t hour; uint8_t min; uint8_t sec; } ds1302_time_t; static uint8_t ds1302_dec_to_bcd(uint8_t dec) { return (uint8_t)(((dec / 10) 4) | (dec % 10)); } static uint8_t ds1302_bcd_to_dec(uint8_t bcd) { return (uint8_t)((bcd 4) * 10 (bcd 0x0F)); } void ds1302_set_time(const ds1302_time_t *tm) { ds1302_write_reg(0x8E, 0x00); ds1302_write_reg(0x80, ds1302_dec_to_bcd(tm-sec) 0x7F); ds1302_write_reg(0x82, ds1302_dec_to_bcd(tm-min) 0x7F); ds1302_write_reg(0x84, ds1302_dec_to_bcd(tm-hour) 0x7F); ds1302_write_reg(0x86, ds1302_dec_to_bcd(tm-day) 0x3F); ds1302_write_reg(0x88, ds1302_dec_to_bcd(tm-month) 0x1F); ds1302_write_reg(0x8A, ds1302_dec_to_bcd(tm-week) 0x07); ds1302_write_reg(0x8C, ds1302_dec_to_bcd(tm-year)); ds1302_write_reg(0x8E, 0x80); } void ds1302_get_time(ds1302_time_t *tm) { uint8_t b; b ds1302_read_reg(0x80); tm-sec ds1302_bcd_to_dec(b 0x7F); b ds1302_read_reg(0x82); tm-min ds1302_bcd_to_dec(b 0x7F); b ds1302_read_reg(0x84); tm-hour ds1302_bcd_to_dec(b 0x7F); b ds1302_read_reg(0x86); tm-day ds1302_bcd_to_dec(b 0x3F); b ds1302_read_reg(0x88); tm-month ds1302_bcd_to_dec(b 0x1F); b ds1302_read_reg(0x8A); tm-week ds1302_bcd_to_dec(b 0x07); b ds1302_read_reg(0x8C); tm-year ds1302_bcd_to_dec(b); }设置时间函数第一行关闭写保护最后一行为可选的重新开启写保护。如果你打算频繁校时可以留着写保护打开防止其他代码误操作时间寄存器。读时间函数里的小时掩码用了 0x7F而不是常见的 0x3F这一点我在前文反复强调过20 点到 23 点的十位信息在 bit6用错掩码会直接把时间读错。3.4 main 函数接入示例接入工程很简单初始化调用一次 gpio init如果模块是第一次上电或者需要校时就调用一次 set_time之后循环读时间即可。int main(void) { HAL_Init(); SystemClock_Config(); ds1302_gpio_init(); ds1302_time_t t { .year 24, .month 5, .day 18, .week 6, .hour 10, .min 30, .sec 0 }; ds1302_set_time(t); while (1) { ds1302_get_time(t); printf(%02u-%02u-%02u %02u:%02u:%02u week%u\r\n, t.year, t.month, t.day, t.hour, t.min, t.sec, t.week); HAL_Delay(1000); } }注意演示代码里每次上电都 set_time实际项目不该这么做否则每次断电重启时间都会重置。正确做法是只做初始化清除写保护和时钟暂停位让芯片跟着备用电池继续走。如果需要判断“是否需要校时”可以存一个标志位到 DS1302 内置 RAM或者通过按键、上位机命令主动校时。4. 调不通怎么办常见症状排查与避坑实录4.1 读数全是 0xFF 或 0x00优先排查这五点如果你读出来的时间全是 0xFF或者全是 0x00不要急着怀疑芯片坏了。按照下面这个顺序查绝大多数问题都能定位。第一查接线。CE、SCLK、IO 三根线有没有接反VCC2 的电压是否在 2.0V 到 5.5V 之间GND 是不是和 STM32 共地。很多模块自带电池座电池极性反了也会导致怪现象。第二查 IO 上拉。如果用开漏模式但没有外部上拉只是依赖 STM32 内部上拉读数据时总线可能被拉到一个不稳定的中间态尤其在 IO 方向切换的瞬间。所以外部 4.7k 上拉强烈建议要加。第三查 SCLK 延时。代码里的 1us 延时是否真的生效。有些工程开了 O3 优化空循环可能被编译器优化掉一部分导致时钟翻转过快。第四查 CE 时序。每次读写都必须 CE 高电平开始、低电平结束。如果 CE 一直悬空或者没有正确拉低芯片的传输状态会混乱。第五查命令字节。最简单的方法是买个十几块钱的逻辑分析仪抓一下 CE、SCLK、IO 三根线对一下命令字节是不是 0x80 写、0x81 读这样的正确序列。没有逻辑分析仪的话可以用 GPIO 翻转法在读写函数前后翻转一个调试引脚再用示波器看间隔。我这里遇到过一次比较隐蔽的情况读出来全是 0xFF追查发现是 IO 引脚在初始化时被配置成了推挽输出写数据时正常但读数据前切换输入模式没有成功。换成开漏模式后问题再没出现过。4.2 秒数不走、分钟乱跳的处理秒数完全不动大概率是时钟暂停位。秒寄存器 bit7 是 CH为 1 时振荡器关闭。初始化时或者每次 set_time 时把这个位清 0秒针就开始走了。如果清 0 之后走了几秒又停住可能是代码某处又把秒寄存器写成带 CH 位的数据比如没有掩码直接写回了一个含 0x80 的 BCD 值。分钟乱跳则常发生在连续单字节读取时。因为秒和分是两个独立寄存器读取过程中如果恰好跨越秒进位边界你可能读到“新秒 旧分”的组合看起来就是分钟突然变化。避免办法有两个。第一个是连续读两次秒寄存器如果两次结果不一致说明跨越了进位重新读一遍完整时间。第二个更优雅直接使用时钟突发模式一次读出秒、分、时、日、月、星期、年 7 个字节减少跨寄存器的不一致窗口。突发读命令是 0xBFCE 拉高后发命令然后连续读 7 个字节最后 CE 拉低。要注意的是CE 保持高电平期间芯片会持续输出数据所以必须按需要的长度读读完立刻拉低 CE否则会进入循环输出时序全部乱掉。4.3 掉电不保存和涓流充电的配置掉电后时间丢失最常见原因是 VCC1 没有接备用电源或者纽扣电池没电了。DS1302 正常工作时由 VCC2 供电断电后切换到 VCC1。注意 VCC1 的电压不能高于 VCC2 加 0.3V否则内部电源切换电路可能出问题。所以 VCC1 接 3V 纽扣电池或 2.4V 到 3.6V 的超级电容是稳妥的。如果你想用超级电容并希望主电源在的时候自动给它充电可以配置涓流充电寄存器 0x90。这个寄存器的用法比较讲究高四位 TCS 必须写成 1010 才会使能充电中间两位选择二极管数量低两位选择充电电阻。一个常见配置是 0xA5代表一个二极管加 2k 欧姆电阻也有模块出厂配置成 0xA6 或 0xA7。如果这个寄存器的 TCS 位不是 1010涓流充电是关闭的。我自己踩过充电相关的一个坑一开始为了省事直接写 0xA5结果 0.22F 的超级电容很快就充满了但芯片时间正常。后来换了大容量电容才发现如果电容太大2k 电阻的充电电流可能偏大需要根据电容容量调整电阻档位。所以没什么特别需求时不要把涓流充电开得太激进宁可电容大一点、充得慢一点。5. 最后再分享三个实用小技巧5.1 读时间更稳的一个小技巧突发读模式前面提到突发模式可以减少跨秒进位的读数不一致问题这里直接给一个简单的实现。时钟突发读命令是 0xBFCE 高电平期间连续读 7 个字节最后 CE 拉低。void ds1302_get_time_burst(ds1302_time_t *tm) { uint8_t buf[7]; uint8_t i; DS1302_CE_HIGH(); ds1302_write_byte(0xBF); for (i 0; i 7; i) { buf[i] ds1302_read_byte(); } DS1302_CE_LOW(); tm-sec ds1302_bcd_to_dec(buf[0] 0x7F); tm-min ds1302_bcd_to_dec(buf[1] 0x7F); tm-hour ds1302_bcd_to_dec(buf[2] 0x7F); tm-day ds1302_bcd_to_dec(buf[3] 0x3F); tm-month ds1302_bcd_to_dec(buf[4] 0x1F); tm-week ds1302_bcd_to_dec(buf[5] 0x07); tm-year ds1302_bcd_to_dec(buf[6]); }这段代码与单字节读取的效果差别在读数的连续性。对精度要求不高的场景用单字节逐项读取也够但如果你做的是数据记录仪这类对时间一致性有要求的设备建议直接用突发读。5.2 31 字节 RAM 的妙用和扩展玩法DS1302 除了时间寄存器还有一块 31 字节的 RAM地址从 0xC0 到 0xFD写地址是偶数读地址对应加 1。这块 RAM 在电池供电时会保持数据非常适合存放一些掉电不能丢的小参数比如设备编号、校时标志、上次关机时间。使用方式就是普通的寄存器读写只是地址范围换一下。我自己的扩展玩法是做一个“开机判断”首次上电时读 RAM 里的一个标志字节如果不是预设魔数就认为模块从未初始化自动执行一次 set_time并把魔数写入 RAM。这样既不会每次开机都重置时间也能在换电池后自动重新校时。这个思路可以移植到很多带掉电存储需求的场景里。另外如果你需要输出更精确的秒信号可以看 DS1302 的 SQW 引脚功能不过很多模块没把该引脚引出来。真要高精度长稳计时还是直接选带温度补偿的实时时钟方案DS1302 的优势是便宜、简单、入门友好。这块芯片虽然老但它把串行时序、双向 IO、寄存器操作这几个嵌入式基本功都串了起来。我第一次调通的时候看到串口打印出稳定的秒数心里还是挺有成就感的。如果你也卡在某个读数的怪问题上试着用逻辑分析仪抓一下波形很多时候一眼就能看出问题。代码我已经整理到开源仓库里对照这篇笔记看应该能把 DS1302 在 STM32 上顺利跑起来。