Home > Devices > Biscuit DIY

Biscuit DIY

The Biscuit DIY lets you build your own Biscuit using off-the-shelf ESP32-C5 development boards. It runs the same scanner firmware as the Pro and Ultra, giving you access to the full set of WiFi and Bluetooth tools from the Biscuit Manager app.

Setup Guide

You can flash the firmware using the web flasher at flasher.biscuitshop.us (browser-based, no install required).

If you prefer to flash manually using your own tool, the raw .bin files and partition offsets are available on the Web Flasher GitHub Releases page.

To put your board into flash mode:

  1. Connect the board to your computer via USB
  2. Hold the BOOT button
  3. While holding BOOT, press and release the RESET button
  4. Release the BOOT button

The board is now in bootloader mode and ready to receive firmware.

After flashing, press the RESET button or power-cycle the board to boot into the new firmware.

First Connection

Once the firmware is flashed and the board is powered on, the connection process is the same as any other Biscuit device:

  1. Install the Biscuit Manager app on your phone (iOS / Android)
  2. Grant Bluetooth and Location permissions when prompted
  3. The app will scan for nearby devices – tap yours to connect
  4. The app syncs time automatically and displays device info on the Dashboard

For the full step-by-step walkthrough, see the First Connection Guide.

Single-Chip Design

Unlike the Pro and Ultra which use two chips (WROOM + C5), the DIY runs on a single ESP32-C5. This means the C5 handles everything – WiFi scanning, Bluetooth scanning, attacks, and the BLE connection to your phone – all on one chip.

Supported Boards

Any ESP32-C5 board with 8 MB flash is compatible. The following boards are officially supported:

  • Espressif ESP32-C5 DevKit — SD Card: Confirmed Working
  • LilyGo T-Dongle C5 — SD Card: Confirmed Working — Buy from LilyGo (use code GHOSTSTRATS for 5% off)
  • Waveshare ESP32-C5 — SD Card: Confirmed Working — Buy on Amazon
  • Seeed Studio XIAO ESP32-C5 — SD Card: Testing / Beta — Buy from Seeed Studio

AWOK Dual C5 (Preassembled)

The AWOK Dual C5 boards from Awok Dynamics are preassembled, ready-to-use Biscuit DIY hardware — flash the firmware and connect. Two variants:

  • AWOK Dual C5 Touch — full-size variant with a built-in touchscreen — no SD card slot
  • AWOK Dual C5 Mini — compact form factor — no SD card slot

To flash either one, open the web flasher, select AWOK Dual C5 Touch or AWOK Dual C5 Mini from the device picker, and follow the prompts. Once connected over Bluetooth the Biscuit Manager app will show the matching board name and icon.

Because neither AWOK variant has an SD card slot, features that require SD storage (Evil Portal HTML templates and credentials, PCAP file storage) are not available on these boards. Everything else — wardriving, scanning, attacks, OTA updates — works the same as the other DIY boards.

Full Feature Set

The DIY supports all core Biscuit capabilities:

  • All WiFi scanning modes (AP scan, station scan, beacon/probe/deauth sniffing)
  • All WiFi attacks (deauth, beacon spam, association flood, and more)
  • All Bluetooth scanning (BLE devices, AirTags, Flipper Zeros, skimmers, drones)
  • All Bluetooth attacks (Sour Apple, Swiftpair, Samsung, Google, Flipper spam)
  • Wardriving with GPS mapping
  • Evil Portal (requires SD card)
  • Channel analyzer
  • Mesh recon (Zigbee, Thread, Matter scanning)
  • Drone detection
  • OTA firmware updates

What’s Different from Pro/Ultra

No Dedicated BLE Gateway

Some dual MCU operations are not supported as the DIY is only a single module. Such as wardrive ALL (WiFi and BLE simultaneously).

No Battery Monitoring

The DIY has no battery level monitoring hardware, so battery percentage and runtime estimates are not available in the app. If you’re running off a battery pack, you’ll need to track charge level separately.

SD Card Required for Some Features

Evil Portal HTML templates and credentials must be stored on an SD card (the Pro stores these on the WROOM’s external flash). If your board has an SD card slot or you wire one up, portal features work identically to the Ultra.

Device settings — your custom name and LED preferences — persist on the C5 itself, so they survive cold boots and SD card swaps without needing the card present.

Wardriving Limitations

The Pro and Ultra models feature dual radios, enabling “Wardrive All” mode (WiFi and Bluetooth simultaneously). Because the DIY relies on a single chip, it can only wardrive WiFi or Bluetooth at one time.

Cannot Act as Mesh Wardrive Hub

The DIY cannot serve as a hub for Biscuit Node mesh wardriving. The hub role requires the WROOM chip’s dedicated wireless radio, which the single-chip DIY does not have.

SD Card Setup

If your board has a built-in SD card slot (such as the LilyGo T-Dongle C5), simply insert a FAT32-formatted microSD card. For boards without a built-in slot, you can wire an SPI SD card module to your board’s SPI pins.

The SD card is used for:

  • Evil Portal HTML templates and captured credentials
  • PCAP file storage

Device settings (custom name, LED preferences) are stored on the C5 itself and do not require an SD card.

SD Card Pinout & Wiring

When wiring an SD card module manually, make sure to connect your SPI SD module’s VCC to 3.3V and GND to GND. Use the pinouts below to connect the remaining SPI pins for your specific board.

Espressif ESP32-C5 DevKit

  • CS: Pin 10
  • MISO: Pin 2
  • MOSI: Pin 7
  • SCK: Pin 6

LilyGo T-Dongle C5

  • CS: Pin 23
  • MISO: Pin 7
  • MOSI: Pin 2
  • SCK: Pin 6

Waveshare ESP32-C5

(Uses FSPI bus)

  • CS: Pin 10
  • MISO: Pin 8
  • MOSI: Pin 5
  • SCK: Pin 4

Seeed Studio XIAO ESP32-C5

(Currently in Beta)

  • CS: Pin 12
  • MISO: Pin 9
  • MOSI: Pin 10
  • SCK: Pin 8

Getting Firmware

DIY boards receive firmware updates over the air, just like the Pro and Ultra. See Firmware Updates for instructions on initial flashing and subsequent OTA updates.