@ohos.driver.deviceManager (Peripheral Management) (System API)

The deviceManager module provides the functions of managing peripheral devices, including querying information about peripherals and their drivers.

NOTE

The initial APIs of this module are supported since API version 12. Newly added APIs will be marked with a superscript to indicate their earliest API version. This topic describes only system APIs provided by the module. For details about its public APIs, see @ohos.driver.deviceManager (Peripheral Management).

Modules to Import

import { deviceManager } from '@kit.DriverDevelopmentKit';

deviceManager.queryDeviceInfo

queryDeviceInfo(deviceId?: number): Array<Readonly<DeviceInfo>>

Obtains the list of detailed information about peripherals. If the device has no peripheral device connected, an empty list is returned.

System API: This is a system API.

Required permissions: ohos.permission.ACCESS_EXTENSIONAL_DEVICE_DRIVER

System capability: SystemCapability.Driver.ExternalDevice

Parameters

Name	Type	Mandatory	Description
deviceId	number	No	Device ID, which is obtained through queryDevices. If no device ID is passed, all device information is obtained by default. If no external device is connected and no device ID is passed, an empty array is returned.

Return value

Type	Description
Array<Readonly<DeviceInfo>>	List of detailed information about peripherals.

Error codes

For details about the error codes, see Universal Error Codes and Driver Error Codes.

ID	Error Message
201	The permission check failed.
202	Permission denied. A non-system application cannot call a system API.
401	Parameter error. Possible causes: 1.Incorrect parameter types.
26300001	ExternalDeviceManager service exception.

Example

import { deviceManager } from '@kit.DriverDevelopmentKit';
import { BusinessError } from '@kit.BasicServicesKit';

try {
  // For example, deviceId is 12345678. You can use queryDevices() to obtain the deviceId.
  let deviceInfos : Array<deviceManager.DeviceInfo> = deviceManager.queryDeviceInfo(12345678);
  for (let item of deviceInfos) {
    console.info(`Device id is ${item.deviceId}`)
  }
} catch (error) {
  let err: BusinessError = error as BusinessError;
  console.error(`Failed to query device info. Code is ${err.code}, message is ${err.message}`);
}

deviceManager.queryDriverInfo

queryDriverInfo(driverUid?: string): Array<Readonly<DriverInfo>>

Obtains the list of detailed information about peripheral drivers. If the device has no peripheral device connected, an empty list is returned.

System API: This is a system API.

Required permissions: ohos.permission.ACCESS_EXTENSIONAL_DEVICE_DRIVER

System capability: SystemCapability.Driver.ExternalDevice

Parameters

Name	Type	Mandatory	Description
driverUid	string	No	Driver UID, which can be obtained by using queryDeviceInfo.

Return value

Type	Description
Array<Readonly<DriverInfo>>	List of detailed information about peripheral drivers.

Error codes

For details about the error codes, see Universal Error Codes and Driver Error Codes.

ID	Error Message
201	The permission check failed.
202	Permission denied. A non-system application cannot call a system API.
401	Parameter error. Possible causes: 1.Incorrect parameter types.
26300001	ExternalDeviceManager service exception.

Example

import { deviceManager } from '@kit.DriverDevelopmentKit';
import { BusinessError } from '@kit.BasicServicesKit';

try {
  // In this example, driver-12345 is the driver UID. During application development, you can use queryDeviceInfo to query the driver UID and use it as the input parameter.
  let driverInfos : Array<deviceManager.DriverInfo> = deviceManager.queryDriverInfo("driver-12345");
  for (let item of driverInfos) {
    console.info(`driver name is ${item.driverName}`)
  }
} catch (error) {
  let err: BusinessError = error as BusinessError;
  console.error(`Failed to query driver info. Code is ${err.code}, message is ${err.message}`);
}

DeviceInfo

Defines the detailed information about a device.

System API: This is a system API.

System capability: SystemCapability.Driver.ExternalDevice

Name	Type	Read-Only	Optional	Description
deviceId	number	No	No	Device ID.
isDriverMatched	boolean	No	No	Whether the device matches the driver. The value true indicates the device matches the driver, and the value false indicates the opposite.
driverUid	string	No	Yes	UID of the driver matching the device.

USBDeviceInfo

Defines detailed information about the USB device. It is inherited from DeviceInfo.

System API: This is a system API.

System capability: SystemCapability.Driver.ExternalDevice

Name	Type	Read-Only	Optional	Description
vendorId	number	No	No	Vendor ID of the USB device.
productId	number	No	No	Product ID of the USB device.
interfaceDescList	Array<Readonly<USBInterfaceDesc>>	Yes	No	List of interface descriptors of the USB device.

USBInterfaceDesc

Defines the interface descriptor of a USB device.

System API: This is a system API.

System capability: SystemCapability.Driver.ExternalDevice

Name	Type	Read-Only	Optional	Description
bInterfaceNumber	number	No	No	Interface ID.
bClass	number	No	No	Interface class.
bSubClass	number	No	No	Interface subclass.
bProtocol	number	No	No	Interface protocol.

DriverInfo

Defines detailed information about a driver.

System API: This is a system API.

System capability: SystemCapability.Driver.ExternalDevice

Name	Type	Read-Only	Optional	Description
busType	BusType	No	No	Bus type.
driverUid	string	No	No	Driver UID.
driverName	string	No	No	Driver name.
driverVersion	string	No	No	Driver version.
driverSize	string	No	No	Driver size, in bytes.
description	string	No	No	Driver description.

USBDriverInfo

Defines detailed information about the USB device driver. It is inherited from DriverInfo.

System API: This is a system API.

System capability: SystemCapability.Driver.ExternalDevice

Name	Type	Read-Only	Optional	Description
productIdList	Array<number>	No	No	Product ID list of the USB devices supported by the driver.
vendorIdList	Array<number>	No	No	Vendor ID list of the USB devices supported by the driver.