RS485 / Modbus 串口性能排查
本页介绍如何测量 Revo 2 的 RS485 / Modbus 查询耗时、检查 Linux 串口延迟设置,并通过原始串口与 SDK 对照定位性能瓶颈。
先确认测的是哪种频率
| 指标 | 含义 |
|---|---|
| 单次查询耗时 | 主机调用从开始到得到响应的时间,可能包含锁等待、驱动缓冲、传输、设备处理和线程调度 |
| 单手纯读频率 | 连续查询同一只手的有效事务数/秒 |
| 双手每只读取频率 | 同一路总线交替查询两只手时,各自收到有效响应的频率 |
| 控制循环频率 | 一轮读取、控制计算和写入的实际执行频率 |
| ROS 话题频率 | 订阅者收到消息的频率;与总线实际收发次数需分别测量 |
例如,若两次读取各耗时 2 ms,串行读完双手至少需要约 4 ms,尚未计入控制写入和其他开销。100 Hz 控制循环每轮只有 10 ms 预算;应测完整循环,不能仅用单手读取峰值推算。API 若异步提交写入,函数返回只表示提交完成,后续总线操作仍可能使读取等待。
ROS 的 update_rate 是目标值;Overrun 表示循环超过周期预算。JointTrajectoryController 的状态发布频率、Action 监测频率以及 /joint_states 接收频率均不能直接代替串口控制帧发送频率。
核对实际版本、端口和设备
对比前,统一设备型号、固件、从机地址、波特率和查询内容,并记录程序实际使用的 SDK 版本及动态库路径。Python 环境、ROS 工作空间和独立 C++ 程序可能使用不同的库;使用 sudo 或修改环境变量后,应重新检查加载路径。
以下命令以 /dev/ttyUSB0 为例,请替换为实际串口:
serial_port=/dev/ttyUSB0
readlink -f "$serial_port"
udevadm info --query=property --name="$serial_port"
readlink -f "/sys/class/tty/${serial_port##*/}/device/driver"驱动链接的层级随设备而异,单条命令没有输出时可继续查看 udevadm info --attribute-walk --name="$serial_port"。这些信息用于记录测试环境。
/dev/ttyUSB*通常为 USB 转串口,但不一定使用 FTDI。/dev/ttyAMA*通常为硬件 UART,实际以驱动信息为准。- 主机接收延迟取决于串口驱动、缓冲和调度配置。对比不同接口时,保持设备、查询内容和波特率一致。
FTDI 延迟定时器与硬件 UART
FTDI USB 串口的 latency_timer 常见初始值为 16 ms,它影响接收缓冲的提交时机,实际事务耗时还包括传输和设备处理。程序打开串口后读回实际值:
cat /sys/bus/usb-serial/devices/ttyUSB0/latency_timerLinux SDK 打开串口时会尝试启用 ASYNC_LOW_LATENCY。在支持的 FTDI 驱动上,这可能使定时器变为 1 ms;以实际读回值为准。若出现 enable_low_latency failed 告警,请检查驱动支持情况和操作权限。设置后结合参数读回值与实际测量结果确认效果。
需要手动启用时,在停止其他串口访问后执行以下命令,再启动程序并读回确认。该命令需要系统提供 setserial,且驱动必须支持相应 ioctl:
sudo setserial /dev/ttyUSB0 low_latency硬件 UART 通常不提供 FTDI 的 latency_timer 文件。此时应查阅对应驱动的 FIFO、DMA、接收超时和 RS485 收发方向配置。ASYNC_LOW_LATENCY 的实际效果由驱动决定,需通过查询耗时验证。
同条件对比原始串口和 SDK
公共示例提供Python/C++ 原始串口测速工具。原始两版不依赖 SDK 或 Modbus 库,但仍使用合法 Modbus RTU 请求帧查询设备;另有 SDK C++ 对照程序。使用前核对工具支持的 Revo2 寄存器、地址和波特率。
- 停止其他串口使用者,用同一只手、同一端口、同一波特率先测纯读取,再测双手交替读取。一个总线上的完整请求/响应事务应串行执行。
- 分别运行原始 Python、原始 C++ 和 SDK。核对实际原生库、有效低延迟设置,若 SDK 初始化改变了设置,在相同有效设置下重新运行原始串口测试。
- 原始工具可通过
--low-latency独立设置和读回主机驱动标志。驱动不支持时会告警,工具仍可继续读取;记录该状态以便解释结果。 - 记录成功数、失败数、中位数、P95、最大值和逐次耗时;启动同步、预热、日志打印及主动 sleep 应与稳定读取时间区分。出现超时或校验错误时停止测试,待串口恢复到无在途请求的状态后重新运行。
- 纯读取对齐后,再比较应用的双手读写、控制循环和 ROS 消息频率。只读、保持姿态与连续运动轨迹属于不同负载。
每个请求应使用目标设备的从机地址(slave ID),并根据帧内容计算 CRC。接收响应时检查地址、功能码、长度及 CRC;Modbus RTU 没有事务序号,开始测量前需确保没有遗留在途请求。
| 对照结果 | 下一步 |
|---|---|
| 原始两版快、SDK 慢 | 检查实际库版本及 SDK 初始化、锁等待、读取和调度路径 |
| 三者都慢 | 检查共同的驱动、收发链路和设备条件;可在同机同手下换已知正常的 USB-RS485 适配器对照 |
| 原始 Python 与 C++ 不同 | 核对串口配置、缓冲、读取方式和测量范围 |
| 纯读正常、完整应用慢 | 分解读写调用和等锁时间,核对真实控制帧数量、异步写入排队及循环预算 |
保存测试结果
建议将以下信息与 CSV 测量数据一同保存,便于重复测试或联系技术支持:
- 测试命令、程序版本、SDK 版本及实际加载的库路径。
- 设备型号、固件、串口驱动、波特率、从机地址和低延迟设置。
- 单手或双手、只读或读写的测试方式,以及测量时长。
- 包含启动信息和错误提示的运行日志,以及有效查询次数和耗时分布。