How cable-disentanglement-workspace/bimanual_ur10e_motion_planner works
This ROS 2 workspace supports bimanual UR10e motion planning and collision avoidance, plus an ArUco-to-MoveIt planning workflow. The principal documented workflow brings up the dual-arm stack, accepts a planned or interactive arm motion, and relies on MoveIt and the robot controllers to plan and execute safely. A separate planner reads a marker pose, applies hand-eye calibration, computes a TCP goal, and requests a plan. Some relationships are documented only at launch/workflow level; unsampled runtime wiring is not inferred.
Main entry points: move_group.launch.py MoveIt move_group · dual_arm_fake.launch.py Fake-hardware launch · dual_arm_real_v2.launch.py Real-hardware launch · main.py ArUco planner entry
Components 20
Robot Bringup
- Dual-arm model
src/dual_arm_moveit_config/config/dual_arm_real_v2.urdf.xacro - MoveIt configuration
src/dual_arm_moveit_config/config - Fake-hardware launch
src/dual_arm_moveit_config/launch/dual_arm_fake.launch.py - Real-hardware launch
src/dual_arm_moveit_config/launch/dual_arm_real_v2.launch.py - MoveIt move_group
src/dual_arm_moveit_config/launch/move_group.launch.py - Arm controllers
src/dual_arm_moveit_config/config/ros2_controllers.yaml
Motion and Safety
- Collision avoidance
src/dual_arm_pkg/scripts/move_until_collision.py - Arm motion planning
src/dual_arm_python/dual_arm_python/arm_motion_planning.py - Single-arm commands
src/aruco_moveit_planner/aruco_moveit_planner/move_arm.py
ArUco Planning
- Marker pose input
src/aruco_moveit_planner/aruco_moveit_planner/pose_reader.py - ArUco planner entry
src/aruco_moveit_planner/aruco_moveit_planner/main.py - Frame transforms
src/aruco_moveit_planner/aruco_moveit_planner/frame_transformer.py - Plan-only client
src/aruco_moveit_planner/aruco_moveit_planner/moveit_planner.py
Calibration
- Hand-eye calibrations
calibrations - easy_handeye2
src/dual_arm_pkg/launch/handeye_calibrate.launch.py
Other components
- Operator
- ZED camera
- ArUco detector
- UR10e arms
- RViz
Connections 25
- Operator → Fake-hardware launch: launch offline
README.md - Operator → Real-hardware launch: launch hardware
README.md - Fake-hardware launch → Dual-arm model: loads model
src/dual_arm_moveit_config/launch/dual_arm_fake.launch.py - Fake-hardware launch → MoveIt move_group: starts planning
src/dual_arm_moveit_config/launch/dual_arm_fake.launch.py - Fake-hardware launch → RViz: starts visualization
src/dual_arm_moveit_config/launch/dual_arm_fake.launch.py - Real-hardware launch → Dual-arm model: loads model
README.md - Real-hardware launch → MoveIt move_group: starts planning
README.md - Real-hardware launch → Arm controllers: starts controllers
- MoveIt configuration → MoveIt move_group: configures planning
- Operator → Collision avoidance: run avoidance
README.md - Operator → Single-arm commands: request motion
- Collision avoidance → MoveIt move_group: requests safe motion
- Arm motion planning → UR10e arms: executes plans
- Operator → ArUco planner entry: start planning
src/aruco_moveit_planner/aruco_moveit_planner/main.py - ArUco planner entry → Marker pose input: reads pose
src/aruco_moveit_planner/aruco_moveit_planner/main.py - ArUco planner entry → Frame transforms: transforms pose
src/aruco_moveit_planner/aruco_moveit_planner/main.py - ArUco planner entry → Plan-only client: requests plan
src/aruco_moveit_planner/aruco_moveit_planner/main.py - Frame transforms → Hand-eye calibrations: loads calibration
- Marker pose input → ArUco detector: subscribes pose
- ZED camera → ArUco detector: provides images
README.md - Plan-only client → MoveIt move_group: sends plan request
src/aruco_moveit_planner/aruco_moveit_planner/moveit_planner.py - MoveIt move_group → RViz: publishes trajectory
- easy_handeye2 → Hand-eye calibrations: produces calibration
- MoveIt move_group → Arm controllers: dispatches trajectories
- Arm controllers → UR10e arms: commands arms