Skip to content

cifertech/nRFBox

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

41 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

logo

nRFBOX

All-in-One Gadget for BLE and 2.4GHz Networks

cifertech - nrfbox GitHub Downloads (all assets, all releases) stars - nrfbox forks - nrfbox


 

📖 Explore the Full Documentation

Ready to dive deeper into nRFBOX's details? Discover the full story, in-depth tutorials, and all the exciting features in our comprehensive documentation. Click the link and explore further!

 

⚠ Future Changes

  • Optimizations: Improve the efficiency of the scanning and jamming algorithms.
  • Additional Features: Add support for more wireless protocols and enhance spoofing capabilities.
  • User Interface: Develop a more user-friendly interface with enhanced display graphics and easier navigation.
 

🌟 About the Project

nRFBOX is a wireless toolkit designed to explore, analyze, and interact with various wireless communication protocols. It combines the ESP32 Wroom32U, NRF24 modules, an OLED display, and other components to create a multifunctional device that can act as a scanner, analyzer, jammer, BLE jammer, BLE spoofer, and perform advanced tasks such as the "Sour Apple" attack.

screenshot
 

🎯 Features

Software:

  • Scanner: Scans the 2.4GHz frequency band to detect active channels and devices.
  • Analyzer: Analyzes the detected signals and provides detailed information about the activity.
  • Jammer: Jams wireless communication on selected channels to test network robustness.
  • BLE Jammer: Specifically targets Bluetooth Low Energy (BLE) devices to disrupt their communication.
  • BLE Spoofer: Spoofs BLE devices to simulate various BLE signals for testing and research.
  • Sour Apple: A specialized attack for testing security measures against specific wireless vulnerabilities.

Hardware:

  • ESP32 Wroom32U
  • NRF24 GTmini Modules
  • OLED 0.96" Display
 

👀 nRFBOX V2

screenshot

👀 nRFBOX V1

screenshot
 

Uploading the Firmware (.bin) to ESP32

If you prefer not to upload the code manually or encounter errors during compilation, you can directly upload the precompiled .bin file to the ESP32. Follow these steps:

Step 1: Download the Required Tools

  1. ESP32 Flash Download Tool: Download the tool from Espressif's official site: ESP32 Flash Download Tool.
  2. USB Drivers: Make sure the drivers for the ESP32 are installed on your system. You can download the drivers from CP210x USB to UART Bridge VCP Drivers if you're using the CP2102 chip.

Step 2: Prepare the .bin File

  1. Download the precompiled .bin file from the repository.

Step 3: Upload the .bin File to ESP32

  1. Connect your ESP32 to your computer using a USB cable.

  2. Open the ESP32 Flash Download Tool and configure the following:

    • Select the appropriate chip type (ESP32) and click OK.
    • In the Download Path Config section, add the .bin file and set the start address to 0x1000.
    • Select the correct COM port where your ESP32 is connected.
    • Choose the correct Baud rate (115200 is generally recommended).
  3. Click on Start to begin uploading the .bin file to your ESP32.

Step 4: Verify the Upload

Once the upload is completed, the tool will confirm a successful flash. You can now restart your ESP32 and run the firmware.

 

⚠️ License

Distributed under the MIT License. See LICENSE.txt for more information.

 

🤝 Contact

▶ Support me on Patreon patreon.com/cifertech

CiferTech - @twitter - CiferTech@gmali.com

Project Link: https://github.com/cifertech/nRFBOX

 

💎 Acknowledgements

The libraries and projects listed below are used in this software:

Community Contributors: Thank you to everyone who contributes to this project and helps improve nRFBOX.