#include <chainable_controller_interface.hpp>

Inheritance diagram for controller_interface::ChainableControllerInterface:

[legend]

Collaboration diagram for controller_interface::ChainableControllerInterface:

[legend]

Public Member Functions
CONTROLLER_INTERFACE_PUBLIC return_type	update (const rclcpp::Time &time, const rclcpp::Duration &period) final

CONTROLLER_INTERFACE_PUBLIC bool	is_chainable () const final
	Get information if a controller is chainable.

CONTROLLER_INTERFACE_PUBLIC std::vector< hardware_interface::CommandInterface >	export_reference_interfaces () final

CONTROLLER_INTERFACE_PUBLIC bool	set_chained_mode (bool chained_mode) final

CONTROLLER_INTERFACE_PUBLIC bool	is_in_chained_mode () const final
	Get information if a controller is currently in chained mode.

Public Member Functions inherited from controller_interface::ControllerInterfaceBase
virtual CONTROLLER_INTERFACE_PUBLIC InterfaceConfiguration	command_interface_configuration () const =0
	Get configuration for controller's required command interfaces.

virtual CONTROLLER_INTERFACE_PUBLIC InterfaceConfiguration	state_interface_configuration () const =0
	Get configuration for controller's required state interfaces.

CONTROLLER_INTERFACE_PUBLIC void	assign_interfaces (std::vector< hardware_interface::LoanedCommandInterface > &&command_interfaces, std::vector< hardware_interface::LoanedStateInterface > &&state_interfaces)

CONTROLLER_INTERFACE_PUBLIC void	release_interfaces ()

virtual CONTROLLER_INTERFACE_PUBLIC return_type	init (const std::string &controller_name, const std::string &namespace_="", const rclcpp::NodeOptions &node_options=rclcpp::NodeOptions() .allow_undeclared_parameters(true) .automatically_declare_parameters_from_overrides(true))

CONTROLLER_INTERFACE_PUBLIC const rclcpp_lifecycle::State &	configure ()
	Custom configure method to read additional parameters for controller-nodes.

virtual CONTROLLER_INTERFACE_PUBLIC CallbackReturn	on_init ()=0
	Extending interface with initialization method which is individual for each controller.

CONTROLLER_INTERFACE_PUBLIC std::shared_ptr< rclcpp_lifecycle::LifecycleNode >	get_node ()

CONTROLLER_INTERFACE_PUBLIC std::shared_ptr< rclcpp_lifecycle::LifecycleNode >	get_node () const

CONTROLLER_INTERFACE_PUBLIC const rclcpp_lifecycle::State &	get_state () const

CONTROLLER_INTERFACE_PUBLIC unsigned int	get_update_rate () const

template<typename ParameterT >
auto	auto_declare (const std::string &name, const ParameterT &default_value)
	Declare and initialize a parameter with a type.

Protected Member Functions
virtual std::vector< hardware_interface::CommandInterface >	on_export_reference_interfaces ()=0

virtual bool	on_set_chained_mode (bool chained_mode)
	Virtual method that each chainable controller should implement to switch chained mode.

virtual return_type	update_reference_from_subscribers ()=0
	Update reference from input topics when not in chained mode.

virtual return_type	update_and_write_commands (const rclcpp::Time &time, const rclcpp::Duration &period)=0
	Execute calculations of the controller and update command interfaces.

Protected Attributes
std::vector< double >	reference_interfaces_
	Storage of values for reference interfaces.

Protected Attributes inherited from controller_interface::ControllerInterfaceBase
std::vector< hardware_interface::LoanedCommandInterface >	command_interfaces_

std::vector< hardware_interface::LoanedStateInterface >	state_interfaces_

unsigned int	update_rate_ = 0

Detailed Description

Virtual class to implement when integrating a controller that can be preceded by other controllers. Specialization of ControllerInterface class to force implementation of methods specific for "chainable" controller, i.e., controller that can be preceded by an another controller, for example inner controller of an control cascade.

Member Function Documentation

◆ export_reference_interfaces()

std::vector< hardware_interface::CommandInterface > controller_interface::ChainableControllerInterface::export_reference_interfaces ( )

finalvirtual

Export interfaces for a chainable controller that can be used as command interface of other controllers.

Returns: list of command interfaces for preceding controllers.

Implements controller_interface::ControllerInterfaceBase.

◆ is_chainable()

bool controller_interface::ChainableControllerInterface::is_chainable ( ) const

finalvirtual

Get information if a controller is chainable.

Returns: true is controller is chainable and false if it is not.

Implements controller_interface::ControllerInterfaceBase.

◆ is_in_chained_mode()

