栗子派昇腾 310B 开发板安装 ROS2 Humble 全流程指南
本文基于真实部署环境,完整记录在栗子派昇腾 310B 开发板(Ubuntu 22.04.5 LTS,aarch64 架构)上安装 ROS2 Humble 的全流程,覆盖软件源配置、安装、环境变量与验证。
一、前置要求
|
项目 |
说明 |
|
硬件 |
栗子派昇腾 310B,已烧录官方 Ubuntu 22.04 LTS 镜像 |
|
系统 |
Ubuntu 22.04.5 LTS(Jammy),架构 aarch64(ARM64) |
|
网络 |
板卡具备可用的外网出口(eth0) |
|
权限 |
root 用户 |
二、系统环境准备(locale)
ROS2 要求系统支持 UTF-8 编码,首次安装先配置 locale:
sudo apt update
sudo apt install -y locales
# 生成 en_US.UTF-8 并设为默认
sudo locale-gen en_US en_US.UTF-8
sudo update-locale LC_ALL=en_US.UTF-8 LANG=en_US.UTF-8
验证:
locale
预期输出中 LANG 与 LC_ALL 均应为 en_US.UTF-8。
三、配置 ROS2 软件源
3.1 添加 GPG 密钥
# 下载 ROS 官方签名密钥
curl -SL https://raw.githubusercontent.com/ros/rosdistro/master/ros.key \
-o /usr/share/keyrings/ros-archive-keyring.gpg
3.2 添加软件源
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/ros-archive-keyring.gpg] http://packages.ros.org/ros2/ubuntu $(. /etc/os-release && echo $UBUNTU_CODENAME) main" \
| sudo tee /etc/apt/sources.list.d/ros2.list > /dev/null
其中 $(. /etc/os-release && echo $UBUNTU_CODENAME) 会自动解析为当前系统代号 jammy,无需手动填写。
3.3 镜像源选择
官方源 packages.ros.org 位于境外,国内直连速度慢,建议替换为国内镜像。以下三个镜像均经实测可用:
|
镜像站 |
地址 |
|
华为云 |
|
|
中科大 USTC |
|
|
清华 TUNA |
|
替换命令(以华为云为例):
sudo sed -i 's|http://packages.ros.org/ros2/ubuntu|https://repo.huaweicloud.com/ros2/ubuntu|' /etc/apt/sources.list.d/ros2.list
镜像与官方源是同一仓库的镜像,结构和签名一致,
signed-by密钥无需更换。
四、安装 ROS2 Humble
4.1 桌面版与基础版
|
版本 |
包名 |
适用场景 |
|
桌面版 |
|
含 RViz2、rqt 等 GUI 工具,需图形环境 |
|
基础版 |
|
无 GUI 依赖,适合无头(headless)部署 |
加速模块若做无头推理、无人车、机械臂节点部署,基础版更省空间且不引入图形依赖;本教程按桌面版记录。
4.2 同步索引并安装
sudo apt update
sudo apt install -y ros-humble-desktop python3-argcomplete python3-colcon-common-extensions
安装约下载 2GB 软件包,共约 270 余个 ROS 包。其中 python3-colcon-common-extensions 为编译工具链,用于后续 colcon build 构建工作空间。
五、配置环境变量
ROS2 命令与库依赖环境变量,需在每次会话前 source:
source /opt/ros/humble/setup.bash
写入 .bashrc 以便自动生效:
echo "source /opt/ros/humble/setup.bash" >> ~/.bashrc
source ~/.bashrc
六、验证安装
source /opt/ros/humble/setup.bash
# 查看发行版
echo $ROS_DISTRO
# 预期输出:humble
# 验证 Python 客户端库
python3 -c "import rclpy; rclpy.init(); print('rclpy OK')"
# 预期输出:rclpy OK
# 查看已安装包数量
ros2 pkg list | wc -l
两点提示:
1. ros2 --version并非有效命令,正确做法是查看ROS_DISTRO环境变量。
2. rclpy模块没有__version__属性,验证导入应直接import rclpy而非访问版本号。
结语
整个安装流程可概括为四步:配置 locale → 添加 ROS2 软件源(推荐换国内镜像)→ apt 安装桌面版/基础版 → 配置环境变量并验证。其中最容易卡住的环节是境外源下载慢,换成华为云/中科大/清华镜像即可显著提速。
如果你在昇腾 310B 上部署 ROS2 时遇到其他问题,欢迎在评论区交流补充。
更多推荐


所有评论(0)