ASL / SignalLab - RF Executor : from-scratch setup bundle
==========================================================

GOAL
  Put a MediaTek MT7612U USB Wi-Fi adapter (Alfa AWUS036ACM, or the generic
  MT7612U dongle in the Hak5 AC bundle) into 802.11 MONITOR MODE + packet
  injection on a Windows PC -- by running it inside a small headless Linux VM
  that grabs the adapter over NATIVE USB passthrough. Reliable; no usbip, no WSL.

WHAT'S IN HERE
  rf-monitor-guide.pdf    The full step-by-step guide (print / read anywhere).
  rf-monitor-guide.html   The same guide as a web page.
  setup-rf-executor.ps1   One-shot automation: installs VirtualBox + Extension
                          Pack, builds the Ubuntu VM, installs the Wi-Fi tools,
                          and wires up USB passthrough + SSH. Re-runnable.
  alfa-dashboard\         A Windows dashboard (Node.js + PuTTY) to drive the adapter
                          from a browser: attach/monitor status, start/stop monitor
                          mode, and live scans of nearby access points & client
                          devices. Two selectable capture engines -- tcpdump
                          (reliable) and airodump (richer). Talks to the VM over SSH.
  start-dashboard.ps1     Launches that dashboard and opens it in your browser.

QUICK START
  1) Read rf-monitor-guide.pdf.
  2) Right-click PowerShell -> "Run as administrator", then:
        powershell -ExecutionPolicy Bypass -File .\setup-rf-executor.ps1
     (~20-30 min, mostly an unattended Ubuntu install that runs itself.)
  3) When it finishes: start the VM, plug in the adapter, and:
        ssh asl@localhost -p 2222        (password: aslrf123)
        sudo airmon-ng start wlan0       -> wlan0mon (type monitor)
  4) Optional dashboard (needs Node.js + PuTTY):
        .\start-dashboard.ps1            -> http://127.0.0.1:8790
        (pick the capture engine -- tcpdump or airodump -- in the UI)

REFERENCE
  VM name : asl-rf-executor
  Login   : asl / aslrf123
  SSH     : ssh asl@localhost -p 2222
  Adapter : MediaTek MT7612U  (USB VID 0e8d / PID 7612)

NOTE
  The adapter runs entirely inside the Linux VM; Windows only hosts it. When you
  plug the adapter in, it "disappears" from Windows -- that's correct: VirtualBox
  has handed it to the VM. The Alfa AWUS036ACM is the same chipset and works on
  this same VM identically.

  GOLDEN RULE: start the VM first, THEN plug in the adapter, and unplug it before
  any VM reboot. An adapter attached during boot can stall the VM's startup while
  the kernel enumerates it. Hot-plugging into a running VM is the safe path.

EXPERIMENTAL AWUS036AXML / MT7921U SUPPORT
  The dashboard recognizes Alfa AWUS036AXML hardware (USB VID 0e8d / PID 7961)
  and correctly reports its MT7921U driver, Wi-Fi 6E, and Bluetooth controller.
  A bounded dashboard validation on Linux 6.17 passed monitor mode, injection,
  and a tcpdump scan (31 APs and 2 client devices). Sustained monitor traffic can
  still trigger a VirtualBox xHCI kernel panic, so the AXML is experimental: use
  manual USB attachment for bounded tests and detach it before reboot. The
  AWUS036ACM / MT7612U remains the dependable executor radio.
