做过的 Arduino 项目多了,总会碰到同一个坎:设备一断电,时间就归零。millis() 计时再准,也只是"开机之后跑了多久",不认年月日。想要数据记录带时间戳、定时任务按真实时刻触发,就得给板子配一颗掉电也不停走的实时时钟。这次把最常见的 DS1302 模块从接线、装库、烧代码到备份电池验证完整过一遍,代码直接用 Rtc by Makuna 库自带的官方示例,一个字符没改。
DS1302 是颗什么芯片
DS1302 是 Maxim(现属 Analog Devices)出的低成本实时时钟芯片,能给出秒、分、时、日、月、星期、年,月份天数和闰年自动处理,一直算到 2100 年。计时基准来自外挂的 32.768kHz 晶振,就是模块板上那颗银色圆柱小元件。
它和 Arduino 之间走的不是 I2C,而是三线串行接口:RST(也叫 CE,片选使能)、DAT(数据输入输出)、CLK(串行时钟),加上 VCC 和 GND 一共五根线。这颗芯片还有个特点:内部带涓流充电器和一路备用电源输入,芯片上有 VCC1、VCC2 两个供电脚,主电在 VCC2,备份电池接 VCC1,主电掉的时候自动切电池。所以模块背面都留着一个 CR2032 纽扣电池座,换一次电池能撑好几年,备电模式下整机功耗不到 1 微安。
顺带说一句它和 DS3231 的关系:DS3231 精度更高(带温补晶振),但 DS1302 胜在便宜、模块到处都有,对走时精度要求不苛刻的记录仪、定时器项目完全够用。两颗芯片接口不同,库也不通用,别拿错。
接线:五根线的事
以 Arduino UNO 为例,模块五个脚对应接:
- VCC → 5V
- GND → GND
- CLK → D5
- DAT → D4
- RST → D2

接线没什么花样,杜邦线直连即可。唯一要留意的是 RST 是高电平有效,平时由库自己拉高拉低控制读写,不用手动干预。另外第一次拿到模块,先看一眼背面电池座里的 CR2032 是不是垫了绝缘片,很多厂商出厂为防运输放电会垫一片,不抽掉备电就是摆设。
装 Rtc by Makuna 库
IDE 里点"工具 → 管理库",搜索框敲 ds1302,会列出好几个候选。推荐装 Michael C. Miller 的 Rtc by Makuna(截图里版本 2.3.7),这一个库同时支持 DS1302、DS1307、DS3231、DS3234,接口风格统一,以后换时钟芯片代码几乎不用重写。

