# tpcarlson/synth-diy architecture

> Architecture diagram of the GitHub repository tpcarlson/synth-diy, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2024-12-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tpcarlson/synth-diy
- Repository: https://github.com/tpcarlson/synth-diy

## Overview

##### Main Components Organization

a. Module Categories
- Signal Generators (VCDO, Pentanoise)
- Signal Processors (VCA, VCADSR, LPG, YARM+)
- Control Modules (Logic, Sycamore, Dice)
- Utility Modules (Mix, Multimult, Through)
- Interface Modules (DrumFiend - MIDI conversion)

##### Module Internal Architecture

For each module type, show:
- Input/Output connections
- Core processing components
- Control voltage (CV) paths
- Digital control sections (where applicable)
- Power distribution

**┌─ Signal Path ─────────────────────┐**

- [Generators] → [Processors] →    │
- ↑          ↑              │
- [Controllers] → [Utilities]      │

- ┘

**┌─ DrumFiend ──────────────────┐**
- ┌─────────┐    ┌──────────┐  │
- Trigger  │    │  MIDI    │  │
- Inputs   │ → │Controller │  │
- (19ch)   │    │          │  │
- ┘    └──────────┘  │
- ┘

##### Implementation Details

For each module, show:
- HP width (as noted in README)
- Primary function
- Key components (e.g., ElectricDruid chips)
- Interface points

## Diagram (Mermaid)

```mermaid
graph TB
    %% Style Definitions
    classDef generator fill:#3498db,stroke:#2980b9,color:white
    classDef processor fill:#2ecc71,stroke:#27ae60,color:white
    classDef controller fill:#f1c40f,stroke:#f39c12,color:black
    classDef utility fill:#95a5a6,stroke:#7f8c8d,color:white
    classDef interface fill:#e74c3c,stroke:#c0392b,color:white

    %% Main Sections
    subgraph Generators
        VCDO["VCDO<br/>(Oscillator)"]
        Pentanoise["Pentanoise<br/>(Noise Gen)"]
    end

    subgraph Processors
        VCA["VCA<br/>(Amplifier)"]
        VCADSR["VCADSR<br/>(Envelope)"]
        LPG["LPG<br/>(Low Pass Gate)"]
        YARM["YARM+<br/>(Ring Mod)"]
    end

    subgraph Controllers
        Logic["Logic<br/>(Gate Processor)"]
        Sycamore["Sycamore<br/>(Sequencer)"]
        Dice["Dice<br/>(Random CV)"]
    end

    subgraph Utilities
        Mix["Mix<br/>(Mixer)"]
        Multimult["Multimult<br/>(Signal Split)"]
        Through["Through<br/>(Buffered Mult)"]
    end

    subgraph Interface
        DrumFiend["DrumFiend<br/>(MIDI Triggers)"]
        DrumFiendFW["DrumFiend<br/>Firmware"]
    end

    %% Connections
    Generators --> Processors
    Controllers --> Generators
    Controllers --> Processors
    Utilities --> Generators
    Utilities --> Processors
    DrumFiend --> DrumFiendFW
    Interface --> Controllers

    %% Styling
    VCDO:::generator
    Pentanoise:::generator
    VCA:::processor
    VCADSR:::processor
    LPG:::processor
    YARM:::processor
    Logic:::controller
    Sycamore:::controller
    Dice:::controller
    Mix:::utility
    Multimult:::utility
    Through:::utility
    DrumFiend:::interface
    DrumFiendFW:::interface

    %% Click Events
    click VCDO "https://github.com/tpcarlson/synth-diy/blob/main//VCDO/vcvco.sch"
    click Pentanoise "https://github.com/tpcarlson/synth-diy/blob/main//pentanoise/pentanoise.sch"
    click VCA "https://github.com/tpcarlson/synth-diy/blob/main//VCA/vca-board.sch"
    click VCADSR "https://github.com/tpcarlson/synth-diy/blob/main//vcadsr/vcadsr.sch"
    click LPG "https://github.com/tpcarlson/synth-diy/blob/main//lpg/lpg.sch"
    click YARM "https://github.com/tpcarlson/synth-diy/blob/main//yarmplus/yarmplus.sch"
    click Logic "https://github.com/tpcarlson/synth-diy/blob/main//logic/logic.sch"
    click Sycamore "https://github.com/tpcarlson/synth-diy/blob/main//sycamore/sycamore.kicad_sch"
    click Dice "https://github.com/tpcarlson/synth-diy/blob/main//d6/d6.kicad_sch"
    click Mix "https://github.com/tpcarlson/synth-diy/blob/main//mix/mix.sch"
    click Multimult "https://github.com/tpcarlson/synth-diy/blob/main//multimult/multimult.sch"
    click Through "https://github.com/tpcarlson/synth-diy/blob/main//through/through.sch"
    click DrumFiend "https://github.com/tpcarlson/synth-diy/blob/main//drumfiend/impact-pal.sch"
    click DrumFiendFW "https://github.com/tpcarlson/synth-diy/blob/main//drumfiend/firmware/drumfiend/code.py"
```
