正在连接信源…

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 用户手册

文档