How kroshu/kuka_drivers works
This repository provides ROS 2 drivers for KUKA robot systems, with separate EAC, RSI, and Sunrise FRI implementations. The main workflow is a ROS 2 lifecycle manager configuring and activating robot hardware and controllers, then coordinating control-mode changes and hardware events. Shared core code supplies lifecycle, controller-selection, interface, and service helpers; driver-specific modules handle robot communication and configuration. The README describes support across KUKA operating systems. Some driver internals are unsampled, so only documented or indexed relationships are shown.
Main entry points: robot_manager_base.cpp RSI Manager · src/robot_manager_node.cpp EAC Manager · src/robot_manager_node.cpp FRI Manager · control_mode.hpp Control And HW Types
Components 22
Shared ROS 2 Core
- Lifecycle Nodes
kuka_drivers_core/src/ros2_base_lc_node.cpp - Controller Selection
kuka_drivers_core/src/controller_handler.cpp - Control Services
kuka_drivers_core/include/communication_helpers/ros2_control_tools.hpp - Control And HW Types
kuka_drivers_core/include/kuka_drivers_core/control_mode.hpp
EAC Driver
- EAC Manager
kuka_iiqka_eac_driver/src/robot_manager_node.cpp - EAC Hardware
kuka_iiqka_eac_driver/src/hardware_interface.cpp
RSI Driver
- RSI Manager
kuka_rsi_driver/src/robot_manager_base.cpp - RSI Variants
kuka_rsi_driver/src/robot_manager_node_extended.cpp - RSI Hardware
kuka_rsi_driver/src/hardware_interface_rsi_base.cpp - RSI XML Config
kuka_rsi_driver/src/rsi_xml_configuration_parser.cpp - RSI Tools
kuka_rsi_driver/scripts
Sunrise FRI Driver
- FRI Manager
kuka_sunrise_fri_driver/src/robot_manager_node.cpp - FRI Hardware
kuka_sunrise_fri_driver/src/hardware_interface.cpp - FRI Connection
kuka_sunrise_fri_driver/src/connection_helpers/fri_connection.cpp - FRI Client SDK
kuka_sunrise_fri_driver/src/fri_client_sdk - Robot FRI App
kuka_sunrise_fri_driver/robot_application/src/ros2/modules/FRIManager.java - Robot ROS Link
kuka_sunrise_fri_driver/robot_application/src/ros2/modules/ROS2Connection.java - FRI Serialization
kuka_sunrise_fri_driver/robot_application/src/ros2/serialization/FRIConfigurationParams.java
ROS 2 Controllers
- Controller Plugins
controllers
Other components
- ROS 2 Operator
- KUKA Robot
- ROS 2 Controller Manager
Connections 32
- ROS 2 Operator → EAC Manager: configures lifecycle
- ROS 2 Operator → RSI Manager: configures lifecycle
- ROS 2 Operator → FRI Manager: configures lifecycle
- EAC Manager → Lifecycle Nodes: extends lifecycle
- RSI Manager → Lifecycle Nodes: extends lifecycle
- FRI Manager → Lifecycle Nodes: extends lifecycle
- EAC Manager → Control Services: changes hardware and controllers
kuka_iiqka_eac_driver/src/robot_manager_node.cpp - RSI Manager → Control Services: changes hardware and controllers
kuka_rsi_driver/src/robot_manager_base.cpp - FRI Manager → Control Services: changes hardware and controllers
kuka_sunrise_fri_driver/src/robot_manager_node.cpp - EAC Manager → Controller Selection: selects mode controllers
kuka_iiqka_eac_driver/src/robot_manager_node.cpp - RSI Manager → Controller Selection: selects mode controllers
kuka_rsi_driver/src/robot_manager_base.cpp - EAC Manager → ROS 2 Controller Manager: requests controller switches
kuka_iiqka_eac_driver/src/robot_manager_node.cpp - RSI Manager → ROS 2 Controller Manager: requests lifecycle changes
kuka_rsi_driver/src/robot_manager_base.cpp - FRI Manager → ROS 2 Controller Manager: requests controller switches
kuka_sunrise_fri_driver/src/robot_manager_node.cpp - EAC Manager → EAC Hardware: activates hardware
- RSI Manager → RSI Hardware: activates hardware
- RSI Manager → RSI Variants: specialized by
- RSI Variants → RSI Manager: inherits base
- RSI XML Config → RSI Hardware: configures RSI
- RSI Tools → RSI Manager: supports setup and monitoring
- FRI Manager → FRI Hardware: manages hardware
- FRI Manager → FRI Connection: uses connection
- FRI Hardware → FRI Connection: uses transport
- FRI Connection → FRI Client SDK: uses FRI client
- KUKA Robot → Robot FRI App: runs robot application
- Robot FRI App → Robot ROS Link: uses ROS link
kuka_sunrise_fri_driver/robot_application/src/ros2/modules/FRIManager.java - Robot FRI App → FRI Serialization: uses configuration encoding
kuka_sunrise_fri_driver/robot_application/src/ros2/modules/FRIManager.java - ROS 2 Controller Manager → Controller Plugins: loads plugins
- Controller Plugins → Control And HW Types: uses shared interfaces
controllers/fri_configuration_controller/src/fri_configuration_controller.cpp - EAC Manager → Control And HW Types: uses control modes and events
kuka_iiqka_eac_driver/src/robot_manager_node.cpp - RSI Manager → Control And HW Types: uses control modes and events
kuka_rsi_driver/src/robot_manager_base.cpp - FRI Manager → Control And HW Types: uses control modes and events
kuka_sunrise_fri_driver/src/robot_manager_node.cpp