.\" Copyright (c) 2026 Abdelkader Boudih <[email protected]> .\" .\" SPDX-License-Identifier: BSD-2-Clause .\" .Dd February 13, 2026 .Dt APPLEIR 4 .Os .Sh NAME .Nm appleir .Nd Apple IR receiver driver .Sh SYNOPSIS To compile this driver into the kernel, place the following lines in your kernel configuration file: .Bd -ragged -offset indent .Cd "device appleir" .Cd "device hidbus" .Cd "device hid" .Cd "device evdev" .Ed .Pp Alternatively, to load the driver as a module at boot time, place the following line in .Xr loader.conf 5 Ns : .Bd -literal -offset indent appleir_load="YES" .Ed .Sh DESCRIPTION The .Nm driver provides support for Apple IR receivers found in Mac computers (2006-2011 era). It supports both Apple Remote controls and generic IR remotes using the NEC infrared protocol. .Pp Supported devices include: .Bl -bullet -compact .It Apple IR Receiver (USB product IDs 0x8240, 0x8241, 0x8242, 0x8243, 0x1440) .El .Pp The driver decodes proprietary Apple Remote button presses and provides a default keymap for common NEC protocol codes used by generic IR remotes. Unmapped button codes can be accessed via the raw HID device at .Pa /dev/hidrawX for custom userland remapping. .Pp The .Pa /dev/input/eventX device presents the remote control as an evdev input device with standard KEY_* codes suitable for media applications. .Sh HARDWARE The .Nm driver supports Apple IR receivers with USB vendor ID 0x05ac and the following product IDs: .Pp .Bl -tag -width "0x8242" -compact .It 0x8240 Apple IR Receiver (first generation) .It 0x8241 Apple IR Receiver .It 0x8242 Apple IR Receiver (Mac Mini 2011, MacBook Pro 3,1) .It 0x8243 Apple IR Receiver .It 0x1440 Apple IR Receiver (slim) .El .Sh FILES .Bl -tag -width ".Pa /dev/input/eventX" -compact .It Pa /dev/input/eventX evdev input device .It Pa /dev/hidrawX raw HID device for custom button mapping .El .Sh SEE ALSO evdev , .Xr hidbus 4 , .Xr usbhid 4 .Pp NEC Infrared Transmission Protocol: .Lk https://techdocs.altium.com/display/FPGA/NEC+Infrared+Transmission+Protocol .Sh HISTORY The .Nm driver first appeared in .Fx 16.0 . .Sh AUTHORS .An Abdelkader Boudih Aq Mt [email protected] .Pp Based on protocol reverse-engineering by James McKenzie and others.
