Flipper Zero
If at any moment you need further guidance, consider joining the discord server.
- Summary
- 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 has the option to attach different peripherals to it's GPIO headers. One such option is the ESP32-S2 Development Board which provides the Flipper Zero with the hardware required for WiFi capabilities. The Marauder firmware can be installed on the ESP32-S2 either via prebuilt firmware binary uploaded over-the-air(OTA) or via configured source build and upload. For either process, it will be assumed the connection between your PC and your WiFi dev board is "direct" i.e. you are not using the Flipper Zero USB-to-UART bridge. Once the install is complete however, you will be required to use the Flipper Zero USB-to-UART bridge.
It is recommended to use the Flasher Script option if you choose "Blue Pill" as this is the quickest and most direct method for installing the Marauder firmware on your WiFi Dev Board
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.