# 松灵 SCOUT MINI / ROS2 EDU KIT PRO / SCOUT MINI COBOT 开发指南与上位机调试手册

> 原文链接：https://robotics.hellobike.com/wiki/agilex-scout-mini-ros2-edu-cobot-dev-guide
> 频道：wiki | 更新日期：2026-11-20 | 标签：松灵, SCOUT MINI, ROS2 EDU KIT PRO, SCOUT MINI COBOT, 松灵上位机, SCOUT 2.0, FAST-LIO
> 核心摘要：详解松灵 AgileX SCOUT MINI 与 SCOUT 2.0 底盘参数差异、ROS2 EDU KIT (Lite/Pro) 与 SCOUT MINI COBOT 复合移动操作套件配置、ugv_sdk 与 scout_ros2 编译启动、底盘 500kbps 与机械臂 1Mbps 双 CAN 总线隔离绑定，以及官方 PyQt5 上位机 Piper_sdk_ui 操作流程。

# 松灵 SCOUT MINI / ROS2 EDU KIT PRO / SCOUT MINI COBOT 开发指南与上位机调试手册

在高校实验室、SLAM 自主导航课程与复合移动操作（Mobile Manipulation）原型搭建中，[松灵机器人（AgileX）](/companies/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](/routes/agilex-full-lineup-piper-scout2-ranger-limo-price)；双臂同构主从遥操作与 LeRobot 采数可配合阅读 [松灵 AgileX PiPER 机械臂与 SCOUT / LIMO 二次开发指南](/wiki/agilex-piper-scout-teleop-dev-guide)。

---

## 1. SCOUT MINI 与 SCOUT 2.0 官方底盘规格对照

当团队评估室内紧凑空间原型验证与室外重载巡检底盘时，可按松灵官方公布的实测指标区分 **SCOUT MINI** 与 **[SCOUT 2.0](/robots/agilex-scout-2-0)**：

| 核心指标 | SCOUT MINI（差速标准版） | [SCOUT 2.0](/robots/agilex-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](/robots/agilex-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`](/sdks/agilexrobotics-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](/robots/agilex-piper) 轻量化六轴协作臂同源架构）。
- **边缘 AI 算力与传感器**：搭载 **NVIDIA Jetson Orin Nano** 机载计算单元、**[Livox Mid-360](/parts/livox-mid-360)** 3D 激光雷达与 **CH110** IMU，通过 CAN 总线统一接入底盘与机械臂。
- **典型能力与 SLAM 扩展**：开箱支持 AB 点导航、动态避障及基于二维码识别的自主抓取投放；搭载 Mid-360 雷达时可直接部署 **FAST-LIO2 + Nav2** 紧耦合激光惯性里程计管线，具体参数整定可参考本站教程 [ROS 2 下部署 FAST-LIO2 + Nav2 实操指南（Livox Mid-360 适配）](/tutorials/ros2-fast-lio2-nav2-mid360-guide)。

---

## 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`](/sdks/agilexrobotics-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. 延伸阅读与选型工具

- **并排参数比对**：[在对比工作台中并排查看 SCOUT 2.0、Ranger Mini、LIMO 与 PiPER](/compare/?ids=agilex-scout-2-0,agilex-ranger-mini,agilex-limo,agilex-piper)
- **激光 SLAM 导航实操**：[ROS 2 下部署 FAST-LIO2 + Nav2 实操指南（Livox Mid-360 适配）](/tutorials/ros2-fast-lio2-nav2-mid360-guide)
- **多指手与双臂遥操作采数**：[多指灵巧手与双臂主从遥操作采数系统搭建指南：从动捕手套/VR 到 LeRobot 数据集封装](/tutorials/2026-11-11-dexterous-hand-teleop-lerobot-dataset-collection)

## 原始参考来源 (Sources)

- [四轮差速移动机器人平台 SCOUT MINI | 松灵机器人官网](https://www.agilex.ai/products/scout-mini)
- [SCOUT MINI | Compact Differential-Drive Off-Road Mobile Robot (AgileX Global)](https://global.agilex.ai/products/scout-mini)
- [ROS2移动机器人教学平台 | SCOUT MINI ROS2 EDU KIT | 松灵机器人](https://www.agilex.ai/products/scout-mini-ros2-edu-kit)
- [The World's First ROS2 Mobile Robot Navigation Open Source Education Kit Released](https://global.agilex.ai/blogs/robotics/the-world-s-first-ros2-mobile-robot-navigation-open-source-education-kit-released)
- [移动操作机器人开发平台 | SCOUT MINI COBOT | 松灵机器人](https://www.agilex.ai/products/scoutminicobot)
- [GitHub agilexrobotics/scout_ros2 (ROS2 Packages for Scout Mobile Robot)](https://github.com/agilexrobotics/scout_ros2)
- [GitHub agilexrobotics/ugv_sdk (C++ SDK for Mobile Robot Platforms)](https://github.com/agilexrobotics/ugv_sdk)
- [GitHub agilexrobotics/piper_sdk (Piper Robot Arm SDK & piper-can CLI)](https://github.com/agilexrobotics/piper_sdk)
- [GitHub agilexrobotics/Piper_sdk_ui (松灵机械臂 PyQt5 开源上位机)](https://github.com/agilexrobotics/Piper_sdk_ui)