# jeroenhn/zykl architecture

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

- Interactive diagram: https://gitdiagram.com/jeroenhn/zykl
- Repository: https://github.com/jeroenhn/zykl

## Overview

ReZyklus is an open-hardware recreation of the Zyklus MPS-1 MIDI performance system. The principal workflow is for a builder to use the BOM and hardware designs to source parts and manufacture boards and panels, assemble the enclosure from case parts, and load the supplied EPROM binaries for a functional clone. The repository also includes custom dial designs, supporting manuals, and KiCad libraries. The README documents these build capabilities, but no source excerpts were available to establish more detailed design dependencies or assembly sequencing.

Main entry points: [`KiCAD Project/Gerbers`](https://github.com/jeroenhn/zykl/tree/main/KiCAD%20Project/Gerbers) (Fabrication files), [`ROMS/zyklus-1.3-ROMS/rezyklus-1.3-rom-bins.zip`](https://github.com/jeroenhn/zykl/blob/main/ROMS/zyklus-1.3-ROMS/rezyklus-1.3-rom-bins.zip) (EPROM binaries), [`BOM/Zyklus parts list V1.0.xlsx`](https://github.com/jeroenhn/zykl/blob/main/BOM/Zyklus%20parts%20list%20V1.0.xlsx) (Parts list), [`Manual`](https://github.com/jeroenhn/zykl/tree/main/Manual) (Historical manuals)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_build_docs["Build references"]
  node_bom["Parts list"]
  node_manual["Historical manuals"]
end

subgraph group_electronics["Electronics design"]
  node_schematics["Circuit designs<br/>[ReZyklus.kicad_sch]"]
  node_pcb["Board layouts"]
  node_panel_design["Panel designs"]
  node_gerbers["Fabrication files"]
  node_libraries["KiCad libraries"]
end

subgraph group_mechanical["Mechanical parts"]
  node_case_models["Case models"]
  node_case_stls["Printable case parts"]
  node_cartridge_case["Cartridge case<br/>[v1.0]"]
  node_dial["Aluminium dial<br/>[Knob03.STEP]"]
end

subgraph group_system_image["System image"]
  node_roms["EPROM binaries"]
  node_instrument["ReZyklus clone"]
end

node_builder(("Builder"))

node_builder -->|"consults"| node_bom
node_builder -->|"builds from"| node_schematics
node_builder -->|"manufactures boards"| node_gerbers
node_builder -->|"builds from"| node_panel_design
node_builder -->|"prints parts"| node_case_stls
node_builder -->|"manufactures dial"| node_dial
node_builder -->|"loads binaries"| node_roms
node_builder -.->|"consults"| node_manual
node_builder -.->|"builds enclosure"| node_case_models
node_builder -.->|"builds case"| node_cartridge_case
node_builder -.->|"uses designs"| node_libraries
node_roms -->|"provides firmware"| node_instrument
node_gerbers -.->|"enables assembly"| node_instrument

click node_bom "https://github.com/jeroenhn/zykl/blob/main/BOM/Zyklus%20parts%20list%20V1.0.xlsx"
click node_manual "https://github.com/jeroenhn/zykl/tree/main/Manual"
click node_schematics "https://github.com/jeroenhn/zykl/blob/main/KiCAD%20Project/ReZyklus.kicad_sch"
click node_pcb "https://github.com/jeroenhn/zykl/tree/main/KiCAD%20Project"
click node_panel_design "https://github.com/jeroenhn/zykl/blob/main/KiCAD%20Project/ReZyklus.panel.kicad_sch"
click node_gerbers "https://github.com/jeroenhn/zykl/tree/main/KiCAD%20Project/Gerbers"
click node_libraries "https://github.com/jeroenhn/zykl/tree/main/KiCAD%20Project/Additional%20Libraries"
click node_case_models "https://github.com/jeroenhn/zykl/tree/main/ReZyklus%20Case/ReZyklus%20DIY%20case%20(white%20panels)"
click node_case_stls "https://github.com/jeroenhn/zykl/tree/main/ReZyklus%20Case/ReZyklus%20DIY%20case%20(white%20panels)/STLs"
click node_cartridge_case "https://github.com/jeroenhn/zykl/tree/main/ReZyklus%20Cartridge%20Case/v1.0"
click node_dial "https://github.com/jeroenhn/zykl/blob/main/Alu%20Dial/Knob03.STEP"
click node_roms "https://github.com/jeroenhn/zykl/blob/main/ROMS/zyklus-1.3-ROMS/rezyklus-1.3-rom-bins.zip"

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_bom,node_manual toneBlue
class node_schematics,node_pcb,node_panel_design,node_gerbers,node_libraries toneAmber
class node_case_models,node_case_stls,node_cartridge_case,node_dial toneMint
class node_roms,node_instrument toneRose
class node_builder toneIndigo
```

## Components

### Build references

- [Parts list](https://github.com/jeroenhn/zykl/blob/main/BOM/Zyklus%20parts%20list%20V1.0.xlsx): `BOM/Zyklus parts list V1.0.xlsx`
- [Historical manuals](https://github.com/jeroenhn/zykl/tree/main/Manual): `Manual`

### Electronics design

- [Circuit designs](https://github.com/jeroenhn/zykl/blob/main/KiCAD%20Project/ReZyklus.kicad_sch): `KiCAD Project/ReZyklus.kicad_sch`
- [Board layouts](https://github.com/jeroenhn/zykl/tree/main/KiCAD%20Project): `KiCAD Project`
- [Panel designs](https://github.com/jeroenhn/zykl/blob/main/KiCAD%20Project/ReZyklus.panel.kicad_sch): `KiCAD Project/ReZyklus.panel.kicad_sch`
- [Fabrication files](https://github.com/jeroenhn/zykl/tree/main/KiCAD%20Project/Gerbers): `KiCAD Project/Gerbers`
- [KiCad libraries](https://github.com/jeroenhn/zykl/tree/main/KiCAD%20Project/Additional%20Libraries): `KiCAD Project/Additional Libraries`

### Mechanical parts

- [Case models](https://github.com/jeroenhn/zykl/tree/main/ReZyklus%20Case/ReZyklus%20DIY%20case%20(white%20panels)): `ReZyklus Case/ReZyklus DIY case (white panels)`
- [Printable case parts](https://github.com/jeroenhn/zykl/tree/main/ReZyklus%20Case/ReZyklus%20DIY%20case%20(white%20panels)/STLs): `ReZyklus Case/ReZyklus DIY case (white panels)/STLs`
- [Cartridge case](https://github.com/jeroenhn/zykl/tree/main/ReZyklus%20Cartridge%20Case/v1.0): `ReZyklus Cartridge Case/v1.0`
- [Aluminium dial](https://github.com/jeroenhn/zykl/blob/main/Alu%20Dial/Knob03.STEP): `Alu Dial/Knob03.STEP`

### System image

- [EPROM binaries](https://github.com/jeroenhn/zykl/blob/main/ROMS/zyklus-1.3-ROMS/rezyklus-1.3-rom-bins.zip): `ROMS/zyklus-1.3-ROMS/rezyklus-1.3-rom-bins.zip`
- **ReZyklus clone**

### Other components

- **Builder**

## Connections

- Builder → Parts list: consults (evidence: `README.md`)
- Builder → Circuit designs: builds from (evidence: `README.md`)
- Builder → Fabrication files: manufactures boards (evidence: `README.md`)
- Builder → Panel designs: builds from (evidence: `README.md`)
- Builder → Printable case parts: prints parts (evidence: `README.md`)
- Builder → Aluminium dial: manufactures dial (evidence: `README.md`)
- Builder → EPROM binaries: loads binaries (evidence: `README.md`)
- Builder → Historical manuals: consults
- Builder → Case models: builds enclosure
- Builder → Cartridge case: builds case
- Builder → KiCad libraries: uses designs
- EPROM binaries → ReZyklus clone: provides firmware (evidence: `README.md`)
- Fabrication files → ReZyklus clone: enables assembly
