Andino(Ekumen 开源 ROS 2 教育小车) 复刻全流程
Andino(Ekumen 开源 ROS 2 教育小车) 从采购、打印、组装到装软件、标定和训练的 206 个步骤,附物料表、购买链接与官方出处。
Ekumen 2023‑07 发布帖称造价不到 300 美元(创作者估计,针对改版前的设计,未说明包含哪些项目);改版后 README 的 BOM 只给购买链接,没有价格。未见官方套件销售
采购
- 购买 Raspberry Pi 4 B
购买 4 GB 的 Raspberry Pi 4 B;文档也指出可购买 8 GB 型号以获得更好的性能。
- 购买两个带编码器电机
Buy two Hobby Motor with Encoder - Metal Gear (DG01D-E) motors.
- 购买 TT 电机车轮
购买用于 TT 电机的通用车轮。
- 购买 Arduino Nano
购买文档中列出的 Arduino Nano,并保留其购买链接。
- 购买 BNO055 IMU
购买文档中列出的 BNO055 IMU,并保留其购买链接。
- 购买 L298N 双 H 桥驱动模块
购买文档中列出的 L298N Dual H Bridge,并保留其购买链接。
- 购买 RPLidar A1M8
从文档列出的 RobotShop 或 Amazon 购买 RPLidar A1M8。
- 确认并购买 Micro-USB 线缆
检查 RPLidar A1M8 是否附带 microUSB-USB 线缆;如果没有,需要另购一根。
- 购买树莓派摄像头模块 V2(8 MP)
从 Robotshop 或 Amazon 购买树莓派摄像头模块 V2(8 MP)。
- 另购 30 cm 加长排线备用
文档提供了 30 cm 加长排线的链接,以防自带排线太短。
- 购买电池盒(18650 用)
从 Amazon 购买塑料电池盒;链接为 6 只装,但只需要一个。
- 购买 18650 电池
从 Amazon 购买 18650 可充电电池,文档说明任何 18650 电池都可以使用。
- 购买 18650 电池充电器
购买任意一款 18650 电池充电器,例如可同时为两块以上电池充电的充电器。
- 选择 12V 转 5V 降压模块
使用输入电压为 12V、输出电压为 5V 且输出电流至少为 3A 的降压 DC-DC 稳压器。
- 选择合适尺寸的断电开关
选择安装孔尺寸为 13 × 20 mm 的断电开关。
- 购买脚轮
购买清单中列出的脚轮。
- 购买扎带
从 Amazon 购买扎带,实际只需要使用 4 到 6 根。
打印与加工
- 打印底座底盘
3D 打印 Base_chassis STL 文件。
- 打印激光雷达底盘
3D 打印 lidar_chassis STL 文件。
- 打印电池底盘
3D 打印 Battery_chassis STL 文件。
- 打印 Arduino 锁座
3D 打印 Arduino_lock_base STL 文件。
- 打印相机外壳
3D 打印 Camera_case 模型。
组装
- 焊接 Arduino Nano 引脚
可以任意位置焊接 Arduino 引脚,但建议按照图片中所示的位置焊接。
- 安装后轮
将底座底盘面朝下,把轮子安装到底座底盘上。
- 翻起底座
将底座底盘面朝上放置。
- 安装电机和 IMU
使用 4 颗 30 mm 螺丝安装电机,并使用扎带安装 IMU。
- 穿过摄像头软线
如图所示,将摄像头软线穿过 IMU 底座下方的孔。
- 装入摄像头外壳
如图所示,将摄像头放入摄像头外壳内。
- 固定摄像头外壳
如图所示,将摄像头外壳放到位;撑开底座时注意不要损坏它。
- 安装树莓派和车轮
将底座旋转 180 度,按图放置树莓派,并将车轮插入电机。
- 连接电机驱动板电源线
给电机驱动板连接电源线和 5 V 线;电源线至少需要 15 cm。
- 完成驱动板接线
按照连接图完成电机驱动板的全部接线。
- 安装 Arduino
使用 Arduino 锁定底座放置 Arduino。
- 完成接线并整理线缆
按照连接图完成其余接线,并按自己的喜好整理线缆。
- 安装激光雷达底座
如图所示,将激光雷达放入激光雷达底座。
- 固定激光雷达驱动板
如图所示,使用扎带将激光雷达驱动板固定在激光雷达底座上。
- 固定激光雷达底座
将激光雷达底座放在底座底盘上方,并用螺丝固定到位。
- 安装降压驱动板和开关
如图所示,将 5 V 降压驱动板和断电开关放入电池底盘。
- 检查电池底盘外观
检查电池底盘外部外观应与所示图片一致。
- 装入电池盒
如图所示,将电池盒放入电池底盘内部。
- 完成电源连接和总装
按照电源连接图完成所有电源连接,并如图所示将电池底盘放入底座底盘。
- 完成 Andino 组装
完成关闭外壳后的 Andino 最终组装。
- 连接开关接地线
仅当开关带 LED 指示灯时,才需要将接地线连接到开关。
- 连接摄像头排线
连接摄像头排线时,确保蓝色或银色一面朝向 USB 端口。
- 连接并验证 RPLidar
将 A1M8 RPLidar 连接到 USB 端口。USB 转换器的 A1M8 侧板绿色指示灯应亮起。
- 按板级定义接线
使用 boards/arduino_uno/andino/board.h 中的引脚分配为 Arduino Uno 接线;Arduino Nano 使用同一分配。
- 连接 L298N 使能输入
如果 L298N 电机驱动板带使能跳线,可将其直接跳接到 5V。
- 连接编码器中断输入
将编码器输入连接到板级引脚分配中指定的引脚,并使用中断引脚。AVR 板使用引脚变化中断。
- 连接可选 BNO055 IMU
可选择通过 I2C 总线连接 Adafruit BNO055;固件在没有 IMU 时也能工作。
- 按 Blue Pill 定义接线
使用 boards/stm32_bluepill/andino/board.h 中的引脚分配连接 STM32 Blue Pill。
- 分配不同的编码器引脚号
编码器引脚必须使用不同编号,此处为 12 到 15,因为每个端口中相同编号的引脚共用外部中断线。
- 避开 USB 与调试器引脚
不要将其他功能分配到 PA11、PA12、PA13 和 PA14;前两者供 USB 使用,后两者供调试器使用。
- 连接开发板或 ST-Link
将开发板连接到主机的 USB 端口。Blue Pill 通过连接到 SWD 插头的 ST-Link 烧录,因此应连接 ST-Link。
- 连接 Blue Pill 串口
固件烧录完成后,使用第二根 USB 线将 Blue Pill 连接到主机。ST-Link 仅在烧录时需要,Blue Pill 的 USB CDC 串口通常显示为 `/dev/ttyACM0`。
- 阅读 Andino 硬件装配说明
打开 andino_hardware 目录并按其中的装配说明组装机器人。
软件与固件
- 上传单片机固件
按照 andino_firmware 包的说明上传单片机固件。
- 使用 Ansible 配置单板机
可以使用社区提供的 Ansible playbook 配置单板机,链接为 https://github.com/garyservin/andino_ansible_config。
- 选择 Raspberry Pi 操作系统
ROS 2 Humble 使用 Ubuntu Mate 22.04 ARM64;ROS 2 Jazzy 使用 Ubuntu Server/Desktop 24.04。
- 将系统写入 microSD 卡
下载目标 ROS 发行版对应的镜像,并使用 Raspberry Pi Imager 安装到 microSD 卡;无需额外配置。
- 启动并完成初始设置
使用 microSD 卡和 HDMI 连接启动 Raspberry Pi,并按向导完成设置;文档建议使用简单凭据,例如用户 pi、密码 admin。
- 更新系统并重启
在终端中运行 sudo apt update && sudo apt upgrade 更新系统,然后重启。
- 安装 SSH 服务器
在树莓派上安装 openssh-server,以便通过同一网络远程访问。
- 启用并连接 SSH
启用 SSH 服务,然后从远程计算机连接树莓派。文档示例为用户 pi 和地址 192.168.0.102。
- 更新软件包索引
更新树莓派的软件包索引,为安装后续依赖做好准备。
- 安装常用工具
安装 git、net-tools、software-properties-common 和 build-essential。
- 安装 ROS Python 包
安装文档列出的 ROS Python 与 Catkin 相关软件包。
- 安装 Colcon 和 ROS 2
按照链接的说明安装 Colcon,并根据 Ubuntu 版本安装 ROS 2 Humble 或 ROS 2 Jazzy。Jazzy 及之后版本应检查树莓派官方说明,并使用 Ubuntu Noble 的 noble-backports。
- 自动加载 ROS 环境
在 `~/.bashrc` 文件中添加 `source /opt/ros/humble/setup.bash`,以便自动加载 ROS 安装环境。
- 安装 Arduino 驱动
在树莓派上安装 Arduino,以支持树莓派与 Arduino 微控制器之间的串行通信。
- 配置串行设备权限
将当前用户加入 `dialout` 和 `plugdev` 组,以使用串行设备。
- 重启以应用组权限
完成用户组配置后重启系统,使权限更改生效。
- 移除 brltty 冲突
在 Ubuntu 22.04 上,从系统中移除 `brltty`,以避免部分芯片驱动与该守护进程的冲突。
- 安装相机软件
将相机模块连接到树莓派相机端口后,安装所需软件包。
- 授予视频设备权限
将当前用户加入 `video` 组,以使用树莓派相机。
- 检查相机状态
运行相机状态命令,检查树莓派相机是否可用。
- 修改启动配置文件
打开 /boot/firmware/config.txt,在 [all] 下添加 start_x=1 和 gpu_mem=128,然后保存并关闭。
- 安装并启动 raspi-config
安装 raspi-config,然后运行 sudo raspi-config。
- 启用树莓派摄像头
进入 Interface Options,选择 camera 并启用它。
- 重启并确认摄像头
重启系统,之后摄像头应该可以正常工作。
- 检查 RPLidar 串口权限
运行 ls -l /dev |grep ttyUSB,检查 RPLidar 串口设备的权限。
- 授予 RPLidar 串口权限
使用 sudo chmod 666 /dev/ttyUSB<number_of_device> 增加设备权限,其中 <number_of_device> 替换为实际设备编号。
- 创建固定 USB 端口名规则
创建每次树莓派启动时执行的规则,将真实 ttyUSBX 端口链接到指定的固定名称。
- 检查连接的 USB 设备
运行 sudo dmesg | grep ttyUSB。测试环境中 Arduino Microcontroller 位于 usb 1-1.2、使用 ttyUSB0,A1M8 Lidar Scanner 位于 usb 1-1.1、使用 ttyUSB1。
- 查找设备 USB 属性
对每个设备运行属性遍历,并找到与 USB 编号匹配的类别下的 idProduct 和 idVendor。文档给出的 Arduino 示例使用 /dev/ttyUSB0。
- 创建机器人工作区
在用户主目录下创建 `robot_ws/src` 工作区。
- 检查 UTF-8 语言环境
检查当前语言环境是否支持 UTF-8,然后安装 locales 软件包。
- 生成并设置英语 UTF-8 语言环境
安装 locales,生成 en_US.UTF-8,并设置 LC_ALL、LANG 和 LANG 环境变量。
- 验证语言环境设置
再次运行 locale,以验证语言环境设置。
- 安装 ROS 2 apt 源软件包
获取 ros2-apt-source 的最新发行版软件包并安装;该软件包提供密钥和 apt 源配置。
- 安装开发工具(可选)
如果要构建 ROS 软件包或进行其他开发,可以安装开发工具。在 Ubuntu 24.04 上,检查 apt 源文件中的套件设置。
- 更新 apt 套件配置
如果缺少 noble-updates 或 noble-backports,编辑 /etc/apt/sources.list.d/ubuntu.sources,将 Suites 行更新为 noble、noble-updates 和 noble-backports。然后清理并更新软件包。
- 安装 ROS 开发工具
更新 apt 缓存并安装 ros-dev-tools。
- 更新 apt 仓库缓存
设置好仓库后,更新 apt 仓库缓存。
- 升级 Ubuntu 系统
安装新软件包之前,确保系统保持最新状态。
- 安装 ROS 桌面版
安装推荐的桌面版软件包,包括 ROS、RViz、演示和教程。
标定与测试
- 检查应用配置
在 include/andino/app/app.h 中检查 App::Config;配置由板级软件包中的 andino::kAppConfig 定义,并在 src/main.cpp 中传给 App。
- 匹配主机串口波特率
将主机串口波特率设置为 57600,使其与板级软件包中的 Board::kSerialBaudRate 一致。
- 检查最大电机速度
在 include/andino/drivers/motor.h 中确认 Motor::kMaxSpeed;最大电机速度的 PWM 占空比为 255。
- 验证开环电机控制
发送 setpwm 255 255 使机器人全速运行,再发送 setpwm 0 0 停止。
- 读取编码器数值
发送 getenc,读取并查看编码器数值。
- 校准每转编码器脉冲数
先发送 rstenc 将编码器归零,然后让电机转动指定的转数,例如 10 转。用编码器总脉冲数除以转数,并保存结果作为控制环的校准值。
- 验证闭环速度控制
发送 setspd <tps> <tps>,其中 tps 表示每秒脉冲数。例如每转 700 ticks 时,setspd 700 700 会让两个电机以每秒 1 转运行,约为 6.28 rad/s。
- 查找开发板串口
运行 `pio device list` 查找开发板的串口。Arduino 开发板通常使用 `/dev/ttyUSB0`,Blue Pill 通常使用 `/dev/ttyACM0`。
- 运行硬件连接检查
在 `andino_firmware` 目录运行 `tools/hw_check.py`,检查与 MCU 的硬件连接和固件刷写是否正常。省略 `--port` 时,如果只连接了一个设备,工具会尝试自动使用该设备。
- 检查电机旋转方向
如果某个电机相对底盘方向反向转动,请切换 L298N 输出的正负极。
- 检查编码器计数方向
前进时编码器值应增加,后退时应减少;如果相反,请切换 A、B 编码器信号。
- 确认摄像头支持状态
如果 supported=1 detected=1,则摄像头正常;否则必须先完成配置。
- 识别每个 USB 设备
如果无法识别设备,可逐个连接并检查命令输出,从而确定每个设备对应的 ttyUSB 端口。
- 记录每个设备的标识属性
记录每个设备的 idProduct 和 idVendor,作为将特定设备固定到指定名称的锚点。
- 运行 C++ 话题发布器
在一个终端中加载环境文件,然后运行 demo_nodes_cpp 的 talker。
- 运行 Python 话题监听器
在另一个终端中加载环境文件,然后运行 demo_nodes_py 的 listener。
- 验证消息发布与接收
确认 talker 显示正在发布消息,listener 显示已听到这些消息。
- 确认 C++ 与 Python API
通过示例验证 ROS 2 的 C++ 和 Python API 均能正常工作。
- 自动选择发行版配置
默认根据 ROS 2 发行版自动选择配置:Humble 使用 nav2_params_humble.yaml,Jazzy 使用 nav2_params_jazzy.yaml。
- 使用自定义参数文件
启动导航栈时传入自定义参数文件路径。
- 配置传感器初始化
include_rplidar 和 include_camera 默认都为 true。可通过启动参数分别关闭或管理每个传感器的初始化。
- 检查 ROS 话题
机器人启动后,使用 ROS 2 CLI 检查环境。运行 ros2 topic list 可显示可用话题,例如 /cmd_vel、/odom、/scan 和 /image_raw。
- 检查 Docker Compose 版本
如果已经安装 Docker Desktop,请从 Docker 菜单选择“About Docker Desktop”,检查 Compose 版本。
- 配置 ROS 2 Control 硬件参数
在 andino_description/urdf/include/andino_control.urdf.xacro 的 ros2_control 标签中,通过 URDF 描述传递硬件接口参数。
采数据与训练
- 使用键盘遥控
使用键盘启动 Andino 的遥控操作。该启动方式类似于运行 teleop_twist_keyboard。
- 使用手柄遥控
使用手柄进行机器人遥控效果更好。启动前需要按照 andino_hardware/README.md 中的说明配置手柄。
- 使用机器人进行建图
使用机器人进行建图,并参阅 `andino_slam` 了解更多信息。
- 使用 rosbag 录制主题
使用 `rosbag_record.launch.py` 执行 `ros2 bag record`,将指定主题保存为 `.bag` 文件。未指定主题时,将录制所有主题。
- 使用键盘遥操作机器人
使用 `teleop_keyboard.launch.py` 通过键盘操作机器人。该文件使用 `teleop_twist_keyboard` 软件包。
- 保存 SLAM 地图
使用 Nav2 提供的 map_saver_cli 节点保存地图,并通过 -f 指定地图名称。
- 调整地图空间阈值
使用 --free 和 --occ 参数修改空闲空间与占用空间的阈值。
- 提供已记录的地图
为导航准备一张已记录的地图;地图录制方法参见 andino_slam。
用起来
- 使用闭环轮速控制
使用 `setspd` 为每个车轮启用 PID 控制器,并可用 `setspd 0 0` 停止电机和禁用 PID。每 33 ms(`pid_rate_hz`,30 Hz)比较目标值与测得脉冲并更新电机 PWM。
- 使用开环 PWM 控制
使用 `setpwm` 禁用 PID,并直接以指定 PWM 值驱动电机。正值使电机前进,负值使电机后退。
- 保持控制命令以防止自动停机
如果 3 秒(`auto_stop_window_ms`)内未收到 `setspd` 或 `setpwm`,电机会停止且 PID 会被禁用。要让机器人持续运动,应周期性发送控制命令。
- 启动 RViz 可视化
运行提供的启动文件,以使用随附配置启动 `rviz2`。
- 启动导航栈
按照 `andino_navigation` 的 README 指令,在真实机器人或仿真中启动基于 Nav2 的导航栈。
- 选择仿真平台
在 Andino 生态提供的平台中选择仿真器;其中推荐使用 `andino_gz`。
- 在 RViz 中可视化 Andino
使用 `rviz.launch.py` 启动 RViz 可视化工具,默认采用 `andino.rviz` 配置。可视化机器人的 3D 模型以及主题信息。
- 连接固件串口监视器
固件刷写后,以 57600 波特率打开开发板的串口连接,以发送固件 README 中描述的固件命令。按 Ctrl+C 退出监视器。
- 启动 Nav2 导航栈
使用地图 YAML 文件路径启动 Andino 导航栈。
- 在保存的地图上导航
地图保存后,按照 andino_navigation 的说明在地图上进行导航。
常见问题
物料
- 树莓派 4B 4GB(可换 8GB)与 64 GB SD 卡
- Arduino Nano(固件也支持 Uno 与 STM32 Blue Pill)+ L298N 双 H 桥驱动
- 2 × DG01D‑E 金属齿轮编码器电机(SparkFun)、TT 电机通用轮与万向轮
- RPLidar A1M8 激光雷达、树莓派 Camera Module V2(800 万像素)、BNO055 IMU
- 18650 电池、电池盒与充电器,12V 转 5V(至少 3A)降压模块,急停开关
- 打印件:底盘、雷达座、电池仓、Arduino 固定座与摄像头外壳;M3 螺丝螺母与扎带
工具
- 一套螺丝刀(README 工具表)
- 3D 打印机或打印服务
- Arduino 排针可能要自行焊接(README 建议焊接方向)
技能
- Ubuntu 与 ROS 2:colcon、rosdep、launch 文件
- udev 规则固定串口名、树莓派摄像头配置
- 用 PlatformIO(Docker)编译与烧录固件
- SLAM 建图与 Nav2 导航
软件
- ROS 2 Humble(Ubuntu 22.04)或 Jazzy(Ubuntu 24.04),有 apt 二进制包,也可用 Ansible 配置
- andino_firmware:PlatformIO 固件,30 Hz 轮速 PID、编码器计数、读取 BNO055,3 秒无指令自动停车
- andino_base(ros2_control 硬件接口)、andino_slam(slam_toolbox)、andino_navigation(Nav2)
- 仿真:andino_gz(推荐)、Webots、O3DE、Isaac Sim、MuJoCo