# mxtiv/bluejammer architecture

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

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

## Overview

BlueJammer is an ESP32-based educational wireless-interference device, documented as using an NRF24L01+ radio and an optional switch for changing modes. The available files contain no source excerpts, so this map is limited to capabilities and hardware relationships stated in the README; internal firmware stages and runtime call paths cannot be verified.

Main entry points: [`BlueJammer.ino`](https://github.com/mxtiv/bluejammer/blob/main/BlueJammer.ino) (BlueJammer firmware)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_device["Device"]
  node_firmware["BlueJammer firmware<br/>[BlueJammer.ino]"]
  node_switch["Mode switch"]
end

subgraph group_radio["Radio interface"]
  node_rf24["RF24 library"]
  node_transceiver["NRF24L01+"]
end

node_user(("Operator"))
node_spectrum(("2.4 GHz environment"))

node_user -->|"changes mode"| node_switch
node_firmware -->|"uses library"| node_rf24
node_rf24 -->|"communicates with"| node_transceiver
node_transceiver -->|"operates in"| node_spectrum

click node_firmware "https://github.com/mxtiv/bluejammer/blob/main/BlueJammer.ino"

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_switch toneBlue
class node_rf24,node_transceiver toneAmber
class node_user,node_spectrum toneIndigo
```

## Components

### Device

- [BlueJammer firmware](https://github.com/mxtiv/bluejammer/blob/main/BlueJammer.ino): `BlueJammer.ino`
- **Mode switch**

### Radio interface

- **RF24 library**
- **NRF24L01+**

### Other components

- **Operator**
- **2.4 GHz environment**

## Connections

- Operator → Mode switch: changes mode (evidence: `README.md`)
- BlueJammer firmware → RF24 library: uses library (evidence: `README.md`)
- RF24 library → NRF24L01+: communicates with (evidence: `README.md`)
- NRF24L01+ → 2.4 GHz environment: operates in (evidence: `README.md`)
