主题
准备 ROS 2 遥操环境
ROS 2 单臂遥操
网页输入在服务进程内转换,见 键盘输入说明。mock 和 aubo 不需要安装 NVIDIA Capture 或独立输入环境。
实机操作遵循现场联调要求。先完成只读与 inactive 连接核对;进入启用/运动前,还需落实实时系统、现场安装和首轮有限运动保护。下方实机入口尚未自动强制检查全部前提,不能将命令可启动理解为运动验收已通过。
支持 Ubuntu 24.04 ARM64/AMD64 / ROS 2 Jazzy。先按 ROS 官方 deb 安装配置官方 apt 源;系统安装采用下列无头依赖,不安装 RViz、ROS desktop 或包含可视化依赖的 MoveIt 元包。Servo 二进制由构建入口按仓库锁定哈希和文件白名单安装到项目产物前缀,不安装上游演示入口和 RViz 配置。
sh
sudo apt-get install --no-install-recommends ros-jazzy-ros-base ros-jazzy-ros2-control ros-jazzy-ros2-controllers ros-jazzy-moveit-kinematics ros-jazzy-moveit-ros-planning-interface ros-jazzy-robot-state-publisher ros-jazzy-joy ros-jazzy-launch-param-builder ros-jazzy-moveit-configs-utils ros-jazzy-rosbag2 python3-colcon-common-extensions gdb
# RRD 官方插件使用 Rust;已安装 rustup 时只需安装配方所列工具链。
# 项目内安装不会修改 shell 配置或系统 ROS。
mkdir -p artifacts/ros2
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs -o artifacts/ros2/rustup-init.sh
CARGO_HOME="$PWD/artifacts/ros2/rust/cargo" RUSTUP_HOME="$PWD/artifacts/ros2/rust/rustup" sh artifacts/ros2/rustup-init.sh -y --no-modify-path --profile minimal --default-toolchain 1.98.0
uv run pride build ros2
uv run pride build workbench
uv run pride hardware teleop --device mock --port 8098
uv run pride hardware teleop --device mock --manual-jog --port 8099
uv run pride hardware teleop --device aubo --address 192.168.77.100 --manual-jog --prepare-only
uv run pride rerun runs/<completed-teleop-run>
# 失败控制会话只用于诊断;不会变成成功归档或训练数据
uv run pride rerun runs/<failed-teleop-run> --diagnostic
uv run pride check ros2
uv run pride check teleop-presets --timeout 600
uv run pride check learning-bridge
uv run pride hardware export-lerobot runs/<completed-teleop-run> --output artifacts/<new-dataset> --task "单臂示教任务说明"工控机 ubuntu 用户部署到 /home/ubuntu/pride 后,可使用版本化 systemd 单元。该单元启动 mock 会话,硬件保持 inactive;实机连接须按下文现场入口单独选择,不能把服务启动当作实机使能。服务授予 ROS 进程实时调度所需的资源上限,是否实际采用实时调度仍需检查运行日志。
sh
sudo install -m 0644 configs/systemd/pride-teleop.service /etc/systemd/system/pride-teleop.service
sudo systemctl daemon-reload
sudo systemd-analyze verify /etc/systemd/system/pride-teleop.service
sudo systemctl enable --now pride-teleop
sudo systemctl status pride-teleop --no-pager工控机的当前诊断部署位于 /home/ubuntu/Developer/pride-telemetry,控制柜位于独立网段 192.168.78.100。 以下覆盖配置将同一 8098 服务切到该部署的 aubo inactive 会话;没有选择人工点动,服务端拒绝使能, 页面只显示实机反馈与独立遥测。单次服务最多 30 分钟,不自动重启;需要新会话时显式重启。 先构建工作台并核对目录、地址及无其他实机控制会话,再安装覆盖配置。基础单元仍默认 mock。
sh
sudo install -d -m 0755 /etc/systemd/system/pride-teleop.service.d
sudo install -m 0644 configs/systemd/pride-teleop-ipc-diagnostics.conf /etc/systemd/system/pride-teleop.service.d/20-ipc-diagnostics.conf
sudo systemctl daemon-reload
sudo systemd-analyze verify pride-teleop.service
sudo systemctl restart pride-teleop.service
systemctl show pride-teleop.service -p ActiveState -p WorkingDirectory -p ExecStart -p Restart -p RuntimeMaxUSec
curl --fail --silent http://192.168.77.2:8098/api/snapshot浏览器访问 http://192.168.77.2:8098,应显示“实机诊断”“ROS 2 · AUBO 实机”、当前关节读数和采集中的独立遥测。 HTTP 返回 200 或 systemd 显示 active 不代替浏览器和反馈检查。恢复原基础单元时,移除本次覆盖配置再重启:
sh
sudo rm /etc/systemd/system/pride-teleop.service.d/20-ipc-diagnostics.conf
sudo systemctl daemon-reload
sudo systemctl restart pride-teleop.service遥操入口默认 mock,运行真正的 ROS 2、TF2、MoveIt Servo 和 ros2_control GenericSystem,默认六关节裸臂,最长 30 分钟。设备初始为 inactive;浏览器先点“启用遥操”,再获取控制权,按住方向按钮或聚焦按钮后按住 Space / Enter;也可聚焦“键盘操作区”,使用 W/S、A/D、Q/E、Z/X、T/G、C/V 控制六轴。按钮和按键均在网页服务进程内转换;关节模式一次只操作一个轴。释放输入停止,离开键盘区清零,窗口失焦释放控制权。“停用遥操”停用控制器并将硬件切回 inactive;重新启用不会恢复旧控制权。停止按钮锁定后,反馈停稳才允许复位。
teleop-presets 在隔离 ROS mock 中自动启用并逐项运行 14 个验收预设,然后停用、归档,并在独立 Isaac Lab CPU PhysX 环境中重放关节参考。涵盖 5 秒保持、六轴分别往返、使能释放/软件停止/输入超时、基座坐标系三轴 ±5 mm 短直线和 10 mm XY 方框。每项最多 60 秒,整次检查限时 600 秒;物理阶段最多 150 秒墙钟,不启动相机或 GPU 渲染。它没有真机选项,也不在网页开放自动验收动作。结果位于 runs/acceptance-*/report.md,最近一次索引为 artifacts/teleop-acceptance/latest.json;其中 ros/ 是可由既有 Rerun 入口读取的完整遥操记录。验收语义和参数见 ROS 2 集成。
--device aubo 必须提供明确 IPv4 地址。--prepare-only 只归档实机配置,不连接网络或启动 ROS,可在网线未接时审查。已验证范围统一见实机状态,本页不把历史连接检查扩大为运动验收。现场连接恢复后的入口如下;未指定 --manual-jog 时,实机只允许 inactive 连接,网页启用请求会被拒绝。软件不负责上电、松刹车、清除控制柜故障或写硬件参数。
sh
uv run pride hardware teleop --device aubo --address 192.168.77.100 --port 8098--manual-jog 在同一入口开放六轴关节点动,适用于 mock 和 aubo。它仍从 inactive 启动,由浏览器操作者启用并获取控制权。每次一个轴,默认速度上限 2°/s,可选 0.5–2°/s,单次最多 5 秒;松手停止,连续停稳后可以反向或换轴。每轴相对启用起点保持 ±10°监督范围,原生另设目标/反馈和时长保护。微脉冲及固定关节参数已删除。详细操作、参数语义和证据边界见人工点动。
工控机当前实机入口,浏览器地址为 http://localhost:8098:
sh
uv run pride hardware teleop --device aubo --address 192.168.78.100 --manual-jog --host 0.0.0.0 --port 8098
# 使用具备实时调度资源上限的既有系统服务
sudo install -m 0644 configs/systemd/pride-teleop-ipc-manual.conf /etc/systemd/system/pride-teleop.service.d/30-ipc-manual.conf
sudo systemctl daemon-reload
sudo systemctl restart pride-teleop.service实机启用继续要求运行中的 PREEMPT_RT、有效 Running/Normal 反馈和连续停稳。工控机系统服务设置 LimitRTPRIO=99,实际线程调度仍须从运行证据核对;临时用户服务不能替代该资源权限。
构建按主机架构固定官方 ARM64/AMD64 AUBO C++ SDK 0.24.1-rc.3,控制柜 API 必须为已记录的 0.24(24000);型号、自由度、关节顺序和名义运动学不匹配时拒绝配置。凭据复用 AUBO_USERNAME / AUBO_PASSWORD,不会写入配置与归档。SDK 与 Python 只读观察器的环境独立,后者继续使用原锁定版本。
后台原始记录在该次 runs/teleop-*/。Ctrl+C 结束会话,完成 RRD 与 manifest 归档;导出仅接受已完成、完整且只含关节模式的示教记录。LeRobot 数据集不上传,位置单位 rad,动作是输入 Servo 的关节速度 rad/s,不能将动作列解释成末端位姿、位置目标或控制柜实际输出。混合末端模式记录保留为原始 RRD。
learning-bridge 首次同步独立的 backends/learning 锁定环境,包含 LeRobot 0.7.0 / Torch 2.10.0 CUDA 13.0,下载体积较大;检查只执行 mock 控制和本地数据读回,不运行 GPU 训练。自研适配类是 lerobot_robot_pride_is7.PrideIS7 / PrideIS7Config,通过 LeRobot 官方插件发现加载,默认只读,动作需显式 control=True。未配置摄像头和手部特征。
纯只读观察仍使用独立 SDK 入口。实机连接、模式切换和停止延迟需要接回设备后分别验收;范围、接口和当前证据见 ROS 2 集成及 ROS 运行时(backends/ros2/README.md)。
真机与 mock 的键盘输入
键盘输入转换随网页服务在同一进程执行,使用已有 NumPy/SciPy;不需要独立输入环境或 NVIDIA Capture。遥操入口自动选择网页环境,检查见下方 ROS 2 集成验收。