ros2_control - galactic
rrbot_system_multi_interface.hpp
1 // Copyright 2021 Department of Engineering Cybernetics, NTNU
2 //
3 // Licensed under the Apache License, Version 2.0 (the "License");
4 // you may not use this file except in compliance with the License.
5 // You may obtain a copy of the License at
6 //
7 // http://www.apache.org/licenses/LICENSE-2.0
8 //
9 // Unless required by applicable law or agreed to in writing, software
10 // distributed under the License is distributed on an "AS IS" BASIS,
11 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 // See the License for the specific language governing permissions and
13 // limitations under the License.
14 
15 #ifndef ROS2_CONTROL_DEMO_HARDWARE__RRBOT_SYSTEM_MULTI_INTERFACE_HPP_
16 #define ROS2_CONTROL_DEMO_HARDWARE__RRBOT_SYSTEM_MULTI_INTERFACE_HPP_
17 
18 #include <chrono>
19 #include <cstdint>
20 #include <memory>
21 #include <string>
22 #include <vector>
23 
24 #include "hardware_interface/handle.hpp"
25 #include "hardware_interface/hardware_info.hpp"
26 #include "hardware_interface/system_interface.hpp"
27 #include "hardware_interface/types/hardware_interface_return_values.hpp"
28 #include "rclcpp/clock.hpp"
29 #include "rclcpp/duration.hpp"
30 #include "rclcpp/macros.hpp"
31 #include "rclcpp/time.hpp"
32 #include "rclcpp_lifecycle/node_interfaces/lifecycle_node_interface.hpp"
33 #include "rclcpp_lifecycle/state.hpp"
34 #include "ros2_control_demo_hardware/visibility_control.h"
35 
36 using CallbackReturn = rclcpp_lifecycle::node_interfaces::LifecycleNodeInterface::CallbackReturn;
37 
38 namespace ros2_control_demo_hardware
39 {
41 {
42 public:
43  RCLCPP_SHARED_PTR_DEFINITIONS(RRBotSystemMultiInterfaceHardware);
44 
45  ROS2_CONTROL_DEMO_HARDWARE_PUBLIC
46  CallbackReturn on_init(const hardware_interface::HardwareInfo & info) override;
47 
48  ROS2_CONTROL_DEMO_HARDWARE_PUBLIC
49  std::vector<hardware_interface::StateInterface> export_state_interfaces() override;
50 
51  ROS2_CONTROL_DEMO_HARDWARE_PUBLIC
52  std::vector<hardware_interface::CommandInterface> export_command_interfaces() override;
53 
54  ROS2_CONTROL_DEMO_HARDWARE_PUBLIC
55  hardware_interface::return_type prepare_command_mode_switch(
56  const std::vector<std::string> & start_interfaces,
57  const std::vector<std::string> & stop_interfaces) override;
58 
59  ROS2_CONTROL_DEMO_HARDWARE_PUBLIC
60  CallbackReturn on_activate(const rclcpp_lifecycle::State & previous_state) override;
61 
62  ROS2_CONTROL_DEMO_HARDWARE_PUBLIC
63  CallbackReturn on_deactivate(const rclcpp_lifecycle::State & previous_state) override;
64 
65  ROS2_CONTROL_DEMO_HARDWARE_PUBLIC
66  hardware_interface::return_type read() override;
67 
68  ROS2_CONTROL_DEMO_HARDWARE_PUBLIC
69  hardware_interface::return_type write() override;
70 
71 private:
72  // Parameters for the RRBot simulation
73  double hw_start_sec_;
74  double hw_stop_sec_;
75  double hw_slowdown_;
76 
77  // Store the commands for the simulated robot
78  std::vector<double> hw_commands_positions_;
79  std::vector<double> hw_commands_velocities_;
80  std::vector<double> hw_commands_accelerations_;
81  std::vector<double> hw_states_positions_;
82  std::vector<double> hw_states_velocities_;
83  std::vector<double> hw_states_accelerations_;
84 
85  // Store time between update loops
86  rclcpp::Clock clock_;
87  rclcpp::Time last_timestamp_;
88  rclcpp::Time current_timestamp; // Avoid initialization on each read
89 
90  // Enum defining at which control level we are
91  // Dumb way of maintaining the command_interface type per joint.
92  enum integration_level_t : std::uint8_t
93  {
94  UNDEFINED = 0,
95  POSITION = 1,
96  VELOCITY = 2,
97  ACCELERATION = 3
98  };
99 
100  // Active control mode for each actuator
101  std::vector<integration_level_t> control_level_;
102 };
103 
104 } // namespace ros2_control_demo_hardware
105 #endif // ROS2_CONTROL_DEMO_HARDWARE__RRBOT_SYSTEM_MULTI_INTERFACE_HPP_
Virtual Class to implement when integrating a complex system into ros2_control.
Definition: system_interface.hpp:68
Definition: rrbot_system_multi_interface.hpp:41
ROS2_CONTROL_DEMO_HARDWARE_PUBLIC hardware_interface::return_type write() override
Write the current command values to the actuator.
Definition: rrbot_system_multi_interface.cpp:320
ROS2_CONTROL_DEMO_HARDWARE_PUBLIC hardware_interface::return_type read() override
Read the current state values from the actuator.
Definition: rrbot_system_multi_interface.cpp:276
ROS2_CONTROL_DEMO_HARDWARE_PUBLIC hardware_interface::return_type prepare_command_mode_switch(const std::vector< std::string > &start_interfaces, const std::vector< std::string > &stop_interfaces) override
Prepare for a new command interface switch.
Definition: rrbot_system_multi_interface.cpp:138
ROS2_CONTROL_DEMO_HARDWARE_PUBLIC std::vector< hardware_interface::CommandInterface > export_command_interfaces() override
Exports all command interfaces for this hardware interface.
Definition: rrbot_system_multi_interface.cpp:121
ROS2_CONTROL_DEMO_HARDWARE_PUBLIC std::vector< hardware_interface::StateInterface > export_state_interfaces() override
Exports all state interfaces for this hardware interface.
Definition: rrbot_system_multi_interface.cpp:104
ROS2_CONTROL_DEMO_HARDWARE_PUBLIC CallbackReturn on_init(const hardware_interface::HardwareInfo &info) override
Initialization of the hardware interface from data parsed from the robot's URDF.
Definition: rrbot_system_multi_interface.cpp:30
This structure stores information about hardware defined in a robot's URDF.
Definition: hardware_info.hpp:101