概述
功能简介
RTC(real-time clock)为操作系统中的实时时钟设备,为操作系统提供精准的实时时间和定时报警功能。当设备下电后,通过外置电池供电,RTC继续记录操作系统时间;设备上电后,RTC提供实时时钟给操作系统,确保断电后系统时间的连续性。
运作机制
在HDF框架中,RTC的接口适配模式采用独立服务模式,在这种模式下,每一个设备对象会独立发布一个设备服务来处理外部访问,设备管理器收到API的访问请求之后,通过提取该请求的参数,达到调用实际设备对象的相应内部方法的目的。独立服务模式可以直接借助HDFDeviceManager的服务管理能力,但需要为每个设备单独配置设备节点,增加内存占用。
独立服务模式下,核心层不会统一发布一个服务供上层使用,因此这种模式下驱动要为每个控制器发布一个服务,具体表现为:
-
驱动适配者需要实现HdfDriverEntry的Bind钩子函数以绑定服务。
-
device_info.hcs文件中deviceNode的policy字段为1或2,不能为0。
图 1 RTC独立服务模式结构图
RTC模块各分层作用:
-
接口层提供打开RTC设备、RTC设备读取时间、RTC设备设置时间、RTC设备读取警报时间、RTC设备设置警报时间、RTC设备定时报警回调函数、RTC设备设置定时报警中断使能去使能、RTC设备设置RTC外频、RTC设备读取RTC外频、复位RTC、设置RTC自定义寄存器配置,读取RTC自定义寄存器配置以及关闭RTC设备的接口。
-
核心层主要提供RTC控制器的创建、销毁,通过钩子函数与适配层交互。
-
适配层主要是将钩子函数的功能实例化,实现具体的功能。
开发指导
场景介绍
RTC主要用于提供实时时间和定时报警功能。当驱动开发者需要将RTC设备适配到OpenHarmony时,需要进行RTC驱动适配,下文将介绍如何进行RTC驱动适配。
接口说明
为了保证上层在调用RTC接口时能够正确的操作硬件,核心层在//drivers/hdf_core/framework/support/platform/include/rtc/rtc_core.h中定义了以下钩子函数。驱动适配者需要在适配层实现这些函数的具体功能,并与这些钩子函数挂接,从而完成接口层与核心层的交互。
RtcMethod定义:
struct RtcMethod {
int32_t (*ReadTime)(struct RtcHost *host, struct RtcTime *time);
int32_t (*WriteTime)(struct RtcHost *host, const struct RtcTime *time);
int32_t (*ReadAlarm)(struct RtcHost *host, enum RtcAlarmIndex alarmIndex, struct RtcTime *time);
int32_t (*WriteAlarm)(struct RtcHost *host, enum RtcAlarmIndex alarmIndex, const struct RtcTime *time);
int32_t (*RegisterAlarmCallback)(struct RtcHost *host, enum RtcAlarmIndex alarmIndex, RtcAlarmCallback cb);
int32_t (*AlarmInterruptEnable)(struct RtcHost *host, enum RtcAlarmIndex alarmIndex, uint8_t enable);
int32_t (*GetFreq)(struct RtcHost *host, uint32_t *freq);
int32_t (*SetFreq)(struct RtcHost *host, uint32_t freq);
int32_t (*Reset)(struct RtcHost *host);
int32_t (*ReadReg)(struct RtcHost *host, uint8_t usrDefIndex, uint8_t *value);
int32_t (*WriteReg)(struct RtcHost *host, uint8_t usrDefIndex, uint8_t value);
};
c
表 1 RtcMethod结构体成员的钩子函数功能说明
函数 | 入参 | 出参 | 返回值 | 功能 |
---|---|---|---|---|
ReadTime | host:结构体指针,核心层RTC控制器 | time:结构体指针,传出的时间值 | HDF_STATUS相关状态 | 读RTC时间信息 |
WriteTime | host:结构体指针,核心层RTC控制器 time:结构体指针,时间传入值 |
无 | HDF_STATUS相关状态 | 写RTC时间信息(包括毫秒~年) |
ReadAlarm | host:结构体指针,核心层RTC控制器 alarmIndex:枚举值,闹钟报警索引 |
time:结构体指针,传出的时间值 | HDF_STATUS相关状态 | 读RTC报警时间信息 |
WriteAlarm | host:结构体指针,核心层RTC控制器 alarmIndex:枚举值,闹钟报警索引 time:结构体指针,时间传入值 |
无 | HDF_STATUS相关状态 | 写RTC报警时间信息 |
RegisterAlarmCallback | host:结构体指针,核心层RTC控制器 alarmIndex:枚举值,闹钟报警索引 cb:函数指针,回调函数 |
无 | HDF_STATUS相关状态 | 注册报警超时回调函数 |
AlarmInterruptEnable | host:结构体指针,核心层RTC控制器 alarmIndex:枚举值,闹钟报警索引 enable:布尔值,控制报警 |
无 | HDF_STATUS相关状态 | 使能/去使能RTC报警中断 |