poseidon

          ≋≋≋   commander of the deep   ≋≋≋

**Firmware per pentest con tastiera per M5Stack Cardputer-Advance**

![target](https://img.shields.io/badge/target-Cardputer--Adv-red?style=flat-square)
![platform](https://img.shields.io/badge/framework-Arduino/PlatformIO-blue?style=flat-square)
![license](https://img.shields.io/badge/license-MIT-green?style=flat-square)
![features](https://img.shields.io/badge/features-164-magenta?style=flat-square)
![release](https://img.shields.io/github/v/release/GeneralDussDuss/poseidon?style=flat-square)
![version](https://img.shields.io/badge/version-0.6.8-cyan?style=flat-square)
![security key](https://img.shields.io/badge/KERBEROS-FIDO2%20passkey-10b981?style=flat-square)

**163 attacchi in tasca — WiFi, BLE, sub-GHz, 2.4 GHz, LoRa, IR e LAN — guidati da una vera tastiera QWERTY.**
POSEIDON trasforma l'M5Stack Cardputer-Advance in un deck di hacking basato su tastiera: digita per navigare, digita i tuoi parametri e guarda **Argus** — un gotchi autonomo a caccia di handshake con uno sprite dell'umore 96x96 — setacciare l'etere mentre fai altro. Stessa famiglia di Flipper Zero, Bruce, Evil-M5Project e Marauder, ma costruito attorno a una tastiera invece che a un D-pad.

[**Flashalo ora →**](#quick-start--flash-it) · [Scarica l'ultimo .bin](https://github.com/GeneralDussDuss/poseidon/releases/latest) · [Sito web](https://generaldussduss.github.io/poseidon) · [Changelog](https://github.com/generaldussduss/poseidon/blob/HEAD/CHANGELOG.md)

**🔐 Nuovo in 0.6.8: KERBEROS.** POSEIDON è ora anche una vera **chiave di sicurezza hardware FIDO2 / U2F**. Premi `k`, connettiti a un PC e registra veri **passkey**, incluso login discoverable senza nome utente. Gli stack U2F e CTAP2 sono scritti a mano su ESP32-S3 e verificati end-to-end contro `python-fido2` di Yubico. [Dettagli ↓](#-kerberos-fido2-security-key)

</div>

---

## 👁️ Incontra Argo

> Hanno accecato il gigante dai cento occhi uccidendolo. POSEIDON gli ha solo dato un nuovo modo di vedere.

**Argo Panoptes** era il sentinella onniveggente del mito — cento occhi, mai tutti chiusi contemporaneamente, condannato a vegliare per l'eternità. POSEIDON porta l'ultimo di quegli occhi. È un **semidio argoniano maledetto** incatenato nel deck, i suoi cento occhi fusi in una singola antenna, tutta quella fame di osservazione puntata sulle onde radio intorno a te. Salta di canale per istinto, impara dove si raduna la preda e cattura handshake WiFi dal nulla mentre il tuo Cardputer sta in tasca — instancabile, perché la maledizione non gli *permette* di riposare. Le espressioni che gli attraversano il volto sono la maledizione che traspare.

---

## 🌊 Nuovo in tutto questo? Inizia qui

POSEIDON è un **gadget di hacking da tasca**. Funziona su un piccolo palmare con una vera tastiera — l'M5Stack Cardputer — e lo trasforma in un coltellino svizzero per i segnali invisibili intorno a te. **Nessun PC, nessuna programmazione.** Flashalo una volta e inizia a digitare.

**Cosa può fare realmente?**

- 📶 **WiFi** — vedi tutte le reti intorno a te, testa le tue, mappale mentre cammini
- 📱 **Bluetooth** — trova tracker persi (AirTags / Tiles), scopri quelli nascosti che ti seguono, scherza con gadget vicini
- 🚗 **Telecomandi e segnali** — registra e riproduci aperture di garage, chiavi auto, campanelli, prese intelligenti *(su cose che possiedi)*
- 📺 **Infrarossi** — un telecomando TV universale, più il classico pulsante "spegni tutti i TV nella stanza"
- 🐾 **Argo** — il tuo animale da schermo che caccia WiFi autonomamente e reagisce con espressioni
- 🎨 **Sei aspetti** — cambia l'intera interfaccia tra sei temi, dal verde matrix al vaporwave

**Mettilo sul tuo dispositivo (~2 minuti):**

1. Scarica l'app gratuita **M5Burner**, *oppure* apri l'[**installer web**](https://generaldussduss.github.io/poseidon/install.html) in Chrome.
2. Cerca **POSEIDON** (o premi Installa), collega il tuo Cardputer, premi il pulsante.
3. Fatto — si avvia direttamente nel menu. Inizia a digitare.

> ⚠️ **Stai calmo.** Questo serve per esplorare *cose tue* e imparare come funziona realmente il wireless. Non toccare reti o dispositivi che non possiedi — è sia scorretto che illegale.

<div align="center">

### ⌁ Vuoi la spiegazione tecnica approfondita? La zona nerd inizia qui. ⌁

</div>

---

## Cos'è questo?

POSEIDON è un firmware per pentest basato su tastiera per **M5Stack Cardputer-Advance** (ESP32-S3, vera tastiera QWERTY + schermo a colori 240x135). **163 funzionalità** coprono WiFi, Bluetooth LE, sub-GHz, 2.4 GHz, LoRa & Mesh, infrarossi, LAN/rete, BadUSB e ricognizione — tutte raggiungibili digitando.

È nello stesso genere di Flipper Zero, Bruce, Evil-M5Project e ESP32Marauder, ma la tastiera cambia tutto:

- **Menu mnemonici a lettera** — ogni voce ha un tasto rapido, quindi ci salti direttamente
- **Parametri digitati** — inserisci un canale, un SSID, una frequenza direttamente, senza scorrimento col tasto pollice
- **Sei temi intercambiabili** + un livello di movimento ambientale procedurale dipinto dietro ogni menu
- **Argo** — un gotchi sprite dell'umore 96x96 che caccia handshake autonomamente mentre navighi nel menu

Funziona in modo indipendente sul Cardputer-Advance. I satelliti opzionali a scatto estendono la portata radio:

- **TRIDENT** — nodo ESP32-C5 tramite ESP-NOW: deauth a 5 GHz, sniffing Zigbee/802.15.4, PMKID
- **nRF52840 Feather** — funzionalità BLE 5.0 (proof-of-concept oggi, consolidato in v0.7)

## Avvio rapido — Flashalo

Due modi per metterlo sul Cardputer-Advance, entrambi basati su browser, nessun toolchain. Scegli uno.

### 1. Cardputer-Advance

**A) M5Burner — un clic, più facile.** Apri [M5Burner](https://docs.m5stack.com/en/download), cerca **POSEIDON**, premi **Burn**. Fatto.

**B) Flasher web** (Chrome / Edge / Opera). Collega il Cardputer via USB-C e apri:

> **<https://generaldussduss.github.io/poseidon/install.html>**

Clicca **Connect**, scegli la porta seriale, **Install** — la pagina flasha l'immagine di fabbrica corrente all'offset `0x0` per te.

### 2. Satellite TRIDENT (ESP32-C5)

Il C5 non è nell'elenco chip di M5Burner, quindi si flasha con il flasher web **esptool-js** di Espressif tramite WebSerial.

1. Collega la scheda C5 all'USB e apri il flasher Espressif: **<https://espressif.github.io/esptool-js/>** (Chrome / Edge)
2. **Connect** e seleziona la porta seriale del C5
3. Aggiungi i tre bin di TRIDENT dall'[ultima release](https://github.com/GeneralDussDuss/poseidon/releases/latest) a questi offset:

   | Offset | File |
   |---|---|
   | `0x2000` | bootloader |
   | `0x8000` | tabella delle partizioni |
   | `0x10000` | applicazione TRIDENT |

4. **Program**. Quando finisce, spegni e riaccendi il C5 — si abbina a POSEIDON tramite ESP-NOW automaticamente.

> Una versione guidata in un clic di questi passaggi è disponibile anche su **<https://generaldussduss.github.io/poseidon/flash/>**.

### Compila dal sorgente```bash
# Cardputer (ESP32-S3) — PlatformIO
git clone https://github.com/GeneralDussDuss/poseidon.git
cd poseidon
pio run -t upload

Il firmware TRIDENT C5 viene compilato con ESP-IDF (idf.py build flash) — vedi la directory trident/ per il suo README.

Panoramica delle funzionalità (164)

🔐 KERBEROS: chiave di sicurezza FIDO2

KERBEROS trasforma il Cardputer in una vera chiave di sicurezza hardware. Premi k, collegalo a un PC via USB e si enumera come autenticatore FIDO2 e U2F.

• U2F e CTAP2, scritti a mano sull'ESP32-S3 (CBOR, COSE, ECDSA su NIST P256, attestazione). Nessuna libreria FIDO già pronta.
• Passkey, non residenti e residenti (scopribili). Accedi senza nome utente.
• Approvazione sul dispositivo — premi fisicamente per approvare sul Cardputer prima che venga emessa qualsiasi firma.
• Verificato end-to-end rispetto alla libreria di riferimento python-fido2 di Yubico: le firme di attestazione e asserzione sono entrambe valide.
• Lo schermo e la tastiera aprono la possibilità di visualizzare il relying party sul dispositivo e un PIN, cosa che una chiave hardware sigillata non può eguagliare.

Entra in KERBEROS e si riavvia in una personalità USB solo FIDO; esci e si riavvia in modalità normale. Funziona oggi come secondo fattore su Google, GitHub e qualsiasi sito WebAuthn.

WiFi (17)

Scansione · Client (tutti i canali + per AP) · Deauth · Deauth Tutti · Rilevatore Deauth · Clona AP · Portale Malvagio (4 template) · Karma · Beacon Spam · Probe Sniff · Cattura PMKID + Handshake a 4 vie · Spettro 2.4 GHz · GPS Wardrive (CSV WiGLE) · Connetti · CIW Zeroclick (157 payload SSID: injection di comandi, Log4Shell, XSS, buffer overflow)

Bluetooth (16)

Scansione (ricerca OUI + Apple Continuity + DB Fast Pair + lookup fornitore GhostBLE sigdb_bt) · Spam (4 marche) · Bad-KB HID · Rilevamento Tracker (AirTag/SmartTag/Tile) · Trova Tracker (Geiger) · Sniffer (CSV) · iBeacon · Clona · GATT Explorer · Flood · Karma · Sour Apple (CVE-2023-42941) · Emulatore Find My · The Salty Deep (controller giocattolo) · Drone Remote ID (trasmissioni UAS ASTM F3411-22a) · WhisperPair (iniezione probe BLE)

Difensive (3 nuove)

Surveillance Hunter (rilevatore Flock/Raven ALPR + body-cam tramite tabelle OUI Plume) · Monitor Difensivo (anomalie WiFi+BLE a 7 classi: deauth-flood, broadcast-deauth, evil-twin, beacon-spam, WiFi-karma, BLE-spoof, BLE-flood) · SATCOM Tracker (database TLE integrato, 14 satelliti preferiti — az/el/lat/lon/alt/portata in tempo reale, senza internet)

Sub-GHz — CC1101 (9)

Scansione/Copia (cattura ISR + decodifica protocollo: Princeton, CAME, NICE, Linear) · Registra RAW (formato .sub di Flipper) · Riproduci file .sub · Libreria di segnali broadcast (più di 3.190 file .sub: auto, scherzi, Tesla, casa) · Analizzatore di spettro (barra + cascata + oscilloscopio) · Forza Bruta (Came/Nice/Linear/Chamberlain/Holtek/Ansonic) · Jammer · Trova segnali caldi/freddi

2.4 GHz — nRF24L01+ (6)

Sniffer ESB Promiscuo (trucco di Travis Goodspeed, validato CRC16) · MouseJack (impronta Logitech/Microsoft + iniezione HID) · BLE Spam (ADV_IND tramite nRF24, CRC24 + whitening) · Analizzatore di spettro (marcatori WiFi/BLE/Zigbee) · Jammer portante CW + Data Flood (7 preimpostazioni) · Trova caldi/freddi

LoRa + GNSS — SX1262 (8)

Scansione LoRa (RX passiva, multibanda) · Beacon TX · Listener Meshtastic LongFast · Analizzatore LoRa (barra + cascata + oscilloscopio con cattura pacchetti in tempo reale) · Chat Meshtastic (invia + ricevi testo) · Nodi Meshtastic (elenco in tempo reale) · Pagina Meshtastic (messaggio diretto a un nodo) · Posizione Meshtastic (mostrati come pin su altre app) · Fix GPS in tempo reale (auto-rilevamento baud, NMEA in background)

Attacchi di Rete (18)

Port Scan · Ping · DNS · Connetti · Responder (LLMNR/NBT-NS → NTLM) · Scanner SSDP/UPnP · LAN Recon (ARP + porta + banner + fornitore) · Shell UART (terminale seriale, auto-baud) · Tunnel TCP Inverso · Honeypot Telnet · Dead Drop WiFi (bacheca messaggi anonima) · Rilevamento Stampante + Stampa Raw · Poisoner SSDP · DHCP Starvation · DHCP Rogue (STA + AP) · Dirottamento di Rete (MitM a catena) · Abuso WPAD (cattura credenziali) · Abuso Autodiscover (cattura hash NTLM di Exchange)

IR (4)

TV-B-Gone · Telecomando Samsung Smart (~40 pulsanti, D-pad completo) · Clona Multi-profilo (Samsung / LG / Sony) · Test LED (diagnostica pin + polarità, verificabile con fotocamera del telefono)

BadUSB (1)

Esecuzione di payload USB-HID con DuckyScript-lite

Argus — Gotchi Autonomo

Sprite dell'umore 96x96 con dodici ritratti che si mappano in tempo reale allo stato di caccia. Caccia handshake in modo autonomo. Cervello selettore di canali RL persistito su SD. 4 modalità: HUNT, STEALTH, SURGICAL, STORM. Fumetto con bordo, sparkline RL, indicatore TX, flash HS.

TRIDENT — Satellite ESP32-C5

Compagno ESP32-C5 tramite ESP-NOW per WiFi 5 GHz + 802.15.4 Zigbee/Thread. Scansione dual-band, deauth remoto 5 GHz, sniff Zigbee, PMKID. LED di stato WS2812 NeoPixel.

Mesh

Beacon di presenza PigSync ESP-NOW — base per coordinamento multi-dispositivo.

Strumenti (9)

Torcia · Cronometro · Dado/Moneta/Palla 8 · Morse · Randomizzatore MAC · Calcolatrice · Test Schermo · Formatta SD · Selettore Tema (6 palette)

Temi (6)

Più uno strato di movimento ambientale procedurale (ui_ambient_tick) dipinto dietro ogni disegno del menu, sensibile al tema. Anteprima dal vivo in Sistema → Anteprima Ambientale. Screensaver abbinati al tema si attivano dopo 2 minuti di inattività.

Funzionalità Firma

Argus — il maledetto che tutto vede. Un semidio dai cento occhi vincolato nel deck (leggenda in alto ↑), Argus è un gotchi autonomo con uno sprite dell'umore 96x96 — dodici ritratti (Osserva, Soddisfatto, Infastidito, Calcolatore, Antica Furia, Addormentato…), ognuno mostra la maledizione mentre reagisce in tempo reale a ciò che cattura. Sotto il simpatico musetto c'è un selettore di canali con apprendimento per rinforzo che impara quali canali rendono e persiste il suo cervello su SD. Lascia POSEIDON in tasca e Argus continua a cacciare handshake nelle modalità HUNT / STEALTH / SURGICAL / STORM.

TRIDENT — aggancia una seconda banda. Un satellite ESP32-C5 tascabile che si abbina a POSEIDON tramite ESP-NOW e aggiunge le radio che l'S3 non può gestire da solo: deauth 5 GHz, sniffing Zigbee / 802.15.4 e cattura PMKID. Flashalo una volta con il flasher web, accendilo e si abbina automaticamente — il tuo Cardputer rimane la tastiera, TRIDENT diventa l'antenna.

SaltyJack — un arsenale di attacchi LAN tascabile. Metti POSEIDON su una rete (WiFi STA o W5500 cablato) ed esegui il tipo di attacchi che di solito richiedono un laptop e un Pi: DHCP starvation, DHCP rogue, Responder (LLMNR/NBT-NS → NTLM), cattura credenziali WPAD e Autodiscover, oltre a un cracker NTLMv2 sul dispositivo. Una fedele porta che attribuisce con orgoglio i crediti a @7h30th3r0n3 per RaspyJack ed Evil-M5Project — vai a mettere una stella a entrambi.

Sei temi + movimento ambientale. POSEIDON (cyberpunk), MATRIX (pioggia verde), E-INK (carta per esterno), SYNTHWAVE (vaporwave), PHANTOM (viola), BLOOD (rosso fsociety). Ogni tema ridipinge l'intera UI, guida il proprio strato ambientale procedurale dietro ogni menu e porta una screensaver abbinata. Cambia dal vivo in Sistema → Selettore Tema.

Hardware

Cappelli Supportati (uno alla volta)

Pianificato: MIMIR Drop-Box (futuro)

MIMIR è un drop-box per test di penetrazione compagno, mirato a una Banana Pi BPI-M4 Zero (Allwinner H618, 4GB RAM). Obiettivo di design: POSEIDON si collega via USB-C come client di controllo in modalità tascabile — nessun collegamento wireless, pura opsec. MIMIR eseguirebbe caccia autonoma di handshake, cracking e post-exploit mentre il Cardputer rimane l'UI interattiva. Non ancora implementato — elemento della roadmap aspirational, nessun codice client in POSEIDON oggi.

Comandi

Confronto

Grandi Riconoscimenti

• @7h30th3r0n3 → Evil-M5Project + RaspyJack — Sottomenu SaltyJack (DHCP Starve, Rogue DHCP, Responder, WPAD, crack NTLMv2), più WPAD, Autodiscover, CIW, honeypot, dead drop, poisoner SSDP, tutto portato dal suo lavoro. Indiscutibilmente la più grande singola ispirazione di codice per il lato LAN/credenziali di POSEIDON. Vai a mettere una stella a entrambi i repo.
• @JesseCHale → HaleHound-CYD — Riferimento per la sequenza di inizializzazione CC1101
• @insecurityofthings → uC_mousejack — Protocollo sniffer ESB + iniezione HID MouseJack
• @0ct0sec → M5PORKCHOP — Concetti di mesh PigSync, wardrive, spettro
• @justcallmekoko → ESP32Marauder — Pattern di attacco WiFi promiscuo
• @bmorcelli / @pr3y → Bruce — Riferimento funzionalità CC1101/nRF24
• @ECTO-1A → AppleJuice — Ricerca CVE-2023-42941
• COSIC — KU Leuven — Ricerca WhisperPair CVE (probe di accoppiamento BLE)
• @SpiderLabs → Responder — Protocollo LLMNR/NBT-NS
• @UberGuidoZ → Flipper — Libreria segnali Sub-GHz (3.190+ file .sub)

Se vedi qualcosa in questo codice che proviene dal tuo progetto e non è accreditato — per favore apri una segnalazione.

Roadmap

Storico completo delle release in CHANGELOG.md. La versione attuale distribuita è v0.6.3 (modalità visive dell'analizzatore sub-GHz — radar / persistenza / sonar, cascata a schermo intero, caccia Argus 5 GHz tramite TRIDENT, Mass Storage e un lotto di correzioni di stabilità, in aggiunta alla libreria sub-GHz integrata della v0.6.1 + indicatore ON-AIR). Cosa c'è dopo:

v0.7 — Dongle BLE 5.0 nRF52840 (pianificato)

L'nRF52840 è il vero chip BLE — BLE 5.0 completo con lungo raggio, PHY codificato e direction finding. Le quattro funzionalità nRF52 introdotte nella v0.6.0 viaggiano su un Adafruit Feather come prova di concetto; la v0.7 consolida il percorso con un dongle dedicato.

• Dongle nRF52840 come sniffer BLE (bridge USB-CDC dal Cardputer)
• Cattura + decodifica completa degli annunci BLE (non solo falso-BLE nRF24)
• Dirottamento connessione BLE (MITM tramite nRF52 + coordinamento NimBLE)
• Direction finding BLE (AoA/AoD con nRF52 multi-antenna)
• Attacchi BLE a lungo raggio (PHY codificato S=8, portata 4x)
• Zigbee tramite radio 802.15.4 dell'nRF52840 (alternativa a TRIDENT)
• Enumerazione superficie d'attacco del router di frontiera Thread
• Flasher firmware nRF52840 dalla SD del Cardputer
• Attacco combinato: MouseJack nRF24 + MITM BLE nRF52 simultaneamente

Aspirazionale — MIMIR Drop-Box (BPI-M4 Zero)

Non iniziato. Un futuro drop-box per test di penetrazione compagno su Banana Pi BPI-M4 Zero che esegue hcxdumptool + cracker sul dispositivo + orchestratore Bjorn. POSEIDON agirebbe come client di controllo in modalità tascabile via USB-C. Nessun codice esiste oggi.

• Demone MIMIR: wrapper hcxdumptool
• Cracker dizionario WPA2 sul dispositivo (PBKDF2-SHA1 dual-core)
• Porta orchestratore Bjorn — handshake → crack → pivot auto-exploit
• Testa di politica RL FENRIR — selezione strategia di exploit autonoma
• Ricetta immagine Armbian H618 (deploy in un flash)
• Trasferimento file MIMIR ↔ POSEIDON
• Registrazione attacchi con tag GPS e integrazione WiGLE

v0.7 — Intelligenza sul Dispositivo

• Cracker WPA2 sul dispositivo (handshake → PBKDF2-SHA1, dual-core ESP32-S3)
• Shell SSH tramite libssh_esp32 (terminale remoto interattivo)
• Dump dominio LDAP (client LDAP BER/DER fatto a mano)
• Web crawler (ragno HTTP + estrazione link per applicazioni web interne)
• Suite attacco SIP (scansiona/enumera/spoofa/inonda/chiama tutti)
• Toolkit CCTV (scoperta telecamere + spray credenziali predefinite)
• Rilevatore skimmer (lista bloccati OUI BLE per skimmer carte di pagamento)
• Wall of Flipper (rileva + contro-spamma Flipper Zero nelle vicinanze)
• Spam beacon Pwnagotchi (falsi annunci peer)
• Dashboard WiFi aperto (test associazione + connettività internet)
• Sfruttamento NAT UPnP (AddPortMapping per bucare firewall)

In corso

• Ulteriori contributi alla libreria di segnali .sub (benvenuti PR della comunità)
• Comunità temi — palette colori inviate dagli utenti
• Parser completo DuckyScript (non solo -lite)
• Supporto formato codificato protocollo .sub di Flipper (non solo RAW)
• Analisi codice rotante KeeLoq (database chiavi produttore)
• Modalità memoria di massa USB sulla SD (esporta catture senza rimuovere la scheda)
• Mesh crittografata ESP-NOW (AES-256 tra nodi POSEIDON)
• CI/CD: build PlatformIO GitHub Actions + rilascio automatico .bin

Legale

Questo è solo per test di sicurezza autorizzati, ricerca e istruzione. Sei responsabile del rispetto di tutte le leggi applicabili. Non utilizzare contro reti o dispositivi senza esplicita autorizzazione.

Licenza MIT. Prendilo, forkalo, miglioralo.