RTC 使用
简介
Firefly-R3572A 板载 HYM8563 实时时钟芯片(RTC,Real Time Clock)。HYM8563 是一款低功耗 CMOS 实时时钟/日历芯片,提供可编程时钟输出、中断输出与掉电检测,所有地址和数据通过 I2C 总线串行传输(最大 400 kbit/s):
- 基于 32.768 kHz 晶振计时(秒、分、小时、星期、日、月、年)
- 宽工作电压范围 1.0~5.5 V
- 低休眠电流(典型 0.25 μA,VDD=3.0 V,TA=25 °C)
- 内部集成振荡电容,漏极开路中断引脚
RTC 驱动
Firefly-R3572A 的 HYM8563 挂在 I2C1 总线、地址 0x51,DTS 节点位于 kernel-6.12/arch/arm64/boot/dts/rockchip/rk3572-firefly-r3572a.dtsi(由主 DTS 的 N_RTC 开关控制是否启用):
&i2c1 {
status = "okay";
pinctrl-0 = <&i2c1m1_xfer_pins>;
hym8563: hym8563@51 {
compatible = "haoyu,hym8563";
reg = <0x51>;
#clock-cells = <0>;
clock-frequency = <32768>;
clock-output-names = "hym8563";
pinctrl-names = "default";
pinctrl-0 = <&hym8563_int>;
interrupt-parent = <&gpio0>;
interrupts = <RK_PC2 IRQ_TYPE_LEVEL_LOW>;
wakeup-source;
};
};驱动源码为 kernel-6.12/drivers/rtc/rtc-hym8563.c。节点名、中断 GPIO、wakeup-source 等属性以你手中 SDK 的代码为准。
接口使用
Linux 提供三种用户空间接口访问 RTC:
- SYSFS 接口:
/sys/class/rtc/rtc0/ - PROCFS 接口:
/proc/driver/rtc - IOCTL 接口:
/dev/rtc0
SYSFS 接口
查看当前 RTC 日期与时间:
cat /sys/class/rtc/rtc0/date
cat /sys/class/rtc/rtc0/time设置定时开机(如 120 秒后开机):
echo +120 > /sys/class/rtc/rtc0/wakealarm
cat /sys/class/rtc/rtc0/wakealarm # 查看设定的开机时间
reboot -p # 关机,等待定时开机PROCFS 接口
cat /proc/driver/rtc输出示例:
rtc_time : 06:53:50
rtc_date : 2022-06-21
alrm_time : 06:55:05
alrm_date : 2022-06-21
alarm_IRQ : yes
alrm_pending : no
24hr : yesIOCTL 接口
可通过 ioctl 操作 /dev/rtc0,详细说明参考 SDK 文档 kernel-6.12/Documentation/admin-guide/rtc.rst。
FAQs
Q1:开发板上电后时间不同步?
A1:检查 RTC 电池是否正确接入;若使用 wakealarm 定时开机,确认 wakeup-source 属性已使能且系统时间已正确写入 RTC。
Q2:系统时间与 RTC 时间如何同步?
A2:可通过 hwclock 在两者间同步,例如 hwclock -w 将系统时间写入 RTC,hwclock -s 用 RTC 时间设置系统时间。

