Linux Audio

Check our new training course

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