class="hide-preCode-box">
        root {
            platform {
                rtc_config {
                    controller_0x12080000 {
                        match_attr = "hisilicon_hi35xx_rtc"; // 【必要】需要和device_info.hcs中的deviceMatchAttr值一致
                        rtcSpiBaseAddr = 0x12080000;         // 地址映射相关
                        regAddrLength = 0x100;               // 地址映射相关
                        irq = 37;                            // 中断号
                        supportAnaCtrl = false;
                        supportLock = false;
                        anaCtrlAddr = 0xff;
                        lock0Addr = 0xff;
                        lock1Addr = 0xff;
                        lock2Addr = 0xff;
                        lock3Addr = 0xff;
                    }
                }
            }
        }
        c
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}"> class="hide-preCode-box">

需要注意的是,新增rtc_config.hcs配置文件后,必须在hdf.hcs文件中将其包含,否则配置文件无法生效。

例如:本例中rtc_config.hcs所在路径为device/soc/hisilicon/hi3516dv300/sdk_liteos/hdf_config/rtc/rtc_config.hcs,则必须在产品对应的hdf.hcs中添加如下语句:

        #include "../../../../device/soc/hisilicon/hi3516dv300/sdk_liteos/hdf_config/rtc/rtc_config.hcs" // 配置文件相对路径
        c
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}">
  1. 实例化RTC控制器对象

完成属性文件配置之后,下一步就是以核心层RtcHost对象的初始化为核心,包括驱动适配者自定义结构体(传递参数和数据),实例化RtcHost成员RtcMethod(让用户可以通过接口来调用驱动底层函数),实现HdfDriverEntry成员函数(Bind、Init、Release)。

从驱动的角度看,自定义结构体是参数和数据的载体,而且rtc_config.hcs文件中的数值会被HDF读入并通过DeviceResourceIface来初始化结构体成员。

        struct RtcConfigInfo {
            uint32_t spiBaseAddr;         // 地址映射相关
            volatile void *remapBaseAddr; // 地址映射相关
            uint16_t regAddrLength;       // 地址映射相关
            uint8_t supportAnaCtrl;       // 是否支持anactrl
            uint8_t supportLock;          // 是否支持锁
            uint8_t irq;                  // 中断号
            uint8_t alarmIndex;           // 闹钟索引
            uint8_t anaCtrlAddr;          // anactrl地址
            struct RtcLockAddr lockAddr;  // 锁地址
            RtcAlarmCallback cb;          // 回调函数
            struct OsalMutex mutex;       // 互斥锁
        };

        // RtcHost是核心层控制器结构体,其中的成员在Init函数中会被赋值。
        struct RtcHost {
            struct IDeviceIoService service;
            struct HdfDeviceObject *device;
            struct RtcMethod *method;
            void *data;
        };
        c
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}"> class="hide-preCode-box">
        // rtc_hi35xx.c中的示例:钩子函数的填充
        static struct RtcMethod g_method = {
            .ReadTime = HiRtcReadTime,
            .WriteTime = HiRtcWriteTime,
            .ReadAlarm = HiReadAlarm,
            .WriteAlarm = HiWriteAlarm,
            .RegisterAlarmCallback = HiRegisterAlarmCallback,
            .AlarmInterruptEnable = HiAlarmInterruptEnable,
            .GetFreq = HiGetFreq,
            .SetFreq = HiSetFreq,
            .Reset = HiReset,
            .ReadReg = HiReadReg,
            .WriteReg = HiWriteReg,
        };
        c
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}">

入参:

HdfDeviceObject是整个驱动对外提供的接口参数,具备HCS配置文件的信息。

返回值:

HDF_STATUS相关状态(表3为部分展示,如需使用其他状态,可参考//drivers/hdf_core/interfaces/inner_api/utils/hdf_base.h中HDF_STATUS定义)。

表 3 HDF_STATUS相关状态说明

class="table-box">
状态(值)问题描述
HDF_ERR_INVALID_OBJECT控制器对象非法
HDF_ERR_MALLOC_FAIL内存分配失败
HDF_ERR_INVALID_PARAM参数非法
HDF_ERR_IOI/O 错误
HDF_SUCCESS初始化成功
HDF_FAILURE初始化失败

函数说明:

关联HdfDeviceObject对象和RtcHost。

        static int32_t HiRtcBind(struct HdfDeviceObject *device)
        {
            struct RtcHost *host = NULL;
            host = RtcHostCreate(device);     // 实际是申请内存并挂接device: host->device = device
                                              // 使HdfDeviceObject与RtcHost可以相互转化的前提
            ......
            device->service = &host->service; // 使HdfDeviceObject与RtcHost可以相互转化的前提
                                              // 方便后续通过调用RtcHostFromDevice实现全局性质的host
            return HDF_SUCCESS;
        }
        c
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}">

入参:

HdfDeviceObject是整个驱动对外提供的接口参数,具备HCS配置文件的信息。

返回值:

HDF_STATUS相关状态。

函数说明:

初始化自定义结构体对象,初始化RtcHost成员。

        static int32_t HiRtcInit(struct HdfDeviceObject *device)
        {
            struct RtcHost *host = NULL;
            struct RtcConfigInfo *rtcInfo = NULL;
            ......
            host = RtcHostFromDevice(device);  // 这里是HdfDeviceObject到RtcHost的强制转换
            rtcInfo = OsalMemCalloc(sizeof(*rtcInfo));
            ......
            /* HiRtcConfigData会从设备配置树中读取属性填充rtcInfo的supportAnaCtrl、supportLock、spiBaseAddr、regAddrLength、irq,
             * 为HiRtcSwInit和HiRtcSwInit提供参数,当函数HiRtcSwInit和HiRtcSwInit内部执行失败后进行内存释放等操作。
             */
            if (HiRtcConfigData(rtcInfo, device->property) != 0) {
                ......
            }
            if (HiRtcSwInit(rtcInfo) != 0) {   // 地址映射以及中断注册相关
                ......
            }
            if (HiRtcHwInit(rtcInfo) != 0) {   // 初始化anaCtrl和lockAddr相关内容
                ......
            }

            host->method = &g_method;          // RtcMethod的实例化对象的挂载
            host->data = rtcInfo;              // 使RtcConfigInfo与RtcHost可以相互转化的前提
            HDF_LOGI("Hdf dev service:%s init success!", HdfDeviceGetServiceName(device));
            return HDF_SUCCESS;
        }
        c
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}"> class="hide-preCode-box">

入参:

HdfDeviceObject是整个驱动对外提供的接口参数,具备HCS配置文件的信息。

返回值:

无。

函数说明:

释放内存和删除控制器,该函数需要在驱动入口结构体中赋值给Release接口,当HDF框架调用Init函数初始化驱动失败时,可以调用Release释放驱动资源。

说明:
所有强制转换获取相应对象的操作前提是在Init或Bind函数中具备对应赋值的操作。

        static void HiRtcRelease(struct HdfDeviceObject *device)
        {
            struct RtcHost *host = NULL;
            struct RtcConfigInfo *rtcInfo = NULL;
            ...
            host = RtcHostFromDevice(device);             // 这里是HdfDeviceObject到RtcHost的强制转换
            rtcInfo = (struct RtcConfigInfo *)host->data; // 这里是RtcHost到RtcConfigInfo的强制转换
            if (rtcInfo != NULL) {
                HiRtcSwExit(rtcInfo);
                OsalMemFree(rtcInfo);                     // 释放RtcConfigInfo
                host->data = NULL;
            }
            RtcHostDestroy(host);                         // 释放RtcHost
        }
        c
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}">
  1. 驱动调试

【可选】针对新增驱动程序,建议验证驱动基本功能,例如挂载后的信息反馈,读取RTC时间、设置RTC时间等。

如果大家想更加深入的学习 OpenHarmony(鸿蒙南向) 开发的全栈内容,不妨可以参考以下相关学习文档进行学习,助你快速提升自己:

OpenHarmony 开发环境搭建:https://qr18.cn/CgxrRy

《OpenHarmony源码解析》:https://qr18.cn/CgxrRy

系统架构分析:https://qr18.cn/CgxrRy

OpenHarmony 设备开发学习手册:https://qr18.cn/CgxrRy

在这里插入图片描述

OpenHarmony面试题(内含参考答案):https://qr18.cn/CgxrRy

写在最后

data-report-view="{"mod":"1585297308_001","spm":"1001.2101.3001.6548","dest":"https://blog.csdn.net/maniuT/article/details/141037080","extend1":"pc","ab":"new"}">> id="blogExtensionBox" style="width:400px;margin:auto;margin-top:12px" class="blog-extension-box"> class="blog_extension blog_extension_type2" id="blog_extension"> class="extension_official" data-report-click="{"spm":"1001.2101.3001.6471"}" data-report-view="{"spm":"1001.2101.3001.6471"}"> class="blog_extension_card_left"> class="blog_extension_card_cont"> 鸿蒙开发学习资料领取!!! class="blog_extension_card_cont_r"> 微信名片
注:本文转载自blog.csdn.net的沧海一笑-dj的文章"https://blog.csdn.net/dengjin20104042056/article/details/99551321"。版权归原作者所有,此博客不拥有其著作权,亦不承担相应法律责任。如有侵权,请联系我们删除。
复制链接

评论记录:

未查询到任何数据!