xref: /freebsd/share/man/man4/hrfkill.4 (revision d1c07141dccf8c719067bd3c30c402e4db9a77b3)
1e2d56447SAymeric Wibo.\"
2e2d56447SAymeric Wibo.\" SPDX-License-Identifier: BSD-2-Clause
3e2d56447SAymeric Wibo.\"
4e2d56447SAymeric Wibo.\" Copyright (c) 2026 The FreeBSD Foundation
5e2d56447SAymeric Wibo.\"
6e2d56447SAymeric Wibo.\" Portions of this software were developed by Aymeric Wibo
7e2d56447SAymeric Wibo.\" <obiwac@freebsd.org> under sponsorship from the FreeBSD Foundation.
8e2d56447SAymeric Wibo.\"
9e2d56447SAymeric Wibo.Dd June 24, 2026
10e2d56447SAymeric Wibo.Dt HRFKILL 4
11e2d56447SAymeric Wibo.Os
12e2d56447SAymeric Wibo.Sh NAME
13e2d56447SAymeric Wibo.Nm hrfkill
14e2d56447SAymeric Wibo.Nd HID radio control driver
15e2d56447SAymeric Wibo.Sh SYNOPSIS
16e2d56447SAymeric Wibo.Cd device hrfkill
17e2d56447SAymeric Wibo.Cd device hid
18e2d56447SAymeric Wibo.Cd device hidbus
19e2d56447SAymeric Wibo.Cd device hidmap
20e2d56447SAymeric Wibo.Cd device evdev
21e2d56447SAymeric WiboIn
22e2d56447SAymeric Wibo.Xr loader.conf 5 :
23e2d56447SAymeric Wibo.Cd hrfkill_load="YES"
24e2d56447SAymeric Wibo.Sh DESCRIPTION
25e2d56447SAymeric WiboThe
26e2d56447SAymeric Wibo.Nm
27e2d56447SAymeric Wibodriver provides support for HID wireless radio control buttons,
28e2d56447SAymeric Wibomost often found as an
29e2d56447SAymeric Wibo.Qq airplane mode
30e2d56447SAymeric Wiboor RFKILL toggle on laptop keyboards, and presents them to applications over the
31e2d56447SAymeric Wibo.Ar evdev
32e2d56447SAymeric Wibointerface.
33e2d56447SAymeric Wibo.Sh HARDWARE
34e2d56447SAymeric WiboThe
35e2d56447SAymeric Wibo.Nm
36e2d56447SAymeric Wibodriver supports HID radio control buttons and airplane mode keys
37e2d56447SAymeric Wiboon devices such as:
38e2d56447SAymeric Wibo.Pp
39e2d56447SAymeric Wibo.Bl -bullet -compact
40e2d56447SAymeric Wibo.It
41e2d56447SAymeric WiboFramework Laptop Keyboard
42e2d56447SAymeric Wibo.El
43e2d56447SAymeric Wibo.Sh FILES
44e2d56447SAymeric Wibo.Bl -tag -width /dev/input/event* -compact
45e2d56447SAymeric Wibo.It Pa /dev/input/event*
46e2d56447SAymeric Wiboinput event device node
47e2d56447SAymeric Wibo.El
48e2d56447SAymeric Wibo.Sh SEE ALSO
49e2d56447SAymeric Wibo.Xr hidbus 4 ,
50e2d56447SAymeric Wibo.Xr hsctrl 4
51e2d56447SAymeric Wibo.Sh HISTORY
52e2d56447SAymeric WiboThe
53e2d56447SAymeric Wibo.Nm
54e2d56447SAymeric Wibodriver first appeared in
55e2d56447SAymeric Wibo.Fx 16.0 .
56e2d56447SAymeric Wibo.Sh AUTHORS
57e2d56447SAymeric WiboThe
58e2d56447SAymeric Wibo.Nm
59e2d56447SAymeric Wibodriver was written by
60*d1c07141SRobert Clausecker.An Aymeric Wibo Aq Mt obiwac@FreeBSD.org
61e2d56447SAymeric Wibounder sponsorship from the FreeBSD Foundation and by
62e2d56447SAymeric Wibo.An Daniel Shaefer Aq Mt git@danielschaefer.me
63e2d56447SAymeric Wibounder sponsorship from Framework Computer Inc.
64e2d56447SAymeric Wibo.Sh CAVEATS
65e2d56447SAymeric WiboCurrently,
66e2d56447SAymeric Wibo.Nm
67e2d56447SAymeric Wiboonly handles radio button reporting.
68e2d56447SAymeric WiboThe HID Generic Desktop radio control page also defines radio switches and
69e2d56447SAymeric Wibostatus LEDs; support for these should be added in a future revision of the
70e2d56447SAymeric Wibodriver.
71e2d56447SAymeric Wibo.Pp
72e2d56447SAymeric Wibo.Fx
73e2d56447SAymeric Wibodoes not yet have a generic RFKILL framework analogous to the one found in
74e2d56447SAymeric WiboLinux.
75e2d56447SAymeric WiboAs a result,
76e2d56447SAymeric Wibo.Nm
77e2d56447SAymeric Wibocan only report radio button events to userspace via
78e2d56447SAymeric Wibo.Ar evdev ;
79e2d56447SAymeric Wibothe kernel itself has no mechanism to act on these events to block or unblock
80e2d56447SAymeric Wibowireless devices.
81e2d56447SAymeric WiboA future RFKILL framework would allow the driver to integrate directly with
82e2d56447SAymeric Wibonetwork interfaces and block transmitters in response to hardware events.
83