# renode/renode-infrastructure architecture

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

- Interactive diagram: https://gitdiagram.com/renode/renode-infrastructure
- Repository: https://github.com/renode/renode-infrastructure

## Overview

Renode is a platform emulator: its runtime models emulations containing machines, CPUs, buses, and peripherals, with a monitor and Python scripting for interaction. The supplied tree and excerpts support those major layers, but do not show the complete startup path or most runtime wiring. Edges are therefore limited to relationships visible in excerpts or explicitly listed by the source index; the README points elsewhere rather than documenting product capabilities.

Main entry points: [`src/Emulator/Extensions/UserInterface/Monitor.cs`](https://github.com/renode/renode-infrastructure/blob/master/src/Emulator/Extensions/UserInterface/Monitor.cs) (Monitor), [`src/Emulator/Extensions/UserInterface/MonitorPythonEngine.cs`](https://github.com/renode/renode-infrastructure/blob/master/src/Emulator/Extensions/UserInterface/MonitorPythonEngine.cs) (Monitor Python), [`src/Emulator/Main/Peripherals/DMA/DmaEngine.cs`](https://github.com/renode/renode-infrastructure/blob/master/src/Emulator/Main/Peripherals/DMA/DmaEngine.cs) (DMA engine), [`src/Emulator/Main/Core/EmulationManager.cs`](https://github.com/renode/renode-infrastructure/blob/master/src/Emulator/Main/Core/EmulationManager.cs) (Emulation manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["Interaction and scripting"]
  node_monitor["Monitor<br/>[Monitor.cs]"]
  node_tokenizer["Command tokenizer<br/>[Tokenizer.cs]"]
  node_monitor_python["Monitor Python"]
  node_python_engine["Python engine<br/>[PythonEngine.cs]"]
  node_commands["Monitor commands"]
end

subgraph group_runtime["Emulation runtime"]
  node_emulation_manager["Emulation manager"]
  node_emulation["Emulation<br/>[Emulation.cs]"]
  node_machine["Machine<br/>[Machine.cs]"]
  node_system_bus["System bus<br/>[SystemBus.cs]"]
  node_bus_api["Bus controller API<br/>[IBusController.cs]"]
  node_logging["Logging<br/>[Logger.cs]"]
end

subgraph group_execution["CPU execution"]
  node_translation_cpu["Translation CPU<br/>[TranslationCPU.cs]"]
  node_arm_cores["Arm cores"]
  node_riscv_cores["RISC-V cores"]
  node_x86_cores["x86 cores"]
end

subgraph group_devices["Peripheral devices"]
  node_mapped_memory["Mapped memory<br/>[MappedMemory.cs]"]
  node_peripheral_api["Peripheral API<br/>[IPeripheral.cs]"]
  node_dma["DMA engine<br/>[DmaEngine.cs]"]
  node_mass_storage["USB mass storage<br/>[MassStorage.cs]"]
  node_interrupt_controller["Arm interrupt controller"]
end

node_operator(("Operator"))

node_operator -.->|"interacts with"| node_monitor
node_monitor_python -->|"parses tokens"| node_tokenizer
node_monitor_python -->|"uses monitor"| node_monitor
node_monitor -->|"loads commands"| node_commands
node_python_engine -->|"exposes to scripts"| node_emulation_manager
node_emulation_manager -->|"creates"| node_emulation
node_system_bus -.->|"implements"| node_bus_api
node_dma -->|"transfers through"| node_bus_api
node_dma -->|"accesses"| node_mapped_memory
node_mass_storage -->|"implements"| node_peripheral_api
node_interrupt_controller -.->|"implements"| node_peripheral_api

click node_monitor "https://github.com/renode/renode-infrastructure/blob/master/src/Emulator/Extensions/UserInterface/Monitor.cs"
click node_tokenizer "https://github.com/renode/renode-infrastructure/blob/master/src/Emulator/Extensions/UserInterface/Tokenizer/Tokenizer.cs"
click node_monitor_python "https://github.com/renode/renode-infrastructure/blob/master/src/Emulator/Extensions/UserInterface/MonitorPythonEngine.cs"
click node_python_engine "https://github.com/renode/renode-infrastructure/blob/master/src/Emulator/Main/Core/PythonEngine.cs"
click node_commands "https://github.com/renode/renode-infrastructure/tree/master/src/Emulator/Extensions/UserInterface/Commands"
click node_emulation_manager "https://github.com/renode/renode-infrastructure/blob/master/src/Emulator/Main/Core/EmulationManager.cs"
click node_emulation "https://github.com/renode/renode-infrastructure/blob/master/src/Emulator/Main/Core/Emulation.cs"
click node_machine "https://github.com/renode/renode-infrastructure/blob/master/src/Emulator/Main/Core/Machine.cs"
click node_system_bus "https://github.com/renode/renode-infrastructure/blob/master/src/Emulator/Main/Peripherals/Bus/SystemBus.cs"
click node_bus_api "https://github.com/renode/renode-infrastructure/blob/master/src/Emulator/Main/Peripherals/Bus/IBusController.cs"
click node_translation_cpu "https://github.com/renode/renode-infrastructure/blob/master/src/Emulator/Peripherals/Peripherals/CPU/TranslationCPU.cs"
click node_arm_cores "https://github.com/renode/renode-infrastructure/tree/master/src/Emulator/Cores/Arm"
click node_riscv_cores "https://github.com/renode/renode-infrastructure/tree/master/src/Emulator/Cores/RiscV"
click node_x86_cores "https://github.com/renode/renode-infrastructure/tree/master/src/Emulator/Cores/X86"
click node_mapped_memory "https://github.com/renode/renode-infrastructure/blob/master/src/Emulator/Main/Peripherals/Memory/MappedMemory.cs"
click node_peripheral_api "https://github.com/renode/renode-infrastructure/blob/master/src/Emulator/Main/Peripherals/IPeripheral.cs"
click node_dma "https://github.com/renode/renode-infrastructure/blob/master/src/Emulator/Main/Peripherals/DMA/DmaEngine.cs"
click node_mass_storage "https://github.com/renode/renode-infrastructure/blob/master/src/Emulator/Peripherals/Peripherals/USBDeprecated/MassStorage.cs"
click node_interrupt_controller "https://github.com/renode/renode-infrastructure/blob/master/src/Emulator/Cores/Arm/ARM_GenericInterruptController.cs"
click node_logging "https://github.com/renode/renode-infrastructure/blob/master/src/Emulator/Main/Logging/Logger.cs"

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_monitor,node_tokenizer,node_monitor_python,node_python_engine,node_commands toneBlue
class node_emulation_manager,node_emulation,node_machine,node_system_bus,node_bus_api,node_logging toneAmber
class node_translation_cpu,node_arm_cores,node_riscv_cores,node_x86_cores toneMint
class node_mapped_memory,node_peripheral_api,node_dma,node_mass_storage,node_interrupt_controller toneRose
class node_operator toneIndigo
```

## Components

### Interaction and scripting

- [Monitor](https://github.com/renode/renode-infrastructure/blob/master/src/Emulator/Extensions/UserInterface/Monitor.cs): `src/Emulator/Extensions/UserInterface/Monitor.cs`
- [Command tokenizer](https://github.com/renode/renode-infrastructure/blob/master/src/Emulator/Extensions/UserInterface/Tokenizer/Tokenizer.cs): `src/Emulator/Extensions/UserInterface/Tokenizer/Tokenizer.cs`
- [Monitor Python](https://github.com/renode/renode-infrastructure/blob/master/src/Emulator/Extensions/UserInterface/MonitorPythonEngine.cs): `src/Emulator/Extensions/UserInterface/MonitorPythonEngine.cs`
- [Python engine](https://github.com/renode/renode-infrastructure/blob/master/src/Emulator/Main/Core/PythonEngine.cs): `src/Emulator/Main/Core/PythonEngine.cs`
- [Monitor commands](https://github.com/renode/renode-infrastructure/tree/master/src/Emulator/Extensions/UserInterface/Commands): `src/Emulator/Extensions/UserInterface/Commands`

### Emulation runtime

- [Emulation manager](https://github.com/renode/renode-infrastructure/blob/master/src/Emulator/Main/Core/EmulationManager.cs): `src/Emulator/Main/Core/EmulationManager.cs`
- [Emulation](https://github.com/renode/renode-infrastructure/blob/master/src/Emulator/Main/Core/Emulation.cs): `src/Emulator/Main/Core/Emulation.cs`
- [Machine](https://github.com/renode/renode-infrastructure/blob/master/src/Emulator/Main/Core/Machine.cs): `src/Emulator/Main/Core/Machine.cs`
- [System bus](https://github.com/renode/renode-infrastructure/blob/master/src/Emulator/Main/Peripherals/Bus/SystemBus.cs): `src/Emulator/Main/Peripherals/Bus/SystemBus.cs`
- [Bus controller API](https://github.com/renode/renode-infrastructure/blob/master/src/Emulator/Main/Peripherals/Bus/IBusController.cs): `src/Emulator/Main/Peripherals/Bus/IBusController.cs`
- [Logging](https://github.com/renode/renode-infrastructure/blob/master/src/Emulator/Main/Logging/Logger.cs): `src/Emulator/Main/Logging/Logger.cs`

### CPU execution

- [Translation CPU](https://github.com/renode/renode-infrastructure/blob/master/src/Emulator/Peripherals/Peripherals/CPU/TranslationCPU.cs): `src/Emulator/Peripherals/Peripherals/CPU/TranslationCPU.cs`
- [Arm cores](https://github.com/renode/renode-infrastructure/tree/master/src/Emulator/Cores/Arm): `src/Emulator/Cores/Arm`
- [RISC-V cores](https://github.com/renode/renode-infrastructure/tree/master/src/Emulator/Cores/RiscV): `src/Emulator/Cores/RiscV`
- [x86 cores](https://github.com/renode/renode-infrastructure/tree/master/src/Emulator/Cores/X86): `src/Emulator/Cores/X86`

### Peripheral devices

- [Mapped memory](https://github.com/renode/renode-infrastructure/blob/master/src/Emulator/Main/Peripherals/Memory/MappedMemory.cs): `src/Emulator/Main/Peripherals/Memory/MappedMemory.cs`
- [Peripheral API](https://github.com/renode/renode-infrastructure/blob/master/src/Emulator/Main/Peripherals/IPeripheral.cs): `src/Emulator/Main/Peripherals/IPeripheral.cs`
- [DMA engine](https://github.com/renode/renode-infrastructure/blob/master/src/Emulator/Main/Peripherals/DMA/DmaEngine.cs): `src/Emulator/Main/Peripherals/DMA/DmaEngine.cs`
- [USB mass storage](https://github.com/renode/renode-infrastructure/blob/master/src/Emulator/Peripherals/Peripherals/USBDeprecated/MassStorage.cs): `src/Emulator/Peripherals/Peripherals/USBDeprecated/MassStorage.cs`
- [Arm interrupt controller](https://github.com/renode/renode-infrastructure/blob/master/src/Emulator/Cores/Arm/ARM_GenericInterruptController.cs): `src/Emulator/Cores/Arm/ARM_GenericInterruptController.cs`

### Other components

- **Operator**

## Connections

- Operator → Monitor: interacts with
- Monitor Python → Command tokenizer: parses tokens (evidence: `src/Emulator/Extensions/UserInterface/MonitorPythonEngine.cs`)
- Monitor Python → Monitor: uses monitor (evidence: `src/Emulator/Extensions/UserInterface/MonitorPythonEngine.cs`)
- Monitor → Monitor commands: loads commands (evidence: `src/Emulator/Extensions/UserInterface/Monitor.cs`)
- Python engine → Emulation manager: exposes to scripts (evidence: `src/Emulator/Main/Core/PythonEngine.cs`)
- Emulation manager → Emulation: creates (evidence: `src/Emulator/Main/Core/EmulationManager.cs`)
- System bus → Bus controller API: implements
- DMA engine → Bus controller API: transfers through (evidence: `src/Emulator/Main/Peripherals/DMA/DmaEngine.cs`)
- DMA engine → Mapped memory: accesses (evidence: `src/Emulator/Main/Peripherals/DMA/DmaEngine.cs`)
- USB mass storage → Peripheral API: implements (evidence: `src/Emulator/Peripherals/Peripherals/USBDeprecated/MassStorage.cs`)
- Arm interrupt controller → Peripheral API: implements