bool controller_interface::ChainableControllerInterface::is_in_chained_mode ( ) const

finalvirtual

Get information if a controller is currently in chained mode.

Get information about controller if it is currently used in chained mode. In chained mode only internal interfaces are available and all subscribers are expected to be disabled. This prevents concurrent writing to controller's inputs from multiple sources.

Returns: true is controller is in chained mode and false if it is not.

Implements controller_interface::ControllerInterfaceBase.

◆ on_export_reference_interfaces()

virtual std::vector< hardware_interface::CommandInterface > controller_interface::ChainableControllerInterface::on_export_reference_interfaces ( )

protectedpure virtual

Virtual method that each chainable controller should implement to export its chainable interfaces. Each chainable controller implements this methods where all input (command) interfaces are exported. The method has the same meaning as export_command_interface method from hardware_interface::SystemInterface or hardware_interface::ActuatorInterface.

Returns: list of CommandInterfaces that other controller can use as their outputs.

Implemented in passthrough_controller::PassthroughController, admittance_controller::AdmittanceController, pid_controller::PidController, and steering_controllers_library::SteeringControllersLibrary.

◆ on_set_chained_mode()

bool controller_interface::ChainableControllerInterface::on_set_chained_mode ( bool chained_mode )

protectedvirtual

Virtual method that each chainable controller should implement to switch chained mode.

Each chainable controller implements this methods to switch between "chained" and "external" mode. In "chained" mode all external interfaces like subscriber and service servers are disabled to avoid potential concurrency in input commands.

Parameters

[in] flag marking a switch to or from chained mode.

Returns: true if controller successfully switched between "chained" and "external" mode. \default returns true so the method don't have to be overridden if controller can always switch chained mode.

Reimplemented in passthrough_controller::PassthroughController, pid_controller::PidController, and steering_controllers_library::SteeringControllersLibrary.

◆ set_chained_mode()

bool controller_interface::ChainableControllerInterface::set_chained_mode ( bool chained_mode )

finalvirtual

Set chained mode of a chainable controller. This method triggers internal processes to switch a chainable controller to "chained" mode and vice-versa. Setting controller to "chained" mode usually involves disabling of subscribers and other external interfaces to avoid potential concurrency in input commands.

Returns: true if mode is switched successfully and false if not.

Implements controller_interface::ControllerInterfaceBase.

◆ update()

return_type controller_interface::ChainableControllerInterface::update	(	const rclcpp::Time &	time,
		const rclcpp::Duration &	period
	)

finalvirtual

Control step update. Command interfaces are updated based on on reference inputs and current states. The method called in the (real-time) control loop.

Parameters

[in]	time	The time at the start of this control loop iteration
[in]	period	The measured time taken by the last control loop iteration

Returns: return_type::OK if update is successfully, otherwise return_type::ERROR.

Implements controller_interface::ControllerInterfaceBase.

◆ update_and_write_commands()

virtual return_type controller_interface::ChainableControllerInterface::update_and_write_commands	(	const rclcpp::Time &	time,
		const rclcpp::Duration &	period
	)

protectedpure virtual

Execute calculations of the controller and update command interfaces.

Update method for chainable controllers. In this method is valid to assume that \reference_interfaces_ hold the values for calculation of the commands in the current control step. This means that this method is called after \update_reference_from_subscribers if controller is not in chained mode.

Returns: return_type::OK if calculation and writing of interface is successfully, otherwise return_type::ERROR.

Implemented in passthrough_controller::PassthroughController, admittance_controller::AdmittanceController, pid_controller::PidController, and steering_controllers_library::SteeringControllersLibrary.

◆ update_reference_from_subscribers()

virtual return_type controller_interface::ChainableControllerInterface::update_reference_from_subscribers ( )

protectedpure virtual

Update reference from input topics when not in chained mode.

Each chainable controller implements this method to update reference from subscribers when not in chained mode.

Returns: return_type::OK if update is successfully, otherwise return_type::ERROR.

Implemented in passthrough_controller::PassthroughController, admittance_controller::AdmittanceController, pid_controller::PidController, and steering_controllers_library::SteeringControllersLibrary.

The documentation for this class was generated from the following files:

ros2_control/controller_interface/include/controller_interface/chainable_controller_interface.hpp
ros2_control/controller_interface/src/chainable_controller_interface.cpp

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Member Function Documentation

◆ export_reference_interfaces()

◆ is_chainable()

◆ is_in_chained_mode()

◆ on_export_reference_interfaces()

◆ on_set_chained_mode()

◆ set_chained_mode()

◆ update()

◆ update_and_write_commands()

◆ update_reference_from_subscribers()