USB Service Development

When to Use

In Host mode, you can obtain the list of connected USB devices, enable or disable the devices, manage device access permissions, and perform data transfer or control transfer.

Available APIs

The USB service provides the following functions: query of USB device list, bulk data transfer, control transfer, and access permission management.

The following table lists the USB APIs currently available. For details, see the API Reference.

Table 1 Open USB APIs

How to Develop

You can set a USB device as a host to connect to a device for data transfer. The development procedure is as follows:

1. Obtain the USB device list.

   // Import the USB API package.
   import { usbManager } from '@kit.BasicServicesKit';
   // Obtain the USB device list.
   let deviceList : Array<usbManager.USBDevice> = usbManager.getDevices();
   /*
   Example deviceList structure:
   [
     {
       name: "1-1",
       serial: "",
       manufacturerName: "",
       productName: "",
       version: "",
       vendorId: 7531,
       productId: 2,
       clazz: 9,
       subClass: 0,
       protocol: 1,
       devAddress: 1,
       busNum: 1,
       configs: [
         {
           id: 1,
           attributes: 224,
           isRemoteWakeup: true,
           isSelfPowered: true,
           maxPower: 0,
           name: "1-1",
           interfaces: [
             {
               id: 0,
               protocol: 0,
               clazz: 9,
               subClass: 0,
               alternateSetting: 0,
               name: "1-1",
               endpoints: [
                 {
                   address: 129,
                   attributes: 3,
                   interval: 12,
                   maxPacketSize: 4,
                   direction: 128,
                   number: 1,
                   type: 3,
                   interfaceId: 0,
                 }
               ]
             }
           ]
         }
       ]
     }
   ]
   */

1. Obtain the device operation permissions.

   import { usbManager } from '@kit.BasicServicesKit';
   import { BusinessError } from '@kit.BasicServicesKit';

   let deviceName : string = deviceList[0].name;
   // Request the permissions to operate a specified device.
   usbManager.requestRight(deviceName).then((hasRight : boolean) => {
     console.info("usb device request right result: " + hasRight);
   }).catch((error : BusinessError)=> {
     console.info("usb device request right failed : " + error);
   });

1. Open the device.

   // Open the device, and obtain the USB device pipe for data transfer.
   let pipe : usbManager.USBDevicePipe = usbManager.connectDevice(deviceList[0]);
   let interface1 : usbManager.USBInterface = deviceList[0].configs[0].interfaces[0];
   /*
    Claim the corresponding interface from **deviceList**.
   interface1 must be one present in the device configuration.
   */
   usbManager.claimInterface(pipe, interface1, true);

1. Perform data transfer. Currently, only bulk transfer and control transfer are supported.

   • Bulk transfer

   import { usbManager } from '@kit.BasicServicesKit';
   import { BusinessError } from '@kit.BasicServicesKit';
   /*
     Read data. Select the corresponding RX endpoint from deviceList for data transfer.
   (endpoint.direction == 0x80); dataUint8Array indicates the data to read. The data type is Uint8Array.
   */
   let inEndpoint : usbManager.USBEndpoint = interface1.endpoints[2];
   let outEndpoint : usbManager.USBEndpoint = interface1.endpoints[1];
   let dataUint8Array : Uint8Array = new Uint8Array(1024);
   usbManager.bulkTransfer(pipe, inEndpoint, dataUint8Array, 15000).then((dataLength : number) => {
   if (dataLength >= 0) {
     console.info("usb readData result Length : " + dataLength);
   } else {
     console.info("usb readData failed : " + dataLength);
   }
   }).catch((error : BusinessError) => {
   console.info("usb readData error : " + JSON.stringify(error));
   });
   // Send data. Select the corresponding TX endpoint from deviceList for data transfer. (endpoint.direction == 0)
   usbManager.bulkTransfer(pipe, outEndpoint, dataUint8Array, 15000).then((dataLength : number) => {
     if (dataLength >= 0) {
       console.info("usb writeData result write length : " + dataLength);
     } else {
       console.info("writeData failed");
     }
   }).catch((error : BusinessError) => {
     console.info("usb writeData error : " + JSON.stringify(error));
   });
   

   • Control transfer

   import { usbManager } from '@kit.BasicServicesKit';
   import { BusinessError } from '@kit.BasicServicesKit';
   
   
   /*
     Construct control transfer parameters.
   */
   let param: usbManager.USBDeviceRequestParams = {
     bmRequestType: 0x80,    // 0x80 indicates a standard request for data transfer from the device to the host.
     bRequest: 0x06,    // 0x06 indicates a request for the descriptor.
     wValue:0x01 << 8|0,    // The value is of two bytes. The high byte indicates the descriptor type. Here, 0x01 indicates the device descriptor. The low byte indicates the descriptor index. The value is set to 0 because it is not involved for the device descriptor.
     wIndex: 0,    // Descriptor index. The value can be 0.
     wLength: 18,    // Descriptor length. The value 18 indicates that a maximum of 1024 characters are supported.
     data: new Uint8Array(18)
   };
   
   
   usbManager.usbControlTransfer(pipe, param).then((ret: number) => {
   console.info("usbControlTransfer = ${ret}");
   })
   

2. Release the USB interface, and close the USB device.

   usbManager.releaseInterface(pipe, interface1);
   usbManager.closePipe(pipe);

你可能感兴趣的鸿蒙文章

harmony 鸿蒙USB Service

harmony 鸿蒙FAQs

harmony 鸿蒙USB Service Terms

harmony 鸿蒙USB Service Overview