MoveIt ROS Control Plugin

This package provides plugins of base class moveit_controller_manager::MoveItControllerManager and a new plugin base class for moveit_controller_manager::MoveItControllerHandle allocators. The allocator class is necessary because moveit_controller_manager::MoveItControllerHandle needs a name passed to the constructor. Two variantes are provided, moveit_ros_control_interface::MoveItControllerManager for interfacing a single ros_control node and moveit_ros_control_interface::MoveItMultiControllerManager for seamless integration with any number of ros_control nodes.

moveit_ros_control_interface::MoveItControllerManager

This plugin interfaces a single ros_control-driven node in the namespace given in the ~ros_control_namespace ROS parameter. It polls all controllers via the list_controllers service and passes their properties to MoveIt. The polling is throttled to 1 Hertz.

Handle plugins

The actual handle creation is delegated to allocator plugins of base class moveit_ros_control_interface::ControllerHandleAllocator. These plugins should be registered with lookup names that match the corresponding controller types.

Currently plugins for position_controllers/JointTrajectoryController, velocity_controllers/JointTrajectoryController and effort_controllers/JointTrajectoryController are available, which simply wrap moveit_simple_controller_manager::FollowJointTrajectoryControllerHandle instances.

Setup

In your MoveIt launch file (e.g. ROBOT_moveit_config/launch/ROBOT_moveit_controller_manager.launch.xml) set the moveit_controller_manager parameter:

<param name="moveit_controller_manager" value="moveit_ros_control_interface::MoveItControllerManager" />

And make sure to set the ros_control_namespace parameter to the namespace (without the /controller_manager/ part) of the ros_control-based node you like to interface. If you are using the moveit_setup_assistent you can add it to ROBOT_moveit_config/config/controllers.yaml, e.g.:

ros_control_namespace: /ROS_CONTROL_NODE
controller_list:
  - name: /ROS_CONTROL_NODE/position_trajectory_controller
    action_ns: follow_joint_trajectory
    type: FollowJointTrajectory
    default: true
    joints:
      - joint_a1
      - joint_a2
      - joint_a3
      - joint_a4
      - joint_a5
      - joint_a6
      - joint_a7

Controller switching

MoveIt can decide which controllers have to be started and stopped. Since only controller names with registered allocator plugins are handed over to MoveIt, this implementation takes care of stopping other conflicting controllers based on their claimed resources and the resources for the to-be-started controllers.

Namespaces

All controller names get prefixed by the namespace of the ros_control node. For this to work the controller names should not contain slashes. This is a strict requirement if the ros_control namespace is /.

moveit_ros_control_interface::MoveItMultiControllerManager

This plugin does not need further configuration. It polls the ROS master for services and identifies ros_control nodes automatically. It spawns moveit_ros_control_interface::MoveItControllerManager instances with their namespace and takes cares of proper delegation.

Setup

Just set the moveit_controller_manager parameter in your MoveIt launch file (e.g. ROBOT_moveit_config/launch/ROBOT_moveit_controller_manager.launch.xml)

<param name="moveit_controller_manager" value="moveit_ros_control_interface::MoveItMultiControllerManager" />

Changelog for package moveit_ros_control_interface

1.1.16 (2024-10-07)

1.1.15 (2024-09-09)

1.1.14 (2024-05-27)

1.1.13 (2023-07-28)

1.1.12 (2023-05-13)

• Drop lib/ prefix from plugin paths (#3305)
• Contributors: Jochen Sprickerhof

1.1.11 (2022-12-21)

1.1.10 (2022-09-13)

1.1.9 (2022-03-06)

1.1.8 (2022-01-30)

1.1.7 (2021-12-31)

1.1.6 (2021-11-06)

• Use newly introduced cmake macro moveit_build_options() from moveit_core
• Fix reversed check in switchControllers (#2726)
• Contributors: Nathan Brooks, Robert Haschke

1.1.5 (2021-05-23)

1.1.4 (2021-05-12)

1.1.3 (2021-04-29)

1.1.2 (2021-04-08)

1.1.1 (2020-10-13)

• [maint] Add comment to MOVEIT_CLASS_FORWARD (#2315)
• Contributors: Felix von Drigalski

1.1.0 (2020-09-04)

• [feature] Optional cpp version setting (#2166)
• [feature] Remove support for Indigo's ros_control (#2128)
• [feature] Add support for pos_vel_controllers and pos_vel_acc_controllers (#1806)
• [fix] Various fixes for upcoming Noetic release (#2180)
• [fix] Fix compiler warnings (#1773)
• [maint] clang-tidy-fix [modernize-loop-convert]{.title-ref} to entire code base (#1419)
• [maint] Switch from include guards to pragma once (#1615)
• [maint] Remove ! from MoveIt name (#1590)
• Contributors: Dave Coleman, Henning Kayser, Jonathan Binney, Robert Haschke, Sandro Magalhães, Sean Yen, Tyler Weaver, Yu, Yan

1.0.6 (2020-08-19)

1.0.5 (2020-07-08)

1.0.4 (2020-05-30)

1.0.3 (2020-04-26)

• [maint] Fix errors: catkin_lint 1.6.7 (#1987)
• [maint] Windows build: Fix binary artifact install locations. (#1575)
• [maint] Use CMAKE_CXX_STANDARD to enforce c++14 (#1607)
• [feature] Add support for pos_vel_controllers and pos_vel_acc_controllers (#1806)
• Contributors: Robert Haschke, Sandro Magalhães, Sean Yen

1.0.2 (2019-06-28)

1.0.1 (2019-03-08)

1.0.0 (2019-02-24)

• [fix] catkin_lint issues (#1341)
• Contributors: Robert Haschke

0.10.8 (2018-12-24)

0.10.7 (2018-12-13)

0.10.6 (2018-12-09)

• [maintenance] Code Cleanup (#1196)
• Contributors: Robert Haschke

0.10.5 (2018-11-01)

0.10.4 (2018-10-29)

0.10.3 (2018-10-29)

0.10.2 (2018-10-24)

0.10.1 (2018-05-25)

0.9.11 (2017-12-25)

0.9.10 (2017-12-09)

0.9.9 (2017-08-06)

• [improve] add backward compatibility patch for indigo (#551)
• Contributors: Michael Görner

0.9.8 (2017-06-21)

0.9.7 (2017-06-05)

0.9.6 (2017-04-12)

0.9.5 (2017-03-08)

0.9.4 (2017-02-06)

• [maintenance] clang-format upgraded to 3.8 (#367)
• Contributors: Dave Coleman, Michael Goerner

0.9.3 (2016-11-16)

0.5.7 (2016-01-30)

• C++03 conforming nested templates
• fixed typo, added example config
• added brief decription tags
• formatted code to roscpp style
• improved documentation
• introduced getAbsName
• Added missing lock
• pre-allocate handles
• fixed typos
• set version to match the others
• fixed a lot of typos
• Intitial version of moveit_ros_control_interface package
• Contributors: Mathias Luedtke