树莓派4B上ROS2 Humble开发环境搭建：Ubuntu 22.04 LTS最佳实践
树莓派4B上ROS2 Humble开发环境搭建：Ubuntu 22.04 LTS最佳实践
树莓派4B作为一款高性能的单板计算机，在机器人开发领域广受欢迎。结合Ubuntu 22.04 LTS的稳定性和ROS2 Humble的最新特性，可以构建一个功能强大且易于维护的机器人开发平台。本文将详细介绍从系统安装到ROS2环境配置的全流程，特别针对树莓派4B的硬件特性进行优化，帮助开发者快速搭建高效的开发环境。
1. 系统准备与安装
1.1 硬件准备清单
在开始之前，请确保准备好以下硬件设备：
- 树莓派4B主板（建议4GB或8GB内存版本）
- 至少32GB的microSD卡（推荐使用UHS-I Class 10及以上规格）
- 5V/3A Type-C电源适配器
- 散热套件（散热片或风扇）
- HDMI显示屏及连接线
- USB键盘和鼠标
- 读卡器（用于烧录系统镜像）
提示：树莓派4B对电源质量较为敏感，使用劣质电源可能导致系统不稳定或性能下降。
1.2 Ubuntu 22.04 LTS镜像选择
针对树莓派4B，Ubuntu官方提供了专门优化的镜像版本。我们推荐使用以下镜像：
| 镜像类型 | 适用场景 | 下载地址 |
|---|---|---|
| Ubuntu Server 22.04 LTS | 无GUI需求，资源占用低 | 官方下载 |
| Ubuntu Desktop 22.04 LTS | 需要图形界面 | 官方下载 |
对于ROS2开发，如果不需要图形界面，建议选择Server版本以获得更好的性能表现。
1.3 系统烧录步骤
使用Raspberry Pi Imager工具可以简化系统烧录过程：
# 在Linux系统下安装Raspberry Pi Imager sudo apt update sudo apt install rpi-imager烧录步骤：
- 插入microSD卡到读卡器并连接电脑
- 打开Raspberry Pi Imager
- 选择"Other general-purpose OS" > "Ubuntu" > 所需版本
- 选择目标存储设备（microSD卡）
- 点击"Write"开始烧录
注意：烧录过程会擦除SD卡上所有数据，请提前备份重要文件。
2. 系统基础配置
2.1 首次启动设置
完成系统烧录后，将microSD卡插入树莓派并接通电源：
- 按照屏幕提示完成初始设置
- 设置用户名和密码
- 配置Wi-Fi网络连接（可选）
- 应用系统更新
首次启动后，建议立即执行系统更新：
sudo apt update && sudo apt upgrade -y sudo reboot2.2 性能优化配置
针对树莓派4B的硬件特性，进行以下优化：
CPU调频策略设置
# 安装cpufrequtils sudo apt install cpufrequtils # 设置性能模式 echo 'GOVERNOR="performance"' | sudo tee /etc/default/cpufrequtils sudo systemctl restart cpufrequtils内存交换优化
# 调整swappiness值 echo 'vm.swappiness=10' | sudo tee -a /etc/sysctl.conf sudo sysctl -p # 禁用不必要的服务 sudo systemctl disable snapd.service sudo systemctl disable snapd.seeded.service3. ROS2 Humble安装与配置
3.1 安装前准备
确保系统已安装必要的依赖项：
sudo apt install -y \ build-essential \ cmake \ git \ python3-colcon-common-extensions \ python3-flake8 \ python3-pip \ python3-pytest-cov \ python3-rosdep \ python3-setuptools \ python3-vcstool \ wget3.2 设置软件源
添加ROS2 Humble的官方软件源：
sudo apt update && sudo apt install -y curl gnupg lsb-release sudo curl -sSL https://raw.githubusercontent.com/ros/rosdistro/master/ros.key -o /usr/share/keyrings/ros-archive-keyring.gpg echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/ros-archive-keyring.gpg] http://packages.ros.org/ros2/ubuntu $(source /etc/os-release && echo $UBUNTU_CODENAME) main" | sudo tee /etc/apt/sources.list.d/ros2.list > /dev/null3.3 安装ROS2 Humble基础包
sudo apt update sudo apt install -y ros-humble-desktop安装完成后，初始化rosdep：
sudo rosdep init rosdep update3.4 环境变量配置
将ROS2环境变量添加到bashrc中：
echo "source /opt/ros/humble/setup.bash" >> ~/.bashrc source ~/.bashrc4. 开发环境验证与测试
4.1 基础功能测试
运行简单的ROS2节点测试安装是否成功：
ros2 run demo_nodes_cpp talker在另一个终端中运行：
ros2 run demo_nodes_py listener如果能看到消息传递，说明ROS2基础功能正常。
4.2 性能基准测试
使用rqt_graph查看节点通信：
ros2 run rqt_graph rqt_graph测试ROS2通信延迟：
ros2 run performance_test perf_test4.3 开发工具配置
推荐安装的开发工具：
- VS Code：轻量级代码编辑器
- rqt：ROS2可视化工具集
- ros2bag：数据记录与回放工具
- TurtleBot3：仿真测试平台
安装VS Code：
sudo apt install -y wget wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > packages.microsoft.gpg sudo install -o root -g root -m 644 packages.microsoft.gpg /usr/share/keyrings/ sudo sh -c 'echo "deb [arch=amd64,arm64,armhf signed-by=/usr/share/keyrings/packages.microsoft.gpg] https://packages.microsoft.com/repos/code stable main" > /etc/apt/sources.list.d/vscode.list' sudo apt update sudo apt install -y code5. 高级配置与优化
5.1 网络性能优化
对于多机ROS2通信，建议进行以下网络优化：
# 增加网络缓冲区大小 echo 'net.core.rmem_max=2097152' | sudo tee -a /etc/sysctl.conf echo 'net.core.wmem_max=2097152' | sudo tee -a /etc/sysctl.conf sudo sysctl -p5.2 实时性优化
对于需要实时控制的应用，可以安装PREEMPT-RT内核：
sudo apt install -y linux-raspi-rt-5.15 sudo reboot5.3 电源管理优化
延长树莓派在电池供电下的工作时间：
# 降低CPU电压 echo 'arm_freq_min=600' | sudo tee -a /boot/config.txt echo 'core_freq_min=250' | sudo tee -a /boot/config.txt # 禁用HDMI输出 echo 'hdmi_blanking=1' | sudo tee -a /boot/config.txt sudo reboot6. 常见问题解决
6.1 安装问题排查
问题1：rosdep初始化失败
解决方案：
sudo rm -f /etc/ros/rosdep/sources.list.d/20-default.list sudo rosdep init rosdep update问题2：ROS2节点无法通信
检查防火墙设置：
sudo ufw allow 11811/tcp sudo ufw allow 11812/tcp6.2 性能问题优化
内存不足处理
增加zram交换空间：
sudo apt install -y zram-config sudo systemctl restart zram-configCPU过热降频
安装散热监控工具：
sudo apt install -y rpi-monitor sudo systemctl enable rpi-monitor sudo systemctl start rpi-monitor在实际项目中，我发现树莓派4B运行ROS2 Humble时，合理配置交换空间和CPU调频策略可以显著提升系统稳定性。特别是在运行多个节点时，建议将swappiness值设置为10-20之间，避免频繁的磁盘交换影响性能。