本文介紹OpenHarmony開源鴻蒙系統的USB控制傳輸功能實現及相關代碼示例，基于觸覺智能RK3576開發板Purple Pi OH2演示。

OpenHarmony的USB通信介紹

實現OpenHarmony開源鴻蒙設備與外部USB設備之間的連接管理、數據收發及設備信息交互，支持對USB 設備的枚舉、配置及數據傳輸控制，適用于各類USB接口進行設備通信的場景。如AHD高清攝像頭、密碼鍵盤、檢測模塊等。

USB控制傳輸主要用于主機（Host）和設備（Device）進行設備狀態的獲取和設置，進行設備屬性狀態的的控制。根據設備支持的端點類型支持控制傳輸讀和寫。

示例環境：

1、僅支持開源鴻蒙OpenHarmony L2標準系統上運行；

2、本示例已適配 API version 12 版本 SDK（兼容 API version 8 及以上版本）；

3、本示例為Stage模型，需要使用DevEco Studio 5.0.2 Release及以上版本才可編譯運行。；

核心功能模塊實現邏輯

USB通信流程整體可分為3塊組成：設備枚舉→設備連接→數據傳輸/接收，流程圖示：

各流程示例代碼，請繼續瀏覽下文。

設備枚舉模塊

負責掃描并識別當前連接的 USB 設備，獲取設備的基本信息（如設備ID、廠商 ID、產品 ID、接口類型等），基于 OpenHarmony 的 USB 服務接口實現設備列表的動態更新。代碼示例：

// 獲取USB設備列表 private getUsbDevices(): void { try { this.deviceList = usbManager.getDevices(); if (this.deviceList.length === 0) { this.log = '未檢測到USB設備'; } else { this.log = `找到 ${this.deviceList.length} 個USB設備`; } this.selectedDeviceIndex = -1; this.interfaces = []; this.endpoints = []; this.selectedInterfaceIndex = -1; this.selectedEndpointIndex = -1; this.isDeviceSelected = false; this.isReceiving = false; } catch (error) { this.log = `獲取設備列表失敗: ${error}`; console.error("獲取USB設備列表異常: ", error); } }

連接管理模塊

處理 USB 設備的連接與斷開邏輯，包括權限校驗、設備掛載狀態監測及連接狀態回調通知，確保設備連接的穩定性。代碼示例：

// 選擇設備 private async selectDevice(index: number): Promise { this.selectedDeviceIndex = index; this.selectedInterfaceIndex = -1; this.selectedEndpointIndex = -1; this.interfaces = []; this.endpoints = []; this.isDeviceSelected = false; this.isReceiving = false; try { let deviceName: string = this.deviceList[index].name;

// 申請操作指定設備的權限 let hasRight: boolean = await usbManager.requestRight(deviceName); console.info("usb device request right result: " + hasRight); if (!hasRight) { this.log = 'USB設備權限獲取失敗'; return; }

數據傳輸模塊

實現與 USB 設備的雙向數據傳輸，支持批量傳輸。主機→USB 設備進行數據發送，適用于向 USB 設備發送配置命令、控制參數等場景，需選擇 OUT方向端點（端點地址 direction=0），流程包括：解析用戶輸入的16進制數據、建立設備通信管道、聲明目標接口、調用 usbManager.bulkTransfer() 發送數據。代碼示例

// 發送數據到設備 private async sendDataToDevice(): Promise { if (this.selectedDeviceIndex === -1 || this.selectedInterfaceIndex === -1 || this.selectedEndpointIndex === -1) { this.log = '請先選擇設備、接口和端點'; this.showSendDataDialog = false; return; } if (!this.sendDataContent.trim()) { this.log = '發送數據不能為空'; return; }

數據接收模塊

USB 設備→主機進行數據發送，適用于從 USB 設備獲取狀態數據、采集數據等場景，需選擇 IN 方向端點（端點地址 direction=0x80），流程包括：建立設備通信管道、聲明目標接口、循環調用 usbManager.bulkTransfer() 讀取數據、解析數據為十六進制格式并展示。代碼示例：

// 開始接收數據 private async startReceiveData(): Promise { if ( this.selectedDeviceIndex === -1 || this.selectedInterfaceIndex === -1 || this.selectedEndpointIndex === -1) { this.log = '請先選擇設備、接口和端點'; return ; }

更多代碼示例，請關注深圳觸覺智能電子發燒友