openharmony/interface_sdk-js
1
0
Fork 0
mirror of https://gitee.com/openharmony/interface_sdk-js synced 2024-11-23 07:10:52 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
master
interface_sdk-js/api/@ohos.usbManager.d.ts
梁琦 d7f8257bbe
update api/@ohos.usbManager.d.ts. 
Signed-off-by: 梁琦 <liangqi28@huawei.com>
2024-11-02 10:08:11 +00:00

1598 lines
47 KiB
TypeScript
Raw Permalink Blame History

/*
* Copyright (c) 2023-2024 Huawei Device Co., Ltd.
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* @file
* @kit BasicServicesKit
*/
/**
* This module provides the capability of manage USB device.
*
* @namespace usbManager
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
declare namespace usbManager {
/**
* Obtains the USB device list.
*
* @returns { Array<Readonly<USBDevice>> } USB device list.
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
function getDevices(): Array<Readonly<USBDevice>>;
/**
* Connects to the USB device based on the device information returned by getDevices().
*
* @param { USBDevice } device - USB device on the device list returned by getDevices(). It cannot be empty.
* @returns { Readonly<USBDevicePipe> } object for data transfer.
* @throws { BusinessError } 401 - Parameter error. Possible causes:
* <br>1.Mandatory parameters are left unspecified.
* <br>2.Incorrect parameter types.
* @throws { BusinessError } 14400001 - Permission denied. Call requestRight to get the permission first.
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
function connectDevice(device: USBDevice): Readonly<USBDevicePipe>;
/**
* Checks whether the application has the permission to access the device.
*
* @param { string } deviceName - device name defined by USBDevice.name. It cannot be empty.
* @returns { boolean } indicates if the user has the permission to access the device.
* @throws { BusinessError } 401 - Parameter error. Possible causes:
* <br>1.Mandatory parameters are left unspecified.
* <br>2.Incorrect parameter types.
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
function hasRight(deviceName: string): boolean;
/**
* Requests the permission for a given application to access the USB device.
* The system application has access to the device by default, and there is no need to call this interface to apply.
*
* @param { string } deviceName - device name defined by USBDevice.name. It cannot be empty.
* @returns { Promise<boolean> } indicates if the device access permissions are granted.
* @throws { BusinessError } 401 - Parameter error. Possible causes:
* <br>1.Mandatory parameters are left unspecified.
* <br>2.Incorrect parameter types.
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
function requestRight(deviceName: string): Promise<boolean>;
/**
* Remove the permission for a given application to access the USB device.
* The system application has access to the device by default, and calling this interface will not have any impact.
*
* @param { string } deviceName - device name defined by USBDevice.name. It cannot be empty.
* @returns { boolean } indicates if the device access permissions are removed.
* @throws { BusinessError } 401 - Parameter error. Possible causes:
* <br>1.Mandatory parameters are left unspecified.
* <br>2.Incorrect parameter types.
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
function removeRight(deviceName: string): boolean;
/**
* Add device access permission.
* The system application has access to the device by default, and calling this interface will not have any impact.
*
* @param { string } bundleName - refers to application that require access permissions. It cannot be empty.
* @param { string } deviceName - device name defined by USBDevice.name. It cannot be empty.
* @returns { boolean } value to indicate whether the permission is granted.
* @throws { BusinessError } 401 - Parameter error. Possible causes:
* <br>1.Mandatory parameters are left unspecified.
* <br>2.Incorrect parameter types.
* @syscap SystemCapability.USB.USBManager
* @systemapi
* @since 9
* @deprecated since 12
* @useinstead ohos.usbManager/usbManager#addDeviceAccessRight
*/
function addRight(bundleName: string, deviceName: string): boolean;
/**
* Converts the string descriptor of a given USB function list to a numeric mask combination.
*
* @param { string } funcs - descriptor of the supported function list. It cannot be empty.
* @returns { number } the numeric mask combination of the function list.
* @throws { BusinessError } 401 - Parameter error. Possible causes:
* <br>1.Mandatory parameters are left unspecified.
* <br>2.Incorrect parameter types.
* @syscap SystemCapability.USB.USBManager
* @systemapi
* @since 9
* @deprecated since 12
* @useinstead ohos.usbManager/usbManager#getFunctionsFromString
*/
function usbFunctionsFromString(funcs: string): number;
/**
* Converts the numeric mask combination of a given USB function list to a string descriptor.
*
* @param { FunctionType } funcs - numeric mask combination of the function list. The type of funcs must be number. It cannot be empty.
* @returns { string } - descriptor of the supported function list.
* @throws { BusinessError } 401 - Parameter error. Possible causes:
* <br>1.Mandatory parameters are left unspecified.
* <br>2.Incorrect parameter types.
* @syscap SystemCapability.USB.USBManager
* @systemapi
* @since 9
* @deprecated since 12
* @useinstead ohos.usbManager/usbManager#getStringFromFunctions
*/
function usbFunctionsToString(funcs: FunctionType): string;
/**
* Sets the current USB function list in Device mode.
*
* @param { FunctionType } funcs - numeric mask combination of the supported function list. It cannot be empty.
* @returns { Promise<void> } the promise returned by the function.
* @throws { BusinessError } 401 - Parameter error. Possible causes:
* <br>1.Mandatory parameters are left unspecified.
* <br>2.Incorrect parameter types.
* @throws { BusinessError } 14400002 - Permission denied. The HDC is disabled by the system.
* @syscap SystemCapability.USB.USBManager
* @systemapi
* @since 9
* @deprecated since 12
* @useinstead ohos.usbManager/usbManager#setDeviceFunctions
*/
function setCurrentFunctions(funcs: FunctionType): Promise<void>;
/**
* Obtains the numeric mask combination for the current USB function list in Device mode.
*
* @returns { FunctionType } the numeric mask combination for the current USB function list in FunctionType.
* @syscap SystemCapability.USB.USBManager
* @systemapi
* @since 9
* @deprecated since 12
* @useinstead ohos.usbManager/usbManager#getDeviceFunctions
*/
function getCurrentFunctions(): FunctionType;
/* usb port functions begin */
/**
* Obtains the USBPort list.
*
* @returns { Array<USBPort> } the USBPort list.
* @syscap SystemCapability.USB.USBManager
* @systemapi
* @since 9
* @deprecated since 12
* @useinstead ohos.usbManager/usbManager#getPortList
*/
function getPorts(): Array<USBPort>;
/**
* Gets the mask combination for the supported mode list of the specified USBPort.
*
* @param { number } portId - unique ID of the port. It cannot be empty.
* @returns { PortModeType } the mask combination for the supported mode list in PortModeType.
* @throws { BusinessError } 401 - Parameter error. Possible causes:
* <br>1.Mandatory parameters are left unspecified.
* <br>2.Incorrect parameter types.
* @syscap SystemCapability.USB.USBManager
* @systemapi
* @since 9
* @deprecated since 12
* @useinstead ohos.usbManager/usbManager#getPortSupportModes
*/
function getSupportedModes(portId: number): PortModeType;
/**
* Sets the role types supported by the specified USBPort, which can be powerRole (for charging) and dataRole (for data transfer).
*
* @param { number } portId - unique ID of the port. It cannot be empty.
* @param { PowerRoleType } powerRole - charging role. It cannot be empty.
* @param { DataRoleType } dataRole - data role. It cannot be empty.
* @returns { Promise<void> } the promise returned by the function.
* @throws { BusinessError } 401 - Parameter error. Possible causes:
* <br>1.Mandatory parameters are left unspecified.
* <br>2.Incorrect parameter types.
* @syscap SystemCapability.USB.USBManager
* @systemapi
* @since 9
* @deprecated since 12
* @useinstead ohos.usbManager/usbManager#setPortRoleTypes
*/
function setPortRoles(portId: number, powerRole: PowerRoleType, dataRole: DataRoleType): Promise<void>;
/**
* Add USB device access right.
* The system application has access to the device by default, and calling this interface will not have any impact.
*
* @permission ohos.permission.MANAGE_USB_CONFIG
* @param { string } tokenId - refers to application that require access permissions. It cannot be empty.
* @param { string } deviceName - device name defined by USBDevice.name. It cannot be empty.
* @returns { boolean } value to indicate whether the permission is granted.
* @throws { BusinessError } 401 - Parameter error. Possible causes:
* <br>1.Mandatory parameters are left unspecified.
* <br>2.Incorrect parameter types.
* @throws { BusinessError } 202 - Permission denied. Normal application do not have permission to use system api.
* @syscap SystemCapability.USB.USBManager
* @systemapi
* @since 12
*/
function addDeviceAccessRight(tokenId: string, deviceName: string): boolean;
/**
* Converts the string descriptor of a given USB function list to a numeric mask combination.
*
* @permission ohos.permission.MANAGE_USB_CONFIG
* @param { string } funcs - descriptor of the supported function list. It cannot be empty.
* @returns { number } the numeric mask combination of the function list.
* @throws { BusinessError } 401 - Parameter error. Possible causes:
* <br>1.Mandatory parameters are left unspecified.
* <br>2.Incorrect parameter types.
* @throws { BusinessError } 202 - Permission denied. Normal application do not have permission to use system api.
* @syscap SystemCapability.USB.USBManager
* @systemapi
* @since 12
*/
function getFunctionsFromString(funcs: string): number;
/**
* Converts the numeric mask combination of a given USB function list to a string descriptor.
*
* @permission ohos.permission.MANAGE_USB_CONFIG
* @param { FunctionType } funcs - numeric mask combination of the function list. It cannot be empty.
* @returns { string } - descriptor of the supported function list.
* @throws { BusinessError } 401 - Parameter error. Possible causes:
* <br>1.Mandatory parameters are left unspecified.
* <br>2.Incorrect parameter types.
* @throws { BusinessError } 202 - Permission denied. Normal application do not have permission to use system api.
* @syscap SystemCapability.USB.USBManager
* @systemapi
* @since 12
*/
function getStringFromFunctions(funcs: FunctionType): string;
/**
* Sets the current USB function list in Device mode.
*
* @permission ohos.permission.MANAGE_USB_CONFIG
* @param { FunctionType } funcs - numeric mask combination of the supported function list. It cannot be empty.
* @returns { Promise<void> } the promise returned by the function.
* @throws { BusinessError } 401 - Parameter error. Possible causes:
* <br>1.Mandatory parameters are left unspecified.
* <br>2.Incorrect parameter types.
* @throws { BusinessError } 202 - Permission denied. Normal application do not have permission to use system api.
* @syscap SystemCapability.USB.USBManager
* @systemapi
* @since 12
*/
function setDeviceFunctions(funcs: FunctionType): Promise<void>;
/**
* Obtains the numeric mask combination for the current USB function list in Device mode.
*
* @permission ohos.permission.MANAGE_USB_CONFIG
* @returns { FunctionType } the numeric mask combination for the current USB function list in FunctionType.
* @throws { BusinessError } 202 - Permission denied. Normal application do not have permission to use system api.
* @syscap SystemCapability.USB.USBManager
* @systemapi
* @since 12
*/
function getDeviceFunctions(): FunctionType;
/* usb port functions begin */
/**
* Obtains the USBPort list.
*
* @permission ohos.permission.MANAGE_USB_CONFIG
* @returns { Array<USBPort> } the USBPort list.
* @throws { BusinessError } 202 - Permission denied. Normal application do not have permission to use system api.
* @syscap SystemCapability.USB.USBManager
* @systemapi
* @since 12
*/
function getPortList(): Array<USBPort>;
/**
* Gets the mask combination for the supported mode list of the specified USBPort.
*
* @permission ohos.permission.MANAGE_USB_CONFIG
* @param { number } portId - unique ID of the port. It cannot be empty.
* @returns { PortModeType } the mask combination for the supported mode list in PortModeType.
* @throws { BusinessError } 401 - Parameter error. Possible causes:
* <br>1.Mandatory parameters are left unspecified.
* <br>2.Incorrect parameter types.
* @throws { BusinessError } 202 - Permission denied. Normal application do not have permission to use system api.
* @syscap SystemCapability.USB.USBManager
* @systemapi
* @since 12
*/
function getPortSupportModes(portId: number): PortModeType;
/**
* Sets the role types supported by the specified USBPort, which can be powerRole (for charging) and dataRole (for data transfer).
*
* @permission ohos.permission.MANAGE_USB_CONFIG
* @param { number } portId - unique ID of the port. It cannot be empty.
* @param { PowerRoleType } powerRole - charging role. It cannot be empty.
* @param { DataRoleType } dataRole - data role. It cannot be empty.
* @returns { Promise<void> } the promise returned by the function.
* @throws { BusinessError } 401 - Parameter error. Possible causes:
* <br>1.Mandatory parameters are left unspecified.
* <br>2.Incorrect parameter types.
* @throws { BusinessError } 202 - Permission denied. Normal application do not have permission to use system api.
* @throws { BusinessError } 14400003 - Unsupported operation. The current device does not support port role switching.
* @syscap SystemCapability.USB.USBManager
* @systemapi
* @since 12
*/
function setPortRoleTypes(portId: number, powerRole: PowerRoleType, dataRole: DataRoleType): Promise<void>;
/**
* Adds USB accessory access right.
*
* @permission ohos.permission.MANAGE_USB_CONFIG
* @param { number } tokenId - refers to application that require access permissions. It cannot be empty.
* @param { USBAccessory } accessory - USB accessory. It cannot be empty.
* @throws { BusinessError } 201 - The permission check failed.
* @throws { BusinessError } 202 - Permission denied. Normal application do not have permission to use system api.
* @throws { BusinessError } 401 - Parameter error. Possible causes:
* <br>1. Mandatory parameters are left unspecified.
* <br>2. Incorrect parameter types.
* @throws { BusinessError } 14400004 - Service exception. Possible causes:
* <br>1. No accessory is plugged in.
* @throws { BusinessError } 14400005 - Database operation exception.
* @syscap SystemCapability.USB.USBManager
* @systemapi
* @since 14
*/
function addAccessoryRight(tokenId: number, accessory: USBAccessory): void;
/* usb pipe functions begin */
/**
* Claims a USB interface.
*
* @param { USBDevicePipe } pipe - device pipe, which is used to determine the bus number and device address. It cannot be empty.
* @param { USBInterface } iface - USB interface, which is used to determine the interface to claim. It cannot be empty.
* @param { boolean } [force] - optional parameter that determines whether to forcibly claim the USB interface.
* @returns { number } returns **0** if the USB interface is successfully claimed; returns an error code otherwise.
* @throws { BusinessError } 401 - Parameter error. Possible causes:
* <br>1.Mandatory parameters are left unspecified.
* <br>2.Incorrect parameter types.
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
function claimInterface(pipe: USBDevicePipe, iface: USBInterface, force?: boolean): number;
/**
* Releases a USB interface.
*
* @param { USBDevicePipe } pipe - device pipe, which is used to determine the bus number and device address. It cannot be empty.
* @param { USBInterface } iface - USB interface, which is used to determine the interface to release. It cannot be empty.
* @returns { number } returns **0** if the USB interface is successfully released; returns an error code otherwise.
* @throws { BusinessError } 401 - Parameter error. Possible causes:
* <br>1.Mandatory parameters are left unspecified.
* <br>2.Incorrect parameter types.
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
function releaseInterface(pipe: USBDevicePipe, iface: USBInterface): number;
/**
* Sets the device configuration.
*
* @param { USBDevicePipe } pipe - device pipe, which is used to determine the bus number and device address. It cannot be empty.
* @param { USBConfiguration } config - device configuration. It cannot be empty.
* @returns { number } returns **0** if the device configuration is successfully set; returns an error code otherwise.
* @throws { BusinessError } 401 - Parameter error. Possible causes:
* <br>1.Mandatory parameters are left unspecified.
* <br>2.Incorrect parameter types.
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
function setConfiguration(pipe: USBDevicePipe, config: USBConfiguration): number;
/**
* Sets a USB interface.
*
* @param { USBDevicePipe } pipe - device pipe, which is used to determine the bus number and device address. It cannot be empty.
* @param { USBInterface } iface - USB interface, which is used to determine the interface to set. It cannot be empty.
* @returns { number } returns **0** if the USB interface is successfully set; return an error code otherwise.
* @throws { BusinessError } 401 - Parameter error. Possible causes:
* <br>1.Mandatory parameters are left unspecified.
* <br>2.Incorrect parameter types.
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
function setInterface(pipe: USBDevicePipe, iface: USBInterface): number;
/**
* Obtains the raw USB descriptor.
*
* @param { USBDevicePipe } pipe - device pipe, which is used to determine the bus number and device address. It cannot be empty.
* @returns { Uint8Array } returns the raw descriptor data.
* @throws { BusinessError } 401 - Parameter error. Possible causes:
* <br>1.Mandatory parameters are left unspecified.
* <br>2.Incorrect parameter types.
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
function getRawDescriptor(pipe: USBDevicePipe): Uint8Array;
/**
* Obtains the file descriptor.
*
* @param { USBDevicePipe } pipe - device pipe, which is used to determine the USB device. It cannot be empty.
* @returns { number } returns the file descriptor of the USB device.
* @throws { BusinessError } 401 - Parameter error. Possible causes:
* <br>1.Mandatory parameters are left unspecified.
* <br>2.Incorrect parameter types.
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
function getFileDescriptor(pipe: USBDevicePipe): number;
/**
* Performs control transfer.
*
* @param { USBDevicePipe } pipe - device pipe, which is used to determine the USB device. It cannot be empty.
* @param { USBControlParams } controlparam - control transfer parameters. It cannot be empty.
* @param { number } [timeout] - timeout duration. This parameter is optional. The default value is **0**, indicating no timeout.
* @returns { Promise<number> } returns the size of the transmitted or received data block if the control transfer is successful;
* return -1 if an exception occurs.
* @throws { BusinessError } 401 - Parameter error. Possible causes:
* <br>1.Mandatory parameters are left unspecified.
* <br>2.Incorrect parameter types.
* @syscap SystemCapability.USB.USBManager
* @since 9
* @deprecated since 12
* @useinstead ohos.usbManager/usbManager#usbControlTransfer
*/
function controlTransfer(pipe: USBDevicePipe, controlparam: USBControlParams, timeout?: number): Promise<number>;
/**
* Performs usb control transfer.
*
* @param { USBDevicePipe } pipe - device pipe, which is used to determine the USB device. It cannot be empty.
* @param { USBDeviceRequestParams } requestparam - control transfer parameters. It cannot be empty.
* @param { number } [timeout] - timeout duration. This parameter is optional. The default value is **0**, indicating no timeout.
* @returns { Promise<number> } returns the size of the transmitted or received data block if the control transfer is successful;
* return -1 if an exception occurs.
* @throws { BusinessError } 401 - Parameter error. Possible causes:
* <br>1.Mandatory parameters are left unspecified.
* <br>2.Incorrect parameter types.
* @syscap SystemCapability.USB.USBManager
* @since 12
*/
function usbControlTransfer(pipe: USBDevicePipe, requestparam: USBDeviceRequestParams, timeout?: number): Promise<number>;
/**
* Performs bulk transfer.
*
* @param { USBDevicePipe } pipe - device pipe, which is used to determine the USB device. It cannot be empty.
* @param { USBEndpoint } endpoint - USB endpoint, which is used to determine the USB port for data transfer. It cannot be empty.
* @param { Uint8Array } buffer - buffer for writing or reading data. It cannot be empty.
* @param { number } [timeout] - timeout duration. This parameter is optional. The default value is **0**, indicating no timeout.
* @returns { Promise<number> } the size of the transmitted or received data block if the control transfer is successful;
* return -1 if an exception occurs.
* @throws { BusinessError } 401 - Parameter error. Possible causes:
* <br>1.Mandatory parameters are left unspecified.
* <br>2.Incorrect parameter types.
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
function bulkTransfer(
pipe: USBDevicePipe,
endpoint: USBEndpoint,
buffer: Uint8Array,
timeout?: number
): Promise<number>;
/**
* Closes a USB device pipe.
*
* @param { USBDevicePipe } pipe - device pipe, which is used to determine the USB device. It cannot be empty.
* @returns { number } returns **0** if the USB device pipe is closed successfully; return an error code otherwise.
* @throws { BusinessError } 401 - Parameter error. Possible causes:
* <br>1.Mandatory parameters are left unspecified.
* <br>2.Incorrect parameter types.
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
function closePipe(pipe: USBDevicePipe): number;
/**
* Checks whether the application has the right to access the USB accessory.
*
* @param { USBAccessory } accessory - USB accessory. It cannot be empty.
* @returns { boolean } indicates if the user has the right to access the USB accessory.
* @throws { BusinessError } 401 - Parameter error. Possible causes:
* <br>1. Mandatory parameters are left unspecified.
* <br>2. Incorrect parameter types.
* @throws { BusinessError } 14400004 - Service exception. Possible causes:
* <br>1. No accessory is plugged in.
* @throws { BusinessError } 14400005 - Database operation exception.
* @throws { BusinessError } 14401001 - The target USBAccessory not matched.
* @syscap SystemCapability.USB.USBManager
* @since 14
*/
function hasAccessoryRight(accessory: USBAccessory): boolean;
/**
* Requests the right for a given application to access the USB accessory.
*
* @param { USBAccessory } accessory - USB accessory. It cannot be empty.
* @returns { Promise<boolean> } indicates if the USB accessory access right are granted.
* @throws { BusinessError } 401 - Parameter error. Possible causes:
* <br>1. Mandatory parameters are left unspecified.
* <br>2. Incorrect parameter types.
* @throws { BusinessError } 14400004 - Service exception. Possible causes:
* <br>1. No accessory is plugged in.
* @throws { BusinessError } 14400005 - Database operation exception.
* @throws { BusinessError } 14401001 - The target USBAccessory not matched.
* @syscap SystemCapability.USB.USBManager
* @since 14
*/
function requestAccessoryRight(accessory: USBAccessory): Promise<boolean>;
/**
* Cancels the right for a given application to access the USB accessory.
*
* @param { USBAccessory } accessory - USB accessory. It cannot be empty.
* @throws { BusinessError } 401 - Parameter error. Possible causes:
* <br>1. Mandatory parameters are left unspecified.
* <br>2. Incorrect parameter types.
* @throws { BusinessError } 14400004 - Service exception. Possible causes:
* <br>1. No accessory is plugged in.
* @throws { BusinessError } 14400005 - Database operation exception.
* @throws { BusinessError } 14401001 - The target USBAccessory not matched.
* @syscap SystemCapability.USB.USBManager
* @since 14
*/
function cancelAccessoryRight(accessory: USBAccessory): void;
/**
* Obtains the USB Accessory list.
*
* @returns { Array<Readonly<USBAccessory>> } USB accessory list.
* @throws { BusinessError } 14400004 - Service exception. Possible causes:
* <br>1. No accessory is plugged in.
* @syscap SystemCapability.USB.USBManager
* @since 14
*/
function getAccessoryList(): Array<Readonly<USBAccessory>>;
/**
* Obtains the accessory handle and opens accessory file descriptor.
*
* @param { USBAccessory } accessory - accessory, which is used to determine the accessory. It cannot be empty.
* @returns { USBAccessoryHandle } returns the handle of the accessory.
* @throws { BusinessError } 401 - Parameter error. Possible causes:
* <br>1. Mandatory parameters are left unspecified.
* <br>2. Incorrect parameter types.
* @throws { BusinessError } 14400001 - Permission denied. Call requestAccessoryRight to get the right first.
* @throws { BusinessError } 14400004 - Service exception. Possible causes:
* <br>1. No accessory is plugged in.
* @throws { BusinessError } 14401001 - The target USBAccessory not matched.
* @throws { BusinessError } 14401002 - Failed to open the native accessory node.
* @throws { BusinessError } 14401003 - Cannot reopen the accessory.
* @syscap SystemCapability.USB.USBManager
* @since 14
*/
function openAccessory(accessory: USBAccessory): USBAccessoryHandle;
/**
* Closes the accessory file descriptor.
*
* @param { USBAccessoryHandle } accessoryHandle - Accessory handle to be closed.
* @throws { BusinessError } 401 - Parameter error. Possible causes:
* <br>1. Mandatory parameters are left unspecified.
* <br>2. Incorrect parameter types.
* @throws { BusinessError } 14400004 - Service exception. Possible causes:
* <br>1. No accessory is plugged in.
* @syscap SystemCapability.USB.USBManager
* @since 14
*/
function closeAccessory(accessoryHandle: USBAccessoryHandle): void;
/**
* Represents the USB endpoint from which data is sent or received. You can obtain the USB endpoint through USBInterface.
*
* @typedef USBEndpoint
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
interface USBEndpoint {
/**
* Endpoint address
*
* @type { number }
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
address: number;
/**
* Endpoint attributes
*
* @type { number }
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
attributes: number;
/**
* Endpoint interval
*
* @type { number }
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
interval: number;
/**
* Maximum size of data packets on the endpoint
*
* @type { number }
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
maxPacketSize: number;
/**
* Endpoint direction
*
* @type { USBRequestDirection }
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
direction: USBRequestDirection;
/**
* Endpoint number
*
* @type { number }
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
number: number;
/**
* Endpoint type
*
* @type { number }
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
type: number;
/**
* Unique ID defined by USBInterface.id, which indicates the interface to which the endpoint belongs
*
* @type { number }
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
interfaceId: number;
}
/**
* Represents a USB interface. One config can contain multiple **USBInterface** instances, each providing a specific function.
*
* @typedef USBInterface
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
interface USBInterface {
/**
* Unique ID of the USB interface
*
* @type { number }
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
id: number;
/**
* Interface protocol
*
* @type { number }
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
protocol: number;
/**
* Device type
*
* @type { number }
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
clazz: number;
/**
* Device subclass
*
* @type { number }
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
subClass: number;
/**
* Alternation between descriptors of the same USB interface
*
* @type { number }
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
alternateSetting: number;
/**
* Interface name
*
* @type { string }
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
name: string;
/**
* USBEndpoint that belongs to the USB interface
*
* @type { Array<USBEndpoint> }
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
endpoints: Array<USBEndpoint>;
}
/**
* USB configuration. One USBDevice can contain multiple USBConfiguration instances.
*
* @typedef USBConfiguration
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
interface USBConfiguration {
/**
* Unique ID of the USB configuration
*
* @type { number }
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
id: number;
/**
* Configuration attributes
*
* @type { number }
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
attributes: number;
/**
* Maximum power consumption, in mA
*
* @type { number }
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
maxPower: number;
/**
* Configuration name, which can be left empty
*
* @type { string }
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
name: string;
/**
* Support for remote wakeup
*
* @type { boolean }
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
isRemoteWakeup: boolean;
/**
* Support for independent power supplies
*
* @type { boolean }
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
isSelfPowered: boolean;
/**
* Supported interface attributes
*
* @type { Array<USBInterface> }
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
interfaces: Array<USBInterface>;
}
/**
* Represents a USB device.
*
* @typedef USBDevice
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
interface USBDevice {
/**
* Bus address
*
* @type { number }
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
busNum: number;
/**
* Device address
*
* @type { number }
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
devAddress: number;
/**
* Device SN
*
* @type { string }
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
serial: string;
/**
* Device name
*
* @type { string }
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
name: string;
/**
* Device manufacturer
*
* @type { string }
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
manufacturerName: string;
/**
* Product information
*
* @type { string }
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
productName: string;
/**
* Product version
*
* @type { string }
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
version: string;
/**
* Vendor ID
*
* @type { number }
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
vendorId: number;
/**
* Product ID
*
* @type { number }
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
productId: number;
/**
* Device class
*
* @type { number }
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
clazz: number;
/**
* Device subclass
*
* @type { number }
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
subClass: number;
/**
* Device protocol code
*
* @type { number }
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
protocol: number;
/**
* Device configuration descriptor information
*
* @type { Array<USBConfiguration> }
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
configs: Array<USBConfiguration>;
}
/**
* Represents a USB device pipe, which is used to determine the USB device.
*
* @typedef USBDevicePipe
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
interface USBDevicePipe {
/**
* Bus address.
*
* @type { number }
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
busNum: number;
/**
* Device address
*
* @type { number }
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
devAddress: number;
}
/**
* Enumerates power role types.
*
* @enum { number }
* @syscap SystemCapability.USB.USBManager
* @systemapi
* @since 9
*/
export enum PowerRoleType {
/**
* None
*
* @syscap SystemCapability.USB.USBManager
* @systemapi
* @since 9
*/
NONE = 0,
/**
* External power supply
*
* @syscap SystemCapability.USB.USBManager
* @systemapi
* @since 9
*/
SOURCE = 1,
/**
* Internal power supply
*
* @syscap SystemCapability.USB.USBManager
* @systemapi
* @since 9
*/
SINK = 2
}
/**
* Enumerates data role types.
*
* @enum { number }
* @syscap SystemCapability.USB.USBManager
* @systemapi
* @since 9
*/
export enum DataRoleType {
/**
* None
*
* @syscap SystemCapability.USB.USBManager
* @systemapi
* @since 9
*/
NONE = 0,
/**
* Host mode
*
* @syscap SystemCapability.USB.USBManager
* @systemapi
* @since 9
*/
HOST = 1,
/**
* Device mode
*
* @syscap SystemCapability.USB.USBManager
* @systemapi
* @since 9
*/
DEVICE = 2
}
/**
* Enumerates port mode types
*
* @enum { number }
* @syscap SystemCapability.USB.USBManager
* @systemapi
* @since 9
*/
export enum PortModeType {
/**
* None
*
* @syscap SystemCapability.USB.USBManager
* @systemapi
* @since 9
*/
NONE = 0,
/**
* Upstream facing port, which functions as the sink of power supply
*
* @syscap SystemCapability.USB.USBManager
* @systemapi
* @since 9
*/
UFP = 1,
/**
* Downstream facing port, which functions as the source of power supply
*
* @syscap SystemCapability.USB.USBManager
* @systemapi
* @since 9
*/
DFP = 2,
/**
* Dynamic reconfiguration port (DRP), which can function as the DFP (host) or UFP (device). It is not supported currently.
*
* @syscap SystemCapability.USB.USBManager
* @systemapi
* @since 9
*/
DRP = 3,
/**
* Not supported currently
*
* @syscap SystemCapability.USB.USBManager
* @systemapi
* @since 9
*/
NUM_MODES = 4
}
/**
* Enumerates USB device port roles.
*
* @typedef USBPortStatus
* @syscap SystemCapability.USB.USBManager
* @systemapi
* @since 9
*/
interface USBPortStatus {
/**
* USB mode
*
* @type { number }
* @syscap SystemCapability.USB.USBManager
* @systemapi
* @since 9
*/
currentMode: number;
/**
* Power role
*
* @type { number }
* @syscap SystemCapability.USB.USBManager
* @systemapi
* @since 9
*/
currentPowerRole: number;
/**
* Data role
*
* @type { number }
* @syscap SystemCapability.USB.USBManager
* @systemapi
* @since 9
*/
currentDataRole: number;
}
/**
* Represents a USB device port.
*
* @typedef USBPort
* @syscap SystemCapability.USB.USBManager
* @systemapi
* @since 9
*/
interface USBPort {
/**
* Unique ID of the USB port
*
* @type { number }
* @syscap SystemCapability.USB.USBManager
* @systemapi
* @since 9
*/
id: number;
/**
* Mask combination for the supported mode list of the USB port
*
* @type { PortModeType }
* @syscap SystemCapability.USB.USBManager
* @systemapi
* @since 9
*/
supportedModes: PortModeType;
/**
* USB port role
*
* @type { USBPortStatus }
* @syscap SystemCapability.USB.USBManager
* @systemapi
* @since 9
*/
status: USBPortStatus;
}
/**
* Represents control transfer parameters.
*
* @typedef USBControlParams
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
interface USBControlParams {
/**
* Request type
*
* @type { number }
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
request: number;
/**
* Request target type
*
* @type { USBRequestTargetType }
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
target: USBRequestTargetType;
/**
* Control request type
*
* @type { USBControlRequestType }
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
reqType: USBControlRequestType;
/**
* Request parameter value
*
* @type { number }
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
value: number;
/**
* Index of the parameter value
*
* @type { number }
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
index: number;
/**
* Data written to or read from the buffer
*
* @type { Uint8Array }
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
data: Uint8Array;
}
/**
* Represents control transfer parameters.
*
* @typedef USBDeviceRequestParams
* @syscap SystemCapability.USB.USBManager
* @since 12
*/
interface USBDeviceRequestParams {
/**
* Bit map request type
*
* @type { number }
* @syscap SystemCapability.USB.USBManager
* @since 12
*/
bmRequestType: number;
/**
* Byte request
*
* @type { number }
* @syscap SystemCapability.USB.USBManager
* @since 12
*/
bRequest: number;
/**
* Request parameter word value
*
* @type { number }
* @syscap SystemCapability.USB.USBManager
* @since 12
*/
wValue: number;
/**
* Word index of the parameter value
*
* @type { number }
* @syscap SystemCapability.USB.USBManager
* @since 12
*/
wIndex: number;
/**
* Word length of the parameter value
*
* @type { number }
* @syscap SystemCapability.USB.USBManager
* @since 12
*/
wLength: number;
/**
* Data written to or read from the buffer
*
* @type { Uint8Array }
* @syscap SystemCapability.USB.USBManager
* @since 12
*/
data: Uint8Array;
}
/**
* Enumerates USB request target types.
*
* @enum { number }
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
export enum USBRequestTargetType {
/**
* USB device
*
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
USB_REQUEST_TARGET_DEVICE = 0,
/**
* USB interface
*
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
USB_REQUEST_TARGET_INTERFACE = 1,
/**
* Endpoint
*
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
USB_REQUEST_TARGET_ENDPOINT = 2,
/**
* Others
*
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
USB_REQUEST_TARGET_OTHER = 3
}
/**
* Enumerates control request types.
*
* @enum { number }
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
export enum USBControlRequestType {
/**
* Standard
*
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
USB_REQUEST_TYPE_STANDARD = 0,
/**
* Class
*
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
USB_REQUEST_TYPE_CLASS = 1,
/**
* Vendor
*
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
USB_REQUEST_TYPE_VENDOR = 2
}
/**
* Enumerates request directions.
*
* @enum { number }
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
export enum USBRequestDirection {
/**
* Request for writing data from the host to the device
*
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
USB_REQUEST_DIR_TO_DEVICE = 0,
/**
* Request for reading data from the device to the host
*
* @syscap SystemCapability.USB.USBManager
* @since 9
*/
USB_REQUEST_DIR_FROM_DEVICE = 0x80
}
/**
* Enumerates function modes.
*
* @enum { number }
* @syscap SystemCapability.USB.USBManager
* @systemapi
* @since 9
*/
export enum FunctionType {
/**
* None
*
* @syscap SystemCapability.USB.USBManager
* @systemapi
* @since 9
*/
NONE = 0,
/**
* Serial port device
*
* @syscap SystemCapability.USB.USBManager
* @systemapi
* @since 9
*/
ACM = 1,
/**
* Ethernet port device
*
* @syscap SystemCapability.USB.USBManager
* @systemapi
* @since 9
*/
ECM = 2,
/**
* HDC device
*
* @syscap SystemCapability.USB.USBManager
* @systemapi
* @since 9
*/
HDC = 4,
/**
* MTP device
*
* @syscap SystemCapability.USB.USBManager
* @systemapi
* @since 9
*/
MTP = 8,
/**
* PTP device
*
* @syscap SystemCapability.USB.USBManager
* @systemapi
* @since 9
*/
PTP = 16,
/**
* RNDIS device
*
* @syscap SystemCapability.USB.USBManager
* @systemapi
* @since 9
*/
RNDIS = 32,
/**
* MIDI device
*
* @syscap SystemCapability.USB.USBManager
* @systemapi
* @since 9
*/
MIDI = 64,
/**
* Audio source device
*
* @syscap SystemCapability.USB.USBManager
* @systemapi
* @since 9
*/
AUDIO_SOURCE = 128,
/**
* NCM device
*
* @syscap SystemCapability.USB.USBManager
* @systemapi
* @since 9
*/
NCM = 256
}
/**
* Represents a USB Accessory.
*
* @typedef USBAccessory
* @syscap SystemCapability.USB.USBManager
* @since 14
*/
interface USBAccessory {
/**
* The manufacturer name of the accessory.
*
* @type { string }
* @syscap SystemCapability.USB.USBManager
* @since 14
*/
manufacturer: string;
/**
* The product of the accessory.
*
* @type { string }
* @syscap SystemCapability.USB.USBManager
* @since 14
*/
product: string;
/**
* The user visible description of the accessory.
*
* @type { string }
* @syscap SystemCapability.USB.USBManager
* @since 14
*/
description: string;
/**
* The version of the accessory.
*
* @type { string }
* @syscap SystemCapability.USB.USBManager
* @since 14
*/
version: string;
/**
* The serial number of the accessory.
*
* @type { string }
* @syscap SystemCapability.USB.USBManager
* @since 14
*/
serialNumber: string;
}
/**
* Handle of accessory.
*
* @typedef USBAccessoryHandle
* @syscap SystemCapability.USB.USBManager
* @since 14
*/
interface USBAccessoryHandle {
/**
* The file descriptor of the accessory.The valid USBAccessoryHandle.accessoryFd is a positive value.
*
* @type { number }
* @syscap SystemCapability.USB.USBManager
* @since 14
*/
accessoryFd: number;
}
}
export default usbManager;
Reference in New Issue View Git Blame Copy Permalink