# ciylab/big_io architecture

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

- Interactive diagram: https://gitdiagram.com/ciylab/big_io
- Repository: https://github.com/ciylab/big_io

## Overview

BIG_IO is embedded firmware for a multi-function MIDI/CV/GATE instrument. The user configures and selects modules, then the firmware runs them against clock ticks and MIDI events to produce MIDI, CV, and gate output. Its documented module types span Euclidean drums, looping/recording, short sequences, random pitches, and simple sequencing; preset load/save and clock control are additional capabilities. The graph preserves these distinct stages. Several dispatch and hardware details are inferred from module names or imports rather than shown in excerpts, so those links are marked unverified.

Main entry points: [`src/Modules.cpp`](https://github.com/ciylab/big_io/blob/main/src/Modules.cpp) (Module registry), [`src/Module.cpp`](https://github.com/ciylab/big_io/blob/main/src/Module.cpp) (Module base), [`src/Main.h`](https://github.com/ciylab/big_io/blob/main/src/Main.h) (Main page), [`src/modules/Drum.cpp`](https://github.com/ciylab/big_io/blob/main/src/modules/Drum.cpp) (Euclidean drums)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["User interface"]
  node_main_page["Main page<br/>[Main.h]"]
  node_config_page["Config page<br/>[Conf.h]"]
  node_play_page["Play page<br/>[Play.h]"]
  node_display["Display<br/>[Display.cpp]"]
  node_encoder["Encoder input<br/>[encoder.cpp]"]
end

subgraph group_runtime["Runtime and modules"]
  node_firmware["Firmware loop<br/>[BIG_IO.ino]"]
  node_registry["Module registry<br/>[Modules.cpp]"]
  node_base["Module base<br/>[Module.cpp]"]
  node_drum["Euclidean drums<br/>[Drum.cpp]"]
  node_looper["Looper recorder<br/>[Looper.cpp]"]
  node_miniseq["Mini sequencer<br/>[Miniseq.cpp]"]
  node_random["Random generator<br/>[Random.cpp]"]
  node_simple["Simple sequencer<br/>[Simple.cpp]"]
end

subgraph group_clock_midi["Clock and MIDI"]
  node_time["Clock and time<br/>[Time.cpp]"]
  node_midi["MIDI handlers<br/>[midi.cpp]"]
end

subgraph group_storage["Preset storage"]
  node_eeprom[("Preset storage<br/>[eeprom.cpp]")]
end

subgraph group_outputs["Signal outputs"]
  node_dac["CV DAC<br/>[dac.cpp]"]
  node_gate["Gate output<br/>[gate.cpp]"]
end

node_user(("Instrument user"))

node_user -.->|"operates"| node_main_page
node_main_page -->|"loads and saves"| node_eeprom
node_registry -.->|"instantiates"| node_drum
node_registry -.->|"instantiates"| node_looper
node_registry -.->|"instantiates"| node_miniseq
node_registry -.->|"instantiates"| node_random
node_registry -.->|"instantiates"| node_simple
node_drum -->|"uses playback methods"| node_base
node_looper -->|"uses playback methods"| node_base
node_miniseq -.->|"uses playback methods"| node_base
node_random -->|"uses playback methods"| node_base
node_simple -.->|"uses playback methods"| node_base
node_drum -.->|"reads ticks"| node_time
node_looper -->|"reads ticks"| node_time
node_random -->|"reads ticks"| node_time
node_main_page -.->|"shows status"| node_display
node_encoder -.->|"changes selection"| node_registry
node_firmware -.->|"runs modules"| node_registry
node_midi -.->|"dispatches events"| node_registry
node_base -.->|"writes CV"| node_dac
node_base -.->|"controls gates"| node_gate

click node_firmware "https://github.com/ciylab/big_io/blob/main/BIG_IO.ino"
click node_registry "https://github.com/ciylab/big_io/blob/main/src/Modules.cpp"
click node_base "https://github.com/ciylab/big_io/blob/main/src/Module.cpp"
click node_main_page "https://github.com/ciylab/big_io/blob/main/src/Main.h"
click node_config_page "https://github.com/ciylab/big_io/blob/main/src/Conf.h"
click node_play_page "https://github.com/ciylab/big_io/blob/main/src/Play.h"
click node_display "https://github.com/ciylab/big_io/blob/main/src/Display.cpp"
click node_encoder "https://github.com/ciylab/big_io/blob/main/src/encoder.cpp"
click node_time "https://github.com/ciylab/big_io/blob/main/src/Time.cpp"
click node_midi "https://github.com/ciylab/big_io/blob/main/src/midi.cpp"
click node_drum "https://github.com/ciylab/big_io/blob/main/src/modules/Drum.cpp"
click node_looper "https://github.com/ciylab/big_io/blob/main/src/modules/Looper.cpp"
click node_miniseq "https://github.com/ciylab/big_io/blob/main/src/modules/Miniseq.cpp"
click node_random "https://github.com/ciylab/big_io/blob/main/src/modules/Random.cpp"
click node_simple "https://github.com/ciylab/big_io/blob/main/src/modules/Simple.cpp"
click node_eeprom "https://github.com/ciylab/big_io/blob/main/src/eeprom.cpp"
click node_dac "https://github.com/ciylab/big_io/blob/main/src/dac.cpp"
click node_gate "https://github.com/ciylab/big_io/blob/main/src/gate.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_page,node_config_page,node_play_page,node_display,node_encoder,node_user toneBlue
class node_firmware,node_registry,node_base,node_drum,node_looper,node_miniseq,node_random,node_simple toneAmber
class node_time,node_midi toneMint
class node_eeprom toneRose
class node_dac,node_gate toneIndigo
```

## Components

### User interface

- [Main page](https://github.com/ciylab/big_io/blob/main/src/Main.h): `src/Main.h`
- [Config page](https://github.com/ciylab/big_io/blob/main/src/Conf.h): `src/Conf.h`
- [Play page](https://github.com/ciylab/big_io/blob/main/src/Play.h): `src/Play.h`
- [Display](https://github.com/ciylab/big_io/blob/main/src/Display.cpp): `src/Display.cpp`
- [Encoder input](https://github.com/ciylab/big_io/blob/main/src/encoder.cpp): `src/encoder.cpp`

### Runtime and modules

- [Firmware loop](https://github.com/ciylab/big_io/blob/main/BIG_IO.ino): `BIG_IO.ino`
- [Module registry](https://github.com/ciylab/big_io/blob/main/src/Modules.cpp): `src/Modules.cpp`
- [Module base](https://github.com/ciylab/big_io/blob/main/src/Module.cpp): `src/Module.cpp`
- [Euclidean drums](https://github.com/ciylab/big_io/blob/main/src/modules/Drum.cpp): `src/modules/Drum.cpp`
- [Looper recorder](https://github.com/ciylab/big_io/blob/main/src/modules/Looper.cpp): `src/modules/Looper.cpp`
- [Mini sequencer](https://github.com/ciylab/big_io/blob/main/src/modules/Miniseq.cpp): `src/modules/Miniseq.cpp`
- [Random generator](https://github.com/ciylab/big_io/blob/main/src/modules/Random.cpp): `src/modules/Random.cpp`
- [Simple sequencer](https://github.com/ciylab/big_io/blob/main/src/modules/Simple.cpp): `src/modules/Simple.cpp`

### Clock and MIDI

- [Clock and time](https://github.com/ciylab/big_io/blob/main/src/Time.cpp): `src/Time.cpp`
- [MIDI handlers](https://github.com/ciylab/big_io/blob/main/src/midi.cpp): `src/midi.cpp`

### Preset storage

- [Preset storage](https://github.com/ciylab/big_io/blob/main/src/eeprom.cpp): `src/eeprom.cpp`

### Signal outputs

- [CV DAC](https://github.com/ciylab/big_io/blob/main/src/dac.cpp): `src/dac.cpp`
- [Gate output](https://github.com/ciylab/big_io/blob/main/src/gate.cpp): `src/gate.cpp`

### Other components

- **Instrument user**

## Connections

- Instrument user → Main page: operates
- Main page → Preset storage: loads and saves (evidence: `src/Main.h`)
- Module registry → Euclidean drums: instantiates
- Module registry → Looper recorder: instantiates
- Module registry → Mini sequencer: instantiates
- Module registry → Random generator: instantiates
- Module registry → Simple sequencer: instantiates
- Euclidean drums → Module base: uses playback methods (evidence: `src/modules/Drum.cpp`)
- Looper recorder → Module base: uses playback methods (evidence: `src/modules/Looper.cpp`)
- Mini sequencer → Module base: uses playback methods
- Random generator → Module base: uses playback methods (evidence: `src/modules/Random.cpp`)
- Simple sequencer → Module base: uses playback methods
- Euclidean drums → Clock and time: reads ticks
- Looper recorder → Clock and time: reads ticks (evidence: `src/modules/Looper.cpp`)
- Random generator → Clock and time: reads ticks (evidence: `src/modules/Random.cpp`)
- Main page → Display: shows status
- Encoder input → Module registry: changes selection
- Firmware loop → Module registry: runs modules
- MIDI handlers → Module registry: dispatches events
- Module base → CV DAC: writes CV
- Module base → Gate output: controls gates
