# paky76/paky76-esp32-s3 architecture

> Architecture diagram of the GitHub repository paky76/paky76-esp32-s3, 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/paky76/paky76-esp32-s3
- Repository: https://github.com/paky76/paky76-esp32-s3

## Overview

Paky76 is a work-in-progress ESP32-S3 interactive desk assistant, combining a prototype electronics platform and a planned embedded experience. Its intended user workflow is to issue a local command through the controls or voice, have the device perform a short action or consult a LAN JARVIS backend, then show a response and play audio. The sampled firmware implements only initial Wi-Fi/BLE/display bring-up; menu, voice, assistant, camera, and storage behavior remain planned. The graph includes those documented product branches, but their links are dashed where implementation evidence is unavailable.

Main entry points: [`firmware/src/main.cpp`](https://github.com/paky76/paky76-esp32-s3/blob/main/firmware/src/main.cpp) (ESP32 bring-up), [`firmware`](https://github.com/paky76/paky76-esp32-s3/tree/main/firmware) (Offline commands), [`hardware/prototipi/revf-d1/Cablaggio-Periferiche.md`](https://github.com/paky76/paky76-esp32-s3/blob/main/hardware/prototipi/revf-d1/Cablaggio-Periferiche.md) (Peripheral interfaces), [`hardware/prototipi/revf-d1/KiCad/Paky76-RevF.kicad_pcb`](https://github.com/paky76/paky76-esp32-s3/blob/main/hardware/prototipi/revf-d1/KiCad/Paky76-RevF.kicad_pcb) (Rev.F electronics)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_device["Device firmware"]
  node_firmware["ESP32 bring-up<br/>[main.cpp]"]
  node_wifi["Wi-Fi station<br/>[main.cpp]"]
  node_ble["BLE advertising<br/>[main.cpp]"]
  node_camera["SPI camera"]
  node_microsd["Removable microSD"]
end

subgraph group_interaction["User interaction"]
  node_menu["Controls and menu"]
  node_offline["Offline commands"]
  node_voice["Italian voice input"]
  node_display["Animated display<br/>[main.cpp]"]
  node_audio["Audio output"]
  node_jarvis["JARVIS assistant"]
  node_ollama["Ollama models"]
end

subgraph group_hardware["Electronics platform"]
  node_rtc["RTC and backup"]
  node_board["Rev.F electronics"]
  node_interfaces["Peripheral interfaces"]
  node_speaker["Speaker"]
end

subgraph group_physical["Physical design"]
  node_enclosure["D1 enclosure<br/>[Paky76-D1.scad]"]
end

node_user(("User"))

node_firmware -->|"starts station"| node_wifi
node_firmware -->|"starts advertising"| node_ble
node_firmware -->|"initializes and draws"| node_display
node_user -.->|"operates"| node_menu
node_menu -.->|"selects commands"| node_offline
node_user -.->|"speaks commands"| node_voice
node_voice -.->|"triggers actions"| node_offline
node_offline -.->|"updates expression"| node_display
node_offline -.->|"plays local sounds"| node_audio
node_wifi -.->|"connects over LAN"| node_jarvis
node_jarvis -.->|"uses models"| node_ollama
node_jarvis -.->|"returns spoken response"| node_audio
node_camera -.->|"shares J7 bus"| node_interfaces
node_microsd -.->|"shares J7 bus"| node_interfaces
node_microsd -.->|"stores compatible files"| node_firmware
node_board -.->|"provides connections"| node_interfaces
node_board -.->|"includes RTC"| node_rtc
node_board -.->|"fits D1 prototype"| node_enclosure
node_interfaces -.->|"connects speaker"| node_speaker

click node_firmware "https://github.com/paky76/paky76-esp32-s3/blob/main/firmware/src/main.cpp"
click node_wifi "https://github.com/paky76/paky76-esp32-s3/blob/main/firmware/src/main.cpp"
click node_ble "https://github.com/paky76/paky76-esp32-s3/blob/main/firmware/src/main.cpp"
click node_menu "https://github.com/paky76/paky76-esp32-s3/blob/main/hardware/prototipi/revf-d1/Paky76-Specifica-Pannello-Comandi.md"
click node_offline "https://github.com/paky76/paky76-esp32-s3/tree/main/firmware"
click node_voice "https://github.com/paky76/paky76-esp32-s3/tree/main/firmware"
click node_display "https://github.com/paky76/paky76-esp32-s3/blob/main/firmware/src/main.cpp"
click node_audio "https://github.com/paky76/paky76-esp32-s3/tree/main/firmware"
click node_jarvis "https://github.com/paky76/paky76-esp32-s3/tree/main/firmware"
click node_camera "https://github.com/paky76/paky76-esp32-s3/blob/main/hardware/prototipi/revf-d1/Cablaggio-Periferiche.md"
click node_microsd "https://github.com/paky76/paky76-esp32-s3/blob/main/hardware/prototipi/revf-d1/Cablaggio-Periferiche.md"
click node_rtc "https://github.com/paky76/paky76-esp32-s3/blob/main/hardware/prototipi/revf-d1/KiCad/Paky76-RevF.kicad_sch"
click node_board "https://github.com/paky76/paky76-esp32-s3/blob/main/hardware/prototipi/revf-d1/KiCad/Paky76-RevF.kicad_pcb"
click node_interfaces "https://github.com/paky76/paky76-esp32-s3/blob/main/hardware/prototipi/revf-d1/Cablaggio-Periferiche.md"
click node_enclosure "https://github.com/paky76/paky76-esp32-s3/blob/main/hardware/prototipi/revd-d1/Stampa-3D/Paky76-D1.scad"
click node_speaker "https://github.com/paky76/paky76-esp32-s3/blob/main/hardware/prototipi/revf-d1/Cablaggio-Periferiche.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_firmware,node_wifi,node_ble,node_camera,node_microsd,node_user toneBlue
class node_menu,node_offline,node_voice,node_display,node_audio,node_jarvis,node_ollama toneAmber
class node_rtc,node_board,node_interfaces,node_speaker toneMint
class node_enclosure toneRose
```

## Components

### Device firmware

- [ESP32 bring-up](https://github.com/paky76/paky76-esp32-s3/blob/main/firmware/src/main.cpp): `firmware/src/main.cpp`
- [Wi-Fi station](https://github.com/paky76/paky76-esp32-s3/blob/main/firmware/src/main.cpp): `firmware/src/main.cpp`
- [BLE advertising](https://github.com/paky76/paky76-esp32-s3/blob/main/firmware/src/main.cpp): `firmware/src/main.cpp`
- [SPI camera](https://github.com/paky76/paky76-esp32-s3/blob/main/hardware/prototipi/revf-d1/Cablaggio-Periferiche.md): `hardware/prototipi/revf-d1/Cablaggio-Periferiche.md`
- [Removable microSD](https://github.com/paky76/paky76-esp32-s3/blob/main/hardware/prototipi/revf-d1/Cablaggio-Periferiche.md): `hardware/prototipi/revf-d1/Cablaggio-Periferiche.md`

### User interaction

- [Controls and menu](https://github.com/paky76/paky76-esp32-s3/blob/main/hardware/prototipi/revf-d1/Paky76-Specifica-Pannello-Comandi.md): `hardware/prototipi/revf-d1/Paky76-Specifica-Pannello-Comandi.md`
- [Offline commands](https://github.com/paky76/paky76-esp32-s3/tree/main/firmware): `firmware`
- [Italian voice input](https://github.com/paky76/paky76-esp32-s3/tree/main/firmware): `firmware`
- [Animated display](https://github.com/paky76/paky76-esp32-s3/blob/main/firmware/src/main.cpp): `firmware/src/main.cpp`
- [Audio output](https://github.com/paky76/paky76-esp32-s3/tree/main/firmware): `firmware`
- [JARVIS assistant](https://github.com/paky76/paky76-esp32-s3/tree/main/firmware): `firmware`
- **Ollama models**

### Electronics platform

- [RTC and backup](https://github.com/paky76/paky76-esp32-s3/blob/main/hardware/prototipi/revf-d1/KiCad/Paky76-RevF.kicad_sch): `hardware/prototipi/revf-d1/KiCad/Paky76-RevF.kicad_sch`
- [Rev.F electronics](https://github.com/paky76/paky76-esp32-s3/blob/main/hardware/prototipi/revf-d1/KiCad/Paky76-RevF.kicad_pcb): `hardware/prototipi/revf-d1/KiCad/Paky76-RevF.kicad_pcb`
- [Peripheral interfaces](https://github.com/paky76/paky76-esp32-s3/blob/main/hardware/prototipi/revf-d1/Cablaggio-Periferiche.md): `hardware/prototipi/revf-d1/Cablaggio-Periferiche.md`
- [Speaker](https://github.com/paky76/paky76-esp32-s3/blob/main/hardware/prototipi/revf-d1/Cablaggio-Periferiche.md): `hardware/prototipi/revf-d1/Cablaggio-Periferiche.md`

### Physical design

- [D1 enclosure](https://github.com/paky76/paky76-esp32-s3/blob/main/hardware/prototipi/revd-d1/Stampa-3D/Paky76-D1.scad): `hardware/prototipi/revd-d1/Stampa-3D/Paky76-D1.scad`

### Other components

- **User**

## Connections

- ESP32 bring-up → Wi-Fi station: starts station (evidence: `firmware/src/main.cpp`)
- ESP32 bring-up → BLE advertising: starts advertising (evidence: `firmware/src/main.cpp`)
- ESP32 bring-up → Animated display: initializes and draws (evidence: `firmware/src/main.cpp`)
- User → Controls and menu: operates (evidence: `README.md`)
- Controls and menu → Offline commands: selects commands (evidence: `README.md`)
- User → Italian voice input: speaks commands (evidence: `README.md`)
- Italian voice input → Offline commands: triggers actions (evidence: `README.md`)
- Offline commands → Animated display: updates expression (evidence: `README.md`)
- Offline commands → Audio output: plays local sounds (evidence: `README.md`)
- Wi-Fi station → JARVIS assistant: connects over LAN (evidence: `README.md`)
- JARVIS assistant → Ollama models: uses models (evidence: `README.md`)
- JARVIS assistant → Audio output: returns spoken response (evidence: `README.md`)
- SPI camera → Peripheral interfaces: shares J7 bus (evidence: `README.md`)
- Removable microSD → Peripheral interfaces: shares J7 bus (evidence: `README.md`)
- Removable microSD → ESP32 bring-up: stores compatible files (evidence: `README.md`)
- Rev.F electronics → Peripheral interfaces: provides connections (evidence: `README.md`)
- Rev.F electronics → RTC and backup: includes RTC (evidence: `README.md`)
- Rev.F electronics → D1 enclosure: fits D1 prototype (evidence: `README.md`)
- Peripheral interfaces → Speaker: connects speaker (evidence: `README.md`)
