ESP32 Marauder

ESP32 Marauder is a suite of WiFi and Bluetooth offensive and defensive tools for the ESP32.

WiFi Capabilities:

• Network Management: Join WiFi networks, shutdown the WiFi interface to save RAM, and manage SSID lists (Generate 20 random SSIDs, Add custom SSIDs via on-screen keyboard, or Clear list).
• Sniffing: Sniff WiFi probe request frames and beacon frames.
• Spamming: Beacon Spam (using a list of SSIDs or random frames) and 'Rick Roll' Beacon (broadcasting Rick Roll lyrics as APs).
• Monitoring & Analysis: Packet Monitor (time bar graph of packet density per channel), EAPOL/PMKID scanning, and Deauth Sniffing (detecting deauthentication packets).
• Detection: Detect Pwnagotchis, Espressif devices, and Bluetooth-enabled credit card skimmers.
• Data Management: Save PCAP files to an SD card.

Bluetooth Capabilities:

• Sniffing: Bluetooth Sniffer for devices in range.
• Shutdown: Shutdown BLE interface to save RAM.

Note: Due to the ESP32-IDF, the ESP32 is incapable of transmitting deauthentication frames.

This fork provides two ways to handle WebSocket message buffers. While it maintains compatibility with the original me-no-dev API using makeBuffer(), it is strongly recommended to use the optimized API based on std::shared_ptr<std::vector<uint8_t>>. The optimized API is more efficient and better supports concurrent use cases.

To ensure cross-fork compatibility, you can use preprocessor macros to detect if you are using the mathieucarbou fork.

void send(JsonDocument& doc) {
  const size_t len = measureJson(doc);

#if defined(ASYNCWEBSERVER_FORK_mathieucarbou)

  // Optimized API: uses shared_ptr for better concurrency support
  auto buffer = std::make_shared<std::vector<uint8_t>>(len);
  assert(buffer);
  serializeJson(doc, buffer->data(), len);
  _ws->textAll(std::move(buffer));

#else

  // Original me-no-dev API
  AsyncWebSocketMessageBuffer* buffer = _ws->makeBuffer(len);
  assert(buffer);
  serializeJson(doc, buffer->get(), len);
  _ws->textAll(buffer);

#endif
}

This fork maintains compatibility with the original me-no-dev WebSocket API by resurrecting AsyncWebSocketMessageBuffer and makeBuffer(), but it also supports a more efficient, optimized API based on std::shared_ptr<std::vector<uint8_t>>.

Developers can choose between the original API or the optimized API. It is strongly recommended to use the optimized API for better performance in concurrent use cases.

// Optimized API usage (Recommended)
void send(JsonDocument& doc) {
  const size_t len = measureJson(doc);

#if defined(ASYNCWEBSERVER_FORK_mathieucarbou)
  // Uses shared pointer API for better concurrency support
  auto buffer = std::make_shared<std::vector<uint8_t>>(len);
  assert(buffer);
  serializeJson(doc, buffer->data(), len);
  _ws->textAll(std::move(buffer));
#else
  // Original me-no-dev API
  AsyncWebSocketMessageBuffer* buffer = _ws->makeBuffer(len);
  assert(buffer);
  serializeJson(doc, buffer->get(), len);
  _ws->textAll(buffer);
#endif
}

Follow these steps to flash the ESP32 Marauder firmware using the Arduino IDE:

1. Install Arduino IDE and add the ESP32 board URL to File > Preferences > Additional Boards Manager URLs: https://dl.espressif.com/dl/package_esp32_index.json.
2. Install Boards: Go to Tools > Board > Boards Manager, search for esp32 and install esp32 by Espressif Systems.
3. Install Libraries:
   • Install SimpleList by Spacehuhn (Download repo and use Sketch > Include Library > Add .ZIP Library...).
   • Install the TFT_eSPI fork by justcallmekoko (Download repo and use Add .ZIP Library...). Note: You must apply specific modifications to the TFT_eSPI library as described in this issue.
4. Install Tools:
   • Install the ESP32 Spiffs Tool following these instructions.
   • Install CH340 Drivers.
5. Configure & Upload:
   • Clone/Download this repository and open esp32_marauder.ino.
   • (Optional) If using analog battery measurement, set #define BATTERY_ANALOG_ON to 1 in MenuFunctions.h.
   • Connect ESP32, select the correct COM port, and select LOLIN D32 under Tools > Boards.
   • Click ESP32 Sketch Data Upload to upload SPIFFS data.
   • Click the Upload button to flash the firmware.

To build a DIY ESP32 Marauder, connect a 2.8" TFT Touch Screen (with ili9341) to an ESP32 development board using the following pin mapping. Note that you may need to consult your specific ESP32 board's pinout.

Battery Circuitry:

• Analog Battery Measurement: Use a 4 to 1 voltage divider and an optional MOSFET. Connect BATTERY + to GPIO34 and MOSFET to GPIO13.
• Charge Detection (Optional): Use a 1 to 2 voltage divider. Connect CHARGE + to GPIO27.

| SD Card | 2.8" TFT | ESP32  |
| ------- | -------- | ------ |
|         | VCC      | VCC    |
|         | GND      | GND    |
|         | CS       | GPIO17 |
|         | RESET    | GPIO5  |
|         | D/C      | GPIO16 |
| SD_MOSI | MOSI     | GPIO23 |
| SD_SCK  | SCK      | GPIO18 |
|         | LED      | GPIO32 |
| SD_MISO | MISO     | GPIO19 |
|         | T_CLK    | GPIO18 |
|         | T_CS     | GPIO21 |
|         | T_DI     | GPIO23 |
|         | T_DO     | GPIO19 |
|         | T_IRQ    |        |
| SD_CS   |          | GPIO12 |