Thor 上安装 Isaac ROS
中文译本 · 原文 Thor 上安装 Isaac ROS
在连着 Unitree G1 的计算机上准备 Isaac ROS 开发环境。
这一步会装上 isaac-ros CLI、ROS 2 工作区、Isaac ROS 源码仓库、容器化的 Isaac ROS 环境、RealSense 支持,以及后面真机流程用到的包安装路径。
更细的选项见官方文档:
- Isaac ROS Getting Started
- Isaac ROS RealSense Setup
- Unitree G1 Teleop Bringup
- Unitree G1 GR00T Deploy
初始化计算平台
- 完成 Jetson AGX Thor Quick Start Guide,然后回到这里。
- 按 JetPack 安装说明装好 JetPack 组件,然后回到这里。
- 核对 JetPack 版本,输出里应有
R38 (release), REVISION: 4.0。
cat /etc/nv_tegra_release
- 把 Thor 功耗模式设成
MAXN。细节见 功耗模式说明。
sudo /usr/sbin/nvpmodel -m 0
创建 Isaac ROS 工作区
mkdir -p "$HOME/workspaces/isaac_ros-dev/src"
echo "export ISAAC_ROS_WS=\"\${ISAAC_ROS_WS:-$HOME/workspaces/isaac_ros-dev/}\"" >> ~/.bashrc
source ~/.bashrc
cd ${ISAAC_ROS_WS}/src
git clone https://github.com/NVIDIA-ISAAC-ROS/isaac_ros_physical_ai.git
git clone https://github.com/NVIDIA-ISAAC-ROS/isaac_ros_robots.git
git clone https://github.com/NVIDIA-ISAAC-ROS/isaac_ros_data_tools.git
放行 CloudXR 端口
CloudXR 需要若干网络端口。Quest 和 PICO(WebXR 客户端)至少要打开 CloudXR 运行时和 WebSocket Secure 代理端口。若启用了 ufw:
sudo ufw allow 47998/udp sudo ufw allow 49100,48322/tcp
如果从源码跑 WebXR 客户端,再放行网页端口:
sudo ufw allow 8080,8443/tcp
安装并初始化 Isaac ROS CLI
下面按 Isaac ROS 文档的 Docker 流程。裸机或虚拟环境见官方文档。
locale # check for UTF-8 sudo apt update && sudo apt install locales sudo locale-gen en_US en_US.UTF-8 sudo update-locale LC_ALL=en_US.UTF-8 LANG=en_US.UTF-8 export LANG=en_US.UTF-8 locale # verify settings
sudo apt update && sudo apt install curl gnupg sudo apt install software-properties-common sudo add-apt-repository universe
k="/usr/share/keyrings/nvidia-isaac-ros.gpg"
curl -fsSL https://isaac.download.nvidia.com/isaac-ros/repos.key | sudo gpg --dearmor \
| sudo tee -a $k > /dev/null
f="/etc/apt/sources.list.d/nvidia-isaac-ros.list"
sudo touch $f
s="deb [signed-by=$k] https://isaac.download.nvidia.com/isaac-ros/release-4.5 noble-jetpack main"
grep -qxF "$s" $f || echo "$s" | sudo tee -a $f
sudo apt-get update
sudo apt-get install isaac-ros-cli
sudo nvidia-ctk runtime configure --runtime=docker --set-as-default
cat /etc/docker/daemon.json
期望类似:
{
"runtimes": {
"nvidia": {
"args": [],
"path": "nvidia-container-runtime"
}
},
"default-runtime": "nvidia"
}
sudo usermod -aG docker $USER newgrp docker
sudo systemctl daemon-reload && sudo systemctl restart docker
docker info | grep -E "Runtimes|Default Runtime" docker run --rm hello-world docker run --rm --gpus all ubuntu:24.04 bash -lc 'echo "NVIDIA runtime OK"'
提示
若 nvidia 不是默认 runtime,先回到 Docker 配置改完再继续。改了 /etc/docker/daemon.json 之后要再重启 Docker。
docker run --rm --gpus all ubuntu:24.04 nvidia-smi
输出里应能看到 NVIDIA Thor,驱动大约 580、CUDA 13.0。这是在确认容器能用到 NVIDIA runtime。失败的话,即使 Docker 已经在跑,也先完成 Jetson AGX Thor 的 Docker 设置再继续。
sudo isaac-ros init docker
echo '--ulimit rtprio=99' > ~/.isaac_ros_dev-dockerargs
这样 ROS 2 controller manager 才能跑在实时线程上。
配置 RealSense
本流程用装在机器人头部的 Intel RealSense。先按连接方式接好相机。
- 开始时先不要插相机。在主机上加 udev 规则,输出里应有
Successfully added udev rules。然后再接上 RealSense。Thor 背包把相机直接插到 Thor;外置 Thor 需要 USB 延长线。接法见下一课的连接图。
wget https://raw.githubusercontent.com/realsenseai/librealsense/v2.56.3/config/99-realsense-libusb.rules && \ sudo mv 99-realsense-libusb.rules /etc/udev/rules.d/ && \ sudo udevadm control --reload-rules && sudo udevadm trigger && echo "Successfully added udev rules"
- 让 Isaac ROS Docker 镜像带上 Physical AI 工作流和 RealSense。
realsense层是相机驱动,gr00t_workflow层是本流程后面用到的全部 ROS 包。
mkdir -p ~/.config/isaac-ros-cli && tee ~/.config/isaac-ros-cli/config.yaml << 'EOF'
docker:
image:
additional_image_keys:
- gr00t_workflow
- realsense
EOF
isaac-ros activate --build-local
rs-enumerate-devices
realsense-viewer
realsense-viewer 需要图形环境,接显示器或远程桌面。相机没被认出时,先按排错指南查硬件,再继续。
接下来
源码在 ${ISAAC_ROS_WS}/src。gr00t_workflow 层包含后面课会用到的包:
ros-$ROS_DISTRO-isaac-ros-unitree-g1-teleop-bringupros-$ROS_DISTRO-isaac-ros-unitree-g1-recorderros-$ROS_DISTRO-isaac-ros-unitree-g1-gr00t