11. RTC¶

RTC全称为Real Time Clock，是一个专门用来记录时间的硬件设备，一般可以集成在soc内部，或者选择外挂，通过i2c与其通信。

那为什么会需要RTC，因为Linux的系统时间(也就是我们常说的wall time)只能在系统运行时使用，系统关机时间就丢了，而RTC可以在系统关闭后，依靠外部电池或其他supply继续工作，这才将时间保存下来。

LubanCat-p1板卡使用的是主控内部rtc，需要RTC电池才能开启RTC的功能，RTC电池的选型如下：

购买链接(仅供参考)： (淘宝野火)CR1220锂电池带线带插头电池RTC记忆时钟后备电池3v
购买链接(仅供参考)： (淘宝)CR2032联想 IBM笔记本台式机主板电池3V纽扣COMS 带线 2针
购买链接(仅供参考)： (淘宝)原装KTS CR2032纽扣电池3V笔记本遥控器台式机主板电脑锂电池带线

注解

链接仅供参考，如需要，请自行根据上述链接的关键词搜索购买

接线的正负极如下：

如果线序不对，可以使用镊子调整RTC电池的接口：

rtc电池和板卡连接如下图所示：

11.1. rtc控制接口¶

Linux 提供了三种用户空间调用接口。在板卡中对应的路径为：

SYSFS接口：/sys/class/rtc/rtc0/
PROCFS接口： /proc/driver/rtc
IOCTL接口： /dev/rtc0

SYSFS接口：

#通过SYSFS接口查看
cat /sys/class/rtc/rtc0/date
#信息输出
2023-06-19

#通过SYSFS接口查看
cat /sys/class/rtc/rtc0/time
#信息输出
03:15:22

PROCFS接口：

#通过PROCFS接口查看
cat /proc/driver/rtc

#信息输出如下
rtc_time        : 00:16:18
rtc_date        : 2023-08-14
alrm_time       : 06:28:15
alrm_date       : 2106-02-07
alarm_IRQ       : no
alrm_pending    : no
update IRQ enabled      : no
periodic IRQ enabled    : no
periodic IRQ frequency  : 1
max user IRQ frequency  : 64
24hr            : yes
name            : 5026000.rtc

IOCTL接口：

可以参考内核文档作为例子
tools/testing/selftests/timers/rtctest.c

11.2. 一些常用的命令¶

date          //修改系统时钟，具体命令使用man命令查看
/bin/busybox hwclock -s    //将硬件时间同步到系统时间
/bin/busybox hwclock -w    //将系统时间同步到硬件时间
timedatectl   //显示系统时间等

使用实例：

sudo date -s "2023-08-14 08:00:00"  //手动设置时间
sudo /bin/busybox hwclock -w     //系统时间同步到硬件rtc
sudo /bin/busybox hwclock -s    //硬件rtc同步到系统

以上手动设置时间或者网络同步时间后，-w将系统时间写入到硬件rtc，-s再将rtc时间写回系统，这样每次重启板卡都会进行rtc时间同步到系统时间。

注意

要使用BusyBox工具带的hwclock功能去配置，直接使用系统hwclock工具配置会出现超时情况。