Skip to content

About

Investigation of why the Xbox Wireless Headset (2024 revision) cannot be used with the Xbox Wireless Adapter for Windows.

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

xbox_dongle_fix

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.

What is in this repository

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

Quick start (observation only)

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 headset

The 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).

License and credits

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.

About

Investigation of why the Xbox Wireless Headset (2024 revision) cannot be used with the Xbox Wireless Adapter for Windows.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages