Inheritance diagram for ros2_control_demo_example_17::RRBotSystemPositionOnlyHardware:

[legend]

Collaboration diagram for ros2_control_demo_example_17::RRBotSystemPositionOnlyHardware:

[legend]

Public Member Functions
hardware_interface::CallbackReturn	on_init (const hardware_interface::HardwareComponentInterfaceParams &params) override
	Initialization of the hardware interface from data parsed from the robot's URDF.

hardware_interface::CallbackReturn	on_configure (const rclcpp_lifecycle::State &previous_state) override

hardware_interface::CallbackReturn	on_activate (const rclcpp_lifecycle::State &previous_state) override

hardware_interface::CallbackReturn	on_deactivate (const rclcpp_lifecycle::State &previous_state) override

hardware_interface::return_type	read (const rclcpp::Time &time, const rclcpp::Duration &period) override
	Read the current state values from the hardware.

hardware_interface::return_type	write (const rclcpp::Time &time, const rclcpp::Duration &period) override
	Write the current command values to the hardware.

hardware_interface::CallbackReturn	init_hardware_status_message (control_msgs::msg::HardwareStatus &msg_template) override
	User-overridable method to configure the structure of the HardwareStatus message.

hardware_interface::return_type	update_hardware_status_message (control_msgs::msg::HardwareStatus &msg) override
	User-overridable method to fill the hardware status message with real-time data.

Public Member Functions inherited from hardware_interface::HardwareComponentInterface
	HardwareComponentInterface (const HardwareComponentInterface &other)=delete
	HardwareComponentInterface copy constructor is actively deleted.

	HardwareComponentInterface (HardwareComponentInterface &&other)=delete

CallbackReturn	init (const hardware_interface::HardwareComponentParams &params)

virtual std::vector< StateInterface >	export_state_interfaces ()
	Exports all state interfaces for this hardware interface.

virtual std::vector< hardware_interface::InterfaceDescription >	export_unlisted_state_interface_descriptions ()

virtual std::vector< StateInterface::ConstSharedPtr >	on_export_state_interfaces ()

virtual std::vector< CommandInterface >	export_command_interfaces ()
	Exports all command interfaces for this hardware interface.

virtual std::vector< hardware_interface::InterfaceDescription >	export_unlisted_command_interface_descriptions ()

virtual std::vector< CommandInterface::SharedPtr >	on_export_command_interfaces ()

virtual return_type	prepare_command_mode_switch (const std::vector< std::string > &, const std::vector< std::string > &)
	Prepare for a new command interface switch.

virtual return_type	perform_command_mode_switch (const std::vector< std::string > &, const std::vector< std::string > &)

HardwareComponentCycleStatus	trigger_read (const rclcpp::Time &time, const rclcpp::Duration &period)
	Triggers the read method synchronously or asynchronously depending on the HardwareInfo.

HardwareComponentCycleStatus	trigger_write (const rclcpp::Time &time, const rclcpp::Duration &period)
	Triggers the write method synchronously or asynchronously depending on the HardwareInfo.

const std::string &	get_name () const
	Get name of the hardware.

const std::string &	get_group_name () const
	Get name of the hardware group to which it belongs to.

const rclcpp_lifecycle::State &	get_lifecycle_state () const
	Get life-cycle state of the hardware.

void	set_lifecycle_state (const rclcpp_lifecycle::State &new_state)
	Set life-cycle state of the hardware.

bool	has_state (const std::string &interface_name) const
	Does the state interface exist?

template<typename T >
void	set_state (const std::string &interface_name, const T &value)
	Set the value of a state interface.

template<typename T = double>
T	get_state (const std::string &interface_name) const
	Get the value from a state interface.

bool	has_command (const std::string &interface_name) const
	Does the command interface exist?

template<typename T >
void	set_command (const std::string &interface_name, const T &value)
	Set the value of a command interface.

template<typename T = double>
T	get_command (const std::string &interface_name) const
	Get the value from a command interface.

rclcpp::Logger	get_logger () const
	Get the logger of the HardwareComponentInterface.

rclcpp::Clock::SharedPtr	get_clock () const
	Get the clock.

rclcpp::Node::SharedPtr	get_node () const
	Get the default node of the HardwareComponentInterface.

const HardwareInfo &	get_hardware_info () const
	Get the hardware info of the HardwareComponentInterface.

void	pause_async_operations ()
	Pause any asynchronous operations.

void	prepare_for_activation ()
	Prepare for the activation of the hardware.

void	enable_introspection (bool enable)
	Enable or disable introspection of the hardware.

Additional Inherited Members
Protected Attributes inherited from hardware_interface::HardwareComponentInterface
HardwareInfo	info_

std::unordered_map< std::string, InterfaceDescription >	joint_state_interfaces_

std::unordered_map< std::string, InterfaceDescription >	joint_command_interfaces_

std::unordered_map< std::string, InterfaceDescription >	sensor_state_interfaces_

