root {
            device_info {
                match_attr = "hdf_manager";
                device_watchdog :: device {
                    device0 :: deviceNode {                                 // 驱动的DeviceNode节点
                        policy = 2;                                         // policy字段是驱动服务发布的策略,如果需要面向用户态,则为2
                        priority = 20;                                      // 驱动启动优先级
                        permission = 0644;                                  // 驱动创建设备节点权限
                        moduleName = "HDF_PLATFORM_WATCHDOG";               // 【必要】用于指定驱动名称,该字段的值必须和驱动入口结构的moduleName值一致
                        serviceName = "HDF_PLATFORM_WATCHDOG_0";            // 【必要】驱动对外发布服务的名称,必须唯一。
                        deviceMatchAttr = "hisilicon_hi35xx_watchdog_0";    // 【必要】用于配置控制器私有数据,必须和驱动私有数据配置表watchdog_config.hcs中的match_attr值保持一致。
                    }
                ......                                                      // 如果存在多个watchdog设备时【必须】添加节点,否则不用
                }
            }
        } 
        c
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}">
class="hide-preCode-box">

在//device/soc/hisilicon/hi3516dv300/sdk_liteos/hdf_config/watchdog/watchdog_config.hcs文件配置器件属性,其中配置参数如下:

        root {
            platform {
                template watchdog_controller {                     // 【必要】配置模板,如果下面节点使用时继承该模板,则节点中未声明的字段会使用该模板中的默认值
                    id = 0;                                        // watchdog ID号
                    match_attr = "";
                    regBase = 0x12050000;                          // 【必要】地址映射需要,物理基地址
                    regStep = 0x1000;                              // 【必要】地址映射需要,寄存器偏移步进
                }
                controller_0x12050000 :: watchdog_controller {     // 【必要】是作为设备驱动私有数据匹配的关键字
                    match_attr = "hisilicon_hi35xx_watchdog_0";    // 【必要】必须和device_info.hcs中的deviceMatchAttr值一致
                }
                ......                                             // 如果存在多个watchdog设备时【必须】添加节点,否则不用
            }
        }
        c
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}">

需要注意的是,新增watchdog_config.hcs配置文件后,必须在产品对应的hdf.hcs文件中将其包含如下语句所示,否则配置文件无法生效。

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

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

从驱动的角度看,驱动适配者自定义结构体是参数和数据的载体,而且watchdog_config.hcs文件中的数值会被HDF读入通过DeviceResourceIface来初始化结构体成员,其中一些重要数值也会传递给核心层WatchdogCntlr对象,例如watchdog设备ID号。

        struct Hi35xxWatchdog {
            struct WatchdogCntlr wdt;           // 【必要】是核心层控制对象,具体描述见下面
            OsalSpinlock lock;                  // 【必要】驱动适配者需要基于此锁变量对watchdog设备实现对应的加锁解锁
            volatile unsigned char *regBase;    // 【必要】地址映射需要,寄存器基地址
            uint32_t phyBase;                   // 【必要】地址映射需要,物理基址
            uint32_t regStep;                   // 【必要】地址映射需要,寄存器偏移步进
        };

        struct WatchdogCntlr {                  // WatchdogCntlr是核心层控制器结构体,其中的成员在Init函数中会被赋值。
            struct IDeviceIoService service;    // 驱动服务
            struct HdfDeviceObject *device;     // 驱动设备对象
            OsalSpinlock lock;                  // 自旋锁
            struct WatchdogMethod *ops;         // 钩子函数
            int16_t wdtId;                      // watchdog设备ID号
            void *priv;                         // 私有数据
        };
        c
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}"> class="hide-preCode-box">
        static struct WatchdogMethod g_method = {      // 钩子函数实例化
            .getStatus = Hi35xxWatchdogGetStatus,      // 获取看门狗状态
            .start = Hi35xxWatchdogStart,              // 启动看门狗
            .stop = Hi35xxWatchdogStop,                // 停止看门狗
            .setTimeout = Hi35xxWatchdogSetTimeout,    // 设置看门狗超时时间
            .getTimeout = Hi35xxWatchdogGetTimeout,    // 获取看门狗超时时间
            .feed = Hi35xxWatchdogFeed,                // 喂狗
        };
        c
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}">

