# nandha0804/apex-diagnostic-tool-v1 architecture

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

- Interactive diagram: https://gitdiagram.com/nandha0804/apex-diagnostic-tool-v1
- Repository: https://github.com/nandha0804/apex-diagnostic-tool-v1

## Overview

Project Apex is a mixed-signal diagnostic instrument documented through hardware design and manufacturing artifacts. Its documented workflow is to use an ESP32-led dual-MCU instrument for impedance analysis or digital-IC truth-table testing. The README describes the architecture and component relationships; the available materials do not expose firmware or schematics as readable excerpts, so detailed control flow and wiring beyond those statements are not inferred. Version 2 items are identified as roadmap, not current functionality.

Main entry points: [`logic_tester/logic_tester.kicad_sch`](https://github.com/nandha0804/apex-diagnostic-tool-v1/blob/main/logic_tester/logic_tester.kicad_sch) (Impedance analyzer), [`README.md`](https://github.com/nandha0804/apex-diagnostic-tool-v1/blob/main/README.md) (V2 platform roadmap), [`logic_tester/logic_tester.kicad_pcb`](https://github.com/nandha0804/apex-diagnostic-tool-v1/blob/main/logic_tester/logic_tester.kicad_pcb) (PCB layout), [`logic_tester/logic_tester_gerber`](https://github.com/nandha0804/apex-diagnostic-tool-v1/tree/main/logic_tester/logic_tester_gerber) (Manufacturing outputs)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_control["Control system"]
  node_esp32["ESP32 master"]
  node_atmega["ATmega328P coprocessor"]
  node_v2_platform["V2 platform roadmap<br/>[README.md]"]
  node_stm32["STM32H723 master<br/>[README.md]"]
  node_avr32["AVR32DB48 slave<br/>[README.md]"]
  node_gui["Desktop GUI plan<br/>[README.md]"]
end

subgraph group_analog["Analog analysis"]
  node_analyzer["Impedance analyzer"]
  node_ad9833["AD9833 generator"]
  node_mcp6022["MCP6022 PGA"]
  node_mcp3208["MCP3208 ADC"]
  node_spi["Isolated SPI bus"]
end

subgraph group_digital["Digital IC testing"]
  node_ic_tester["Digital IC tester"]
  node_zif["16-pin ZIF socket"]
  node_switch["1P3T switch matrix"]
end

subgraph group_artifacts["Hardware artifacts"]
  node_schematic["Circuit schematic"]
  node_pcb["PCB layout"]
  node_gerber["Manufacturing outputs"]
end

node_operator(("Instrument user"))

node_operator -->|"uses instrument"| node_esp32
node_esp32 -->|"dual-MCU system"| node_atmega
node_esp32 -.->|"instrument control"| node_analyzer
node_analyzer -->|"generates waveform"| node_ad9833
node_analyzer -->|"amplifies signal"| node_mcp6022
node_analyzer -->|"samples signal"| node_mcp3208
node_mcp3208 -->|"uses isolated bus"| node_spi
node_operator -->|"tests digital ICs"| node_ic_tester
node_ic_tester -->|"tests through"| node_zif
node_zif -->|"routed via"| node_switch
node_switch -->|"enables validation"| node_ic_tester
node_schematic -.->|"design represented in"| node_pcb
node_pcb -.->|"manufacturing files"| node_gerber
node_v2_platform -->|"plans upgrade to"| node_stm32
node_v2_platform -->|"plans upgrade to"| node_avr32
node_v2_platform -->|"plans transition to"| node_gui

click node_esp32 "https://github.com/nandha0804/apex-diagnostic-tool-v1/blob/main/logic_tester/logic_tester.kicad_sch"
click node_atmega "https://github.com/nandha0804/apex-diagnostic-tool-v1/blob/main/logic_tester/logic_tester.kicad_sch"
click node_analyzer "https://github.com/nandha0804/apex-diagnostic-tool-v1/blob/main/logic_tester/logic_tester.kicad_sch"
click node_ad9833 "https://github.com/nandha0804/apex-diagnostic-tool-v1/blob/main/logic_tester/logic_tester.kicad_sch"
click node_mcp6022 "https://github.com/nandha0804/apex-diagnostic-tool-v1/blob/main/logic_tester/logic_tester.kicad_sch"
click node_mcp3208 "https://github.com/nandha0804/apex-diagnostic-tool-v1/blob/main/logic_tester/logic_tester.kicad_sch"
click node_spi "https://github.com/nandha0804/apex-diagnostic-tool-v1/blob/main/logic_tester/logic_tester.kicad_sch"
click node_ic_tester "https://github.com/nandha0804/apex-diagnostic-tool-v1/blob/main/logic_tester/logic_tester.kicad_sch"
click node_zif "https://github.com/nandha0804/apex-diagnostic-tool-v1/blob/main/logic_tester/logic_tester.kicad_sch"
click node_switch "https://github.com/nandha0804/apex-diagnostic-tool-v1/blob/main/logic_tester/logic_tester.kicad_sch"
click node_schematic "https://github.com/nandha0804/apex-diagnostic-tool-v1/blob/main/logic_tester/logic_tester.kicad_sch"
click node_pcb "https://github.com/nandha0804/apex-diagnostic-tool-v1/blob/main/logic_tester/logic_tester.kicad_pcb"
click node_gerber "https://github.com/nandha0804/apex-diagnostic-tool-v1/tree/main/logic_tester/logic_tester_gerber"
click node_v2_platform "https://github.com/nandha0804/apex-diagnostic-tool-v1/blob/main/README.md"
click node_stm32 "https://github.com/nandha0804/apex-diagnostic-tool-v1/blob/main/README.md"
click node_avr32 "https://github.com/nandha0804/apex-diagnostic-tool-v1/blob/main/README.md"
click node_gui "https://github.com/nandha0804/apex-diagnostic-tool-v1/blob/main/README.md"

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_esp32,node_atmega,node_v2_platform,node_stm32,node_avr32,node_gui,node_operator toneBlue
class node_analyzer,node_ad9833,node_mcp6022,node_mcp3208,node_spi toneAmber
class node_ic_tester,node_zif,node_switch toneMint
class node_schematic,node_pcb,node_gerber toneRose
```

## Components

### Control system

- [ESP32 master](https://github.com/nandha0804/apex-diagnostic-tool-v1/blob/main/logic_tester/logic_tester.kicad_sch): `logic_tester/logic_tester.kicad_sch`
- [ATmega328P coprocessor](https://github.com/nandha0804/apex-diagnostic-tool-v1/blob/main/logic_tester/logic_tester.kicad_sch): `logic_tester/logic_tester.kicad_sch`
- [V2 platform roadmap](https://github.com/nandha0804/apex-diagnostic-tool-v1/blob/main/README.md): `README.md`
- [STM32H723 master](https://github.com/nandha0804/apex-diagnostic-tool-v1/blob/main/README.md): `README.md`
- [AVR32DB48 slave](https://github.com/nandha0804/apex-diagnostic-tool-v1/blob/main/README.md): `README.md`
- [Desktop GUI plan](https://github.com/nandha0804/apex-diagnostic-tool-v1/blob/main/README.md): `README.md`

### Analog analysis

- [Impedance analyzer](https://github.com/nandha0804/apex-diagnostic-tool-v1/blob/main/logic_tester/logic_tester.kicad_sch): `logic_tester/logic_tester.kicad_sch`
- [AD9833 generator](https://github.com/nandha0804/apex-diagnostic-tool-v1/blob/main/logic_tester/logic_tester.kicad_sch): `logic_tester/logic_tester.kicad_sch`
- [MCP6022 PGA](https://github.com/nandha0804/apex-diagnostic-tool-v1/blob/main/logic_tester/logic_tester.kicad_sch): `logic_tester/logic_tester.kicad_sch`
- [MCP3208 ADC](https://github.com/nandha0804/apex-diagnostic-tool-v1/blob/main/logic_tester/logic_tester.kicad_sch): `logic_tester/logic_tester.kicad_sch`
- [Isolated SPI bus](https://github.com/nandha0804/apex-diagnostic-tool-v1/blob/main/logic_tester/logic_tester.kicad_sch): `logic_tester/logic_tester.kicad_sch`

### Digital IC testing

- [Digital IC tester](https://github.com/nandha0804/apex-diagnostic-tool-v1/blob/main/logic_tester/logic_tester.kicad_sch): `logic_tester/logic_tester.kicad_sch`
- [16-pin ZIF socket](https://github.com/nandha0804/apex-diagnostic-tool-v1/blob/main/logic_tester/logic_tester.kicad_sch): `logic_tester/logic_tester.kicad_sch`
- [1P3T switch matrix](https://github.com/nandha0804/apex-diagnostic-tool-v1/blob/main/logic_tester/logic_tester.kicad_sch): `logic_tester/logic_tester.kicad_sch`

### Hardware artifacts

- [Circuit schematic](https://github.com/nandha0804/apex-diagnostic-tool-v1/blob/main/logic_tester/logic_tester.kicad_sch): `logic_tester/logic_tester.kicad_sch`
- [PCB layout](https://github.com/nandha0804/apex-diagnostic-tool-v1/blob/main/logic_tester/logic_tester.kicad_pcb): `logic_tester/logic_tester.kicad_pcb`
- [Manufacturing outputs](https://github.com/nandha0804/apex-diagnostic-tool-v1/tree/main/logic_tester/logic_tester_gerber): `logic_tester/logic_tester_gerber`

### Other components

- **Instrument user**

## Connections

- Instrument user → ESP32 master: uses instrument (evidence: `README.md`)
- ESP32 master → ATmega328P coprocessor: dual-MCU system (evidence: `README.md`)
- ESP32 master → Impedance analyzer: instrument control
- Impedance analyzer → AD9833 generator: generates waveform (evidence: `README.md`)
- Impedance analyzer → MCP6022 PGA: amplifies signal (evidence: `README.md`)
- Impedance analyzer → MCP3208 ADC: samples signal (evidence: `README.md`)
- MCP3208 ADC → Isolated SPI bus: uses isolated bus (evidence: `README.md`)
- Instrument user → Digital IC tester: tests digital ICs (evidence: `README.md`)
- Digital IC tester → 16-pin ZIF socket: tests through (evidence: `README.md`)
- 16-pin ZIF socket → 1P3T switch matrix: routed via (evidence: `README.md`)
- 1P3T switch matrix → Digital IC tester: enables validation (evidence: `README.md`)
- Circuit schematic → PCB layout: design represented in
- PCB layout → Manufacturing outputs: manufacturing files
- V2 platform roadmap → STM32H723 master: plans upgrade to (evidence: `README.md`)
- V2 platform roadmap → AVR32DB48 slave: plans upgrade to (evidence: `README.md`)
- V2 platform roadmap → Desktop GUI plan: plans transition to (evidence: `README.md`)
