How xchallenge-zespol-pw/unitree_moveit2 works
This repository provides Unitree G1 arm manipulation through MoveIt 2, with an optional lidar filter that removes ball points before obstacle mapping. The main workflow is to start the robot-specific MoveIt configuration, use the manipulation interface to prepare a collision scene and request arm motions, then execute those motions through MoveIt. The interface delegates planning and execution to the arm controller and scene updates to the collision manager. The README is brief; finer capabilities come from sampled source comments and launch files, so unsampled connections are omitted.
Main entry points: move_group.launch.py MoveIt Launch · obstacle_remover_node.cpp Cloud Filter · unitree_moveit_interface.cpp Manipulation Interface · arm_controller.cpp Arm Controller
Components 17
MoveIt Setup
- MoveIt Launch
g1_moveit/launch/move_group.launch.py - G1 Robot Model
g1_moveit/config/g1_29dof.urdf.xacro - MoveIt Move Group
Arm Manipulation
- Manipulation Interface
unitree_arms/src/unitree_moveit_interface.cpp - Arm Controller
unitree_arms/src/arm_controller.cpp
Collision Scene
- Collision Manager
unitree_arms/src/collision_manager.cpp - Planning Scene
Obstacle Filtering
- Filter Launch
obstacle_remover_node/launch/obstacle_remover.launch.py - Filter Entry
obstacle_remover_node/src/obstacle_remover_node_main.cpp - Cloud Filter
obstacle_remover_node/src/obstacle_remover_node.cpp - MoveIt OctoMap
g1_moveit/config/sensors_3d_task_2.yaml
Other components
- Operator
- Robot Controllers
- RViz
- Lidar Cloud
- TF Frames
- Filtered Cloud
Connections 18
- Operator → MoveIt Launch: starts
g1_moveit/launch/move_group.launch.py - MoveIt Launch → G1 Robot Model: loads model
g1_moveit/launch/move_group.launch.py - MoveIt Launch → MoveIt Move Group: starts
g1_moveit/launch/move_group.launch.py - Operator → Manipulation Interface: requests motions
- Manipulation Interface → Arm Controller: delegates motion
unitree_arms/src/unitree_moveit_interface.cpp - Manipulation Interface → Collision Manager: updates scene
unitree_arms/src/unitree_moveit_interface.cpp - Arm Controller → MoveIt Move Group: plans and executes
- Arm Controller → Robot Controllers: sends trajectories
- Collision Manager → Planning Scene: applies objects
unitree_arms/src/collision_manager.cpp - Collision Manager → RViz: publishes markers
unitree_arms/src/collision_manager.cpp - Operator → Filter Launch: starts filter
obstacle_remover_node/launch/obstacle_remover.launch.py - Filter Launch → Filter Entry: starts node
obstacle_remover_node/launch/obstacle_remover.launch.py - Filter Entry → Cloud Filter: constructs node
obstacle_remover_node/src/obstacle_remover_node_main.cpp - Lidar Cloud → Cloud Filter: provides cloud
- TF Frames → Cloud Filter: provides transforms
- Cloud Filter → Filtered Cloud: publishes cloud
- Filtered Cloud → MoveIt OctoMap: feeds mapping
- MoveIt Launch → Filter Launch: optionally starts