# torvalds/1590a architecture

> Architecture diagram of the GitHub repository torvalds/1590a, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/torvalds/1590a
- Repository: https://github.com/torvalds/1590a

## Overview

##### Project type and purpose
- This is a hardware‐design project consisting of multiple KiCad PCB subprojects. Its goal is to create modular guitar pedal electronics (Base board + interchangeable Effects boards) all fitting into 1590A enclosures.

##### File structure
- Top‐level files:
- README.md – project overview and electrical/mechanical notes
- Gen2-notes.md – mechanical fitting details for 1590A enclosure
- LICENSE, .gitignore
- Directories for PCB modules:
- Base/VGND – base board (power rails, buffering, bypass switch)
- Power/USB-C – power‐only board variant
- Effect/Boost, Effect/Rectifier, Effect/Tremolo – three standalone effect boards
- Debug/Connector – connector breakout for debugging
- Libraries:
- symbols/ – schematic symbol libraries for parts used across all boards
- Mylib.pretty/ – footprint library of custom or supplier footprints
- Drill‐pattern mechanical folder:
- Tayda/Enclosure-drill-holes – drilling templates for Tayda parts

##### README for additional insights
- Architecture is “base board + plug‐in effects.”
- Power domain: single 9 V input split into +4.5 V reference and ± rails via LM2426.
- Signal domain: input → buffering → effect stage → buffering → output.
- Modular approach: any effect board can plug into the base board.
- Mechanical: boards slide into 1590A enclosure side slots, connectors line up.

##### Detail without overthinking
- Every PCB module as a distinct component.
- Library artifacts (symbol + footprint repos) as supporting blocks.
- Mechanical drill‐pattern folder as part of the build process.
- Don’t combine the three effects into one block—keep them separate to reflect modularity.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% External Interfaces
    subgraph "External Interfaces"
        DC9["9 V DC In"]:::external
        GuitarIn["Guitar In"]:::external
        AmpOut["Amp Out"]:::external
        Stomp["Stomp Switch"]:::external
    end

    %% PCB Modules
    subgraph "PCB Modules"
        Base["Base Board Module"]:::board
        PowerUSB["Power-Only USB-C Board"]:::board
        Boost["Boost Effect Module"]:::effect
        Rectifier["Rectifier Effect Module"]:::effect
        Tremolo["Tremolo Effect Module"]:::effect
        Debug["Debug Connector Breakout"]:::board
    end

    %% Libraries
    subgraph "Libraries"
        SymLib["Schematic Symbol Libraries"]:::lib
        FootLib["PCB Footprint Library"]:::lib
    end

    %% Mechanical & Documentation
    Mechanical["Enclosure Drill Patterns"]:::mech
    Docs["Project Docs (README, Gen2-notes)"]:::doc

    %% Power Flows
    DC9 -->|"9 V (red)"| Base
    Base -->|"+9 V, GND, +4.5 V (red/black/blue)"| Boost
    Base -->|"+9 V, GND, +4.5 V (red/black/blue)"| Rectifier
    Base -->|"+9 V, GND, +4.5 V (red/black/blue)"| Tremolo
    DC9 -->|"9 V (red)"| PowerUSB

    %% Signal Flows
    GuitarIn -->|"Signal In (green)"| Base
    Base -->|"Effect Signal Out (green)"| Boost
    Boost -->|"Processed Signal (green)"| Base
    Base -->|"Buffered Out (green)"| AmpOut

    GuitarIn -.->|"Signal In (green)"| Rectifier
    Rectifier -.->|"Processed Signal (green)"| Base

    GuitarIn -.->|"Signal In (green)"| Tremolo
    Tremolo -.->|"Processed Signal (green)"| Base

    %% Debug Connector
    Base -->|"Debug interface"| Debug

    %% Mechanical Alignment
    Mechanical --> Base
    Mechanical --> Boost
    Mechanical --> Rectifier
    Mechanical --> Tremolo
    Mechanical --> PowerUSB
    Mechanical --> Debug

    %% Libraries usage
    SymLib --> Base
    SymLib --> PowerUSB
    SymLib --> Boost
    SymLib --> Rectifier
    SymLib --> Tremolo
    SymLib --> Debug

    FootLib --> Base
    FootLib --> PowerUSB
    FootLib --> Boost
    FootLib --> Rectifier
    FootLib --> Tremolo
    FootLib --> Debug

    %% Documentation
    Docs --> SymLib
    Docs --> FootLib
    Docs --> Base
    Docs --> PowerUSB
    Docs --> Boost
    Docs --> Rectifier
    Docs --> Tremolo
    Docs --> Debug

    %% Click Events
    click Base "https://github.com/torvalds/1590a/tree/main/Base/VGND/"
    click PowerUSB "https://github.com/torvalds/1590a/blob/main/Power/USB-C.kicad_sch"
    click Boost "https://github.com/torvalds/1590a/tree/main/Effect/Boost/"
    click Rectifier "https://github.com/torvalds/1590a/tree/main/Effect/Rectifier/"
    click Tremolo "https://github.com/torvalds/1590a/tree/main/Effect/Tremolo/"
    click Debug "https://github.com/torvalds/1590a/tree/main/Debug/Connector/"
    click SymLib "https://github.com/torvalds/1590a/tree/main/symbols/"
    click FootLib "https://github.com/torvalds/1590a/tree/main/Mylib.pretty/"
    click Mechanical "https://github.com/torvalds/1590a/tree/main/Tayda/Enclosure-drill-holes/"
    click Docs "https://github.com/torvalds/1590a/blob/main/README.md"

    %% Styles
    classDef external fill:#f2f2f2,stroke:#999,stroke-width:1px
    classDef board fill:#d0e1f9,stroke:#1f78b4,stroke-width:2px
    classDef effect fill:#d9f2d9,stroke:#33a02c,stroke-width:2px
    classDef lib fill:#fff2cc,stroke:#e6b800,stroke-width:2px
    classDef mech fill:#e6e6e6,stroke:#666,stroke-width:1px,stroke-dasharray: 2 2
    classDef doc fill:#f9d5e5,stroke:#c71585,stroke-width:1px
```
