1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
|
<table class="head">
<tr>
<td class="head-ltitle">APPLEIR(4)</td>
<td class="head-vol">Device Drivers Manual</td>
<td class="head-rtitle">APPLEIR(4)</td>
</tr>
</table>
<div class="manual-text">
<section class="Sh">
<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
<p class="Pp"><code class="Nm">appleir</code> — <span class="Nd">Apple IR
receiver driver</span></p>
</section>
<section class="Sh">
<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
<p class="Pp">To compile this driver into the kernel, place the following lines
in your kernel configuration file:</p>
<div class="Bd Pp Bd-indent"><code class="Cd">device appleir</code>
<br/>
<code class="Cd">device hidbus</code>
<br/>
<code class="Cd">device hid</code>
<br/>
<code class="Cd">device evdev</code></div>
<p class="Pp">Alternatively, to load the driver as a module at boot time, place
the following line in <a class="Xr">loader.conf(5)</a>:</p>
<div class="Bd Pp Bd-indent Li">
<pre>appleir_load="YES"</pre>
</div>
</section>
<section class="Sh">
<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
<p class="Pp">The <code class="Nm">appleir</code> 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.</p>
<p class="Pp">Supported devices include:</p>
<ul class="Bl-bullet Bl-compact">
<li>Apple IR Receiver (USB product IDs 0x8240, 0x8241, 0x8242, 0x8243,
0x1440)</li>
</ul>
<p class="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
<span class="Pa">/dev/hidrawX</span> for custom userland remapping.</p>
<p class="Pp">The <span class="Pa">/dev/input/eventX</span> device presents the
remote control as an evdev input device with standard KEY_* codes suitable
for media applications.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="HARDWARE"><a class="permalink" href="#HARDWARE">HARDWARE</a></h1>
<p class="Pp">The <code class="Nm">appleir</code> driver supports Apple IR
receivers with USB vendor ID 0x05ac and the following product IDs:</p>
<p class="Pp"></p>
<dl class="Bl-tag Bl-compact">
<dt>0x8240</dt>
<dd>Apple IR Receiver (first generation)</dd>
<dt>0x8241</dt>
<dd>Apple IR Receiver</dd>
<dt>0x8242</dt>
<dd>Apple IR Receiver (Mac Mini 2011, MacBook Pro 3,1)</dd>
<dt>0x8243</dt>
<dd>Apple IR Receiver</dd>
<dt>0x1440</dt>
<dd>Apple IR Receiver (slim)</dd>
</dl>
</section>
<section class="Sh">
<h1 class="Sh" id="FILES"><a class="permalink" href="#FILES">FILES</a></h1>
<dl class="Bl-tag Bl-compact">
<dt><span class="Pa">/dev/input/eventX</span></dt>
<dd>evdev input device</dd>
<dt><span class="Pa">/dev/hidrawX</span></dt>
<dd>raw HID device for custom button mapping</dd>
</dl>
</section>
<section class="Sh">
<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
ALSO</a></h1>
<p class="Pp">evdev , <a class="Xr">hidbus(4)</a>,
<a class="Xr">usbhid(4)</a></p>
<p class="Pp">NEC Infrared Transmission Protocol:
<a class="Lk" href="https://techdocs.altium.com/display/FPGA/NEC+Infrared+Transmission+Protocol">https://techdocs.altium.com/display/FPGA/NEC+Infrared+Transmission+Protocol</a></p>
</section>
<section class="Sh">
<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
<p class="Pp">The <code class="Nm">appleir</code> driver first appeared in
<span class="Ux">FreeBSD 16.0</span>.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<p class="Pp"><span class="An">Abdelkader Boudih</span>
<<a class="Mt" href="mailto:freebsd@seuros.com">freebsd@seuros.com</a>></p>
<p class="Pp">Based on protocol reverse-engineering by James McKenzie and
others.</p>
</section>
</div>
<table class="foot">
<tr>
<td class="foot-date">February 13, 2026</td>
<td class="foot-os">FreeBSD 15.0</td>
</tr>
</table>
|
