Linux驅(qū)動|rtc-hym8563移植筆記
1
本文基于瑞芯微rk3568平臺，關(guān)于該平臺快速入手操作，大家可以參考以下文章：
《瑞芯微rk356x板子快速上手》
0、什么是rtc-hym8563？
RTC：實(shí)時時鐘的縮寫是(Real_Time Clock)。RTC 是集成電路，通常稱為時鐘芯片。
1）產(chǎn)品概述
HYM8563是一款低功耗CMOS實(shí)時時鐘/日歷芯片，由武漢昊昱公司設(shè)計生產(chǎn)。
它提供一個可編程的時鐘輸出，一個中斷輸出和一個掉電檢測器，所有的地址和數(shù)據(jù)都通過I2C總線接口串行傳遞。
最大總線速度為400Kbits/s，每次讀寫數(shù)據(jù)后，內(nèi)嵌的字地址寄存器會自動遞增。
2）產(chǎn)品特點(diǎn)
● 可計時基于32.768kHz晶體的秒，分，小時，星期，天，月和年
● 帶有世紀(jì)標(biāo)志
● 寬工作電壓范圍：1.8～5.5V
● 低休眠電流：典型值為0.25μA（VDD=3.0V，TA=25℃）
● 400kHz的I2C總線接口（VDD=1.8～5.5V時）
● 可編程時鐘輸出頻率為：32.768kHz，1024Hz， 32Hz，1H
● 報警和定時器
● 掉電檢測器
● 內(nèi)部集成振蕩電容
● 片內(nèi)電源復(fù)位功能
● I2C總線從地址：讀，0A3H；寫，0A2H
● 漏極開路中斷引腳
● 封裝形式：DIP8和SOP8
一、 移植基于平臺
soc : rk3568 board: EVB1-DDR4-V10 軟 件：Android 11 Linux：4.19.232
二、移植步驟
1）電路圖
由以上兩個圖可得硬件信息如下：
- RTC連接到I2C的通道5
- CLKOUT引腳對應(yīng)RTCIC_32KOUT
- INT連接的是RTCIC_INT_L_GPIO0_D3，即GPIO0的bit3
- 從設(shè)備地址為0x51（0101 0001）, read：1010 0011 write: 1010 0010
2）設(shè)備樹
內(nèi)核中已有關(guān)于hym8563的設(shè)備樹節(jié)點(diǎn)信息說明：
Documentation/devicetree/bindings/rtc/haoyu,hym8563.txt
同時在瑞芯微提供的個廠家sdk中，已經(jīng)由類似的設(shè)備樹節(jié)點(diǎn)實(shí)例，所以我們也可以直接參考該內(nèi)容：
下面是pinctrl關(guān)于rtc引腳的說明：
結(jié)合該說明文檔，根據(jù)硬件信息，填充設(shè)備樹信息到文件
kernel\arch\arm64\boot\dts\rockchip\rk3568-evb.dtsi
填加信息如下：
1393 &i2c5 {
1394 status = "okay";
1395 hym8563: hym8563@51 {
1396 compatible = "haoyu,hym8563";
1397 reg =;
1398
1399 pinctrl-names = "default";
1400 pinctrl-0 = <&rtc_int>;
1401
1402 interrupt-parent = <&gpio0>;
1403 interrupts =;
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)容和硬件電路圖是對應(yīng)起來的。
3）驅(qū)動
hym8563驅(qū)動程序位于
drivers/rtc/rtc-hym8563.c
打開該驅(qū)動
arch/arm64/configs/rockchip_defconfig
4）打開hctosys驅(qū)動權(quán)限
為了支持硬件的時鐘(RTC)能與系統(tǒng)時間同步，內(nèi)核需要對應(yīng)驅(qū)動支持：
4434 CONFIG_RTC_HCTOSYS=y 允許RTC時間設(shè)置到系統(tǒng)時間 4435 CONFIG_RTC_HCTOSYS_DEVICE="rtc0" 默認(rèn)同步時間的RTC設(shè)備 4436 CONFIG_RTC_SYSTOHC=y 允許系統(tǒng)時間設(shè)置到RTC 4437 CONFIG_RTC_SYSTOHC_DEVICE="rtc0" 默認(rèn)同步時間的RTC設(shè)備
修改完畢，重新編譯內(nèi)核和設(shè)備樹，燒錄內(nèi)核即可
三、測試rtc
測試1）測試rtc驅(qū)動
在UI界面上設(shè)置->系統(tǒng)->日期和時間->時間可以讀取和設(shè)置新的時間，
設(shè)置完畢使用hwclock查看時間
如果時間一致，可以設(shè)置說明rtc驅(qū)動起了作用，
【也可以在驅(qū)動的read函數(shù)中，增加log，更加直觀】
.read_time = hym8563_rtc_read_time,
.set_time = hym8563_rtc_set_time,
測試2）測試rtc關(guān)機(jī)后時間同步
-
設(shè)置當(dāng)前時間和自己手機(jī)同步
-
拔掉電源，等待幾分鐘開機(jī)
-
確認(rèn)板子時間是否則和當(dāng)前手機(jī)時間一致
四、其他查看rtc方法
同時在以下目錄中也可以直接讀取驅(qū)動相關(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下有多個rtc設(shè)備，需要去掉rtc-rk808驅(qū)動
共板里除了hym8563，在pmic中還有內(nèi)部的rtc-rk808，我們需要把該rtc驅(qū)動去掉，否則/sys/class/rtc下會有2個rtc設(shè)備
在以下文件
arch/arm64/configs/rockchip_defconfig
808 CONFIG_RTC_DRV_RK808=n
該驅(qū)動位于
drivers/rtc/rtc-rk808.c
問題2）ui界面設(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位于以下文件：
frameworks\base\services\core\jni\com_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í)對應(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ù)還會繼續(xù)編寫Linux內(nèi)核的rtc 時間子系統(tǒng)的文章，敬請關(guān)注！
下載文檔
