# embeddedrpc/erpc architecture

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

- Interactive diagram: https://gitdiagram.com/embeddedrpc/erpc
- Repository: https://github.com/embeddedrpc/erpc

## Overview

eRPC is an embedded RPC system for multicore and multichip systems. Its main workflow is to define remote interfaces in IDL, generate language-specific shims, then exchange requests and replies through client/server runtimes, codecs, and transports. The repository also includes C, Java, and Python runtime implementations and an eRPC sniffer. The graph follows documented capabilities and indexed references; several runtime internals were not sampled, so uncertain connections are omitted.

Main entry points: [`erpc_c/setup/erpc_client_setup.cpp`](https://github.com/embeddedrpc/erpc/blob/main/erpc_c/setup/erpc_client_setup.cpp) (Client Setup), [`erpc_c/infra/erpc_transport.hpp`](https://github.com/embeddedrpc/erpc/blob/main/erpc_c/infra/erpc_transport.hpp) (Transport Interface), [`erpc_java/src/main/java/io/github/embeddedrpc/erpc/server/Server.java`](https://github.com/embeddedrpc/erpc/blob/main/erpc_java/src/main/java/io/github/embeddedrpc/erpc/server/Server.java) (Java Server), [`erpc_java/src/main/java/io/github/embeddedrpc/erpc/codec/Codec.java`](https://github.com/embeddedrpc/erpc/blob/main/erpc_java/src/main/java/io/github/embeddedrpc/erpc/codec/Codec.java) (Java Codec)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_gen["IDL Code Generation"]
  node_generator["eRPC Generator<br/>[erpcgen.cpp]"]
  node_generated_shims["Generated Shims"]
end

subgraph group_c_runtime["C Runtime"]
  node_c_setup["Client Setup"]
  node_c_manager["Client Manager"]
  node_c_codec["Basic Codec"]
  node_c_buffer["Message Buffers"]
  node_c_transport["Transport Interface<br/>[erpc_transport.hpp]"]
  node_c_transports["Hardware Transports"]
  node_c_server["Server Dispatch<br/>[erpc_server.hpp]"]
  node_c_arbitrator["Transport Arbitrator"]
  node_c_port["Platform Ports<br/>[erpc_threading.h]"]
end

subgraph group_java_runtime["Java Runtime"]
  node_java_client["Java Client<br/>[ClientManager.java]"]
  node_java_server["Java Server<br/>[Server.java]"]
  node_java_service["Java Services<br/>[Service.java]"]
  node_java_codec["Java Codec<br/>[Codec.java]"]
  node_java_transport["Java Transport<br/>[Transport.java]"]
end

subgraph group_py_runtime["Python Runtime"]
  node_python_client["Python Client<br/>[client.py]"]
  node_python_server["Python Server<br/>[server.py]"]
  node_python_transport["Python Transport<br/>[transport.py]"]
end

subgraph group_tools["Inspection Tools"]
  node_sniffer["eRPC Sniffer<br/>[Sniffer.cpp]"]
end

node_developer(("Interface Developer"))
node_idl["RPC IDL"]

node_developer -->|"defines interfaces"| node_idl
node_idl -->|"inputs IDL"| node_generator
node_generator -->|"generates shims"| node_generated_shims
node_generated_shims -.->|"uses runtime"| node_c_setup
node_c_setup -->|"initializes"| node_c_manager
node_c_setup -->|"creates codec factory"| node_c_codec
node_c_setup -->|"accepts transport"| node_c_transport
node_c_transport -->|"exchanges buffers"| node_c_buffer
node_c_transports -.->|"implements interface"| node_c_transport
node_c_setup -->|"creates arbitrator"| node_c_arbitrator
node_c_arbitrator -->|"shares transport"| node_c_transport
node_c_port -->|"provides threading"| node_c_manager
node_java_client -->|"creates codec"| node_java_codec
node_java_client -->|"sends requests"| node_java_transport
node_java_server -->|"dispatches methods"| node_java_service
node_java_server -->|"decodes messages"| node_java_codec
node_java_server -->|"receives requests"| node_java_transport
node_java_service -->|"uses codec"| node_java_codec
node_python_client -->|"sends requests"| node_python_transport
node_python_server -->|"uses transport"| node_python_transport
node_sniffer -->|"inspects messages"| node_c_buffer

click node_generator "https://github.com/embeddedrpc/erpc/blob/main/erpcgen/src/erpcgen.cpp"
click node_generated_shims "https://github.com/embeddedrpc/erpc/tree/main/erpcgen/src"
click node_c_setup "https://github.com/embeddedrpc/erpc/blob/main/erpc_c/setup/erpc_client_setup.cpp"
click node_c_manager "https://github.com/embeddedrpc/erpc/blob/main/erpc_c/infra/erpc_client_manager.cpp"
click node_c_codec "https://github.com/embeddedrpc/erpc/blob/main/erpc_c/infra/erpc_basic_codec.hpp"
click node_c_buffer "https://github.com/embeddedrpc/erpc/blob/main/erpc_c/infra/erpc_message_buffer.hpp"
click node_c_transport "https://github.com/embeddedrpc/erpc/blob/main/erpc_c/infra/erpc_transport.hpp"
click node_c_transports "https://github.com/embeddedrpc/erpc/tree/main/erpc_c/transports"
click node_c_server "https://github.com/embeddedrpc/erpc/blob/main/erpc_c/infra/erpc_server.hpp"
click node_c_arbitrator "https://github.com/embeddedrpc/erpc/blob/main/erpc_c/infra/erpc_transport_arbitrator.hpp"
click node_c_port "https://github.com/embeddedrpc/erpc/blob/main/erpc_c/port/erpc_threading.h"
click node_java_client "https://github.com/embeddedrpc/erpc/blob/main/erpc_java/src/main/java/io/github/embeddedrpc/erpc/client/ClientManager.java"
click node_java_server "https://github.com/embeddedrpc/erpc/blob/main/erpc_java/src/main/java/io/github/embeddedrpc/erpc/server/Server.java"
click node_java_service "https://github.com/embeddedrpc/erpc/blob/main/erpc_java/src/main/java/io/github/embeddedrpc/erpc/server/Service.java"
click node_java_codec "https://github.com/embeddedrpc/erpc/blob/main/erpc_java/src/main/java/io/github/embeddedrpc/erpc/codec/Codec.java"
click node_java_transport "https://github.com/embeddedrpc/erpc/blob/main/erpc_java/src/main/java/io/github/embeddedrpc/erpc/transport/Transport.java"
click node_python_client "https://github.com/embeddedrpc/erpc/blob/main/erpc_python/erpc/client.py"
click node_python_server "https://github.com/embeddedrpc/erpc/blob/main/erpc_python/erpc/server.py"
click node_python_transport "https://github.com/embeddedrpc/erpc/blob/main/erpc_python/erpc/transport.py"
click node_sniffer "https://github.com/embeddedrpc/erpc/blob/main/erpcsniffer/src/Sniffer.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_generator,node_generated_shims toneBlue
class node_c_setup,node_c_manager,node_c_codec,node_c_buffer,node_c_transport,node_c_transports,node_c_server,node_c_arbitrator,node_c_port toneAmber
class node_java_client,node_java_server,node_java_service,node_java_codec,node_java_transport toneMint
class node_python_client,node_python_server,node_python_transport toneRose
class node_sniffer,node_developer,node_idl toneIndigo
```

## Components

### IDL Code Generation

- [eRPC Generator](https://github.com/embeddedrpc/erpc/blob/main/erpcgen/src/erpcgen.cpp): `erpcgen/src/erpcgen.cpp`
- [Generated Shims](https://github.com/embeddedrpc/erpc/tree/main/erpcgen/src): `erpcgen/src`

### C Runtime

- [Client Setup](https://github.com/embeddedrpc/erpc/blob/main/erpc_c/setup/erpc_client_setup.cpp): `erpc_c/setup/erpc_client_setup.cpp`
- [Client Manager](https://github.com/embeddedrpc/erpc/blob/main/erpc_c/infra/erpc_client_manager.cpp): `erpc_c/infra/erpc_client_manager.cpp`
- [Basic Codec](https://github.com/embeddedrpc/erpc/blob/main/erpc_c/infra/erpc_basic_codec.hpp): `erpc_c/infra/erpc_basic_codec.hpp`
- [Message Buffers](https://github.com/embeddedrpc/erpc/blob/main/erpc_c/infra/erpc_message_buffer.hpp): `erpc_c/infra/erpc_message_buffer.hpp`
- [Transport Interface](https://github.com/embeddedrpc/erpc/blob/main/erpc_c/infra/erpc_transport.hpp): `erpc_c/infra/erpc_transport.hpp`
- [Hardware Transports](https://github.com/embeddedrpc/erpc/tree/main/erpc_c/transports): `erpc_c/transports`
- [Server Dispatch](https://github.com/embeddedrpc/erpc/blob/main/erpc_c/infra/erpc_server.hpp): `erpc_c/infra/erpc_server.hpp`
- [Transport Arbitrator](https://github.com/embeddedrpc/erpc/blob/main/erpc_c/infra/erpc_transport_arbitrator.hpp): `erpc_c/infra/erpc_transport_arbitrator.hpp`
- [Platform Ports](https://github.com/embeddedrpc/erpc/blob/main/erpc_c/port/erpc_threading.h): `erpc_c/port/erpc_threading.h`

### Java Runtime

- [Java Client](https://github.com/embeddedrpc/erpc/blob/main/erpc_java/src/main/java/io/github/embeddedrpc/erpc/client/ClientManager.java): `erpc_java/src/main/java/io/github/embeddedrpc/erpc/client/ClientManager.java`
- [Java Server](https://github.com/embeddedrpc/erpc/blob/main/erpc_java/src/main/java/io/github/embeddedrpc/erpc/server/Server.java): `erpc_java/src/main/java/io/github/embeddedrpc/erpc/server/Server.java`
- [Java Services](https://github.com/embeddedrpc/erpc/blob/main/erpc_java/src/main/java/io/github/embeddedrpc/erpc/server/Service.java): `erpc_java/src/main/java/io/github/embeddedrpc/erpc/server/Service.java`
- [Java Codec](https://github.com/embeddedrpc/erpc/blob/main/erpc_java/src/main/java/io/github/embeddedrpc/erpc/codec/Codec.java): `erpc_java/src/main/java/io/github/embeddedrpc/erpc/codec/Codec.java`
- [Java Transport](https://github.com/embeddedrpc/erpc/blob/main/erpc_java/src/main/java/io/github/embeddedrpc/erpc/transport/Transport.java): `erpc_java/src/main/java/io/github/embeddedrpc/erpc/transport/Transport.java`

### Python Runtime

- [Python Client](https://github.com/embeddedrpc/erpc/blob/main/erpc_python/erpc/client.py): `erpc_python/erpc/client.py`
- [Python Server](https://github.com/embeddedrpc/erpc/blob/main/erpc_python/erpc/server.py): `erpc_python/erpc/server.py`
- [Python Transport](https://github.com/embeddedrpc/erpc/blob/main/erpc_python/erpc/transport.py): `erpc_python/erpc/transport.py`

### Inspection Tools

- [eRPC Sniffer](https://github.com/embeddedrpc/erpc/blob/main/erpcsniffer/src/Sniffer.cpp): `erpcsniffer/src/Sniffer.cpp`

### Other components

- **Interface Developer**
- **RPC IDL**

## Connections

- Interface Developer → RPC IDL: defines interfaces (evidence: `README.md`)
- RPC IDL → eRPC Generator: inputs IDL (evidence: `README.md`)
- eRPC Generator → Generated Shims: generates shims (evidence: `README.md`)
- Generated Shims → Client Setup: uses runtime
- Client Setup → Client Manager: initializes (evidence: `erpc_c/setup/erpc_client_setup.cpp`)
- Client Setup → Basic Codec: creates codec factory (evidence: `erpc_c/setup/erpc_client_setup.cpp`)
- Client Setup → Transport Interface: accepts transport (evidence: `erpc_c/setup/erpc_client_setup.cpp`)
- Transport Interface → Message Buffers: exchanges buffers (evidence: `erpc_c/infra/erpc_transport.hpp`)
- Hardware Transports → Transport Interface: implements interface (evidence: `erpc_c/transports/erpc_ipc_service_zephyr_transport.hpp`)
- Client Setup → Transport Arbitrator: creates arbitrator
- Transport Arbitrator → Transport Interface: shares transport (evidence: `erpc_c/infra/erpc_transport_arbitrator.hpp`)
- Platform Ports → Client Manager: provides threading
- Java Client → Java Codec: creates codec (evidence: `erpc_java/src/main/java/io/github/embeddedrpc/erpc/client/ClientManager.java`)
- Java Client → Java Transport: sends requests (evidence: `erpc_java/src/main/java/io/github/embeddedrpc/erpc/client/ClientManager.java`)
- Java Server → Java Services: dispatches methods (evidence: `erpc_java/src/main/java/io/github/embeddedrpc/erpc/server/Server.java`)
- Java Server → Java Codec: decodes messages (evidence: `erpc_java/src/main/java/io/github/embeddedrpc/erpc/server/Server.java`)
- Java Server → Java Transport: receives requests (evidence: `erpc_java/src/main/java/io/github/embeddedrpc/erpc/server/Server.java`)
- Java Services → Java Codec: uses codec (evidence: `erpc_java/src/main/java/io/github/embeddedrpc/erpc/server/Service.java`)
- Python Client → Python Transport: sends requests (evidence: `erpc_python/erpc/client.py`)
- Python Server → Python Transport: uses transport (evidence: `erpc_python/erpc/server.py`)
- eRPC Sniffer → Message Buffers: inspects messages (evidence: `erpcsniffer/src/Sniffer.cpp`)
