OpenHarmony（鸿蒙南向）——平台驱动开发【RTC】

概述

功能简介

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报警中断