# emenstanougat/esp32-bluejammer architecture

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

- Interactive diagram: https://gitdiagram.com/emenstanougat/esp32-bluejammer
- Repository: https://github.com/emenstanougat/esp32-bluejammer

## Overview

This repository is a hardware-and-firmware distribution for the ESP32-BlueJammer, not a source-code project: it provides prebuilt firmware images, bootloader/partition binaries, enclosure models, and build guidance. The documented user workflow is to choose a firmware mode, flash the device, then observe or switch modes using the OLED, LED, and Boot button where supported. Firmware variants cover Bluetooth, BLE, Wi-Fi, RC, and combinations; the README also describes PCB and enclosure options. No source excerpts were supplied, so internal firmware behavior and most binary-to-hardware relationships remain undocumented here.

Main entry points: [`README.md`](https://github.com/emenstanougat/esp32-bluejammer/blob/main/README.md) (ESP32 device), [`Firmware_Files/Generic`](https://github.com/emenstanougat/esp32-bluejammer/tree/main/Firmware_Files/Generic) (Mode selection), [`Firmware_Files/Bootloader&Partitions`](https://github.com/emenstanougat/esp32-bluejammer/tree/main/Firmware_Files/Bootloader%26Partitions) (Boot and partitions), [`Firmware_Files/OLED`](https://github.com/emenstanougat/esp32-bluejammer/tree/main/Firmware_Files/OLED) (OLED images)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_firmware["Firmware images"]
  node_mode_choice["Mode selection"]
  node_generic_images["Generic images"]
  node_oled_images["OLED images"]
  node_official_image["Official combo image"]
  node_flipper_image["Flipper Zero image"]
  node_boot_parts["Boot and partitions"]
end

subgraph group_hardware["Device hardware"]
  node_flasher["Firmware flashing<br/>[README.md]"]
  node_esp32["ESP32 device<br/>[README.md]"]
  node_rf_modules["RF modules<br/>[README.md]"]
  node_oled["OLED and indicators<br/>[README.md]"]
  node_pcb["PCB designs<br/>[README.md]"]
end

subgraph group_enclosures["Enclosure models"]
  node_rf_case["RF PCB cases"]
  node_ebyte_case["Ebyte PCB case"]
  node_perfboard_case["Perfboard cases"]
end

node_builder(("Device builder"))

node_builder -->|"chooses mode"| node_mode_choice
node_mode_choice -->|"selects image"| node_generic_images
node_mode_choice -->|"selects image"| node_oled_images
node_builder -->|"flashes firmware"| node_flasher
node_flasher -.->|"loads image"| node_esp32
node_builder -.->|"may choose"| node_official_image
node_builder -.->|"may choose"| node_flipper_image
node_boot_parts -.->|"supports boot"| node_esp32
node_esp32 -->|"uses radio modules"| node_rf_modules
node_esp32 -->|"drives display"| node_oled
node_builder -->|"assembles hardware"| node_pcb
node_pcb -->|"fits enclosure"| node_rf_case
node_pcb -.->|"fits enclosure"| node_ebyte_case
node_builder -.->|"may use"| node_perfboard_case

click node_mode_choice "https://github.com/emenstanougat/esp32-bluejammer/tree/main/Firmware_Files/Generic"
click node_generic_images "https://github.com/emenstanougat/esp32-bluejammer/tree/main/Firmware_Files/Generic"
click node_oled_images "https://github.com/emenstanougat/esp32-bluejammer/tree/main/Firmware_Files/OLED"
click node_official_image "https://github.com/emenstanougat/esp32-bluejammer/blob/main/Firmware_Files/Official/Official-Combo-Channel_BT-BLE-WiFi-RC.ino.bin"
click node_flipper_image "https://github.com/emenstanougat/esp32-bluejammer/blob/main/Firmware_Files/FlipperZero_Firmware-ZeroWave/FlipperZeroFirmware.ino.bin"
click node_boot_parts "https://github.com/emenstanougat/esp32-bluejammer/tree/main/Firmware_Files/Bootloader%26Partitions"
click node_flasher "https://github.com/emenstanougat/esp32-bluejammer/blob/main/README.md"
click node_esp32 "https://github.com/emenstanougat/esp32-bluejammer/blob/main/README.md"
click node_rf_modules "https://github.com/emenstanougat/esp32-bluejammer/blob/main/README.md"
click node_oled "https://github.com/emenstanougat/esp32-bluejammer/blob/main/README.md"
click node_pcb "https://github.com/emenstanougat/esp32-bluejammer/blob/main/README.md"
click node_rf_case "https://github.com/emenstanougat/esp32-bluejammer/tree/main/3D%20files/ESP32-RF_DIY-PCB_enclosure"
click node_ebyte_case "https://github.com/emenstanougat/esp32-bluejammer/tree/main/3D%20files/ESP32-RF_Ebyte_DIY-PCB_enclosure"
click node_perfboard_case "https://github.com/emenstanougat/esp32-bluejammer/tree/main/3D%20files/PerfboardBuild"

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_mode_choice,node_generic_images,node_oled_images,node_official_image,node_flipper_image,node_boot_parts toneBlue
class node_flasher,node_esp32,node_rf_modules,node_oled,node_pcb toneAmber
class node_rf_case,node_ebyte_case,node_perfboard_case toneMint
class node_builder toneIndigo
```

## Components

### Firmware images

- [Mode selection](https://github.com/emenstanougat/esp32-bluejammer/tree/main/Firmware_Files/Generic): `Firmware_Files/Generic`
- [Generic images](https://github.com/emenstanougat/esp32-bluejammer/tree/main/Firmware_Files/Generic): `Firmware_Files/Generic`
- [OLED images](https://github.com/emenstanougat/esp32-bluejammer/tree/main/Firmware_Files/OLED): `Firmware_Files/OLED`
- [Official combo image](https://github.com/emenstanougat/esp32-bluejammer/blob/main/Firmware_Files/Official/Official-Combo-Channel_BT-BLE-WiFi-RC.ino.bin): `Firmware_Files/Official/Official-Combo-Channel_BT-BLE-WiFi-RC.ino.bin`
- [Flipper Zero image](https://github.com/emenstanougat/esp32-bluejammer/blob/main/Firmware_Files/FlipperZero_Firmware-ZeroWave/FlipperZeroFirmware.ino.bin): `Firmware_Files/FlipperZero_Firmware-ZeroWave/FlipperZeroFirmware.ino.bin`
- [Boot and partitions](https://github.com/emenstanougat/esp32-bluejammer/tree/main/Firmware_Files/Bootloader%26Partitions): `Firmware_Files/Bootloader&Partitions`

### Device hardware

- [Firmware flashing](https://github.com/emenstanougat/esp32-bluejammer/blob/main/README.md): `README.md`
- [ESP32 device](https://github.com/emenstanougat/esp32-bluejammer/blob/main/README.md): `README.md`
- [RF modules](https://github.com/emenstanougat/esp32-bluejammer/blob/main/README.md): `README.md`
- [OLED and indicators](https://github.com/emenstanougat/esp32-bluejammer/blob/main/README.md): `README.md`
- [PCB designs](https://github.com/emenstanougat/esp32-bluejammer/blob/main/README.md): `README.md`

### Enclosure models

- [RF PCB cases](https://github.com/emenstanougat/esp32-bluejammer/tree/main/3D%20files/ESP32-RF_DIY-PCB_enclosure): `3D files/ESP32-RF_DIY-PCB_enclosure`
- [Ebyte PCB case](https://github.com/emenstanougat/esp32-bluejammer/tree/main/3D%20files/ESP32-RF_Ebyte_DIY-PCB_enclosure): `3D files/ESP32-RF_Ebyte_DIY-PCB_enclosure`
- [Perfboard cases](https://github.com/emenstanougat/esp32-bluejammer/tree/main/3D%20files/PerfboardBuild): `3D files/PerfboardBuild`

### Other components

- **Device builder**

## Connections

- Device builder → Mode selection: chooses mode (evidence: `README.md`)
- Mode selection → Generic images: selects image (evidence: `README.md`)
- Mode selection → OLED images: selects image (evidence: `README.md`)
- Device builder → Firmware flashing: flashes firmware (evidence: `README.md`)
- Firmware flashing → ESP32 device: loads image
- Device builder → Official combo image: may choose
- Device builder → Flipper Zero image: may choose
- Boot and partitions → ESP32 device: supports boot
- ESP32 device → RF modules: uses radio modules (evidence: `README.md`)
- ESP32 device → OLED and indicators: drives display (evidence: `README.md`)
- Device builder → PCB designs: assembles hardware (evidence: `README.md`)
- PCB designs → RF PCB cases: fits enclosure (evidence: `README.md`)
- PCB designs → Ebyte PCB case: fits enclosure
- Device builder → Perfboard cases: may use
