# ximikboda/mremu architecture

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

- Interactive diagram: https://gitdiagram.com/ximikboda/mremu
- Repository: https://github.com/ximikboda/mremu

## Overview

MREmu emulates MediaTek MRE/VXP and VRE applications. The principal workflow is that a launch request reaches AppManager, which loads and prepares an application, selects a supported app type, starts it, and dispatches its events. App execution crosses Bridge into the emulated CPU and memory address space; the app also exposes MRE runtime services such as graphics, I/O, audio, sockets, timers, resources, and system callbacks. The README identifies the supported platforms but does not document a detailed user interface. Some subsystem links below are dashed because their implementation was not sampled.

Main entry points: [`MREmu/AppManager.cpp`](https://github.com/ximikboda/mremu/blob/master/MREmu/AppManager.cpp) (App manager), [`MREmu/App.cpp`](https://github.com/ximikboda/mremu/blob/master/MREmu/App.cpp) (Application instance), [`MREmu/MREngine/ProgramManager.cpp`](https://github.com/ximikboda/mremu/blob/master/MREmu/MREngine/ProgramManager.cpp) (Program manager API), [`MREmu/Bridge.cpp`](https://github.com/ximikboda/mremu/blob/master/MREmu/Bridge.cpp) (Execution bridge)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_orchestration["App orchestration"]
  node_manager["App manager<br/>[AppManager.cpp]"]
  node_launch_events["Launch events<br/>[AppManagerEvents.h]"]
  node_app_context["App context<br/>[AppContext.h]"]
  node_app["Application instance<br/>[App.cpp]"]
  node_native_app["Native app<br/>[NativeApp.cpp]"]
  node_arm_app["ARM app<br/>[ArmApp.cpp]"]
  node_dll_app["DLL app<br/>[DLLApp.cpp]"]
end

subgraph group_execution["Emulated execution"]
  node_bridge["Execution bridge<br/>[Bridge.cpp]"]
  node_cpu["Emulated CPU<br/>[Cpu.cpp]"]
  node_memory["Memory manager<br/>[Memory.cpp]"]
end

subgraph group_services["MRE runtime services"]
  node_system_api["System API<br/>[System.h]"]
  node_program_manager["Program manager API<br/>[ProgramManager.cpp]"]
  node_charset["Character sets<br/>[CharSet.h]"]
  node_engine_services["Runtime services"]
end

subgraph group_devices["Device interaction"]
  node_device_input["Keyboard and touch"]
  node_menubar["Device menubar<br/>[Menubar.cpp]"]
  node_app_selector["App selector<br/>[AppSelector.cpp]"]
end

node_user(("Application user"))

node_user -.->|"requests launch"| node_manager
node_manager -->|"queues launches"| node_launch_events
node_manager -->|"loads and prepares"| node_app
node_manager -->|"creates native"| node_native_app
node_manager -->|"selects format"| node_arm_app
node_manager -->|"selects format"| node_dll_app
node_manager -->|"starts app"| node_app
node_manager -.->|"sets executing app"| node_app_context
node_app -->|"dispatches calls"| node_bridge
node_bridge -->|"runs emulated code"| node_cpu
node_bridge -->|"translates addresses"| node_memory
node_program_manager -->|"gets app context"| node_app_context
node_program_manager -->|"queues app events"| node_manager
node_app -->|"owns app memory"| node_memory
node_app -.->|"uses callbacks"| node_system_api
node_app -.->|"provides runtime services"| node_engine_services
node_device_input -.->|"dispatches input"| node_manager
node_menubar -->|"reads context"| node_app_context
node_app_selector -.->|"requests selection"| node_manager
node_program_manager -->|"converts strings"| node_charset

click node_manager "https://github.com/ximikboda/mremu/blob/master/MREmu/AppManager.cpp"
click node_launch_events "https://github.com/ximikboda/mremu/blob/master/MREmu/AppManagerEvents.h"
click node_app_context "https://github.com/ximikboda/mremu/blob/master/MREmu/AppContext.h"
click node_app "https://github.com/ximikboda/mremu/blob/master/MREmu/App.cpp"
click node_native_app "https://github.com/ximikboda/mremu/blob/master/MREmu/NativeApp.cpp"
click node_arm_app "https://github.com/ximikboda/mremu/blob/master/MREmu/ArmApp.cpp"
click node_dll_app "https://github.com/ximikboda/mremu/blob/master/MREmu/DLLApp.cpp"
click node_bridge "https://github.com/ximikboda/mremu/blob/master/MREmu/Bridge.cpp"
click node_cpu "https://github.com/ximikboda/mremu/blob/master/MREmu/Cpu.cpp"
click node_memory "https://github.com/ximikboda/mremu/blob/master/MREmu/Memory.cpp"
click node_system_api "https://github.com/ximikboda/mremu/blob/master/MREmu/MREngine/System.h"
click node_program_manager "https://github.com/ximikboda/mremu/blob/master/MREmu/MREngine/ProgramManager.cpp"
click node_charset "https://github.com/ximikboda/mremu/blob/master/MREmu/MREngine/CharSet.h"
click node_engine_services "https://github.com/ximikboda/mremu/tree/master/MREmu/MREngine"
click node_device_input "https://github.com/ximikboda/mremu/tree/master/MREmu/Device"
click node_menubar "https://github.com/ximikboda/mremu/blob/master/MREmu/Device/Menubar.cpp"
click node_app_selector "https://github.com/ximikboda/mremu/blob/master/MREmu/NativeApps/Menu/AppSelector.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_manager,node_launch_events,node_app_context,node_app,node_native_app,node_arm_app,node_dll_app,node_user toneBlue
class node_bridge,node_cpu,node_memory toneAmber
class node_system_api,node_program_manager,node_charset,node_engine_services toneMint
class node_device_input,node_menubar,node_app_selector toneRose
```

## Components

### App orchestration

- [App manager](https://github.com/ximikboda/mremu/blob/master/MREmu/AppManager.cpp): `MREmu/AppManager.cpp`
- [Launch events](https://github.com/ximikboda/mremu/blob/master/MREmu/AppManagerEvents.h): `MREmu/AppManagerEvents.h`
- [App context](https://github.com/ximikboda/mremu/blob/master/MREmu/AppContext.h): `MREmu/AppContext.h`
- [Application instance](https://github.com/ximikboda/mremu/blob/master/MREmu/App.cpp): `MREmu/App.cpp`
- [Native app](https://github.com/ximikboda/mremu/blob/master/MREmu/NativeApp.cpp): `MREmu/NativeApp.cpp`
- [ARM app](https://github.com/ximikboda/mremu/blob/master/MREmu/ArmApp.cpp): `MREmu/ArmApp.cpp`
- [DLL app](https://github.com/ximikboda/mremu/blob/master/MREmu/DLLApp.cpp): `MREmu/DLLApp.cpp`

### Emulated execution

- [Execution bridge](https://github.com/ximikboda/mremu/blob/master/MREmu/Bridge.cpp): `MREmu/Bridge.cpp`
- [Emulated CPU](https://github.com/ximikboda/mremu/blob/master/MREmu/Cpu.cpp): `MREmu/Cpu.cpp`
- [Memory manager](https://github.com/ximikboda/mremu/blob/master/MREmu/Memory.cpp): `MREmu/Memory.cpp`

### MRE runtime services

- [System API](https://github.com/ximikboda/mremu/blob/master/MREmu/MREngine/System.h): `MREmu/MREngine/System.h`
- [Program manager API](https://github.com/ximikboda/mremu/blob/master/MREmu/MREngine/ProgramManager.cpp): `MREmu/MREngine/ProgramManager.cpp`
- [Character sets](https://github.com/ximikboda/mremu/blob/master/MREmu/MREngine/CharSet.h): `MREmu/MREngine/CharSet.h`
- [Runtime services](https://github.com/ximikboda/mremu/tree/master/MREmu/MREngine): `MREmu/MREngine`

### Device interaction

- [Keyboard and touch](https://github.com/ximikboda/mremu/tree/master/MREmu/Device): `MREmu/Device`
- [Device menubar](https://github.com/ximikboda/mremu/blob/master/MREmu/Device/Menubar.cpp): `MREmu/Device/Menubar.cpp`
- [App selector](https://github.com/ximikboda/mremu/blob/master/MREmu/NativeApps/Menu/AppSelector.cpp): `MREmu/NativeApps/Menu/AppSelector.cpp`

### Other components

- **Application user**

## Connections

- Application user → App manager: requests launch
- App manager → Launch events: queues launches (evidence: `MREmu/AppManager.cpp`)
- App manager → Application instance: loads and prepares (evidence: `MREmu/AppManager.cpp`)
- App manager → Native app: creates native (evidence: `MREmu/AppManager.cpp`)
- App manager → ARM app: selects format (evidence: `MREmu/AppManager.cpp`)
- App manager → DLL app: selects format (evidence: `MREmu/AppManager.cpp`)
- App manager → Application instance: starts app (evidence: `MREmu/AppManager.cpp`)
- App manager → App context: sets executing app
- Application instance → Execution bridge: dispatches calls
- Execution bridge → Emulated CPU: runs emulated code
- Execution bridge → Memory manager: translates addresses
- Program manager API → App context: gets app context (evidence: `MREmu/MREngine/ProgramManager.cpp`)
- Program manager API → App manager: queues app events (evidence: `MREmu/MREngine/ProgramManager.cpp`)
- Application instance → Memory manager: owns app memory
- Application instance → System API: uses callbacks
- Application instance → Runtime services: provides runtime services
- Keyboard and touch → App manager: dispatches input
- Device menubar → App context: reads context (evidence: `MREmu/Device/Menubar.cpp`)
- App selector → App manager: requests selection
- Program manager API → Character sets: converts strings (evidence: `MREmu/MREngine/ProgramManager.cpp`)
