鸿蒙5.0开发进阶:NDK开发-USB DDK开发指南

鸿蒙OpenHarmony【外设驱动使用之USB】 子系统 USB(Universal Serial Bus)通用串行总线,包含了主机端(Host)和设备端(Device)。主机端负责USB总线中的数据传输及端口管理,设备端则可以连接各种外设,所以USB驱动开发又分为主机端驱动开发和设备端驱动开发。 阅读详情

往期鸿蒙全套实战文章必看:(文中附带全栈鸿蒙学习资料)


场景介绍

USB DDK(USB Driver Develop Kit)是为开发者提供的USB驱动程序开发套件,支持开发者基于用户态,在应用层开发USB设备驱动。提供了一系列主机侧访问设备的接口,包括主机侧打开和关闭接口、管道同步异步读写通信、控制传输、中断传输等。

约束与限制

  • USB DDK开放API支持USB接口非标外设扩展驱动开发场景。

  • USB DDK开放API使用范围内仅允许DriverExtensionAbilit生命周期内使用。

  • 使用USB DDK开放API需要在module.json5中声明匹配的ACL权限,例如ohos.permission.ACCESS_DDK_USB。

接口说明

名称描述
OH_Usb_Init(void)初始化DDK。
OH_Usb_Release(void)释放DDK。
OH_Usb_GetDeviceDescriptor(uint64_t deviceId, struct UsbDeviceDescriptor *desc)获取设备描述符。
OH_Usb_GetConfigDescriptor(uint64_t deviceId, uint8_t configIndex, struct UsbDdkConfigDescriptor **const config)获取配置描述符。请在描述符使用完后使用OH_Usb_FreeConfigDescriptor()释放描述符,否则会造成内存泄露。
OH_Usb_FreeConfigDescriptor(const struct UsbDdkConfigDescriptor *const config)释放配置描述符,请在描述符使用完后释放描述符,否则会造成内存泄露。
OH_Usb_ClaimInterface(uint64_t deviceId, uint8_t interfaceIndex, uint64_t *interfaceHandle)声明接口。
OH_Usb_SelectInterfaceSetting(uint64_t interfaceHandle, uint8_t settingIndex)激活接口的备用设置。
OH_Usb_GetCurrentInterfaceSetting(uint64_t interfaceHandle, uint8_t *settingIndex)获取接口当前激活的备用设置。
OH_Usb_SendControlReadRequest(uint64_t interfaceHandle, const struct UsbControlRequestSetup *setup, uint32_t timeout, uint8_t *data, uint32_t *dataLen)发送控制读请求,该接口为同步接口。
OH_Usb_SendControlWriteRequest(uint64_t interfaceHandle, const struct UsbControlRequestSetup *setup, uint32_t, const uint8_t *data, uint32_t dataLen)发送控制写请求,该接口为同步接口。
OH_Usb_ReleaseInterface(uint64_t interfaceHandle)释放接口。
OH_Usb_SendPipeRequest(const struct UsbRequestPipe *pipe, UsbDeviceMemMap *devMmap)发送管道请求,该接口为同步接口。中断传输和批量传输都使用该接口发送请求。
OH_Usb_CreateDeviceMemMap(uint64_t deviceId, size_t size, UsbDeviceMemMap **devMmap)创建缓冲区。请在缓冲区使用完后,调用OH_Usb_DestroyDeviceMemMap()销毁缓冲区,否则会造成资源泄露。
OH_Usb_DestroyDeviceMemMap(UsbDeviceMemMap *devMmap)销毁缓冲区。请在缓冲区使用完后及时销毁缓冲区,否则会造成资源泄露。

开发步骤

以下步骤描述了如何使用 USB DDK开发USB驱动:

添加动态链接库

CMakeLists.txt中添加以下lib。

libusb_ndk.z.so

头文件