入参:

HdfDeviceObject:HDF框架给每一个驱动创建的设备对象,用来保存设备相关的私有数据和服务接口。

返回值:

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_IOI/O 错误
HDF_SUCCESS初始化成功
HDF_FAILURE初始化失败

函数说明:

初始化自定义结构体对象,初始化WatchdogCntlr成员,调用核心层WatchdogCntlrAdd函数,完成看门狗控制器的添加。

        // 一般而言,Init函数需要根据入参(HdfDeviceObject对象)的属性值初始化Hi35xxWatchdog结构体的成员,
        // 但watchdog_hi35xx.c示例中是在bind函数中实现的
        static int32_t Hi35xxWatchdogInit(struct HdfDeviceObject *device)
        {
            (void)device;
            return HDF_SUCCESS;
        }

        static int32_t Hi35xxWatchdogBind(struct HdfDeviceObject *device)
        {
            int32_t ret;
            struct Hi35xxWatchdog *hwdt = NULL;
            ......
            hwdt = (struct Hi35xxWatchdog *)OsalMemCalloc(sizeof(*hwdt)); // Hi35xxWatchdog 结构体指针的内存申请
            ......
            hwdt->regBase = OsalIoRemap(hwdt->phyBase, hwdt->regStep);    // 地址映射
            ......
            hwdt->wdt.priv = (void *)device->property;                    // 【必要】此处是将设备属性的内容赋值给priv成员,但后续没有调用 priv 成员,
                                                                          // 如果需要用到priv成员,需要额外实例化WatchdogMethod的getPriv和releasePriv成员函数
            hwdt->wdt.ops = &g_method;                                    // 【必要】WatchdogMethod实例化对象的挂载
            hwdt->wdt.device = device;                                    // 【必要】这是为了方便HdfDeviceObject与WatchdogcCntlr相互转化
            ret = WatchdogCntlrAdd(&hwdt->wdt);                           // 【必要】调用此函数初始化核心层结构体,返回成功信号后驱动才完全接入平台核心层
            if (ret != HDF_SUCCESS) {                                     // 不成功的话,需要去除映射并释放Init函数申请的资源
                OsalIoUnmap((void *)hwdt->regBase);
                OsalMemFree(hwdt);
                return ret;
            }    
            return HDF_SUCCESS;
        }
        c
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}"> class="hide-preCode-box">

入参:

HdfDeviceObject:HDF框架给每一个驱动创建的设备对象,用来保存设备相关的私有数据和服务接口。

返回值:

无。

函数说明:

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

        static void Hi35xxWatchdogRelease(struct HdfDeviceObject *device)
        {
            struct WatchdogCntlr *wdt = NULL;
            struct Hi35xxWatchdog *hwdt = NULL;
            ......
            wdt = WatchdogCntlrFromDevice(device);    // 【必要】通过device获取WatchdogCntlr
            ......
            if (wdt == NULL) {
                return;
            }
            WatchdogCntlrRemove(wdt);                 // 【必要】调用WatchdogCntlrRemove函数来释放WatchdogCntlr对象的内容
            hwdt = (struct Hi35xxWatchdog *)wdt;      // 这里将WatchdogCntlr转化为Hi35xxWatchdog
            if (hwdt->regBase != NULL) {              // 【必要】解除地址映射
                OsalIoUnmap((void *)hwdt->regBase);
                hwdt->regBase = NULL;
            }
            OsalMemFree(hwdt);                        // 【必要】释放驱动适配者自定义对象占用的内存
        }
        c
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}"> class="hide-preCode-box">
  1. 驱动调试

【可选】针对新增驱动程序,建议验证驱动基本功能,例如挂载后的信息反馈,获取看门狗状态、喂狗等。

如果大家想更加深入的学习 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/141065840","extend1":"pc","ab":"new"}">>
注:本文转载自blog.csdn.net的沧海一笑-dj的文章"https://blog.csdn.net/dengjin20104042056/article/details/99686340"。版权归原作者所有,此博客不拥有其著作权,亦不承担相应法律责任。如有侵权,请联系我们删除。
复制链接

评论记录:

未查询到任何数据!