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 }; 369 370 static bool apple_is_non_apple_keyboard(struct hid_device *hdev) 371 { 372 int i; 373 374 for (i = 0; i < ARRAY_SIZE(non_apple_keyboards); i++) { 375 char *non_apple = non_apple_keyboards[i].name; 376 377 if (strncmp(hdev->name, non_apple, strlen(non_apple)) == 0) 378 return true; 379 } 380 381 return false; 382 } 383 384 static bool apple_is_omoton_kb066(struct hid_device *hdev) 385 { 386 return hdev->product == USB_DEVICE_ID_APPLE_ALU_WIRELESS_ANSI && 387 strcmp(hdev->name, "Bluetooth Keyboard") == 0; 388 } 389 390 static inline void apple_setup_key_translation(struct input_dev *input, 391 const struct apple_key_translation *table) 392 { 393 const struct apple_key_translation *trans; 394 395 for (trans = table; trans->from; trans++) 396 set_bit(trans->to, input->keybit); 397 } 398 399 static const struct apple_key_translation *apple_find_translation( 400 const struct apple_key_translation *table, u16 from) 401 { 402 const struct apple_key_translation *trans; 403 404 /* Look for the translation */ 405 for (trans = table; trans->from; trans++) 406 if (trans->from == from) 407 return trans; 408 409 return NULL; 410 } 411 412 static void input_event_with_scancode(struct input_dev *input, 413 __u8 type, __u16 code, unsigned int hid, __s32 value) 414 { 415 if (type == EV_KEY && 416 (!test_bit(code, input->key)) == value) 417 input_event(input, EV_MSC, MSC_SCAN, hid); 418 input_event(input, type, code, value); 419 } 420 421 static int hidinput_apple_event(struct hid_device *hid, struct input_dev *input, 422 struct hid_usage *usage, __s32 value) 423 { 424 struct apple_sc *asc = hid_get_drvdata(hid); 425 const struct apple_key_translation *trans, *table; 426 bool do_translate; 427 u16 code = usage->code; 428 unsigned int real_fnmode; 429 430 if (fnmode == 3) { 431 if (asc->quirks & APPLE_DISABLE_FKEYS) 432 real_fnmode = 4; 433 else if (asc->quirks & APPLE_IS_NON_APPLE) 434 real_fnmode = 2; 435 else 436 real_fnmode = 1; 437 } else { 438 real_fnmode = fnmode; 439 } 440 441 if (swap_fn_leftctrl) { 442 trans = apple_find_translation(swapped_fn_leftctrl_keys, code); 443 444 if (trans) 445 code = trans->to; 446 } 447 448 if (iso_layout > 0 || (iso_layout < 0 && (asc->quirks & APPLE_ISO_TILDE_QUIRK) && 449 hid->country == HID_COUNTRY_INTERNATIONAL_ISO)) { 450 trans = apple_find_translation(apple_iso_keyboard, code); 451 452 if (trans) 453 code = trans->to; 454 } 455 456 if (swap_opt_cmd) { 457 if (swap_opt_cmd == 2) 458 trans = apple_find_translation(swapped_option_cmd_left_keys, code); 459 else 460 trans = apple_find_translation(swapped_option_cmd_keys, code); 461 462 if (trans) 463 code = trans->to; 464 } 465 466 if (swap_ctrl_cmd) { 467 trans = apple_find_translation(swapped_ctrl_cmd_keys, code); 468 469 if (trans) 470 code = trans->to; 471 } 472 473 if (code == KEY_FN) 474 asc->fn_on = !!value; 475 476 if (real_fnmode) { 477 switch (hid->product) { 478 case USB_DEVICE_ID_APPLE_ALU_WIRELESS_ANSI: 479 case USB_DEVICE_ID_APPLE_ALU_WIRELESS_ISO: 480 case USB_DEVICE_ID_APPLE_ALU_WIRELESS_JIS: 481 case USB_DEVICE_ID_APPLE_ALU_WIRELESS_2009_ANSI: 482 case USB_DEVICE_ID_APPLE_ALU_WIRELESS_2009_ISO: 483 case USB_DEVICE_ID_APPLE_ALU_WIRELESS_2009_JIS: 484 case USB_DEVICE_ID_APPLE_ALU_WIRELESS_2011_ANSI: 485 case USB_DEVICE_ID_APPLE_ALU_WIRELESS_2011_ISO: 486 case USB_DEVICE_ID_APPLE_ALU_WIRELESS_2011_JIS: 487 table = magic_keyboard_alu_fn_keys; 488 break; 489 case USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_2015: 490 case USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_NUMPAD_2015: 491 table = magic_keyboard_2015_fn_keys; 492 break; 493 case USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_2021: 494 case USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_FINGERPRINT_2021: 495 case USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_NUMPAD_2021: 496 case USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_2024: 497 case USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_FINGERPRINT_2024: 498 case USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_NUMPAD_2024: 499 table = magic_keyboard_2021_and_2024_fn_keys; 500 break; 501 case USB_DEVICE_ID_APPLE_WELLSPRINGT2_J132: 502 case USB_DEVICE_ID_APPLE_WELLSPRINGT2_J213: 503 case USB_DEVICE_ID_APPLE_WELLSPRINGT2_J680: 504 case USB_DEVICE_ID_APPLE_WELLSPRINGT2_J680_ALT: 505 table = macbookpro_no_esc_fn_keys; 506 break; 507 case USB_DEVICE_ID_APPLE_WELLSPRINGT2_J152F: 508 case USB_DEVICE_ID_APPLE_WELLSPRINGT2_J214K: 509 case USB_DEVICE_ID_APPLE_WELLSPRINGT2_J223: 510 table = macbookpro_dedicated_esc_fn_keys; 511 break; 512 case USB_DEVICE_ID_APPLE_WELLSPRINGT2_J140K: 513 case USB_DEVICE_ID_APPLE_WELLSPRINGT2_J230K: 514 table = apple_fn_keys; 515 break; 516 default: 517 if (hid->product >= USB_DEVICE_ID_APPLE_WELLSPRING4_ANSI && 518 hid->product <= USB_DEVICE_ID_APPLE_WELLSPRING4A_JIS) 519 table = macbookair_fn_keys; 520 else if (hid->product < 0x21d || hid->product >= 0x300) 521 table = powerbook_fn_keys; 522 else 523 table = apple_fn_keys; 524 } 525 526 trans = apple_find_translation(table, code); 527 528 if (trans) { 529 bool from_is_set = test_bit(trans->from, input->key); 530 bool to_is_set = test_bit(trans->to, input->key); 531 532 if (from_is_set) 533 code = trans->from; 534 else if (to_is_set) 535 code = trans->to; 536 537 if (!(from_is_set || to_is_set)) { 538 if (trans->flags & APPLE_FLAG_FKEY) { 539 switch (real_fnmode) { 540 case 1: 541 do_translate = !asc->fn_on; 542 break; 543 case 2: 544 do_translate = asc->fn_on; 545 break; 546 default: 547 /* case 4 */ 548 do_translate = false; 549 } 550 } else if (trans->flags & APPLE_FLAG_TB_FKEY) { 551 switch (real_fnmode) { 552 case 4: 553 do_translate = false; 554 break; 555 default: 556 do_translate = asc->fn_on; 557 } 558 } else { 559 do_translate = asc->fn_on; 560 } 561 562 if (do_translate) 563 code = trans->to; 564 } 565 } 566 567 if (asc->quirks & APPLE_NUMLOCK_EMULATION && 568 (test_bit(code, asc->pressed_numlock) || 569 test_bit(LED_NUML, input->led))) { 570 trans = apple_find_translation(powerbook_numlock_keys, code); 571 572 if (trans) { 573 if (value) 574 set_bit(code, asc->pressed_numlock); 575 else 576 clear_bit(code, asc->pressed_numlock); 577 578 code = trans->to; 579 } 580 } 581 } 582 583 if (usage->code != code) { 584 input_event_with_scancode(input, usage->type, code, usage->hid, value); 585 586 return 1; 587 } 588 589 return 0; 590 } 591 592 static int apple_event(struct hid_device *hdev, struct hid_field *field, 593 struct hid_usage *usage, __s32 value) 594 { 595 struct apple_sc *asc = hid_get_drvdata(hdev); 596 597 if (!(hdev->claimed & HID_CLAIMED_INPUT) || !field->hidinput || 598 !usage->type) 599 return 0; 600 601 if ((asc->quirks & APPLE_INVERT_HWHEEL) && 602 usage->code == REL_HWHEEL) { 603 input_event_with_scancode(field->hidinput->input, usage->type, 604 usage->code, usage->hid, -value); 605 return 1; 606 } 607 608 if ((asc->quirks & APPLE_HAS_FN) && 609 hidinput_apple_event(hdev, field->hidinput->input, 610 usage, value)) 611 return 1; 612 613 614 return 0; 615 } 616 617 static int apple_fetch_battery(struct hid_device *hdev) 618 { 619 #ifdef CONFIG_HID_BATTERY_STRENGTH 620 struct apple_sc *asc = hid_get_drvdata(hdev); 621 struct hid_report_enum *report_enum; 622 struct hid_report *report; 623 624 if (!(asc->quirks & APPLE_RDESC_BATTERY) || !hdev->battery) 625 return -1; 626 627 report_enum = &hdev->report_enum[hdev->battery_report_type]; 628 report = report_enum->report_id_hash[hdev->battery_report_id]; 629 630 if (!report || report->maxfield < 1) 631 return -1; 632 633 if (hdev->battery_capacity == hdev->battery_max) 634 return -1; 635 636 hid_hw_request(hdev, report, HID_REQ_GET_REPORT); 637 return 0; 638 #else 639 return -1; 640 #endif 641 } 642 643 static void apple_battery_timer_tick(struct timer_list *t) 644 { 645 struct apple_sc *asc = timer_container_of(asc, t, battery_timer); 646 struct hid_device *hdev = asc->hdev; 647 648 if (apple_fetch_battery(hdev) == 0) { 649 mod_timer(&asc->battery_timer, 650 jiffies + secs_to_jiffies(APPLE_BATTERY_TIMEOUT_SEC)); 651 } 652 } 653 654 /* 655 * MacBook JIS keyboard has wrong logical maximum 656 * Magic Keyboard JIS has wrong logical maximum 657 */ 658 static const __u8 *apple_report_fixup(struct hid_device *hdev, __u8 *rdesc, 659 unsigned int *rsize) 660 { 661 struct apple_sc *asc = hid_get_drvdata(hdev); 662 663 if(*rsize >=71 && rdesc[70] == 0x65 && rdesc[64] == 0x65) { 664 hid_info(hdev, 665 "fixing up Magic Keyboard JIS report descriptor\n"); 666 rdesc[64] = rdesc[70] = 0xe7; 667 } 668 669 if ((asc->quirks & APPLE_RDESC_JIS) && *rsize >= 60 && 670 rdesc[53] == 0x65 && rdesc[59] == 0x65) { 671 hid_info(hdev, 672 "fixing up MacBook JIS keyboard report descriptor\n"); 673 rdesc[53] = rdesc[59] = 0xe7; 674 } 675 676 /* 677 * Change the usage from: 678 * 0x06, 0x00, 0xff, // Usage Page (Vendor Defined Page 1) 0 679 * 0x09, 0x0b, // Usage (Vendor Usage 0x0b) 3 680 * To: 681 * 0x05, 0x01, // Usage Page (Generic Desktop) 0 682 * 0x09, 0x06, // Usage (Keyboard) 2 683 */ 684 if ((asc->quirks & APPLE_RDESC_BATTERY) && *rsize == 83 && 685 rdesc[46] == 0x84 && rdesc[58] == 0x85) { 686 hid_info(hdev, 687 "fixing up Magic Keyboard battery report descriptor\n"); 688 *rsize = *rsize - 1; 689 rdesc = kmemdup(rdesc + 1, *rsize, GFP_KERNEL); 690 if (!rdesc) 691 return NULL; 692 693 rdesc[0] = 0x05; 694 rdesc[1] = 0x01; 695 rdesc[2] = 0x09; 696 rdesc[3] = 0x06; 697 } 698 699 return rdesc; 700 } 701 702 static void apple_setup_input(struct input_dev *input) 703 { 704 set_bit(KEY_NUMLOCK, input->keybit); 705 706 /* Enable all needed keys */ 707 apple_setup_key_translation(input, apple_fn_keys); 708 apple_setup_key_translation(input, powerbook_fn_keys); 709 apple_setup_key_translation(input, powerbook_numlock_keys); 710 apple_setup_key_translation(input, apple_iso_keyboard); 711 apple_setup_key_translation(input, magic_keyboard_alu_fn_keys); 712 apple_setup_key_translation(input, magic_keyboard_2015_fn_keys); 713 apple_setup_key_translation(input, magic_keyboard_2021_and_2024_fn_keys); 714 apple_setup_key_translation(input, macbookpro_no_esc_fn_keys); 715 apple_setup_key_translation(input, macbookpro_dedicated_esc_fn_keys); 716 } 717 718 static int apple_input_mapping(struct hid_device *hdev, struct hid_input *hi, 719 struct hid_field *field, struct hid_usage *usage, 720 unsigned long **bit, int *max) 721 { 722 struct apple_sc *asc = hid_get_drvdata(hdev); 723 724 if (usage->hid == (HID_UP_CUSTOM | 0x0003) || 725 usage->hid == (HID_UP_MSVENDOR | 0x0003) || 726 usage->hid == (HID_UP_HPVENDOR2 | 0x0003)) { 727 /* The fn key on Apple USB keyboards */ 728 set_bit(EV_REP, hi->input->evbit); 729 hid_map_usage_clear(hi, usage, bit, max, EV_KEY, KEY_FN); 730 asc->fn_found = true; 731 apple_setup_input(hi->input); 732 return 1; 733 } 734 735 /* we want the hid layer to go through standard path (set and ignore) */ 736 return 0; 737 } 738 739 static int apple_input_mapped(struct hid_device *hdev, struct hid_input *hi, 740 struct hid_field *field, struct hid_usage *usage, 741 unsigned long **bit, int *max) 742 { 743 struct apple_sc *asc = hid_get_drvdata(hdev); 744 745 if (asc->quirks & APPLE_MIGHTYMOUSE) { 746 if (usage->hid == HID_GD_Z) 747 hid_map_usage(hi, usage, bit, max, EV_REL, REL_HWHEEL); 748 else if (usage->code == BTN_1) 749 hid_map_usage(hi, usage, bit, max, EV_KEY, BTN_2); 750 else if (usage->code == BTN_2) 751 hid_map_usage(hi, usage, bit, max, EV_KEY, BTN_1); 752 } 753 754 return 0; 755 } 756 757 static int apple_input_configured(struct hid_device *hdev, 758 struct hid_input *hidinput) 759 { 760 struct apple_sc *asc = hid_get_drvdata(hdev); 761 762 if (((asc->quirks & APPLE_HAS_FN) && !asc->fn_found) || apple_is_omoton_kb066(hdev)) { 763 hid_info(hdev, "Fn key not found (Apple Wireless Keyboard clone?), disabling Fn key handling\n"); 764 asc->quirks &= ~APPLE_HAS_FN; 765 } 766 767 if (apple_is_non_apple_keyboard(hdev)) { 768 hid_info(hdev, "Non-apple keyboard detected; function keys will default to fnmode=2 behavior\n"); 769 asc->quirks |= APPLE_IS_NON_APPLE; 770 } 771 772 return 0; 773 } 774 775 static bool apple_backlight_check_support(struct hid_device *hdev) 776 { 777 int i; 778 unsigned int hid; 779 struct hid_report *report; 780 781 list_for_each_entry(report, &hdev->report_enum[HID_INPUT_REPORT].report_list, list) { 782 for (i = 0; i < report->maxfield; i++) { 783 hid = report->field[i]->usage->hid; 784 if ((hid & HID_USAGE_PAGE) == HID_UP_MSVENDOR && (hid & HID_USAGE) == 0xf) 785 return true; 786 } 787 } 788 789 return false; 790 } 791 792 static int apple_backlight_set(struct hid_device *hdev, u16 value, u16 rate) 793 { 794 int ret = 0; 795 struct apple_backlight_set_report *rep; 796 797 rep = kmalloc(sizeof(*rep), GFP_KERNEL); 798 if (rep == NULL) 799 return -ENOMEM; 800 801 rep->report_id = 0xB0; 802 rep->version = 1; 803 rep->backlight = value; 804 rep->rate = rate; 805 806 ret = hid_hw_raw_request(hdev, 0xB0u, (u8 *) rep, sizeof(*rep), 807 HID_OUTPUT_REPORT, HID_REQ_SET_REPORT); 808 809 kfree(rep); 810 return ret; 811 } 812 813 static int apple_backlight_led_set(struct led_classdev *led_cdev, 814 enum led_brightness brightness) 815 { 816 struct apple_sc_backlight *backlight = container_of(led_cdev, 817 struct apple_sc_backlight, cdev); 818 819 return apple_backlight_set(backlight->hdev, brightness, 0); 820 } 821 822 static int apple_backlight_init(struct hid_device *hdev) 823 { 824 int ret; 825 struct apple_sc *asc = hid_get_drvdata(hdev); 826 struct apple_backlight_config_report *rep; 827 828 if (!apple_backlight_check_support(hdev)) 829 return -EINVAL; 830 831 rep = kmalloc(0x200, GFP_KERNEL); 832 if (rep == NULL) 833 return -ENOMEM; 834 835 ret = hid_hw_raw_request(hdev, 0xBFu, (u8 *) rep, sizeof(*rep), 836 HID_FEATURE_REPORT, HID_REQ_GET_REPORT); 837 if (ret < 0) { 838 hid_err(hdev, "backlight request failed: %d\n", ret); 839 goto cleanup_and_exit; 840 } 841 if (ret < 8 || rep->version != 1) { 842 hid_err(hdev, "backlight config struct: bad version %i\n", rep->version); 843 ret = -EINVAL; 844 goto cleanup_and_exit; 845 } 846 847 hid_dbg(hdev, "backlight config: off=%u, on_min=%u, on_max=%u\n", 848 rep->backlight_off, rep->backlight_on_min, rep->backlight_on_max); 849 850 asc->backlight = devm_kzalloc(&hdev->dev, sizeof(*asc->backlight), GFP_KERNEL); 851 if (!asc->backlight) { 852 ret = -ENOMEM; 853 goto cleanup_and_exit; 854 } 855 856 asc->backlight->hdev = hdev; 857 asc->backlight->cdev.name = "apple::kbd_backlight"; 858 asc->backlight->cdev.max_brightness = rep->backlight_on_max; 859 asc->backlight->cdev.brightness_set_blocking = apple_backlight_led_set; 860 861 ret = apple_backlight_set(hdev, 0, 0); 862 if (ret < 0) { 863 hid_err(hdev, "backlight set request failed: %d\n", ret); 864 goto cleanup_and_exit; 865 } 866 867 ret = devm_led_classdev_register(&hdev->dev, &asc->backlight->cdev); 868 869 cleanup_and_exit: 870 kfree(rep); 871 return ret; 872 } 873 874 static void apple_magic_backlight_report_set(struct hid_report *rep, s32 value, u8 rate) 875 { 876 rep->field[0]->value[0] = value; 877 rep->field[1]->value[0] = 0x5e; /* Mimic Windows */ 878 rep->field[1]->value[0] |= rate << 8; 879 880 hid_hw_request(rep->device, rep, HID_REQ_SET_REPORT); 881 } 882 883 static void apple_magic_backlight_set(struct apple_magic_backlight *backlight, 884 int brightness, char rate) 885 { 886 apple_magic_backlight_report_set(backlight->power, brightness ? 1 : 0, rate); 887 if (brightness) 888 apple_magic_backlight_report_set(backlight->brightness, brightness, rate); 889 } 890 891 static int apple_magic_backlight_led_set(struct led_classdev *led_cdev, 892 enum led_brightness brightness) 893 { 894 struct apple_magic_backlight *backlight = container_of(led_cdev, 895 struct apple_magic_backlight, cdev); 896 897 apple_magic_backlight_set(backlight, brightness, 1); 898 return 0; 899 } 900 901 static int apple_magic_backlight_init(struct hid_device *hdev) 902 { 903 struct apple_magic_backlight *backlight; 904 struct hid_report_enum *report_enum; 905 906 /* 907 * Ensure this usb endpoint is for the keyboard backlight, not touchbar 908 * backlight. 909 */ 910 if (hdev->collection[0].usage != HID_USAGE_MAGIC_BL) 911 return -ENODEV; 912 913 backlight = devm_kzalloc(&hdev->dev, sizeof(*backlight), GFP_KERNEL); 914 if (!backlight) 915 return -ENOMEM; 916 917 report_enum = &hdev->report_enum[HID_FEATURE_REPORT]; 918 backlight->brightness = report_enum->report_id_hash[APPLE_MAGIC_REPORT_ID_BRIGHTNESS]; 919 backlight->power = report_enum->report_id_hash[APPLE_MAGIC_REPORT_ID_POWER]; 920 921 if (!backlight->brightness || backlight->brightness->maxfield < 2 || 922 !backlight->power || backlight->power->maxfield < 2) 923 return -ENODEV; 924 925 backlight->cdev.name = ":white:" LED_FUNCTION_KBD_BACKLIGHT; 926 backlight->cdev.max_brightness = backlight->brightness->field[0]->logical_maximum; 927 backlight->cdev.brightness_set_blocking = apple_magic_backlight_led_set; 928 929 apple_magic_backlight_set(backlight, 0, 0); 930 931 return devm_led_classdev_register(&hdev->dev, &backlight->cdev); 932 933 } 934 935 static int apple_probe(struct hid_device *hdev, 936 const struct hid_device_id *id) 937 { 938 unsigned long quirks = id->driver_data; 939 struct apple_sc *asc; 940 int ret; 941 942 asc = devm_kzalloc(&hdev->dev, sizeof(*asc), GFP_KERNEL); 943 if (asc == NULL) { 944 hid_err(hdev, "can't alloc apple descriptor\n"); 945 return -ENOMEM; 946 } 947 948 asc->hdev = hdev; 949 asc->quirks = quirks; 950 951 hid_set_drvdata(hdev, asc); 952 953 ret = hid_parse(hdev); 954 if (ret) { 955 hid_err(hdev, "parse failed\n"); 956 return ret; 957 } 958 959 ret = hid_hw_start(hdev, HID_CONNECT_DEFAULT); 960 if (ret) { 961 hid_err(hdev, "hw start failed\n"); 962 return ret; 963 } 964 965 if (quirks & APPLE_RDESC_BATTERY) { 966 timer_setup(&asc->battery_timer, apple_battery_timer_tick, 0); 967 mod_timer(&asc->battery_timer, 968 jiffies + secs_to_jiffies(APPLE_BATTERY_TIMEOUT_SEC)); 969 apple_fetch_battery(hdev); 970 } 971 972 if (quirks & APPLE_BACKLIGHT_CTL) 973 apple_backlight_init(hdev); 974 975 if (quirks & APPLE_MAGIC_BACKLIGHT) { 976 ret = apple_magic_backlight_init(hdev); 977 if (ret) 978 goto out_err; 979 } 980 981 return 0; 982 983 out_err: 984 if (quirks & APPLE_RDESC_BATTERY) 985 timer_delete_sync(&asc->battery_timer); 986 987 hid_hw_stop(hdev); 988 return ret; 989 } 990 991 static void apple_remove(struct hid_device *hdev) 992 { 993 struct apple_sc *asc = hid_get_drvdata(hdev); 994 995 if (asc->quirks & APPLE_RDESC_BATTERY) 996 timer_delete_sync(&asc->battery_timer); 997 998 hid_hw_stop(hdev); 999 } 1000 1001 static const struct hid_device_id apple_devices[] = { 1002 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_MIGHTYMOUSE), 1003 .driver_data = APPLE_MIGHTYMOUSE | APPLE_INVERT_HWHEEL }, 1004 1005 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_FOUNTAIN_ANSI), 1006 .driver_data = APPLE_NUMLOCK_EMULATION | APPLE_HAS_FN }, 1007 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_FOUNTAIN_ISO), 1008 .driver_data = APPLE_NUMLOCK_EMULATION | APPLE_HAS_FN }, 1009 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER_ANSI), 1010 .driver_data = APPLE_NUMLOCK_EMULATION | APPLE_HAS_FN }, 1011 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER_ISO), 1012 .driver_data = APPLE_NUMLOCK_EMULATION | APPLE_HAS_FN }, 1013 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER_JIS), 1014 .driver_data = APPLE_NUMLOCK_EMULATION | APPLE_HAS_FN }, 1015 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER3_ANSI), 1016 .driver_data = APPLE_NUMLOCK_EMULATION | APPLE_HAS_FN }, 1017 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER3_ISO), 1018 .driver_data = APPLE_NUMLOCK_EMULATION | APPLE_HAS_FN | 1019 APPLE_ISO_TILDE_QUIRK }, 1020 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER3_JIS), 1021 .driver_data = APPLE_NUMLOCK_EMULATION | APPLE_HAS_FN | 1022 APPLE_RDESC_JIS }, 1023 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER4_ANSI), 1024 .driver_data = APPLE_NUMLOCK_EMULATION | APPLE_HAS_FN }, 1025 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER4_ISO), 1026 .driver_data = APPLE_NUMLOCK_EMULATION | APPLE_HAS_FN | 1027 APPLE_ISO_TILDE_QUIRK }, 1028 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER4_JIS), 1029 .driver_data = APPLE_NUMLOCK_EMULATION | APPLE_HAS_FN | 1030 APPLE_RDESC_JIS }, 1031 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_MINI_ANSI), 1032 .driver_data = APPLE_HAS_FN }, 1033 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_MINI_ISO), 1034 .driver_data = APPLE_HAS_FN }, 1035 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_MINI_JIS), 1036 .driver_data = APPLE_HAS_FN }, 1037 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_ANSI), 1038 .driver_data = APPLE_HAS_FN }, 1039 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_ISO), 1040 .driver_data = APPLE_HAS_FN }, 1041 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_JIS), 1042 .driver_data = APPLE_HAS_FN }, 1043 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER4_HF_ANSI), 1044 .driver_data = APPLE_NUMLOCK_EMULATION | APPLE_HAS_FN }, 1045 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER4_HF_ISO), 1046 .driver_data = APPLE_NUMLOCK_EMULATION | APPLE_HAS_FN | 1047 APPLE_ISO_TILDE_QUIRK }, 1048 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER4_HF_JIS), 1049 .driver_data = APPLE_NUMLOCK_EMULATION | APPLE_HAS_FN | 1050 APPLE_RDESC_JIS }, 1051 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_REVB_ANSI), 1052 .driver_data = APPLE_HAS_FN }, 1053 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_REVB_ANSI), 1054 .driver_data = APPLE_HAS_FN }, 1055 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_REVB_ISO), 1056 .driver_data = APPLE_HAS_FN }, 1057 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_REVB_ISO), 1058 .driver_data = APPLE_HAS_FN }, 1059 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_REVB_JIS), 1060 .driver_data = APPLE_HAS_FN }, 1061 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_WIRELESS_ANSI), 1062 .driver_data = APPLE_NUMLOCK_EMULATION | APPLE_HAS_FN }, 1063 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_WIRELESS_ISO), 1064 .driver_data = APPLE_NUMLOCK_EMULATION | APPLE_HAS_FN | 1065 APPLE_ISO_TILDE_QUIRK }, 1066 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_WIRELESS_2011_ISO), 1067 .driver_data = APPLE_NUMLOCK_EMULATION | APPLE_HAS_FN | 1068 APPLE_ISO_TILDE_QUIRK }, 1069 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE, 1070 USB_DEVICE_ID_APPLE_ALU_WIRELESS_2011_ANSI), 1071 .driver_data = APPLE_NUMLOCK_EMULATION | APPLE_HAS_FN }, 1072 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE, 1073 USB_DEVICE_ID_APPLE_ALU_WIRELESS_2011_JIS), 1074 .driver_data = APPLE_NUMLOCK_EMULATION | APPLE_HAS_FN }, 1075 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_WIRELESS_JIS), 1076 .driver_data = APPLE_NUMLOCK_EMULATION | APPLE_HAS_FN }, 1077 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_2015), 1078 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK | APPLE_RDESC_BATTERY }, 1079 { HID_BLUETOOTH_DEVICE(BT_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_2015), 1080 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK }, 1081 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_NUMPAD_2015), 1082 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK | APPLE_RDESC_BATTERY }, 1083 { HID_BLUETOOTH_DEVICE(BT_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_NUMPAD_2015), 1084 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK }, 1085 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING_ANSI), 1086 .driver_data = APPLE_HAS_FN }, 1087 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING_ISO), 1088 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK }, 1089 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING_JIS), 1090 .driver_data = APPLE_HAS_FN | APPLE_RDESC_JIS }, 1091 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING2_ANSI), 1092 .driver_data = APPLE_HAS_FN }, 1093 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING2_ISO), 1094 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK }, 1095 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING2_JIS), 1096 .driver_data = APPLE_HAS_FN | APPLE_RDESC_JIS }, 1097 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING3_ANSI), 1098 .driver_data = APPLE_HAS_FN }, 1099 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING3_ISO), 1100 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK }, 1101 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING3_JIS), 1102 .driver_data = APPLE_HAS_FN | APPLE_RDESC_JIS }, 1103 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING4_ANSI), 1104 .driver_data = APPLE_HAS_FN }, 1105 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING4_ISO), 1106 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK }, 1107 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING4_JIS), 1108 .driver_data = APPLE_HAS_FN | APPLE_RDESC_JIS }, 1109 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING4A_ANSI), 1110 .driver_data = APPLE_HAS_FN }, 1111 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING4A_ISO), 1112 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK }, 1113 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING4A_JIS), 1114 .driver_data = APPLE_HAS_FN | APPLE_RDESC_JIS }, 1115 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING5_ANSI), 1116 .driver_data = APPLE_HAS_FN }, 1117 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING5_ISO), 1118 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK }, 1119 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING5_JIS), 1120 .driver_data = APPLE_HAS_FN | APPLE_RDESC_JIS }, 1121 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING6_ANSI), 1122 .driver_data = APPLE_HAS_FN }, 1123 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING6_ISO), 1124 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK }, 1125 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING6_JIS), 1126 .driver_data = APPLE_HAS_FN | APPLE_RDESC_JIS }, 1127 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING6A_ANSI), 1128 .driver_data = APPLE_HAS_FN }, 1129 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING6A_ISO), 1130 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK }, 1131 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING6A_JIS), 1132 .driver_data = APPLE_HAS_FN | APPLE_RDESC_JIS }, 1133 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING5A_ANSI), 1134 .driver_data = APPLE_HAS_FN }, 1135 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING5A_ISO), 1136 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK }, 1137 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING5A_JIS), 1138 .driver_data = APPLE_HAS_FN | APPLE_RDESC_JIS }, 1139 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING7_ANSI), 1140 .driver_data = APPLE_HAS_FN }, 1141 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING7_ISO), 1142 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK }, 1143 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING7_JIS), 1144 .driver_data = APPLE_HAS_FN | APPLE_RDESC_JIS }, 1145 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING7A_ANSI), 1146 .driver_data = APPLE_HAS_FN }, 1147 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING7A_ISO), 1148 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK }, 1149 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING7A_JIS), 1150 .driver_data = APPLE_HAS_FN | APPLE_RDESC_JIS }, 1151 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING8_ANSI), 1152 .driver_data = APPLE_HAS_FN }, 1153 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING8_ISO), 1154 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK }, 1155 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING8_JIS), 1156 .driver_data = APPLE_HAS_FN | APPLE_RDESC_JIS }, 1157 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING9_ANSI), 1158 .driver_data = APPLE_HAS_FN }, 1159 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING9_ISO), 1160 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK }, 1161 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRING9_JIS), 1162 .driver_data = APPLE_HAS_FN | APPLE_RDESC_JIS }, 1163 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRINGT2_J140K), 1164 .driver_data = APPLE_HAS_FN | APPLE_BACKLIGHT_CTL | APPLE_ISO_TILDE_QUIRK }, 1165 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRINGT2_J132), 1166 .driver_data = APPLE_HAS_FN | APPLE_BACKLIGHT_CTL | APPLE_ISO_TILDE_QUIRK | 1167 APPLE_DISABLE_FKEYS }, 1168 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRINGT2_J680), 1169 .driver_data = APPLE_HAS_FN | APPLE_BACKLIGHT_CTL | APPLE_ISO_TILDE_QUIRK | 1170 APPLE_DISABLE_FKEYS }, 1171 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRINGT2_J680_ALT), 1172 .driver_data = APPLE_HAS_FN | APPLE_BACKLIGHT_CTL | APPLE_ISO_TILDE_QUIRK | 1173 APPLE_DISABLE_FKEYS }, 1174 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRINGT2_J213), 1175 .driver_data = APPLE_HAS_FN | APPLE_BACKLIGHT_CTL | APPLE_ISO_TILDE_QUIRK | 1176 APPLE_DISABLE_FKEYS }, 1177 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRINGT2_J214K), 1178 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK | APPLE_DISABLE_FKEYS }, 1179 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRINGT2_J223), 1180 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK | APPLE_DISABLE_FKEYS }, 1181 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRINGT2_J230K), 1182 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK }, 1183 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_WELLSPRINGT2_J152F), 1184 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK | APPLE_DISABLE_FKEYS }, 1185 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_WIRELESS_2009_ANSI), 1186 .driver_data = APPLE_NUMLOCK_EMULATION | APPLE_HAS_FN }, 1187 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_WIRELESS_2009_ISO), 1188 .driver_data = APPLE_NUMLOCK_EMULATION | APPLE_HAS_FN | 1189 APPLE_ISO_TILDE_QUIRK }, 1190 { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_ALU_WIRELESS_2009_JIS), 1191 .driver_data = APPLE_NUMLOCK_EMULATION | APPLE_HAS_FN }, 1192 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_FOUNTAIN_TP_ONLY), 1193 .driver_data = APPLE_NUMLOCK_EMULATION | APPLE_HAS_FN }, 1194 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_GEYSER1_TP_ONLY), 1195 .driver_data = APPLE_NUMLOCK_EMULATION | APPLE_HAS_FN }, 1196 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_2021), 1197 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK | APPLE_RDESC_BATTERY }, 1198 { HID_BLUETOOTH_DEVICE(BT_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_2021), 1199 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK }, 1200 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_FINGERPRINT_2021), 1201 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK | APPLE_RDESC_BATTERY }, 1202 { HID_BLUETOOTH_DEVICE(BT_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_FINGERPRINT_2021), 1203 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK }, 1204 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_NUMPAD_2021), 1205 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK | APPLE_RDESC_BATTERY }, 1206 { HID_BLUETOOTH_DEVICE(BT_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_NUMPAD_2021), 1207 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK }, 1208 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_2024), 1209 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK | APPLE_RDESC_BATTERY }, 1210 { HID_BLUETOOTH_DEVICE(BT_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_2024), 1211 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK }, 1212 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_FINGERPRINT_2024), 1213 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK | APPLE_RDESC_BATTERY }, 1214 { HID_BLUETOOTH_DEVICE(BT_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_FINGERPRINT_2024), 1215 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK }, 1216 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_NUMPAD_2024), 1217 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK | APPLE_RDESC_BATTERY }, 1218 { HID_BLUETOOTH_DEVICE(BT_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_NUMPAD_2024), 1219 .driver_data = APPLE_HAS_FN | APPLE_ISO_TILDE_QUIRK }, 1220 { HID_USB_DEVICE(USB_VENDOR_ID_APPLE, USB_DEVICE_ID_APPLE_TOUCHBAR_BACKLIGHT), 1221 .driver_data = APPLE_MAGIC_BACKLIGHT }, 1222 1223 { } 1224 }; 1225 MODULE_DEVICE_TABLE(hid, apple_devices); 1226 1227 static struct hid_driver apple_driver = { 1228 .name = "apple", 1229 .id_table = apple_devices, 1230 .report_fixup = apple_report_fixup, 1231 .probe = apple_probe, 1232 .remove = apple_remove, 1233 .event = apple_event, 1234 .input_mapping = apple_input_mapping, 1235 .input_mapped = apple_input_mapped, 1236 .input_configured = apple_input_configured, 1237 }; 1238 module_hid_driver(apple_driver); 1239 1240 MODULE_DESCRIPTION("Apple USB HID quirks support for Linux"); 1241 MODULE_LICENSE("GPL"); 1242