Skip to content

0-iQpy/Vortex-U

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Vortex-U

Vortex-U v1.0.0

Vortex-U is a high-velocity, hybrid Wi-Fi security tool developed for the ESP32-U. It utilizes a custom dual-core injection engine that decouples the radio hardware from the standard OS network stack, achieving extreme packet rates while remaining resilient to system-level crashes.

The Vortex Engine

The core of this project is the Vortex Engine, which communicates directly with the radio silicon via esp_wifi_80211_tx.

  • Netstack Independence: Operates through 12308 netstack registration failures, firing raw frames even when the high-level OS reports critical errors.
  • Dual-Core Tasking: Core 0 is dedicated to high-priority injection, while Core 1 manages the WebUI and system controls.
  • Hardware Telemetry: Includes a real-time MHz detector that queries the silicon registers to verify clock frequency during active sessions.

Verified Performance Matrix

The following metrics represent the average throughput verified via internal ESP32-U hardware telemetry, utilizing an optimized 256-packet burst and 100µs internal delay.

Clock Mode Average Velocity (PPS) Performance Gain (%) Stability Profile
80 MHz ~8,212 PPS Baseline Maximum: Ideal for low-power or battery-powered field use.
160 MHz ~8,945 PPS +8.9% Balanced: The "Sweet Spot" for high-impact stability.
240 MHz ~9,238 PPS +12.5% Extreme: Maximum force for quick disruption bursts.

Installation & Setup

  1. Hardware: Developed specifically for the ESP32-U (external antenna version).
  2. Bypass Configuration: Ensure bypass.cpp is included in your build to wrap IEEE802.11 sanity checks.
  3. Flash: Standard Arduino IDE flash. Once active, connect to the Vortex-U AP and navigate to 192.168.4.1.
  4. Operational Reset: Due to the deep hardware reconfiguration used to switch MHz modes, a manual reset is recommended to return to the command console after an attack session.

Disclaimer: This project is for educational and authorized security testing purposes only. Usage on networks without explicit permission is illegal.

About

A high-velocity ESP32-U Wi-Fi research tool utilizing a dual-core "Vortex Engine" to achieve hardware-verified 9,238 PPS injection through real-time clock domain switching and netstack bypass.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages