常见问题 (FAQ)

问题:RoArm-M3-S 和 RoArm-M3-Pro 两个型号的区别在哪？

答：RoArm-M3-S 使用的舵机为工程塑胶外壳的 ST3215 Servo 和 ST3215-HS Servo；而 RoArm-M3-Pro 除手腕关节 2 和末端关节之外的其余关节使用的舵机为金属外壳的 ST3235 Servo，金属外壳的舵机虚位会更小，不会随着使用时间而增大。

问题:使用串口通信发送 JSON 指令或 ROS2 控制机械臂没有反应？

答：首先先检查是否给机械臂供电，电源接口及电源开关标注见 ，插上电源接口后需要看驱动板上的电源开关是否打开；接着对照 机器人通用驱动板板载接口 部分确保机械臂是插入序号 ⑨ 的 USB 接口；最后检查串口通信的端口号是否正确。若上述检查完毕后控制机械臂仍未有反应，请咨询技术支持。

问题:使用下载工具或 Arduino IDE 给机器人通用驱动板上传程序时未出现新的 COM 口，是为什么？

答：首先先对照 机器人通用驱动板板载接口 部分检查是不是插入序号 ⑨ 的 USB 接口，是的话接着看下电脑的设备管理器是否有新的 COM 口出现，若没有，则看下其它设备中是否有名字中带 CP2102 未识别的设备（如图），有的话则是未安装驱动导致的，可点击安装 CP2102 串口驱动 CP2102 串口驱动。若其它设备中没有名字中带 CP2102 未识别的设备，则联系店铺客服返厂维修。

问题:使用下载工具或 Arduino IDE 给机器人通用驱动板上传程序时出现 'Failed to connect to ESP32: Timed out waiting for packet header' 的错误提示，是什么原因？

答：出现这种情况一般情况下是机器人通用驱动板自动下载电路不作效了，此时需要拔掉 USB 线重新进行上传，在上传时出现"...."的时候，按住机器人通用驱动板上的 BOOT 按键别松开，然后按一秒 EN 键后松开 EN 键，EN 键松开后再松开 BOOT 键。若多次进行该操作后都上传不成功，则联系店铺客服返厂维修。

问题:重新给产品上传程序后，连接 WIFI 出现密码错误或者其它连接不上的情况，该如何解决？

答：重新烧录过程序，要串口通信发指令

{ "T": 604}

再给机械臂重新上电，忘记 WIFI 重新进行连接。

问题:Web 端无法访问，输入 192.168.4.1 后无法打开控制界面？

答：首先确认机械臂处于 AP 模式（开机后默认模式），检查手机/电脑是否已连接到机械臂的 WiFi 热点（SSID 通常为 RoArm-M3-XXXX）。如果已连接但仍无法访问，尝试清除浏览器缓存或更换浏览器。如果机械臂处于 STA 模式，需在机械臂 OLED 屏幕上查看分配的 IP 地址，使用该 IP 地址访问。

问题:机械臂运动时出现异常声音或卡顿现象？

答：可能是机械臂运动超出工作空间限制或遇到障碍物。首先检查机械臂周围是否有障碍物，然后确认运动指令中的角度/坐标值是否在合理范围内。如果问题持续存在，检查机械臂各关节连接是否松动，舵机是否正常工作。建议先进行零点校准操作。

问题:ROS2 环境下机械臂无法正常通信或控制？

答：首先确认机械臂驱动节点已正确启动，检查 ROS2 网络配置，确保机械臂与 ROS2 主机在同一网络。使用ros2 node list和ros2 topic list确认节点和话题正常。如果使用虚拟机环境，确保网络桥接模式设置正确。检查防火墙设置是否阻止了 ROS2 通信。

问题:机械臂末端执行器（夹爪）无法正常开合？

答：检查夹爪连接线是否牢固，发送夹爪控制指令（T=114,led=角度值）测试。角度范围通常为 0-135 度（对应弧度 0-1.08）。如果夹爪无反应，检查驱动板上的夹爪接口连接，或通过 Web 端测试夹爪功能。

问题:MoveIt2 规划时机械臂运动轨迹不理想或碰撞检测误报？

答：检查 MoveIt2 配置中的碰撞矩阵设置，可能需要调整碰撞检测参数。在 Rviz2 中可视化规划结果，确认轨迹合理性。如果频繁出现碰撞误报，可以适当增大碰撞检测的容差值或优化机械臂的 URDF 模型。

问题:机械臂的精度如何校准？

答：RoArm-M3 支持软件零点校准。通过发送零点校准指令

{ "T": 100}

将当前姿态设为零点。也可通过 Web 端进行校准，确保机械臂处于期望的零点位置后执行校准操作。建议在校准前确保机械臂各关节处于安全位置。

问题:如何扩展机械臂的功能或添加外部传感器？

答：RoArm-M3 提供丰富的扩展接口，包括 I2C、SPI、UART 等。可以通过 40PIN 扩展接口连接树莓派等上位机，或通过 I2C 接口连接 OLED 屏幕、传感器等。支持二次开发，可使用 Arduino IDE 或 PlatformIO 进行编程。

问题:机械臂长时间运行后性能下降或发热明显？

答：长时间高负载运行可能导致舵机发热。建议合理安排工作周期，避免连续高强度运行。检查环境温度是否过高，确保良好的散热条件。如果性能明显下降，检查电源供应是否稳定，电压是否在正常范围内。