百科agilex.ai2 天前
松灵 SCOUT MINI / ROS2 EDU KIT PRO / SCOUT MINI COBOT 开发指南与上位机调试手册
在高校实验室、SLAM 自主导航课程与复合移动操作(Mobile Manipulation)原型搭建中,松灵机器人(AgileX) 的 SCOUT MINI 系列及衍生整机套件(SCOUT MINI ROS2 EDU KIT Lite / Pro 与 SCOUT MINI COBOT)是高频选型平台。本文依据松灵官方产品规格页与开源仓库文档,梳理底盘差异、套件硬件拓扑、ROS 2 驱动编译、双 CAN 波特率隔离绑定及图形化上位机调试流程。
全系价格与车型横向选型可先参考:2026 松灵机器人机械臂与移动底盘价格表:PiPER vs Scout 2.0 vs Ranger Mini vs LIMO;双臂同构主从遥操作与 LeRobot 采数可配合阅读 松灵 AgileX PiPER 机械臂与 SCOUT / LIMO 二次开发指南。
1. SCOUT MINI 与 SCOUT 2.0 官方底盘规格对照
当团队评估室内紧凑空间原型验证与室外重载巡检底盘时,可按松灵官方公布的实测指标区分 SCOUT MINI 与 SCOUT 2.0:
| 核心指标 | SCOUT MINI(差速标准版) | SCOUT 2.0 | 工程选型建议 |
|---|---|---|---|
| 运动模式 | 四轮差速独立悬挂(另提供全向麦轮 Omni 版) | 四轮差速双叉臂独立悬架 | 狭窄走廊原地自转优先选 MINI;重型户外选 2.0 |
| 整机尺寸 (L×W×H) | 612 × 580 × 245 mm(轴距 451 mm / 轮距 490 mm) | 930 × 699 × 337 mm | MINI 可直接通过常规实验室单开门与小型电梯 |
| 整备质量 | 23 kg | 67 kg | MINI 单人或双人即可搬运装车 |
| 额定运动载重 | 10 kg | 50 kg | 单臂(如 4.2 kg 的 PiPER)+ 雷达算力选 MINI 足够;双臂升降立柱需上 2.0 |
| 最高行驶速度 | 1.5 m/s | 1.67 m/s | 两者速度接近,室内建议限速 ≤0.8 m/s |
| 爬坡 / 越障 / 越沟 | 满载 20°(空载 22°)/ 满载 40 mm(空载 50 mm)/ 越沟 100 mm | 爬坡 30° / 越障 110 mm | 115 mm 最小离地间隙一致,高路沿场景选 2.0 |
| 电池与驱动电机 | 24V 15Ah 三元锂(对外供电 24V 10A),4×250W 无刷轮毂电机 | 4×200W 无刷伺服电机,大容量锂电包 | MINI 充电约 2h,满载续航 1 h(8 km)/ 空载 3 h(35 km);2.0 满载续航 2.5–3.5 h |
| 防护与工作温域 | IP22 / -10 ~ 40℃ | IP22 / -10 ~ 40℃ | 雨雪露天作业需做外罩密封 |
| 底层通信接口 | CAN 总线(500 kbps,兼容 V1/V2 协议) | CAN 总线(500 kbps,兼容 V1/V2 协议) | 均共用 ugv_sdk 与 scout_ros / scout_ros2 |
2. 两大开箱即用整机套件:ROS2 EDU KIT(Lite / Pro)与 SCOUT MINI COBOT
松灵在 SCOUT MINI 裸底盘之上封装了两套面向不同实验目标的标准套件,检索选型时注意区分算力架构与激光雷达型号:
2.1 SCOUT MINI ROS2 EDU KIT(Lite / Pro 导航教学套件)
面向高校 ROS 2 教学实训、SLAM 建图与 Nav2 自主导航课题验证。松灵官方发布了 ROS 2 EDU Lite 与 ROS 2 EDU Pro 双档配置:
- 计算与显示配置:搭载 x86 架构工控机(官网公开配置为 Intel Core i7 / 16GB 内存 / 516GB 存储),配备 14 寸 1920×1080P 显示器,支持本地可视化调试与远程桌面编程。
- 感知传感器栈:集成 16 线三维激光雷达(早期基础导航版亦支持 2D LiDAR + 9 轴 IMU 组合)与 Intel RealSense D435 双目深度相机。
- 软件栈:原生支持 ROS 2 生态、Cartographer 点云建图、Nav2(Navigation 2) 多点路径规划与动态避障,以及 Gazebo 仿真环境(对应站内仿真包
ugv_gazebo_sim)。
2.2 SCOUT MINI COBOT(复合移动协作机器人开发平台)
面向「自主移动导航 + 视觉识别 + 机械臂抓取与放置」一体化的具身智能科研与实训场景:
- 移动底盘:SCOUT MINI(612×580×245 mm,底盘额定负载 10 kg,满载续航 1h / 空载 3h)。
- 机载协作机械臂:整备重量 4.2 kg,额定有效负载 1.5 kg,工作半径 626 mm,重复定位精度 ±0.1 mm(与松灵 PiPER 轻量化六轴协作臂同源架构)。
- 边缘 AI 算力与传感器:搭载 NVIDIA Jetson Orin Nano 机载计算单元、Livox Mid-360 3D 激光雷达与 CH110 IMU,通过 CAN 总线统一接入底盘与机械臂。
- 典型能力与 SLAM 扩展:开箱支持 AB 点导航、动态避障及基于二维码识别的自主抓取投放;搭载 Mid-360 雷达时可直接部署 FAST-LIO2 + Nav2 紧耦合激光惯性里程计管线,具体参数整定可参考本站教程 ROS 2 下部署 FAST-LIO2 + Nav2 实操指南(Livox Mid-360 适配)。
3. 底盘 ROS 2 驱动编译与双 CAN 波特率隔离避坑
3.1 编译 ugv_sdk 与 scout_ros2 并启动 SCOUT MINI
根据松灵官方 ugv_sdk 与 scout_ros2 仓库文档,SCOUT 2.0、SCOUT MINI(差速版)与 SCOUT MINI Omni(全向麦轮版)均通过 SocketCAN 以 500,000 bps(500 kbps) 波特率通信,SDK 会自动识别 V1/V2 协议,但启动时必须调用对应车型的 launch 文件或显式传入 is_scout_mini 参数:
# 1. 安装系统编译与 SocketCAN 调试依赖
sudo apt-get update
sudo apt-get install -y build-essential git cmake libasio-dev can-utils iproute2
# 2. 拉取官方 ugv_sdk 与 scout_ros2 并使用 colcon 编译
mkdir -p ~/ros2_ws/src
cd ~/ros2_ws/src
git clone https://github.com/agilexrobotics/ugv_sdk.git
git clone https://github.com/agilexrobotics/scout_ros2.git
cd ~/ros2_ws
colcon build
source install/setup.bash
# 3. 加载 gs_usb 内核模块并以 500kbps 拉起底盘 CAN 接口
sudo modprobe gs_usb
sudo ip link set can0 up type can bitrate 500000
# 4. 先用 candump 确认底盘是否有心跳报文上报(排查接线/急停开关第一手段)
candump can0
# 5. 启动 SCOUT MINI 专用 ROS 2 底盘节点(全向轮版本追加 is_omni_wheel:=true)
ros2 launch scout_base scout_mini_base.launch.py port_name:=can0 is_scout_mini:=true is_omni_wheel:=false
# 6. 新开终端启动键盘遥操作验证线速度与角速度响应(确认遥控器切出手动独占且急停已释放)
ros2 run teleop_twist_keyboard teleop_twist_keyboard3.2 复合机器人(SCOUT MINI COBOT)双 CAN 波特率冲突避坑
在 SCOUT MINI COBOT 或自建「SCOUT 底盘 + PiPER 机械臂」复合平台上,工控机同时插有至少 2 个 USB-to-CAN 模块,这是现场调试最高频的报错源头:
- 波特率严格不同,切勿混接:
- SCOUT MINI / SCOUT 2.0 底盘 CAN 波特率固定为
500000(500 kbps); - PiPER 机械臂 CAN 波特率固定为
1000000(1 Mbps)。
- SCOUT MINI / SCOUT 2.0 底盘 CAN 波特率固定为
- 按物理 USB 端口重命名绑定:Linux 重启后
can0/can1枚举顺序可能互换。使用piper_sdk自带的piper-canCLI(仅支持 Linux,依赖can-utils与ethtool)定位物理 USB 槽位并分别激活:
pip3 install python-can piper_sdk
# 若提示 piper-can 不在 PATH,将用户脚本目录加入环境变量
export PATH="$(python3 -m site --user-base)/bin:$PATH"
# 单独插入机械臂 CAN 模块,查看其物理 USB 端口号(例如输出 3-1.4:1.0)
piper-can find
# 将该物理端口固定重命名为 can_piper 并以 1Mbps 激活机械臂总线
piper-can activate can_piper 1000000 --usb-port "3-1.4:1.0"
# 另一路连接底盘的 USB-CAN 接口保持 can0,以 500kbps 激活底盘总线
sudo ip link set can0 up type can bitrate 500000固件版本提示:根据
piper_sdk官方说明,机械臂主控固件版本在1.8-8及以后时,Python 脚本请实例化C_PiperInterface_V3("can_piper")替代旧版默认接口;且读取关节状态反馈时机械臂必须处于 从臂模式(Slave Mode),若处于主臂示教模式将不返回反馈帧,可通过piper.MasterSlaveConfig(0xFC, 0, 0, 0)切回从臂模式。
4. 松灵官方开源上位机(Piper_sdk_ui)安装与排障指南
针对站内高频检索的「松灵上位机」,松灵官方在 GitHub 开源了基于 Python 3.10 + PyQt5 + piper_sdk 的跨 Ubuntu 18.04 / 20.04 / 22.04 图形化上位机仓库 Piper_sdk_ui,用于无代码完成 CAN 端口激活、主从模式切换、单关节/全关节零点标定、固件版本查询与夹爪保护清错。
4.1 环境安装与启动命令
# 1. 安装 CAN 工具与 Qt5 运行库
sudo apt update -y
sudo apt install -y can-utils ethtool qt5-qmake qtbase5-dev
# 2. 克隆官方上位机仓库并创建 Python 3.10 独立环境
cd $HOME
git clone https://github.com/agilexrobotics/Piper_sdk_ui.git
conda create -n piper_sdk_ui python=3.10 -y
conda activate piper_sdk_ui
pip3 install python-can piper_sdk pyqt5
# 3. 启动图形化上位机界面
cd $HOME/Piper_sdk_ui
python3 ./piper_ui.py4.2 上位机核心操作顺序与高频避坑
- 标准上电操作流:点击
Find CAN Port(需终端授权管理员权限)→ 选择目标端口(如can0或重命名后的can_piper)→ 点击Activate CAN Port(后续所有功能必须在激活端口后才可点击)→ 点击Enable使能电机 → 打开右下角Status information reading的Start实时监看Joint Status、Gripper Status与正运动学FK。 - 主从模式切换与重力掉落防护:
- 在
Slave / Master选项中,Master即为主臂示教模式,Slave为从臂受控模式; - 安全红线:切换模式后执行
Reset重置,或点击All Set Zero/ 单轴Set Zero标定零点时,对应关节电机会立即失能卸力,机械臂受重力直接下坠!执行前务必用手托住机械臂或置于海绵支架上;使用Stop缓降后,需先点Reset再连续点击两次Enable方可恢复受控。
- 在
- 夹爪报错与启动常见故障处理:
- 夹爪过热无响应:长时间堵转触发过热保护时,点击界面上的
Gripper disable and clear err失能并清除错误码,待降温后重新设定Gripper stroke(默认行程 70 mm,确认confirm); - Conda 下启动报
libGL error: MESA-LOADER: failed to open iris:系 Conda 内置动态库与系统显卡驱动冲突,在当前虚拟环境中执行conda install -c conda-forge gcc即可修复。
- 夹爪过热无响应:长时间堵转触发过热保护时,点击界面上的
5. 延伸阅读与选型工具
- 并排参数比对:在对比工作台中并排查看 SCOUT 2.0、Ranger Mini、LIMO 与 PiPER
- 激光 SLAM 导航实操:ROS 2 下部署 FAST-LIO2 + Nav2 实操指南(Livox Mid-360 适配)
- 多指手与双臂遥操作采数:多指灵巧手与双臂主从遥操作采数系统搭建指南:从动捕手套/VR 到 LeRobot 数据集封装
外部来源
本页事实对应的公开页面,以原文为准。(点击将离开本站)