std::unordered_map< std::string, InterfaceDescription >	gpio_state_interfaces_

std::unordered_map< std::string, InterfaceDescription >	gpio_command_interfaces_

std::unordered_map< std::string, InterfaceDescription >	unlisted_state_interfaces_

std::unordered_map< std::string, InterfaceDescription >	unlisted_command_interfaces_

rclcpp_lifecycle::State	lifecycle_state_

std::unique_ptr< realtime_tools::AsyncFunctionHandler< return_type > >	async_handler_

std::vector< StateInterface::SharedPtr >	joint_states_

std::vector< CommandInterface::SharedPtr >	joint_commands_

std::vector< StateInterface::SharedPtr >	sensor_states_

std::vector< StateInterface::SharedPtr >	gpio_states_

std::vector< CommandInterface::SharedPtr >	gpio_commands_

std::vector< StateInterface::SharedPtr >	unlisted_states_

std::vector< CommandInterface::SharedPtr >	unlisted_commands_

pal_statistics::RegistrationsRAII	stats_registrations_

std::shared_ptr< rclcpp::Publisher< control_msgs::msg::HardwareStatus > >	hardware_status_publisher_

realtime_tools::RealtimeThreadSafeBox< std::optional< control_msgs::msg::HardwareStatus > >	hardware_status_box_

rclcpp::TimerBase::SharedPtr	hardware_status_timer_

Member Function Documentation

◆ init_hardware_status_message()

hardware_interface::CallbackReturn ros2_control_demo_example_17::RRBotSystemPositionOnlyHardware::init_hardware_status_message ( control_msgs::msg::HardwareStatus & )

overridevirtual

User-overridable method to configure the structure of the HardwareStatus message.

To enable status publishing, override this method to pre-allocate the message structure and fill in static information like device IDs and interface names. This method is called once during the non-realtime init() phase. If the hardware_device_states vector is left empty, publishing will be disabled.

Parameters

[out] msg_template A reference to a HardwareStatus message to be configured.

Returns: CallbackReturn::SUCCESS if configured successfully, CallbackReturn::ERROR on failure.

Reimplemented from hardware_interface::HardwareComponentInterface.

◆ on_init()

hardware_interface::CallbackReturn ros2_control_demo_example_17::RRBotSystemPositionOnlyHardware::on_init ( const hardware_interface::HardwareComponentInterfaceParams & params )

overridevirtual

Initialization of the hardware interface from data parsed from the robot's URDF.

Parameters

[in] params A struct of type hardware_interface::HardwareComponentInterfaceParams containing all necessary parameters for initializing this specific hardware component, specifically its HardwareInfo, and a weak_ptr to the executor.

Warning: The parsed executor should not be used to call cancel() or use blocking callbacks such as spin().

Returns: CallbackReturn::SUCCESS if required data are provided and can be parsed.; CallbackReturn::ERROR if any error happens or data are missing.

Reimplemented from hardware_interface::HardwareComponentInterface.

◆ read()

hardware_interface::return_type ros2_control_demo_example_17::RRBotSystemPositionOnlyHardware::read	(	const rclcpp::Time &	time,
		const rclcpp::Duration &	period
	)

overridevirtual

Read the current state values from the hardware.

The data readings from the physical hardware has to be updated and reflected accordingly in the exported state interfaces. That is, the data pointed by the interfaces shall be updated.

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 the read was successful, return_type::ERROR otherwise.

Implements hardware_interface::HardwareComponentInterface.

◆ update_hardware_status_message()

hardware_interface::return_type ros2_control_demo_example_17::RRBotSystemPositionOnlyHardware::update_hardware_status_message ( control_msgs::msg::HardwareStatus & )

overridevirtual

User-overridable method to fill the hardware status message with real-time data.

This real-time safe method is called by the framework within the trigger_read() loop. Override this method to populate the value fields of the pre-allocated message with the latest hardware states that were updated in your read() method.

Parameters

[in,out] msg The pre-allocated message to be filled with the latest values.

Returns: return_type::OK on success, return_type::ERROR on failure.

Reimplemented from hardware_interface::HardwareComponentInterface.

◆ write()

hardware_interface::return_type ros2_control_demo_example_17::RRBotSystemPositionOnlyHardware::write	(	const rclcpp::Time &	,
		const rclcpp::Duration &
	)

overridevirtual

Write the current command values to the hardware.

The physical hardware shall be updated with the latest value from the exported command interfaces.

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 the read was successful, return_type::ERROR otherwise.

Implements hardware_interface::SystemInterface.

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

ros2_control_demos/example_17/hardware/include/ros2_control_demo_example_17/rrbot.hpp
ros2_control_demos/example_17/hardware/rrbot.cpp

Public Member Functions

Additional Inherited Members

Member Function Documentation

◆ init_hardware_status_message()

◆ on_init()

◆ read()

◆ update_hardware_status_message()

◆ write()