The aim of this project is to port the ESP32-Marauder firmware to the Cheap Yellow Display (CYD), offering powerful WiFi and Bluetooth testing features on an affordable and accessible hardware platform.
- Added compatibility for ESP32-2432S024R 2.4" Resistive Touch USB Type-C Only
- Flash older Marauder firmware versions
- Guide for antenna modification using ESP-WROOM-32U with built-in IPEX/U.FL connector
- Evil Portal examples and setup
- How to add an external antenna
- A compatible CYD module (see Compatibility)
- Chrome browser
- Data-capable USB cable
- (Optional) GPS module for enhanced functionality
- Go to the CYM Web Flasher
- Click "Connect" and select your device
- Choose the appropriate Model and Version
- Click "Program" to start flashing
If issues arise, try the following steps:
- Unplug and restart your CYD module
- Hold
RST, tapBOOT, releaseRST(the screen should go blank) - Refresh the Web Flasher page and click "Connect"
- If problems persist, hold
BOOTwhile clicking "Connect"
For further details, check out the Web Flasher repository.
- Set up your Arduino environment following the ESP32 Marauder Arduino IDE Setup Guide.
- Add the necessary libraries to your Arduino libraries folder.
- Set the upload speed to
115200in the Arduino IDE (tested on version 1.8.19). - Upload the firmware to your CYD module.
For a step-by-step guide, refer to Smoochiee's tutorial.
The project has been successfully tested on:
No hardware modifications are required, thanks to @ggaljoen's fork of the TFT_eSPI library.
GPS functionality is fully supported via the 4-pin connector near the MicroUSB port. For a list of compatible GPS hardware, refer to the official wiki.
| GPS | -> | CYD |
|---|---|---|
| VCC | -> | VIN |
| GND | -> | GND |
| TX | -> | TX |
| RX | -> | RX |
Note: On 2.4" models swap RX/TX
After flashing, your CYD module will boot into the Marauder interface. Refer to the ESP32 Marauder Wiki for detailed usage instructions.
A huge thanks to the creators and supporters of the ESP32 Cheap Yellow Display project and the community Discord, especially @cod5fgzj, smoochiee, ggaljoen, and ATOMNFT. And a special mention to JustCallMeKoko for their foundational work on the ESP32Marauder.
This project is for educational purposes only. Always obtain proper authorization before testing on networks you don't own or have explicit permission to test. Don't be a dick!