hrfkill(4)

hrfkill4

Hid radio control driver

Usage

device hrfkill device hid device hidbus device hidmap device evdev In loader.conf(5): hrfkill_load="YES"

Overview

The hrfkill driver provides support for HID wireless radio control buttons, most often found as an "airplane mode" or RFKILL toggle on laptop keyboards, and presents them to applications over the evdev interface.

Hardware

The hrfkill driver supports HID radio control buttons and airplane mode keys on devices such as:

  • Framework Laptop Keyboard

Files

/dev/input/event*

input event device node

Caveats

Currently, hrfkill only handles radio button reporting. The HID Generic Desktop radio control page also defines radio switches and status LEDs; support for these should be added in a future revision of the driver.

FreeBSD does not yet have a generic RFKILL framework analogous to the one found in Linux. As a result, hrfkill can only report radio button events to userspace via evdev; the kernel itself has no mechanism to act on these events to block or unblock wireless devices. A future RFKILL framework would allow the driver to integrate directly with network interfaces and block transmitters in response to hardware events.

History

The hrfkill driver first appeared in FreeBSD 16.0.

Authors

The hrfkill driver was written by Aymeric Wibo ⟨[email protected]⟩ under sponsorship from the FreeBSD Foundation and by Daniel Shaefer ⟨[email protected]⟩ under sponsorship from Framework Computer Inc.

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.