鸿蒙开发(NEXT/API 12)【硬件(外设扩展驱动开发)】驱动开发服务

场景介绍

[DriverExtensionAbility]是Driver类型的ExtensionAbility组件,提供驱动相关扩展框架能力。对于部分设备,支持插入外接的硬件模块来扩展设备能力, 此时可以以应用方式安装该硬件模块的驱动程序。通过DriverExtensionAbility可实现此类应用的开发。

[DriverExtensionAbility]可以通过DriverExtensionManager被应用绑定,并根据应用的请求信息在后台处理相关事务。

每个类型的ExtensionAbility都有自己的Context,DriverExtensionAbility通过[DriverExtensionContext]提供相关能力。

环境搭建

其中SDK版本配置的要求如下:

NDK接口 SDK版本
USB DDK API10及以上
HID DDK API11及以上

开发步骤

开发者在实现一个驱动时,需要在DevEco Studio工程中手动新建一个DriverExtensionAbility,具体步骤如下。

  1. 在工程Module对应的ets目录下,右键选择"New > Directory",新建一个目录并命名为driverextability。

  2. 在driverextability目录,右键选择"New > ArkTS File",新建一个文件并命名为DriverExtAbility.ets。

  3. 在文件中导入相关Kit,并定义请求Code。

    import { DriverExtensionAbility } from '@kit.DriverDevelopmentKit';
    import { Want } from '@kit.AbilityKit';
    import { rpc } from '@kit.IPCKit';

    const REQUEST_CODE = 99; // 与扩展外设客户端约定请求码

  4. 打开DriverExtAbility.ets文件,导入[RPC通信模块],重载onRemoteMessageRequest()方法,接收应用传递过来的消息,并将处理的结果返回给应用。REQUEST_VALUE用于校验应用发送的服务请求码。

    class StubTest extends rpc.RemoteObject {
    // 接收应用传递过来的消息处理,以及将处理的结果返回给客户端
    onRemoteMessageRequest(code: number, data: rpc.MessageSequence, reply: rpc.MessageSequence,
    option: rpc.MessageOption) {
    if (code === REQUEST_CODE) {
    // 接收应用传递过来的数据
    // 应用使用多次调用data.writeString()写入多个数据时,驱动可以通过多次调用data.readString()方法接收对应的数据
    let optFir: string = data.readString();
    // 驱动将数据的处理结果返回给应用
    // 示例中为接收了"Hello",并将"Hello World"返回给应用
    reply.writeString(optFir + World);
    }
    return true;
    }
    }

  5. 在DriverExtAbility.ets文件中,增加导入[DriverExtensionAbility]的依赖包,该包提供了onInit()、onRelease()、onConnect()和onDisconnect()生命周期回调,自定义类继承[DriverExtensionAbility]并根据需要重写需要的生命周期回调。

    export default class DriverExtAbility extends DriverExtensionAbility {
    onInit(want: Want) {
    console.info('testTag', onInit, want: ${want.abilityName});
    }

    onRelease() {
    console.info('testTag', onRelease);
    }

    onConnect(want: Want) {
    console.info('testTag', onConnect, want: ${want.abilityName});
    return new StubTest("test");
    }

    onDisconnect(want: Want) {
    console.info('testTag', onDisconnect, want: ${want.abilityName});
    }

    onDump(params: Array<string>) {
    console.info('testTag', onDump, params: + JSON.stringify(params));
    return ['params'];
    }
    }

  6. 在工程Module对应的[module.json5配置文件]中注册DriverExtensionAbility,type标签需要设置为"driver",srcEntry标签表示当前ExtensionAbility组件所对应的代码路径。

    {
    "module": {
    "name": "entry",
    "type": "entry",
    "description": "string:module_desc", "mainElement": "EntryAbility", "deviceTypes": [ "default", "tablet" ], "requestPermissions": [ { "name": "ohos.permission.ACCESS_EXTENSIONAL_DEVICE_DRIVER" // 此处为扩展外设相关权限,必须配置 } ], "deliveryWithInstall": true, "installationFree": false, "pages": "profile:main_pages",
    "abilities": [
    {
    "name": "EntryAbility",
    "srcEntry": "./ets/entryability/EntryAbility.ets",
    "description": "string:EntryAbility_desc", "icon": "media:startIcon",
    "label": "string:EntryAbility_label", "startWindowIcon": "media:startIcon",
    "startWindowBackground": "color:start_window_background", "exported": true, "skills": [ { "entities": [ "entity.system.home" ], "actions": [ "action.system.home" ] } ] } ], "extensionAbilities": [ { "name": "DriverExtAbility", "icon": "media:startIcon",
    "description": "driver",
    "type": "driver",
    "exported": true,
    "srcEntry": "./ets/driverextability/DriverExtAbility.ets",
    "metadata": [
    {
    "name": "bus", // 必填项,所属总线
    "value": "USB"
    },
    {
    "name": "desc", // 选填项,必要的驱动描述
    "value": "the sample of driverExtensionAbility"
    },
    {
    "name": "vendor", // 选填项,驱动厂商名称
    "value": "string"
    },
    {
    "name": "vid", // 支持 USB vendor id 列表,填写16进制,此处为4817的16进制
    "value": "0x12D1"
    },
    {
    "name": "pid", // 支持的 USB product id 列表,填写16进制,此处为4258的16进制
    "value": "0x10A2"
    }
    ]
    }
    ]
    }
    }

  7. 完成客户端和驱动示例代码开发后,将Hap导入设备中,并点击hap中的Hello,查看是否会转变为Hello world,即实现ipc通信功能。

扩展设备能力

扩展外设管理提供了HID DDK和USB DDK两种能力,用于驱动开发;

应用签名

应用需要配置签名文件才能在设备上运行,并且扩展外设管理客户端开发,需要配置扩展外设的权限:ohos.permission.ACCESS_EXTENSIONAL_DEVICE_DRIVER。

相关推荐
yilylong11 分钟前
鸿蒙(Harmony)实现滑块验证码
华为·harmonyos·鸿蒙
baby_hua11 分钟前
HarmonyOS第一课——DevEco Studio的使用
华为·harmonyos
HarmonyOS_SDK38 分钟前
融合虚拟与现实,AR Engine为用户提供沉浸式交互体验
harmonyos
- 羊羊不超越 -2 小时前
App渠道来源追踪方案全面分析(iOS/Android/鸿蒙)
android·ios·harmonyos
Industio_触觉智能3 小时前
OpenHarmony4.1蓝牙芯片如何适配?触觉智能RK3568主板SBC3568演示
openharmony·rk3568·开源鸿蒙·鸿蒙开发板·触觉智能
长弓三石4 小时前
鸿蒙网络编程系列44-仓颉版HttpRequest上传文件示例
前端·网络·华为·harmonyos·鸿蒙
SameX6 小时前
鸿蒙 Next 电商应用安全支付与密码保护实践
前端·harmonyos
TeYiToKu6 小时前
笔记整理—linux驱动开发部分(9)framebuffer驱动框架
linux·c语言·arm开发·驱动开发·笔记·嵌入式硬件·arm
SuperHeroWu76 小时前
【HarmonyOS】键盘遮挡输入框UI布局处理
华为·harmonyos·压缩·keyboard·键盘遮挡·抬起
努力变厉害的小超超11 小时前
ArkTS中的组件基础、状态管理、样式处理、class语法以及界面渲染
笔记·鸿蒙