# gitfad12/polyuanalog architecture

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

- Interactive diagram: https://gitdiagram.com/gitfad12/polyuanalog
- Repository: https://github.com/gitfad12/polyuanalog

## Overview

polyUAnalog is an open-source polyphonic analog synthesizer organized around a conductor board coordinating independent monophonic voice boards, with a separate hands-on controller. The user-facing path is controller input, conductor coordination, per-voice synthesis, and analog audio output. The voice firmware’s sampled synthesis layer combines oscillators, envelopes, and modulation with AS3397 hardware control. Hardware designs cover the voice, conductor, controller, bus, power, and FX boards. Firmware excerpts show controller drivers and voice-layer calls; conductor routing and several hardware interactions are documented at project level rather than shown in sampled source.

Main entry points: [`firmware/controller/main.py`](https://github.com/gitfad12/polyuanalog/blob/main/firmware/controller/main.py) (Controller Firmware), [`firmware/voice/Synth.h`](https://github.com/gitfad12/polyuanalog/blob/main/firmware/voice/Synth.h) (Synthesis Core), [`hardware/conductor`](https://github.com/gitfad12/polyuanalog/tree/main/hardware/conductor) (Conductor Board), [`firmware/conductor/Conductor.ino`](https://github.com/gitfad12/polyuanalog/blob/main/firmware/conductor/Conductor.ino) (Conductor Firmware)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_control["Control Surface"]
  node_controller_fw["Controller Firmware<br/>[main.py]"]
  node_parameters["Control Parameters<br/>[param.py]"]
  node_expander["MCP23017 Driver<br/>[mcp23017.py]"]
  node_display["OLED Driver<br/>[ssd1306.py]"]
  node_pixels["LED Driver<br/>[neopixel.py]"]
end

subgraph group_orchestration["Voice Orchestration"]
  node_conductor_fw["Conductor Firmware<br/>[Conductor.ino]"]
  node_presets["Voice Presets<br/>[preset.h]"]
end

subgraph group_synthesis["Voice Synthesis"]
  node_voice_fw["Voice Firmware<br/>[voice.ino]"]
  node_synth_core["Synthesis Core<br/>[Synth.h]"]
  node_as3397["AS3397 Control<br/>[as3397.cpp]"]
  node_dso["Digital Oscillator<br/>[DSO.cpp]"]
  node_envelope["ADSR Envelope<br/>[ADSR.cpp]"]
  node_lfo["LFO Modulation<br/>[LFO.cpp]"]
end

subgraph group_hardware["Hardware Designs"]
  node_voice_board["Voice Board"]
  node_conductor_board["Conductor Board"]
  node_controller_board["Controller Board"]
  node_bus_board["Bus Board"]
  node_power_board["Power Board"]
  node_fx_board["FX Board"]
end

node_player(("Synth Player"))
node_audio(("Analog Audio"))

node_player -->|"operates"| node_controller_fw
node_controller_fw -->|"uses"| node_parameters
node_controller_fw -->|"reads inputs"| node_expander
node_controller_fw -->|"uses display"| node_display
node_controller_fw -->|"uses LEDs"| node_pixels
node_controller_fw -.->|"controls"| node_conductor_fw
node_conductor_fw -->|"orchestrates"| node_voice_fw
node_conductor_fw -.->|"configures"| node_presets
node_voice_fw -.->|"runs"| node_synth_core
node_synth_core -->|"sets CV"| node_as3397
node_synth_core -->|"updates"| node_dso
node_synth_core -->|"updates"| node_envelope
node_synth_core -->|"updates"| node_lfo
node_voice_fw -.->|"produces"| node_audio
node_conductor_board -->|"coordinates"| node_voice_board
node_controller_board -.->|"interfaces with"| node_conductor_board
node_conductor_board -.->|"connects via"| node_bus_board
node_conductor_board -.->|"supports connection"| node_fx_board

click node_controller_fw "https://github.com/gitfad12/polyuanalog/blob/main/firmware/controller/main.py"
click node_parameters "https://github.com/gitfad12/polyuanalog/blob/main/firmware/controller/param.py"
click node_expander "https://github.com/gitfad12/polyuanalog/blob/main/firmware/controller/mcp23017.py"
click node_display "https://github.com/gitfad12/polyuanalog/blob/main/firmware/controller/ssd1306.py"
click node_pixels "https://github.com/gitfad12/polyuanalog/blob/main/firmware/controller/neopixel.py"
click node_conductor_fw "https://github.com/gitfad12/polyuanalog/blob/main/firmware/conductor/Conductor.ino"
click node_presets "https://github.com/gitfad12/polyuanalog/blob/main/firmware/conductor/preset.h"
click node_voice_fw "https://github.com/gitfad12/polyuanalog/blob/main/firmware/voice/voice.ino"
click node_synth_core "https://github.com/gitfad12/polyuanalog/blob/main/firmware/voice/Synth.h"
click node_as3397 "https://github.com/gitfad12/polyuanalog/blob/main/firmware/voice/as3397.cpp"
click node_dso "https://github.com/gitfad12/polyuanalog/blob/main/firmware/voice/DSO.cpp"
click node_envelope "https://github.com/gitfad12/polyuanalog/blob/main/firmware/voice/ADSR.cpp"
click node_lfo "https://github.com/gitfad12/polyuanalog/blob/main/firmware/voice/LFO.cpp"
click node_voice_board "https://github.com/gitfad12/polyuanalog/tree/main/hardware/voice"
click node_conductor_board "https://github.com/gitfad12/polyuanalog/tree/main/hardware/conductor"
click node_controller_board "https://github.com/gitfad12/polyuanalog/tree/main/hardware/controller"
click node_bus_board "https://github.com/gitfad12/polyuanalog/tree/main/hardware/Bus"
click node_power_board "https://github.com/gitfad12/polyuanalog/tree/main/hardware/power"
click node_fx_board "https://github.com/gitfad12/polyuanalog/tree/main/hardware/FX"

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_controller_fw,node_parameters,node_expander,node_display,node_pixels toneBlue
class node_conductor_fw,node_presets toneAmber
class node_voice_fw,node_synth_core,node_as3397,node_dso,node_envelope,node_lfo toneMint
class node_voice_board,node_conductor_board,node_controller_board,node_bus_board,node_power_board,node_fx_board toneRose
class node_player,node_audio toneIndigo
```

## Components

### Control Surface

- [Controller Firmware](https://github.com/gitfad12/polyuanalog/blob/main/firmware/controller/main.py): `firmware/controller/main.py`
- [Control Parameters](https://github.com/gitfad12/polyuanalog/blob/main/firmware/controller/param.py): `firmware/controller/param.py`
- [MCP23017 Driver](https://github.com/gitfad12/polyuanalog/blob/main/firmware/controller/mcp23017.py): `firmware/controller/mcp23017.py`
- [OLED Driver](https://github.com/gitfad12/polyuanalog/blob/main/firmware/controller/ssd1306.py): `firmware/controller/ssd1306.py`
- [LED Driver](https://github.com/gitfad12/polyuanalog/blob/main/firmware/controller/neopixel.py): `firmware/controller/neopixel.py`

### Voice Orchestration

- [Conductor Firmware](https://github.com/gitfad12/polyuanalog/blob/main/firmware/conductor/Conductor.ino): `firmware/conductor/Conductor.ino`
- [Voice Presets](https://github.com/gitfad12/polyuanalog/blob/main/firmware/conductor/preset.h): `firmware/conductor/preset.h`

### Voice Synthesis

- [Voice Firmware](https://github.com/gitfad12/polyuanalog/blob/main/firmware/voice/voice.ino): `firmware/voice/voice.ino`
- [Synthesis Core](https://github.com/gitfad12/polyuanalog/blob/main/firmware/voice/Synth.h): `firmware/voice/Synth.h`
- [AS3397 Control](https://github.com/gitfad12/polyuanalog/blob/main/firmware/voice/as3397.cpp): `firmware/voice/as3397.cpp`
- [Digital Oscillator](https://github.com/gitfad12/polyuanalog/blob/main/firmware/voice/DSO.cpp): `firmware/voice/DSO.cpp`
- [ADSR Envelope](https://github.com/gitfad12/polyuanalog/blob/main/firmware/voice/ADSR.cpp): `firmware/voice/ADSR.cpp`
- [LFO Modulation](https://github.com/gitfad12/polyuanalog/blob/main/firmware/voice/LFO.cpp): `firmware/voice/LFO.cpp`

### Hardware Designs

- [Voice Board](https://github.com/gitfad12/polyuanalog/tree/main/hardware/voice): `hardware/voice`
- [Conductor Board](https://github.com/gitfad12/polyuanalog/tree/main/hardware/conductor): `hardware/conductor`
- [Controller Board](https://github.com/gitfad12/polyuanalog/tree/main/hardware/controller): `hardware/controller`
- [Bus Board](https://github.com/gitfad12/polyuanalog/tree/main/hardware/Bus): `hardware/Bus`
- [Power Board](https://github.com/gitfad12/polyuanalog/tree/main/hardware/power): `hardware/power`
- [FX Board](https://github.com/gitfad12/polyuanalog/tree/main/hardware/FX): `hardware/FX`

### Other components

- **Synth Player**
- **Analog Audio**

## Connections

- Synth Player → Controller Firmware: operates (evidence: `README.md`)
- Controller Firmware → Control Parameters: uses (evidence: `firmware/controller/main.py`)
- Controller Firmware → MCP23017 Driver: reads inputs (evidence: `firmware/controller/main.py`)
- Controller Firmware → OLED Driver: uses display (evidence: `firmware/controller/main.py`)
- Controller Firmware → LED Driver: uses LEDs (evidence: `firmware/controller/main.py`)
- Controller Firmware → Conductor Firmware: controls (evidence: `README.md`)
- Conductor Firmware → Voice Firmware: orchestrates (evidence: `README.md`)
- Conductor Firmware → Voice Presets: configures
- Voice Firmware → Synthesis Core: runs
- Synthesis Core → AS3397 Control: sets CV (evidence: `firmware/voice/Synth.h`)
- Synthesis Core → Digital Oscillator: updates (evidence: `firmware/voice/Synth.h`)
- Synthesis Core → ADSR Envelope: updates (evidence: `firmware/voice/Synth.h`)
- Synthesis Core → LFO Modulation: updates (evidence: `firmware/voice/Synth.h`)
- Voice Firmware → Analog Audio: produces
- Conductor Board → Voice Board: coordinates (evidence: `README.md`)
- Controller Board → Conductor Board: interfaces with (evidence: `README.md`)
- Conductor Board → Bus Board: connects via (evidence: `README.md`)
- Conductor Board → FX Board: supports connection (evidence: `README.md`)
