USBHID(4)

πŸ“¦
version 15.1 Β· 3 versions
, in freebsd 15.1

πŸ’… USBHID(4) β€” the kernel interfaces manual, but make it cute

okay so bestie, welcome to usbhid(4) β€” that's the USB HID transport driver page from the Kernel Interfaces Manual, and I'm gonna walk you through it like we're texting at 2am 🫢


✨ NAME ✨

usbhid β€” the USB HID transport driver. that's it, that's the name, iconic πŸ’…


πŸ¦‹ SYNOPSIS πŸ¦‹

so like, if you wanna compile this driver into the kernel? you gotta place these lines in your kernel configuration file:

device usbhid

orrrr, alternatively, if you'd rather load the driver as a module at boot time (very lowkey of you), place this line in loader.conf(5):

usbhid_load="YES"

slay, either way works πŸ’–


🌸 DESCRIPTION 🌸

the usbhid driver provides an interface to USB Human Interface Devices, aka HIDs πŸŽ€ that's literally the whole vibe. it's the transport driver, it's the middleman, it's giving main character energy ✨


πŸ‘‘ SYSCTL VARIABLES πŸ‘‘

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

  • hw.usb.usbhid.enable β€” enables usbhid and makes its priority greater than other USB HID drivers, like ukbd(4), ums(4), and uhid(4). default is 1. she's enabled by default, periodt πŸ‘‘
  • hw.usb.usbhid.debug β€” the debug output level, where 0 means debugging is disabled and larger values increase debug message verbosity. default is 0. and ngl, those debug messages get printed on the system console and can be viewed using dmesg(8) πŸ”₯
πŸ’€ heads up bestie: if you crank up hw.usb.usbhid.debug, you're gonna get more verbose messages, and they show up on the system console β€” that's straight from the page, no cap.

🧚 SEE ALSO 🧚

the whole friend group showed up for this one, iykyk:

ehci(4), hkbd(4), hms(4), ohci(4), uhci(4), usb(4), xhci(4), usbconfig(8) 🌈


πŸ’œ HISTORY πŸ’œ

okay so storytime πŸ“– the usbhid driver first appeared in FreeBSD 13.0. and then it was enabled by default in FreeBSD 15.0. glow up fr fr ✨


πŸ“ AUTHORS πŸ“

the usbhid driver was written by Vladimir Kondratyev <wulf@FreeBSD.org> β€” thank you for your service king πŸ«‘πŸ’–


πŸŽ€ and that's the page!! this version came from Debian, dated October 2, 2025, filed under USBHID(4) in the Kernel Interfaces Manual. mwah, love u, go read your dmesg πŸ’‹βœ¨
πŸ“¦ where this page comes from
  • freebsd 15.1: base 15.1
  • πŸ’– girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms