本文介紹OpenHarmony開源鴻蒙系統(tǒng)的USB控制傳輸功能實(shí)現(xiàn)及相關(guān)代碼示例，基于觸覺智能RK3576開發(fā)板Purple Pi OH2演示。

OpenHarmony的USB通信介紹

實(shí)現(xiàn)OpenHarmony開源鴻蒙設(shè)備與外部USB設(shè)備之間的連接管理、數(shù)據(jù)收發(fā)及設(shè)備信息交互，支持對(duì)USB 設(shè)備的枚舉、配置及數(shù)據(jù)傳輸控制，適用于各類USB接口進(jìn)行設(shè)備通信的場(chǎng)景。如AHD高清攝像頭、密碼鍵盤、檢測(cè)模塊等。

USB控制傳輸主要用于主機(jī)（Host）和設(shè)備（Device）進(jìn)行設(shè)備狀態(tài)的獲取和設(shè)置，進(jìn)行設(shè)備屬性狀態(tài)的的控制。根據(jù)設(shè)備支持的端點(diǎn)類型支持控制傳輸讀和寫。

示例環(huán)境：

1、僅支持開源鴻蒙OpenHarmony L2標(biāo)準(zhǔn)系統(tǒng)上運(yùn)行；

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

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

核心功能模塊實(shí)現(xiàn)邏輯

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

各流程示例代碼，請(qǐng)繼續(xù)瀏覽下文。

設(shè)備枚舉模塊

負(fù)責(zé)掃描并識(shí)別當(dāng)前連接的 USB 設(shè)備，獲取設(shè)備的基本信息（如設(shè)備ID、廠商 ID、產(chǎn)品 ID、接口類型等），基于 OpenHarmony 的 USB 服務(wù)接口實(shí)現(xiàn)設(shè)備列表的動(dòng)態(tài)更新。代碼示例：

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

連接管理模塊

處理 USB 設(shè)備的連接與斷開邏輯，包括權(quán)限校驗(yàn)、設(shè)備掛載狀態(tài)監(jiān)測(cè)及連接狀態(tài)回調(diào)通知，確保設(shè)備連接的穩(wěn)定性。代碼示例：

// 選擇設(shè)備 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;

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

數(shù)據(jù)傳輸模塊

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

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

數(shù)據(jù)接收模塊

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

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

更多代碼示例，請(qǐng)關(guān)注深圳觸覺智能電子發(fā)燒友