Investigation of why the Xbox Wireless Headset (2024 revision) cannot be used with the Xbox Wireless
Adapter for Windows (USB 045E:02FE): the headset says "paired", but Windows never sees it.
Result in one paragraph. The radio link, pairing and the first GIP exchanges work on Windows. The failure is in the GIP authentication: the headset answers Windows' version-1 style handshake with a version-3 request that the Windows stack does not handle; Windows resets the headset in a loop. A host that skips authentication gets audio and microphone working, but the headset drops the link after 15 to 30 seconds. This is a Windows-side support gap, not a hardware fault. Full write-up: docs/REPORT.md.
Status: research project. It does not make the headset usable on Windows. See the report for what is known, what is not, and what is asked of Microsoft.
| Path | Content |
|---|---|
docs/REPORT.md |
Technical report (findings, experiments, requests) |
docs/traces/ |
Anonymised decoded GIP timelines of each experiment |
docs/architecture.md |
How the proxy works |
docs/capturing.md |
How to capture the same traces (Linux usbmon, Windows USBPcap) |
gipproxy/ |
USB/IP proxy: MT76/GIP decoding, drop rules, headset host, virtual USB audio device |
tests/ |
25 offline tests (unit + end to end), built from anonymised real frames |
scripts/run-session.ps1 |
Starts a complete proxy session on Windows (elevated PowerShell) |
tools/ |
Helpers to anonymise fixtures and export publishable traces |
sensible/ |
Private and git-ignored: raw captures, session logs, notes. Never published |
Requires Python 3.11+ (standard library only), usbipd-win and usbip-win2 (kernel driver signed by Microsoft).
python -m unittest discover -s tests -t . # offline tests
.\scripts\run-session.ps1 # elevated: observe the stock Windows behaviour
.\scripts\run-session.ps1 -Rules drop-power-reset,drop-auth-reset # experiment B
.\scripts\run-session.ps1 -Takeover # experiment D: host without authentication
.\scripts\run-session.ps1 -Audio # experiment E: + virtual USB audio headsetThe script moves usbipd to port 3241 for the session (the usbip client cannot use another port than
3240), binds the dongle, starts the proxy and attaches the virtual copy of the dongle, then restores
everything when you press Enter. Logs go to sensible/logs/ (they contain MAC addresses and nearby
Wi-Fi frames: do not publish them).
GPL-2.0-or-later (see LICENSE). Large parts of the frame layouts and of the GIP host behaviour are ported
from xone (original author Severin von Wnuck-Lipinski), which
this work would not exist without. usbipd-win and usbip-win2 are used unmodified.
This project is not affiliated with Microsoft. "Xbox" is a trademark of Microsoft.