1 // SPDX-License-Identifier: GPL-2.0-or-later
2 /*
3 * USB HID quirks support for Linux
4 *
5 * Copyright (c) 1999 Andreas Gal
6 * Copyright (c) 2000-2005 Vojtech Pavlik <vojtech@suse.cz>
7 * Copyright (c) 2005 Michael Haboustak <mike-@cinci.rr.com> for Concept2, Inc
8 * Copyright (c) 2006-2007 Jiri Kosina
9 * Copyright (c) 2008 Jiri Slaby <jirislaby@gmail.com>
10 * Copyright (c) 2019 Paul Pawlowski <paul@mrarm.io>
11 * Copyright (c) 2023 Orlando Chamberlain <orlandoch.dev@gmail.com>
12 * Copyright (c) 2024 Aditya Garg <gargaditya08@live.com>
13 */
14
15 /*
16 */
17
18 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
19
20 #include <linux/device.h>
21 #include <linux/hid.h>
22 #include <linux/jiffies.h>
23 #include <linux/module.h>
24 #include <linux/slab.h>
25 #include <linux/timer.h>
26 #include <linux/string.h>
27 #include <linux/leds.h>
28 #include <dt-bindings/leds/common.h>
29
30 #include "hid-ids.h"
31
32 #define APPLE_RDESC_JIS BIT(0)
33 /* BIT(1) reserved, was: APPLE_IGNORE_MOUSE */
34 #define APPLE_HAS_FN BIT(2)
35 /* BIT(3) reserved, was: APPLE_HIDDEV */
36 #define APPLE_ISO_TILDE_QUIRK BIT(4)
37 #define APPLE_MIGHTYMOUSE BIT(5)
38 #define APPLE_INVERT_HWHEEL BIT(6)
39 /* BIT(7) reserved, was: APPLE_IGNORE_HIDINPUT */
40 #define APPLE_NUMLOCK_EMULATION BIT(8)
41 #define APPLE_RDESC_BATTERY BIT(9)
42 #define APPLE_BACKLIGHT_CTL BIT(10)
43 #define APPLE_IS_NON_APPLE BIT(11)
44 #define APPLE_MAGIC_BACKLIGHT BIT(12)
45 #define APPLE_DISABLE_FKEYS BIT(13)
46
47 #define APPLE_FLAG_FKEY BIT(0)
48 #define APPLE_FLAG_TB_FKEY BIT(1)
49
50 #define HID_COUNTRY_INTERNATIONAL_ISO 13
51 #define APPLE_BATTERY_TIMEOUT_SEC 60
52
53 #define HID_USAGE_MAGIC_BL 0xff00000f
54 #define APPLE_MAGIC_REPORT_ID_POWER 3
55 #define APPLE_MAGIC_REPORT_ID_BRIGHTNESS 1
56
57 static unsigned int fnmode = 3;
58 module_param(fnmode, uint, 0644);
59 MODULE_PARM_DESC(fnmode, "Mode of fn key on Apple keyboards (0 = disabled, "
60 "1 = fkeyslast, 2 = fkeysfirst, [3] = auto, 4 = fkeysdisabled)");
61
62 static int iso_layout = -1;
63 module_param(iso_layout, int, 0644);
64 MODULE_PARM_DESC(iso_layout, "Swap the backtick/tilde and greater-than/less-than keys. "
65 "([-1] = auto, 0 = disabled, 1 = enabled)");
66
67 static unsigned int swap_opt_cmd;
68 module_param(swap_opt_cmd, uint, 0644);
69 MODULE_PARM_DESC(swap_opt_cmd, "Swap the Option (\"Alt\") and Command (\"Flag\") keys. "
70 "(For people who want to keep Windows PC keyboard muscle memory. "
71 "[0] = as-is, Mac layout. 1 = swapped, Windows layout., 2 = swapped, Swap only left side)");
72
73 static unsigned int swap_ctrl_cmd;
74 module_param(swap_ctrl_cmd, uint, 0644);
75 MODULE_PARM_DESC(swap_ctrl_cmd, "Swap the Control (\"Ctrl\") and Command (\"Flag\") keys. "
76 "(For people who are used to Mac shortcuts involving Command instead of Control. "
77 "[0] = No change. 1 = Swapped.)");
78
79 static unsigned int swap_fn_leftctrl;
80 module_param(swap_fn_leftctrl, uint, 0644);
81 MODULE_PARM_DESC(swap_fn_leftctrl, "Swap the Fn and left Control keys. "
82 "(For people who want to keep PC keyboard muscle memory. "
83 "[0] = as-is, Mac layout, 1 = swapped, PC layout)");
84
85 struct apple_non_apple_keyboard {
86 char *name;
87 };
88
89 struct apple_sc_backlight {
90 struct led_classdev cdev;
91 struct hid_device *hdev;
92 };
93
94 struct apple_backlight_config_report {
95 u8 report_id;
96 u8 version;
97 u16 backlight_off, backlight_on_min, backlight_on_max;
98 };
99
100 struct apple_backlight_set_report {
101 u8 report_id;
102 u8 version;
103 u16 backlight;
104 u16 rate;
105 };
106
107 struct apple_magic_backlight {
108 struct led_classdev cdev;
109 struct hid_report *brightness;
110 struct hid_report *power;
111 };
112
113 struct apple_sc {
114 struct hid_device *hdev;
115 unsigned long quirks;
116 unsigned int fn_on;
117 unsigned int fn_found;
118 DECLARE_BITMAP(pressed_numlock, KEY_CNT);
119 struct timer_list battery_timer;
120 struct apple_sc_backlight *backlight;
121 };
122
123 struct apple_key_translation {
124 u16 from;
125 u16 to;
126 unsigned long flags;
127 };
128
129 static const struct apple_key_translation magic_keyboard_alu_fn_keys[] = {
130 { KEY_BACKSPACE, KEY_DELETE },
131 { KEY_ENTER, KEY_INSERT },
132 { KEY_F1, KEY_BRIGHTNESSDOWN, APPLE_FLAG_FKEY },
133 { KEY_F2, KEY_BRIGHTNESSUP, APPLE_FLAG_FKEY },
134 { KEY_F3, KEY_SCALE, APPLE_FLAG_FKEY },
135 { KEY_F4, KEY_DASHBOARD, APPLE_FLAG_FKEY },
136 { KEY_F6, KEY_NUMLOCK, APPLE_FLAG_FKEY },
137 { KEY_F7, KEY_PREVIOUSSONG, APPLE_FLAG_FKEY },
138 { KEY_F8, KEY_PLAYPAUSE, APPLE_FLAG_FKEY },
139 { KEY_F9, KEY_NEXTSONG, APPLE_FLAG_FKEY },
140 { KEY_F10, KEY_MUTE, APPLE_FLAG_FKEY },
141 { KEY_F11, KEY_VOLUMEDOWN, APPLE_FLAG_FKEY },
142 { KEY_F12, KEY_VOLUMEUP, APPLE_FLAG_FKEY },
143 { KEY_UP, KEY_PAGEUP },
144 { KEY_DOWN, KEY_PAGEDOWN },
145 { KEY_LEFT, KEY_HOME },
146 { KEY_RIGHT, KEY_END },
147 { }
148 };
149
150 static const struct apple_key_translation magic_keyboard_2015_fn_keys[] = {
151 { KEY_BACKSPACE, KEY_DELETE },
152 { KEY_ENTER, KEY_INSERT },
153 { KEY_F1, KEY_BRIGHTNESSDOWN, APPLE_FLAG_FKEY },
154 { KEY_F2, KEY_BRIGHTNESSUP, APPLE_FLAG_FKEY },
155 { KEY_F3, KEY_SCALE, APPLE_FLAG_FKEY },
156 { KEY_F4, KEY_DASHBOARD, APPLE_FLAG_FKEY },
157 { KEY_F7, KEY_PREVIOUSSONG, APPLE_FLAG_FKEY },
158 { KEY_F8, KEY_PLAYPAUSE, APPLE_FLAG_FKEY },
159 { KEY_F9, KEY_NEXTSONG, APPLE_FLAG_FKEY },
160 { KEY_F10, KEY_MUTE, APPLE_FLAG_FKEY },
161 { KEY_F11, KEY_VOLUMEDOWN, APPLE_FLAG_FKEY },
162 { KEY_F12, KEY_VOLUMEUP, APPLE_FLAG_FKEY },
163 { KEY_UP, KEY_PAGEUP },
164 { KEY_DOWN, KEY_PAGEDOWN },
165 { KEY_LEFT, KEY_HOME },
166 { KEY_RIGHT, KEY_END },
167 { }
168 };
169
170 static const struct apple_key_translation magic_keyboard_2021_and_2024_fn_keys[] = {
171 { KEY_BACKSPACE, KEY_DELETE },
172 { KEY_ENTER, KEY_INSERT },
173 { KEY_F1, KEY_BRIGHTNESSDOWN, APPLE_FLAG_FKEY },
174 { KEY_F2, KEY_BRIGHTNESSUP, APPLE_FLAG_FKEY },
175 { KEY_F3, KEY_SCALE, APPLE_FLAG_FKEY },
176 { KEY_F4, KEY_SEARCH, APPLE_FLAG_FKEY },
177 { KEY_F5, KEY_MICMUTE, APPLE_FLAG_FKEY },
178 { KEY_F6, KEY_SLEEP, APPLE_FLAG_FKEY },
179 { KEY_F7, KEY_PREVIOUSSONG, APPLE_FLAG_FKEY },
180 { KEY_F8, KEY_PLAYPAUSE, APPLE_FLAG_FKEY },
181 { KEY_F9, KEY_NEXTSONG, APPLE_FLAG_FKEY },
182 { KEY_F10, KEY_MUTE, APPLE_FLAG_FKEY },
183 { KEY_F11, KEY_VOLUMEDOWN, APPLE_FLAG_FKEY },
184 { KEY_F12, KEY_VOLUMEUP, APPLE_FLAG_FKEY },
185 { KEY_UP, KEY_PAGEUP },
186 { KEY_DOWN, KEY_PAGEDOWN },
187 { KEY_LEFT, KEY_HOME },
188 { KEY_RIGHT, KEY_END },
189 { }
190 };
191
192 static const struct apple_key_translation macbookair_fn_keys[] = {
193 { KEY_BACKSPACE, KEY_DELETE },
194 { KEY_ENTER, KEY_INSERT },
195 { KEY_F1, KEY_BRIGHTNESSDOWN, APPLE_FLAG_FKEY },
196 { KEY_F2, KEY_BRIGHTNESSUP, APPLE_FLAG_FKEY },
197 { KEY_F3, KEY_SCALE, APPLE_FLAG_FKEY },
198 { KEY_F4, KEY_DASHBOARD, APPLE_FLAG_FKEY },
199 { KEY_F6, KEY_PREVIOUSSONG, APPLE_FLAG_FKEY },
200 { KEY_F7, KEY_PLAYPAUSE, APPLE_FLAG_FKEY },
201 { KEY_F8, KEY_NEXTSONG, APPLE_FLAG_FKEY },
202 { KEY_F9, KEY_MUTE, APPLE_FLAG_FKEY },
203 { KEY_F10, KEY_VOLUMEDOWN, APPLE_FLAG_FKEY },
204 { KEY_F11, KEY_VOLUMEUP, APPLE_FLAG_FKEY },
205 { KEY_F12, KEY_EJECTCD, APPLE_FLAG_FKEY },
206 { KEY_UP, KEY_PAGEUP },
207 { KEY_DOWN, KEY_PAGEDOWN },
208 { KEY_LEFT, KEY_HOME },
209 { KEY_RIGHT, KEY_END },
210 { }
211 };
212
213 static const struct apple_key_translation macbookpro_no_esc_fn_keys[] = {
214 { KEY_BACKSPACE, KEY_DELETE },
215 { KEY_ENTER, KEY_INSERT },
216 { KEY_GRAVE, KEY_ESC, APPLE_FLAG_TB_FKEY },
217 { KEY_1, KEY_F1, APPLE_FLAG_TB_FKEY },
218 { KEY_2, KEY_F2, APPLE_FLAG_TB_FKEY },
219 { KEY_3, KEY_F3, APPLE_FLAG_TB_FKEY },
220 { KEY_4, KEY_F4, APPLE_FLAG_TB_FKEY },
221 { KEY_5, KEY_F5, APPLE_FLAG_TB_FKEY },
222 { KEY_6, KEY_F6, APPLE_FLAG_TB_FKEY },
223 { KEY_7, KEY_F7, APPLE_FLAG_TB_FKEY },
224 { KEY_8, KEY_F8, APPLE_FLAG_TB_FKEY },
225 { KEY_9, KEY_F9, APPLE_FLAG_TB_FKEY },
226 { KEY_0, KEY_F10, APPLE_FLAG_TB_FKEY },
227 { KEY_MINUS, KEY_F11, APPLE_FLAG_TB_FKEY },
228 { KEY_EQUAL, KEY_F12, APPLE_FLAG_TB_FKEY },
229 { KEY_UP, KEY_PAGEUP },
230 { KEY_DOWN, KEY_PAGEDOWN },
231 { KEY_LEFT, KEY_HOME },
232 { KEY_RIGHT, KEY_END },
233 { }
234 };
235
236 static const struct apple_key_translation macbookpro_dedicated_esc_fn_keys[] = {
237 { KEY_BACKSPACE, KEY_DELETE },
238 { KEY_ENTER, KEY_INSERT },
239 { KEY_1, KEY_F1, APPLE_FLAG_TB_FKEY },
240 { KEY_2, KEY_F2, APPLE_FLAG_TB_FKEY },
241 { KEY_3, KEY_F3, APPLE_FLAG_TB_FKEY },
242 { KEY_4, KEY_F4, APPLE_FLAG_TB_FKEY },
243 { KEY_5, KEY_F5, APPLE_FLAG_TB_FKEY },
244 { KEY_6, KEY_F6, APPLE_FLAG_TB_FKEY },
245 { KEY_7, KEY_F7, APPLE_FLAG_TB_FKEY },
246 { KEY_8, KEY_F8, APPLE_FLAG_TB_FKEY },
247 { KEY_9, KEY_F9, APPLE_FLAG_TB_FKEY },
248 { KEY_0, KEY_F10, APPLE_FLAG_TB_FKEY },
249 { KEY_MINUS, KEY_F11, APPLE_FLAG_TB_FKEY },
250 { KEY_EQUAL, KEY_F12, APPLE_FLAG_TB_FKEY },
251 { KEY_UP, KEY_PAGEUP },
252 { KEY_DOWN, KEY_PAGEDOWN },
253 { KEY_LEFT, KEY_HOME },
254 { KEY_RIGHT, KEY_END },
255 { }
256 };
257
258 static const struct apple_key_translation apple_fn_keys[] = {
259 { KEY_BACKSPACE, KEY_DELETE },
260 { KEY_ENTER, KEY_INSERT },
261 { KEY_F1, KEY_BRIGHTNESSDOWN, APPLE_FLAG_FKEY },
262 { KEY_F2, KEY_BRIGHTNESSUP, APPLE_FLAG_FKEY },
263 { KEY_F3, KEY_SCALE, APPLE_FLAG_FKEY },
264 { KEY_F4, KEY_DASHBOARD, APPLE_FLAG_FKEY },
265 { KEY_F5, KEY_KBDILLUMDOWN, APPLE_FLAG_FKEY },
266 { KEY_F6, KEY_KBDILLUMUP, APPLE_FLAG_FKEY },
267 { KEY_F7, KEY_PREVIOUSSONG, APPLE_FLAG_FKEY },
268 { KEY_F8, KEY_PLAYPAUSE, APPLE_FLAG_FKEY },
269 { KEY_F9, KEY_NEXTSONG, APPLE_FLAG_FKEY },
270 { KEY_F10, KEY_MUTE, APPLE_FLAG_FKEY },
271 { KEY_F11, KEY_VOLUMEDOWN, APPLE_FLAG_FKEY },
272 { KEY_F12, KEY_VOLUMEUP, APPLE_FLAG_FKEY },
273 { KEY_UP, KEY_PAGEUP },
274 { KEY_DOWN, KEY_PAGEDOWN },
275 { KEY_LEFT, KEY_HOME },
276 { KEY_RIGHT, KEY_END },
277 { }
278 };
279
280 static const struct apple_key_translation powerbook_fn_keys[] = {
281 { KEY_BACKSPACE, KEY_DELETE },
282 { KEY_F1, KEY_BRIGHTNESSDOWN, APPLE_FLAG_FKEY },
283 { KEY_F2, KEY_BRIGHTNESSUP, APPLE_FLAG_FKEY },
284 { KEY_F3, KEY_MUTE, APPLE_FLAG_FKEY },
285 { KEY_F4, KEY_VOLUMEDOWN, APPLE_FLAG_FKEY },
286 { KEY_F5, KEY_VOLUMEUP, APPLE_FLAG_FKEY },
287 { KEY_F6, KEY_NUMLOCK, APPLE_FLAG_FKEY },
288 { KEY_F7, KEY_SWITCHVIDEOMODE, APPLE_FLAG_FKEY },
289 { KEY_F8, KEY_KBDILLUMTOGGLE, APPLE_FLAG_FKEY },
290 { KEY_F9, KEY_KBDILLUMDOWN, APPLE_FLAG_FKEY },
291 { KEY_F10, KEY_KBDILLUMUP, APPLE_FLAG_FKEY },
292 { KEY_UP, KEY_PAGEUP },
293 { KEY_DOWN, KEY_PAGEDOWN },
294 { KEY_LEFT, KEY_HOME },
295 { KEY_RIGHT, KEY_END },
296 { }
297 };
298
299 static const struct apple_key_translation powerbook_numlock_keys[] = {
300 { KEY_J, KEY_KP1 },
301 { KEY_K, KEY_KP2 },
302 { KEY_L, KEY_KP3 },
303 { KEY_U, KEY_KP4 },
304 { KEY_I, KEY_KP5 },
305 { KEY_O, KEY_KP6 },
306 { KEY_7, KEY_KP7 },
307 { KEY_8, KEY_KP8 },
308 { KEY_9, KEY_KP9 },
309 { KEY_M, KEY_KP0 },
310 { KEY_DOT, KEY_KPDOT },
311 { KEY_SLASH, KEY_KPPLUS },
312 { KEY_SEMICOLON, KEY_KPMINUS },
313 { KEY_P, KEY_KPASTERISK },
314 { KEY_MINUS, KEY_KPEQUAL },
315 { KEY_0, KEY_KPSLASH },
316 { KEY_F6, KEY_NUMLOCK },
317 { KEY_KPENTER, KEY_KPENTER },
318 { KEY_BACKSPACE, KEY_BACKSPACE },
319 { }
320 };
321
322 static const struct apple_key_translation apple_iso_keyboard[] = {
323 { KEY_GRAVE, KEY_102ND },
324 { KEY_102ND, KEY_GRAVE },
325 { }
326 };
327
328 static const struct apple_key_translation swapped_option_cmd_keys[] = {
329 { KEY_LEFTALT, KEY_LEFTMETA },
330 { KEY_LEFTMETA, KEY_LEFTALT },
331 { KEY_RIGHTALT, KEY_RIGHTMETA },
332 { KEY_RIGHTMETA, KEY_RIGHTALT },
333 { }
334 };
335
336 static const struct apple_key_translation swapped_option_cmd_left_keys[] = {
337 { KEY_LEFTALT, KEY_LEFTMETA },
338 { KEY_LEFTMETA, KEY_LEFTALT },
339 { }
340 };
341
342 static const struct apple_key_translation swapped_ctrl_cmd_keys[] = {
343 { KEY_LEFTCTRL, KEY_LEFTMETA },
344 { KEY_LEFTMETA, KEY_LEFTCTRL },
345 { KEY_RIGHTCTRL, KEY_RIGHTMETA },
346 { KEY_RIGHTMETA, KEY_RIGHTCTRL },
347 { }
348 };
349
350 static const struct apple_key_translation swapped_fn_leftctrl_keys[] = {
351 { KEY_FN, KEY_LEFTCTRL },
352 { KEY_LEFTCTRL, KEY_FN },
353 { }
354 };
355
356 static const struct apple_non_apple_keyboard non_apple_keyboards[] = {
357 { "SONiX KN85 Keyboard" },
358 { "SONiX USB DEVICE" },
359 { "SONiX AK870 PRO" },
360 { "Keychron" },
361 { "AONE" },
362 { "GANSS" },
363 { "Hailuck" },
364 { "Jamesdonkey" },
365 { "A3R" },
366 { "hfd.cn" },
367 { "WKB603" },
368 { "TH87" }, /* EPOMAKER TH87 BT mode */
369 { "HFD Epomaker TH87" }, /* EPOMAKER TH87 USB mode */
370 { "2.4G Wireless Receiver" }, /* EPOMAKER TH87 dongle */
371 };
372
apple_is_non_apple_keyboard(struct hid_device * hdev)373 static bool apple_is_non_apple_keyboard(struct hid_device *hdev)
374 {
375 int i;
376
377 for (i = 0; i < ARRAY_SIZE(non_apple_keyboards); i++) {
378 char *non_apple = non_apple_keyboards[i].name;
379
380 if (strncmp(hdev->name, non_apple, strlen(non_apple)) == 0)
381 return true;
382 }
383
384 return false;
385 }
386
apple_is_omoton_kb066(struct hid_device * hdev)387 static bool apple_is_omoton_kb066(struct hid_device *hdev)
388 {
389 return hdev->product == USB_DEVICE_ID_APPLE_ALU_WIRELESS_ANSI &&
390 strcmp(hdev->name, "Bluetooth Keyboard") == 0;
391 }
392
apple_setup_key_translation(struct input_dev * input,const struct apple_key_translation * table)393 static inline void apple_setup_key_translation(struct input_dev *input,
394 const struct apple_key_translation *table)
395 {
396 const struct apple_key_translation *trans;
397
398 for (trans = table; trans->from; trans++)
399 set_bit(trans->to, input->keybit);
400 }
401
apple_find_translation(const struct apple_key_translation * table,u16 from)402 static const struct apple_key_translation *apple_find_translation(
403 const struct apple_key_translation *table, u16 from)
404 {
405 const struct apple_key_translation *trans;
406
407 /* Look for the translation */
408 for (trans = table; trans->from; trans++)
409 if (trans->from == from)
410 return trans;
411
412 return NULL;
413 }
414
input_event_with_scancode(struct input_dev * input,__u8 type,__u16 code,unsigned int hid,__s32 value)415 static void input_event_with_scancode(struct input_dev *input,
416 __u8 type, __u16 code, unsigned int hid, __s32 value)
417 {
418 if (type == EV_KEY &&
419 (!test_bit(code, input->key)) == value)
420 input_event(input, EV_MSC, MSC_SCAN, hid);
421 input_event(input, type, code, value);
422 }
423
hidinput_apple_event(struct hid_device * hid,struct input_dev * input,struct hid_usage * usage,__s32 value)424 static int hidinput_apple_event(struct hid_device *hid, struct input_dev *input,
425 struct hid_usage *usage, __s32 value)
426 {
427 struct apple_sc *asc = hid_get_drvdata(hid);
428 const struct apple_key_translation *trans, *table;
429 bool do_translate;
430 u16 code = usage->code;
431 unsigned int real_fnmode;
432
433 if (fnmode == 3) {
434 if (asc->quirks & APPLE_DISABLE_FKEYS)
435 real_fnmode = 4;
436 else if (asc->quirks & APPLE_IS_NON_APPLE)
437 real_fnmode = 2;
438 else
439 real_fnmode = 1;
440 } else {
441 real_fnmode = fnmode;
442 }
443
444 if (swap_fn_leftctrl) {
445 trans = apple_find_translation(swapped_fn_leftctrl_keys, code);
446
447 if (trans)
448 code = trans->to;
449 }
450
451 if (iso_layout > 0 || (iso_layout < 0 && (asc->quirks & APPLE_ISO_TILDE_QUIRK) &&
452 hid->country == HID_COUNTRY_INTERNATIONAL_ISO)) {
453 trans = apple_find_translation(apple_iso_keyboard, code);
454
455 if (trans)
456 code = trans->to;
457 }
458
459 if (swap_opt_cmd) {
460 if (swap_opt_cmd == 2)
461 trans = apple_find_translation(swapped_option_cmd_left_keys, code);
462 else
463 trans = apple_find_translation(swapped_option_cmd_keys, code);
464
465 if (trans)
466 code = trans->to;
467 }
468
469 if (swap_ctrl_cmd) {
470 trans = apple_find_translation(swapped_ctrl_cmd_keys, code);
471
472 if (trans)
473 code = trans->to;
474 }
475
476 if (code == KEY_FN)
477 asc->fn_on = !!value;
478
479 if (real_fnmode) {
480 switch (hid->product) {
481 case USB_DEVICE_ID_APPLE_ALU_WIRELESS_ANSI:
482 case USB_DEVICE_ID_APPLE_ALU_WIRELESS_ISO:
483 case USB_DEVICE_ID_APPLE_ALU_WIRELESS_JIS:
484 case USB_DEVICE_ID_APPLE_ALU_WIRELESS_2009_ANSI:
485 case USB_DEVICE_ID_APPLE_ALU_WIRELESS_2009_ISO:
486 case USB_DEVICE_ID_APPLE_ALU_WIRELESS_2009_JIS:
487 case USB_DEVICE_ID_APPLE_ALU_WIRELESS_2011_ANSI:
488 case USB_DEVICE_ID_APPLE_ALU_WIRELESS_2011_ISO:
489 case USB_DEVICE_ID_APPLE_ALU_WIRELESS_2011_JIS:
490 table = magic_keyboard_alu_fn_keys;
491 break;
492 case USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_2015:
493 case USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_NUMPAD_2015:
494 table = magic_keyboard_2015_fn_keys;
495 break;
496 case USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_2021:
497 case USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_FINGERPRINT_2021:
498 case USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_NUMPAD_2021:
499 case USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_2024:
500 case USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_FINGERPRINT_2024:
501 case USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_NUMPAD_2024:
502 table = magic_keyboard_2021_and_2024_fn_keys;
503 break;
504 case USB_DEVICE_ID_APPLE_WELLSPRINGT2_J132:
505 case USB_DEVICE_ID_APPLE_WELLSPRINGT2_J213:
506 case USB_DEVICE_ID_APPLE_WELLSPRINGT2_J680:
507 case USB_DEVICE_ID_APPLE_WELLSPRINGT2_J680_ALT:
508 table = macbookpro_no_esc_fn_keys;
509 break;
510 case USB_DEVICE_ID_APPLE_WELLSPRINGT2_J152F:
511 case USB_DEVICE_ID_APPLE_WELLSPRINGT2_J214K:
512 case USB_DEVICE_ID_APPLE_WELLSPRINGT2_J223:
513 table = macbookpro_dedicated_esc_fn_keys;
514 break;
515 case USB_DEVICE_ID_APPLE_WELLSPRINGT2_J140K:
516 case USB_DEVICE_ID_APPLE_WELLSPRINGT2_J230K:
517 table = apple_fn_keys;
518 break;
519 default:
520 if (hid->product >= USB_DEVICE_ID_APPLE_WELLSPRING4_ANSI &&
521 hid->product <= USB_DEVICE_ID_APPLE_WELLSPRING4A_JIS)
522 table = macbookair_fn_keys;
523 else if (hid->product < 0x21d || hid->product >= 0x300)
524 table = powerbook_fn_keys;
525 else
526 table = apple_fn_keys;
527 }
528
529 trans = apple_find_translation(table, code);
530
531 if (trans) {
532 bool from_is_set = test_bit(trans->from, input->key);
533 bool to_is_set = test_bit(trans->to, input->key);
534
535 if (from_is_set)
536 code = trans->from;
537 else if (to_is_set)
538 code = trans->to;
539
540 if (!(from_is_set || to_is_set)) {
541 if (trans->flags & APPLE_FLAG_FKEY) {
542 switch (real_fnmode) {
543 case 1:
544 do_translate = !asc->fn_on;
545 break;
546 case 2:
547 do_translate = asc->fn_on;
548 break;
549 default:
550 /* case 4 */
551 do_translate = false;
552 }
553 } else if (trans->flags & APPLE_FLAG_TB_FKEY) {
554 switch (real_fnmode) {
555 case 4:
556 do_translate = false;
557 break;
558 default:
559 do_translate = asc->fn_on;
560 }
561 } else {
562 do_translate = asc->fn_on;
563 }
564
565 if (do_translate)
566 code = trans->to;
567 }
568 }
569
570 if (asc->quirks & APPLE_NUMLOCK_EMULATION &&
571 (test_bit(code, asc->pressed_numlock) ||
572 test_bit(LED_NUML, input->led))) {
573 trans = apple_find_translation(powerbook_numlock_keys, code);
574
575 if (trans) {
576 if (value)
577 set_bit(code, asc->pressed_numlock);
578 else
579 clear_bit(code, asc->pressed_numlock);
580
581 code = trans->to;
582 }
583 }
584 }
585
586 if (usage->code != code) {
587 input_event_with_scancode(input, usage->type, code, usage->hid, value);
588
589 return 1;
590 }
591
592 return 0;
593 }
594
apple_event(struct hid_device * hdev,struct hid_field * field,struct hid_usage * usage,__s32 value)595 static int apple_event(struct hid_device *hdev, struct hid_field *field,
596 struct hid_usage *usage, __s32 value)
597 {
598 struct apple_sc *asc = hid_get_drvdata(hdev);
599
600 if (!(hdev->claimed & HID_CLAIMED_INPUT) || !field->hidinput ||
601 !usage->type)
602 return 0;
603
604 if ((asc->quirks & APPLE_INVERT_HWHEEL) &&
605 usage->code == REL_HWHEEL) {
606 input_event_with_scancode(field->hidinput->input, usage->type,
607 usage->code, usage->hid, -value);
608 return 1;
609 }
610
611 if ((asc->quirks & APPLE_HAS_FN) &&
612 hidinput_apple_event(hdev, field->hidinput->input,
613 usage, value))
614 return 1;
615
616
617 return 0;
618 }
619
apple_fetch_battery(struct hid_device * hdev)620 static int apple_fetch_battery(struct hid_device *hdev)
621 {
622 #ifdef CONFIG_HID_BATTERY_STRENGTH
623 struct apple_sc *asc = hid_get_drvdata(hdev);
624 struct hid_report_enum *report_enum;
625 struct hid_report *report;
626 struct hid_battery *bat;
627
628 bat = hid_get_battery(hdev);
629 if (!(asc->quirks & APPLE_RDESC_BATTERY) || !bat)
630 return -1;
631
632 report_enum = &hdev->report_enum[bat->report_type];
633 report = report_enum->report_id_hash[bat->report_id];
634
635 if (!report || report->maxfield < 1)
636 return -1;
637
638 if (bat->capacity == bat->max)
639 return -1;
640
641 hid_hw_request(hdev, report, HID_REQ_GET_REPORT);
642 return 0;
643 #else
644 return -1;
645 #endif
646 }
647
apple_battery_timer_tick(struct timer_list * t)648 static void apple_battery_timer_tick(struct timer_list *t)
649 {
650 struct apple_sc *asc = timer_container_of(asc, t, battery_timer);
651 struct hid_device *hdev = asc->hdev;
652
653 if (apple_fetch_battery(hdev) == 0) {
654 mod_timer(&asc->battery_timer,
655 jiffies + secs_to_jiffies(APPLE_BATTERY_TIMEOUT_SEC));
656 }
657 }
658
659 /*
660 * MacBook JIS keyboard has wrong logical maximum
661 * Magic Keyboard JIS has wrong logical maximum
662 */
apple_report_fixup(struct hid_device * hdev,__u8 * rdesc,unsigned int * rsize)663 static const __u8 *apple_report_fixup(struct hid_device *hdev, __u8 *rdesc,
664 unsigned int *rsize)
665 {
666 struct apple_sc *asc = hid_get_drvdata(hdev);
667
668 if(*rsize >=71 && rdesc[70] == 0x65 && rdesc[64] == 0x65) {
669 hid_info(hdev,
670 "fixing up Magic Keyboard JIS report descriptor\n");
671 rdesc[64] = rdesc[70] = 0xe7;
672 }
673
674 if ((asc->quirks & APPLE_RDESC_JIS) && *rsize >= 60 &&
675 rdesc[53] == 0x65 && rdesc[59] == 0x65) {
676 hid_info(hdev,
677 "fixing up MacBook JIS keyboard report descriptor\n");
678 rdesc[53] = rdesc[59] = 0xe7;
679 }
680
681 /*
682 * Change the usage from:
683 * 0x06, 0x00, 0xff, // Usage Page (Vendor Defined Page 1) 0
684 * 0x09, 0x0b, // Usage (Vendor Usage 0x0b) 3
685 * To:
686 * 0x05, 0x01, // Usage Page (Generic Desktop) 0
687 * 0x09, 0x06, // Usage (Keyboard) 2
688 */
689 if ((asc->quirks & APPLE_RDESC_BATTERY) && *rsize == 83 &&
690 rdesc[46] == 0x84 && rdesc[58] == 0x85) {
691 hid_info(hdev,
692 "fixing up Magic Keyboard battery report descriptor\n");
693 *rsize = *rsize - 1;
694 rdesc = rdesc + 1;
695
696 rdesc[0] = 0x05;
697 rdesc[1] = 0x01;
698 rdesc[2] = 0x09;
699 rdesc[3] = 0x06;
700 }
701
702 return rdesc;
703 }
704
apple_setup_input(struct input_dev * input)705 static void apple_setup_input(struct input_dev *input)
706 {
707 set_bit(KEY_NUMLOCK, input->keybit);
708
709 /* Enable all needed keys */
710 apple_setup_key_translation(input, apple_fn_keys);
711 apple_setup_key_translation(input, powerbook_fn_keys);
712 apple_setup_key_translation(input, powerbook_numlock_keys);
713 apple_setup_key_translation(input, apple_iso_keyboard);
714 apple_setup_key_translation(input, magic_keyboard_alu_fn_keys);
715 apple_setup_key_translation(input, magic_keyboard_2015_fn_keys);
716 apple_setup_key_translation(input, magic_keyboard_2021_and_2024_fn_keys);
717 apple_setup_key_translation(input, macbookpro_no_esc_fn_keys);
718 apple_setup_key_translation(input, macbookpro_dedicated_esc_fn_keys);
719 }
720
apple_input_mapping(struct hid_device * hdev,struct hid_input * hi,struct hid_field * field,struct hid_usage * usage,unsigned long ** bit,int * max)721 static int apple_input_mapping(struct hid_device *hdev, struct hid_input *hi,
722 struct hid_field *field, struct hid_usage *usage,
723 unsigned long **bit, int *max)
724 {
725 struct apple_sc *asc = hid_get_drvdata(hdev);
726
727 if (usage->hid == (HID_UP_CUSTOM | 0x0003) ||
728 usage->hid == (HID_UP_MSVENDOR | 0x0003) ||
729 usage->hid == (HID_UP_HPVENDOR2 | 0x0003)) {
730 /* The fn key on Apple USB keyboards */
731 set_bit(EV_REP, hi->input->evbit);
732 hid_map_usage_clear(hi, usage, bit, max, EV_KEY, KEY_FN);
733 asc->fn_found = true;
734 apple_setup_input(hi->input);
735 return 1;
736 }
737
738 /* we want the hid layer to go through standard path (set and ignore) */
739 return 0;
740 }
741
apple_input_mapped(struct hid_device * hdev,struct hid_input * hi,struct hid_field * field,struct hid_usage * usage,unsigned long ** bit,int * max)742 static int apple_input_mapped(struct hid_device *hdev, struct hid_input *hi,
743 struct hid_field *field, struct hid_usage *usage,
744 unsigned long **bit, int *max)
745 {
746 struct apple_sc *asc = hid_get_drvdata(hdev);
747
748 if (asc->quirks & APPLE_MIGHTYMOUSE) {
749 if (usage->hid == HID_GD_Z)
750 hid_map_usage(hi, usage, bit, max, EV_REL, REL_HWHEEL);
751 else if (usage->code == BTN_1)
752 hid_map_usage(hi, usage, bit, max, EV_KEY, BTN_2);
753 else if (usage->code == BTN_2)
754 hid_map_usage(hi, usage, bit, max, EV_KEY, BTN_1);
755 }
756
757 return 0;
758 }
759
apple_input_configured(struct hid_device * hdev,struct hid_input * hidinput)760 static int apple_input_configured(struct hid_device *hdev,
761 struct hid_input *hidinput)
762 {
763 struct apple_sc *asc = hid_get_drvdata(hdev);
764
765 if (((asc->quirks & APPLE_HAS_FN) && !asc->fn_found) || apple_is_omoton_kb066(hdev)) {
766 hid_info(hdev, "Fn key not found (Apple Wireless Keyboard clone?), disabling Fn key handling\n");
767 asc->quirks &= ~APPLE_HAS_FN;
768 }
769
770 if (apple_is_non_apple_keyboard(hdev)) {
771 hid_info(hdev, "Non-apple keyboard detected; function keys will default to fnmode=2 behavior\n");
772 asc->quirks |= APPLE_IS_NON_APPLE;
773 }
774
775 return 0;
776 }
777
apple_backlight_check_support(struct hid_device * hdev)778 static bool apple_backlight_check_support(struct hid_device *hdev)
779 {
780 int i;
781 unsigned int hid;
782 struct hid_report *report;
783
784 list_for_each_entry(report, &hdev->report_enum[HID_INPUT_REPORT].report_list, list) {
785 for (i = 0; i < report->maxfield; i++) {
786 hid = report->field[i]->usage->hid;
787 if ((hid & HID_USAGE_PAGE) == HID_UP_MSVENDOR && (hid & HID_USAGE) == 0xf)
788 return true;
789 }
790 }
791
792 return false;
793 }
794
apple_backlight_set(struct hid_device * hdev,u16 value,u16 rate)795 static int apple_backlight_set(struct hid_device *hdev, u16 value, u16 rate)
796 {
797 int ret = 0;
798 struct apple_backlight_set_report *rep;
799
800 rep = kmalloc_obj(*rep);
801 if (rep == NULL)
802 return -ENOMEM;
803
804 rep->report_id = 0xB0;
805 rep->version = 1;
806 rep->backlight = value;
807 rep->rate = rate;
808
809 ret = hid_hw_raw_request(hdev, 0xB0u, (u8 *) rep, sizeof(*rep),
810 HID_OUTPUT_REPORT, HID_REQ_SET_REPORT);
811
812 kfree(rep);
813 return ret;
814 }
815
apple_backlight_led_set(struct led_classdev * led_cdev,enum led_brightness brightness)816 static int apple_backlight_led_set(struct led_classdev *led_cdev,
817 enum led_brightness brightness)
818 {
819 struct apple_sc_backlight *backlight = container_of(led_cdev,
820 struct apple_sc_backlight, cdev);
821
822 return apple_backlight_set(backlight->hdev, brightness, 0);
823 }
824
apple_backlight_init(struct hid_device * hdev)825 static int apple_backlight_init(struct hid_device *hdev)
826 {
827 int ret;
828 struct apple_sc *asc = hid_get_drvdata(hdev);
829 struct apple_backlight_config_report *rep;
830
831 if (!apple_backlight_check_support(hdev))
832 return -EINVAL;
833
834 rep = kmalloc(0x200, GFP_KERNEL);
835 if (rep == NULL)
836 return -ENOMEM;
837
838 ret = hid_hw_raw_request(hdev, 0xBFu, (u8 *) rep, sizeof(*rep),
839 HID_FEATURE_REPORT, HID_REQ_GET_REPORT);
840 if (ret < 0) {
841 hid_err(hdev, "backlight request failed: %d\n", ret);
842 goto cleanup_and_exit;
843 }
844 if (ret < 8 || rep->version != 1) {
845 hid_err(hdev, "backlight config struct: bad version %i\n", rep->version);
846 ret = -EINVAL;
847 goto cleanup_and_exit;
848 }
849
850 hid_dbg(hdev, "backlight config: off=%u, on_min=%u, on_max=%u\n",
851 rep->backlight_off, rep->backlight_on_min, rep->backlight_on_max);
852
853 asc->backlight = devm_kzalloc(&hdev->dev, sizeof(*asc->backlight), GFP_KERNEL);
854 if (!asc->backlight) {
855 ret = -ENOMEM;
856 goto cleanup_and_exit;
857 }
858
859 asc->backlight->hdev = hdev;
860 asc->backlight->cdev.name = "apple::kbd_backlight";
861 asc->backlight->cdev.max_brightness = rep->backlight_on_max;
862 asc->backlight->cdev.brightness_set_blocking = apple_backlight_led_set;
863 asc->backlight->cdev.flags = LED_CORE_SUSPENDRESUME;
864
865 ret = apple_backlight_set(hdev, 0, 0);
866 if (ret < 0) {
867 hid_err(hdev, "backlight set request failed: %d\n", ret);
868 goto cleanup_and_exit;
869 }
870
871 ret = devm_led_classdev_register(&hdev->dev, &asc->backlight->cdev);
872
873 cleanup_and_exit:
874 kfree(rep);
875 return ret;
876 }
877
apple_magic_backlight_report_set(struct hid_report * rep,s32 value,u8 rate)878 static void apple_magic_backlight_report_set(struct hid_report *rep, s32 value, u8 rate)
879 {
880 rep->field[0]->value[0] = value;
881 rep->field[1]->value[0] = 0x5e; /* Mimic Windows */
882 rep->field[1]->value[0] |= rate << 8;
883
884 hid_hw_request(rep->device, rep, HID_REQ_SET_REPORT);
885 }
886
apple_magic_backlight_set(struct apple_magic_backlight * backlight,int brightness,char rate)887 static void apple_magic_backlight_set(struct apple_magic_backlight *backlight,
888 int brightness, char rate)
889 {
890 apple_magic_backlight_report_set(backlight->power, brightness ? 1 : 0, rate);
891 if (brightness)
892 apple_magic_backlight_report_set(backlight->brightness, brightness, rate);
893 }
894
apple_magic_backlight_led_set(struct led_classdev * led_cdev,enum led_brightness brightness)895 static int apple_magic_backlight_led_set(struct led_classdev *led_cdev,
896 enum led_brightness brightness)
897 {
898 struct apple_magic_backlight *backlight = container_of(led_cdev,
899 struct apple_magic_backlight, cdev);
900
901 apple_magic_backlight_set(backlight, brightness, 1);
902 return 0;
903 }
904
apple_magic_backlight_init(struct hid_device * hdev)905 static int apple_magic_backlight_init(struct hid_device *hdev)
906 {
907 struct apple_magic_backlight *backlight;
908 struct hid_report_enum *report_enum;
909
910 /*
911 * Ensure this usb endpoint is for the keyboard backlight, not touchbar
912 * backlight.
913 */
914 if (hdev->collection[0].usage != HID_USAGE_MAGIC_BL)
915 return -ENODEV;
916
917 backlight = devm_kzalloc(&hdev->dev, sizeof(*backlight), GFP_KERNEL);
918 if (!backlight)
919 return -ENOMEM;
920
921 report_enum = &hdev->report_enum[HID_FEATURE_REPORT];
922 backlight->brightness = report_enum->report_id_hash[APPLE_MAGIC_REPORT_ID_BRIGHTNESS];
923 backlight->power = report_enum->report_id_hash[APPLE_MAGIC_REPORT_ID_POWER];
924
925 if (!backlight->brightness || backlight->brightness->maxfield < 2 ||
926 !backlight->power || backlight->power->maxfield < 2)
927 return -ENODEV;
928
929 backlight->cdev.name = ":white:" LED_FUNCTION_KBD_BACKLIGHT;
930 backlight->cdev.max_brightness = backlight->brightness->field[0]->logical_maximum;
931 backlight->cdev.brightness_set_blocking = apple_magic_backlight_led_set;
932 backlight->cdev.flags = LED_CORE_SUSPENDRESUME;
933
934 apple_magic_backlight_set(backlight, 0, 0);
935
936 return devm_led_classdev_register(&hdev->dev, &backlight->cdev);
937
938 }
939
apple_probe(struct hid_device * hdev,const struct hid_device_id * id)940 static int apple_probe(struct hid_device *hdev,
941 const struct hid_device_id *id)
942 {
943 unsigned long quirks = id->driver_data;
944 struct apple_sc *asc;
945 int ret;
946
947 asc = devm_kzalloc(&hdev->dev, sizeof(*asc), GFP_KERNEL);
948 if (asc == NULL) {
949 hid_err(hdev, "can't alloc apple descriptor\n");
950 return -ENOMEM;
951 }
952
953 asc->hdev = hdev;
954 asc->quirks = quirks;
955
956 hid_set_drvdata(hdev, asc);
957
958 ret = hid_parse(hdev);
959 if (ret) {
960 hid_err(hdev, "parse failed\n");
961 return ret;
962 }
963
964 ret = hid_hw_start(hdev, HID_CONNECT_DEFAULT);
965 if (ret) {
966 hid_err(hdev, "hw start failed\n");
967 return ret;
968 }
969
970 if (quirks & APPLE_RDESC_BATTERY) {
971 timer_setup(&asc->battery_timer, apple_battery_timer_tick, 0);
972 mod_timer(&asc->battery_timer,
973 jiffies + secs_to_jiffies(APPLE_BATTERY_TIMEOUT_SEC));
974 apple_fetch_battery(hdev);
975 }
976
977 if (quirks & APPLE_BACKLIGHT_CTL)
978 apple_backlight_init(hdev);
979
980 if (quirks & APPLE_MAGIC_BACKLIGHT) {
981 ret = apple_magic_backlight_init(hdev);
982 if (ret)
983 goto out_err;
984 }
985
986 return 0;
987
988 out_err:
989 if (quirks & APPLE_RDESC_BATTERY)
990 timer_delete_sync(&asc->battery_timer);
991
992 hid_hw_stop(hdev);
993 return ret;
994 }
995
apple_remove(struct hid_device * hdev)996 static void apple_remove(struct hid_device *hdev)
997 {
998 struct apple_sc *asc = hid_get_drvdata(hdev);
999
1000 if (asc->quirks & APPLE_RDESC_BATTERY)
1001 timer_delete_sync(&asc->battery_timer);
1002
1003 hid_hw_stop(hdev);
1004 }
1005
1006 static const struct hid_device_id apple_devices[] = {
1007 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_MIGHTYMOUSE),
1008 .driver_data = APPLE_MIGHTYMOUSE | APPLE_INVERT_HWHEEL },
1009
1010 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_FOUNTAIN_ANSI),
1011 .driver_data = APPLE_NUMLOCK_EMULATION | APPLE_HAS_FN },
1012 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_FOUNTAIN_ISO),
1013 .driver_data = APPLE_NUMLOCK_EMULATION | APPLE_HAS_FN },
1014 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER_ANSI),
1015 .driver_data = APPLE_NUMLOCK_EMULATION | APPLE_HAS_FN },
1016 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER_ISO),
1017 .driver_data = APPLE_NUMLOCK_EMULATION | APPLE_HAS_FN },
1018 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER_JIS),
1019 .driver_data = APPLE_NUMLOCK_EMULATION | APPLE_HAS_FN },
1020 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER3_ANSI),
1021 .driver_data = APPLE_NUMLOCK_EMULATION | APPLE_HAS_FN },
1022 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER3_ISO),
1023 .driver_data = APPLE_NUMLOCK_EMULATION | APPLE_HAS_FN |
1024 APPLE_ISO_TILDE_QUIRK },
1025 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER3_JIS),
1026 .driver_data = APPLE_NUMLOCK_EMULATION | APPLE_HAS_FN |
1027 APPLE_RDESC_JIS },
1028 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER4_ANSI),
1029 .driver_data = APPLE_NUMLOCK_EMULATION | APPLE_HAS_FN },
1030 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER4_ISO),
1031 .driver_data = APPLE_NUMLOCK_EMULATION | APPLE_HAS_FN |
1032 APPLE_ISO_TILDE_QUIRK },
1033 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER4_JIS),
1034 .driver_data = APPLE_NUMLOCK_EMULATION | APPLE_HAS_FN |
1035 APPLE_RDESC_JIS },
1036 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_MINI_ANSI),
1037 .driver_data = APPLE_HAS_FN },
1038 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_MINI_ISO),
1039 .driver_data = APPLE_HAS_FN },
1040 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_MINI_JIS),
1041 .driver_data = APPLE_HAS_FN },
1042 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_ANSI),
1043 .driver_data = APPLE_HAS_FN },
1044 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_ISO),
1045 .driver_data = APPLE_HAS_FN },
1046 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_JIS),
1047 .driver_data = APPLE_HAS_FN },
1048 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER4_HF_ANSI),
1049 .driver_data = APPLE_NUMLOCK_EMULATION | APPLE_HAS_FN },
1050 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER4_HF_ISO),
1051 .driver_data = APPLE_NUMLOCK_EMULATION | APPLE_HAS_FN |
1052 APPLE_ISO_TILDE_QUIRK },
1053 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER4_HF_JIS),
1054 .driver_data = APPLE_NUMLOCK_EMULATION | APPLE_HAS_FN |
1055 APPLE_RDESC_JIS },
1056 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_REVB_ANSI),
1057 .driver_data = APPLE_HAS_FN },
1058 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_REVB_ANSI),
1059 .driver_data = APPLE_HAS_FN },
1060 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_REVB_ISO),
1061 .driver_data = APPLE_HAS_FN },
1062 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_REVB_ISO),
1063 .driver_data = APPLE_HAS_FN },
1064 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_REVB_JIS),
1065 .driver_data = APPLE_HAS_FN },
1066 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_WIRELESS_ANSI),
1067 .driver_data = APPLE_NUMLOCK_EMULATION | APPLE_HAS_FN },
1068 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_WIRELESS_ISO),
1069 .driver_data = APPLE_NUMLOCK_EMULATION | APPLE_HAS_FN |
1070 APPLE_ISO_TILDE_QUIRK },
1071 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_WIRELESS_2011_ISO),
1072 .driver_data = APPLE_NUMLOCK_EMULATION | APPLE_HAS_FN |
1073 APPLE_ISO_TILDE_QUIRK },
1074 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE,
1075 USB_DEVICE_ID_APPLE_ALU_WIRELESS_2011_ANSI),
1076 .driver_data = APPLE_NUMLOCK_EMULATION | APPLE_HAS_FN },
1077 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE,
1078 USB_DEVICE_ID_APPLE_ALU_WIRELESS_2011_JIS),
1079 .driver_data = APPLE_NUMLOCK_EMULATION | APPLE_HAS_FN },
1080 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_WIRELESS_JIS),
1081 .driver_data = APPLE_NUMLOCK_EMULATION | APPLE_HAS_FN },
1082 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_2015),
1083 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK | APPLE_RDESC_BATTERY },
1084 { HID_BLUETOOTH_DEVICE(BT_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_2015),
1085 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK },
1086 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_NUMPAD_2015),
1087 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK | APPLE_RDESC_BATTERY },
1088 { HID_BLUETOOTH_DEVICE(BT_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_NUMPAD_2015),
1089 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK },
1090 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING_ANSI),
1091 .driver_data = APPLE_HAS_FN },
1092 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING_ISO),
1093 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK },
1094 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING_JIS),
1095 .driver_data = APPLE_HAS_FN | APPLE_RDESC_JIS },
1096 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING2_ANSI),
1097 .driver_data = APPLE_HAS_FN },
1098 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING2_ISO),
1099 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK },
1100 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING2_JIS),
1101 .driver_data = APPLE_HAS_FN | APPLE_RDESC_JIS },
1102 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING3_ANSI),
1103 .driver_data = APPLE_HAS_FN },
1104 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING3_ISO),
1105 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK },
1106 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING3_JIS),
1107 .driver_data = APPLE_HAS_FN | APPLE_RDESC_JIS },
1108 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING4_ANSI),
1109 .driver_data = APPLE_HAS_FN },
1110 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING4_ISO),
1111 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK },
1112 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING4_JIS),
1113 .driver_data = APPLE_HAS_FN | APPLE_RDESC_JIS },
1114 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING4A_ANSI),
1115 .driver_data = APPLE_HAS_FN },
1116 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING4A_ISO),
1117 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK },
1118 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING4A_JIS),
1119 .driver_data = APPLE_HAS_FN | APPLE_RDESC_JIS },
1120 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING5_ANSI),
1121 .driver_data = APPLE_HAS_FN },
1122 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING5_ISO),
1123 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK },
1124 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING5_JIS),
1125 .driver_data = APPLE_HAS_FN | APPLE_RDESC_JIS },
1126 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING6_ANSI),
1127 .driver_data = APPLE_HAS_FN },
1128 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING6_ISO),
1129 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK },
1130 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING6_JIS),
1131 .driver_data = APPLE_HAS_FN | APPLE_RDESC_JIS },
1132 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING6A_ANSI),
1133 .driver_data = APPLE_HAS_FN },
1134 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING6A_ISO),
1135 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK },
1136 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING6A_JIS),
1137 .driver_data = APPLE_HAS_FN | APPLE_RDESC_JIS },
1138 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING5A_ANSI),
1139 .driver_data = APPLE_HAS_FN },
1140 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING5A_ISO),
1141 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK },
1142 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING5A_JIS),
1143 .driver_data = APPLE_HAS_FN | APPLE_RDESC_JIS },
1144 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING7_ANSI),
1145 .driver_data = APPLE_HAS_FN },
1146 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING7_ISO),
1147 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK },
1148 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING7_JIS),
1149 .driver_data = APPLE_HAS_FN | APPLE_RDESC_JIS },
1150 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING7A_ANSI),
1151 .driver_data = APPLE_HAS_FN },
1152 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING7A_ISO),
1153 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK },
1154 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING7A_JIS),
1155 .driver_data = APPLE_HAS_FN | APPLE_RDESC_JIS },
1156 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING8_ANSI),
1157 .driver_data = APPLE_HAS_FN },
1158 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING8_ISO),
1159 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK },
1160 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING8_JIS),
1161 .driver_data = APPLE_HAS_FN | APPLE_RDESC_JIS },
1162 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING9_ANSI),
1163 .driver_data = APPLE_HAS_FN },
1164 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING9_ISO),
1165 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK },
1166 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING9_JIS),
1167 .driver_data = APPLE_HAS_FN | APPLE_RDESC_JIS },
1168 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRINGT2_J140K),
1169 .driver_data = APPLE_HAS_FN | APPLE_BACKLIGHT_CTL | APPLE_ISO_TILDE_QUIRK },
1170 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRINGT2_J132),
1171 .driver_data = APPLE_HAS_FN | APPLE_BACKLIGHT_CTL | APPLE_ISO_TILDE_QUIRK |
1172 APPLE_DISABLE_FKEYS },
1173 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRINGT2_J680),
1174 .driver_data = APPLE_HAS_FN | APPLE_BACKLIGHT_CTL | APPLE_ISO_TILDE_QUIRK |
1175 APPLE_DISABLE_FKEYS },
1176 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRINGT2_J680_ALT),
1177 .driver_data = APPLE_HAS_FN | APPLE_BACKLIGHT_CTL | APPLE_ISO_TILDE_QUIRK |
1178 APPLE_DISABLE_FKEYS },
1179 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRINGT2_J213),
1180 .driver_data = APPLE_HAS_FN | APPLE_BACKLIGHT_CTL | APPLE_ISO_TILDE_QUIRK |
1181 APPLE_DISABLE_FKEYS },
1182 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRINGT2_J214K),
1183 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK | APPLE_DISABLE_FKEYS },
1184 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRINGT2_J223),
1185 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK | APPLE_DISABLE_FKEYS },
1186 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRINGT2_J230K),
1187 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK },
1188 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRINGT2_J152F),
1189 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK | APPLE_DISABLE_FKEYS },
1190 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_WIRELESS_2009_ANSI),
1191 .driver_data = APPLE_NUMLOCK_EMULATION | APPLE_HAS_FN },
1192 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_WIRELESS_2009_ISO),
1193 .driver_data = APPLE_NUMLOCK_EMULATION | APPLE_HAS_FN |
1194 APPLE_ISO_TILDE_QUIRK },
1195 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_WIRELESS_2009_JIS),
1196 .driver_data = APPLE_NUMLOCK_EMULATION | APPLE_HAS_FN },
1197 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_FOUNTAIN_TP_ONLY),
1198 .driver_data = APPLE_NUMLOCK_EMULATION | APPLE_HAS_FN },
1199 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER1_TP_ONLY),
1200 .driver_data = APPLE_NUMLOCK_EMULATION | APPLE_HAS_FN },
1201 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_2021),
1202 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK | APPLE_RDESC_BATTERY },
1203 { HID_BLUETOOTH_DEVICE(BT_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_2021),
1204 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK },
1205 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_FINGERPRINT_2021),
1206 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK | APPLE_RDESC_BATTERY },
1207 { HID_BLUETOOTH_DEVICE(BT_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_FINGERPRINT_2021),
1208 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK },
1209 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_NUMPAD_2021),
1210 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK | APPLE_RDESC_BATTERY },
1211 { HID_BLUETOOTH_DEVICE(BT_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_NUMPAD_2021),
1212 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK },
1213 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_2024),
1214 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK | APPLE_RDESC_BATTERY },
1215 { HID_BLUETOOTH_DEVICE(BT_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_2024),
1216 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK },
1217 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_FINGERPRINT_2024),
1218 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK | APPLE_RDESC_BATTERY },
1219 { HID_BLUETOOTH_DEVICE(BT_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_FINGERPRINT_2024),
1220 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK },
1221 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_NUMPAD_2024),
1222 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK | APPLE_RDESC_BATTERY },
1223 { HID_BLUETOOTH_DEVICE(BT_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_NUMPAD_2024),
1224 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK },
1225 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_TOUCHBAR_BACKLIGHT),
1226 .driver_data = APPLE_MAGIC_BACKLIGHT },
1227
1228 { }
1229 };
1230 MODULE_DEVICE_TABLE(hid, apple_devices);
1231
1232 static struct hid_driver apple_driver = {
1233 .name = "apple",
1234 .id_table = apple_devices,
1235 .report_fixup = apple_report_fixup,
1236 .probe = apple_probe,
1237 .remove = apple_remove,
1238 .event = apple_event,
1239 .input_mapping = apple_input_mapping,
1240 .input_mapped = apple_input_mapped,
1241 .input_configured = apple_input_configured,
1242 };
1243 module_hid_driver(apple_driver);
1244
1245 MODULE_DESCRIPTION("Apple USB HID quirks support for Linux");
1246 MODULE_LICENSE("GPL");
1247