# arduino-guay/esp32-ag_sinte architecture

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

- Interactive diagram: https://gitdiagram.com/arduino-guay/esp32-ag_sinte
- Repository: https://github.com/arduino-guay/esp32-ag_sinte

## Overview

This is an ESP32-based autonomous monophonic synthesizer. The user workflow is MIDI notes and physical controls → parameter and arpeggiator handling → voice, oscillator, envelope, and filter processing → I²S audio output. Separate branches cover the LCD menu, ADC controls, waveform tables, and configurable delay. Several runtime files are unsampled, so their connections are shown as unverified rather than asserted; documented capabilities are retained.

Main entry points: [`AG_Menu.cpp`](https://github.com/arduino-guay/esp32-ag_sinte/blob/main/AG_Menu.cpp) (LCD menu), [`AG_Midi.h`](https://github.com/arduino-guay/esp32-ag_sinte/blob/main/AG_Midi.h) (MIDI routing), [`AG_Voz.cpp`](https://github.com/arduino-guay/esp32-ag_sinte/blob/main/AG_Voz.cpp) (Synth voices), [`AG_Param.cpp`](https://github.com/arduino-guay/esp32-ag_sinte/blob/main/AG_Param.cpp) (Sound parameters)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_controls["Controls and Input"]
  node_entry["Synth runtime<br/>[AG_Sinte.ino]"]
  node_adc["ADC controls<br/>[AG_ADC.cpp]"]
  node_menu["LCD menu<br/>[AG_Menu.cpp]"]
  node_params["Sound parameters<br/>[AG_Param.cpp]"]
end

subgraph group_sequencing["Note Handling"]
  node_midi["MIDI routing<br/>[AG_Midi.h]"]
  node_arp["Arpeggiator<br/>[AG_Arpegiador.cpp]"]
end

subgraph group_sound["Sound Generation"]
  node_synth["Synth engine"]
  node_voice["Synth voices<br/>[AG_Voz.cpp]"]
  node_osc["Oscillators<br/>[AG_Oscilador.cpp]"]
  node_tables["Waveform tables<br/>[AG_Wavetable.cpp]"]
  node_akwf["AKWF samples<br/>[AG_AKWF.hpp]"]
  node_util["Signal utilities<br/>[AG_Util.cpp]"]
  node_envelope["ADSR envelopes<br/>[ADSR.cpp]"]
  node_filter["Filters<br/>[AG_Filtro.cpp]"]
end

subgraph group_audio["Audio Output"]
  node_delay["Configurable delay<br/>[simple_delay.ino]"]
  node_i2s["I²S output<br/>[i2s_interface.ino]"]
end

node_player(("Player"))
node_controls_hw(("Encoder and pots"))
node_midi_in(("MIDI input"))
node_dac["I²S DAC"]

node_player -->|"sends notes"| node_midi_in
node_midi_in -.->|"delivers MIDI"| node_midi
node_controls_hw -.->|"provides controls"| node_adc
node_controls_hw -->|"operates menu"| node_menu
node_entry -.->|"services controls"| node_menu
node_menu -->|"sets parameters"| node_params
node_menu -->|"sets arpeggio"| node_arp
node_menu -->|"sets mode"| node_midi
node_midi -->|"dispatches notes"| node_synth
node_midi -->|"dispatches notes"| node_arp
node_midi -->|"updates controls"| node_params
node_arp -.->|"triggers notes"| node_synth
node_synth -.->|"processes voices"| node_voice
node_voice -.->|"generates tones"| node_osc
node_voice -.->|"filters voices"| node_filter
node_voice -.->|"shapes volume"| node_envelope
node_params -.->|"selects waveforms"| node_osc
node_params -.->|"configures filters"| node_filter
node_osc -.->|"reads waveform"| node_tables
node_tables -->|"uses signal functions"| node_util
node_util -->|"reads samples"| node_akwf
node_synth -.->|"processes audio"| node_delay
node_delay -.->|"outputs audio"| node_i2s
node_i2s -->|"sends audio"| node_dac

click node_entry "https://github.com/arduino-guay/esp32-ag_sinte/blob/main/AG_Sinte.ino"
click node_adc "https://github.com/arduino-guay/esp32-ag_sinte/blob/main/AG_ADC.cpp"
click node_menu "https://github.com/arduino-guay/esp32-ag_sinte/blob/main/AG_Menu.cpp"
click node_params "https://github.com/arduino-guay/esp32-ag_sinte/blob/main/AG_Param.cpp"
click node_midi "https://github.com/arduino-guay/esp32-ag_sinte/blob/main/AG_Midi.h"
click node_arp "https://github.com/arduino-guay/esp32-ag_sinte/blob/main/AG_Arpegiador.cpp"
click node_synth "https://github.com/arduino-guay/esp32-ag_sinte/blob/main/AG_Sintetizador.cpp"
click node_voice "https://github.com/arduino-guay/esp32-ag_sinte/blob/main/AG_Voz.cpp"
click node_osc "https://github.com/arduino-guay/esp32-ag_sinte/blob/main/AG_Oscilador.cpp"
click node_tables "https://github.com/arduino-guay/esp32-ag_sinte/blob/main/AG_Wavetable.cpp"
click node_akwf "https://github.com/arduino-guay/esp32-ag_sinte/blob/main/AG_AKWF.hpp"
click node_util "https://github.com/arduino-guay/esp32-ag_sinte/blob/main/AG_Util.cpp"
click node_envelope "https://github.com/arduino-guay/esp32-ag_sinte/blob/main/ADSR.cpp"
click node_filter "https://github.com/arduino-guay/esp32-ag_sinte/blob/main/AG_Filtro.cpp"
click node_delay "https://github.com/arduino-guay/esp32-ag_sinte/blob/main/simple_delay.ino"
click node_i2s "https://github.com/arduino-guay/esp32-ag_sinte/blob/main/i2s_interface.ino"

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_entry,node_adc,node_menu,node_params toneBlue
class node_midi,node_arp toneAmber
class node_synth,node_voice,node_osc,node_tables,node_akwf,node_util,node_envelope,node_filter toneMint
class node_delay,node_i2s toneRose
class node_player,node_controls_hw,node_midi_in,node_dac toneIndigo
```

## Components

### Controls and Input

- [Synth runtime](https://github.com/arduino-guay/esp32-ag_sinte/blob/main/AG_Sinte.ino): `AG_Sinte.ino`
- [ADC controls](https://github.com/arduino-guay/esp32-ag_sinte/blob/main/AG_ADC.cpp): `AG_ADC.cpp`
- [LCD menu](https://github.com/arduino-guay/esp32-ag_sinte/blob/main/AG_Menu.cpp): `AG_Menu.cpp`
- [Sound parameters](https://github.com/arduino-guay/esp32-ag_sinte/blob/main/AG_Param.cpp): `AG_Param.cpp`

### Note Handling

- [MIDI routing](https://github.com/arduino-guay/esp32-ag_sinte/blob/main/AG_Midi.h): `AG_Midi.h`
- [Arpeggiator](https://github.com/arduino-guay/esp32-ag_sinte/blob/main/AG_Arpegiador.cpp): `AG_Arpegiador.cpp`

### Sound Generation

- [Synth engine](https://github.com/arduino-guay/esp32-ag_sinte/blob/main/AG_Sintetizador.cpp): `AG_Sintetizador.cpp`
- [Synth voices](https://github.com/arduino-guay/esp32-ag_sinte/blob/main/AG_Voz.cpp): `AG_Voz.cpp`
- [Oscillators](https://github.com/arduino-guay/esp32-ag_sinte/blob/main/AG_Oscilador.cpp): `AG_Oscilador.cpp`
- [Waveform tables](https://github.com/arduino-guay/esp32-ag_sinte/blob/main/AG_Wavetable.cpp): `AG_Wavetable.cpp`
- [AKWF samples](https://github.com/arduino-guay/esp32-ag_sinte/blob/main/AG_AKWF.hpp): `AG_AKWF.hpp`
- [Signal utilities](https://github.com/arduino-guay/esp32-ag_sinte/blob/main/AG_Util.cpp): `AG_Util.cpp`
- [ADSR envelopes](https://github.com/arduino-guay/esp32-ag_sinte/blob/main/ADSR.cpp): `ADSR.cpp`
- [Filters](https://github.com/arduino-guay/esp32-ag_sinte/blob/main/AG_Filtro.cpp): `AG_Filtro.cpp`

### Audio Output

- [Configurable delay](https://github.com/arduino-guay/esp32-ag_sinte/blob/main/simple_delay.ino): `simple_delay.ino`
- [I²S output](https://github.com/arduino-guay/esp32-ag_sinte/blob/main/i2s_interface.ino): `i2s_interface.ino`

### Other components

- **Player**
- **Encoder and pots**
- **MIDI input**
- **I²S DAC**

## Connections

- Player → MIDI input: sends notes (evidence: `readme.md`)
- MIDI input → MIDI routing: delivers MIDI (evidence: `readme.md`)
- Encoder and pots → ADC controls: provides controls (evidence: `readme.md`)
- Encoder and pots → LCD menu: operates menu (evidence: `AG_Menu.cpp`)
- Synth runtime → LCD menu: services controls
- LCD menu → Sound parameters: sets parameters (evidence: `AG_Menu.cpp`)
- LCD menu → Arpeggiator: sets arpeggio (evidence: `AG_Menu.cpp`)
- LCD menu → MIDI routing: sets mode (evidence: `AG_Menu.cpp`)
- MIDI routing → Synth engine: dispatches notes (evidence: `AG_Midi.h`)
- MIDI routing → Arpeggiator: dispatches notes (evidence: `AG_Midi.h`)
- MIDI routing → Sound parameters: updates controls (evidence: `AG_Midi.h`)
- Arpeggiator → Synth engine: triggers notes
- Synth engine → Synth voices: processes voices
- Synth voices → Oscillators: generates tones
- Synth voices → Filters: filters voices
- Synth voices → ADSR envelopes: shapes volume
- Sound parameters → Oscillators: selects waveforms
- Sound parameters → Filters: configures filters
- Oscillators → Waveform tables: reads waveform
- Waveform tables → Signal utilities: uses signal functions
- Signal utilities → AKWF samples: reads samples (evidence: `AG_Util.cpp`)
- Synth engine → Configurable delay: processes audio
- Configurable delay → I²S output: outputs audio
- I²S output → I²S DAC: sends audio (evidence: `readme.md`)
