harmony 鸿蒙USB串口通信管理

2025-06-12
浏览 (7)

USB串口通信管理

简介

USB串口通信服务中通过Host设备的USB接口连接串口设备的串口进行串行数据传输，通信管理核心目标是实现设备间的高效、稳定数据传输与协同控制。主要使用在工业自动化与远程监控、物联网设备互联、医疗设备管理等场景。

环境准备

请参考USB串口通信服务开发概述环境准备。

开发指导

接口说明

接口名	描述
getPortList(): Readonly<SerialPort>[]	获取串口设备列表。
hasSerialRight(portId: number): boolean	检查应用程序是否具有访问串口设备的权限。
requestSerialRight(portId: number): Promise<boolean>	请求对串口设备的访问权限。
open(portId: number): void	打开串口设备。
close(portId: number): void	关闭串口设备。
read(portId: number, buffer: Uint8Array, timeout?: number): Promise<number>	从串口设备读取数据，使用Promise异步返回。
readSync(portId: number, buffer: Uint8Array, timeout?: number): number	以同步方法从串口设备读取数据。
write(portId: number, buffer: Uint8Array, timeout?: number): Promise<number>	往串口设备写入数据，使用Promise异步返回。
writeSync(portId: number, buffer: Uint8Array, timeout?: number): number	以同步方法往串口设备写入数据。

开发步骤

开发者可以通过上述接口读取和写入数据：

说明：

以下示例代码只是串口数据传输的必要流程，需要放入具体的方法中执行。

导入模块。

// 导入usbManager模块。
import serial from '@ohos.usbManager.serial';
import { buffer } from '@kit.ArkTS';

获取设备列表。

// 获取连接主设备的USB设备列表
let portList: serial.SerialPort[] = serial.getPortList();
console.info(`usbSerial portList: ${portList}`);
if (portList === undefined||portList.length === 0) {
  console.error('usbSerial portList is empty');
  return;
}

获取设备操作权限。

// 此处对列表中的第一台USB设备判断是否拥有访问权限
let portId: number = portList[0].portId;
if (!serial.hasSerialRight(portId)) {
  await serial.requestSerialRight(portId).then(result => {
    if(!result) {
      // 没有访问设备的权限且用户不授权则退出
      console.error('The user does not have permission to perform this operation');
      return;
    }
  });
}

根据串口打开设备。

try {
  serial.open(portId)
  console.info(`open usbSerial success, portId: ${portId}`);
} catch (error) {
  console.error(`open usbSerial error： ${error}`);
}

通过串口读取数据。

// 异步读取 
let readBuffer: Uint8Array = new Uint8Array(64);
serial.read(portId, readBuffer, 2000).then((size: number) => {
  console.info(`read usbSerial success, readBuffer: ${readBuffer}`);
}).catch((error: Error) => {
  console.error(`read usbSerial error: ${error}`);
})


// 同步读取
let readSyncBuffer: Uint8Array = new Uint8Array(64);
try {
  serial.readSync(portId, readSyncBuffer, 2000);
  console.info(`readSync usbSerial success, readSyncBuffer: ${readSyncBuffer}`);
} catch (error) {
  console.error(`readSync usbSerial error: ${error}`);
}

通过串口写入数据。

// 异步写入
let writeBuffer: Uint8Array = new Uint8Array(buffer.from('Hello World', 'utf-8').buffer)
serial.write(portId, writeBuffer, 2000).then((size: number) => {
  console.info(`write usbSerial success, writeBuffer: ${writeBuffer}`);
}).catch((error: Error) => {
  console.error(`write usbSerial error: ${error}`);
})


// 同步写入
let writeSyncBuffer: Uint8Array = new Uint8Array(buffer.from('Hello World', 'utf-8').buffer)
try {
  serial.writeSync(portId, writeSyncBuffer, 2000);
  console.info(`writeSync usbSerial success, writeSyncBuffer: ${writeSyncBuffer}`);
} catch (error) {
  console.error(`writeSync usbSerial error: ${error}`);
}

关闭串口设备

try {
  serial.close(portId);
  console.info(`close usbSerial success, portId: ${portId}`);
} catch (error) {
  console.error(`close usbSerial error: ${error}`);
}

调测验证

准备一根USB转串口线缆，线缆的USB接口连接到OpenHarmony设备USB端口（该端口需支持USB转串口），线缆的串口接口连接到目标设备的串口上。
在OpenHarmony设备上执行上述示例。
返回usbSerial success，表示相关接口调用成功，设备串口通信能力正常；返回usbSerial error，表示接口调用失败。

你可能感兴趣的鸿蒙文章

harmony 鸿蒙USB串口配置管理

harmony 鸿蒙USB串口通信服务开发概述

0 赞

所属分类： 后端技术
本文标签：
版权声明： 原创文章如转载，请注明本文链接: https://m.seaxiang.com/blog/NQHeK7