# yanglianoo/cmw architecture

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

- Interactive diagram: https://gitdiagram.com/yanglianoo/cmw
- Repository: https://github.com/yanglianoo/cmw

## Overview

cmw is a C++ middleware project described as based on CyberRT and Fast DDS. Its principal workflow is application code using node publisher/subscriber APIs to exchange channel messages through transport; serialization and transport implementations support that flow. A separate runtime branch discovers processes and channel roles and maintains topology. Scheduling/task execution, components, class loading, and blocker-based message handling are additional runtime capabilities apparent from the source tree. The tree and excerpts establish the architecture’s broad shape; many links to unsampled modules are intentionally left unverified.

Main entry points: [`transport/rtps/participant.cpp`](https://github.com/yanglianoo/cmw/blob/master/transport/rtps/participant.cpp) (RTPS Transport), [`discovery/topology_manager.cpp`](https://github.com/yanglianoo/cmw/blob/master/discovery/topology_manager.cpp) (Topology Manager), [`discovery/specific_manager/manager.cpp`](https://github.com/yanglianoo/cmw/blob/master/discovery/specific_manager/manager.cpp) (Discovery Protocol), [`task/task_manager.cpp`](https://github.com/yanglianoo/cmw/blob/master/task/task_manager.cpp) (Task Manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Node and Messages"]
  node_node_api["Node API<br/>[node.cpp]"]
  node_publisher["Publisher<br/>[publisher.h]"]
  node_subscriber["Subscriber<br/>[subscriber.h]"]
  node_channel_data["Channel Data<br/>[data_dispatcher.h]"]
  node_serialization["Serialization<br/>[data_stream.cpp]"]
  node_listener["Listener Dispatch<br/>[listener_handler.h]"]
end

subgraph group_transport["Message Transport"]
  node_dispatcher["Transport Dispatcher<br/>[dispatcher.cpp]"]
  node_transport_core["Transport Core<br/>[transport.cpp]"]
  node_rtps["RTPS Transport<br/>[participant.cpp]"]
  node_shared_memory["Shared Memory<br/>[segment.cpp]"]
end

subgraph group_discovery["Topology Discovery"]
  node_topology["Topology Manager"]
  node_node_discovery["Node Discovery<br/>[node_manager.cpp]"]
  node_channel_discovery["Channel Discovery"]
  node_discovery_manager["Discovery Protocol<br/>[manager.cpp]"]
  node_graph["Topology Graph<br/>[graph.cpp]"]
end

subgraph group_runtime["Runtime Services"]
  node_scheduler["Scheduler<br/>[scheduler.cpp]"]
  node_task_manager["Task Manager<br/>[task_manager.cpp]"]
  node_coroutines["Coroutines<br/>[croutine.cpp]"]
  node_components["Components<br/>[component_base.h]"]
  node_class_loader["Class Loader"]
  node_blocker["Blocker Manager"]
end

node_application(("Application"))

node_application -.->|"uses"| node_node_api
node_node_api -.->|"creates"| node_publisher
node_node_api -.->|"creates"| node_subscriber
node_publisher -.->|"publishes"| node_channel_data
node_subscriber -.->|"receives"| node_channel_data
node_channel_data -.->|"serializes"| node_serialization
node_serialization -.->|"encodes messages"| node_dispatcher
node_dispatcher -.->|"dispatches"| node_transport_core
node_transport_core -.->|"selects transport"| node_rtps
node_transport_core -.->|"selects transport"| node_shared_memory
node_dispatcher -.->|"delivers callbacks"| node_listener
node_topology -->|"starts discovery"| node_node_discovery
node_topology -->|"starts discovery"| node_channel_discovery
node_topology -->|"creates participant"| node_rtps
node_discovery_manager -->|"encodes changes"| node_serialization
node_discovery_manager -->|"publishes changes"| node_rtps
node_discovery_manager -->|"creates reader"| node_rtps
node_channel_discovery -.->|"updates topology"| node_graph
node_task_manager -->|"creates tasks"| node_scheduler
node_task_manager -->|"runs routines"| node_coroutines
node_task_manager -->|"notifies workers"| node_scheduler
node_components -.->|"loads dynamically"| node_class_loader
node_application -.->|"uses callbacks"| node_blocker

click node_node_api "https://github.com/yanglianoo/cmw/blob/master/node/node.cpp"
click node_publisher "https://github.com/yanglianoo/cmw/blob/master/node/publisher.h"
click node_subscriber "https://github.com/yanglianoo/cmw/blob/master/node/subscriber.h"
click node_channel_data "https://github.com/yanglianoo/cmw/blob/master/data/data_dispatcher.h"
click node_serialization "https://github.com/yanglianoo/cmw/blob/master/serialize/data_stream.cpp"
click node_listener "https://github.com/yanglianoo/cmw/blob/master/transport/message/listener_handler.h"
click node_dispatcher "https://github.com/yanglianoo/cmw/blob/master/transport/dispatcher/dispatcher.cpp"
click node_transport_core "https://github.com/yanglianoo/cmw/blob/master/transport/transport.cpp"
click node_rtps "https://github.com/yanglianoo/cmw/blob/master/transport/rtps/participant.cpp"
click node_shared_memory "https://github.com/yanglianoo/cmw/blob/master/transport/shm/segment.cpp"
click node_topology "https://github.com/yanglianoo/cmw/blob/master/discovery/topology_manager.cpp"
click node_node_discovery "https://github.com/yanglianoo/cmw/blob/master/discovery/specific_manager/node_manager.cpp"
click node_channel_discovery "https://github.com/yanglianoo/cmw/blob/master/discovery/specific_manager/channel_manager.cpp"
click node_discovery_manager "https://github.com/yanglianoo/cmw/blob/master/discovery/specific_manager/manager.cpp"
click node_graph "https://github.com/yanglianoo/cmw/blob/master/discovery/container/graph.cpp"
click node_scheduler "https://github.com/yanglianoo/cmw/blob/master/scheduler/scheduler.cpp"
click node_task_manager "https://github.com/yanglianoo/cmw/blob/master/task/task_manager.cpp"
click node_coroutines "https://github.com/yanglianoo/cmw/blob/master/croutine/croutine.cpp"
click node_components "https://github.com/yanglianoo/cmw/blob/master/component/component_base.h"
click node_class_loader "https://github.com/yanglianoo/cmw/blob/master/class_loader/class_loader_manager.cpp"
click node_blocker "https://github.com/yanglianoo/cmw/blob/master/blocker/blocker_manager.cpp"

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_node_api,node_publisher,node_subscriber,node_channel_data,node_serialization,node_listener toneBlue
class node_dispatcher,node_transport_core,node_rtps,node_shared_memory toneAmber
class node_topology,node_node_discovery,node_channel_discovery,node_discovery_manager,node_graph toneMint
class node_scheduler,node_task_manager,node_coroutines,node_components,node_class_loader,node_blocker toneRose
class node_application toneIndigo
```

## Components

### Node and Messages

- [Node API](https://github.com/yanglianoo/cmw/blob/master/node/node.cpp): `node/node.cpp`
- [Publisher](https://github.com/yanglianoo/cmw/blob/master/node/publisher.h): `node/publisher.h`
- [Subscriber](https://github.com/yanglianoo/cmw/blob/master/node/subscriber.h): `node/subscriber.h`
- [Channel Data](https://github.com/yanglianoo/cmw/blob/master/data/data_dispatcher.h): `data/data_dispatcher.h`
- [Serialization](https://github.com/yanglianoo/cmw/blob/master/serialize/data_stream.cpp): `serialize/data_stream.cpp`
- [Listener Dispatch](https://github.com/yanglianoo/cmw/blob/master/transport/message/listener_handler.h): `transport/message/listener_handler.h`

### Message Transport

- [Transport Dispatcher](https://github.com/yanglianoo/cmw/blob/master/transport/dispatcher/dispatcher.cpp): `transport/dispatcher/dispatcher.cpp`
- [Transport Core](https://github.com/yanglianoo/cmw/blob/master/transport/transport.cpp): `transport/transport.cpp`
- [RTPS Transport](https://github.com/yanglianoo/cmw/blob/master/transport/rtps/participant.cpp): `transport/rtps/participant.cpp`
- [Shared Memory](https://github.com/yanglianoo/cmw/blob/master/transport/shm/segment.cpp): `transport/shm/segment.cpp`

### Topology Discovery

- [Topology Manager](https://github.com/yanglianoo/cmw/blob/master/discovery/topology_manager.cpp): `discovery/topology_manager.cpp`
- [Node Discovery](https://github.com/yanglianoo/cmw/blob/master/discovery/specific_manager/node_manager.cpp): `discovery/specific_manager/node_manager.cpp`
- [Channel Discovery](https://github.com/yanglianoo/cmw/blob/master/discovery/specific_manager/channel_manager.cpp): `discovery/specific_manager/channel_manager.cpp`
- [Discovery Protocol](https://github.com/yanglianoo/cmw/blob/master/discovery/specific_manager/manager.cpp): `discovery/specific_manager/manager.cpp`
- [Topology Graph](https://github.com/yanglianoo/cmw/blob/master/discovery/container/graph.cpp): `discovery/container/graph.cpp`

### Runtime Services

- [Scheduler](https://github.com/yanglianoo/cmw/blob/master/scheduler/scheduler.cpp): `scheduler/scheduler.cpp`
- [Task Manager](https://github.com/yanglianoo/cmw/blob/master/task/task_manager.cpp): `task/task_manager.cpp`
- [Coroutines](https://github.com/yanglianoo/cmw/blob/master/croutine/croutine.cpp): `croutine/croutine.cpp`
- [Components](https://github.com/yanglianoo/cmw/blob/master/component/component_base.h): `component/component_base.h`
- [Class Loader](https://github.com/yanglianoo/cmw/blob/master/class_loader/class_loader_manager.cpp): `class_loader/class_loader_manager.cpp`
- [Blocker Manager](https://github.com/yanglianoo/cmw/blob/master/blocker/blocker_manager.cpp): `blocker/blocker_manager.cpp`

### Other components

- **Application**

## Connections

- Application → Node API: uses
- Node API → Publisher: creates
- Node API → Subscriber: creates
- Publisher → Channel Data: publishes
- Subscriber → Channel Data: receives
- Channel Data → Serialization: serializes
- Serialization → Transport Dispatcher: encodes messages
- Transport Dispatcher → Transport Core: dispatches
- Transport Core → RTPS Transport: selects transport
- Transport Core → Shared Memory: selects transport
- Transport Dispatcher → Listener Dispatch: delivers callbacks
- Topology Manager → Node Discovery: starts discovery (evidence: `discovery/topology_manager.cpp`)
- Topology Manager → Channel Discovery: starts discovery (evidence: `discovery/topology_manager.cpp`)
- Topology Manager → RTPS Transport: creates participant (evidence: `discovery/topology_manager.cpp`)
- Discovery Protocol → Serialization: encodes changes (evidence: `discovery/specific_manager/manager.cpp`)
- Discovery Protocol → RTPS Transport: publishes changes (evidence: `discovery/specific_manager/manager.cpp`)
- Discovery Protocol → RTPS Transport: creates reader (evidence: `discovery/specific_manager/manager.cpp`)
- Channel Discovery → Topology Graph: updates topology
- Task Manager → Scheduler: creates tasks (evidence: `task/task_manager.cpp`)
- Task Manager → Coroutines: runs routines (evidence: `task/task_manager.cpp`)
- Task Manager → Scheduler: notifies workers
- Components → Class Loader: loads dynamically
- Application → Blocker Manager: uses callbacks