#include <usb/usb_ddk_api.h>
#include <usb/usb_ddk_types.h>
  1. 获取设备描述符。

    使用 usb_ddk_api.h 的 OH_Usb_Init 接口初始化DDK,并使用 OH_Usb_GetDeviceDescriptor获取到设备描述符。

    // 初始化USB DDK
    OH_Usb_Init();
    struct UsbDeviceDescriptor devDesc;
    uint64_t deviceId = 0;
    // 获取设备描述符
    OH_Usb_GetDeviceDescriptor(deviceId, &devDesc);
  2. 获取配置描述符及声明接口。

    使用 usb_ddk_api.h 的 OH_Usb_GetConfigDescriptor 接口获取配置描述符 config,并使用 OH_Usb_ClaimInterface 声明"认领"接口。。

    struct UsbDdkConfigDescriptor *config = nullptr;
    // 获取配置描述符
    OH_Usb_GetConfigDescriptor(deviceId, 1, &config);
    // 根据配置描述符,找到所需要通信的interfaceIndex
    uint8_t interfaceIndex = 0;
    // 声明接口
    uint64_t interfaceHandle = 0;
    OH_Usb_ClaimInterface(deviceId, interfaceIndex, &interfaceHandle);
    // 释放配置描述符
    OH_Usb_FreeConfigDescriptor(config);
  3. 获取当前激活接口的备用设置及激活备用设置。

    使用 usb_ddk_api.h 的 OH_Usb_GetCurrentInterfaceSetting 获取备用设置,并使用 OH_Usb_SelectInterfaceSetting 激活备用设置

    uint8_t settingIndex = 0;
    // 接口获取备用设置
    OH_Usb_GetCurrentInterfaceSetting(interfaceHandle, &settingIndex);
    
    // 激活备用设置
    OH_Usb_SelectInterfaceSetting(interfaceHandle, &settingIndex);
  4. 发送控制读请求、发送控制写请求。

    使用 usb_ddk_api.h 的OH_Usb_SendControlReadRequest发送控制读请求,或者使用OH_Usb_SendControlWriteRequest发送控制写请求。

        // 超时时间,设置为1s;
    uint32_t timeout = 1000;
    
    struct UsbControlRequestSetup setupRead;
    setupRead.bmRequestType    = 0x80;
    setupRead.bRequest = 0x08;
    setupRead.wValue = 0;
    setupRead.wIndex = 0;
    setupRead.wLength = 0x01;
    uint8_t dataRead[256] = {0};
    uint32_t dataReadLen = 256;
    // 发送控制读请求
    OH_Usb_SendControlReadRequest(interfaceHandle, &setupRead, timeout, dataRead, &dataReadLen);
    
    struct UsbControlRequestSetup setupWrite;
    setupWrite.bmRequestType = 0;
    setupWrite.bRequest = 0x09;
    setupWrite.wValue = 1;
    setupWrite.wIndex = 0;
    setupWrite.wLength = 0;
    uint8_t dataWrite[256] = {0};
    uint32_t dataWriteLen = 256;
    // 发送控制写请求
    OH_Usb_SendControlWriteRequest(interfaceHandle, &setupWrite, timeout, dataWrite, &dataWriteLen);
  5. 创建内存映射缓冲区及发送请求。

    使用 usb_ddk_api.h 的OH_Usb_CreateDeviceMemMap接口创建内存映射缓冲区devMmap,并使用OH_Usb_SendPipeRequest发送请求。

    struct UsbDeviceMemMap *devMmap = nullptr;
    // 创建用于存放数据的缓冲区
    size_t bufferLen = 10;
    OH_Usb_CreateDeviceMemMap(deviceId, bufferLen, &devMmap);
    struct UsbRequestPipe pipe;
    pipe.interfaceHandle = interfaceHandle;
    // 根据配置描述符找到所要通信的端点
    pipe.endpoint = 128;
    pipe.timeout = UINT32_MAX;
    // 发送请求
    OH_Usb_SendPipeRequest(&pipe, devMmap);
  6. 释放资源。

    在所有请求处理完毕,程序退出前,使用 usb_ddk_api.h 的 OH_Usb_DestroyDeviceMemMap 接口销毁缓冲区。使用OH_Usb_ReleaseInterface释放接口。使用OH_Usb_Release释放USB DDK。

    // 销毁缓冲区
    OH_Usb_DestroyDeviceMemMap(devMmap);
    // 释放接口
    OH_Usb_ReleaseInterface(interfaceHandle);
    // 释放USB DDK
    OH_Usb_Release();

鸿蒙HarmonyOS应用开发之USB DDK开发指导 USB DDK(USB Driver Develop Kit)是为开发者提供的USB驱动程序开发套件,支持开发者基于用户态,在应用层开发USB设备驱动。提供了一系列主机侧访问设备的接口,包括主机侧打开和关闭接口、管道同步异步读写通信、控制传输、中断传输等。 阅读详情

相关推荐

Harmony鸿蒙南向外设驱动开发-USB

USB(Universal Serial Bus)通用串行总线,包含了主机端(Host)和设备端(Device)。

m0_64420071的博客 2413

开发WDM型USB设备驱动程序(二)

USB设备驱动程序开发工具  开发USB设备驱动程序需要专门的开发工具,目前应用广泛的工具主要有两大类。  一类是Microsoft公司提供的Windows DDK(Device Driver Kit)。它有Windows 98 DDK和Windows 2000 DDK两个版本。Windows 98 DDK能够开发Windows 95/98/Me/NT下的VxD、KMD和WDM驱动程序。Windo

