No version for distro humble. Known supported distros are highlighted in the buttons above.
No version for distro iron. Known supported distros are highlighted in the buttons above.
No version for distro rolling. Known supported distros are highlighted in the buttons above.
No version for distro noetic. Known supported distros are highlighted in the buttons above.
No version for distro ardent. Known supported distros are highlighted in the buttons above.
No version for distro bouncy. Known supported distros are highlighted in the buttons above.
No version for distro crystal. Known supported distros are highlighted in the buttons above.
No version for distro eloquent. Known supported distros are highlighted in the buttons above.
No version for distro dashing. Known supported distros are highlighted in the buttons above.
No version for distro galactic. Known supported distros are highlighted in the buttons above.
No version for distro foxy. Known supported distros are highlighted in the buttons above.
No version for distro lunar. Known supported distros are highlighted in the buttons above.
No version for distro jade. Known supported distros are highlighted in the buttons above.
No version for distro indigo. Known supported distros are highlighted in the buttons above.
No version for distro hydro. Known supported distros are highlighted in the buttons above.

Package Summary

Tags No category tags.
Version 0.0.0
License BSD
Build type CATKIN
Use RECOMMENDED

Repository Summary

Checkout URI https://github.com/xArm-Developer/xarm_ros.git
VCS Type git
VCS Version master
Last Updated 2024-03-15
Dev Status DEVELOPED
CI status Continuous Integration
Released UNRELEASED
Tags No category tags.
Contributing Help Wanted (0)
Good First Issues (0)
Pull Requests to Review (0)

Package Description

The xarm_planner package

Additional Links

No additional links.

Maintainers

  • Jason Peng

Authors

No additional authors.

Package Introduction

  This package is intended to provide users a demo programming interface to use moveit!, instead of just using the GUI. To use the API better, users are encouraged to go through Moveit tutorial.
  Inside the package, 'xarm_simple_planner' is just a basic implementation of the Move_group interface, if higher level configurations (constraints, switch kinematic solver or planners, etc) are needed, user can fully explore Moveit abilities and implement a sofisticated version.
  For simplified Chinese instructions: 简体中文版

Usage

Launch the simple planner node:

If you want to try it in simulation, run:

   $ roslaunch xarm_planner xarm_planner_rviz_sim.launch robot_dof:=<7|6|5> robot_type:=<xarm|lite>  add_gripper:=<true|false> add_vacuum_gripper:=<true|false>

Or, if you would work with real xArm, run:

   $ roslaunch xarm_planner xarm_planner_realHW.launch robot_ip:=<your controller box LAN IP address> robot_dof:=<7|6|5> robot_type:=<xarm|lite> add_gripper:=<true|false> add_vacuum_gripper:=<true|false>

Argument 'robot_dof' specifies the number of joints of your xArm (default is 7). 'add_gripper' and 'add_vacuum_gripper' are for the cases with UF end-effector attached, only one end-effector can be attached.

This node can provide services for planning request in Cartesian target and joint space target. Service definition can be found in srv folder. User can call the services to let planner solve the path to specified target point, and retrieve the boolean result as successful or not. Once the node is launched, user can try in command-line first, something like:

For joint-space planning request:

   $ rosservice call xarm_joint_plan 'target: [1.0, -0.5, 0.0, -0.3, 0.0, 0.0, 0.5]'

The target elements in this case correspond to each joint target angle in radians, number of elements is same with the DOF.

For Cartesian-space point-to-point planning request:

   $ rosservice call xarm_pose_plan 'target: [[0.28, 0.2, 0.2], [1.0, 0.0, 0.0, 0.0]]'

The separated fields for Cartesian target correspond to tool frame position (x, y, z) in meters and orientation Quaternions (x, y, z, w).
Note that this motion is still point-to-point, meaning the trajectory is NOT a straight line.

For Cartesian straight line planning request:

   $ rosservice call xarm_straight_plan 'target: [[0.28, 0.2, 0.2], [1.0, 0.0, 0.0, 0.0]]'

Command data units are the same with above Cartesian pose command. If planned succesfully, end-effector trajectory will be a straight-line in space. Note that the velocity change may not be as expected during execution. Please refer to MoveGroupInterface documentation to make your modifications to the code if necessary.

After calling the above planning services, a boolean result named 'success' will be returned.

Quaternion calculation tips:

If you are not familiar with conversion from (roll, pitch, yaw) to quaternions, refer to this page.

For Execution of planned trajectory:

Notice: Use Cartesian planning with special care, since trajectory from Moveit (OMPL) planner can be highly random and not necessarily the optimal (closest) solution, Do check it in Rviz befroe confirm to move!

If solution exists and user want to execute it on the robot, it can be done by service call (recommended) or topic message.

Execute by service call (Blocking)

Call the 'xarm_exec_plan' service with a request data of 'true', the latest planned path will be executed, the service will return after finishing the execution:

   $ rosservice call xarm_exec_plan 'true'

Execute by topic (Non-blocking)

Just publish a message (type: std_msgs/Bool) to the topic "/xarm_planner_exec", the boolean data should be 'true' to launch the execution, it returns immediately and does not wait for finish:

   $ rostopic pub -1 /xarm_planner_exec std_msgs/Bool 'true'

