良许Linux教程网 干货合集 Linux驱动|rtc-hym8563移植笔记

Linux驱动|rtc-hym8563移植笔记

本文基于瑞芯微rk3568平台,关于该平台快速入手操作,大家可以参考以下文章:

瑞芯微rk356x板子快速上手

0、什么是rtc-hym8563?

RTC:实时时钟的缩写是(Real_Time Clock)。RTC 是集成电路,通常称为时钟芯片。

1)产品概述

HYM8563是一款低功耗CMOS实时时钟/日历芯片,由武汉昊昱公司设计生产。

image-20240501202824563
image-20240501202824563

它提供一个可编程的时钟输出,一个中断输出和一个掉电检测器,所有的地址和数据都通过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
Linux:4.19.232

二、移植步骤

1)电路图

图片
图片
image-20240501202829487
image-20240501202829487

由以上两个图可得硬件信息如下:

  1. RTC连接到I2C的通道5
  2. CLKOUT引脚对应RTCIC_32KOUT
  3. INT连接的是RTCIC_INT_L_GPIO0_D3,即GPIO0的bit3
  4. 从设备地址为0x51(0101 0001), read:1010 0011 write: 1010 0010

2)设备树

内核中已有关于hym8563的设备树节点信息说明:

Documentation/devicetree/bindings/rtc/haoyu,hym8563.txt
image-20240501202841492
image-20240501202841492

同时在瑞芯微提供的个厂家sdk中,已经由类似的设备树节点实例,所以我们也可以直接参考该内容:

image-20240501202846039
image-20240501202846039
image-20240501202849682
image-20240501202849682

下面是pinctrl关于rtc引脚的说明:

image-20240501202930943
image-20240501202930943

结合该说明文档,根据硬件信息,填充设备树信息到文件

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 = ;
1401         
1402         interrupt-parent = ;
1403         interrupts = ;
1404     };

1468 &pinctrl {
1469     rtc {
1470             rtc_int: rtc-int {
1471              rockchip,pins = ;
1472         };
1473     };

可以看到该节点内容和硬件电路图是对应起来的。

3)驱动

hym8563驱动程序位于

drivers/rtc/rtc-hym8563.c

打开该驱动

arch/arm64/configs/rockchip_defconfig
image-20240501202905717
image-20240501202905717

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设备

修改完毕,重新编译内核和设备树,烧录内核即可

三、测试rtc

测试1)测试rtc驱动

在UI界面上设置->系统->日期和时间->时间 可以读取和设置新的时间,

image-20240501202911112
image-20240501202911112

设置完毕使用hwclock查看时间

如果时间一致,可以设置说明rtc驱动起了作用,

image-20240501202915898
image-20240501202915898

【也可以在驱动的read函数中,增加log,更加直观】

 .read_time  = hym8563_rtc_read_time,
 .set_time  = hym8563_rtc_set_time,

测试2)测试rtc关机后时间同步

  1. 设置当前时间和自己手机同步
  2. 拔掉电源,等待几分钟开机
  3. 确认板子时间是否则和当前手机时间一致

四、其他查看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 genfscon sysfs /devices/platform/fe5e0000.i2c/i2c-5/5-0051/rtc/rtc0/hctosys                u:object_r:sysfs_hctosys:s0

重新编译安卓即可。

 

注意 /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即可

image-20240501202923141
image-20240501202923141

后续还会继续编写Linux内核的rtc 时间子系统的文章,敬请关注!

六、欢迎交流

一口君建立了瑞芯微的技术交流群,

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

加群后台留言即可。

以上就是良许教程网为各位朋友分享的Linu系统相关内容。想要了解更多Linux相关知识记得关注公众号“良许Linux”,或扫描下方二维码进行关注,更多干货等着你 !

137e00002230ad9f26e78-265x300
本文由 良许Linux教程网 发布,可自由转载、引用,但需署名作者且注明文章出处。如转载至微信公众号,请在文末添加作者公众号二维码。
良许

作者: 良许

良许,世界500强企业Linux开发工程师,公众号【良许Linux】的作者,全网拥有超30W粉丝。个人标签:创业者,CSDN学院讲师,副业达人,流量玩家,摄影爱好者。
上一篇
下一篇

发表评论

联系我们

联系我们

公众号:良许Linux

在线咨询: QQ交谈

邮箱: yychuyu@163.com

关注微信
微信扫一扫关注我们

微信扫一扫关注我们

关注微博
返回顶部