Flipper Zero
If at any moment you need further guidance, consider joining the discord server.
- Introduction
- WiFi Dev Board Enclosure
- Firmware Install Options
- Don't have a dev board?
- Having Issues?
- Tethered Usage
- Untethered Usage
- SD Card Modification
- Patreon
- YouTube Video
- More Videos
- Next Steps
The Flipper Zero features a GPIO header on the top edge of it's body. This header is able to accommodate many different peripheral devices including ESP32 modules and development boards. Because of it's many available protocols, the Flipper Zero is able to communicate directly with the ESP32 Marauder firmware when it is properly installed on a compatible ESP32 expansion board. All that is requires is to install the ESP32 Marauder firmware on a compatible ESP32 development board, install the necessary application files on your Flipper Zero, connect your ESP32 development board to the Flipper Zero, and begin using the Marauder firmware features.
If you do not currently own a 3D printer and would like to purchase an enclosure for your WiFi Dev Board, I am currently selling them on our web store with multiple color and material options. If you are interested, check out the shop here.
/i/663561/products/2022-06-22T17%3A49%3A07.471Z-IMG_2245.JPG?1655894975)
/i/663561/products/2022-06-22T17%3A49%3A07.471Z-IMG_2242.JPG?1655894975)
/i/663561/products/2022-08-23T17%3A05%3A36.894Z-IMG_5955%20-%20Copy.jpg?1661249267)
| Blue pill | Red Pill |
|---|---|
| Really easy. Nothing to change, but you don't get any customization (which is fine). | This pill is the size of a large pumpkin and it goes in your ass. Install libraries, build from source, know everything |
| Spacehuhn Web Installer, FZ Marauder Flasher, FZEasyMarauderFlash, or Marauder OTA | Build from source |
Once you have installed the firmware, be sure to check what to do next.
This video by Lab 401 will provide instructions for using the flasher script. This is the quickest way to get Marauder running on your device
Once you install the Marauder firmware on the WiFi dev board, you can connect the dev board to the Flipper Zero GPIO header and connect the flipper to your PC or Android phone via USB cable.
On the Flipper Zero, navigate to GPIO>USB-UART Bridge. I keep my Bridge configured to use USB channel 0
If you don't have a dev board, you can learn how to make one here...
If you are having issues with your Marauder installation either with the install process or with the firmware usage, be sure to check if your issue has already been solved in FAQ. If not, feel free to join my Discord to request help from the community or submit an issue
Marauder can be used via its command-line interface supplemented by the Flipper Zero USB-to-UART bridge and a PC/Laptop. The goal is to eventually get the Flipper Zero to offer a bluetooth connection to facilitate a Serial-over-Bluetooth bridge to the WiFi Dev Board so everything can be done over mobile phone.
For tethered use, follow these steps...
- Connect your dev board to your flipper zero and power it on
- Connect your flipper zero to your PC/Mobile phone via USB-C
- On your flipper, open the USB-UART Bridge via the GPIO menu
- Configure the bridge to use USB channel 0 with baud 115200
- On your PC or mobile device, open a serial connection to the Flipper Zero with baud 115200
- Be sure to check what COM port your flipper zero is on so you know what to connect to
If you would like to use the Flipper Zero and it's WiFi dev board flashed with Marauder as a standalone unit without a PC or mobile phone attached, install any of the following 3rd party Flipper Zero firmwares on your device. They come prebuilt with the WiFi Marauder fap created by 0xchocolate.
Note: We now offer a dedicated SD adapter and SD/GPS adapter board for a clean install on the Flipper Zero WiFi Dev Board. No wires are necessary.
A MicroSD card can be attached to the Flipper Zero WiFi Dev Board SPI via a MicroSD Breakout. Attaching a microSD card to the Flipper Zero WiFi Dev Board will allow the Marauder firmware to save captured WiFi traffic to storage in the form of PCAP files to be exported for analysis later. If you install this mod, DO NOT use the flipper_sd_serial.bin to update your WiFi Dev Board. Refer to the following table for the required solder connections
| MicroSD Breakout | Flipper Zero WiFi Dev Board |
|---|---|
| VCC | 3V3 |
| GND | GND |
| DI (MOSI) | IO35 |
| DO (MISO) | IO37 |
| SCK | IO36 |
| CS | IO10 |
Once all of the solder connections have been made, a piece of double-sided tape can be used to fix the MicroSD Breakout Board to the back of the WiFi Development Board.
If you are looking to support me and my pursuit of shitty projects, consider heading over to my Patreon. It aint much and it's not very big around, but it'll get the job done.
The following video describes and demonstrates the installation and usage of the Marauder firmware on the Flipper Zero WiFi Dev Board.
If you're trying to figure out what to do now that you have Marauder installed on your Flipper Zero, consider reading Commandline for how to use the Marauder command line interface, and Workflow Examples to understand how to use some of the commands in a practical way.