# ros-controls/ros2_control architecture

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

- Interactive diagram: https://gitdiagram.com/ros-controls/ros2_control
- Repository: https://github.com/ros-controls/ros2_control
- Video tour (about a minute): https://gitdiagram.com/ros-controls/ros2_control/video

## Overview

ros2_control is a ROS 2 framework for connecting controllers to robot hardware. Its principal runtime workflow loads hardware descriptions and exposes hardware interfaces; the controller manager then reads hardware, updates controllers, and writes commands, while managing controller and hardware lifecycle services. Controllers claim interfaces through the controller API, and joint-limit enforcement and chained controllers extend control behavior. The CLI and rqt plugin provide operator-facing management. Relationships are based on the supplied excerpts, source index references, and documented control-loop behavior; unsampled subsystem links are omitted where not established.

Main entry points: [`hardware_interface/src/resource_manager.cpp`](https://github.com/ros-controls/ros2_control/blob/master/hardware_interface/src/resource_manager.cpp) (Resource manager), [`controller_manager/src/controller_manager.cpp`](https://github.com/ros-controls/ros2_control/blob/master/controller_manager/src/controller_manager.cpp) (Controller manager), [`controller_interface/include/controller_interface/controller_interface_base.hpp`](https://github.com/ros-controls/ros2_control/blob/master/controller_interface/include/controller_interface/controller_interface_base.hpp) (Controller API), [`hardware_interface/include/hardware_interface/hardware_component_interface.hpp`](https://github.com/ros-controls/ros2_control/blob/master/hardware_interface/include/hardware_interface/hardware_component_interface.hpp) (Hardware components)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_management["Runtime management"]
  node_control_node["Control node"]
  node_manager["Controller manager"]
  node_manager_api["Manager services"]
  node_spawner["Spawner tools<br/>[spawner.py]"]
end

subgraph group_hardware["Hardware interfaces"]
  node_component_parser["Description parser"]
  node_resource_manager["Resource manager"]
  node_hardware_components["Hardware components"]
  node_handles["State and command handles<br/>[handle.hpp]"]
  node_semantic_components["Semantic components"]
  node_transmissions["Transmission models<br/>[transmission.hpp]"]
end

subgraph group_control["Controllers and limits"]
  node_controller_api["Controller API"]
  node_chainable_api["Chainable controllers"]
  node_joint_limits["Joint limiters"]
end

subgraph group_operator["Operator tools"]
  node_cli["Control CLI"]
  node_rqt["Manager GUI"]
end

node_operator_user(("Operator"))
node_robot_description["Robot description"]
node_hardware_plugins["Hardware plugins"]

node_operator_user -->|"runs commands"| node_cli
node_operator_user -->|"manages runtime"| node_rqt
node_control_node -.->|"starts"| node_manager
node_robot_description -->|"describes hardware"| node_resource_manager
node_manager -->|"reads and writes"| node_resource_manager
node_manager -->|"updates controllers"| node_controller_api
node_manager -.->|"serves management"| node_manager_api
node_cli -->|"calls services"| node_manager_api
node_rqt -->|"calls services"| node_manager_api
node_spawner -.->|"manages controllers"| node_manager_api
node_resource_manager -->|"parses descriptions"| node_component_parser
node_component_parser -->|"configures components"| node_hardware_components
node_resource_manager -->|"initializes and accesses"| node_hardware_components
node_hardware_components -.->|"exports interfaces"| node_handles
node_resource_manager -->|"claims interfaces"| node_handles
node_controller_api -->|"uses claimed interfaces"| node_handles
node_controller_api -->|"configures limits"| node_joint_limits
node_resource_manager -->|"enforces limits"| node_joint_limits
node_chainable_api -->|"extends"| node_controller_api
node_semantic_components -.->|"wraps interfaces"| node_handles
node_hardware_plugins -.->|"loaded as components"| node_resource_manager
node_transmissions -.->|"maps actuator motion"| node_hardware_components

click node_control_node "https://github.com/ros-controls/ros2_control/blob/master/controller_manager/src/ros2_control_node.cpp"
click node_manager "https://github.com/ros-controls/ros2_control/blob/master/controller_manager/src/controller_manager.cpp"
click node_manager_api "https://github.com/ros-controls/ros2_control/blob/master/controller_manager/controller_manager/controller_manager_services.py"
click node_spawner "https://github.com/ros-controls/ros2_control/blob/master/controller_manager/controller_manager/spawner.py"
click node_cli "https://github.com/ros-controls/ros2_control/tree/master/ros2controlcli/ros2controlcli/verb"
click node_rqt "https://github.com/ros-controls/ros2_control/blob/master/rqt_controller_manager/rqt_controller_manager/controller_manager.py"
click node_component_parser "https://github.com/ros-controls/ros2_control/blob/master/hardware_interface/src/component_parser.cpp"
click node_resource_manager "https://github.com/ros-controls/ros2_control/blob/master/hardware_interface/src/resource_manager.cpp"
click node_hardware_components "https://github.com/ros-controls/ros2_control/blob/master/hardware_interface/include/hardware_interface/hardware_component_interface.hpp"
click node_handles "https://github.com/ros-controls/ros2_control/blob/master/hardware_interface/include/hardware_interface/handle.hpp"
click node_semantic_components "https://github.com/ros-controls/ros2_control/tree/master/controller_interface/include/semantic_components"
click node_controller_api "https://github.com/ros-controls/ros2_control/blob/master/controller_interface/include/controller_interface/controller_interface_base.hpp"
click node_chainable_api "https://github.com/ros-controls/ros2_control/blob/master/controller_interface/include/controller_interface/chainable_controller_interface.hpp"
click node_joint_limits "https://github.com/ros-controls/ros2_control/blob/master/joint_limits/src/joint_saturation_limiter.cpp"
click node_transmissions "https://github.com/ros-controls/ros2_control/blob/master/transmission_interface/include/transmission_interface/transmission.hpp"

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_control_node,node_manager,node_manager_api,node_spawner toneBlue
class node_component_parser,node_resource_manager,node_hardware_components,node_handles,node_semantic_components,node_transmissions toneAmber
class node_controller_api,node_chainable_api,node_joint_limits toneMint
class node_cli,node_rqt toneRose
class node_operator_user,node_robot_description,node_hardware_plugins toneIndigo
```

## Components

### Runtime management

- [Control node](https://github.com/ros-controls/ros2_control/blob/master/controller_manager/src/ros2_control_node.cpp): `controller_manager/src/ros2_control_node.cpp`
- [Controller manager](https://github.com/ros-controls/ros2_control/blob/master/controller_manager/src/controller_manager.cpp): `controller_manager/src/controller_manager.cpp`
- [Manager services](https://github.com/ros-controls/ros2_control/blob/master/controller_manager/controller_manager/controller_manager_services.py): `controller_manager/controller_manager/controller_manager_services.py`
- [Spawner tools](https://github.com/ros-controls/ros2_control/blob/master/controller_manager/controller_manager/spawner.py): `controller_manager/controller_manager/spawner.py`

### Hardware interfaces

- [Description parser](https://github.com/ros-controls/ros2_control/blob/master/hardware_interface/src/component_parser.cpp): `hardware_interface/src/component_parser.cpp`
- [Resource manager](https://github.com/ros-controls/ros2_control/blob/master/hardware_interface/src/resource_manager.cpp): `hardware_interface/src/resource_manager.cpp`
- [Hardware components](https://github.com/ros-controls/ros2_control/blob/master/hardware_interface/include/hardware_interface/hardware_component_interface.hpp): `hardware_interface/include/hardware_interface/hardware_component_interface.hpp`
- [State and command handles](https://github.com/ros-controls/ros2_control/blob/master/hardware_interface/include/hardware_interface/handle.hpp): `hardware_interface/include/hardware_interface/handle.hpp`
- [Semantic components](https://github.com/ros-controls/ros2_control/tree/master/controller_interface/include/semantic_components): `controller_interface/include/semantic_components`
- [Transmission models](https://github.com/ros-controls/ros2_control/blob/master/transmission_interface/include/transmission_interface/transmission.hpp): `transmission_interface/include/transmission_interface/transmission.hpp`

### Controllers and limits

- [Controller API](https://github.com/ros-controls/ros2_control/blob/master/controller_interface/include/controller_interface/controller_interface_base.hpp): `controller_interface/include/controller_interface/controller_interface_base.hpp`
- [Chainable controllers](https://github.com/ros-controls/ros2_control/blob/master/controller_interface/include/controller_interface/chainable_controller_interface.hpp): `controller_interface/include/controller_interface/chainable_controller_interface.hpp`
- [Joint limiters](https://github.com/ros-controls/ros2_control/blob/master/joint_limits/src/joint_saturation_limiter.cpp): `joint_limits/src/joint_saturation_limiter.cpp`

### Operator tools

- [Control CLI](https://github.com/ros-controls/ros2_control/tree/master/ros2controlcli/ros2controlcli/verb): `ros2controlcli/ros2controlcli/verb`
- [Manager GUI](https://github.com/ros-controls/ros2_control/blob/master/rqt_controller_manager/rqt_controller_manager/controller_manager.py): `rqt_controller_manager/rqt_controller_manager/controller_manager.py`

### Other components

- **Operator**
- **Robot description**
- **Hardware plugins**

## Connections

- Operator → Control CLI: runs commands (evidence: `ros2controlcli/ros2controlcli/verb/list_controllers.py`)
- Operator → Manager GUI: manages runtime (evidence: `rqt_controller_manager/rqt_controller_manager/controller_manager.py`)
- Control node → Controller manager: starts
- Robot description → Resource manager: describes hardware
- Controller manager → Resource manager: reads and writes (evidence: `controller_manager/src/controller_manager.cpp`)
- Controller manager → Controller API: updates controllers (evidence: `controller_manager/src/controller_manager.cpp`)
- Controller manager → Manager services: serves management
- Control CLI → Manager services: calls services
- Manager GUI → Manager services: calls services (evidence: `rqt_controller_manager/rqt_controller_manager/controller_manager.py`)
- Spawner tools → Manager services: manages controllers
- Resource manager → Description parser: parses descriptions (evidence: `hardware_interface/src/resource_manager.cpp`)
- Description parser → Hardware components: configures components (evidence: `hardware_interface/src/component_parser.cpp`)
- Resource manager → Hardware components: initializes and accesses (evidence: `hardware_interface/src/resource_manager.cpp`)
- Hardware components → State and command handles: exports interfaces
- Resource manager → State and command handles: claims interfaces
- Controller API → State and command handles: uses claimed interfaces (evidence: `controller_interface/include/controller_interface/controller_interface_base.hpp`)
- Controller API → Joint limiters: configures limits (evidence: `controller_interface/include/controller_interface/controller_interface_base.hpp`)
- Resource manager → Joint limiters: enforces limits (evidence: `hardware_interface/src/resource_manager.cpp`)
- Chainable controllers → Controller API: extends (evidence: `controller_interface/include/controller_interface/chainable_controller_interface.hpp`)
- Semantic components → State and command handles: wraps interfaces
- Hardware plugins → Resource manager: loaded as components
- Transmission models → Hardware components: maps actuator motion
