# kroshu/kuka_drivers architecture

> Architecture diagram of the GitHub repository kroshu/kuka_drivers, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kroshu/kuka_drivers
- Repository: https://github.com/kroshu/kuka_drivers

## Overview

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: [`kuka_rsi_driver/src/robot_manager_base.cpp`](https://github.com/kroshu/kuka_drivers/blob/master/kuka_rsi_driver/src/robot_manager_base.cpp) (RSI Manager), [`kuka_iiqka_eac_driver/src/robot_manager_node.cpp`](https://github.com/kroshu/kuka_drivers/blob/master/kuka_iiqka_eac_driver/src/robot_manager_node.cpp) (EAC Manager), [`kuka_sunrise_fri_driver/src/robot_manager_node.cpp`](https://github.com/kroshu/kuka_drivers/blob/master/kuka_sunrise_fri_driver/src/robot_manager_node.cpp) (FRI Manager), [`kuka_drivers_core/include/kuka_drivers_core/control_mode.hpp`](https://github.com/kroshu/kuka_drivers/blob/master/kuka_drivers_core/include/kuka_drivers_core/control_mode.hpp) (Control And HW Types)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_core["Shared ROS 2 Core"]
  node_core_lifecycle["Lifecycle Nodes"]
  node_controller_logic["Controller Selection"]
  node_control_helpers["Control Services"]
  node_core_types["Control And HW Types<br/>[control_mode.hpp]"]
end

subgraph group_eac["EAC Driver"]
  node_eac_manager["EAC Manager"]
  node_eac_hardware["EAC Hardware"]
end

subgraph group_rsi["RSI Driver"]
  node_rsi_manager["RSI Manager"]
  node_rsi_variants["RSI Variants"]
  node_rsi_hardware["RSI Hardware"]
  node_rsi_config["RSI XML Config"]
  node_rsi_tools["RSI Tools"]
end

subgraph group_fri["Sunrise FRI Driver"]
  node_fri_manager["FRI Manager"]
  node_fri_hardware["FRI Hardware"]
  node_fri_connection["FRI Connection<br/>[fri_connection.cpp]"]
  node_fri_sdk["FRI Client SDK"]
  node_fri_app["Robot FRI App<br/>[FRIManager.java]"]
  node_ros_connection["Robot ROS Link"]
  node_fri_serialization["FRI Serialization"]
end

subgraph group_controllers["ROS 2 Controllers"]
  node_controller_plugins["Controller Plugins"]
end

node_user(("ROS 2 Operator"))
node_robot_system(("KUKA Robot"))
node_controller_manager["ROS 2 Controller Manager"]

node_user -.->|"configures lifecycle"| node_eac_manager
node_user -.->|"configures lifecycle"| node_rsi_manager
node_user -.->|"configures lifecycle"| node_fri_manager
node_eac_manager -->|"extends lifecycle"| node_core_lifecycle
node_rsi_manager -->|"extends lifecycle"| node_core_lifecycle
node_fri_manager -->|"extends lifecycle"| node_core_lifecycle
node_eac_manager -->|"changes hardware and controllers"| node_control_helpers
node_rsi_manager -->|"changes hardware and controllers"| node_control_helpers
node_fri_manager -->|"changes hardware and controllers"| node_control_helpers
node_eac_manager -->|"selects mode controllers"| node_controller_logic
node_rsi_manager -->|"selects mode controllers"| node_controller_logic
node_eac_manager -->|"requests controller switches"| node_controller_manager
node_rsi_manager -->|"requests lifecycle changes"| node_controller_manager
node_fri_manager -->|"requests controller switches"| node_controller_manager
node_eac_manager -.->|"activates hardware"| node_eac_hardware
node_rsi_manager -.->|"activates hardware"| node_rsi_hardware
node_rsi_manager -->|"specialized by"| node_rsi_variants
node_rsi_variants -->|"inherits base"| node_rsi_manager
node_rsi_config -.->|"configures RSI"| node_rsi_hardware
node_rsi_tools -.->|"supports setup and monitoring"| node_rsi_manager
node_fri_manager -.->|"manages hardware"| node_fri_hardware
node_fri_manager -->|"uses connection"| node_fri_connection
node_fri_hardware -.->|"uses transport"| node_fri_connection
node_fri_connection -.->|"uses FRI client"| node_fri_sdk
node_robot_system -.->|"runs robot application"| node_fri_app
node_fri_app -->|"uses ROS link"| node_ros_connection
node_fri_app -->|"uses configuration encoding"| node_fri_serialization
node_controller_manager -.->|"loads plugins"| node_controller_plugins
node_controller_plugins -->|"uses shared interfaces"| node_core_types
node_eac_manager -->|"uses control modes and events"| node_core_types
node_rsi_manager -->|"uses control modes and events"| node_core_types
node_fri_manager -->|"uses control modes and events"| node_core_types

click node_eac_manager "https://github.com/kroshu/kuka_drivers/blob/master/kuka_iiqka_eac_driver/src/robot_manager_node.cpp"
click node_eac_hardware "https://github.com/kroshu/kuka_drivers/blob/master/kuka_iiqka_eac_driver/src/hardware_interface.cpp"
click node_rsi_manager "https://github.com/kroshu/kuka_drivers/blob/master/kuka_rsi_driver/src/robot_manager_base.cpp"
click node_rsi_variants "https://github.com/kroshu/kuka_drivers/blob/master/kuka_rsi_driver/src/robot_manager_node_extended.cpp"
click node_rsi_hardware "https://github.com/kroshu/kuka_drivers/blob/master/kuka_rsi_driver/src/hardware_interface_rsi_base.cpp"
click node_rsi_config "https://github.com/kroshu/kuka_drivers/blob/master/kuka_rsi_driver/src/rsi_xml_configuration_parser.cpp"
click node_rsi_tools "https://github.com/kroshu/kuka_drivers/tree/master/kuka_rsi_driver/scripts"
click node_fri_manager "https://github.com/kroshu/kuka_drivers/blob/master/kuka_sunrise_fri_driver/src/robot_manager_node.cpp"
click node_fri_hardware "https://github.com/kroshu/kuka_drivers/blob/master/kuka_sunrise_fri_driver/src/hardware_interface.cpp"
click node_fri_connection "https://github.com/kroshu/kuka_drivers/blob/master/kuka_sunrise_fri_driver/src/connection_helpers/fri_connection.cpp"
click node_fri_sdk "https://github.com/kroshu/kuka_drivers/tree/master/kuka_sunrise_fri_driver/src/fri_client_sdk"
click node_fri_app "https://github.com/kroshu/kuka_drivers/blob/master/kuka_sunrise_fri_driver/robot_application/src/ros2/modules/FRIManager.java"
click node_ros_connection "https://github.com/kroshu/kuka_drivers/blob/master/kuka_sunrise_fri_driver/robot_application/src/ros2/modules/ROS2Connection.java"
click node_fri_serialization "https://github.com/kroshu/kuka_drivers/blob/master/kuka_sunrise_fri_driver/robot_application/src/ros2/serialization/FRIConfigurationParams.java"
click node_core_lifecycle "https://github.com/kroshu/kuka_drivers/blob/master/kuka_drivers_core/src/ros2_base_lc_node.cpp"
click node_controller_logic "https://github.com/kroshu/kuka_drivers/blob/master/kuka_drivers_core/src/controller_handler.cpp"
click node_control_helpers "https://github.com/kroshu/kuka_drivers/blob/master/kuka_drivers_core/include/communication_helpers/ros2_control_tools.hpp"
click node_core_types "https://github.com/kroshu/kuka_drivers/blob/master/kuka_drivers_core/include/kuka_drivers_core/control_mode.hpp"
click node_controller_plugins "https://github.com/kroshu/kuka_drivers/tree/master/controllers"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_core_lifecycle,node_controller_logic,node_control_helpers,node_core_types toneBlue
class node_eac_manager,node_eac_hardware toneAmber
class node_rsi_manager,node_rsi_variants,node_rsi_hardware,node_rsi_config,node_rsi_tools toneMint
class node_fri_manager,node_fri_hardware,node_fri_connection,node_fri_sdk,node_fri_app,node_ros_connection,node_fri_serialization toneRose
class node_controller_plugins,node_user,node_robot_system,node_controller_manager toneIndigo
```

## Components

### Shared ROS 2 Core

- [Lifecycle Nodes](https://github.com/kroshu/kuka_drivers/blob/master/kuka_drivers_core/src/ros2_base_lc_node.cpp): `kuka_drivers_core/src/ros2_base_lc_node.cpp`
- [Controller Selection](https://github.com/kroshu/kuka_drivers/blob/master/kuka_drivers_core/src/controller_handler.cpp): `kuka_drivers_core/src/controller_handler.cpp`
- [Control Services](https://github.com/kroshu/kuka_drivers/blob/master/kuka_drivers_core/include/communication_helpers/ros2_control_tools.hpp): `kuka_drivers_core/include/communication_helpers/ros2_control_tools.hpp`
- [Control And HW Types](https://github.com/kroshu/kuka_drivers/blob/master/kuka_drivers_core/include/kuka_drivers_core/control_mode.hpp): `kuka_drivers_core/include/kuka_drivers_core/control_mode.hpp`

### EAC Driver

- [EAC Manager](https://github.com/kroshu/kuka_drivers/blob/master/kuka_iiqka_eac_driver/src/robot_manager_node.cpp): `kuka_iiqka_eac_driver/src/robot_manager_node.cpp`
- [EAC Hardware](https://github.com/kroshu/kuka_drivers/blob/master/kuka_iiqka_eac_driver/src/hardware_interface.cpp): `kuka_iiqka_eac_driver/src/hardware_interface.cpp`

### RSI Driver

- [RSI Manager](https://github.com/kroshu/kuka_drivers/blob/master/kuka_rsi_driver/src/robot_manager_base.cpp): `kuka_rsi_driver/src/robot_manager_base.cpp`
- [RSI Variants](https://github.com/kroshu/kuka_drivers/blob/master/kuka_rsi_driver/src/robot_manager_node_extended.cpp): `kuka_rsi_driver/src/robot_manager_node_extended.cpp`
- [RSI Hardware](https://github.com/kroshu/kuka_drivers/blob/master/kuka_rsi_driver/src/hardware_interface_rsi_base.cpp): `kuka_rsi_driver/src/hardware_interface_rsi_base.cpp`
- [RSI XML Config](https://github.com/kroshu/kuka_drivers/blob/master/kuka_rsi_driver/src/rsi_xml_configuration_parser.cpp): `kuka_rsi_driver/src/rsi_xml_configuration_parser.cpp`
- [RSI Tools](https://github.com/kroshu/kuka_drivers/tree/master/kuka_rsi_driver/scripts): `kuka_rsi_driver/scripts`

### Sunrise FRI Driver

- [FRI Manager](https://github.com/kroshu/kuka_drivers/blob/master/kuka_sunrise_fri_driver/src/robot_manager_node.cpp): `kuka_sunrise_fri_driver/src/robot_manager_node.cpp`
- [FRI Hardware](https://github.com/kroshu/kuka_drivers/blob/master/kuka_sunrise_fri_driver/src/hardware_interface.cpp): `kuka_sunrise_fri_driver/src/hardware_interface.cpp`
- [FRI Connection](https://github.com/kroshu/kuka_drivers/blob/master/kuka_sunrise_fri_driver/src/connection_helpers/fri_connection.cpp): `kuka_sunrise_fri_driver/src/connection_helpers/fri_connection.cpp`
- [FRI Client SDK](https://github.com/kroshu/kuka_drivers/tree/master/kuka_sunrise_fri_driver/src/fri_client_sdk): `kuka_sunrise_fri_driver/src/fri_client_sdk`
- [Robot FRI App](https://github.com/kroshu/kuka_drivers/blob/master/kuka_sunrise_fri_driver/robot_application/src/ros2/modules/FRIManager.java): `kuka_sunrise_fri_driver/robot_application/src/ros2/modules/FRIManager.java`
- [Robot ROS Link](https://github.com/kroshu/kuka_drivers/blob/master/kuka_sunrise_fri_driver/robot_application/src/ros2/modules/ROS2Connection.java): `kuka_sunrise_fri_driver/robot_application/src/ros2/modules/ROS2Connection.java`
- [FRI Serialization](https://github.com/kroshu/kuka_drivers/blob/master/kuka_sunrise_fri_driver/robot_application/src/ros2/serialization/FRIConfigurationParams.java): `kuka_sunrise_fri_driver/robot_application/src/ros2/serialization/FRIConfigurationParams.java`

### ROS 2 Controllers

- [Controller Plugins](https://github.com/kroshu/kuka_drivers/tree/master/controllers): `controllers`

### Other components

- **ROS 2 Operator**
- **KUKA Robot**
- **ROS 2 Controller Manager**

## Connections

- 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 (evidence: `kuka_iiqka_eac_driver/src/robot_manager_node.cpp`)
- RSI Manager → Control Services: changes hardware and controllers (evidence: `kuka_rsi_driver/src/robot_manager_base.cpp`)
- FRI Manager → Control Services: changes hardware and controllers (evidence: `kuka_sunrise_fri_driver/src/robot_manager_node.cpp`)
- EAC Manager → Controller Selection: selects mode controllers (evidence: `kuka_iiqka_eac_driver/src/robot_manager_node.cpp`)
- RSI Manager → Controller Selection: selects mode controllers (evidence: `kuka_rsi_driver/src/robot_manager_base.cpp`)
- EAC Manager → ROS 2 Controller Manager: requests controller switches (evidence: `kuka_iiqka_eac_driver/src/robot_manager_node.cpp`)
- RSI Manager → ROS 2 Controller Manager: requests lifecycle changes (evidence: `kuka_rsi_driver/src/robot_manager_base.cpp`)
- FRI Manager → ROS 2 Controller Manager: requests controller switches (evidence: `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 (evidence: `kuka_sunrise_fri_driver/robot_application/src/ros2/modules/FRIManager.java`)
- Robot FRI App → FRI Serialization: uses configuration encoding (evidence: `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 (evidence: `controllers/fri_configuration_controller/src/fri_configuration_controller.cpp`)
- EAC Manager → Control And HW Types: uses control modes and events (evidence: `kuka_iiqka_eac_driver/src/robot_manager_node.cpp`)
- RSI Manager → Control And HW Types: uses control modes and events (evidence: `kuka_rsi_driver/src/robot_manager_base.cpp`)
- FRI Manager → Control And HW Types: uses control modes and events (evidence: `kuka_sunrise_fri_driver/src/robot_manager_node.cpp`)
