企业官网建设流程全解析

DS1302 这颗芯片第一次拿在手里的时候,我甚至觉得它简单得有点无聊:三根线、一个晶振、一颗纽扣电池,能有什么花活。结果第一版驱动烧进去,串口打印出来的时间永远是 00:00:00,秒位像被钉死一样一动不动。折腾到后半夜才回过神:秒寄存器最高位那个 CH 位出厂是 1,时钟振荡器压根就没开,你在代码里不显式把它清掉,这颗芯片就是一块安静的石头。

这篇是把我用 STM32 驱动 DS1302 的代码整理成开源学习笔记时顺手记下的完整过程,主要写给两类人:一类是刚开始碰三线制 RTC、被时序图绕晕的新手,另一类是已经写出了驱动但读回的数据不对、正在到处翻帖子的人。内容从命令字节的位布局一路讲到涓流充电寄存器这个容易出事的坑,包含可以直接抄的驱动骨架、GPIO 开漏配置的取舍理由、逻辑分析仪上的四步排查顺序,以及走时精度这块最容易被忽略的晶振问题。代码基于 HAL 库加裸机位操作,换成寄存器版本只需要改引脚层那几行。

1. 三根线背后的 DS1302：先搞清楚它在跟谁打交道

1.1 一颗"走时 + 31 字节便签"的混合体

DS1302 本质上是个组合体:一路实时时钟,加上 31 字节的静态 RAM。时钟部分负责秒、分、时、日、月、星期、年这七个量,数据全部用 BCD 码存放;RAM 部分则是 31 个可以随便读写的字节,靠同一颗备份电池保持。通信走的是三线制,分别是 CE(有些资料写成 RST)、I/O 和 SCLK,没有片选地址,也没有应答机制,纯粹是靠时序硬怼。

它的供电有两个脚:VCC2 接主电源,VCC1 接备份电池。主电源在的时候用 VCC2,主电源掉下去自动切到 VCC1,切换是芯片内部自己完成的,不需要软件干预。工作电压范围是 2.0V 到 5.5V,晶振固定用 32.768kHz,这是所有 RTC 芯片的通用频率,因为 32768 是 2 的 15 次方,做 15 级二分频正好得到 1Hz。

那 31 字节 RAM 的价值在哪?很多人拿到手觉得没用,其实它解决了一个很实际的问题:设备上总有几个不常改但又不能丢的配置,比如设备编号、累计运行次数、上次的标定参数、开机次数。这些量如果用 STM32 内部 Flash 存,要处理擦写寿命和页对齐,麻烦;如果加一颗 EEPROM,又是一颗料、两条 I2C 线。DS1302 自带的 RAM 顺手就填上了这个位置,写法和时钟寄存器几乎一样,只是命令字不同。唯一要注意的是,电池一旦拿掉,RAM 里的东西和走时一起丢,这一点在设计时要想清楚。

1.2 STM32 自带 RTC 不香吗：三种方案摆在一起比

每次把这个项目发出去,评论区一定会有人问:STM32 自己就有 RTC,为什么要外挂一颗?这个问题值得认真回答,因为选型决定了后面所有的工作量。我把三种常见方案摆在一起对比过,结论很直观。

我用 DS1302 的项目基本有这么几个共同点:手上模块现成、对时间精度要求只到分钟级、需要一块独立的非易失小存储、或者主控后面可能换成别的型号。真正在乎一年累积误差的场景,我会直接上带温补的那一类,DS1302 没有温度补偿,夏天和冬天的日误差能差出好几倍,这是它的物理限制,靠软件补不回来。

至于 STM32 内部 RTC,省成本省板面是最大优势,如果你的产品对时间要求就是"大致准",内部 RTC 完全够用,没必要多焊一颗芯片。我选 DS1302 更多是工程习惯问题——把时间这一块做成独立的、可拆卸的模块,主控换代的时候这部分逻辑一行都不用动。

1.3 模块到手的硬件自检清单

软件调不通的时候,有一半的问题其实出在硬件上,所以我养成了一个习惯:拿到模块先做一轮万用表检查,再写代码。这个清单花不了五分钟,能省掉后面几个小时的怀疑人生。

• 量 VCC 和 GND,确认模块到底是 5V 供电还是 3.3V 供电,有些模块自带稳压或者电平转换,有些则是裸芯片直接引出来
• 检查 I/O 线上有没有上拉电阻,常见是 4.7k 到 10k。不少便宜的裸板是不带的,读数据的时候会一直读到 0
• 装电池之前先量电池电压,低于 2.0V 直接换新的,电压不够的时候时间保持会不可靠
• 检查晶振是不是 32.768kHz,焊点有没有虚焊。这个位置的虚焊比例高得离谱,尤其是手工焊的板子
• 用万用表通断档确认三根信号线到 MCU 引脚的对应关系,丝印上的 CLK/DAT/RST、SCLK/IO/CE 都是同一组东西,别被名字绕晕
• 自制板的话,确认 X1/X2 两根线尽量短,不要从开关电源或者电机驱动下面穿过

