# antonbronnfjell/project-esp32-embedsyst-cpp_ble-jammer-nrf24l01 architecture

> Architecture diagram of the GitHub repository antonbronnfjell/project-esp32-embedsyst-cpp_ble-jammer-nrf24l01, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/antonbronnfjell/project-esp32-embedsyst-cpp_ble-jammer-nrf24l01
- Repository: https://github.com/antonbronnfjell/project-esp32-embedsyst-cpp_ble-jammer-nrf24l01

## Overview

This ESP32-S3 firmware provides button-controlled RF transmission modes using two NRF24 radios and WiFi, with LED status and a BLE discovery capability. The main firmware is a monolith: it handles button events, dispatches mode routines, and configures the transmitters. The graph separates its documented modes to show their distinct behaviors, not separate source modules. Source excerpts show the mode dispatch, radio operations, WiFi setup, BLE scan, and encoder interface; the RF24 driver is an external submodule whose internals are not shown.

Main entry points: [`main/jammer_main.cpp`](https://github.com/antonbronnfjell/project-esp32-embedsyst-cpp_ble-jammer-nrf24l01/blob/main/main/jammer_main.cpp) (Jammer controller), [`main/led_strip_encoder.c`](https://github.com/antonbronnfjell/project-esp32-embedsyst-cpp_ble-jammer-nrf24l01/blob/main/main/led_strip_encoder.c) (RMT LED encoder)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_controls["Controls and status"]
  node_button["GPIO 35 button<br/>[jammer_main.cpp]"]
  node_led["Mode LED<br/>[jammer_main.cpp]"]
  node_encoder["RMT LED encoder"]
end

subgraph group_coordination["Jammer coordination"]
  node_controller["Jammer controller<br/>[jammer_main.cpp]"]
end

subgraph group_transmission["Transmission modes"]
  node_barrage["Barrage and storm<br/>[jammer_main.cpp]"]
  node_hybrid["ADV barrage and tracking<br/>[jammer_main.cpp]"]
  node_btclassic["BT Classic sweep<br/>[jammer_main.cpp]"]
  node_bleall["BLE all channels<br/>[jammer_main.cpp]"]
  node_bleadv["BLE advertising<br/>[jammer_main.cpp]"]
  node_blesiege["BLE siege<br/>[jammer_main.cpp]"]
  node_carrier["Constant carrier<br/>[jammer_main.cpp]"]
end

subgraph group_discovery["Discovery and hardware"]
  node_nrf["Dual NRF24 radios"]
  node_wifi["WiFi raw TX<br/>[jammer_main.cpp]"]
  node_ble_scan["BLE discovery scan<br/>[jammer_main.cpp]"]
  node_rf_test["RF channel test<br/>[jammer_main.cpp]"]
end

node_operator(("Operator"))

node_operator -->|"presses"| node_button
node_button -->|"reports events"| node_controller
node_controller -->|"dispatches"| node_barrage
node_controller -->|"dispatches"| node_hybrid
node_controller -->|"dispatches"| node_btclassic
node_controller -->|"dispatches"| node_bleall
node_controller -->|"dispatches"| node_bleadv
node_controller -->|"dispatches"| node_blesiege
node_controller -->|"dispatches"| node_carrier
node_barrage -->|"retunes"| node_nrf
node_hybrid -->|"retunes"| node_nrf
node_btclassic -->|"sweeps channels"| node_nrf
node_bleall -->|"cycles channels"| node_nrf
node_bleadv -->|"cycles channels"| node_nrf
node_blesiege -->|"hops channels"| node_nrf
node_carrier -->|"sets carrier"| node_nrf
node_controller -->|"updates status"| node_led
node_led -->|"uses encoding"| node_encoder
node_controller -->|"initializes"| node_wifi
node_controller -->|"scans nearby"| node_ble_scan
node_controller -->|"tests channels"| node_rf_test

click node_button "https://github.com/antonbronnfjell/project-esp32-embedsyst-cpp_ble-jammer-nrf24l01/blob/main/main/jammer_main.cpp"
click node_led "https://github.com/antonbronnfjell/project-esp32-embedsyst-cpp_ble-jammer-nrf24l01/blob/main/main/jammer_main.cpp"
click node_encoder "https://github.com/antonbronnfjell/project-esp32-embedsyst-cpp_ble-jammer-nrf24l01/blob/main/main/led_strip_encoder.c"
click node_controller "https://github.com/antonbronnfjell/project-esp32-embedsyst-cpp_ble-jammer-nrf24l01/blob/main/main/jammer_main.cpp"
click node_barrage "https://github.com/antonbronnfjell/project-esp32-embedsyst-cpp_ble-jammer-nrf24l01/blob/main/main/jammer_main.cpp"
click node_hybrid "https://github.com/antonbronnfjell/project-esp32-embedsyst-cpp_ble-jammer-nrf24l01/blob/main/main/jammer_main.cpp"
click node_btclassic "https://github.com/antonbronnfjell/project-esp32-embedsyst-cpp_ble-jammer-nrf24l01/blob/main/main/jammer_main.cpp"
click node_bleall "https://github.com/antonbronnfjell/project-esp32-embedsyst-cpp_ble-jammer-nrf24l01/blob/main/main/jammer_main.cpp"
click node_bleadv "https://github.com/antonbronnfjell/project-esp32-embedsyst-cpp_ble-jammer-nrf24l01/blob/main/main/jammer_main.cpp"
click node_blesiege "https://github.com/antonbronnfjell/project-esp32-embedsyst-cpp_ble-jammer-nrf24l01/blob/main/main/jammer_main.cpp"
click node_carrier "https://github.com/antonbronnfjell/project-esp32-embedsyst-cpp_ble-jammer-nrf24l01/blob/main/main/jammer_main.cpp"
click node_wifi "https://github.com/antonbronnfjell/project-esp32-embedsyst-cpp_ble-jammer-nrf24l01/blob/main/main/jammer_main.cpp"
click node_ble_scan "https://github.com/antonbronnfjell/project-esp32-embedsyst-cpp_ble-jammer-nrf24l01/blob/main/main/jammer_main.cpp"
click node_rf_test "https://github.com/antonbronnfjell/project-esp32-embedsyst-cpp_ble-jammer-nrf24l01/blob/main/main/jammer_main.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_button,node_led,node_encoder toneBlue
class node_controller toneAmber
class node_barrage,node_hybrid,node_btclassic,node_bleall,node_bleadv,node_blesiege,node_carrier toneMint
class node_nrf,node_wifi,node_ble_scan,node_rf_test toneRose
class node_operator toneIndigo
```

## Components

### Controls and status

- [GPIO 35 button](https://github.com/antonbronnfjell/project-esp32-embedsyst-cpp_ble-jammer-nrf24l01/blob/main/main/jammer_main.cpp): `main/jammer_main.cpp`
- [Mode LED](https://github.com/antonbronnfjell/project-esp32-embedsyst-cpp_ble-jammer-nrf24l01/blob/main/main/jammer_main.cpp): `main/jammer_main.cpp`
- [RMT LED encoder](https://github.com/antonbronnfjell/project-esp32-embedsyst-cpp_ble-jammer-nrf24l01/blob/main/main/led_strip_encoder.c): `main/led_strip_encoder.c`

### Jammer coordination

- [Jammer controller](https://github.com/antonbronnfjell/project-esp32-embedsyst-cpp_ble-jammer-nrf24l01/blob/main/main/jammer_main.cpp): `main/jammer_main.cpp`

### Transmission modes

- [Barrage and storm](https://github.com/antonbronnfjell/project-esp32-embedsyst-cpp_ble-jammer-nrf24l01/blob/main/main/jammer_main.cpp): `main/jammer_main.cpp`
- [ADV barrage and tracking](https://github.com/antonbronnfjell/project-esp32-embedsyst-cpp_ble-jammer-nrf24l01/blob/main/main/jammer_main.cpp): `main/jammer_main.cpp`
- [BT Classic sweep](https://github.com/antonbronnfjell/project-esp32-embedsyst-cpp_ble-jammer-nrf24l01/blob/main/main/jammer_main.cpp): `main/jammer_main.cpp`
- [BLE all channels](https://github.com/antonbronnfjell/project-esp32-embedsyst-cpp_ble-jammer-nrf24l01/blob/main/main/jammer_main.cpp): `main/jammer_main.cpp`
- [BLE advertising](https://github.com/antonbronnfjell/project-esp32-embedsyst-cpp_ble-jammer-nrf24l01/blob/main/main/jammer_main.cpp): `main/jammer_main.cpp`
- [BLE siege](https://github.com/antonbronnfjell/project-esp32-embedsyst-cpp_ble-jammer-nrf24l01/blob/main/main/jammer_main.cpp): `main/jammer_main.cpp`
- [Constant carrier](https://github.com/antonbronnfjell/project-esp32-embedsyst-cpp_ble-jammer-nrf24l01/blob/main/main/jammer_main.cpp): `main/jammer_main.cpp`

### Discovery and hardware

- **Dual NRF24 radios**
- [WiFi raw TX](https://github.com/antonbronnfjell/project-esp32-embedsyst-cpp_ble-jammer-nrf24l01/blob/main/main/jammer_main.cpp): `main/jammer_main.cpp`
- [BLE discovery scan](https://github.com/antonbronnfjell/project-esp32-embedsyst-cpp_ble-jammer-nrf24l01/blob/main/main/jammer_main.cpp): `main/jammer_main.cpp`
- [RF channel test](https://github.com/antonbronnfjell/project-esp32-embedsyst-cpp_ble-jammer-nrf24l01/blob/main/main/jammer_main.cpp): `main/jammer_main.cpp`

### Other components

- **Operator**

## Connections

- Operator → GPIO 35 button: presses (evidence: `README.md`)
- GPIO 35 button → Jammer controller: reports events (evidence: `main/jammer_main.cpp`)
- Jammer controller → Barrage and storm: dispatches (evidence: `main/jammer_main.cpp`)
- Jammer controller → ADV barrage and tracking: dispatches (evidence: `main/jammer_main.cpp`)
- Jammer controller → BT Classic sweep: dispatches (evidence: `main/jammer_main.cpp`)
- Jammer controller → BLE all channels: dispatches (evidence: `main/jammer_main.cpp`)
- Jammer controller → BLE advertising: dispatches (evidence: `main/jammer_main.cpp`)
- Jammer controller → BLE siege: dispatches (evidence: `main/jammer_main.cpp`)
- Jammer controller → Constant carrier: dispatches (evidence: `main/jammer_main.cpp`)
- Barrage and storm → Dual NRF24 radios: retunes (evidence: `main/jammer_main.cpp`)
- ADV barrage and tracking → Dual NRF24 radios: retunes (evidence: `README.md`)
- BT Classic sweep → Dual NRF24 radios: sweeps channels (evidence: `README.md`)
- BLE all channels → Dual NRF24 radios: cycles channels (evidence: `README.md`)
- BLE advertising → Dual NRF24 radios: cycles channels (evidence: `README.md`)
- BLE siege → Dual NRF24 radios: hops channels (evidence: `README.md`)
- Constant carrier → Dual NRF24 radios: sets carrier (evidence: `README.md`)
- Jammer controller → Mode LED: updates status (evidence: `README.md`)
- Mode LED → RMT LED encoder: uses encoding (evidence: `main/jammer_main.cpp`)
- Jammer controller → WiFi raw TX: initializes (evidence: `main/jammer_main.cpp`)
- Jammer controller → BLE discovery scan: scans nearby (evidence: `main/jammer_main.cpp`)
- Jammer controller → RF channel test: tests channels (evidence: `main/jammer_main.cpp`)
