HIDBUS(4)

📦
version 15.1 · 2 versions
, in freebsd 15.1, nixpkgs unstable

💅 HIDBUS(4) 💅

ok so we're reading the Kernel Interfaces Manual today bestie, and this page is all about hidbus — the generic HID bus driver. yes it's as iconic as it sounds, let's get into it 🎀

✨ NAME ✨

hidbus — the generic HID bus driver. that's it, that's the whole name, and honestly? she ate. 🔥

✨ SYNOPSIS ✨

ok so if you wanna compile this driver into the kernel (yes, hard-mode, no modules, we love commitment 💪), you drop these lines into your kernel configuration file:

device hidbus
device hid

orrr, alternatively, if you'd rather load the driver as a module at boot time (the chill option, lowkey the move fr fr), you put this line in loader.conf(5):

hidbus_load="YES"

periodt. that's the whole setup 🫶

🦋 DESCRIPTION 🦋

so here's the vibe: the hidbus driver provides support for multiple HID driver attachments to a single HID transport backend. basically she's the main character middle-manager and she's slaying at it 👑

want the receipts? check out iichid(4) or usbhid(4).

now, each HID device can have several components — think a keyboard and a mouse sharing one device, like a little duo. these components use different report identifiers (that's a byte, okay, a single byte, no cap) which get combined into groups called collections, and the whole point of those collections is to distinguish which one the data is coming from. iykyk 💫

the hidbus driver has other drivers attached that handle particular kinds of devices, and hidbus broadcasts data to all of them. yes, all of them. she's generous like that 💜

🌸 SYSCTL VARIABLES 🌸

ok these next ones are available as both sysctl(8) variables and loader(8) tunables — double duty, we love a multitasker ✨

  • hw.hid.hidbus.debug — this is your debug output level. 0 means debugging is disabled (default, keep it cute and quiet 🤫) and larger values increase debug message verbosity. so like, the bigger the number, the more she talks. default is 0, obviously.

🎀 SEE ALSO 🎀

the whole friend group, in order, no one left out 💖

hconf(4), hcons(4), hgame(4), hidraw(4), hkbd(4), hms(4), hmt(4), hpen(4), hsctrl(4), hskbd(4), iichid(4), usbhid(4)

⭐ HISTORY ⭐

the hidbus driver first appeared in FreeBSD 13.0. she's a 13.0 girlie and we respect the origin story 🌈

👑 AUTHORS 👑

the hidbus driver was written by Vladimir Kondratyev <wulf@FreeBSD.org>. absolute legend behavior, thank you for your service 🙏✨

and that's the whole page bestie, you're officially caught up 💅

ngl this one's short and sweet — no scary warnings, no deprecated chaos, just a bus driver doing her thing 🍓

sign-off time: this page is from the Debian build of the manual, dated September 14, 2020 — so if something's moved since then, that's between you and the calendar bestie 😭💖

📦 where this page comes from