提示:模块丝印和代码里的宏定义一定要对得上,我见过不止一次把 IO 和 SCLK 接反的情况,现象是读回来全是 0xFF,而人却一直在怀疑软件时序。

2. 逐位抠时序：DS1302 通信层的实现细节

2.1 命令字节的位布局，错一位就全盘皆输

和 DS1302 的所有交互,都是从发一个字节的命令字开始的。这 8 个 bit 的分工非常固定:bit7 恒为 1;bit6 用来区分访问的是时钟寄存器还是 RAM,0 表示时钟,1 表示 RAM;bit5 到 bit1 是五位寄存器地址 A4 到 A0;bit0 是读写标志,1 表示读,0 表示写。

这个结构带来一个很有意思的结果:每个寄存器的写命令和读命令是成对的连续值。秒寄存器写是 0x80,读是 0x81;分寄存器写是 0x82,读是 0x83;一路排下去,小时是 0x84/0x85,日期是 0x86/0x87,月是 0x88/0x89,星期是 0x8A/0x8B,年是 0x8C/0x8D。写保护寄存器是 0x8E/0x8F,涓流充电寄存器是 0x90/0x91。突发模式下,时钟突发写是 0xBE、读是 0xBF,RAM 突发写是 0xFE、读是 0xFF,RAM 单字节从 0xC0 开始写、0xC1 开始读。

我建议直接在头文件里把这套命令字定义成宏,而不是在代码里到处写裸数字。原因很简单:调不通的时候你会反复回去查这个地址对不对,定义成宏之后一眼就能看出是哪个寄存器,省掉大量翻手册的时间。还有一个更容易出错的点——命令字和数据字节都是低位在前发送的。也就是说发送 0x80 的时候,线上依次出现的是 0、0、0、0、0、0、0、1,如果你在逻辑分析仪上看到的是反过来的顺序,那就是自己的代码把位序装反了。

2.2 上升沿写、下降沿读，代码必须贴着时序图写

DS1302 的位传输方向判据非常干脆:写数据的时候,芯片在 SCLK 的上升沿采样,所以 MCU 必须先摆好 I/O 电平,再把时钟拉高;读数据的时候,芯片在 SCLK 的下降沿把数据摆到 I/O 上,所以 MCU 要在时钟拉低之后再采样。这个"写看上升沿、读看下降沿"的区别如果记混了,现象通常就是写进去能生效、读出来全是乱码,或者干脆两边都不对。

除了边沿方向,还有几条硬性约束必须同时满足。CE 在整段 16 个时钟周期里必须始终保持高电平,传输开始前拉高、结束后拉低,中间不能抖动;SCLK 空闲时应该保持低电平,不能悬空;两次传输之间 CE 必须先拉低再拉高,靠这个电平变化来复位芯片的位计数器。这些细节在时序图上都画着,但很多人是照着别人的代码抄,抄的时候只抄了循环体,漏了 CE 的处理,结果就是第一次能读对、第二次开始全错。

下面是我实际在用的位操作骨架,两个函数加起来不到三十行:

/* ---------- 引脚操作宏,移植时只改这一段 ---------- */ #define DS_CE_H() HAL_GPIO_WritePin(DS_CE_PORT, DS_CE_PIN, GPIO_PIN_SET) #define DS_CE_L() HAL_GPIO_WritePin(DS_CE_PORT, DS_CE_PIN, GPIO_PIN_RESET) #define DS_SCLK_H() HAL_GPIO_WritePin(DS_SCLK_PORT, DS_SCLK_PIN, GPIO_PIN_SET) #define DS_SCLK_L() HAL_GPIO_WritePin(DS_SCLK_PORT, DS_SCLK_PIN, GPIO_PIN_RESET) #define DS_IO_H() HAL_GPIO_WritePin(DS_IO_PORT, DS_IO_PIN, GPIO_PIN_SET) #define DS_IO_L() HAL_GPIO_WritePin(DS_IO_PORT, DS_IO_PIN, GPIO_PIN_RESET) #define DS_IO_READ() HAL_GPIO_ReadPin (DS_IO_PORT, DS_IO_PIN) /* 写一个字节,低位在前,上升沿被 DS1302 采样 */ static void ds1302_write_byte(uint8_t dat) { for (uint8_t i = 0; i < 8; i++) { if (dat & 0x01) DS_IO_H(); else DS_IO_L(); delay_us(2); DS_SCLK_H(); /* 上升沿,DS1302 采样 */ delay_us(2); DS_SCLK_L(); delay_us(2); dat >>= 1; } } /* 读一个字节,低位在前,下降沿后采样 */ static uint8_t ds1302_read_byte(void) { uint8_t dat = 0; for (uint8_t i = 0; i < 8; i++) { DS_SCLK_L(); /* 下降沿,DS1302 输出数据 */ delay_us(2); if (DS_IO_READ()) dat |= (uint8_t)(1u << i); delay_us(2); DS_SCLK_H(); delay_us(2); } return dat; }

读函数这里我特意用(1u << i)按位序拼装,而不是用右移加置最高位的写法。两种写法在数学上是反的,后者拼出来的字节是位序颠倒的。如果你手上那份驱动读出来的数值明显不对,但写进去的时间看起来又没错,第一件事就是拿一个已知值验证位序:把秒寄存器写成 0x30,再读回来,如果读到 0x0C,那就是两端位序对不上,把拼装方式反过来就行了。

2.3 单字节模式与突发模式，什么时候用哪个

DS1302 提供两种读写方式。单字节模式一次只操作一个寄存器,发一个命令字加一个数据字节,十六个时钟搞定。突发模式则是一次发命令字,然后连续读写八个字节,时钟突发读的命令字是 0xBF,写是 0xBE,RAM 突发一次性可以搬运 31 个字节。

我的做法很明确:写时间用单字节,读时间用突发。写时间这件事一天也就发生几次,慢一点无所谓,单字节模式逻辑简单、出错好定位。读时间就不一样了,如果一字节一字节读,会发生一个很难复现但确实存在的问题——读到 23:59:59 的下一秒,秒寄存器进位成 00 而分寄存器还没来得及更新,你把这两个值拼起来就得到了 23:00:00 这种时间倒流的数据。突发读模式在设计上就是为了解决这个:命令字发出以后,芯片把所有时钟寄存器锁存到内部影子寄存器,后续八个字节读的都是同一时刻的快照,不会出现半新半旧的情况。

typedef struct { uint8_t year; /* 00 - 99 */ uint8_t month; /* 1 - 12 */ uint8_t date; /* 1 - 31 */ uint8_t week; /* 1 - 7 */ uint8_t hour; /* 0 - 23 */ uint8_t min; /* 0 - 59 */ uint8_t sec; /* 0 - 59 */ } ds1302_time_t; /* 突发读,一次拿到完整时间,避免跨零点读到不一致的数据 */ void ds1302_read_time(ds1302_time_t *t) { uint8_t buf[8]; DS_CE_H(); ds1302_write_byte(0xBF); for (uint8_t i = 0; i < 8; i++) { buf[i] = ds1302_read_byte(); } DS_CE_L(); t->sec = bcd2dec(buf[0] & 0x7F); /* 去掉 CH 位 */ t->min = bcd2dec(buf[1] & 0x7F); t->hour = bcd2dec(buf[2] & 0x3F); /* 24 小时制 */ t->date = bcd2dec(buf[3] & 0x3F); t->month = bcd2dec(buf[4] & 0x1F); t->week = bcd2dec(buf[5] & 0x07); t->year = bcd2dec(buf[6]); }

突发写这一侧我踩过一次坑,值得单独说一下:时钟突发写要连续写八个字节,前七个正好对应秒到年,第八个字节按照一些资料的说法会落到写保护寄存器上,但不同版本的说明写得不完全一致。我的处理方式是干脆不用突发写,老老实实一个一个寄存器写,反正设置时间这个操作本身很少发生,没必要为了省几十微秒去冒一个不确定性。真要用突发写的话,第八个字节固定送 0x00,并且在写之前手动解除保护、写完之后重新加上,这样无论它落到哪里都不会出问题。

2.4 微秒延时怎么做才不掉链子

DS1302 的时序要求其实很宽松,手册里的建立和保持时间都是几百纳秒级别,所以只要保证微秒级的延时不出错,通信基本就稳了。问题在于怎么做出一个可靠的微秒延时。常见的有四种做法,我都试过,给你一张对比表。

DWT 是内核里自带的一个调试周期计数器,只要把跟踪使能位打开就能当高精度计时器用,成本接近于零:

static void dwt_delay_init(void) { CoreDebug->DEMCR |= CoreDebug_DEMCR_TRCENA_Msk; DWT->CYCCNT = 0; DWT->CTRL |= DWT_CTRL_CYCCNTENA_Msk; } static inline void delay_us(uint32_t us) { uint32_t start = DWT->CYCCNT; uint32_t ticks = us * (SystemCoreClock / 1000000U); while ((DWT->CYCCNT - start) < ticks) { __NOP(); } }

用的时候有个边界要注意:CYCCNT 是 32 位,在 72MHz 下大约 59 秒就会回绕一圈。做 DS1302 的位延时每次只有几微秒,完全不用担心,但别拿它去做几百毫秒的延时,回绕之后循环条件会失效。另外实际调试的时候,我建议先把延时开到 5 微秒甚至 10 微秒,把通信跑通,确认数据正确之后再往 1 到 2 微秒压。这样做的好处是能干净地分离问题:延时给得足够大还读不对,那就不是时序问题,而是位序、地址或者硬件问题,排查范围一下子缩小一半。

3. GPIO 配置：为什么我坚持把 IO 脚做成开漏

3.1 推挽输出的隐患

我见过的最多的硬件配置错误,就是把 I/O 脚按默认的推挽输出配下去了。CubeMX 新建工程以后输出脚的默认模式就是推挽,顺手点下去,代码也能跑,时间也能读写——直到某一次读数据的时候读到错值,或者更糟,芯片的 I/O 脚开始发烫。

问题的根源在于 DS1302 的 I/O 是一根双向线,一个时刻只能有一方在驱动。如果 STM32 这边配成推挽输出并且输出高电平,而 DS1302 那边正在把这根线拉低来输出一个 0,两边就形成了直接的短路通路。这个电流路径很短但电流不小,短时间的表现是读回来的数据出错,长时间的后果就是某一侧的引脚被慢慢打坏。

有些人会说,我用 HAL 库读引脚的时候读的是输入数据寄存器,不就行了吗?读 IDR 确实能看到引脚实际电平,但推挽输出并不会因为你读了一下就释放线路,MCU 的输出级仍然牢牢地驱动着这根线,冲突依旧存在。想用推挽就必须在每次读之前把引脚切成输入模式、读完再切回输出,这一来一回不仅慢,而且在切换的瞬间电平是不确定的,很容易被 DS1302 当成一个时钟沿或者数据位。

3.2 开漏加外部上拉：省掉模式切换的做法

正确的配置是把 I/O 脚设成开漏输出,并且确保这根线上有上拉电阻。开漏输出的电气行为是:写 0 时主动拉低,写 1 时输出级完全断开、引脚进入高阻态,靠上拉电阻把电平抬到高。这样一来,MCU 想读数据的时候只要写个 1 把线让出来就行,DS1302 想拉低就拉低、想抬高就抬高,两边永远不会同时驱动。

这个方案还有一个额外好处:整个驱动代码里不需要任何一次 GPIO 模式切换。读字节的时候不用先把引脚改成输入、读完再改回输出,直接读 IDR 就行,代码干净,速度也快。我最早那版驱动里是带模式切换的,后来发现光是把这几行去掉,位操作的耗时就能降下来一截,而且再也没有出现过切换瞬间误采样的偶发问题。

上拉电阻怎么选,我给几条我自己的经验值。STM32 内部的上拉大约在 30 到 50 千欧这个量级,在杜邦线短距离、速率低于 100kHz 的情况下完全够用,把 CubeMX 里的 Pull-up 勾上就能省一颗电阻。但我自己的板子上一律是外部补 10 千欧,原因有两个:一是模块和主控之间如果走的是排线,内部那个几十千欧的弱上拉配上线上几十皮法的分布电容,边沿会变缓,快速读的时候容易踩到不确定区;二是外部上拉是显式的,别人看原理图的时候不会怀疑。

CE 和 SCLK 这两根线是单向的,从 MCU 出来到 DS1302,理论上推挽输出也没问题,推挽的边沿还更陡。我一般还是会顺手给 SCLK 加一个上拉,主要是为了上电瞬间这根线有个确定的高电平,不至于浮空被当成一个时钟脉冲。CE 线上加不加都行,加了不亏,一颗电阻几分钱。

3.3 供电电平的选择与 5V 模块的兼容

DS1302 的供电范围是 2.0V 到 5.5V,这给了很大的自由度,但也带来一个容易忽略的兼容问题。如果模块按 5V 供电,那么它的 I/O 输出高电平就会接近 5V,这时候要看 STM32 对应引脚的容忍度。STM32 的数据手册里引脚分成两类,标注为 5V 容忍(通常写作 FT)的引脚,输入可以承受 5V;没有标注的引脚,绝对最大输入电压只有 VDD 加 0.3V,3.3V 系统下也就是 3.6V 左右,硬接 5V 就是超规格使用,短时间可能看不出问题,长期可靠性没有任何保证。

我的做法是尽量统一用 3.3V 给 DS1302 供电。3.3V 下 I/O 高电平就是 3.3V,和 STM32 完全对得上,不需要任何电平转换,这是最省心的组合。另外供电电压确实会影响最高时钟频率:手册里给的 SCLK 上限,在 5V 附近是 2MHz 这一档,电压掉到 2V 左右会降到几百 kHz。我们用的是软件位操作,实际速率也就几百 kHz,离这个上限很远,所以这条基本不会成为瓶颈,但如果你打算改成硬件 SPI 去跑,这个降频关系就必须先算清楚。

VCC1 和 VCC2 的接法也顺带提一句:VCC2 接主电源,VCC1 接电池正极。大部分现成模块已经把电池座焊到 VCC1 上了,你只需要接一个主电源和一个地。自制板的时候注意一个问题,有些设计会让主电源电压低于电池电压,这种情况下芯片会一直用电池,主电源等于白接,所以主电源的电压一定要高于电池电压。

4. 寄存器地图与 BCD 转换：时间数据的读写姿势

4.1 秒到年，七个寄存器的位含义全表

DS1302 的时间寄存器用的是 BCD 编码,也就是说一个字节里,高四位是一个十进制位、低四位是另一个十进制位。比如 0x23 表示的不是十进制的 35,而是"23"。这个编码方式在数码管显示的场景下很方便,但在计算的时候必须先转成普通数值再转回来,否则会算出一堆莫名其妙的数。

