# djphazer/o_c-phazerville architecture

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

- Interactive diagram: https://gitdiagram.com/djphazer/o_c-phazerville
- Repository: https://github.com/djphazer/o_c-phazerville

## Overview

Phazerville Suite is firmware for Ornament & Crime Eurorack modules, expanding the Hemisphere applet system and retaining stock O&C applications. The principal workflow is hardware input and user interaction, selecting and running an app or applet, then producing CV, gate, MIDI, or audio output. The graph includes the documented application families and audio capabilities; links for unsampled runtime modules are limited to the evident firmware workflow, not detailed call claims. EEPROM persistence and clock management are supported by sampled source excerpts.

Main entry points: [`software/src/OC_core.cpp`](https://github.com/djphazer/o_c-phazerville/blob/main/software/src/OC_core.cpp) (Core runtime), [`software/src/AppletRegistry.h`](https://github.com/djphazer/o_c-phazerville/blob/main/software/src/AppletRegistry.h) (Applet registry), [`software/src/Main.cpp`](https://github.com/djphazer/o_c-phazerville/blob/main/software/src/Main.cpp) (Firmware entry), [`software/src/HemisphereApplet.cpp`](https://github.com/djphazer/o_c-phazerville/blob/main/software/src/HemisphereApplet.cpp) (Hemisphere framework)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Firmware runtime"]
  node_main["Firmware entry<br/>[Main.cpp]"]
  node_core["Core runtime<br/>[OC_core.cpp]"]
  node_registry["Applet registry<br/>[AppletRegistry.h]"]
  node_hemisphere["Hemisphere framework"]
end

subgraph group_features["Musical features"]
  node_applets["Hemisphere applets"]
  node_apps["O&amp;C applications"]
  node_sequins["Sequins sequencer<br/>[Sequins.h]"]
  node_envseq["Envelope sequencer<br/>[EnvSeq.h]"]
  node_clock["Clock manager<br/>[HSClockManager.h]"]
end

subgraph group_audio["Audio DSP"]
  node_audioio["Audio I/O<br/>[AudioIO.cpp]"]
  node_audioapplets["Audio applets"]
  node_audiolib["Audio processing"]
end

subgraph group_platform["Hardware and state"]
  node_io["I/O processing<br/>[OC_io.cpp]"]
  node_display["Display and UI<br/>[OC_ui.cpp]"]
  node_settings["Firmware settings<br/>[OC_storage.h]"]
  node_pages["Wear-level storage<br/>[util_pagestorage.h]"]
  node_eeprom[("EEPROM storage<br/>[EEPROMStorage.h]")]
  node_drivers["Hardware drivers<br/>[OC_ADC.cpp]"]
end

node_user(("Module user"))
node_module{{"O&amp;C module"}}

node_user -->|"operates"| node_module
node_module -->|"starts firmware"| node_main
node_main -->|"starts runtime"| node_core
node_core -->|"processes I/O"| node_io
node_core -->|"updates interface"| node_display
node_core -->|"dispatches applets"| node_registry
node_registry -->|"selects framework"| node_hemisphere
node_hemisphere -->|"runs applets"| node_applets
node_registry -->|"selects applications"| node_apps
node_apps -->|"includes sequencer"| node_sequins
node_applets -->|"includes envelope sequencer"| node_envseq
node_core -->|"services timing"| node_clock
node_core -->|"services audio"| node_audioio
node_audioio -->|"runs audio applets"| node_audioapplets
node_audioapplets -->|"uses DSP"| node_audiolib
node_io -->|"accesses hardware"| node_drivers
node_settings -->|"stores settings"| node_pages
node_pages -->|"reads and writes"| node_eeprom

click node_main "https://github.com/djphazer/o_c-phazerville/blob/main/software/src/Main.cpp"
click node_core "https://github.com/djphazer/o_c-phazerville/blob/main/software/src/OC_core.cpp"
click node_io "https://github.com/djphazer/o_c-phazerville/blob/main/software/src/OC_io.cpp"
click node_display "https://github.com/djphazer/o_c-phazerville/blob/main/software/src/OC_ui.cpp"
click node_registry "https://github.com/djphazer/o_c-phazerville/blob/main/software/src/AppletRegistry.h"
click node_hemisphere "https://github.com/djphazer/o_c-phazerville/blob/main/software/src/HemisphereApplet.cpp"
click node_applets "https://github.com/djphazer/o_c-phazerville/tree/main/software/src/applets"
click node_apps "https://github.com/djphazer/o_c-phazerville/tree/main/software/src/apps"
click node_sequins "https://github.com/djphazer/o_c-phazerville/blob/main/software/src/apps/Sequins.h"
click node_envseq "https://github.com/djphazer/o_c-phazerville/blob/main/software/src/applets/EnvSeq.h"
click node_clock "https://github.com/djphazer/o_c-phazerville/blob/main/software/src/HSClockManager.h"
click node_audioio "https://github.com/djphazer/o_c-phazerville/blob/main/software/src/AudioIO.cpp"
click node_audioapplets "https://github.com/djphazer/o_c-phazerville/tree/main/software/src/audio_applets"
click node_audiolib "https://github.com/djphazer/o_c-phazerville/tree/main/software/src/Audio"
click node_settings "https://github.com/djphazer/o_c-phazerville/blob/main/software/src/OC_storage.h"
click node_pages "https://github.com/djphazer/o_c-phazerville/blob/main/software/src/util/util_pagestorage.h"
click node_eeprom "https://github.com/djphazer/o_c-phazerville/blob/main/software/src/src/drivers/EEPROMStorage.h"
click node_drivers "https://github.com/djphazer/o_c-phazerville/blob/main/software/src/OC_ADC.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_main,node_core,node_registry,node_hemisphere,node_user toneBlue
class node_applets,node_apps,node_sequins,node_envseq,node_clock toneAmber
class node_audioio,node_audioapplets,node_audiolib toneMint
class node_io,node_display,node_settings,node_pages,node_eeprom,node_drivers toneRose
class node_module toneIndigo
```

## Components

### Firmware runtime

- [Firmware entry](https://github.com/djphazer/o_c-phazerville/blob/main/software/src/Main.cpp): `software/src/Main.cpp`
- [Core runtime](https://github.com/djphazer/o_c-phazerville/blob/main/software/src/OC_core.cpp): `software/src/OC_core.cpp`
- [Applet registry](https://github.com/djphazer/o_c-phazerville/blob/main/software/src/AppletRegistry.h): `software/src/AppletRegistry.h`
- [Hemisphere framework](https://github.com/djphazer/o_c-phazerville/blob/main/software/src/HemisphereApplet.cpp): `software/src/HemisphereApplet.cpp`

### Musical features

- [Hemisphere applets](https://github.com/djphazer/o_c-phazerville/tree/main/software/src/applets): `software/src/applets`
- [O&C applications](https://github.com/djphazer/o_c-phazerville/tree/main/software/src/apps): `software/src/apps`
- [Sequins sequencer](https://github.com/djphazer/o_c-phazerville/blob/main/software/src/apps/Sequins.h): `software/src/apps/Sequins.h`
- [Envelope sequencer](https://github.com/djphazer/o_c-phazerville/blob/main/software/src/applets/EnvSeq.h): `software/src/applets/EnvSeq.h`
- [Clock manager](https://github.com/djphazer/o_c-phazerville/blob/main/software/src/HSClockManager.h): `software/src/HSClockManager.h`

### Audio DSP

- [Audio I/O](https://github.com/djphazer/o_c-phazerville/blob/main/software/src/AudioIO.cpp): `software/src/AudioIO.cpp`
- [Audio applets](https://github.com/djphazer/o_c-phazerville/tree/main/software/src/audio_applets): `software/src/audio_applets`
- [Audio processing](https://github.com/djphazer/o_c-phazerville/tree/main/software/src/Audio): `software/src/Audio`

### Hardware and state

- [I/O processing](https://github.com/djphazer/o_c-phazerville/blob/main/software/src/OC_io.cpp): `software/src/OC_io.cpp`
- [Display and UI](https://github.com/djphazer/o_c-phazerville/blob/main/software/src/OC_ui.cpp): `software/src/OC_ui.cpp`
- [Firmware settings](https://github.com/djphazer/o_c-phazerville/blob/main/software/src/OC_storage.h): `software/src/OC_storage.h`
- [Wear-level storage](https://github.com/djphazer/o_c-phazerville/blob/main/software/src/util/util_pagestorage.h): `software/src/util/util_pagestorage.h`
- [EEPROM storage](https://github.com/djphazer/o_c-phazerville/blob/main/software/src/src/drivers/EEPROMStorage.h): `software/src/src/drivers/EEPROMStorage.h`
- [Hardware drivers](https://github.com/djphazer/o_c-phazerville/blob/main/software/src/OC_ADC.cpp): `software/src/OC_ADC.cpp`

### Other components

- **Module user**
- **O&C module**

## Connections

- Module user → O&C module: operates
- O&C module → Firmware entry: starts firmware
- Firmware entry → Core runtime: starts runtime
- Core runtime → I/O processing: processes I/O
- Core runtime → Display and UI: updates interface
- Core runtime → Applet registry: dispatches applets
- Applet registry → Hemisphere framework: selects framework
- Hemisphere framework → Hemisphere applets: runs applets
- Applet registry → O&C applications: selects applications
- O&C applications → Sequins sequencer: includes sequencer
- Hemisphere applets → Envelope sequencer: includes envelope sequencer
- Core runtime → Clock manager: services timing
- Core runtime → Audio I/O: services audio
- Audio I/O → Audio applets: runs audio applets
- Audio applets → Audio processing: uses DSP
- I/O processing → Hardware drivers: accesses hardware
- Firmware settings → Wear-level storage: stores settings
- Wear-level storage → EEPROM storage: reads and writes
