驱动开发服务

介绍

本示例主要展示了通过DriverDevelopmentKit开发套件中USB Serial DDK开发驱动服务，使用@ohos.driver.deviceManager 、@ohos.app.ability.DriverExtensionAbility 、@ohos.rpc、USB Serial DDK 等接口，实现了整个USB转串口设备驱动功能，包括USB转串口设备UI参数设置界面及驱动服务端。其中UI参数界面包括串口设备、温度显示，驱动服务端通过客户端绑定拉起，驱动服务端主要给UI参数界面提供接口及与物理设备通信;

效果预览

主页(串口设置)	温度显示

使用说明

1. 安装该示例应用后，当目标设备插入时，扩展外设驱动服务SA会拉起DriverExtensionAbility相关进程（即：驱动服务端）
2. 在主界面绘制完成后，会调用deviceManager的绑定接口，绑定驱动服务端，成功后主界面会显示“设备已连接”；
3. 主界面用户可以填USB Serial通信相关参数，打开设备；
4. 温度显示界面，用户可以设置超时时间，读取温度，界面会通过服务端与设备通信；
5. 退出按钮，退出驱动界面。

工程目录

给出项目中关键的目录结构并描述它们的作用，示例如下：

entry/src/main/ets
|---components
|   |---SerialPortComponent.ets            //“串口设置”部件页面构造
|   |---TempShowComponent.ets             //“温度显示”部件页面构造
|---DriverAbility
|   |---driver.ts                          //主要重载了继承驱动扩展能力DriverExtensionAbility，Onit初始化USB接口等
|---entryability
|   |---EntryAbility.ets                   //界面ability
|---pages
|   |---Index.ets                          //应用首页
|---tool
|   |---GlobalContext.ets                  //用于上下文存储单例对象工具
|   |---RpcTool.ets                        //主要封装了扩展外设相关接口，实现相关功能，如：查询设备，绑定设备，连接远程对象等
|   |---ObserverManager.ets                //观察者管理类
|   |---SerialPortStatusManager.ets        //串口状态管理类
|   |---TemperatureStatusManager.ets       //温度显示管理类
entry/src/main/cpp
|---types
|   |---libentry                           //创建native c++工程，自动生成的文件目录
|---hello.cpp                              //主要封装了UsbSerial驱动相关接口，实现相关功能，如：设置波特率、读写等功能
|---data_parser.cpp                        //主要封装了UsbSerial物理设备与系统通信数据转换功能
|---data_parser.h                          //申明UsbSerial物理设备与系统通信数据转换接口

具体实现

• 驱动UI界面，功能包括查询设备列表、绑定设备驱动服务端、与设备驱动服务端通信，源码参考：Index.ets

  • 使用deviceManager.queryDevices来获取设备列表;
  • 通过deviceManager.bindDeviceDriver来绑定设备驱动服务端，通过返回值拿到驱动服务端实例;
  • 通过服务端实例调用sendMessageRequest与设备驱动服务端通信，并获取到服务端回应，将回应数据打印到主界面;

• 驱动服务端，与驱动UI界面通信，源码参考：driver.ts

  • 当物理设备插入后，UI界面通过bindDeviceDriver接口获取到驱动服务端实例，再通过服务端实例与服务端通信；
  • 驱动服务拉起后，会调用DriverExtAbility中onInit方法，可以在此方法中通过Napi接口调用CAPI，初始化USB DDK等
  • 驱动UI界面通过deviceManager调用绑定接口，会调用DriverExtAbility中onConnect返回服务端实例
  • 驱动UI界面通过服务端实例与服务端通信，服务端通过Napi接口调用CAPI，与物理设备通信

相关权限

ohos.permission.ACCESS_EXTENSIONAL_DEVICE_DRIVER ohos.permission.ACCESS_DDK_USB_SERIAL

约束与限制

1. 本示例仅支持标准系统上运行，支持设备：RK3568;
2. 本示例为Stage模型，仅支持API18版本SDK，SDK版本号(API Version 18),镜像版本号(5.1Release)
3. 本示例需要使用DevEco Studio 版本号(6.0Release)版本才可编译运行。

下载

如需单独下载本工程，执行如下命令：

git init
git config core.sparsecheckout true
echo code/DocsSample/DriverDevelopmentKit > .git/info/sparse-checkout
git remote add origin https://gitee.com/openharmony/applications_app_samples.git
git pull origin master