下面这张表是我从手册里整理出来的完整位定义,建议直接贴到代码注释里,调的时候看一眼就清楚了。

几个细节要单独说清楚。小时寄存器的 bit7 是十二/二十四小时制的选择位,写 0 表示二十四小时制,这时候 bit6 和 bit5 拼起来就是小时的十位,取值 0 到 2,低四位是小时的个位,所以按 0x3F 做掩码正好。星期寄存器的取值是 1 到 7,具体哪天算第一天完全由你自己定,芯片不做任何判断,我一般按周一等于 1 来用。年份寄存器只有两个 BCD 位,也就是说只能表示 00 到 99,没有世纪位,跨越 2000 年这种问题必须在应用层解决,我的做法是固定一个基准年 2000,读回来的两位数字加上去就是完整年份。

BCD 和普通数值之间的转换就是两行代码,但一定要用查表或者移位加取模的写法,不要图快用什么数学技巧:

static inline uint8_t bcd2dec(uint8_t bcd) { return (uint8_t)(((bcd >> 4) & 0x0F) * 10 + (bcd & 0x0F)); } static inline uint8_t dec2bcd(uint8_t dec) { return (uint8_t)(((dec / 10) << 4) | (dec % 10)); }

4.2 CH 位：新板子不走时的头号嫌疑人

秒寄存器最高位那个 CH 位,是我在这个项目上交的第一笔学费。CH 是 Clock Halt 的缩写,写 1 的时候振荡器停振,寄存器里的数据还能照常读写,但时间永远停在原地不动。新芯片出厂时这个位是 1,备份电池完全没电重新上电的时候,读回来的值也可能是随机的,CH 位大概率还是 1。

为什么这个东西这么容易踩?因为它藏在一个看起来完全正常的写法里。很多人写初始化的时候是这么干的:先把秒寄存器的值读出来,把秒数改掉,再写回去,想着"保留原来的高位比较保险"。如果原来读回来的 CH 位是 1,你这么一写就把 1 原封不动写回去了,时钟永远启动不了,而代码看起来逻辑完美。正确的做法是写秒寄存器的时候显式清掉最高位:

ds1302_write_reg(0x80, (uint8_t)(dec2bcd(sec) & 0x7F)); /* CH = 0,启动振荡器 */

还有一种更隐蔽的情况:初始化里先用某个条件判断要不要设置时间,结果判断逻辑走偏了,写时间的代码根本没执行,CH 位自然没人清。所以排查"时间不走"这个问题的时候,顺序应该是先读一次秒寄存器,看 bit7 是不是 1,是的话直接排查初始化路径,不用往别的地方想。

4.3 写保护 0x8E 的开锁与上锁顺序

写保护寄存器只有最高位有用,写 1 表示保护,这时候除了这个寄存器本身,其他所有寄存器的写操作都会被忽略;写 0 表示解除保护,可以正常写。这个位的存在是为了防误写,尤其在有干扰或者程序跑飞的时候,能挡住一部分意外改写。

操作顺序必须是"解锁、写数据、上锁"这三步,中间不能被打断。而且整个序列要在同一次 CE 拉高期间完成吗?这里要注意,解除保护是一个独立的写操作,它和其他写操作一样需要完整的 CE 拉高、十六个时钟、CE 拉低的过程,不能把解锁和数据写塞进同一个 CE 高电平区间里。

void ds1302_set_time(const ds1302_time_t *t) { ds1302_write_reg(0x8E, 0x00); /* 解锁 */ ds1302_write_reg(0x80, dec2bcd(t->sec) & 0x7F); /* 秒,顺带清 CH */ ds1302_write_reg(0x82, dec2bcd(t->min)); ds1302_write_reg(0x84, dec2bcd(t->hour)); ds1302_write_reg(0x86, dec2bcd(t->date)); ds1302_write_reg(0x88, dec2bcd(t->month)); ds1302_write_reg(0x8A, dec2bcd(t->week)); ds1302_write_reg(0x8C, dec2bcd(t->year)); ds1302_write_reg(0x8E, 0x80); /* 上锁 */ }

写完立刻上锁,这个习惯成本为零,但能挡掉一些你事后根本查不出来的偶发问题。我经历过一次很典型的:设备在电机启动的瞬间时间会被改掉,后来加了上锁、并且在应用层每隔一段时间校验一次时间合理性,问题就消失了。虽然根因是电源和布线,但软件侧的防护确实起了作用。

4.4 跨零点读时间，别用逐字节拼装

前面讲突发读的时候提过这个问题的原理,这里再展开说一下现象。假设你在 23:59:59 这一瞬间逐字节读时间,先读秒读到 59,下一秒的准备时间里芯片进位了,再读分读到的却是 00,拼出来就是 23:00:59。这个错误本身不致命,下一次读就恢复正常了,但如果你的应用里有"按分钟触发某个动作"的逻辑,这一条脏数据就可能触发一次误动作。

