ESP32 Marauder v1.12.3 + JSON Serial Interface (Marauder v4)

ESP32 Marauder v1.12.3 + JSON Serial Interface — Marauder v4

Prebuilt firmware for the Marauder v4 (OG Marauder, ESP32‑D0WD, CH340), based
on Marauder v1.12.3 plus the new JSON serial interface and screen‑free
analyzers from the feature/json-serial-interface branch (PR
justcallmekoko/ESP32Marauder#1346).

Built with arduino-cli + esp32:esp32@3.3.4, flash‑tested on real v4 hardware.

What's new

A machine‑readable command set over the USB serial CLI, so any host program can
parse device data reliably instead of scraping text:

• jsoninfo — handshake / capabilities
• jsonstatus — poll‑friendly device state
• jsonlist <a|s|c|i|p|t> — list APs / SSIDs / stations / IPs / probes / AirTags
• jsonmode <0|1> — toggle streaming
• analyzer [-t wifi|bt|chan] — run the analyzers with no screen

Every machine line is prefixed with @J and is one JSON object. Existing CLI
behaviour is unchanged. See JSON_SERIAL_INTERFACE.md in the repo for the full
protocol.

Assets

File	Use
…marauder_v4.merged.bin	Recommended. Full image — flash the single file at 0x0.
…marauder_v4.bootloader.bin	Bootloader — offset 0x1000 (manual method)
…marauder_v4.partitions.bin	Partition table — offset 0x8000
boot_app0.bin	Boot selector — offset 0xe000
…marauder_v4.app.bin	Application — offset 0x10000
SHA256SUMS.txt	Integrity checksums

Flashing

Easiest — single merged image (flash at 0x0):

esptool --chip esp32 -p /dev/ttyUSB0 -b 921600 write_flash \
  0x0 ESP32Marauder-v1.12.3-jsonserial-marauder_v4.merged.bin

Manual — individual images at their offsets:

esptool --chip esp32 -p /dev/ttyUSB0 -b 921600 write_flash \
  0x1000  ESP32Marauder-v1.12.3-jsonserial-marauder_v4.bootloader.bin \
  0x8000  ESP32Marauder-v1.12.3-jsonserial-marauder_v4.partitions.bin \
  0xe000  boot_app0.bin \
  0x10000 ESP32Marauder-v1.12.3-jsonserial-marauder_v4.app.bin

Use the correct serial port (/dev/ttyUSB0 on Linux, COMx on Windows). You
can also flash the merged image with the web flasher at
https://esp.huhn.me or Espressif's Flash Download Tool.

Verify integrity: sha256sum -c SHA256SUMS.txt

Notes

• This build targets Marauder v4 only. Other boards must be built from source
  (select the board in esp32_marauder/configs.h).
• Unofficial personal build from a fork; not an official justcallmekoko release.