# emirarkali/deos-core-protocol-stack architecture

> Architecture diagram of the GitHub repository emirarkali/deos-core-protocol-stack, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/emirarkali/deos-core-protocol-stack
- Repository: https://github.com/emirarkali/deos-core-protocol-stack

## Overview

DEOS Core is a Zephyr CAN-FD protocol stack for embedded nodes. An application initializes the core, registers command handlers, starts reception, and sends messages; incoming frames are decoded and dispatched to built-in network/diagnostic behavior or an application handler. The stack also supports hosted logical nodes, per-node fault diagnostics, and optional routing. The routing implementation is explicitly provisional; relationships shown here are based on the README and sampled source excerpts, not an inspection of every implementation detail.

Main entry points: [`lib/deos_core/src/deos_dispatch.c`](https://github.com/emirarkali/deos-core-protocol-stack/blob/main/lib/deos_core/src/deos_dispatch.c) (Message Dispatcher), [`src/main.c`](https://github.com/emirarkali/deos-core-protocol-stack/blob/main/src/main.c) (Example Integration), [`lib/deos_core/src/deos_core.c`](https://github.com/emirarkali/deos-core-protocol-stack/blob/main/lib/deos_core/src/deos_core.c) (Core Lifecycle), [`lib/deos_core/src/deos_tx.c`](https://github.com/emirarkali/deos-core-protocol-stack/blob/main/lib/deos_core/src/deos_tx.c) (CAN Transmission)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_app_main["Example Integration<br/>[main.c]"]
end

subgraph group_lifecycle["Core Lifecycle"]
  node_core["Core Lifecycle<br/>[deos_core.c]"]
  node_internal["Core Interfaces<br/>[deos_internal.h]"]
end

subgraph group_messaging["CAN Messaging"]
  node_dispatch["Message Dispatcher<br/>[deos_dispatch.c]"]
  node_rx["CAN Reception<br/>[deos_rx.c]"]
  node_tx["CAN Transmission<br/>[deos_tx.c]"]
  node_codec["Frame Codec<br/>[deos_codec.c]"]
end

subgraph group_services["Protocol Services"]
  node_network["Ping/Pong<br/>[deos_network.c]"]
  node_fault["Fault Diagnostics<br/>[deos_fault.c]"]
  node_fault_table[("Node Fault Tables<br/>[deos_fault.c]")]
  node_router["Router Stub<br/>[deos_router.c]"]
end

node_app_actor(("Control Application"))
node_can_bus(("CAN-FD Network"))
node_remote_nodes(("Peer Nodes"))

node_app_actor -->|"configures"| node_app_main
node_app_main -->|"initializes"| node_core
node_app_main -->|"registers handler"| node_dispatch
node_app_main -->|"starts"| node_core
node_app_main -->|"sends message"| node_tx
node_core -->|"initializes"| node_fault
node_core -->|"initializes"| node_dispatch
node_core -->|"starts reception"| node_rx
node_core -->|"initializes optionally"| node_router
node_rx -->|"receives frames"| node_can_bus
node_rx -->|"decodes frames"| node_codec
node_rx -->|"dispatches messages"| node_dispatch
node_dispatch -->|"routes nonlocal"| node_router
node_dispatch -->|"handles network commands"| node_network
node_dispatch -->|"handles diagnostics"| node_fault
node_dispatch -->|"invokes registered handler"| node_app_main
node_tx -->|"encodes frames"| node_codec
node_tx -->|"transmits frames"| node_can_bus
node_tx -->|"raises send fault"| node_fault
node_network -->|"sends ping or pong"| node_tx
node_fault -->|"updates and reads"| node_fault_table
node_fault -->|"streams responses"| node_tx
node_remote_nodes -->|"exchanges frames"| node_can_bus
node_can_bus -->|"delivers frames"| node_rx

click node_app_main "https://github.com/emirarkali/deos-core-protocol-stack/blob/main/src/main.c"
click node_core "https://github.com/emirarkali/deos-core-protocol-stack/blob/main/lib/deos_core/src/deos_core.c"
click node_dispatch "https://github.com/emirarkali/deos-core-protocol-stack/blob/main/lib/deos_core/src/deos_dispatch.c"
click node_rx "https://github.com/emirarkali/deos-core-protocol-stack/blob/main/lib/deos_core/src/deos_rx.c"
click node_tx "https://github.com/emirarkali/deos-core-protocol-stack/blob/main/lib/deos_core/src/deos_tx.c"
click node_codec "https://github.com/emirarkali/deos-core-protocol-stack/blob/main/lib/deos_core/src/deos_codec.c"
click node_internal "https://github.com/emirarkali/deos-core-protocol-stack/blob/main/lib/deos_core/src/deos_internal.h"
click node_network "https://github.com/emirarkali/deos-core-protocol-stack/blob/main/lib/deos_core/src/deos_network.c"
click node_fault "https://github.com/emirarkali/deos-core-protocol-stack/blob/main/lib/deos_core/src/deos_fault.c"
click node_fault_table "https://github.com/emirarkali/deos-core-protocol-stack/blob/main/lib/deos_core/src/deos_fault.c"
click node_router "https://github.com/emirarkali/deos-core-protocol-stack/blob/main/lib/deos_core/src/deos_router.c"

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_app_main toneBlue
class node_core,node_internal toneAmber
class node_dispatch,node_rx,node_tx,node_codec toneMint
class node_network,node_fault,node_fault_table,node_router toneRose
class node_app_actor,node_can_bus,node_remote_nodes toneIndigo
```

## Components

### Application

- [Example Integration](https://github.com/emirarkali/deos-core-protocol-stack/blob/main/src/main.c): `src/main.c`

### Core Lifecycle

- [Core Lifecycle](https://github.com/emirarkali/deos-core-protocol-stack/blob/main/lib/deos_core/src/deos_core.c): `lib/deos_core/src/deos_core.c`
- [Core Interfaces](https://github.com/emirarkali/deos-core-protocol-stack/blob/main/lib/deos_core/src/deos_internal.h): `lib/deos_core/src/deos_internal.h`

### CAN Messaging

- [Message Dispatcher](https://github.com/emirarkali/deos-core-protocol-stack/blob/main/lib/deos_core/src/deos_dispatch.c): `lib/deos_core/src/deos_dispatch.c`
- [CAN Reception](https://github.com/emirarkali/deos-core-protocol-stack/blob/main/lib/deos_core/src/deos_rx.c): `lib/deos_core/src/deos_rx.c`
- [CAN Transmission](https://github.com/emirarkali/deos-core-protocol-stack/blob/main/lib/deos_core/src/deos_tx.c): `lib/deos_core/src/deos_tx.c`
- [Frame Codec](https://github.com/emirarkali/deos-core-protocol-stack/blob/main/lib/deos_core/src/deos_codec.c): `lib/deos_core/src/deos_codec.c`

### Protocol Services

- [Ping/Pong](https://github.com/emirarkali/deos-core-protocol-stack/blob/main/lib/deos_core/src/deos_network.c): `lib/deos_core/src/deos_network.c`
- [Fault Diagnostics](https://github.com/emirarkali/deos-core-protocol-stack/blob/main/lib/deos_core/src/deos_fault.c): `lib/deos_core/src/deos_fault.c`
- [Node Fault Tables](https://github.com/emirarkali/deos-core-protocol-stack/blob/main/lib/deos_core/src/deos_fault.c): `lib/deos_core/src/deos_fault.c`
- [Router Stub](https://github.com/emirarkali/deos-core-protocol-stack/blob/main/lib/deos_core/src/deos_router.c): `lib/deos_core/src/deos_router.c`

### Other components

- **Control Application**
- **CAN-FD Network**
- **Peer Nodes**

## Connections

- Control Application → Example Integration: configures (evidence: `src/main.c`)
- Example Integration → Core Lifecycle: initializes (evidence: `src/main.c`)
- Example Integration → Message Dispatcher: registers handler (evidence: `src/main.c`)
- Example Integration → Core Lifecycle: starts (evidence: `src/main.c`)
- Example Integration → CAN Transmission: sends message (evidence: `src/main.c`)
- Core Lifecycle → Fault Diagnostics: initializes (evidence: `lib/deos_core/src/deos_core.c`)
- Core Lifecycle → Message Dispatcher: initializes (evidence: `lib/deos_core/src/deos_core.c`)
- Core Lifecycle → CAN Reception: starts reception (evidence: `lib/deos_core/src/deos_core.c`)
- Core Lifecycle → Router Stub: initializes optionally (evidence: `lib/deos_core/src/deos_core.c`)
- CAN Reception → CAN-FD Network: receives frames (evidence: `lib/deos_core/src/deos_rx.c`)
- CAN Reception → Frame Codec: decodes frames (evidence: `lib/deos_core/src/deos_rx.c`)
- CAN Reception → Message Dispatcher: dispatches messages (evidence: `lib/deos_core/src/deos_rx.c`)
- Message Dispatcher → Router Stub: routes nonlocal (evidence: `lib/deos_core/src/deos_dispatch.c`)
- Message Dispatcher → Ping/Pong: handles network commands (evidence: `lib/deos_core/src/deos_dispatch.c`)
- Message Dispatcher → Fault Diagnostics: handles diagnostics (evidence: `lib/deos_core/src/deos_dispatch.c`)
- Message Dispatcher → Example Integration: invokes registered handler (evidence: `lib/deos_core/src/deos_dispatch.c`)
- CAN Transmission → Frame Codec: encodes frames (evidence: `lib/deos_core/src/deos_tx.c`)
- CAN Transmission → CAN-FD Network: transmits frames (evidence: `lib/deos_core/src/deos_tx.c`)
- CAN Transmission → Fault Diagnostics: raises send fault (evidence: `lib/deos_core/src/deos_tx.c`)
- Ping/Pong → CAN Transmission: sends ping or pong (evidence: `lib/deos_core/src/deos_network.c`)
- Fault Diagnostics → Node Fault Tables: updates and reads (evidence: `lib/deos_core/src/deos_fault.c`)
- Fault Diagnostics → CAN Transmission: streams responses (evidence: `lib/deos_core/src/deos_fault.c`)
- Peer Nodes → CAN-FD Network: exchanges frames (evidence: `README.md`)
- CAN-FD Network → CAN Reception: delivers frames (evidence: `lib/deos_core/src/deos_rx.c`)