千金甜果的专栏 3589

鸿蒙HarmonyOS开发:USB DDK驱动程序开发套件

USB DDK(USB Driver Develop Kit)是为开发者提供的USB驱动程序开发套件,支持开发者基于用户态,在应用层开发USB设备驱动。

wqad23256的博客 909

纯血鸿蒙适配实战:工业IDE ETest的驱动重构与性能验证

嵌入式开发中,工业IDE需直接操作串口、网口、USB等底层硬件,而鸿蒙微内核与分布式软总线机制对设备访问模型进行了重构。传统基于POSIX的通信抽象层无法直接复用,必须通过HDF驱动框架重新实现设备发现、权限申请与数据归一化。这一适配过程不仅解决了国产操作系统下工业工具链的可用性问题,更在汽车嵌入式、蓝桥杯嵌入式等场景中验证了端到端延迟与稳定性。ETest完成纯血鸿蒙PC版适配,正是从驱动层重构切入,为嵌入式测试工具链的国产化替代提供了可复现的工程实践。

weixin_34056162的博客 323

鸿蒙面试必问:在多线程环境下,使用USB DDK开发USB驱动需要注意哪些问题?

要注意一下这些问题................

m0_69424697的博客 662

鸿蒙面试必问:在使用USB DDK开发USB驱动时,OH_Usb_Init接口的功能是什么,在什么阶段调用?

OH_Usb_Init接口的功能是..............

m0_69424697的博客 731

OpenHarmony开发之——USB驱动

USB Host DDK:负责提供用户态第三方功能驱动的USB设备数据读写接口、向内核USB驱动框架注册的设备插拔时间通知接口和移除USB逻辑设备的接口;图 1USB仓HOST侧相关模块逻辑视图USB Device DDK:负责创建和删除USB设备,接口的事件获取、打开、关闭等,管道同步异步读写通信、设置USB自定义属性等;图 2USB仓Device侧相关模块逻辑视图。

m0_71263309的博客 1824

OpenHarmony usb打开报错“usb fail error code = -3, error msg = LIBUSB_ERROR_ACCESS”

一、前言:最近公司项目需求,定位要求使用国产系统,国产系统无非就是 统信os ,麒麟OS, 还有这两年比较热的 OpenHarmony。执行命令,可以查看当前OpenHarmony 系统中,所有usb 设备,具体区分是哪一个设备,通过设备的id 可以知道。解决上述问题,需要改变找到设备对应的USB 设备的节点,然后使用 linux 命令手动修改权限。2.1 在OpenHarmony 中,使用命令行工具是 hdc.exe。二、在开发中使用 usb 通讯时,遇到 权限不足,一直报错。

gd6321374的专栏 1024

HarmonyOS USB DDK助你轻松实现USB驱动开发

HDF(Hardware Driver Foundation)驱动框架是HarmonyOS硬件生态开放的基础,为开发者提供了驱动加载、驱动服务管理和驱动消息机制等驱动能力,让开发者能精准且高效地开发驱动程序。 本期,我们将为大家带来HDF驱动框架中USB DDK的解析与指导。 一、USB DDK介绍 USB(Universal Serial Bus)通用串行总线,用于规范电脑与外部设备的连接和通讯,包含了主机端(Host)和设备端(Device)。其中,主机端负责USB总线中的数据传输及端口

HarmonyOSDev的博客 2642

鸿蒙HarmonyOS应用开发之HID DDK开发指导

HID DDK(HID Driver Develop Kit)是为开发者提供的HID设备驱动程序开发套件,支持开发者基于用户态,在应用层开发HID设备驱动。提供了一系列主机侧访问设备的接口,包括创建设备、向设备发送事件、销毁设备。

1 1035

OpenHarmony的USB框架

这里的设备是逻辑设备,对于usb来说就是接口驱动。状态通知:fill:#333;color:#333;color:#333;fill:none;插入通知HdfSBuf接口读写设备结点设备usb busHDF内核驱动服务HDF用户态驱动服务HDIAPPUeventd创建设备结点数据通讯:fill:#333;color:#333;color:#333;fill:none;主设备号次设备号APP设备结点bus usb设备。

myxuan475的专栏 3022

【OpenHarmony】USB服务组件