这个坑我是在客户投诉"设备偶尔会在错误的时间点动作"之后才真正重视起来的。当时第一反应是怀疑触发逻辑写错了,查了很久没结果,后来在读写时间的函数里加了一条日志,把每次读到的原始字节打出来,才看到那条时间倒流的记录。改成突发读之后,这个问题再也没出现过。

突发读的原理是芯片在收到突发读命令字之后,会把所有时钟寄存器锁存一份到影子寄存器里,后续这八个字节都从影子寄存器取。所以只要命令字发对了,读出来的必然是一个完整时刻的快照。记住这个结论就够了:读时间一律用突发读,不要为了省事逐字节拼。

4.5 用 RAM 里的"魔法数"判断时间是否需要初始化

有一个很实际的问题:设备上电以后,你怎么知道 DS1302 里保存的时间还有效?如果纽扣电池刚换过、或者设备在仓库里躺了两年,时间大概率是乱的。这时候如果直接拿去用,日志里的时间会变成某个荒唐的年份。

我的做法是在 RAM 的第一个字节里放一个约定值,上电初始化的时候先读一下,对不上就说明这是第一次上电或者电池换过,需要重新设置时间:

#define DS_RAM_MAGIC_ADDR 0u #define DS_RAM_MAGIC_VALUE 0xA5u void ds1302_init(void) { dwt_delay_init(); if (ds1302_ram_read(DS_RAM_MAGIC_ADDR) != DS_RAM_MAGIC_VALUE) { ds1302_time_t def = { .year = 25, .month = 1, .date = 1, .week = 3, .hour = 0, .min = 0, .sec = 0 }; ds1302_set_time(&def); ds1302_ram_write(DS_RAM_MAGIC_ADDR, DS_RAM_MAGIC_VALUE); } }

这个逻辑之所以成立,是因为 RAM 和走时用的是同一颗备份电池:电池在,RAM 数据在、时间也准;电池没,RAM 丢了、时间也不可信。两者天然同步,不需要额外的检测手段。RAM 的其他三十个字节可以拿来存设备编号、开机次数之类的东西,写入方式和时钟寄存器一样,只是命令字从 0xC0 开始递增,读的时候用 0xC1 开始递增。要注意 RAM 的写操作同样受写保护寄存器约束,写之前记得解锁。

5. 涓流充电寄存器 0x90：写错一个字节的代价

5.1 位定义与可选档位

涓流充电寄存器是 DS1302 里最容易被随手乱写的一个。它的八个位分成三组:高四位是 TCS,必须写入固定的 1010 才会启用充电功能,写其他任何值都是关闭;中间两位是 DS,选择串联几个二极管;低两位是 RS,选择串联哪个阻值的限流电阻。

充电电流的估算很简单,就是把主电源电压减去二极管压降再减去电池当前电压,除以串联电阻。单只二极管的正向压降大约 0.7V 这个量级,所以 3.3V 供电、电池 3.0V 的情况下,0xA6 这一档的电流只有零点零几毫安,属于典型的涓流维护级别。这也说明了为什么充电功能更适合"长期维持电量"而不是"给一颗空电池充满"——它的电流本来就小得可怜。

5.2 5V 供电下必须避开两二极管档位

两二极管配置在高主电源电压下是个危险组合,手册里对此有过明确提示。道理其实不难理解:二极管串联越多压降越大,看起来似乎更安全,但当主电源是 5V 的时候,减去两倍压降之后剩下的电压仍然明显高于电池电压,流过限流电阻的电流会大幅上升。这个电流会全部灌进小小的纽扣电池里,超出它的耐受范围。

后果分两层。轻的一层是电池本身:不可充电的锂锰电池被持续灌电流会发热、内阻升高、寿命骤减,严重的时候会鼓包甚至漏液。重的一层是芯片和板子:漏出来的电解液会腐蚀走线和焊盘,这种损伤往往是不可逆的,只能换板。我修过一块被漏液腐蚀过的板子,清理完之后虽然能工作,但那片区域的阻焊层已经没了,可靠性上心里始终没底。

所以我的建议很直接:除非你的产品明确使用可充电的纽扣电池,并且供电电压确认在 3.3V 附近,否则 0x90 这个寄存器一律写 0x00。要开的话也只用单二极管档位,不要碰两二极管那三档。

5.3 用不可充电电池时应该关掉它

这是我在这个项目里最想强调的一条经验。市面上一大把 DS1302 模块出厂就焊着标准的 CR2032,而这种电池是一次电池,不可充电。很多教程和示例代码里,初始化的时候顺手写了一个 0xA5 进去,理由是"手册里说这样能充电",然后这个板子就这么跑了几年。

实际结果是,那颗不可充电的电池一直在被涓流充电,几年下来轻则容量衰减得比正常快,重则开始漏液。等到设备出问题拆开看,电池座上已经一片狼藉。这个坑的隐蔽性在于:它不会立刻出问题,而是在一两年后以"设备时间经常丢"的形式暴露出来,那时候很少有人会联想到初始化里那一行充电寄存器的配置。

