Repository navigation
GhostESP Revival Setup and Wireless Observation Lab
Caution
Authorized use only. Use owned devices or an explicitly authorized lab. Define permitted collection, transmissions and data retention before testing. Read the legal notice. Device-owner permission does not override radio law.
Last reviewed: 2026-11-07
GhostESP Revival is an ESP-IDF-based wireless research platform with board UI, serial and other target-dependent interfaces. It is the maintained successor to the archived original GhostESP. Use this guide for first installation, bounded Wi-Fi/BLE observations and capture verification; broad functionality does not imply every build has every feature.
| Requirement | Check Before Flashing |
|---|---|
| Target | Upstream lists WROOM, S2, S3, C3, C5, C6 and P4 variants; choose the exact board configuration, not just the chip name. |
| Radio | S2 has no Bluetooth; C5-capable builds can use 5 GHz. P4 designs depend on an external radio companion. |
| Storage / GPS | Confirm SD wiring, supported filesystem and GPS source in the board matrix. A GPS column is not proof your physical device contains GNSS. |
| USB / RF / NFC | Native USB and external CC1101/NRF24/NFC functions require their documented ports and peripherals. |
- Save the previous firmware identity and authorized settings/logs. Record the board model, flash/PSRAM size, display and attached modules.
- Open the official flasher with a browser and connection mode that it supports. Upstream specifically recommends this installer or its release binaries.
- Select the exact board and stable release, review the erase warning, connect the correct port and complete installation without interrupting power.
- Reboot, confirm the version and peripherals, and inspect boot/startup settings. Disable unneeded automation, uploads, third-party apps and transmit-capable tests.
- Use current project documentation for command syntax. Do not reuse original GhostESP commands or offsets without checking.
- Prepare one owned access point and one owned BLE beacon. Record known channel, BSSID, advertisement identity and the approved collection window.
- Use the build's observation/scanner interface and confirm both known devices. Do not enable active BLE scanning if the exercise requires receive-only collection; scan requests, WebUI AP operation and associated network discovery can transmit.
- Where supported, record a short Wi-Fi or BLE capture to SD or stream it to an analysis host. Confirm the actual export format before opening it in Wireshark.
- Check timestamps, channel/signal metadata and whether the known device appears. A graph or device counter alone does not prove that a useful capture was saved.
- Stop collection, copy the original artifact and record its hash and settings. Separate any conversion/export from the preserved original. No upload is required.
| Symptom | First Checks |
|---|---|
| No BLE menu | Chip support first; an ESP32-S2 cannot gain BLE from another image. |
| Blank display / missing SD | Exact board target, flash size, wiring and matching assets; avoid random pin changes. |
| Empty capture | Correct band/channel, supported mode, storage and approved test-device activity. Channel hopping can miss frames. |
| Broken after a firmware switch | Back up first, then use the official installer/recovery procedure for the full target layout. |
| Resource | Use |
|---|---|
| Marauder | Alternative wireless toolkit with a different target/client model |
| Bruce | Alternative multi-radio module workflow |
| Wardriving Data Handling | Location identifiers, retention and deliberate sharing |
| Firmware Catalog | Activity notes and broader platform selection |
| Documentation Index | Return to section navigation |
This is an original PNWC setup and benign validation workflow based on the linked primary documentation. Source and navigation were reviewed; no physical board was flashed, firmware compiled or radio behavior measured. Confirm current target manifests and release notes before use; menu names and build requirements can change.
Master Index | Role Navigation | Legal Notice
๐ Source: Documentation/ghostesp-revival.md | โ๏ธ Suggest an edit | โฌ
๏ธ Back to Technical Guides & Cheat Sheets
- ๐บ๏ธ Browse by Topic
- ๐ All Repository Files
- ๐งญ Learning Paths
- ๐ Master Guide
- ๐ค Glossary
- โ๏ธ Legal & Disclaimer
๐ Foundations & Learning
๐ก๏ธ Defense & Investigations
- Incident Response
- Open Source Intelligence (OSINT)
- Reverse Engineering
- Operations Security (OPSEC)
- Compliance
โ๏ธ Platforms & Infrastructure
๐ก Hardware, Wireless & Field Projects
- PNWC Cyberdeck
- Hardware Testing
- Hardware Hacking
- Software-Defined Radio
- Wardriving
- uConsole
- Space Security
๐งฐ Assessment & Field Reference
๐ฆ Downloads & Project Resources
๐๏ธ Additional Topics