11.RTC
===========

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

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

**11.1 RTC的使用**
--------------

以SC-3568HA为例，该板卡使用外部RTC(hym8563)，默认关闭了rk809的rtc功能。

使用外部RTC时需要接入纽扣电池

    |RTC_0| 

**11.2 RTC用户接口调用**
--------------

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

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

SYSFS接口：

.. code-block:: bash
    :linenos:

    # cat /sys/class/rtc/rtc0/date
    2024-10-21
    # cat /sys/class/rtc/rtc0/time
    09:48:46

.. hint::
    遇到cat返回的Invalid argument的情况，需要先进入系统设置内先设置一下时间


PROCFS接口：

.. code-block:: bash
    :linenos:

    # cat /proc/driver/rtc
    rtc_time        : 09:50:05
    rtc_date        : 2024-10-21
    alrm_time       : 00:00:00
    alrm_date       : 1970-01-01
    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

IOCTL接口：

可以使用 ioctl 控制 /dev/rtc0

**11.3 关于时钟常用的命令**
--------------

.. code-block:: bash
    :linenos:

    date          //修改系统时钟，具体命令使用可以man下
    hwclock -s    //将硬件时间同步到系统时间
    hwclock -w    //将系统时间同步到硬件时间

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

.. |RTC_0| image:: picture/RTC_0.png
   :width: 5in
   :height: 4in