STM32 驱动 DS1302 这套代码我整理了很久最开始是纯粹的学习笔记后来发现网上的资料实在太零散才决定把它按开源项目的标准重新梳理了一遍。DS1302 是一颗很经典的串行实时时钟芯片跟 STM32 配合起来并不复杂但里面有很多细节比如寄存器地址、BCD 码转换、写保护、晶振起振任何一个环节没弄对读出来的时间就会千奇百怪。这篇文章适合刚学会 GPIO 控制、想接触时序外设的初学者也适合已经把模块跑起来但总是读到怪数据的同学。我会从方案选型开始讲然后给出完整的驱动代码再把踩过的坑全部翻出来最后说一下怎么把这套代码搬到自己的工程里。1. 项目概述与整体设计思路1.1 DS1302 到底是什么DS1302 是一颗低功耗的串行实时时钟芯片内部带有年月日时分秒的计数寄存器还有一个 31×8 位的 RAM 可以存一些校准参数。它只需要外接一颗 32.768kHz 的晶振再给它一个备用电池就能在主系统掉电之后继续走时。相比 STM32 内部自带的 RTC外部 DS1302 的好处是模块化、移植方便换一块板子也能继续用而且不用操作备份域时钟和复杂的电源切换逻辑。很多 DS1302 模块上直接带了晶振和备用电池座买回来接上 STM32 的 GPIO 就能测。它和芯片之间的通信是三条线CE片选使能、SCLK串行时钟、IO双向数据不是标准的 I2C也不是标准的 SPI但本质上是一种非常简单的三线串行总线。1.2 为什么拿 STM32 来驱动它STM32 的 GPIO 资源丰富用普通引脚模拟这套时序非常方便。DS1302 的 IO 口是双向的读写都走同一根线这意味着主控需要随时把这根线从输出切换成输入、或者从输入切换成输出。STM32 的 GPIO 模式切换非常灵活用 HAL 库改一个结构体就能完成。另外DS1302 的工作电压范围比较宽3.3V 和 5V 系统都能用。现在的 STM32 开发板绝大多数是 3.3V 逻辑电平直接给 DS1302 供 3.3VIO 电平一致不需要电平转换。我手头用的是 STM32F103 系列的核心板GPIO 输出速度设成高速驱动 DS1302 完全够用。1.3 方案选型模拟时序还是硬件 SPI最开始我也想过用 STM32 的硬件 SPI 来驱动 DS1302毕竟它也有时钟、数据、使能引脚。但仔细看数据手册就会发现DS1302 的 IO 是单线双向硬件 SPI 的 MOSI 和 MISO 是分开的如果强行用硬件 SPI就必须把 MOSI 和 MISO 外部短接还要频繁切换 SPI 的方向。命令字节是 LSB 优先时钟极性和相位也不是直接对应常用 SPI Mode 0 或者 Mode 3调起来非常别扭。所以最终的方案选择是用 GPIO 模拟三线时序。这种做法的优势有三个不占用 SPI 外设时序完全由软件控制容易排查问题。换到任何 MCU 都只需要改几个 GPIO 宏不用重新调硬件外设。代码逻辑清晰学习价值高看完就能理解 DS1302 的通信协议。2. 读懂 DS1302 的通信时序和寄存器2.1 三线接口通信协议DS1302 的通信基础是 CE、SCLK、IO 三根线。CE 从低变高之后芯片进入数据传输状态SCLK 提供时钟IO 上一位一位地传输命令和数据。每次读写操作都要先发一个命令字节再传输数据字节。命令字节的格式是bit7 固定为 1bit6 固定为 0bit5 到 bit1 是寄存器地址bit0 是读写标志。bit0 为 0 表示写为 1 表示读。比如秒寄存器的写命令是 0x80读命令是 0x81分钟寄存器的写命令是 0x82读命令是 0x83。所有字节都是 LSB 优先也就是最低位先发。SCLK 空闲时必须保持低电平。写数据时主机在 SCLK 低电平期间把数据放到 IO 上然后拉高 SCLK上升沿把数据锁存进 DS1302读数据时DS1302 会在 SCLK 下降沿切换数据主机在 SCLK 高电平期间读取 IO 是稳定的。所以底层函数里写字节的循环是“放数据、拉高、拉低”读字节的循环是“拉高、读数据、拉低”。注意CE 拉高之前SCLK 和 IO 都应该是低电平CE 拉低之后本次传输结束IO 会恢复高阻。这个顺序必须严格保持否则芯片可能不认命令。2.2 寄存器地址和 BCD 编码DS1302 内部的时间寄存器都是 BCD 码存储的。BCD 码的意思是用四位二进制表示一位十进制数比如秒 59在寄存器里存的是 0x59而不是十进制的 89。很多新手直接拿十六进制转十进制去处理结果时间显示得乱七八糟问题就出在这里。常用寄存器地址如下表寄存器写命令读命令取值范围有效位说明秒0x800x8100~59bit7 是时钟停止位 CH低 7 位是秒分0x820x8300~59低 7 位有效时0x840x8501~12 或 00~2324 小时制时保留低 6 位日0x860x8701~31低 6 位有效月0x880x8901~12低 5 位有效bit7 是世纪位星期0x8A0x8B01~07低 3 位有效年0x8C0x8D00~998 位全部有效写保护0x8E0x8Fbit7 WPWP1 时禁止写任何寄存器充电0x900x91—涓流充电配置不用就写 0x00BCD 转换的公式很简单十位 值 4个位 值 0x0F。比如寄存器读出来 0x59(0x59 4) * 10 (0x59 0x0F) 5 * 10 9 59。反过来要把 59 写成寄存器就((59 / 10) 4) | (59 % 10) 0x59。2.3 写保护、充电和时钟启动DS1302 的写保护寄存器地址是 0x8Ebit7 WP 默认状态不一定为 0。如果 WP 是 1你再怎么写秒、分、时都是无效的。所以每次设置时间之前都要先把 WP 清 0写完所有寄存器后再把 WP 置 1防止误写。秒寄存器的 bit7 是 CH 位。CH 写 1 会让内部振荡器停止时钟不走CH 写 0 才会让晶振跑起来。上电后第一次使用 DS1302最好完整设置一次时间并把秒寄存器的 CH 位写成 0否则芯片可能一直停在那里不动。充电寄存器 0x90 是用来配置备用电池或者超级电容充电的常见做法是不使用充电功能时直接写 0x00。如果要给电池充电TCS、DS、RS 这些位必须按数据手册的固定组合来配置不能随便写。比如常见的配置是串一个二极管加一个 2kΩ 限流电阻但具体值要看你的电池规格和模块设计我这里不推荐照抄某个固定值。3. STM32 驱动代码完整拆解3.1 引脚分配和 GPIO 初始化我用的是 PB11 接 CE、PB12 接 IO、PB13 接 SCLK三根线占三个普通 GPIO。模块供电直接接 3.3V共地。如果你手里的板子引脚占用不同只需要改 ds1302.c 头部的宏定义其他代码不用动。GPIO 初始化时CE 和 SCLK 配置成推挽输出IO 先配置成输入状态后面在读写函数里再动态切换方向。CE 和 SCLK 上电后都要保持低电平。#include ds1302.h #define DS1302_PORT GPIOB #define DS1302_CE_PIN GPIO_PIN_11 #define DS1302_IO_PIN GPIO_PIN_12 #define DS1302_SCLK_PIN GPIO_PIN_13 #define DS1302_SEC_REG 0x80 #define DS1302_MIN_REG 0x82 #define DS1302_HOUR_REG 0x84 #define DS1302_DATE_REG 0x86 #define DS1302_MONTH_REG 0x88 #define DS1302_DAY_REG 0x8A #define DS1302_YEAR_REG 0x8C #define DS1302_WP_REG 0x8E static void DS1302_IO_Mode_Output(void) { GPIO_InitTypeDef GPIO_InitStruct {0}; GPIO_InitStruct.Pin DS1302_IO_PIN; GPIO_InitStruct.Mode GPIO_MODE_OUTPUT_PP; GPIO_InitStruct.Speed GPIO_SPEED_FREQ_HIGH; HAL_GPIO_Init(DS1302_PORT, GPIO_InitStruct); } static void DS1302_IO_Mode_Input(void) { GPIO_InitTypeDef GPIO_InitStruct {0}; GPIO_InitStruct.Pin DS1302_IO_PIN; GPIO_InitStruct.Mode GPIO_MODE_INPUT; GPIO_InitStruct.Pull GPIO_NOPULL; HAL_GPIO_Init(DS1302_PORT, GPIO_InitStruct); } void DS1302_Init(void) { GPIO_InitTypeDef GPIO_InitStruct {0}; __HAL_RCC_GPIOB_CLK_ENABLE(); GPIO_InitStruct.Pin DS1302_CE_PIN | DS1302_SCLK_PIN; GPIO_InitStruct.Mode GPIO_MODE_OUTPUT_PP; GPIO_InitStruct.Speed GPIO_SPEED_FREQ_HIGH; HAL_GPIO_Init(DS1302_PORT, GPIO_InitStruct); DS1302_IO_Mode_Input(); HAL_GPIO_WritePin(DS1302_PORT, DS1302_CE_PIN, GPIO_PIN_RESET); HAL_GPIO_WritePin(DS1302_PORT, DS1302_SCLK_PIN, GPIO_PIN_RESET); }IO 引脚你也可以在外部加一颗 4.7kΩ 上拉到 3.3V这样读时序里 IO 在高阻窗口不会乱跳。如果用了外部上拉IO 输出可以考虑配置成开漏输出避免推挽输出和外部上拉打架。3.2 微秒延时函数的取舍DS1302 的时钟频率并不高GPIO 模拟时每跳变一次最好留一点延时让电平稳定。太短的延时可能偶尔读到抖动的电平太长的延时也不会损坏芯片只会让整个读写过程变慢。我建议在每半个时钟周期延时 1~2 微秒。最简单的方式是用一个空的 volatile 循环注意别被编译器优化掉。在 72MHz 主频下下面的代码大概会产生微秒级延时实际需要你用逻辑分析仪或者示波器标定一下static void DS1302_Delay(void) { volatile uint32_t loop 200; while (loop--); }如果你工程里已经有 DWT 或者定时器延时函数直接替换成精确延时更好。这个函数只在读写过程中被调用频率不高性能不是问题。3.3 字节读写底层函数字节读写是三线时序的核心。写字节时每次把当前最低位放到 IO然后给一个 SCLK 上升沿读字节时把 SCLK 拉高后读 IO再把 SCLK 拉低。static void DS1302_SCLK_H(void) { HAL_GPIO_WritePin(DS1302_PORT, DS1302_SCLK_PIN, GPIO_PIN_SET); } static void DS1302_SCLK_L(void) { HAL_GPIO_WritePin(DS1302_PORT, DS1302_SCLK_PIN, GPIO_PIN_RESET); } static void DS1302_CE_H(void) { HAL_GPIO_WritePin(DS1302_PORT, DS1302_CE_PIN, GPIO_PIN_SET); } static void DS1302_CE_L(void) { HAL_GPIO_WritePin(DS1302_PORT, DS1302_CE_PIN, GPIO_PIN_RESET); } static void DS1302_WriteByte(uint8_t dat) { DS1302_IO_Mode_Output(); for (uint8_t i 0; i 8; i) { HAL_GPIO_WritePin(DS1302_PORT, DS1302_IO_PIN, (dat 0x01) ? GPIO_PIN_SET : GPIO_PIN_RESET); DS1302_SCLK_H(); DS1302_Delay(); DS1302_SCLK_L(); DS1302_Delay(); dat 1; } } static uint8_t DS1302_ReadByte(void) { uint8_t dat 0; DS1302_IO_Mode_Input(); for (uint8_t i 0; i 8; i) { DS1302_SCLK_H(); DS1302_Delay(); if (HAL_GPIO_ReadPin(DS1302_PORT, DS1302_IO_PIN) GPIO_PIN_SET) { dat | (uint8_t)(0x01 i); } DS1302_SCLK_L(); DS1302_Delay(); } return dat; }读字节时有个容易犯的错IO 方向没切到输入导致读到的一直是当前输出状态。我见过有人调了半天读出来的秒永远是 0x00后来发现 IO 一直配置成推挽输出DS1302 的数据根本拉不动 STM32 的引脚。所以每次DS1302_ReadByte第一步就是把 IO 切到输入不能省。3.4 寄存器读写和 BCD 转换有了字节读写剩下的寄存器操作就顺理成章了。读寄存器的命令是addr | 0x01写寄存器的命令是addr然后 CE 拉低结束整个操作。uint8_t DS1302_ReadReg(uint8_t addr) { uint8_t dat; DS1302_CE_L(); DS1302_SCLK_L(); DS1302_CE_H(); DS1302_WriteByte(addr | 0x01); dat DS1302_ReadByte(); DS1302_CE_L(); return dat; } void DS1302_WriteReg(uint8_t addr, uint8_t dat) { DS1302_CE_L(); DS1302_SCLK_L(); DS1302_CE_H(); DS1302_WriteByte(addr); DS1302_WriteByte(dat); DS1302_CE_L(); }BCD 转换两个小函数也放在一起static uint8_t DS1302_BCD2Dec(uint8_t val) { return (val 4) * 10 (val 0x0F); } static uint8_t DS1302_Dec2BCD(uint8_t val) { return ((val / 10) 4) | (val % 10); }这里要特别提醒如果你直接把读到的寄存器值打印成十六进制看起来很像真实时间但这只是碰巧。比如秒寄存器读出来 0x59十六进制打印显示 0x59直觉上你会以为就是 59 秒但它本质是 BCD 码。如果你把它当成普通十六进制数再转十进制得到的是 89那就错了。所以所有时间寄存器都必须经过 BCD2Dec 转换后再给应用层使用。3.5 设置时间和读取时间时间结构体我定义成独立的结构体这样上层代码不用关心 DS1302 的寄存器细节后续换成其他 RTC 芯片也容易。typedef struct { uint8_t year; uint8_t month; uint8_t date; uint8_t day; uint8_t hour; uint8_t minute; uint8_t second; } DS1302_Time;设置时间前先关闭写保护写完所有时间寄存器后再开启写保护。秒寄存器最好最后写这样能保证前面几个寄存器都写好了再让 CH 位清零时钟立刻走起来。void DS1302_SetTime(const DS1302_Time *time) { DS1302_WriteReg(DS1302_WP_REG, 0x00); DS1302_WriteReg(DS1302_YEAR_REG, DS1302_Dec2BCD(time-year)); DS1302_WriteReg(DS1302_MONTH_REG, DS1302_Dec2BCD(time-month)); DS1302_WriteReg(DS1302_DATE_REG, DS1302_Dec2BCD(time-date)); DS1302_WriteReg(DS1302_DAY_REG, DS1302_Dec2BCD(time-day)); DS1302_WriteReg(DS1302_HOUR_REG, DS1302_Dec2BCD(time-hour)); DS1302_WriteReg(DS1302_MIN_REG, DS1302_Dec2BCD(time-minute)); DS1302_WriteReg(DS1302_SEC_REG, DS1302_Dec2BCD(time-second)); DS1302_WriteReg(DS1302_WP_REG, 0x80); }读取时间时要把每个寄存器的高位掩码处理掉避免读到 CH、12/24 小时模式位、世纪位等干扰信息。比如小时寄存器在 24 小时制下低 6 位才是有效数字所以 0x3F星期寄存器低 3 位有效所以 0x07月寄存器的 bit7 是世纪位所以 0x1F。如果不做掩码直接转 BCD就可能得到 132 这种离谱的月。void DS1302_GetTime(DS1302_Time *time) { uint8_t val; val DS1302_ReadReg(DS1302_YEAR_REG); time-year DS1302_BCD2Dec(val); val DS1302_ReadReg(DS1302_MONTH_REG) 0x1F; time-month DS1302_BCD2Dec(val); val DS1302_ReadReg(DS1302_DATE_REG) 0x3F; time-date DS1302_BCD2Dec(val); val DS1302_ReadReg(DS1302_DAY_REG) 0x07; time-day DS1302_BCD2Dec(val); val DS1302_ReadReg(DS1302_HOUR_REG) 0x3F; time-hour DS1302_BCD2Dec(val); val DS1302_ReadReg(DS1302_MIN_REG) 0x7F; time-minute DS1302_BCD2Dec(val); val DS1302_ReadReg(DS1302_SEC_REG) 0x7F; time-second DS1302_BCD2Dec(val); }主循环里使用很简单DS1302_Time t; DS1302_GetTime(t); printf(20%02d-%02d-%02d %02d:%02d:%02d\r\n, t.year, t.month, t.date, t.hour, t.minute, t.second);年份只存 00~99显示时手动加 2000 就是当前的“20xx”年。DS1302 的世纪位不完整不能指望它自动处理 2100 年工业项目里如果要跨世纪需要在应用层自己扩展世纪位。4. 调试记录哪些问题最值得提前规避4.1 时间不走或者秒位不跳动这是新手遇到最多的问题。DS1302 的时间不走首先查看秒寄存器的 bit7 CH 位。读秒寄存器后如果 0x80的结果是 1说明振荡器停机了。解决办法是把秒寄存器设置成小于 60 且 bit7 为 0 的值设置时间以后时钟才会走起来。其次是晶振问题。DS1302 需要外接 32.768kHz 晶振很多模块已经焊好了。如果模块是散件自己焊的晶振虚焊、引脚间有污渍都会导致不起振。用示波器探头点 X1 脚附近能看到 32.768kHz 波形但探头电容可能影响起振最好用 10x 探头。实在没有示波器就重点检查晶振两个脚到芯片引脚之间的焊点。还有供电问题。DS1302 有 VCC2 和 VCC1 两个电源脚VCC2 接主电源VCC1 接备用电池。如果 VCC2 没供电而 VCC1 有电芯片确实能走但时间基准可能不稳定。最省心的做法是 VCC2 接 3.3VVCC1 接一颗 3V 纽扣电池正极电池负极接地。4.2 读出来的数据全是 0xFF 或者 0x00这种情况基本是通信时序没有建立起来。0xFF 往往表示 IO 一直处于高电平最可能的原因是 IO 方向没有切到输入或者 CE 没有拉高就发了命令。0x00 则可能表示命令字节不对DS1302 根本没响应。我调试时习惯先把 CE、SCLK、IO 都接到逻辑分析仪上打一条读秒命令看波形是不是符合预期。正常的读秒操作应该先看到 CE 拉高然后 SCLK 上有 8 个时钟IO 上传出命令字节 0x81之后又是 8 个时钟IO 由 DS1302 驱动输出秒数。如果命令波形完全不对就检查命令字是不是写成了 0x01 而不是 0x81。4.3 时间数值“看着对”但其实错DS1302 的寄存器值必须经过 BCD 转换才能作为整数使用。很多人直接把读到的十六进制值当十进制用结果秒到 5 分 9 秒这种地方就会跳变。举个例子如果秒寄存器读到 0x45直接当十进制 45 用看起来没问题但内部其实表示 45 秒。那如果是 0x59直接当十六进制转十进制会变成 89立刻出错。所以统一走BCD2Dec是唯一稳妥的办法。掩码也不能省。小时寄存器如果 bit6 被设置成 12 小时模式低 6 位的含义就变了。我建议只使用 24 小时制设置时间时传入 0~23读取时 0x3F。星期和月、日的掩码也要分类处理不要一个函数读到底。4.4 写保护没关闭导致写入无效如果所有寄存器写操作都执行了但是读回来时间没有任何变化第一嫌疑就是写保护寄存器。DS1302 的默认上电状态不保证 WP 是 0所以每次SetTime第一步必须写 0x8E 为 0x00。即使你只需要改小时也不能绕过这一条。还有种情况是写保护被打开后读回时间却还能变化那是正常的因为写保护只影响写操作不影响内部走时。如果你以为写保护打开后时间会冻结那就理解错了。4.5 备用电池充电配置不要乱动很多 DS1302 模块预留了电池座或者法拉电容。芯片的充电寄存器 0x90 如果被设置成某个充电组合会对电池持续提供涓流充电。问题是有些电池根本不需要充或者充电电流过大长期使用会鼓包。我在自己的工程里不使用后备电池充电功能时一律写 0x00。如果你确定要用请先查清楚数据手册上 TCS、DS、RS 的配置含义再根据电池类型选电阻。4.6 逻辑分析仪和串口打印是最有效的调试工具GPIO 模拟时序不怕慢就怕不知道线上到底发生了什么。逻辑分析仪改造成本很低抓一次读秒的操作基本就能判断是命令字、IO 方向还是 CE 时序的问题。没有逻辑分析仪时用串口打印每次读到的原始寄存器值结合掩码和 BCD 转换也能快速定位。我个人会先把DS1302_ReadReg(0x81)的原始值打印出来。如果这个值是稳定的 0x00~0x59 范围说明通信大概率已经通了问题只可能出在 BCD 转换或者掩码上。如果值不稳定乱跳再回头查时序和引脚连接。5. 开源模块化与后续扩展5.1 驱动代码的模块化组织这套驱动我整理成 ds1302.h 和 ds1302.c 两个文件对外只暴露初始化、设置时间、读取时间这几个函数寄存器地址全部放在 .c 文件内部。上层 main.c 只跟DS1302_Time结构体打交道不需要理解寄存器细节。这样做的好处是代码干净也方便以后替换成其他时钟芯片。头文件内容如下#ifndef DS1302_H #define DS1302_H #include main.h typedef struct { uint8_t year; uint8_t month; uint8_t date; uint8_t day; uint8_t hour; uint8_t minute; uint8_t second; } DS1302_Time; void DS1302_Init(void); void DS1302_SetTime(const DS1302_Time *time); void DS1302_GetTime(DS1302_Time *time); uint8_t DS1302_ReadReg(uint8_t addr); void DS1302_WriteReg(uint8_t addr, uint8_t dat); #endif5.2 移植到其他 STM32 型号或其他 MCU移植这套代码的核心是替换三部分GPIO 初始化、GPIO 读写、延时函数。只要把宏定义里的端口和引脚改成你自己的再把 HAL_GPIO 相关调用换成对应平台的 API其余逻辑不需要动。这也是我当时不依赖硬件 SPI 的重要原因因为模拟时序基本是跨平台通吃的。如果换到 5V 的单片机比如传统 51供电和 IO 电平可能都是 5VDS1302 可以直接兼容。但 STM32 是 3.3V 系统不要为了“兼容 5V 模块”就把 VCC 接到 5V防止 IO 电平不匹配。3.3V 供电对 DS1302 来说完全够用。5.3 突发读写模式代码里用的是单寄存器读写一个寄存器单独操作一次。DS1302 还支持突发模式一次传完 8 个寄存器。读突发命令是 0xBF写突发命令是 0xBE。突发读的好处是可以连续读秒、分、时、日、月、星期、年避免单寄存器读时出现“秒刚读完分已经进位”的竞态问题。如果你对时间连续性要求高可以在DS1302_GetTime里改成先发 0xBF 读突发再连续读 7 到 8 个字节。代码逻辑就是把原来的addr | 0x01换成 0xBF然后循环调用DS1302_ReadByte()。单字节读写做学习够用项目里要求极致稳定时再上突发模式。5.4 这套代码可以怎么继续扩展DS1302 最大的特点是便宜、简单、非常适合做日志记录和时间戳。你可以把它接到 STM32 的低功耗采集系统里定时唤醒后读取时间写入传感器数据。也可以把它和 OLED、LCD 组合做一个桌面时钟。如果想再进一步可以把时间校准做成软件补偿每隔一段时间用高精度时钟源校准 DS1302记录秒误差偏移量走到一定偏差时微调秒寄存器或者定期重写时间。这种思路在 DS1302 这种低成本 RTC 上非常实用毕竟它的晶振精度有限长时间走下来肯定会有积累误差。提示DS1302 本身没有闹钟功能如果你需要定时唤醒或闹钟建议选择带闹钟寄存器的外部 RTC或者在主控内部定时器上做软件闹钟。不要被网上一些“DS1302 闹钟”的说法误导确认芯片型号和手册为准。这套驱动代码我在实际项目中反复用过读取非常稳定。如果你只是想在开发板上跑一个带时间显示的小项目把引脚宏改好初始化后先调用一次DS1302_SetTime写入当前时间然后循环读取基本就能工作了。最后再提醒一次遇到读出来不对的情况先打印原始寄存器值再做 BCD 转换和掩码分析这是排查问题最快的一条路。