USB Manager模块是OpenHarmony系统中负责USB设备管理的核心服务模块,采用分层架构设计,主要提供四大功能:USB Host设备管理(设备枚举、数据传输)、USB Device功能切换(ACM/ECM/HDC等模式)、USB端口角色管理以及串口设备控制。模块采用单例模式、观察者模式等设计模式,通过SystemAbility方式运行,与驱动子系统、权限管理、公共事件服务等模块交互。

fakerth的博客 1468

深入解析OpenHarmony USB DDK通信机制:从架构到实战

OpenHarmony USB DDK(Device Development Kit)是OpenHarmony系统提供的USB设备开发工具包,为开发者提供了一套完整的USB设备驱动开发接口。本文档专注于OpenHarmony系统中的USB DDK通信机制,详细介绍其架构、核心组件、通信流程及实现方法。OpenHarmony USB DDK支持主机(Host)和设备(Device)两种模式,本文主要关注主机模式的通信实现。RAW API:底层接口,提供更直接的USB访问能力。

m0_67505153的博客 397

嵌入式linux/鸿蒙开发板(IMX6ULL)开发(三)配置网络环境

文章目录1.使用USB网卡直连配置网络1.1 连接方式介绍1.1.1 硬件资源列表1.1.2 连接方式1.2 系统IP配置1.2.1 windows配置1.2.2 常见问题1.2.3 vmware配置1.2.4 ubuntu配置1.2.5 开发板设置IP地址1.3 三者互ping验证1.3.1 windows ping ubuntu1.3.2 开发板ping windows 和 ubuntu1.3.3 windows 和 ubuntu ping 开发板1.4 开发板使用网络服务1.4.1 文件系统内使用nf

da.的博客 6472

HarmonyOS鸿蒙开发指南:基于ArkTS开发 设备管理 USB服务

USB服务是应用访问底层的一种设备抽象概念。开发者根据提供的USB API,可以获取设备列表、控制设备访问权限、以及与连接的设备进行数据传输、控制命令传输等。Host模式下,可以获取到已经连接的设备列表,并根据需要打开和关闭设备、控制设备权限、进行数据传输等。

斌擎科技 1548

usb ddk 读写usb

ddk_usb,学习的好东西. DDK后通过调用API读写函数,进行USB通讯.

OpenHarmony外设驱动使用 (十五),USB

USB(Universal Serial Bus)通用串行总线,包含了主机端(Host)和设备端(Device)。主机端负责USB总线中的数据传输及端口管理,设备端则可以连接各种外设,所以USB驱动开发又分为主机端驱动开发和设备端驱动开发。OpenHarmony系统USB模块支持USB业务的开发,提供USB相关的功能,提供用户态第三方功能驱动的USB设备数据读写接口,以及提供创建和删除USB设备,接口的事件获取、打开和关闭等,管道同步异步读写通信,设置USB自定义属性等。

__Benco的博客 1554

基于python的排课表系统,用python编写排课系统

实现一个具体的课程管理系统。(5) 学生可以查看自己选上的课的成绩,以及各个课程的得分、绩点,并给出其平均绩点,但不允许查看年级其他人的成绩。(2) 学生定制专属课表,可以查看整个学期本人的课程安排,包括课程名称、上课时间、上课地点、任课老师、学分等等。(13) 系主任可以查看整个系的全部学生以及他们的平均绩点,可以对每个班进行排名,或者也可以对整个系进行排名。(15) 系主任可以查看整个学期所开设的所有课程,包括这些课程的全部详细信息。(1) 学生基本信息的查询,学生可以对本人的系统登陆密码进行修改。

yang0728y的博客 2000

应用程序利用libusb读取usb设备数据

应用程序利用libusb读取usb设备数据 应用程序利用libusb读取usb设备数据 应用程序利用libusb读取usb设备数据

weixin_55163060的博客 4839

STM32F103C8T6 Bootloader开发实战:串口IAP固件升级与Keil工程配置详解

本文详细介绍了STM32F103C8T6 Bootloader开发实战,重点讲解串口IAP固件升级的实现方法与Keil uVision5工程配置。通过Flash分区管理、USART1通信协议设计及应用程序跳转机制等核心技术,帮助开发者掌握嵌入式系统固件升级方案,提升设备维护效率。

weixin_29165725的博客 437

TMS320F280049C 学习笔记11 控制率加速器 CLA 例程

总结了TI官方在C2000Ware_3_01_00_00版本中提供的7个与CLA相关的例程。

whyorwhnt的专栏 1万+
上一篇: 鸿蒙5.0开发进阶:NDK开发-内存管理purgeable内存开发指南
下一篇: 鸿蒙5.0开发进阶:NDK开发-HID DDK开发指南
懂你的大海
博客等级 码龄6年 9049粉丝 1381原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值