Warning
This project is designed strictly for educational and research purposes to demonstrate RF security concepts and the vulnerabilities in wireless communications. Using this device for disrupting legitimate communications is illegal in most jurisdictions.
SpiritBox is an advanced BLE (Bluetooth Low Energy) and RF jammer built on the ESP32 platform with NRF24L01 modules. It leverages dual SPI bus architecture to efficiently target multiple frequency channels simultaneously, providing a comprehensive platform for wireless security research and testing.
- ๐ถ Dual Radio Operation: Utilizes two NRF24L01 modules operating on separate SPI buses
- ๐ Dynamic Channel Hopping: Implements both sequential and random channel selection algorithms
- ๐ Real-time Monitoring: OLED display shows current operational status and parameters
- ๐ Mode Selection: Hardware switch to toggle between different jamming patterns
- ๐ Low Power Design: Optimized for extended field operation with battery power
- ๐ฑ Portable Form Factor: Compact design for ease of deployment in laboratory environments
| Component | Quantity | Purpose |
|---|---|---|
| ๐ง ESP32 Dev Board | 1 | Main controller |
| ๐ก NRF24L01+ Modules | 2 | RF transmission |
| ๐บ SSD1306 OLED (128x32) | 1 | Status display |
| ๐ Toggle Switch | 1 | Mode selection |
| โก 3.3V Voltage Regulator | 1 | Power stabilization |
| ๐ 18650 Battery Holder | 1 | Power source |
| ๐ Capacitors (10ฮผF) | 2 | Power filtering |
- ๐ง Arduino IDE (1.8.x or later)
- ๐งฉ ESP32 Arduino Core
- ๐ Libraries:
- RF24 (by TMRh20)
- Adafruit GFX
- Adafruit SSD1306
- ezButton
- Install the Arduino IDE and ESP32 board support
- Install required libraries through the Library Manager
- Clone this repository:
git clone https://github.com/rubberpirate/spiritbox.git - Open the project in Arduino IDE
- Select "ESP32 Dev Module" from the Board menu
- Upload the sketch to your ESP32
- Systematically sweeps through the 2.4GHz band
- Predictable pattern for controlled testing
- Configurable delay between channel switches
- Unpredictable channel selection algorithm
- Variable timing between transmissions
- More effective against adaptive frequency-hopping systems
The OLED display shows:
- Current operating mode
- Active channels for both radios
- Transmission status
- Power level indicator
The following parameters can be modified in the code:
// Channel range (0-125)
#define MIN_CHANNEL 0
#define MAX_CHANNEL 83
// Power level (RF24_PA_MIN, RF24_PA_LOW, RF24_PA_HIGH, RF24_PA_MAX)
#define POWER_LEVEL RF24_PA_HIGH
// Transmission speed (RF24_250KBPS, RF24_1MBPS, RF24_2MBPS)
#define DATA_RATE RF24_1MBPS- ๐ Battery Life: Approximately 3-4 hours with an 18650 battery
- ๐ก Effective Range: 10-15 meters with standard antenna
- ๐ถ Channel Coverage: Up to 84 channels in the 2.4GHz spectrum
- โก Response Time: ~0.5ms channel switching speed
- ๐ WebSocket interface for remote control
- ๐ง Enhanced pattern recognition for targeted jamming
- ๐ Spectrum analyzer functionality
| Issue | Solution |
|---|---|
| ๐ก NRF modules not responding | Check SPI connections and power supply stability |
| ๐ถ Limited range | Verify antenna connection, try using an external antenna |
| ๐ Inconsistent operation | Add additional capacitors (10ฮผF) near NRF power pins |
| ๐ง ESP32 crashes | Reduce SPI speed or add delay between operations |
Contributions to this educational project are welcome. Please open an issue or submit a pull request with your improvements.
Important
โจ Remember: With great power comes great responsibility. Use this knowledge ethically. โจ