# brennony/engineering-protocol architecture

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

- Interactive diagram: https://gitdiagram.com/brennony/engineering-protocol
- Repository: https://github.com/brennony/engineering-protocol

## Overview

This is an engineering-learning repository, not one integrated application: it collects independent Python exercises and calculator tools alongside embedded Arduino libraries. The user-facing pattern is a learner exploring projects and using their individual APIs; there is no repository-wide runtime entry point or shared result pipeline. The graph emphasizes sampled project behavior and the indexed core modules. Some library capabilities are represented at their enclosing directory because their implementation was not sampled; unsupported connections are omitted.

Main entry points: [`Projects/Python/Calculator/calculator.py`](https://github.com/brennony/engineering-protocol/blob/main/Projects/Python/Calculator/calculator.py) (Calculator CLI), [`Projects/Archives/From_IntroToCoding/libraries/SD/src/utility/SdFile.cpp`](https://github.com/brennony/engineering-protocol/blob/main/Projects/Archives/From_IntroToCoding/libraries/SD/src/utility/SdFile.cpp) (FAT file engine), [`Projects/Archives/From_IntroToCoding/libraries/Adafruit_GFX_Library/Adafruit_GFX.cpp`](https://github.com/brennony/engineering-protocol/blob/main/Projects/Archives/From_IntroToCoding/libraries/Adafruit_GFX_Library/Adafruit_GFX.cpp) (Graphics primitives), [`Projects/Python/Calculator/algebra_helpers.py`](https://github.com/brennony/engineering-protocol/blob/main/Projects/Python/Calculator/algebra_helpers.py) (Algebra helpers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_python["Python projects"]
  node_calculator["Calculator CLI<br/>[calculator.py]"]
  node_math["Math helpers<br/>[math_helpers.py]"]
  node_algebra["Algebra helpers<br/>[algebra_helpers.py]"]
  node_trig["Trig helpers<br/>[trig_helpers.py]"]
  node_student["Student records<br/>[student_record.py]"]
  node_insurance["Insurance quoter"]
  node_algorithms["Algorithms"]
  node_aboutme["About me<br/>[about_me.py]"]
end

subgraph group_graphics["Graphics and displays"]
  node_gfx["Graphics primitives<br/>[Adafruit_GFX.cpp]"]
  node_fontdata["Classic font data<br/>[glcdfont.c]"]
  node_fontfiles["Font collection"]
  node_ili9341["ILI9341 display"]
  node_ledbackpack["LED backpacks"]
  node_sh110x["SH110X displays"]
end

subgraph group_hardware["Embedded hardware"]
  node_circuitplayground["Circuit Playground"]
  node_neopixel["NeoPixel LEDs"]
  node_touch["Touch input"]
  node_tsc2007["TSC2007 touch"]
  node_touchscreen["Resistive touchscreen<br/>[TouchScreen.cpp]"]
  node_gps["NMEA parsing<br/>[NMEA_parse.cpp]"]
  node_busio["Bus IO devices"]
end

subgraph group_data["Embedded data and signal"]
  node_rtc["Real-time clocks<br/>[RTClib.cpp]"]
  node_sdapi["SD file API<br/>[SD.cpp]"]
  node_fat["FAT file engine<br/>[SdFile.cpp]"]
  node_fatstructs["FAT structures<br/>[FatStructs.h]"]
  node_sdcard["SD card transport<br/>[Sd2Card.h]"]
  node_dma["DMA transfers"]
  node_fft["FFT support tables"]
  node_pdm["PDM audio input"]
  node_sleepydog["Watchdog and sleep"]
  node_wavehc["Wave playback<br/>[WaveHC.cpp]"]
end

node_learner(("Learner"))

node_learner -->|"uses"| node_calculator
node_learner -->|"explores"| node_student
node_calculator -->|"calls"| node_math
node_calculator -->|"calls"| node_algebra
node_calculator -->|"calls"| node_trig
node_algebra -->|"calls"| node_math
node_gfx -->|"reads glyphs"| node_fontdata
node_ili9341 -->|"extends"| node_gfx
node_ledbackpack -->|"uses"| node_gfx
node_sdapi -.->|"uses"| node_fat
node_fat -->|"uses"| node_fatstructs
node_fat -->|"uses"| node_sdcard

click node_calculator "https://github.com/brennony/engineering-protocol/blob/main/Projects/Python/Calculator/calculator.py"
click node_math "https://github.com/brennony/engineering-protocol/blob/main/Projects/Python/Calculator/math_helpers.py"
click node_algebra "https://github.com/brennony/engineering-protocol/blob/main/Projects/Python/Calculator/algebra_helpers.py"
click node_trig "https://github.com/brennony/engineering-protocol/blob/main/Projects/Python/Calculator/trig_helpers.py"
click node_student "https://github.com/brennony/engineering-protocol/blob/main/Projects/Python/Student_Record/student_record.py"
click node_insurance "https://github.com/brennony/engineering-protocol/blob/main/Projects/Python/Insurance_Quoter/insurance-quoter.py"
click node_algorithms "https://github.com/brennony/engineering-protocol/tree/main/Projects/Python/Algorithms"
click node_aboutme "https://github.com/brennony/engineering-protocol/blob/main/Projects/Python/About_Me/about_me.py"
click node_gfx "https://github.com/brennony/engineering-protocol/blob/main/Projects/Archives/From_IntroToCoding/libraries/Adafruit_GFX_Library/Adafruit_GFX.cpp"
click node_fontdata "https://github.com/brennony/engineering-protocol/blob/main/Projects/Archives/From_IntroToCoding/libraries/Adafruit_GFX_Library/glcdfont.c"
click node_fontfiles "https://github.com/brennony/engineering-protocol/tree/main/Projects/Archives/From_IntroToCoding/libraries/Adafruit_GFX_Library/Fonts"
click node_ili9341 "https://github.com/brennony/engineering-protocol/blob/main/Projects/Archives/From_IntroToCoding/libraries/Adafruit_ILI9341/Adafruit_ILI9341.cpp"
click node_ledbackpack "https://github.com/brennony/engineering-protocol/blob/main/Projects/Archives/From_IntroToCoding/libraries/Adafruit_LED_Backpack_Library/Adafruit_LEDBackpack.cpp"
click node_sh110x "https://github.com/brennony/engineering-protocol/tree/main/Projects/Archives/From_IntroToCoding/libraries/Adafruit_SH110X"
click node_circuitplayground "https://github.com/brennony/engineering-protocol/blob/main/Projects/Archives/From_IntroToCoding/libraries/Adafruit_Circuit_Playground/Adafruit_CircuitPlayground.cpp"
click node_neopixel "https://github.com/brennony/engineering-protocol/blob/main/Projects/Archives/From_IntroToCoding/libraries/Adafruit_Circuit_Playground/utility/Adafruit_CPlay_NeoPixel.cpp"
click node_touch "https://github.com/brennony/engineering-protocol/blob/main/Projects/Archives/From_IntroToCoding/libraries/Adafruit_STMPE610/Adafruit_STMPE610.cpp"
click node_tsc2007 "https://github.com/brennony/engineering-protocol/blob/main/Projects/Archives/From_IntroToCoding/libraries/Adafruit_TSC2007/Adafruit_TSC2007.cpp"
click node_touchscreen "https://github.com/brennony/engineering-protocol/blob/main/Projects/Archives/From_IntroToCoding/libraries/Adafruit_TouchScreen/TouchScreen.cpp"
click node_gps "https://github.com/brennony/engineering-protocol/blob/main/Projects/Archives/From_IntroToCoding/libraries/Adafruit_GPS_Library/src/NMEA_parse.cpp"
click node_rtc "https://github.com/brennony/engineering-protocol/blob/main/Projects/Archives/From_IntroToCoding/libraries/RTClib/src/RTClib.cpp"
click node_sdapi "https://github.com/brennony/engineering-protocol/blob/main/Projects/Archives/From_IntroToCoding/libraries/SD/src/SD.cpp"
click node_fat "https://github.com/brennony/engineering-protocol/blob/main/Projects/Archives/From_IntroToCoding/libraries/SD/src/utility/SdFile.cpp"
click node_fatstructs "https://github.com/brennony/engineering-protocol/blob/main/Projects/Archives/From_IntroToCoding/libraries/SD/src/utility/FatStructs.h"
click node_sdcard "https://github.com/brennony/engineering-protocol/blob/main/Projects/Archives/From_IntroToCoding/libraries/SD/src/utility/Sd2Card.h"
click node_dma "https://github.com/brennony/engineering-protocol/blob/main/Projects/Archives/From_IntroToCoding/libraries/Adafruit_Zero_DMA_Library/Adafruit_ZeroDMA.cpp"
click node_fft "https://github.com/brennony/engineering-protocol/blob/main/Projects/Archives/From_IntroToCoding/libraries/Adafruit_Zero_FFT_Library/arm_common_tables.c"
click node_pdm "https://github.com/brennony/engineering-protocol/blob/main/Projects/Archives/From_IntroToCoding/libraries/Adafruit_Zero_PDM_Library/Adafruit_ZeroPDM.cpp"
click node_sleepydog "https://github.com/brennony/engineering-protocol/tree/main/Projects/Archives/From_IntroToCoding/libraries/Adafruit_SleepyDog_Library"
click node_busio "https://github.com/brennony/engineering-protocol/tree/main/Projects/Archives/From_IntroToCoding/libraries/Adafruit_BusIO"
click node_wavehc "https://github.com/brennony/engineering-protocol/blob/main/Projects/Archives/From_IntroToCoding/libraries/WaveHC/WaveHC.cpp"

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_calculator,node_math,node_algebra,node_trig,node_student,node_insurance,node_algorithms,node_aboutme toneBlue
class node_gfx,node_fontdata,node_fontfiles,node_ili9341,node_ledbackpack,node_sh110x toneAmber
class node_circuitplayground,node_neopixel,node_touch,node_tsc2007,node_touchscreen,node_gps,node_busio toneMint
class node_rtc,node_sdapi,node_fat,node_fatstructs,node_sdcard,node_dma,node_fft,node_pdm,node_sleepydog,node_wavehc toneRose
class node_learner toneIndigo
```

## Components

### Python projects

- [Calculator CLI](https://github.com/brennony/engineering-protocol/blob/main/Projects/Python/Calculator/calculator.py): `Projects/Python/Calculator/calculator.py`
- [Math helpers](https://github.com/brennony/engineering-protocol/blob/main/Projects/Python/Calculator/math_helpers.py): `Projects/Python/Calculator/math_helpers.py`
- [Algebra helpers](https://github.com/brennony/engineering-protocol/blob/main/Projects/Python/Calculator/algebra_helpers.py): `Projects/Python/Calculator/algebra_helpers.py`
- [Trig helpers](https://github.com/brennony/engineering-protocol/blob/main/Projects/Python/Calculator/trig_helpers.py): `Projects/Python/Calculator/trig_helpers.py`
- [Student records](https://github.com/brennony/engineering-protocol/blob/main/Projects/Python/Student_Record/student_record.py): `Projects/Python/Student_Record/student_record.py`
- [Insurance quoter](https://github.com/brennony/engineering-protocol/blob/main/Projects/Python/Insurance_Quoter/insurance-quoter.py): `Projects/Python/Insurance_Quoter/insurance-quoter.py`
- [Algorithms](https://github.com/brennony/engineering-protocol/tree/main/Projects/Python/Algorithms): `Projects/Python/Algorithms`
- [About me](https://github.com/brennony/engineering-protocol/blob/main/Projects/Python/About_Me/about_me.py): `Projects/Python/About_Me/about_me.py`

### Graphics and displays

- [Graphics primitives](https://github.com/brennony/engineering-protocol/blob/main/Projects/Archives/From_IntroToCoding/libraries/Adafruit_GFX_Library/Adafruit_GFX.cpp): `Projects/Archives/From_IntroToCoding/libraries/Adafruit_GFX_Library/Adafruit_GFX.cpp`
- [Classic font data](https://github.com/brennony/engineering-protocol/blob/main/Projects/Archives/From_IntroToCoding/libraries/Adafruit_GFX_Library/glcdfont.c): `Projects/Archives/From_IntroToCoding/libraries/Adafruit_GFX_Library/glcdfont.c`
- [Font collection](https://github.com/brennony/engineering-protocol/tree/main/Projects/Archives/From_IntroToCoding/libraries/Adafruit_GFX_Library/Fonts): `Projects/Archives/From_IntroToCoding/libraries/Adafruit_GFX_Library/Fonts`
- [ILI9341 display](https://github.com/brennony/engineering-protocol/blob/main/Projects/Archives/From_IntroToCoding/libraries/Adafruit_ILI9341/Adafruit_ILI9341.cpp): `Projects/Archives/From_IntroToCoding/libraries/Adafruit_ILI9341/Adafruit_ILI9341.cpp`
- [LED backpacks](https://github.com/brennony/engineering-protocol/blob/main/Projects/Archives/From_IntroToCoding/libraries/Adafruit_LED_Backpack_Library/Adafruit_LEDBackpack.cpp): `Projects/Archives/From_IntroToCoding/libraries/Adafruit_LED_Backpack_Library/Adafruit_LEDBackpack.cpp`
- [SH110X displays](https://github.com/brennony/engineering-protocol/tree/main/Projects/Archives/From_IntroToCoding/libraries/Adafruit_SH110X): `Projects/Archives/From_IntroToCoding/libraries/Adafruit_SH110X`

### Embedded hardware

- [Circuit Playground](https://github.com/brennony/engineering-protocol/blob/main/Projects/Archives/From_IntroToCoding/libraries/Adafruit_Circuit_Playground/Adafruit_CircuitPlayground.cpp): `Projects/Archives/From_IntroToCoding/libraries/Adafruit_Circuit_Playground/Adafruit_CircuitPlayground.cpp`
- [NeoPixel LEDs](https://github.com/brennony/engineering-protocol/blob/main/Projects/Archives/From_IntroToCoding/libraries/Adafruit_Circuit_Playground/utility/Adafruit_CPlay_NeoPixel.cpp): `Projects/Archives/From_IntroToCoding/libraries/Adafruit_Circuit_Playground/utility/Adafruit_CPlay_NeoPixel.cpp`
- [Touch input](https://github.com/brennony/engineering-protocol/blob/main/Projects/Archives/From_IntroToCoding/libraries/Adafruit_STMPE610/Adafruit_STMPE610.cpp): `Projects/Archives/From_IntroToCoding/libraries/Adafruit_STMPE610/Adafruit_STMPE610.cpp`
- [TSC2007 touch](https://github.com/brennony/engineering-protocol/blob/main/Projects/Archives/From_IntroToCoding/libraries/Adafruit_TSC2007/Adafruit_TSC2007.cpp): `Projects/Archives/From_IntroToCoding/libraries/Adafruit_TSC2007/Adafruit_TSC2007.cpp`
- [Resistive touchscreen](https://github.com/brennony/engineering-protocol/blob/main/Projects/Archives/From_IntroToCoding/libraries/Adafruit_TouchScreen/TouchScreen.cpp): `Projects/Archives/From_IntroToCoding/libraries/Adafruit_TouchScreen/TouchScreen.cpp`
- [NMEA parsing](https://github.com/brennony/engineering-protocol/blob/main/Projects/Archives/From_IntroToCoding/libraries/Adafruit_GPS_Library/src/NMEA_parse.cpp): `Projects/Archives/From_IntroToCoding/libraries/Adafruit_GPS_Library/src/NMEA_parse.cpp`
- [Bus IO devices](https://github.com/brennony/engineering-protocol/tree/main/Projects/Archives/From_IntroToCoding/libraries/Adafruit_BusIO): `Projects/Archives/From_IntroToCoding/libraries/Adafruit_BusIO`

### Embedded data and signal

- [Real-time clocks](https://github.com/brennony/engineering-protocol/blob/main/Projects/Archives/From_IntroToCoding/libraries/RTClib/src/RTClib.cpp): `Projects/Archives/From_IntroToCoding/libraries/RTClib/src/RTClib.cpp`
- [SD file API](https://github.com/brennony/engineering-protocol/blob/main/Projects/Archives/From_IntroToCoding/libraries/SD/src/SD.cpp): `Projects/Archives/From_IntroToCoding/libraries/SD/src/SD.cpp`
- [FAT file engine](https://github.com/brennony/engineering-protocol/blob/main/Projects/Archives/From_IntroToCoding/libraries/SD/src/utility/SdFile.cpp): `Projects/Archives/From_IntroToCoding/libraries/SD/src/utility/SdFile.cpp`
- [FAT structures](https://github.com/brennony/engineering-protocol/blob/main/Projects/Archives/From_IntroToCoding/libraries/SD/src/utility/FatStructs.h): `Projects/Archives/From_IntroToCoding/libraries/SD/src/utility/FatStructs.h`
- [SD card transport](https://github.com/brennony/engineering-protocol/blob/main/Projects/Archives/From_IntroToCoding/libraries/SD/src/utility/Sd2Card.h): `Projects/Archives/From_IntroToCoding/libraries/SD/src/utility/Sd2Card.h`
- [DMA transfers](https://github.com/brennony/engineering-protocol/blob/main/Projects/Archives/From_IntroToCoding/libraries/Adafruit_Zero_DMA_Library/Adafruit_ZeroDMA.cpp): `Projects/Archives/From_IntroToCoding/libraries/Adafruit_Zero_DMA_Library/Adafruit_ZeroDMA.cpp`
- [FFT support tables](https://github.com/brennony/engineering-protocol/blob/main/Projects/Archives/From_IntroToCoding/libraries/Adafruit_Zero_FFT_Library/arm_common_tables.c): `Projects/Archives/From_IntroToCoding/libraries/Adafruit_Zero_FFT_Library/arm_common_tables.c`
- [PDM audio input](https://github.com/brennony/engineering-protocol/blob/main/Projects/Archives/From_IntroToCoding/libraries/Adafruit_Zero_PDM_Library/Adafruit_ZeroPDM.cpp): `Projects/Archives/From_IntroToCoding/libraries/Adafruit_Zero_PDM_Library/Adafruit_ZeroPDM.cpp`
- [Watchdog and sleep](https://github.com/brennony/engineering-protocol/tree/main/Projects/Archives/From_IntroToCoding/libraries/Adafruit_SleepyDog_Library): `Projects/Archives/From_IntroToCoding/libraries/Adafruit_SleepyDog_Library`
- [Wave playback](https://github.com/brennony/engineering-protocol/blob/main/Projects/Archives/From_IntroToCoding/libraries/WaveHC/WaveHC.cpp): `Projects/Archives/From_IntroToCoding/libraries/WaveHC/WaveHC.cpp`

### Other components

- **Learner**

## Connections

- Learner → Calculator CLI: uses
- Learner → Student records: explores
- Calculator CLI → Math helpers: calls (evidence: `Projects/Python/Calculator/calculator.py`)
- Calculator CLI → Algebra helpers: calls (evidence: `Projects/Python/Calculator/calculator.py`)
- Calculator CLI → Trig helpers: calls (evidence: `Projects/Python/Calculator/calculator.py`)
- Algebra helpers → Math helpers: calls (evidence: `Projects/Python/Calculator/algebra_helpers.py`)
- Graphics primitives → Classic font data: reads glyphs (evidence: `Projects/Archives/From_IntroToCoding/libraries/Adafruit_GFX_Library/Adafruit_GFX.cpp`)
- ILI9341 display → Graphics primitives: extends
- LED backpacks → Graphics primitives: uses (evidence: `Projects/Archives/From_IntroToCoding/libraries/Adafruit_LED_Backpack_Library/Adafruit_LEDBackpack.cpp`)
- SD file API → FAT file engine: uses
- FAT file engine → FAT structures: uses
- FAT file engine → SD card transport: uses
