本文基于瑞芯微rk3568平台,關于該平台快速入手操作,大家可以參考以下文章:
《瑞芯微rk356x闆子快速上手》
0、什麼是rtc-hym8563?
RTC:實時時鐘的縮寫是(Real_Time Clock)。RTC 是內建電路,通常稱為時鐘晶片。
1)産品概述
HYM8563是一款低功耗CMOS實時時鐘/月曆晶片,由武漢昊昱公司設計生産。
![](https://img.laitimes.com/img/_0nNw4CM6IyYiwiM6ICdiwiI0gTMx81dsQWZ4lmZf1GLlpXazVmcvwFciV2dsQXYtJ3bm9CX9s2RkBnVHFmb1clWvB3MaVnRtp1XlBXe0xCMy81dvRWYoNHLwEzX5xCMx8FesU2cfdGLwMzX0xiRGZkRGZ0Xy9GbvNGLpZTY1EmMZVDUSFTU4VFRR9Fd4VGdsYTMfVmepNHLrJXYtJXZ0F2dvwVZnFWbp1zczV2YvJHctM3cv1Ce-cmbw5yNwMjM3M2M2EWMwUzMxczMzYzX4IzMwADMxAzLcBTMyIDMy8CXn9Gbi9CXzV2Zh1WavwVbvNmLvR3YxUjLyM3Lc9CX6MHc0RHaiojIsJye.png)
它提供一個可程式設計的時鐘輸出,一個中斷輸出和一個掉電檢測器,所有的位址和資料都通過I2C總線接口串行傳遞。
最大總線速度為400Kbits/s,每次讀寫資料後,内嵌的字位址寄存器會自動遞增。
2)産品特點
● 可計時基于32.768kHz晶體的秒,分,小時,星期,天,月和年
● 帶有世紀标志
● 寬工作電壓範圍:1.8~5.5V
● 低休眠電流:典型值為0.25μA(VDD=3.0V,TA=25℃)
● 400kHz的I2C總線接口(VDD=1.8~5.5V時)
● 可程式設計時鐘輸出頻率為:32.768kHz,1024Hz,
32Hz,1H
● 報警和定時器
● 掉電檢測器
● 内部內建振蕩電容
● 片内電源複位功能
● I2C總線從位址:讀,0A3H;寫,0A2H
● 漏極開路中斷引腳
● 封裝形式:DIP8和SOP8
一、 移植基于平台
soc : rk3568
board: EVB1-DDR4-V10
軟 件:Android 11
二、移植步驟
1)電路圖
由以上兩個圖可得硬體資訊如下:
- RTC連接配接到I2C的通道5
- CLKOUT引腳對應RTCIC_32KOUT
- INT連接配接的是RTCIC_INT_L_GPIO0_D3,即GPIO0的bit3
- 從裝置位址為0x51(0101 0001), read:1010 0011 write: 1010 0010
2)裝置樹
核心中已有關于hym8563的裝置樹節點資訊說明:
Documentation/devicetree/bindings/rtc/haoyu,hym8563.txt
同時在瑞芯微提供的個廠家sdk中,已經由類似的裝置樹節點執行個體,是以我們也可以直接參考該内容:
下面是pinctrl關于rtc引腳的說明:
結合該說明文檔,根據硬體資訊,填充裝置樹資訊到檔案
kernel\arch\arm64\boot\dts\rockchip\rk3568-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 };
可以看到該節點内容和硬體電路圖是對應起來的。
3)驅動
hym8563驅動程式位于
drivers/rtc/rtc-hym8563.c
打開該驅動
arch/arm64/configs/rockchip_defconfig
4)打開hctosys驅動權限
為了支援硬體的時鐘(RTC)能與系統時間同步,核心需要對應驅動支援:
4434 CONFIG_RTC_HCTOSYS=y 允許RTC時間設定到系統時間
4435 CONFIG_RTC_HCTOSYS_DEVICE="rtc0" 預設同步時間的RTC裝置
4436 CONFIG_RTC_SYSTOHC=y 允許系統時間設定到RTC
4437 CONFIG_RTC_SYSTOHC_DEVICE="rtc0"
修改完畢,重新編譯核心和裝置樹,燒錄核心即可
三、測試rtc
測試1)測試rtc驅動
在UI界面上
設定->系統->日期和時間->時間
可以讀取和設定新的時間,
設定完畢使用hwclock檢視時間
如果時間一緻,可以設定說明rtc驅動起了作用,
【也可以在驅動的read函數中,增加log,更加直覺】
= hym8563_rtc_read_time,
.set_time =
測試2)測試rtc關機後時間同步
- 設定目前時間和自己手機同步
- 拔掉電源,等待幾分鐘開機
- 确認闆子時間是否則和目前手機時間一緻
四、其他檢視rtc方法
同時在以下目錄中也可以直接讀取驅動相關的資訊。
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裝置,需要去掉rtc-rk808驅動
共闆裡除了hym8563,在pmic中還有内部的rtc-rk808,我們需要把該rtc驅動去掉,否則/sys/class/rtc下會有2個rtc裝置
在以下檔案
arch/arm64/configs/rockchip_defconfig
808 CONFIG_RTC_DRV_RK808=n
該驅動位于
drivers/rtc/rtc-rk808.c
問題2)ui界面設定的時間無法同步到hym8563中
打開開機後的logcat,發現有如下資訊
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 }
由程式可知,沒有權限打開檔案
/sys/class/rtc/rtc0/hctosys
增加該檔案讀取權限,打開檔案
device/rockchip/common/sepolicy/vendor/genfs_contexts
增加以下内容:
28 # rk356x RTC
29
重新編譯安卓即可。
注意
/sys/class/rtc/rtc0/hctosys 其實對應的檔案位置是/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)沒有紐扣電池,需要自己飛線,接穩壓電源
如下圖,注意正負極,電壓設定為3v即可
後續還會繼續編寫Linux核心的rtc 時間子系統的文章,敬請關注!
六、歡迎交流
一口君建立了瑞芯微的技術交流群,