Alternative way of calling services or publish messages, is to do it programatically. User can refer to ROS tutorial1 and tutorial2 to find out how to do it, or refer to the 'xarm_simple_planner_test.cpp' in the src folder as an example.
To run the test program ( for xArm7 only, user can modify the command list for other models), after launching the simple planner:

   $ rosrun xarm_planner xarm_simple_planner_test

The program will execute three hard-coded joint space target, MAKE SURE THERE ARE PLENTY SURROUNDING SPACES BEFORE EXECUTING THIS!

Visualization of planned trajectory

Refer to issue #57, now xArm and end-effector descriptions are re-configured to enable the visualization of TCP trajectory upon successful planning. As is shown below:

VISUAL_TRAJ1 VISUAL_TRAJ2

CHANGELOG
No CHANGELOG found.

Wiki Tutorials

See ROS Wiki Tutorials for more details.

Source Tutorials

Not currently indexed.

Launch files

  • launch/robot_planner_realmove.launch
      • robot_ip
      • report_type [default: normal]
      • dof [default: 7]
      • robot_type [default: xarm]
      • robot_sn [default: ]
      • model1300 [default: false]
      • limited [default: true]
      • hw_ns [default: xarm]
      • velocity_control [default: false]
      • baud_checkset [default: true]
      • default_gripper_baud [default: 2000000]
      • attach_to [default: world]
      • attach_xyz [default: '0 0 0']
      • attach_rpy [default: '0 0 0']
      • add_realsense_d435i [default: false]
      • add_d435i_links [default: false]
      • add_gripper [default: false]
      • add_vacuum_gripper [default: false]
      • add_other_geometry [default: false]
      • geometry_type [default: box]
      • geometry_mass [default: 0.1]
      • geometry_height [default: 0.1]
      • geometry_radius [default: 0.1]
      • geometry_length [default: 0.1]
      • geometry_width [default: 0.1]
      • geometry_mesh_filename [default: ]
      • geometry_mesh_origin_xyz [default: '0 0 0']
      • geometry_mesh_origin_rpy [default: '0 0 0']
      • geometry_mesh_tcp_xyz [default: '0 0 0']
      • geometry_mesh_tcp_rpy [default: '0 0 0']
      • ext_ns [default: ]
      • sensors_3d [default: false]
      • enforce_limits [default: true]
      • jnt_stat_pub_rate [default: 10]
      • show_rviz [default: true]
      • no_gui_plan [default: true]
  • launch/xarm_planner_realHW.launch
      • robot_ip
      • robot_dof
      • show_rviz [default: true]
      • no_gui_plan [default: true]
      • add_gripper [default: false]
      • add_vacuum_gripper [default: false]
      • report_type [default: normal]
      • ext_ns [default: ]
      • robot_type [default: xarm]
      • model1300 [default: false]
  • launch/xarm_planner_rviz_sim.launch
      • robot_dof
      • add_gripper [default: false]
      • add_vacuum_gripper [default: false]
      • namespace [default: xarm]
      • robot_type [default: xarm]
      • model1300 [default: false]
  • launch/robot_planner_fake.launch
      • dof [default: 7]
      • robot_type [default: xarm]
      • robot_sn [default: ]
      • model1300 [default: false]
      • limited [default: true]
      • attach_to [default: world]
      • attach_xyz [default: '0 0 0']
      • attach_rpy [default: '0 0 0']
      • add_realsense_d435i [default: false]
      • add_d435i_links [default: false]
      • add_gripper [default: false]
      • add_vacuum_gripper [default: false]
      • add_other_geometry [default: false]
      • geometry_type [default: box]
      • geometry_mass [default: 0.1]
      • geometry_height [default: 0.1]
      • geometry_radius [default: 0.1]
      • geometry_length [default: 0.1]
      • geometry_width [default: 0.1]
      • geometry_mesh_filename [default: ]
      • geometry_mesh_origin_xyz [default: '0 0 0']
      • geometry_mesh_origin_rpy [default: '0 0 0']
      • geometry_mesh_tcp_xyz [default: '0 0 0']
      • geometry_mesh_tcp_rpy [default: '0 0 0']
      • ext_ns [default: ]
      • sensors_3d [default: false]
      • jnt_stat_pub_rate [default: 10]
      • no_gui_plan [default: true]
  • launch/moveit_sim_configurations.launch
      • arm_dof
      • end_effector [default: ]
      • namespace [default: xarm]
      • robot_type [default: xarm]
      • model1300 [default: false]
  • launch/moveit_real_arm_configurations.launch
      • arm_dof
      • robot_ip
      • end_effector [default: ]
      • show_rviz [default: true]
      • no_gui_plan [default: true]
      • report_type [default: normal]
      • robot_type [default: xarm]
      • ext_ns [default: ]
      • model1300 [default: false]

Messages

No message files found.

Plugins

No plugins found.

Recent questions tagged xarm_planner at Robotics Stack Exchange

No version for distro melodic. Known supported distros are highlighted in the buttons above.