Linux驅(qū)動(dòng) | rtc-hym8563移植筆記

0、什么是rtc-hym8563？

RTC：實(shí)時(shí)時(shí)鐘的縮寫是(Real_Time Clock)。RTC 是集成電路，通常稱為時(shí)鐘芯片。

1）產(chǎn)品概述

HYM8563是一款低功耗CMOS實(shí)時(shí)時(shí)鐘/日歷芯片，由武漢昊昱公司設(shè)計(jì)生產(chǎn)。它提供一個(gè)可編程的時(shí)鐘輸出，一個(gè)中斷輸出和一個(gè)掉電檢測器，所有的地址和數(shù)據(jù)都通過I2C總線接口串行傳遞。

最大總線速度為400Kbits/s，每次讀寫數(shù)據(jù)后，內(nèi)嵌的字地址寄存器會(huì)自動(dòng)遞增。

2）產(chǎn)品特點(diǎn)

● 可計(jì)時(shí)基于32.768kHz晶體的秒，分，小時(shí)，星期，天，月和年

● 帶有世紀(jì)標(biāo)志 

● 寬工作電壓范圍：1.8～5.5V

● 低休眠電流：典型值為0.25μA（VDD=3.0V，TA=25℃）

● 400kHz的I2C總線接口（VDD=1.8～5.5V時(shí)）

● 可編程時(shí)鐘輸出頻率為：32.768kHz，1024Hz， 32Hz，1H

● 報(bào)警和定時(shí)器 

● 掉電檢測器 

● 內(nèi)部集成振蕩電容

● 片內(nèi)電源復(fù)位功能 

● I2C總線從地址：讀，0A3H；寫，0A2H

● 漏極開路中斷引腳 

● 封裝形式：DIP8和SOP8

一、 移植基于平臺(tái)

soc  : rk3568   
board: EVB1-DDR4-V10
軟  件：Android 11
Linux：4.19.232

二、移植步驟

1）電路圖

由以上兩個(gè)圖可得硬件信息如下：

2）設(shè)備樹

內(nèi)核中已有關(guān)于hym8563的設(shè)備樹節(jié)點(diǎn)信息說明：

Documentation/devicetree/bindings/rtc/haoyu,hym8563.txt

同時(shí)在瑞芯微提供的個(gè)廠家sdk中，已經(jīng)由類似的設(shè)備樹節(jié)點(diǎn)實(shí)例，所以我們也可以直接參考該內(nèi)容：

下面是pinctrl關(guān)于rtc引腳的說明：

結(jié)合該說明文檔，根據(jù)硬件信息，填充設(shè)備樹信息到文件

kernelarcharm64bootdtsrockchiprk3568-evb.dtsi

填加信息如下：

