poseidon

          ≋≋≋   commander of the deep   ≋≋≋

**Keyboard-first pentesting firmware for the 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 атаки в кармане — WiFi, BLE, sub-GHz, 2.4 ГГц, LoRa, ИК и LAN — управляемые настоящей QWERTY-клавиатурой.**
POSEIDON превращает M5Stack Cardputer-Advance в хакерскую панель с управлением с клавиатуры: печатайте для навигации, вводите параметры и наблюдайте, как **Argus** — автономный готчи, охотящийся за хендшейками, с 96x96 спрайтом настроения — работает в радиоэфире, пока вы заняты. Из той же семьи, что Flipper Zero, Bruce, Evil-M5Project и Marauder, но построен вокруг клавиатуры, а не D-pad.

[**Прошить сейчас →**](#quick-start--flash-it) · [Скачать последний .bin](https://github.com/GeneralDussDuss/poseidon/releases/latest) · [Веб-сайт](https://generaldussduss.github.io/poseidon) · [Список изменений](https://github.com/generaldussduss/poseidon/blob/HEAD/CHANGELOG.md)

**🔐 Новое в 0.6.8: KERBEROS.** POSEIDON теперь также является настоящим **аппаратным ключом безопасности FIDO2 / U2F**. Нажмите `k`, подключитесь к ПК и регистрируйте настоящие **passkey**, включая вход без имени пользователя. Стеки U2F и CTAP2 написаны вручную для ESP32-S3 и проверены от и до с помощью `python-fido2` от Yubico. [Подробности ↓](#-kerberos-fido2-security-key)

</div>

---

## 👁️ Встречайте Аргуса

> Они ослепили стоглазого великана, убив его. POSEIDON просто дал ему новый способ видеть.

**Аргус Панопт** был всевидящим стражем из мифов — сто глаз, никогда не закрытых одновременно, проклятый вечно бдить. POSEIDON несёт последние из тех глаз. Он **проклятый полубог-аргонианец**, закованный в панель, его сто глаз переплавлены в одну антенну, вся эта жажда наблюдения направлена на радиоволны вокруг вас. Он переключает каналы инстинктивно, узнаёт, где собирается добыча, и вылавливает WiFi-хендшейки из воздуха, пока ваш Cardputer лежит в кармане — неутомимый, потому что проклятие не даёт ему *отдыхать*. Настроения, мелькающие на его лице — это проявление проклятия.

---

## 🌊 Всё это в новинку? Начните здесь

POSEIDON — это **карманное хакерское устройство**. Оно работает на крошечном ручном устройстве с настоящей клавиатурой — M5Stack Cardputer — и превращает его в швейцарский нож для невидимых сигналов вокруг вас. **Никакого ПК, никакого кодирования.** Прошейте один раз и начинайте печатать.

**Что он на самом деле может делать?**

- 📶 **WiFi** — видеть все сети вокруг, тестировать свои, картографировать их при ходьбе
- 📱 **Bluetooth** — находить потерянные трекеры (AirTags / Tiles), обнаруживать скрытые, следящие за вами, возиться с ближайшими гаджетами
- 🚗 **Пульты и сигналы** — записывать и воспроизводить гаражные ворота, автомобильные брелоки, дверные звонки, умные розетки *(на том, что вам принадлежит)*
- 📺 **Инфракрасный** — универсальный пульт от телевизора, плюс классическая кнопка «выключить все телевизоры в комнате»
- 🐾 **Argus** — ваш экранный питомец, который самостоятельно охотится за WiFi и реагирует настроениями
- 🎨 **Шесть обликов** — переключайте весь интерфейс между шестью темами, от матрично-зелёной до вапорвейв

**Установите на своё устройство (~2 минуты):**

1. Загрузите бесплатное приложение **M5Burner** *или* откройте [**веб-установщик**](https://generaldussduss.github.io/poseidon/install.html) в Chrome.
2. Найдите **POSEIDON** (или нажмите «Установить»), подключите Cardputer, нажмите кнопку.
3. Готово — он загружается прямо в меню. Просто начните печатать.

> ⚠️ **Будьте адекватны.** Это для исследования *своего* оборудования и понимания, как на самом деле работает беспроводная связь. Не трогайте сети или устройства, которые вам не принадлежат — это и невежливо, и незаконно.

<div align="center">

### ⌁ Нужно глубокое техническое описание? Зона для гиков начинается здесь. ⌁

</div>

---

## Что это такое?

POSEIDON — это прошивка для пентеста с управлением с клавиатуры для **M5Stack Cardputer-Advance** (ESP32-S3, настоящая QWERTY-клавиатура + цветной экран 240x135). **163 функции** охватывают WiFi, Bluetooth LE, sub-GHz, 2.4 ГГц, LoRa и Mesh, инфракрасный, LAN/сеть, BadUSB и разведку — все доступны через набор текста.

Он того же жанра, что Flipper Zero, Bruce, Evil-M5Project и ESP32Marauder, но клавиатура всё меняет:

- **Меню с буквенными мнемониками** — каждый элемент имеет горячую клавишу, так что вы переходите прямо к нему
- **Вводимые параметры** — введите канал, SSID, частоту напрямую, без прокрутки джойстиком
- **Шесть сменных тем** + процедурный слой фонового движения, накладываемый за каждым меню
- **Argus** — готчи с 96x96 спрайтом настроения, который самостоятельно охотится за хендшейками, пока вы просматриваете меню

Работает автономно на Cardputer-Advance. Дополнительные модули, подключаемые через разъём, расширяют радиус радиосвязи:

- **TRIDENT** — узел ESP32-C5 через ESP-NOW: деаутентификация 5 ГГц, сниффинг Zigbee/802.15.4, PMKID
- **nRF52840 Feather** — возможности BLE 5.0 (сегодня как proof-of-concept, будет доработано в v0.7)

## Быстрый старт — прошивка

Два способа прошить Cardputer-Advance, оба через браузер, без инструментария. Выберите один.

### 1. Cardputer-Advance

**A) M5Burner — одним кликом, проще всего.** Откройте [M5Burner](https://docs.m5stack.com/en/download), найдите **POSEIDON**, нажмите **Burn**. Готово.

**B) Веб-прошивальщик** (Chrome / Edge / Opera). Подключите Cardputer через USB-C и откройте:

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

Нажмите **Connect**, выберите последовательный порт, **Install** — страница сама прошьёт текущий заводской образ по смещению `0x0`.

### 2. Спутник TRIDENT (ESP32-C5)

C5 нет в списке чипов M5Burner, поэтому прошивается с помощью веб-прошивальщика Espressif **esptool-js** через WebSerial.

1. Подключите плату C5 к USB и откройте прошивальщик Espressif: **<https://espressif.github.io/esptool-js/>** (Chrome / Edge)
2. **Connect** и выберите последовательный порт C5
3. Добавьте три бинарных файла TRIDENT из [последнего релиза](https://github.com/GeneralDussDuss/poseidon/releases/latest) по следующим смещениям:

   | Смещение | Файл |
   |---|---|
   | `0x2000` | bootloader |
   | `0x8000` | таблица разделов |
   | `0x10000` | приложение TRIDENT |

4. **Program**. После завершения перезагрузите C5 — он автоматически подключится к POSEIDON через ESP-NOW.

> Одношаговая версия этих шагов с подсказками также доступна по адресу **<https://generaldussduss.github.io/poseidon/flash/>**.

### Сборка из исходников```bash
# Cardputer (ESP32-S3) — PlatformIO
git clone https://github.com/GeneralDussDuss/poseidon.git
cd poseidon
pio run -t upload

Прошивка TRIDENT C5 собирается с помощью ESP-IDF (idf.py build flash) — см. каталог trident/ и его README.

Обзор возможностей (164)

🔐 KERBEROS: ключ безопасности FIDO2

KERBEROS превращает Cardputer в настоящий аппаратный ключ безопасности. Нажмите k, подключите к ПК через USB, и он определится как аутентификатор FIDO2 и U2F.

• U2F и CTAP2, написаны вручную на ESP32-S3 (CBOR, COSE, ECDSA через NIST P256, аттестация). Никакой готовой библиотеки FIDO.
• Passkeys, нерезидентные и резидентные (обнаруживаемые). Вход без имени пользователя.
• Подтверждение на устройстве — вы физически нажимаете для подтверждения на Cardputer перед выдачей любой подписи.
• Сквозная верификация с эталонной библиотекой python-fido2 от Yubico: проверяются как аттестационные, так и утверждающие подписи.
• Экран и клавиатура открывают возможность отображения информации о проверяющей стороне на устройстве и PIN-кода, чего не может обеспечить аппаратный запечатанный ключ.

Войдите в KERBEROS, и он перезагрузится в USB-профиль только FIDO; выйдите, и он перезагрузится в обычный режим. Работает сегодня как второй фактор на Google, GitHub и любом сайте WebAuthn.

WiFi (17)

Сканирование · Клиенты (все каналы + по AP) · Деаутентификация · Деаутентификация всех · Детектор деаутентификации · Клонирование AP · Evil Portal (4 шаблона) · Karma · Beacon Spam · Probe Sniff · Захват PMKID + 4-стороннего рукопожатия · Спектр 2,4 ГГц · GPS Wardrive (WiGLE CSV) · Подключение · CIW Zeroclick (157 полезных нагрузок SSID: cmd injection, Log4Shell, XSS, buffer overflow)

Bluetooth (16)

Сканирование (OUI + Apple Continuity + Fast Pair DB + GhostBLE sigdb_bt поиск по вендору) · Спам (4 бренда) · Bad-KB HID · Обнаружение трекеров (AirTag/SmartTag/Tile) · Поиск трекеров (Гейгер) · Сниффер (CSV) · iBeacon · Клонирование · GATT Explorer · Флуд · Karma · Sour Apple (CVE-2023-42941) · Find My Emulator · The Salty Deep (игрушечный контроллер) · Drone Remote ID (ASTM F3411-22a UAS передачи) · WhisperPair (внедрение BLE зондов)

Защитные (3 новых)

Surveillance Hunter (Flock/Raven ALPR + детектор нательных камер через таблицы OUI Plume) · Defensive Monitor (7-классовая аномалия WiFi+BLE: deauth-флуд, broadcast-deauth, evil-twin, beacon-spam, WiFi-karma, BLE-spoof, BLE-flood) · SATCOM Tracker (встроенная база TLE, 14 избранных спутников — азимут/угол места/широта/долгота/высота/дальность в реальном времени, без интернета)

Sub-GHz — CC1101 (9)

Сканирование/Копирование (захват ISR + декодер протоколов: Princeton, CAME, NICE, Linear) · Запись RAW (формат Flipper .sub) · Воспроизведение .sub файлов · Библиотека сигналов (3,190+ .sub файлов: машины, розыгрыши, Tesla, дом) · Анализатор спектра (столбцы + водопад + осциллограф) · Brute Force (Came/Nice/Linear/Chamberlain/Holtek/Ansonic) · Глушилка · Поиск горячих/холодных сигналов

2.4 ГГц — nRF24L01+ (6)

Promiscuous ESB Sniffer (трюк Travis Goodspeed, проверка CRC16) · MouseJack (отпечаток Logitech/Microsoft + HID-инъекция) · BLE Спам (ADV_IND через nRF24, CRC24 + отбеливание) · Анализатор спектра (маркеры WiFi/BLE/Zigbee) · CW Carrier + Data Flood Jammer (7 пресетов) · Поиск горячих/холодных

LoRa + GNSS — SX1262 (8)

Сканирование LoRa (пассивный RX, многодиапазонный) · Передача маяка · Прослушивание Meshtastic LongFast · Анализатор LoRa (столбцовый измеритель + водопад + осциллограф с захватом пакетов в реальном времени) · Meshtastic Чат (отправка и получение текста) · Meshtastic Узлы (живой список) · Meshtastic Сообщение (прямое сообщение узлу) · Meshtastic Позиция (отображение в виде пина в других приложениях) · Live GPS Fix (автоопределение скорости, фоновый NMEA)

Сетевые атаки (18)

Сканирование портов · Ping · DNS · Подключение · Responder (LLMNR/NBT-NS → NTLM) · SSDP/UPnP сканер · Разведка LAN (ARP + порт + баннер + вендор) · UART Shell (последовательный терминал, автоопределение скорости) · Reverse TCP Tunnel · Telnet Honeypot · WiFi Dead Drop (анонимная доска сообщений) · Обнаружение принтеров + Raw Print · SSDP Poisoner · DHCP Starvation · Rogue DHCP (STA + AP) · Перехват сети (цепочка MitM) · Злоупотребление WPAD (захват учетных данных) · Злоупотребление Autodiscover (захват хэша NTLM Exchange)

IR (4)

TV-B-Gone · Samsung Smart Remote (~40 кнопок, полный D-pad) · Клонирование нескольких профилей (Samsung / LG / Sony) · LED Test (диагностика контактов и полярности, проверяемая камерой телефона)

BadUSB (1)

Исполнитель полезной нагрузки USB-HID с DuckyScript-lite

Argus — автономный Готчи

96x96 спрайт настроения с двенадцатью портретами, которые в реальном времени отражают состояние охоты. Охотится за рукопожатиями автономно. Мозг с выбором канала RL сохраняется на SD. 4 режима: HUNT, STEALTH, SURGICAL, STORM. Облачко с рамкой, график RL, индикатор TX, вспышка HS.

TRIDENT — спутник ESP32-C5

Компаньон ESP32-C5 через ESP-NOW для WiFi 5 ГГц + 802.15.4 Zigbee/Thread. Двухдиапазонное сканирование, удаленная деаутентификация 5 ГГц, сниффинг Zigbee, PMKID. Светодиод состояния WS2812 NeoPixel.

Mesh

Маяк присутствия PigSync ESP-NOW — основа для координации нескольких устройств.

Инструменты (9)

Фонарик · Секундомер · Кубик/Монетка/Шар · Азбука Морзе · Рандомизатор MAC · Калькулятор · Тест экрана · Форматирование SD · Выбор темы (6 палитр)

Темы (6)

Плюс процедурный слой амбиентного движения (ui_ambient_tick), отображаемый за каждым меню с учетом темы. Живой предпросмотр в System → Ambient Preview. Заставки, соответствующие теме, включаются через 2 минуты бездействия.

Ключевые возможности

Argus — проклятый всевидящий. Стоокий полубог, заключенный в колоду (лор вверху ↑), Argus — автономный готчи с 96x96 спрайтом настроения — двенадцать портретов (Наблюдающий, Довольный, Раздраженный, Вычисляющий, Древняя Ярость, Спящий…), каждый из которых показывает проклятие, реагируя в реальном времени на то, что он ловит. Под милым личиком скрывается подкрепляющийся обучением выбор канала, который учится, какие каналы выгодны, и сохраняет свой мозг на SD. Оставьте POSEIDON в кармане, и Argus продолжает охотиться за рукопожатиями в режимах HUNT / STEALTH / SURGICAL / STORM.

TRIDENT — пристегните второй диапазон. Карманный спутник ESP32-C5, который подключается к POSEIDON через ESP-NOW и добавляет радио, которые S3 не может выполнять в одиночку: деаутентификация 5 ГГц, сниффинг Zigbee / 802.15.4 и захват PMKID. Прошейте его один раз через веб-прошивальщик, включите питание, и он автоматически подключится — ваш Cardputer остается клавиатурой, TRIDENT становится антенной.

SaltyJack — карманный арсенал атак на LAN. Подключите POSEIDON к сети (WiFi STA или проводной W5500) и запускайте атаки, для которых обычно нужен ноутбук и Pi: DHCP starvation, Rogue DHCP, Responder (LLMNR/NBT-NS → NTLM), захват учетных данных через WPAD и Autodiscover, а также встроенный взломщик NTLMv2. Верный порт, который с гордостью упоминает @7h30th3r0n3's RaspyJack и Evil-M5Project — поставьте звезду обоим.

Шесть тем + амбиентное движение. POSEIDON (киберпанк), MATRIX (зеленый дождь), E-INK (дневная бумага), SYNTHWAVE (вапорвейв), PHANTOM (фиолетовый), BLOOD (красный fsociety). Каждая тема перекрашивает весь интерфейс, запускает свой процедурный амбиентный слой за каждым меню и привносит соответствующую заставку. Переключайте вживую в System → Theme Picker.

Аппаратное обеспечение

Поддерживаемые шапки (по одной)

Планируется: MIMIR Drop-Box (будущее)

MIMIR — это сопутствующая пентест-дропбокс, нацеленная на Banana Pi BPI-M4 Zero (Allwinner H618, 4 ГБ ОЗУ). Цель дизайна: POSEIDON подключается через USB-C как клиент управления в карманном режиме — без беспроводной связи, чистая опсека. MIMIR будет выполнять автономную охоту за рукопожатиями, взлом и постэксплуатацию, пока Cardputer остается интерактивным интерфейсом. Еще не реализовано — пункт дорожной карты, нет клиентского кода в POSEIDON сегодня.

Управление

Сравнение

Огромные благодарности

• @7h30th3r0n3 → Evil-M5Project + RaspyJack — Подменю SaltyJack (DHCP Starve, Rogue DHCP, Responder, WPAD, взломщик NTLMv2), плюс WPAD, Autodiscover, CIW, honeypot, dead drop, SSDP poisoner — все портировано из его работы. Бесспорно, самый большой источник вдохновения для создания LAN/учетных данных POSEIDON. Поставьте звезду обоим репозиториям.
• @JesseCHale → HaleHound-CYD — ссылка на последовательность инициализации CC1101
• @insecurityofthings → uC_mousejack — сниффер ESB MouseJack + протокол HID-инъекции
• @0ct0sec → M5PORKCHOP — концепции сетки PigSync, wardrive, спектра
• @justcallmekoko → ESP32Marauder — шаблоны WiFi-атак в режиме promisc
• @bmorcelli / @pr3y → Bruce — ссылка на функционал CC1101/nRF24
• @ECTO-1A → AppleJuice — исследование CVE-2023-42941
• COSIC — KU Leuven — исследование WhisperPair CVE (BLE-зонды спаривания)
• @SpiderLabs → Responder — протоколы LLMNR/NBT-NS
• @UberGuidoZ → Flipper — библиотека сигналов Sub-GHz (3,190+ .sub файлов)

Если вы видите что-то в этом коде, что взято из вашего проекта и не указано — пожалуйста, откройте issue.

Дорожная карта

Полная история релизов в CHANGELOG.md. Текущая выпущенная версия — v0.6.3 (визуальные режимы анализатора sub-GHz — радар / персистентность / сонар, полноэкранный водопад, охота Argus на 5 ГГц через TRIDENT, Mass Storage и набор исправлений стабильности, поверх встроенной в v0.6.1 библиотеки sub-GHz + индикатора ON-AIR). Что дальше:

v0.7 — nRF52840 BLE 5.0 донгл (планируется)

nRF52840 — это настоящий BLE-чип — полный BLE 5.0 с дальним радиусом, кодированным PHY и определением направления. Четыре функции nRF52, появившиеся в v0.6.0, работают на Adafruit Feather как proof-of-concept; v0.7 укрепляет путь с помощью выделенного донгла.

• Донгл nRF52840 как сниффер BLE (мост USB-CDC от Cardputer)
• Полный захват и декодирование рекламных пакетов BLE (не только поддельный BLE от nRF24)
• Перехват соединения BLE (MITM через nRF52 + координация NimBLE)
• Определение направления BLE (AoA/AoD с многоантенным nRF52)
• Атаки BLE на большом расстоянии (Coded PHY S=8, дальность 4x)
• Zigbee через радио 802.15.4 nRF52840 (альтернатива TRIDENT)
• Перебор поверхности атаки пограничного маршрутизатора Thread
• Прошивальщик прошивки nRF52840 с SD Cardputer
• Комбинированная атака: nRF24 MouseJack + nRF52 BLE MITM одновременно

Амбициозно — MIMIR Drop-Box (BPI-M4 Zero)

Не начато. Будущая сопутствующая пентест-дропбокс на Banana Pi BPI-M4 Zero с hcxdumptool + взломщиком на устройстве + оркестратором Bjorn. POSEIDON будет выступать в роли клиента управления в карманном режиме через USB-C. На данный момент кода нет.

• Демон MIMIR: обертка hcxdumptool
• Взломщик словаря WPA2 на устройстве (двухъядерный PBKDF2-SHA1)
• Порт оркестратора Bjorn — рукопожатие → взлом → авто-эксплойт pivot
• Голова политики FENRIR RL — автономный выбор стратегии эксплойта
• Рецепт образа Armbian H618 (однопрошивное развертывание)
• Передача файлов MIMIR ↔ POSEIDON
• Журналирование атак с GPS-тегами и интеграция с WiGLE

v0.7 — Интеллект на устройстве

• Взломщик WPA2 на устройстве (рукопожатие → PBKDF2-SHA1, двухъядерный ESP32-S3)
• SSH-оболочка через libssh_esp32 (интерактивный удаленный терминал)
• Дамп домена LDAP (самодельный клиент BER/DER LDAP)
• Веб-краулер (HTTP-паук + извлечение ссылок для внутренних веб-приложений)
• Набор атак SIP (сканирование/перебор/спуфинг/флуд/звонок всем)
• Инструментарий CCTV (обнаружение камер + подбор стандартных учетных данных)
• Детектор скиммеров (черный список BLE OUI для скиммеров платежных карт)
• Стена Flipper (обнаружение + встречный спам близлежащих Flipper Zero)
• Спам маячками Pwnagotchi (фальшивые широковещательные передачи)
• Панель открытого WiFi (ассоциация + тест подключения к интернету)
• Эксплойт UPnP NAT (AddPortMapping для пробоя файрвола)

В процессе

• Больше вкладов в библиотеку сигналов .sub (приветствуются PR сообщества)
• Сообщество тем — пользовательские цветовые палитры
• Полный парсер DuckyScript (не только -lite)
• Поддержка формата Flipper .sub с кодированием протокола (не только RAW)
• Анализ сменного кода KeeLoq (база ключей производителя)
• Режим USB Mass Storage для SD-карты (экспорт захватов без извлечения карты)
• Шифрованная сетка ESP-NOW (AES-256 между узлами POSEIDON)
• CI/CD: сборка PlatformIO GitHub Actions + авторелиз .bin

Правовая информация

Это предназначено только для авторизованного тестирования безопасности, исследований и образования. Вы несете ответственность за соблюдение всех применимых законов. Не используйте против сетей или устройств без явного разрешения.

Лицензия MIT. Берите, форкайте, улучшайте.