正确的判断逻辑是这样的:先确认电池型号。CR2032 这类常见的一次锂锰电池,涓流充电寄存器写 0x00;LIR2032 这类标称可充电的型号,或者用超级电容做备份的,才按前面的表格选一档开启充电。实在不确定型号的,一律写 0x00。时间保持靠的是一颗满电的 CR2032 自放电,一颗好电池撑三到五年完全没问题,根本不需要充电。

注意:0x90 的写入和普通寄存器一样受写保护寄存器约束,而且它和其他寄存器不同,写错了不会立刻报错,只会在很长时间以后以电池损坏的形式体现出来。这一类"慢性的坑"最值得在代码审查的时候专门看一眼。

6. 上板联调：从波形到 24 小时漂移

6.1 逻辑分析仪的四步排查法

软件写完以后能不能跑通,靠猜是没用的,老老实实抓波形最快。一个几十块钱的八通道逻辑分析仪就够了,把 CE、SCLK、IO 三根线接上去,采样率设到 1MHz 以上,很多软件还自带三线或者 SPI 解码器,能直接把字节解出来。

我的排查顺序是固定的四步,按这个顺序走基本能覆盖八成以上的问题:

第一步看 CE。确认每次操作开始前 CE 拉高,操作结束后拉低,高电平期间不能有毛刺。如果 CE 一直是低,那后面所有分析都是浪费时间,通信根本不会发生。

第二步数时钟。单字节读写一定是十六个时钟脉冲,不多不少。多出一个就会把下一次操作的第一个位提前吃掉,读回来的数据会整体错位一位,这种错误在数值上看起来往往只差一点点,特别容易被误判成"偶尔出错"。

第三步看命令字。以读秒为例,线上依次应该出现 1、0、0、0、0、0、0、1,也就是 0x81 低位在前。如果解码器解出来是 0x81 但你自己数波形发现第一个是 1 最后一个是 1 中间全 0,那是正常的;如果你发现顺序完全反了,那就是自己代码里的位序问题。

第四步看 IO 的响应。命令字发完之后,如果 DS1302 正常工作,读操作时它会在下降沿之后把 IO 拉出高低电平。如果 IO 全程都被上拉电阻顶在高电平,说明芯片根本没有应答,这时候去查供电、晶振和 CE;如果 IO 一直是低,那要怀疑线接错或者驱动冲突。

我把常见现象和对应的原因整理成了这张表,调不通的时候对着看能省不少时间。

6.2 走时不准，先怀疑晶振和负载电容

时间能读能写了,下一个问题是准不准。DS1302 这个级别的 RTC 没有温度补偿,理想条件下一天误差在一两秒以内属于正常范围,如果一天差十秒以上,那就不是芯片的问题,而是外围电路的问题。

第一个要查的是晶振的负载电容规格。DS1302 是按 6pF 负载电容的晶振设计的,典型应用电路里 X1 和 X2 之间直接接晶振,不加任何外部电容。很多板子上贴的是 12.5pF 的通用晶振,或者干脆额外焊了两个 12pF 的电容上去,这些都会让走时明显偏慢。我遇到过一块板子每天慢二十多秒,把外部电容拆掉换成 6pF 晶振之后,误差直接回到两秒以内。

第二个要查的是布局。DS1302 的振荡器驱动能力很弱,这是低功耗设计的必然结果,代价就是抗干扰能力差。X1 和 X2 两根线如果旁边走着开关电源的反馈线或者电机的驱动线,走时会被噪声推来推去,表现为误差不固定、每天都不同。处理办法是把这两根线尽可能缩短,X1 和 X2 正下方尽量铺地,远离任何高 di/dt 的走线。

第三个因素没法完全解决,那就是温度。晶振的频率会随温度漂移,冬天和夏天的日误差不一样是正常现象,想彻底解决只能换带温度补偿的型号。如果你的产品要求全年误差在几十秒以内,DS1302 在原理上就做不到,这一点在选型阶段就要想清楚,不要等到量产了才发现。

6.3 别用示波器探头去点晶振引脚

这个坑单独拿出来说,因为它浪费了我整整两个小时。当时现象是秒位不走,我怀疑晶振没起振,就拿示波器探头去搭 X1 脚,想看看 32.768kHz 的波形。探头一搭上去,读数跳动,波形时有时无,我判断是晶振坏了,换了新的还是这样,又怀疑是芯片坏了,换了芯片还是这样。最后把探头拿开重新上电,秒位正常地跳了起来。

原因很简单:探头本身有十几皮法的输入电容,而 DS1302 的振荡回路就靠那几皮法的负载电容在维持,探头一接上去,相当于给振荡回路并联了一个远超设计值的大电容,振荡条件直接被破坏。所以你看到的"不起振"是你自己造成的,跟电路无关。判断晶振有没有在工作,正确的方法是读秒寄存器看值有没有在变,或者干脆在 I/O 上抓通信波形,永远不要直接去碰 X1 和 X2。这条经验也适用于几乎所有低功耗 RTC 芯片。

