正在连接信源…

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 的说明在地图上进行导航。

常见问题

  • 打印的底盘缺少安装孔,打印后仍需手动钻孔。 #14
  • Gazebo 仿真可运行,但真机无法正常工作。 #274
  • 首次 colcon 构建因 ROS 依赖未满足而失败。 #117 #272
  • Arduino 固件编译失败,缺少所需库清单。 #276
  • 电机只能开关,无法调节速度。 #292

物料

  • 树莓派 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

文档