RTC

Introduction

CQ38W-3576 development BOARD uses TT8563RH as RTC(Real Time Clock), TT8563RH is a low power CMOS real-time Clock/calendar chip, it provides a programmable Clock output, an interrupt Output and a power down detector, all addresses and data are passed serially through the I2C bus interface.

• Timing can be based on 32.768kHz crystals in seconds, minutes, hours, weeks, days, months and years
• Wide working voltage range
  .0~5.5V
• Low resting current: Typical 0.25μA(VDD =3.0V, TA =25°C)
• Internal integrated oscillating capacitor
• drain open circuit interrupt pin

CQ38W-3576 has a capacitor to supply power to the RTC as shown in the following figure to ensure that the RTC runs in a short time.

Driver RTC

DTS Reference: kernel/arch/arm64/boot/dts/rockchip/rk3576-firefly-ext-icore-3576q38.dtsi

Driver Reference: kernel/drivers/rtc/rtc-hym8563.c

Interface usage

Linux provides three user-space call interfaces. The corresponding path in the CQ38W-3576 development board is:

• SYSFS Interface : /sys/class/rtc/rtc0/
• PROCFS Interface : /proc/driver/rtc
• IOCTL Interface : /dev/rtc0

SYSFS Interface

You can directly use the interface below cat and echo operations /sys/class/rtc/rtc0/.

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

# cat /sys/class/rtc/rtc0/date
2013-01-18
# cat /sys/class/rtc/rtc0/time
09:36:10

Set the startup time, such as starting up after 120 seconds:

#Start the machine regularly after 120 seconds
echo +120 >  /sys/class/rtc/rtc0/wakealarm
# View boot time
cat /sys/class/rtc/rtc0/wakealarm
#To turn it off
reboot -p

PROCFS Interface

Print RTC related information:

# 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
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.

Please refer to the document rtc.txt for detailed instructions.

FAQs

Q1: The time is out of sync after the development board is powered on ?

A1 : Check that the RTC battery is properly connected