RTC

Introduction

The EC-Orin NX has one internal RTC powered by an external motherboard
battery, represented as "rtc0" in the kernel.

Interface Usage

Linux provides three user-space call interfaces. The paths are:

SYSFS interface: /sys/class/rtc/rtc0/

PROCFS interface: /proc/driver/rtc

IOCTL interface: /dev/rtc0

Synchronize the latest system time to the RTC:

   hwclock -w

SYSFS Interface

You can directly use "cat" and "echo" to operate on the interfaces
under "/sys/class/rtc/rtc0/".

For example, to check the current RTC date and time:

   # cat /sys/class/rtc/rtc0/date
   2024-07-10
   # cat /sys/class/rtc/rtc0/time
   02:36:30

PROCFS Interface

Print RTC-related information:

   # cat /proc/driver/rtc
   rtc_time        : 02:37:00
   rtc_date        : 2024-07-10
   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 Interface

You can use "ioctl" to control "/dev/rtc0".

For detailed usage instructions, please refer to the document "kernel-
jammy-src/Documentation/admin-guide/rtc.rst".