XHCI(4)

📦 version 12.2, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ xhci(4) ✨

okay bestie, gather round, because today we're talking about xhci(4) — the manual page for the USB eXtensible Host Controller driver, and honestly? it's giving main character energy in your kernel. 🦋

🌸 NAME 🌸

xhci — the USB eXtensible Host Controller driver 💅

🎀 SYNOPSIS 🎀

device xhci

that's it. that's the whole vibe. drop it in your kernel config and you're slaying. ✨

💖 DESCRIPTION 💖

so the xhci driver is out here providing support for the USB eXtensible Host Controller Interface, and the way it does this is iconic: it lets you use USB 1.0, 2.0 and 3.0 devices all on the same USB port. no cap. one port, all your lil gadgets, living in harmony. 🫶

and when you plug in a USB 3.0 compliant device, the XHCI controller can carry USB connection speeds all the way up to 5.0Gbps. she's fast. she's THAT girl. 🔥

🌈 HARDWARE 🌈

the xhci driver supports XHCI compatible controllers — and specifically the ones rocking:

  • PCI class 12 (serial bus)
  • subclass 3 (USB)
  • programming interface 48 (XHCI)

if your controller has those three numbers, she's in. periodt. 👑

⭐ SYSCTL VARIABLES ⭐

these cuties are available as both sysctl(8) variables and loader(8) tunables, which is honestly so versatile of them:

  • hw.usb.xhci.debug — the debug output level. 0 means debugging is disabled, and bigger values make the debug messages chattier and chattier. default is 0. so like, keep it at zero unless you're actively snooping. 🙈

🦋 SEE ALSO 🦋

the whole USB fam, all linked up. iykyk. 💜

🎀 HISTORY 🎀

the xhci device driver first appeared in FreeBSD 8.2. a legend from day one, fr fr. ✨

and that's the tea, bestie! this lil page came to you from the Debian corner of the world, dated April 24, 2018 — go forth and plug things in responsibly. 💖🌸🎀
📦 where this page comes from