TurtleBot 4 复刻全流程
TurtleBot 4 从采购、打印、组装到装软件、标定和训练的 151 个步骤,附物料表、购买链接与官方出处。
价格未在核对页列出
采购
- 选择支持双频的路由器
使用能够同时支持 2.4 GHz 和 5 GHz 的路由器,以获得最佳性能。
组装
- 启动机器人
将 TurtleBot 4 放到充电座上。底座绿色 LED 会亮起几秒,TurtleBot 4 随即启动;等待机器人完成启动。
- 通过以太网连接树莓派
使用以太网线将电脑直接连接到树莓派;必要时使用 USB 转以太网适配器。
- 关闭机器人并取出存储卡
关闭机器人电源,然后从树莓派中取出 microSD 卡。
- 将存储卡插入电脑
将 microSD 卡插入电脑,必要时使用适配器。
- 连接两个计算单元
使用 USB-C 线缆连接 Create® 3 和 Raspberry Pi;该线缆同时为 Raspberry Pi 供电并建立以太网连接。
软件与固件
- SSH 登录树莓派
通过 SSH 登录 TurtleBot 4 上的树莓派。
- 启用 IPv4 转发
编辑 /etc/sysctl.conf,取消 net.ipv4.ip_forward=1 的注释。
- 获取并安装发现文件
克隆指定分支的 turtlebot4_setup 仓库,将发现配置和安装脚本移到目标位置,然后删除克隆目录。
- 加载其他工作空间
如需使用其他工作空间,在 /etc/turtlebot4_discovery/setup.bash 中配置并加载它们。
- 更新 Bash 启动配置
将 source /etc/turtlebot4_discovery/setup.bash 添加到 .bashrc。
- 重新安装 Upstart 作业
使用更新后的 install.py 脚本重新安装 Upstart 作业,并指定发现设置工作空间。
- 再次 SSH 登录树莓派
再次通过 SSH 登录 TurtleBot 4 上的树莓派。
- 退出设置工具
完成设置后退出设置工具。
- 在终端应用新设置
在终端中运行 turtlebot4-source,使新设置应用到当前终端。
- 重启 ROS 2 守护进程
使用 turtlebot4-daemon-restart,或依次执行 ros2 daemon stop 和 ros2 daemon start,重启 ROS 2 守护进程。
- 更新 Create 3 固件
通过 webserver 将 Create® 3 更新到最新固件。
- 恢复出厂设置并断开 Wi-Fi
固件更新完成后执行 factory reset,使 Create® 3 断开所有 Wi-Fi 网络。
- SSH 登录树莓派
通过 SSH 登录 TurtleBot 4 的 Raspberry Pi。
- 运行 TurtleBot 4 设置工具
在 Raspberry Pi 上运行 TurtleBot 4 设置工具。
- 进入 Discovery Server 菜单
在设置工具中通过 ROS Setup 进入 Discovery Server 菜单。
- 退出演置工具
退出演示中的 TurtleBot 4 设置工具。
- 加载新的环境设置
在终端运行 turtlebot4-source,使新设置应用到终端环境。
- 再次重启 ROS 2 守护进程
再次使用 turtlebot4-daemon-restart,或执行 ros2 daemon stop 和 ros2 daemon start,重启 ROS 2 守护进程。
- 安装用户电脑发现客户端文件
在 User PC Setup 部分克隆 turtlebot4_setup 仓库,并将 ip_route 服务、脚本和 discovery_super_client 文件安装到文档指定的系统目录。所示命令使用 galactic 分支,页面还列出 humble 和 jazzy 标签页。
- 启用并启动 IP 路由服务
重新加载 systemd,启用 ip_route.service,然后启动该服务。
- 加载 Bash 环境设置
运行 source ~/.bashrc,加载 Bash 配置。
- 重启用户电脑 ROS 2 守护进程
依次执行 ros2 daemon stop 和 ros2 daemon start,重启用户电脑上的 ROS 2 守护进程。
- 运行发现服务器配置脚本
运行 configure_discovery.sh,配置用户电脑的 Discovery Server 连接。
- 创建发现配置目录
创建名为 /etc/turtlebot4_discovery/ 的目录。
- 创建发现服务器配置文件
在 /etc/turtlebot4_discovery/ 中创建包含所需配置的 setup.bash 文件。
- 将配置文件加入 Bashrc
在 ~/.bashrc 文件中添加 source /etc/turtlebot4_discovery/setup.bash 这一行。
- 检查并删除已有 IP 路由
检查先前的发现服务器配置方法是否已经创建 IP 路由;如果存在,则删除该路由。
- 加载 Bashrc 配置
运行 source ~/.bashrc,加载 ~/.bashrc 中的配置。
- 重启 ROS 2 守护进程
停止 ROS 2 守护进程,然后重新启动它。
- 运行发现服务器配置脚本
从 turtlebot4_setup 仓库下载并运行 jazzy 分支的 configure_discovery.sh。
- 设置机器人 ROS 域编号
输入机器人或机器人的 ROS_DOMAIN_ID,默认值为 0。
- 设置发现服务器编号
输入发现服务器 ID,默认值为 0;每个服务器必须使用唯一的服务器编号。
- 设置发现服务器 IP 地址
输入发现服务器 IP 地址,通常应使用 TurtleBot4 Raspberry Pi 的 WiFi IP 地址。
- 设置发现服务器端口
输入发现服务器端口,默认值为 11811。
- 应用发现服务器环境配置
设置 ROS_DOMAIN_ID=0 和包含两个服务器地址的 ROS_DISCOVERY_SERVER。
- 加载 Bash 配置更改
对 ~/.bashrc 文件执行 source,以应用更改。
- 配置第一个发现服务器
输入发现服务器 ID 0、IP 地址 192.168.131.5,并使用默认端口 11811,然后选择 a 添加另一个服务器。
- 配置下一个发现服务器
输入发现服务器 ID 1、IP 地址 192.168.131.6,并使用默认端口 11811,然后选择 d 完成配置。
- 确认发现服务器环境变量
确认 ROS_DOMAIN_ID 为 0,ROS_DISCOVERY_SERVER 包含两个服务器地址,并按提示输入 sudo 密码。
- 加载 bashrc 使更改生效
加载 ~/.bashrc 文件,使发现服务器配置更改生效。
标定与测试
- 保存发现服务器配置
在 Web 服务器中进入 Application -> Configuration,并保存显示的发现服务器设置。
- 进入发现服务器菜单
通过 ROS Setup 进入 Discovery Server 菜单。
- 启用发现服务器
将 Enabled 设置为 True。
- 保留板载服务器端口
将 onboard server port 保留为 11811。
- 设置板载服务器 ID
为系统设置唯一的板载服务器编号。单台机器人可保留为 0;多台机器人时,每台应使用 0 到 255 之间的不同编号。
- 保留默认的服务器设置
其余设置保留默认值。offboard IP address 为空时,所有 offboard server 设置都会被忽略。
- 保存并应用设置
保存设置,返回主菜单并应用设置。
- 列出 Create 3 主题
Create® 3 发出提示音后,运行 ros2 topic list 查看主题。
- 启用 Discovery Server
将 Enabled 设置为 True。
- 保留板载服务器端口
将 onboard server port 保留为 11811。
- 设置板载服务器 ID
将 onboard server ID 设置为系统中的唯一编号。只有一台机器人时可保留为 0;有多台机器人时,每台使用 0 到 255 之间的不同编号。
- 保留默认的外部服务器设置
其余 offboard server 设置保留默认值。将 offboard IP address 留空时,所有 offboard server 设置都会被忽略。
- 保存并应用设置
保存设置,返回主菜单,然后应用设置。
- 确认主题列表
Create® 3 发出提示音后,再次运行 ros2 topic list 查看主题。
- 修改 IP 路由脚本
在 /usr/local/sbin/ip_route.sh 中替换 10.42.0.1。
- 修改发现客户端 XML
在 /etc/turtlebot4_discovery/discovery_super_client.xml 中替换 127.0.0.1。
- 修改发现服务器设置脚本
在 /etc/turtlebot4_discovery/setup.bash 中替换 127.0.0.1。
- 检查用户电脑主题
在用户电脑终端运行 ros2 topic list,检查可见主题。
- 设置机器人 ROS_DOMAIN_ID
输入机器人的 ROS_DOMAIN_ID,默认值为 0。
- 设置发现服务器 ID
输入 Discovery Server ID,默认值为 0;每个服务器必须使用唯一的服务器 ID。
- 设置发现服务器 IP 地址
Enter the Discovery Server IP address, which most often should be the TurtleBot 4 Raspberry Pi Wi-Fi IP.
- 设置发现服务器端口
输入 Discovery Server port,默认值为 11811。
- 列出 ROS 2 主题
运行 ros2 topic list,列出 ROS 2 主题。
- 设置机器人 1 命名空间
将 ROBOT_NAMESPACE 设置为 /robot1。
- 启用机器人 1 板载服务器
启用板载服务器,将端口设为 11811,服务器 ID 设为 0。
- 设置机器人 1 板外服务器
将板外服务器 IP 留空,端口设为 11811,服务器 ID 设为 1。
- 设置机器人 1 Wi-Fi
将 Wi-Fi 模式设为 Client,SSID 设为 my_ttb4_network,密码设为 secure_password,频段设为 5GHz。启用 DHCP,并将 IP 地址留空。
- 设置机器人 2 命名空间
将 ROBOT_NAMESPACE 设置为 /robot2。
- 启用机器人 2 板载服务器
启用板载服务器,将端口设为 11811,服务器 ID 设为 1。
- 设置机器人 2 板外服务器
将板外服务器 IP 留空,端口设为 11811,服务器 ID 设为 1。
- 设置机器人 2 Wi-Fi
将 Wi-Fi 模式设为 Client,SSID 设为 my_ttb4_network,密码设为 secure_password,频段设为 5GHz。启用 DHCP,并将 IP 地址留空。
- 设置 ROS 域 ID
在用户计算机上接受 ROS_DOMAIN_ID 0。
- 添加第一个发现服务器
输入第一个发现服务器的 ID 0、IP 192.168.131.5,并使用端口 11811。然后选择 a 添加另一个服务器。
- 添加第二个发现服务器
输入下一个发现服务器的 ID 1、IP 192.168.131.6,并使用端口 11811。完成后选择 d。
- 查找新的 Raspberry Pi IP
Wi-Fi 设置生效后,Raspberry Pi 会重启并连接到网络,DHCP 会分配新的 IP 地址。TurtleBot 4 的 IP 地址显示在显示屏顶部;TurtleBot 4 Lite 则需要检查 /ip 主题。
- 使用 Galactic 查看 IP
在 ROS Galactic 环境中设置 RMW 实现和 ROS_DOMAIN_ID,然后监听 /ip 主题。
- 使用 Humble 查看 IP
在 ROS Humble 环境中设置 RMW 实现和 ROS_DOMAIN_ID,然后监听 /ip 主题。
- 使用 Jazzy 查看 IP
在 ROS Jazzy 环境中设置 RMW 实现和 ROS_DOMAIN_ID,然后监听 /ip 主题。
- 确认终端输出的 IP
在终端中确认 IP 地址会周期性打印出来,例如 192.168.28.24。
- 通过网关查找 IP
如果之前的方法无法找到 IP 地址,登录网关并查找主机名为 “ubuntu” 的设备。
采数据与训练
- 启动 Galactic 键盘遥控
启动 CLI 界面,通过按键控制机器人行驶。
- 启动 Humble 键盘遥控
启动 CLI 界面,通过按键控制机器人行驶。
- 启动 Jazzy 键盘遥控
以 stamped:=true 参数启动 CLI 键盘遥控界面,通过按键控制机器人行驶。
- 使用按键驾驶机器人
按 i 让机器人前进,按 j 让机器人左转,其他按键也用于控制行驶。
- 调整线速度和角速度
行驶过程中可以调整机器人的线速度和角速度。
- 使用摇杆遥控机器人
按住 L1 或 R1,并移动左侧摇杆来驱动机器人。默认情况下,L1 以普通速度驱动,R1 以加速模式驱动;这些按钮可在配置文件中更改。
用起来
- 发布速度命令
通过 /cmd_vel 主题发送 geometry_msgs/Twist 或 geometry_msgs/msg/TwistStamped 速度消息。命令中的各速度分量初始值均为 0.0。
- 设置直线和旋转速度
设置 linear.x 使机器人前进或后退,设置 angular.z 使机器人向左或向右旋转。
- 发送 Create 3 动作
使用 DriveDistance、DriveArc 和 RotateAngle ROS 2 动作控制机器人。示例命令以 0.3 m/s 的速度向前行驶 0.5 m。
- 使用新 IP 重新 SSH
找到新的 IP 地址后,使用该地址 SSH 重新连接到机器人。
- 移动前更新无线网络
将 TurtleBot 4 移到使用不同无线网络的新位置前,重新配置树莓派以连接该网络,或将其置于 AP 模式;否则它会继续尝试连接原网络。
物料
- iRobot Create 3 底盘
- 树莓派 4B 4GB
- OAK‑D‑Lite(Lite 版)或 OAK‑D‑Pro(标准版)
- RPLIDAR A1M8
工具
- 整机交付,无需打印
技能
- ROS 2
软件
- ROS 2 用户手册