Firmware Setup

The VoidRecon firmware is provided as a pre‑compiled binary (voidrecon.bin) – the easiest way to get started.
You can also build from source if you need to customise the code.

---

📥 Option 1: Flash the Pre‑compiled Binary (Recommended)

This method requires esptool.py – the official Espressif flashing tool.

1. Download the Binary

• Go to the Releases page.
• Download the latest voidrecon.bin.

2. Install esptool.py

pip install esptool

3. Connect Your ESP32

• Plug the board into your computer.
• Note the serial port:
  • Windows: COMx (e.g., COM3)
  • Linux/macOS: /dev/ttyUSB0 or /dev/ttyACM0

4. Erase Flash (Optional but Recommended)

esptool.py --port /dev/ttyUSB0 erase_flash

5. Flash the Binary

esptool.py --port /dev/ttyUSB0 --baud 460800 write_flash 0x1000 voidrecon.bin

Note: The start address 0x1000 is correct for most ESP32 combined binaries. If you encounter boot issues, try 0x0 or check the ESP32 documentation for your partition layout.

6. Reset and Test

• Press the EN (reset) button on the ESP32.
• Open a serial monitor (or use the Python CLI – see below) at 115200 baud.
• You should see the VoidRecon banner and the > prompt. Type help to verify.

---

🛠️ Option 2: Build from Source (Advanced)

If you prefer to compile the firmware yourself (e.g., to modify the code), the source is available in this repository. This is not required for normal operation.

Prerequisites

• PlatformIO (recommended) or Arduino IDE with ESP32 support
• Git (to clone the repository)

Steps

git clone https://github.com/wrait8/voidrecon.git
cd voidrecon

• Open the project in PlatformIO (or the .ino file in Arduino IDE).
• Select your ESP32 board (e.g., ESP32 Dev Module).
• Compile and upload.

---

💻 Interacting with VoidRecon

### A) Using the Python CLI Tool (Recommended)

The repository includes voidrecon-cli.py – a dedicated script that simplifies communication, handles baud rate, line endings, and offers extra features like logging and scripting.

Install Dependencies

pip install pyserial

Run the CLI

python voidrecon-cli.py --port /dev/ttyUSB0

Available Options

Option	Description
--port	Serial port (required)
--baud	Baud rate (default: 115200)
--log	Save session output to a file
--help	Show full usage

Once connected, you can type any VoidRecon command (e.g., help, setmhz 433.92, rx). The CLI will handle line endings and display responses cleanly.

B) Using a Generic Serial Terminal

If you prefer a manual approach, any terminal program will work:

Tool	Platform
PuTTY	Windows
screen	Linux/macOS
minicom	Linux
Arduino Serial Monitor	All (with 115200 baud)

Settings:

• Baud rate: 115200
• Data bits: 8
• Parity: None
• Stop bits: 1
• Flow control: None

After connecting, type help to list all commands.