7. 驱动分层与开源仓库的整理方式

7.1 三层结构：为什么要把引脚和协议彻底分开

这个驱动我从第一版到现在重构过两次,每次都是为了把层次分得更干净。现在的结构是三层,每一层的职责非常明确。

最底下的引脚层,只负责操作 CE、SCLK、IO 这三个电平,全部用宏定义实现,集中放在头文件最上面的十几行里。这一层不含任何逻辑,只做电平翻译。中间是协议层,包含读写字节、读写寄存器、突发读这几个函数,这一层完全不认识 GPIO,只调用引脚层的宏。最上面是应用层,负责时间结构体、BCD 转换、设置时间、读取时间、RAM 读写、上电初始化判断。

这样分的好处有两个。一个是可移植性:换 MCU 的时候只改引脚层的宏定义,或者换成寄存器版本直接操作 BSRR 和 IDR,协议层和应用层一行都不用动,我把它从 STM32F1 挪到 F4 上,前后花了不到十分钟。另一个是可测试性:协议层的函数是纯逻辑,可以在 PC 上写个假的引脚层去跑单元测试,验证 BCD 转换和位序拼装这类容易出错的逻辑,而不需要每次都上板。

还有一点值得说:把"是不是要用开漏"这类硬件相关的假设也写在引脚层里,用注释说明清楚。别人拿到你的代码,看到引脚层里明确写了"IO 必须是开漏输出并外部上拉",就不会随手改成推挽然后踩坑。

7.2 开源仓库里应该放哪些东西

既然是把这套东西当开源学习笔记发出去,整理得好不好直接决定了别人能不能用起来。我见过太多的开源驱动仓库,就一个孤零零的 c 文件,没有接线说明、没有示例、没有依赖说明,拿下来第一步就卡住。

我觉得至少要包含这几样东西。一份 README,里面第一件事就是接线表,把模块丝印、STM32 引脚、方向、备注列清楚,让人照着插线就能跑。然后是供电说明,写明白是 3.3V 还是 5V,电池是哪种型号,涓流充电寄存器设置的哪个值、为什么这么设。接着是依赖说明,比如依赖 HAL 库的哪个版本、用了哪个引脚宏、DWT 需要什么条件。

代码部分最好是能直接跑起来的最小示例:上电初始化、判断是否需要设置时间、每秒通过串口打印一次当前时间。这个示例虽然简单,但它把整个链路都串起来了,别人拿过去烧进去就能验证硬件接线对不对,遇到问题也好反馈。另外建议在仓库里放一份变更记录,哪怕只有几行,比如"v1.1 修复了突发读的位序问题""v1.2 增加了 RAM 魔法数判断",这些记录对后来者来说是非常有价值的线索。

至于不该提交的东西,主要是编译产物和完整的芯片库。把整个 HAL 库几百个文件全传上去,仓库体积会暴涨到几十兆,别人克隆下来要等半天,而且真正的驱动代码只有两个文件,全被淹没了。我的做法是只提交驱动本身加一个精简的示例工程,依赖的库在 README 里写明获取方式。

7.3 移植到别的平台要改哪几个地方

最后说移植。这套代码往别的 MCU 上搬,需要改的地方是有限的,列出来其实只有四处。

第一处是引脚宏定义,包括三个引脚的端口和引脚号,以及电平操作宏的实现。第二处是 GPIO 的初始化配置,在 STM32 上是调用 HAL_GPIO_Init 传入开漏加上的参数,换到寄存器风格的话就是直接改 MODER 和 OTYPER 这两个寄存器,换到别的厂商的芯片上就是对应的输出模式配置,核心要求只有一个:开漏加外部上拉。第三处是微秒延时,没有 DWT 的芯片可以用一个空闲定时器做基准,或者用经过验证的循环延时。第四处是引脚读写的效率,如果你对速度有要求,可以把 HAL 的函数替换成直接操作寄存器,一次调用从几百纳秒降到几十纳秒,整个读写时间能缩短一半以上。

剩下的部分,包括命令字的定义、BCD 转换、突发读的实现、时间结构体和 RAM 读写,全是标准 C,一个字都不用改。这也是我一开始坚持分层的意义所在——真正跟硬件绑定的代码被压缩到几十行以内,其余部分可以跨平台复用。

我个人在这个小项目上最大的体会是:DS1302 的难点从来不在它的协议有多复杂,它的时序简单到用示波器看几眼就能明白。真正的难点在于那些不会立刻报错的地方——CH 位没清导致时钟不走、充电寄存器写错导致两年后电池漏液、位序装反导致数据看起来"差不多对"。这些东西没有一条能在调试器里给你弹个提示,只能靠一个个踩过去、然后写进笔记里。所以我把每一处都记了下来,包括那几个我到现在还会在代码审查时专门看一眼的寄存器。