1393 &i2c5 {
1394     status = "okay";
1395     hym8563: hym8563@51 {
1396         compatible = "haoyu,hym8563";                                                              
1397         reg = <0x51>;
1398         
1399         pinctrl-names = "default";
1400         pinctrl-0 = <&rtc_int>;
1401         
1402         interrupt-parent = <&gpio0>;
1403         interrupts = <RK_PD3 IRQ_TYPE_LEVEL_LOW>;
1404     };

1468 &pinctrl {
1469     rtc {
1470             rtc_int: rtc-int {
1471              rockchip,pins = <0 RK_PD3 RK_FUNC_GPIO &pcfg_pull_up>;
1472         };
1473     };

可以看到該節(jié)點(diǎn)內(nèi)容和硬件電路圖是對(duì)應(yīng)起來的。

3）驅(qū)動(dòng)

hym8563驅(qū)動(dòng)程序位于

drivers/rtc/rtc-hym8563.c

打開該驅(qū)動(dòng)

arch/arm64/configs/rockchip_defconfig

4）打開hctosys驅(qū)動(dòng)權(quán)限

為了支持硬件的時(shí)鐘(RTC)能與系統(tǒng)時(shí)間同步，內(nèi)核需要對(duì)應(yīng)驅(qū)動(dòng)支持：

4434 CONFIG_RTC_HCTOSYS=y                允許RTC時(shí)間設(shè)置到系統(tǒng)時(shí)間
4435 CONFIG_RTC_HCTOSYS_DEVICE="rtc0"    默認(rèn)同步時(shí)間的RTC設(shè)備
4436 CONFIG_RTC_SYSTOHC=y                允許系統(tǒng)時(shí)間設(shè)置到RTC
4437 CONFIG_RTC_SYSTOHC_DEVICE="rtc0"    默認(rèn)同步時(shí)間的RTC設(shè)備

修改完畢，重新編譯內(nèi)核和設(shè)備樹，燒錄內(nèi)核即可

三、測試rtc

測試1）測試rtc驅(qū)動(dòng)

在UI界面上設(shè)置->系統(tǒng)->日期和時(shí)間->時(shí)間 可以讀取和設(shè)置新的時(shí)間，

設(shè)置完畢使用hwclock查看時(shí)間

如果時(shí)間一致，可以設(shè)置說明rtc驅(qū)動(dòng)起了作用，

【也可以在驅(qū)動(dòng)的read函數(shù)中，增加log，更加直觀】

 .read_time  = hym8563_rtc_read_time,
 .set_time  = hym8563_rtc_set_time,

測試2）測試rtc關(guān)機(jī)后時(shí)間同步

四、其他查看rtc方法

同時(shí)在以下目錄中也可以直接讀取驅(qū)動(dòng)相關(guān)的信息。

rk3568_r:/sys/class/rtc # ls
rtc0
rk3568_r:/sys/class/rtc # cd rtc0
rk3568_r:/sys/class/rtc/rtc0 # cd ..
rk3568_r:/sys/class/rtc # ls -l
total 0
lrwxrwxrwx 1 root root 0 2021-01-01 12:00 rtc0 -> ../../devices/platform/fe5e0000.i2c/i2c-5/5-0051/rtc/rtc0
rk3568_r:/sys/class/rtc # cd rtc0
rk3568_r:/sys/class/rtc/rtc0 # ls
date  device   max_user_freq  power        subsystem  uevent     wakeup8
dev   hctosys  name           since_epoch  time       wakealarm
rk3568_r:/sys/class/rtc/rtc0 # cat name
rtc-hym8563 5-0051
rk3568_r:/sys/class/rtc/rtc0 # cat time
03:04:57
rk3568_r:/sys/class/rtc/rtc0 # cat hctosys
1

五、遇到的問題

問題1）/sys/class/rtc下有多個(gè)rtc設(shè)備，需要去掉rtc-rk808驅(qū)動(dòng)

共板里除了hym8563，在pmic中還有內(nèi)部的rtc-rk808，我們需要把該rtc驅(qū)動(dòng)去掉，否則/sys/class/rtc下會(huì)有2個(gè)rtc設(shè)備 在以下文件

arch/arm64/configs/rockchip_defconfig

808 CONFIG_RTC_DRV_RK808=n 

該驅(qū)動(dòng)位于

 drivers/rtc/rtc-rk808.c

問題2）ui界面設(shè)置的時(shí)間無法同步到hym8563中

打開開機(jī)后的logcat，發(fā)現(xiàn)有如下信息

01-01 12:00:14.256   439   439 E AlarmManagerService: failed to open /sys/class/rtc/rtc0/hctosys: Permission denied
01-01 12:00:14.256   439   439 W AlarmManagerService: no wall clock RTC found
01-01 12:00:14.260   439   439 D AlarmManagerService: Kernel timezone updated to 0 minutes west of GMT
01-01 12:00:14.261   439   439 D AlarmManagerService: Setting time of day to sec=1663584459

09-19 10:47:39.000   439   439 W AlarmManagerService: Unable to set rtc to 1663584459: No such device

該log位于以下文件：

frameworksbaseservicescorejnicom_android_server_AlarmManagerService.cpp

該log位于263行：

257 static bool rtc_is_hctosys(unsigned int rtc_id)
258 {
259     android::String8 hctosys_path = String8::format("%s/rtc%u/hctosys",
260             rtc_sysfs, rtc_id);
261     FILE *file = fopen(hctosys_path.string(), "re");
262     if (!file) {
263         ALOGE("failed to open %s: %s", hctosys_path.string(), strerror(errno));
264         return false;
265     }
266 
267     unsigned int hctosys;
268     bool ret = false;
269     int err = fscanf(file, "%u", &hctosys);
270     if (err == EOF)
271         ALOGE("failed to read from %s: %s", hctosys_path.string(),
272                 strerror(errno));
273     else if (err == 0)
274         ALOGE("%s did not have expected contents", hctosys_path.string());
275     else
276         ret = hctosys;
277 
278     fclose(file);
279     return ret;                                                                                     
280 }

由程序可知，沒有權(quán)限打開文件

/sys/class/rtc/rtc0/hctosys

增加該文件讀取權(quán)限，打開文件

device/rockchip/common/sepolicy/vendor/genfs_contexts

增加以下內(nèi)容：

28 # rk356x RTC
29 genfscon sysfs /devices/platform/fe5e0000.i2c/i2c-5/5-0051/rtc/rtc0/hctosys                u:object_r:sysfs_hctosys:s0

重新編譯安卓即可。

注意 /sys/class/rtc/rtc0/hctosys 其實(shí)對(duì)應(yīng)的文件位置是/sys/devices/platform/fe5e0000.i2c/i2c-5/5-0051/rtc/rtc0/hctosys rk3568_r:/sys/class/rtc # ls -l total 0 lrwxrwxrwx 1 root root 0 2021-01-01 12:00 rtc0 -> ../../devices/platform/fe5e0000.i2c/i2c-5/5-0051/rtc/rtc0

問題3）沒有紐扣電池，需要自己飛線，接穩(wěn)壓電源

如下圖，注意正負(fù)極，電壓設(shè)置為3v即可

后續(xù)還會(huì)繼續(xù)編寫Linux內(nèi)核的rtc 時(shí)間子系統(tǒng)的文章，敬請(qǐng)關(guān)注！

六、歡迎交流

一口君建立了瑞芯微的技術(shù)交流群，

大家工作中用到瑞芯微系列soc的，可以一起交流，

加群后臺(tái)留言即可。