Skip to content

百科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 mmMINI 可直接通过常规实验室单开门与小型电梯
整备质量23 kg67 kgMINI 单人或双人即可搬运装车
额定运动载重10 kg50 kg单臂(如 4.2 kg 的 PiPER)+ 雷达算力选 MINI 足够;双臂升降立柱需上 2.0
最高行驶速度1.5 m/s1.67 m/s两者速度接近,室内建议限速 ≤0.8 m/s
爬坡 / 越障 / 越沟满载 20°(空载 22°)/ 满载 40 mm(空载 50 mm)/ 越沟 100 mm爬坡 30° / 越障 110 mm115 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 参数:

bash
# 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_keyboard

3.2 复合机器人(SCOUT MINI COBOT)双 CAN 波特率冲突避坑 ​

在 SCOUT MINI COBOT 或自建「SCOUT 底盘 + PiPER 机械臂」复合平台上,工控机同时插有至少 2 个 USB-to-CAN 模块,这是现场调试最高频的报错源头:

  1. 波特率严格不同,切勿混接:
    • SCOUT MINI / SCOUT 2.0 底盘 CAN 波特率固定为 500000(500 kbps);
    • PiPER 机械臂 CAN 波特率固定为 1000000(1 Mbps)。
  2. 按物理 USB 端口重命名绑定:Linux 重启后 can0 / can1 枚举顺序可能互换。使用 piper_sdk 自带的 piper-can CLI(仅支持 Linux,依赖 can-utils 与 ethtool)定位物理 USB 槽位并分别激活:
bash
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 环境安装与启动命令 ​

bash
# 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.py

4.2 上位机核心操作顺序与高频避坑 ​

  1. 标准上电操作流:点击 Find CAN Port(需终端授权管理员权限)→ 选择目标端口(如 can0 或重命名后的 can_piper)→ 点击 Activate CAN Port(后续所有功能必须在激活端口后才可点击)→ 点击 Enable 使能电机 → 打开右下角 Status information reading 的 Start 实时监看 Joint Status、Gripper Status 与正运动学 FK。
  2. 主从模式切换与重力掉落防护:
    • 在 Slave / Master 选项中,Master 即为主臂示教模式,Slave 为从臂受控模式;
    • 安全红线:切换模式后执行 Reset 重置,或点击 All Set Zero / 单轴 Set Zero 标定零点时,对应关节电机会立即失能卸力,机械臂受重力直接下坠!执行前务必用手托住机械臂或置于海绵支架上;使用 Stop 缓降后,需先点 Reset 再连续点击两次 Enable 方可恢复受控。
  3. 夹爪报错与启动常见故障处理:
    • 夹爪过热无响应:长时间堵转触发过热保护时,点击界面上的 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. 延伸阅读与选型工具 ​

基于本页技术方向关联的整机参数、核心零部件、实测报告与同赛道选型横评。

外部来源

本页事实对应的公开页面,以原文为准。(点击将离开本站)

  1. 四轮差速移动机器人平台 SCOUT MINI | 松灵机器人官网 ↗访问 2026-11-20
  2. SCOUT MINI | Compact Differential-Drive Off-Road Mobile Robot (AgileX Global) ↗访问 2026-11-20