串口管理错误码
说明:
以下仅介绍本模块特有错误码,通用错误码请参考通用错误码说明文档
35700001 服务异常
错误信息
Service error.
错误描述
调用串口通信相关接口时,串口通信服务内部发生异常。
可能原因
-
串口通信服务未启动。
-
串口通信服务内部异常。
处理步骤
-
检查设备串口功能是否正常。
-
重启设备后重试。
35700002 参数错误
错误信息
Invalid parameter.
错误描述
调用串口通信相关接口时,传入的参数不合法。
可能原因
-
波特率不是正整数。
-
写入数据长度超出范围。
-
超时时间超出接口限定范围。
-
参数类型错误。
处理步骤
-
检查波特率是否为正整数。
-
检查写入数据长度是否在(0, 4096]范围内。
-
检查超时时间是否在[0, 300000]范围内。
-
检查参数类型是否正确。
35700003 虚拟串口断开
错误信息
Virtual serial port disconnected.
错误描述
操作串口通信相关接口时,USB虚拟串口设备已断开连接。
可能原因
-
USB转串口线缆被拔出。
-
USB虚拟串口设备异常断开。
处理步骤
-
检查USB转串口线缆连接是否正常。
-
重新插拔USB设备后,重新调用getSerialPortList获取设备列表,再调用open接口打开设备。
35700004 端口已被占用
错误信息
Port already in use.
错误描述
调用open接口打开串口时,串口端口已被其他应用或进程占用。
可能原因
-
同一串口被其他应用打开。
-
上次操作未正常关闭串口。
处理步骤
-
关闭占用该串口的其他应用。
-
调用close关闭串口后重新打开。
35700005 端口未打开
错误信息
Port not open.
错误描述
操作串口通信相关接口时,串口端口未打开。
可能原因
-
未调用open方法打开串口。
-
串口已被关闭。
处理步骤
-
先调用open方法打开串口。
-
检查串口是否已被关闭,若已关闭则重新打开。
35700006 传输超时
错误信息
Transmission timeout.
错误描述
调用write接口写入数据时,数据传输超时。
可能原因
-
指定超时时间内数据未能写入串口。
-
接收端设备未响应。
-
串口通信参数配置不匹配。
-
写入请求过于频繁,硬件发送缓冲区拥塞,导致数据来不及发送。
处理步骤
-
检查接收端设备是否正常连接。
-
适当增大超时时间参数。
-
检查串口通信参数(波特率等)是否与对端一致。
-
降低写入频率或在写入之间调用drain接口等待前次数据发送完成后再发送。
35700007 用户授权被拒绝
错误信息
User authorization required.
错误描述
调用open接口打开串口时,系统会校验用户是否已允许应用访问目标串口,若用户拒绝授权,则抛出该错误码。
可能原因
- 用户在授权弹窗中拒绝了应用访问目标串口的请求。
处理步骤
- 引导用户在授权弹窗中允许应用访问目标串口。
35700008 权限被拒绝
错误信息
Permission denied.
错误描述
调用serial.addPortAuthorization接口时,当前应用不是串口授权弹窗应用,无权执行该操作。
可能原因
- 调用方不是串口授权弹窗应用。serial.addPortAuthorization接口仅允许串口授权弹窗应用调用。
处理步骤
- 确认当前应用是否为串口授权弹窗应用。该接口仅允许特定的串口授权弹窗应用调用,其他应用无法使用。
本文来自 OpenHarmony 文档贡献者,按 CC BY 4.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。