烧录示例代码
装好库之后,文件 → 示例 → Rtc by Makuna 里就有 DS1302_Simple,直接打开烧录。完整代码如下,与库仓库里的官方示例一致:
// CONNECTIONS:
// DS1302 CLK/SCLK --> 5
// DS1302 DAT/IO --> 4
// DS1302 RST/CE --> 2
// DS1302 VCC --> 3.3v - 5v
// DS1302 GND --> GND
#include "RtcDS1302.h"
ThreeWire myWire(4,5,2); // IO, SCLK, CE
RtcDS1302< ThreeWire > Rtc(myWire);
void setup ()
{
Serial.begin(57600);
Serial.print("compiled: ");
Serial.print(__DATE__);
Serial.println(__TIME__);
Rtc.Begin();
RtcDateTime compiled = RtcDateTime(__DATE__, __TIME__);
printDateTime(compiled);
Serial.println();
if (!Rtc.IsDateTimeValid())
{
// Common Causes:
// 1) first time you ran and the device wasn't running yet
// 2) the battery on the device is low or even missing
Serial.println("RTC lost confidence in the DateTime!");
Rtc.SetDateTime(compiled);
}
if (Rtc.GetIsWriteProtected())
{
Serial.println("RTC was write protected, enabling writing now");
Rtc.SetIsWriteProtected(false);
}
if (!Rtc.GetIsRunning())
{
Serial.println("RTC was not actively running, starting now");
Rtc.SetIsRunning(true);
}
RtcDateTime now = Rtc.GetDateTime();
if (now < compiled)
{
Serial.println("RTC is older than compile time! (Updating DateTime)");
Rtc.SetDateTime(compiled);
}
else if (now > compiled)
{
Serial.println("RTC is newer than compile time. (this is expected)");
}
else if (now == compiled)
{
Serial.println("RTC is the same as compile time! (not expected but all is fine)");
}
}
void loop ()
{
RtcDateTime now = Rtc.GetDateTime();
printDateTime(now);
Serial.println();
if (!now.IsValid())
{
// Common Causes:
// 1) the battery on the device is low or even missing and the power line was disconnected
Serial.println("RTC lost confidence in the DateTime!");
}
delay(10000); // ten seconds
}
#define countof(a) (sizeof(a) / sizeof(a[0]))
void printDateTime(const RtcDateTime& dt)
{
char datestring[26];
snprintf_P(datestring,
countof(datestring),
PSTR("%02u/%02u/%04u %02u:%02u:%02u"),
dt.Month(),
dt.Day(),
dt.Year(),
dt.Hour(),
dt.Minute(),
dt.Second() );
Serial.print(datestring);
}两处写法说明一下,避免被编辑器转码坑到:头文件一行照库示例本写作尖括号 include,本站编辑器会把尖括号当 HTML 标签吞掉,这里改成了等价的引号写法 #include "RtcDS1302.h",Arduino 工具链下两种写法搜索路径等价;声明 RTC 对象那一行同理,尖括号模板参数两侧加了空格,编译结果不变,自己敲代码时按常规尖括号写即可。ThreeWire(4,5,2) 三个参数的顺序是 IO、SCLK、CE,对应 D4、D5、D2,和上面接线一一对应,别调换。
烧录完打开串口监视器,波特率对准 57600。setup 里那段逻辑值得读一遍:库把电脑编译那一刻的时间当参照,RTC 里的时间比它新就说明芯片一直在走(这是正常情况);比它旧说明芯片没走过或没电,自动把编译时间写进去;写保护没解开会自动解除;芯片没在跑会自动启动。也就是说第一次上电什么都不用配,时间自己就校进去了。
串口输出长什么样
正常运行的输出是每 10 秒一行日期时间,类似下面这样:

截图是 9600 波特率下抓的(把示例里 Serial.begin 改成 9600、delay 改成 5000 的常见玩法),效果一样,关键只有一条:监视器波特率必须和 Serial.begin 对上,否则满屏乱码还以为模块坏了。看到 "RTC is newer than compile time. (this is expected)" 这行,说明芯片时间比编译时间新,走时正常。
掉电备份到底有没有用,拔电试试
备份电池是 DS1302 的灵魂,值得专门验证。做法很简单:等串口打了几行时间之后,拔掉 USB 线,过一两分钟再插回去。如果时间连续,说明电池在接管计时;如果每次上电都被重置成编译时间,多半是电池座里有绝缘片没抽、电池没电,或者 VCC1 供电脚根本没接电池。
代码里也有对应的自检线索:loop 里读到 now.IsValid() 为假并打出 "RTC lost confidence in the DateTime!",通常就是电池低压或缺失,主电断过之后芯片丢了对时间的把握。这时候换一颗 CR2032 再校一次时间即可。另外 DS1302 的涓流充电功能可以给可充电锂电池补电,但普通 CR2032 是不可充电的锰锂电池,接涓流充电有鼓包风险,用一次性纽扣电池的话保持默认不开涓流充电就好,Makuna 库默认不开启,不用动。
收尾
整套下来成本就是几块钱的模块加一颗纽扣电池,换来的是断电不丢的时间基准。接线五根、装一个库、烧一个官方示例,剩下的事芯片自己会做。后面把 printDateTime 打出来的时间戳喂给 SD 卡日志或者定时灌溉逻辑,就是一个能独立跑的数据记录仪了。唯一要有心理预期的是它的走时精度靠普通晶振,跑几个月漂个十几秒很正常,对精度较真的项目再考虑带温补的方案。











代码块里模板尖括号带空格那个写法编译没问题,评论区有人踩过这个坑的应该能看懂。
接完第一次上电时间自动校准这点太省心了,不用手动写时间。
拿这个做了个温室数据记录仪,跑了几个月漂了大概二十秒,对记录场景完全够用,精度要求高的确实得上温补方案。
感谢整理,ThreeWire(4,5,2) 那三个参数顺序之前一直记混,现在明确了是 IO、SCLK、CE。
这篇正好补了我上周的坑。当时没看背面电池座,CR2032底下垫着绝缘片,拔电重插时间老被重置,还以为是模块坏的。后来抽掉绝缘片就正常了,文章里这个提醒真的关键。