Files
a7l20-cup-grasp/docs/INSTALL.md
T

3.2 KiB
Raw Blame History

环境配置

系统与连接

  • Ubuntu 24.04 x86_64,Python 3.12 + venv;不使用 conda。
  • ROS 2 Jazzy;需要 rclpy、sensor_msgs、geometry_msgs、control_msgs、trajectory_msgs、shape_msgs、std_srvs、rosidl_runtime_py 和 moveit_msgs。几何模块复用消息类型,不要求启动 MoveIt Servo。
  • D405 使用 realsense2_camera,848×480、30 FPS、对齐深度;执行入口会复用或启动相机驱动。避免其他程序独占设备。
  • 下位机地址 192.168.10.21,原生 ROSBridge 端口 9090,机械臂保留厂家桥服务及反馈接口。
  • 左手 can0,1 Mbps,设备身份默认 LHT20-011-263-L-B-1-D,标定表随包提供;其他设备必须重新确认身份与标定,不能直接套用。
  • ROS_DOMAIN_ID 默认 29。主机和下位机网络、USB/CAN 权限由现场配置。

已安装 ROS 2 软件源的机器可补充系统组件:

sudo apt install python3.12-venv python3-pip iproute2 libgl1 libglib2.0-0 \
  ros-jazzy-ros-base ros-jazzy-realsense2-camera ros-jazzy-rosbridge-server \
  ros-jazzy-control-msgs ros-jazzy-trajectory-msgs ros-jazzy-shape-msgs \
  ros-jazzy-moveit-msgs ros-jazzy-rosidl-runtime-py
bash scripts/setup.sh
bash run.sh check

requirements.txt 锁定原工作环境中实际使用的直接依赖版本。setup.sh 创建独立 .venv,并允许访问系统 ROS Python 包;不复制旧 venv。SDK 动态库随包保留在 runtime/arm/vendor,Linux x86_64 使用,其他架构需厂家对应库。

首次使用 CAN 且接口未启用时:

sudo ip link set dev can0 up type can bitrate 1000000

此命令只配置 CAN 接口;机械臂使能由现场操作,不由安装脚本完成。

配置

需要覆盖解释器、ROS 环境或域号时,将 config/local.env.example 复制为 config/local.env 后编辑。文件已排除出 Git。直接运行 Python 模块前,先 source scripts/environment.sh,再 source 对应 ROS setup.bash。

config/camera_extrinsics_current.json 为共同 base_link 外参,右臂标定的指尖偏移不用于左手。视觉主线使用每轮新 RGB-D 与实测局部运动映射;默认杯子模式使用已保存的 HUG 形状模板,再优化当前几何,不要求现场运行大模型。

可选新物体 HUG 模式

--object-mode pointcloud 不是默认杯子流程。额外需要 HUG 源码、hug_full.safetensors 权重和其独立推理环境,以及 retarget_l20_v2.py 所在 retargeting 目录、dex-retargeting / pinocchio / PyYAML 环境。通过 HUG_ROOT、RETARGETING_ROOT、RETARGET_PYTHON 配置;权重和这些独立环境不包含在本仓库。本次不宣称此可选模式完成独立安装验收。

可选通用轨迹回放

默认杯子观察位路线不需要此组依赖。使用 runtime/arm 的通用 follow 轨迹规划时,先安装并编译离线 MoveIt TOTG 辅助程序:

sudo apt install g++ libeigen3-dev ros-jazzy-moveit-core ros-jazzy-ruckig
.venv/bin/python -m pip install -r requirements-replay.txt
.venv/bin/python runtime/arm/build_totg.py

源文件为 runtime/arm/cpp/totg_offline.cpp,输出 runtime/arm/build/totg_offline。构建与离线定时均不连接机器人;实际执行仍受原控制检查约束。CUP_ROS_PREFIX 可覆盖 ROS 安装目录,默认从 CUP_ROS_SETUP 推导。