Install — POSEIDON

00 · TRIDENT · ESP32-C5 SATELLITE

TRIDENT — Web Flasher or esptool

TRIDENT is the ESP32-C5 satellite that gives POSEIDON 5 GHz deauth, Zigbee sniffing, and PMKID capture over ESP-NOW. M5Burner doesn't support ESP32-C5 yet, so use the web flasher below (Chrome/Edge/Opera) or the esptool command block. POSEIDON itself installs via M5Burner further down.

ONE-CLICK · BROWSER

Plug the C5 in via USB-C, hit the button, pick the COM port, wait ~15 s.

Browser not supported — use Chrome/Edge/Opera. Web flashing needs HTTPS.

Manual flash — esptool

If the browser flasher can't reach your port (Linux udev, Windows driver issues, etc.), grab trident-factory.bin from the latest release and flash it yourself. The factory image already contains bootloader + partition table + app merged at offset 0x0.

SHELL · ESP32-C5 one-liner

# install esptool if you haven't

$ pip install esptool

# flash the C5 at 0x0 — factory bin includes bootloader + partitions + app

$ esptool.py --chip esp32c5 --port COM8 erase_flash

$ esptool.py --chip esp32c5 --port COM8 write_flash 0x0 trident-factory.bin

Replace COM8 with your actual serial port. macOS: /dev/tty.usbmodem* · Linux: /dev/ttyACM0. esptool ≥ v4.7 is required for ESP32-C5 chip support.

Build from source — ESP-IDF

The C5 firmware lives in c5_node/ and builds with ESP-IDF 5.5+ (needed for ESP32-C5 chip support).

SHELL · build + flash from source

$ cd poseidon/c5_node

$ idf.py set-target esp32c5

$ idf.py build

$ idf.py -p COM8 flash

The satellite pairs with POSEIDON automatically over ESP-NOW on channel 1 — no WiFi credentials, no manual MAC pairing. Power it up next to the Cardputer and you'll see it show up in C5 → Status.

01 · EASIEST

M5Burner — custom repository

M5Burner is M5Stack's official GUI flasher. POSEIDON isn't on their public list yet, but you can add our custom repo in one click and get auto-updates whenever we tag a release.

M5BURNER · CUSTOM REPO URL

https://generaldussduss.github.io/poseidon/m5burner.json

paste into M5Burner → Settings → Custom → Add

Step-by-step

Download M5Burner from docs.m5stack.com/download and open it.
Open Settings (gear icon, bottom-left) → Custom Firmware tab.
Paste the repo URL above and click Add.
Back in the main view, scroll the sidebar until you see the POSEIDON entry (icon: trident).
Click it → select the latest version → hit Burn.
M5Burner auto-detects the COM port, erases, and flashes. Reboots when done.

M5Burner checks this URL on every launch — v0.6.0 shows up automatically the moment it's tagged.

02 · TERMINAL

esptool — direct flash

Download the factory image from the latest release and flash it. Works on Windows / macOS / Linux.

SHELL · one-liner

# install esptool (one time)

$ pip install esptool

# erase + flash at 0x0

$ esptool.py --chip esp32s3 --port COM5 erase_flash

$ esptool.py --chip esp32s3 --port COM5 write_flash 0x0 poseidon-factory.bin

Replace COM5 with your actual port. macOS looks like /dev/tty.usbmodem*, Linux like /dev/ttyACM0.

03 · SOURCE

PlatformIO — build from source

Clone the repo, open in VS Code with the PlatformIO extension, hit Upload. Uses pioarduino platform 55.03.38 + Bruce's patched libs (pinned in platformio.ini).

SHELL · clone + flash

$ git clone https://github.com/GeneralDussDuss/poseidon.git

$ cd poseidon

$ pio run -t upload

First build pulls ~500 MB (framework + libs). Subsequent builds are ~30 seconds. Need Python 3.10+ and PlatformIO Core installed.

⚠ BRICK RECOVERY

If the device boots to black or locks up: hold G0 during power-on to force download mode, then re-flash. Every ESP32-S3 has this escape hatch — you cannot permanently brick a Cardputer-Adv from software.