TwinWave - WiFi & Sub-GHz Module for Flipper Zero

// System Core

Capabilities

⚡ Compact Design

Plug directly into Flipper Zero's GPIO header. Designed for permanent attachment with compact form factor - compactness was the key motivation behind development.

📡 Dual Radio System

Wi-Fi 2.4 GHz (ESP32-PICO-V3-02) + Sub-GHz 433 MHz (TI CC1101) in one compact module.

🔧 Replaceable Antennas

2× SMA female connectors allow you to swap antennas for optimal performance in any scenario.

🛜 Marauder firmware

WiFi analysis, traffic monitoring, and wireless penetration testing with Marauder firmware.

⚙️ Independent Power Control

Micro switches for Wi-Fi and Sub-GHz radios. Save battery by disabling unused modules.

✨ Community Open Hardware

Transparent design with complete schematics and PCB files. Free to build, study, and customize for personal use.

// Visual Data

Media Archive

📷 Product Photos

Link Established

Top View

Without Case

Hardware Alpha

TwinWave PCB

Extended Antenna

// Signal Demonstration

Live Feed

// Technical Specs

Hardware Details

Parameter	Specification
Wi-Fi Radio	ESP32-PICO-V3-02 (2.4 GHz)
Sub-GHz Radio	TI CC1101 (433 MHz)
Antenna Connectors	2× SMA Female
Power Supply	3.3V via Flipper GPIO
Power Consumption (Sub-GHz)	20-40 mA
Power Consumption (Wi-Fi Idle)	~40 mA
Power Consumption (Wi-Fi Active)	125-330 mA
ESP32 Interface	UART/Serial via GPIO
CC1101 Interface	SPI Bus (shared with Flipper)
Firmware Support	Marauder v1.9.1 (ESP32 PICO port)
PCB Revision	v2.1

// Firmware Upload

Flash Instructions

To upload or update the ESP32 Marauder firmware, you need to connect via a USB-TTL (UART) adapter to the GPIO pin header on the bottom side of the TwinWave PCB.

🔌 UART Connection (10-pin header - bottom side)

Connect USB-TTL adapter (CP2102, CH340, FT232) to the 10-pin GPIO header on the bottom side of TwinWave PCB:

                        
                        Pin 1 (3V3) → VCC (3.3V only!)
                    
                        Pin 3 (GND) → GND
                    
                        Pin 5 (RX) → TX (adapter)
                    
                        Pin 6 (TX) → RX (adapter)

⚠️ Hold BOOT, press RESET, release both to enter flash mode.

Flashing Methods

⚡ Method 1: Web Flasher (Recommended)

Flash firmware directly from your browser — no installation required!

Connect USB-TTL adapter to TwinWave (see wiring diagram above)
Put ESP32 into boot mode (hold BOOT, press RESET, release both)
Open the Web Flasher and follow the wizard

🚀 Open Web Flasher

✓ Automatically downloads latest firmware • Supports custom firmware upload • Works in Chrome, Edge, Opera

💾 Method 2: esptool.py

Flash precompiled binaries using Python esptool

Install esptool: pip install esptool
Download firmware from Downloads and extract the ZIP
Run the flash command:
esptool.py --chip esp32 \ --port /dev/ttyUSB0 \ --baud 460800 write_flash -z \ 0x1000 bootloader.bin \ 0x8000 partitions.bin \ 0x10000 firmware.bin
Adjust port: /dev/cu.usbserial-* (macOS), COM3 (Windows)

🚀 Method 3: PlatformIO

Build and upload from source using PlatformIO IDE

Install PlatformIO IDE extension for VS Code
Clone the repository: git clone https://github.com/0xMartin/TwinWave
Open firmware/ folder in VS Code with PlatformIO
Connect USB-TTL adapter and enter flash mode (BOOT + RESET)
Click Upload button (→) in PlatformIO toolbar
PlatformIO will automatically compile and flash the firmware

✓ Recommended for development and custom modifications

WARNING: Always use 3.3V power supply. Using 5V will damage the ESP32 chip permanently!

// Production Files

Downloads

Download all necessary files for manufacturing your own TwinWave module from the latest GitHub release.

⚡ PCB Manufacturing

Gerber, BOM and Pick & Place files for PCB fabrication services (JLCPCB, PCBWay, etc.)

📄 Gerber_PCB_2026-01-06.zip 📄 BOM_TwinWave_PCB_2026-01-06.xlsx 📄 PickAndPlace_PCB_2026-01-06.xlsx

🖨️ 3D Printed Case

STL file for protective enclosure (single piece). Print with PLA, PETG or Resin material.

📄 TwinWave_3D_Shell.stl

💾 Marauder Firmware

Custom ESP32 Marauder port specifically compiled for TwinWave PCB (ESP32-PICO-V3-02).

Based on ESP32 Marauder by justcallmekoko

📄 MARAUDER-v1.9.1-ESP32-PICO-V3-02.zip

⚡ Web Flasher

🔧 Open Project in EasyEDA Pro

Download and install EasyEDA Pro (free PCB design software)
Clone or download the repository from GitHub
Locate the project file in the repository: hardware/ProDoc_TwinWave_2026-01-06.epro
Open EasyEDA Pro and select File → Open Project
Navigate to the .epro file and open it
The complete PCB project with schematic will be loaded and ready for editing or export

🌐 View Project on OSHWLab

The complete project is also available on OSHWLab for online viewing and direct ordering from PCB manufacturers.

📋 View on OSHWLab