# psp2swu/miaki architecture

> Architecture diagram of the GitHub repository psp2swu/miaki, 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/psp2swu/miaki
- Repository: https://github.com/psp2swu/miaki

## Overview

Miaki is a PS Vita CEX-to-DevKit firmware mod. The primary workflow is selecting installation in the app, extracting and validating TOOL.PUP, preparing and flashing the system image, then restarting; the app also exposes restore, activation, identity, and boot-mode controls. The kernel module supplies low-level disk and SPKG operations. README-described features are retained, but their internal wiring is not inferred where source excerpts do not show it.

Main entry points: [`app/src/main.c`](https://github.com/psp2swu/miaki/blob/main/app/src/main.c) (App menu), [`app/src/include/flasher.c`](https://github.com/psp2swu/miaki/blob/main/app/src/include/flasher.c) (Firmware flasher), [`app/src/include/menu/activation.c`](https://github.com/psp2swu/miaki/blob/main/app/src/include/menu/activation.c) (Activation menu), [`app/src/include/ui/ui.c`](https://github.com/psp2swu/miaki/blob/main/app/src/include/ui/ui.c) (Menu UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Miaki app"]
  node_app_main["App menu<br/>[main.c]"]
  node_ui["Menu UI<br/>[ui.c]"]
  node_debug["Debug display<br/>[debugScreen.h]"]
end

subgraph group_firmware["Firmware operations"]
  node_pup["PUP extraction<br/>[pup.c]"]
  node_flasher["Firmware flasher<br/>[flasher.c]"]
  node_config["Flash configuration<br/>[config.c]"]
  node_boot["Boot repair<br/>[boot.c]"]
end

subgraph group_identity["Identity and modes"]
  node_edition["Console identity<br/>[edition.c]"]
  node_boot_modes["Boot modes<br/>[boot_parameters.c]"]
  node_devmode["Direct DevMode<br/>[devmode.c]"]
end

subgraph group_activation["Activation tools"]
  node_activation_menu["Activation menu<br/>[activation.c]"]
  node_kmspico["KMSpico activation<br/>[main.c]"]
end

subgraph group_runtime["Low-level runtime"]
  node_disk["Kernel disk I/O<br/>[main.c]"]
  node_spkg["SPKG decryptor<br/>[spkg.c]"]
  node_modules["Module loader<br/>[modules.c]"]
end

node_user(("Vita user"))

node_user -->|"selects options"| node_app_main
node_app_main -->|"draws menu"| node_ui
node_app_main -->|"installs or restores"| node_flasher
node_app_main -->|"opens activation"| node_activation_menu
node_app_main -->|"opens identity menu"| node_edition
node_app_main -->|"opens boot modes"| node_boot_modes
node_app_main -->|"repairs boot"| node_boot
node_flasher -->|"extracts package"| node_pup
node_flasher -->|"configures install"| node_config
node_flasher -->|"loads modules"| node_modules
node_flasher -->|"copies system image"| node_disk
node_flasher -->|"requests decryption"| node_spkg
node_activation_menu -.->|"supports long activation"| node_kmspico
node_user -.->|"activates DevMode"| node_devmode
node_flasher -->|"reports progress"| node_debug

click node_app_main "https://github.com/psp2swu/miaki/blob/main/app/src/main.c"
click node_ui "https://github.com/psp2swu/miaki/blob/main/app/src/include/ui/ui.c"
click node_debug "https://github.com/psp2swu/miaki/blob/main/app/src/debugScreen.h"
click node_pup "https://github.com/psp2swu/miaki/blob/main/app/src/pup.c"
click node_flasher "https://github.com/psp2swu/miaki/blob/main/app/src/include/flasher.c"
click node_config "https://github.com/psp2swu/miaki/blob/main/app/src/include/flasher/config.c"
click node_boot "https://github.com/psp2swu/miaki/blob/main/app/src/include/flasher/boot.c"
click node_disk "https://github.com/psp2swu/miaki/blob/main/kernel/src/main.c"
click node_spkg "https://github.com/psp2swu/miaki/blob/main/kernel/src/spkg.c"
click node_edition "https://github.com/psp2swu/miaki/blob/main/app/src/include/menu/edition.c"
click node_boot_modes "https://github.com/psp2swu/miaki/blob/main/app/src/include/menu/boot_parameters.c"
click node_activation_menu "https://github.com/psp2swu/miaki/blob/main/app/src/include/menu/activation.c"
click node_kmspico "https://github.com/psp2swu/miaki/blob/main/kmspico/src/main.c"
click node_devmode "https://github.com/psp2swu/miaki/blob/main/devmode/devmode.c"
click node_modules "https://github.com/psp2swu/miaki/blob/main/app/src/include/modules.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,node_ui,node_debug,node_user toneBlue
class node_pup,node_flasher,node_config,node_boot toneAmber
class node_edition,node_boot_modes,node_devmode toneMint
class node_activation_menu,node_kmspico toneRose
class node_disk,node_spkg,node_modules toneIndigo
```

## Components

### Miaki app

- [App menu](https://github.com/psp2swu/miaki/blob/main/app/src/main.c): `app/src/main.c`
- [Menu UI](https://github.com/psp2swu/miaki/blob/main/app/src/include/ui/ui.c): `app/src/include/ui/ui.c`
- [Debug display](https://github.com/psp2swu/miaki/blob/main/app/src/debugScreen.h): `app/src/debugScreen.h`

### Firmware operations

- [PUP extraction](https://github.com/psp2swu/miaki/blob/main/app/src/pup.c): `app/src/pup.c`
- [Firmware flasher](https://github.com/psp2swu/miaki/blob/main/app/src/include/flasher.c): `app/src/include/flasher.c`
- [Flash configuration](https://github.com/psp2swu/miaki/blob/main/app/src/include/flasher/config.c): `app/src/include/flasher/config.c`
- [Boot repair](https://github.com/psp2swu/miaki/blob/main/app/src/include/flasher/boot.c): `app/src/include/flasher/boot.c`

### Identity and modes

- [Console identity](https://github.com/psp2swu/miaki/blob/main/app/src/include/menu/edition.c): `app/src/include/menu/edition.c`
- [Boot modes](https://github.com/psp2swu/miaki/blob/main/app/src/include/menu/boot_parameters.c): `app/src/include/menu/boot_parameters.c`
- [Direct DevMode](https://github.com/psp2swu/miaki/blob/main/devmode/devmode.c): `devmode/devmode.c`

### Activation tools

- [Activation menu](https://github.com/psp2swu/miaki/blob/main/app/src/include/menu/activation.c): `app/src/include/menu/activation.c`
- [KMSpico activation](https://github.com/psp2swu/miaki/blob/main/kmspico/src/main.c): `kmspico/src/main.c`

### Low-level runtime

- [Kernel disk I/O](https://github.com/psp2swu/miaki/blob/main/kernel/src/main.c): `kernel/src/main.c`
- [SPKG decryptor](https://github.com/psp2swu/miaki/blob/main/kernel/src/spkg.c): `kernel/src/spkg.c`
- [Module loader](https://github.com/psp2swu/miaki/blob/main/app/src/include/modules.c): `app/src/include/modules.c`

### Other components

- **Vita user**

## Connections

- Vita user → App menu: selects options
- App menu → Menu UI: draws menu (evidence: `app/src/main.c`)
- App menu → Firmware flasher: installs or restores (evidence: `app/src/main.c`)
- App menu → Activation menu: opens activation (evidence: `app/src/main.c`)
- App menu → Console identity: opens identity menu (evidence: `app/src/main.c`)
- App menu → Boot modes: opens boot modes (evidence: `app/src/main.c`)
- App menu → Boot repair: repairs boot (evidence: `app/src/main.c`)
- Firmware flasher → PUP extraction: extracts package (evidence: `app/src/include/flasher.c`)
- Firmware flasher → Flash configuration: configures install (evidence: `app/src/include/flasher.c`)
- Firmware flasher → Module loader: loads modules (evidence: `app/src/include/flasher.c`)
- Firmware flasher → Kernel disk I/O: copies system image (evidence: `app/src/include/flasher.c`)
- Firmware flasher → SPKG decryptor: requests decryption (evidence: `app/src/include/flasher.c`)
- Activation menu → KMSpico activation: supports long activation
- Vita user → Direct DevMode: activates DevMode
- Firmware flasher → Debug display: reports progress (evidence: `app/src/include/flasher.c`)
