1 // SPDX-License-Identifier: GPL-2.0+
4 * Denis Peter, MPL AG Switzerland
6 * Part of this source has been derived from the Linux USB
16 #include <stdio_dev.h>
19 #include <asm/byteorder.h>
21 #include <asm/state.h>
27 * USB vendor and product IDs used for quirks.
29 #define USB_VENDOR_ID_APPLE 0x05ac
30 #define USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_2021 0x029c
31 #define USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_FINGERPRINT_2021 0x029a
32 #define USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_NUMPAD_2021 0x029f
34 #define USB_VENDOR_ID_KEYCHRON 0x3434
36 #define USB_HID_QUIRK_POLL_NO_REPORT_IDLE BIT(0)
39 * If overwrite_console returns 1, the stdin, stderr and stdout
40 * are switched to the serial port, else the settings in the
41 * environment are used
43 #ifdef CONFIG_SYS_CONSOLE_OVERWRITE_ROUTINE
44 extern int overwrite_console(void);
46 int overwrite_console(void)
52 /* Keyboard sampling rate */
53 #define REPEAT_RATE 40 /* 40msec -> 25cps */
54 #define REPEAT_DELAY 10 /* 10 x REPEAT_RATE = 400msec */
57 #define CAPS_LOCK 0x39
58 #define SCROLL_LOCK 0x47
61 #define LEFT_CNTR (1 << 0)
62 #define LEFT_SHIFT (1 << 1)
63 #define LEFT_ALT (1 << 2)
64 #define LEFT_GUI (1 << 3)
65 #define RIGHT_CNTR (1 << 4)
66 #define RIGHT_SHIFT (1 << 5)
67 #define RIGHT_ALT (1 << 6)
68 #define RIGHT_GUI (1 << 7)
70 /* Size of the keyboard buffer */
71 #define USB_KBD_BUFFER_LEN 0x20
74 #define DEVNAME "usbkbd"
77 static const unsigned char usb_kbd_numkey[] = {
78 '1', '2', '3', '4', '5', '6', '7', '8', '9', '0',
79 '\r', 0x1b, '\b', '\t', ' ', '-', '=', '[', ']',
80 '\\', '#', ';', '\'', '`', ',', '.', '/'
82 static const unsigned char usb_kbd_numkey_shifted[] = {
83 '!', '@', '#', '$', '%', '^', '&', '*', '(', ')',
84 '\r', 0x1b, '\b', '\t', ' ', '_', '+', '{', '}',
85 '|', '~', ':', '"', '~', '<', '>', '?'
88 static const unsigned char usb_kbd_num_keypad[] = {
89 '/', '*', '-', '+', '\r',
90 '1', '2', '3', '4', '5', '6', '7', '8', '9', '0',
94 static const u8 usb_special_keys[] = {
95 #ifdef CONFIG_USB_KEYBOARD_FN_KEYS
96 '2', 'H', '5', '3', 'F', '6', 'C', 'D', 'B', 'A'
103 * NOTE: It's important for the NUM, CAPS, SCROLL-lock bits to be in this
104 * order. See usb_kbd_setled() function!
106 #define USB_KBD_NUMLOCK (1 << 0)
107 #define USB_KBD_CAPSLOCK (1 << 1)
108 #define USB_KBD_SCROLLLOCK (1 << 2)
109 #define USB_KBD_CTRL (1 << 3)
111 #define USB_KBD_LEDMASK \
112 (USB_KBD_NUMLOCK | USB_KBD_CAPSLOCK | USB_KBD_SCROLLLOCK)
114 struct usb_kbd_pdata {
115 unsigned long intpipe;
118 unsigned long last_report;
119 struct int_queue *intq;
123 uint32_t repeat_delay;
125 uint32_t usb_in_pointer;
126 uint32_t usb_out_pointer;
127 uint8_t usb_kbd_buffer[USB_KBD_BUFFER_LEN];
130 uint8_t old[USB_KBD_BOOT_REPORT_SIZE];
135 extern int __maybe_unused net_busy_flag;
137 /* The period of time between two calls of usb_kbd_testc(). */
138 static unsigned long kbd_testc_tms;
140 int usb_kbd_remove_for_test(void)
142 return console_remove_by_name(DEVNAME);
145 /* Puts character in the queue and sets up the in and out pointer. */
146 static void usb_kbd_put_queue(struct usb_kbd_pdata *data, u8 c)
148 if (data->usb_in_pointer == USB_KBD_BUFFER_LEN - 1) {
149 /* Check for buffer full. */
150 if (data->usb_out_pointer == 0)
153 data->usb_in_pointer = 0;
155 /* Check for buffer full. */
156 if (data->usb_in_pointer == data->usb_out_pointer - 1)
159 data->usb_in_pointer++;
162 data->usb_kbd_buffer[data->usb_in_pointer] = c;
166 * Set the LEDs. Since this is used in the irq routine, the control job is
167 * issued with a timeout of 0. This means, that the job is queued without
168 * waiting for job completion.
170 static void usb_kbd_setled(struct usb_device *dev)
172 struct usb_kbd_pdata *data = dev->privptr;
173 struct usb_interface *iface = &dev->config.if_desc[data->ifnum];
174 ALLOC_ALIGN_BUFFER(uint32_t, leds, 1, USB_DMA_MINALIGN);
176 *leds = data->flags & USB_KBD_LEDMASK;
177 usb_control_msg(dev, usb_sndctrlpipe(dev, 0),
178 USB_REQ_SET_REPORT, USB_TYPE_CLASS | USB_RECIP_INTERFACE,
179 0x200, iface->desc.bInterfaceNumber, leds, 1, 0);
182 #define CAPITAL_MASK 0x20
183 /* Translate the scancode in ASCII */
184 static int usb_kbd_translate(struct usb_kbd_pdata *data, unsigned char scancode,
185 unsigned char modifier, int pressed)
191 data->repeat_delay = 0;
196 data->repeat_delay++;
197 if (data->repeat_delay < REPEAT_DELAY)
200 data->repeat_delay = REPEAT_DELAY;
203 /* Alphanumeric values */
204 if ((scancode > 3) && (scancode <= 0x1d)) {
205 keycode = scancode - 4 + 'a';
207 if (data->flags & USB_KBD_CAPSLOCK)
208 keycode &= ~CAPITAL_MASK;
210 if (modifier & (LEFT_SHIFT | RIGHT_SHIFT)) {
211 /* Handle CAPSLock + Shift pressed simultaneously */
212 if (keycode & CAPITAL_MASK)
213 keycode &= ~CAPITAL_MASK;
215 keycode |= CAPITAL_MASK;
219 if ((scancode > 0x1d) && (scancode < 0x39)) {
221 if (modifier & (LEFT_SHIFT | RIGHT_SHIFT))
222 keycode = usb_kbd_numkey_shifted[scancode - 0x1e];
224 keycode = usb_kbd_numkey[scancode - 0x1e];
228 if ((scancode >= 0x54) && (scancode <= 0x67))
229 keycode = usb_kbd_num_keypad[scancode - 0x54];
231 if (data->flags & USB_KBD_CTRL)
232 keycode = scancode - 0x3;
235 if (scancode == NUM_LOCK) {
236 data->flags ^= USB_KBD_NUMLOCK;
240 if (scancode == CAPS_LOCK) {
241 data->flags ^= USB_KBD_CAPSLOCK;
244 if (scancode == SCROLL_LOCK) {
245 data->flags ^= USB_KBD_SCROLLLOCK;
250 /* Report keycode if any */
252 debug("%c", keycode);
253 usb_kbd_put_queue(data, keycode);
257 #ifdef CONFIG_USB_KEYBOARD_FN_KEYS
258 if (scancode < 0x3a || scancode > 0x52 ||
259 scancode == 0x46 || scancode == 0x47)
262 usb_kbd_put_queue(data, 0x1b);
263 if (scancode < 0x3e) {
265 usb_kbd_put_queue(data, 0x4f);
266 usb_kbd_put_queue(data, scancode - 0x3a + 'P');
269 usb_kbd_put_queue(data, '[');
270 if (scancode < 0x42) {
272 usb_kbd_put_queue(data, '1');
273 if (scancode == 0x3e)
275 keycode = scancode - 0x3f + '7';
276 } else if (scancode < 0x49) {
278 usb_kbd_put_queue(data, '2');
281 keycode = scancode - 0x42 + '0';
284 * INSERT, HOME, PAGE UP, DELETE, END, PAGE DOWN,
285 * RIGHT, LEFT, DOWN, UP
287 keycode = usb_special_keys[scancode - 0x49];
289 usb_kbd_put_queue(data, keycode);
290 if (scancode < 0x4f && scancode != 0x4a && scancode != 0x4d)
291 usb_kbd_put_queue(data, '~');
294 /* Left, Right, Up, Down */
295 if (scancode > 0x4e && scancode < 0x53) {
296 usb_kbd_put_queue(data, 0x1b);
297 usb_kbd_put_queue(data, '[');
298 usb_kbd_put_queue(data, usb_special_keys[scancode - 0x4f]);
302 #endif /* CONFIG_USB_KEYBOARD_FN_KEYS */
305 static uint32_t usb_kbd_service_key(struct usb_device *dev, int i, int up)
308 struct usb_kbd_pdata *data = dev->privptr;
321 (memscan(new + 2, old[i], USB_KBD_BOOT_REPORT_SIZE - 2) ==
322 new + USB_KBD_BOOT_REPORT_SIZE)) {
323 res |= usb_kbd_translate(data, old[i], data->new[0], up);
329 /* Interrupt service routine */
330 static int usb_kbd_irq_worker(struct usb_device *dev)
332 struct usb_kbd_pdata *data = dev->privptr;
335 /* No combo key pressed */
336 if (data->new[0] == 0x00)
337 data->flags &= ~USB_KBD_CTRL;
338 /* Left or Right Ctrl pressed */
339 else if ((data->new[0] == LEFT_CNTR) || (data->new[0] == RIGHT_CNTR))
340 data->flags |= USB_KBD_CTRL;
342 for (i = 2; i < USB_KBD_BOOT_REPORT_SIZE; i++) {
343 res |= usb_kbd_service_key(dev, i, 0);
344 res |= usb_kbd_service_key(dev, i, 1);
347 /* Key is still pressed */
348 if ((data->new[2] > 3) && (data->old[2] == data->new[2]))
349 res |= usb_kbd_translate(data, data->new[2], data->new[0], 2);
354 memcpy(data->old, data->new, USB_KBD_BOOT_REPORT_SIZE);
359 /* Keyboard interrupt handler */
360 static int usb_kbd_irq(struct usb_device *dev)
362 if ((dev->irq_status != 0) ||
363 (dev->irq_act_len != USB_KBD_BOOT_REPORT_SIZE)) {
364 debug("USB KBD: Error %lX, len %d\n",
365 dev->irq_status, dev->irq_act_len);
369 return usb_kbd_irq_worker(dev);
372 /* Interrupt polling */
373 static inline void usb_kbd_poll_for_event(struct usb_device *dev)
375 #if defined(CONFIG_SYS_USB_EVENT_POLL)
376 struct usb_kbd_pdata *data = dev->privptr;
378 /* Submit an interrupt transfer request */
379 if (usb_int_msg(dev, data->intpipe, &data->new[0],
380 data->intpktsize, data->intinterval, true) >= 0)
381 usb_kbd_irq_worker(dev);
382 #elif defined(CONFIG_SYS_USB_EVENT_POLL_VIA_CONTROL_EP) || \
383 defined(CONFIG_SYS_USB_EVENT_POLL_VIA_INT_QUEUE)
384 #if defined(CONFIG_SYS_USB_EVENT_POLL_VIA_CONTROL_EP)
385 struct usb_interface *iface;
386 struct usb_kbd_pdata *data = dev->privptr;
387 iface = &dev->config.if_desc[data->ifnum];
388 usb_get_report(dev, iface->desc.bInterfaceNumber,
389 1, 0, data->new, USB_KBD_BOOT_REPORT_SIZE);
390 if (memcmp(data->old, data->new, USB_KBD_BOOT_REPORT_SIZE)) {
391 usb_kbd_irq_worker(dev);
393 struct usb_kbd_pdata *data = dev->privptr;
394 if (poll_int_queue(dev, data->intq)) {
395 usb_kbd_irq_worker(dev);
396 /* We've consumed all queued int packets, create new */
397 destroy_int_queue(dev, data->intq);
398 data->intq = create_int_queue(dev, data->intpipe, 1,
399 USB_KBD_BOOT_REPORT_SIZE, data->new,
402 data->last_report = get_timer(0);
403 /* Repeat last usb hid report every REPEAT_RATE ms for keyrepeat */
404 } else if (data->last_report != -1 &&
405 get_timer(data->last_report) > REPEAT_RATE) {
406 usb_kbd_irq_worker(dev);
407 data->last_report = get_timer(0);
412 /* test if a character is in the queue */
413 static int usb_kbd_testc(struct stdio_dev *sdev)
415 struct stdio_dev *dev;
416 struct usb_device *usb_kbd_dev;
417 struct usb_kbd_pdata *data;
420 * Polling the keyboard for an event can take dozens of milliseconds.
421 * Add a delay between polls to avoid blocking activity which polls
422 * rapidly, like the UEFI console timer.
424 unsigned long poll_delay = CONFIG_SYS_HZ / 50;
426 #ifdef CONFIG_CMD_NET
428 * If net_busy_flag is 1, NET transfer is running,
429 * then we check key-pressed every second (first check may be
430 * less than 1 second) to improve TFTP booting performance.
433 poll_delay = CONFIG_SYS_HZ;
436 #ifdef CONFIG_SANDBOX
438 * Skip delaying polls if a test requests it.
440 if (state_get_skip_delays())
444 dev = stdio_get_by_name(sdev->name);
445 usb_kbd_dev = (struct usb_device *)dev->priv;
446 data = usb_kbd_dev->privptr;
448 if (get_timer(kbd_testc_tms) >= poll_delay) {
449 usb_kbd_poll_for_event(usb_kbd_dev);
450 kbd_testc_tms = get_timer(0);
453 return !(data->usb_in_pointer == data->usb_out_pointer);
456 /* gets the character from the queue */
457 static int usb_kbd_getc(struct stdio_dev *sdev)
459 struct stdio_dev *dev;
460 struct usb_device *usb_kbd_dev;
461 struct usb_kbd_pdata *data;
463 dev = stdio_get_by_name(sdev->name);
464 usb_kbd_dev = (struct usb_device *)dev->priv;
465 data = usb_kbd_dev->privptr;
467 while (data->usb_in_pointer == data->usb_out_pointer) {
469 usb_kbd_poll_for_event(usb_kbd_dev);
472 if (data->usb_out_pointer == USB_KBD_BUFFER_LEN - 1)
473 data->usb_out_pointer = 0;
475 data->usb_out_pointer++;
477 return data->usb_kbd_buffer[data->usb_out_pointer];
480 /* probes the USB device dev for keyboard type. */
481 static int usb_kbd_probe_dev(struct usb_device *dev, unsigned int ifnum)
483 struct usb_interface *iface;
484 struct usb_endpoint_descriptor *ep;
485 struct usb_kbd_pdata *data;
486 unsigned int quirks = 0;
489 if (dev->descriptor.bNumConfigurations != 1)
492 iface = &dev->config.if_desc[ifnum];
494 if (iface->desc.bInterfaceClass != USB_CLASS_HID)
497 if (iface->desc.bInterfaceSubClass != USB_SUB_HID_BOOT)
500 if (iface->desc.bInterfaceProtocol != USB_PROT_HID_KEYBOARD)
503 for (epNum = 0; epNum < iface->desc.bNumEndpoints; epNum++) {
504 ep = &iface->ep_desc[epNum];
506 /* Check if endpoint is interrupt IN endpoint */
507 if ((ep->bmAttributes & 3) != 3)
510 if (ep->bEndpointAddress & 0x80)
514 if (epNum == iface->desc.bNumEndpoints)
517 debug("USB KBD: found interrupt EP: 0x%x\n", ep->bEndpointAddress);
519 switch (dev->descriptor.idVendor) {
520 case USB_VENDOR_ID_APPLE:
521 case USB_VENDOR_ID_KEYCHRON:
522 quirks |= USB_HID_QUIRK_POLL_NO_REPORT_IDLE;
528 data = malloc(sizeof(struct usb_kbd_pdata));
530 printf("USB KBD: Error allocating private data\n");
534 /* Clear private data */
535 memset(data, 0, sizeof(struct usb_kbd_pdata));
537 /* allocate input buffer aligned and sized to USB DMA alignment */
538 data->new = memalign(USB_DMA_MINALIGN,
539 roundup(USB_KBD_BOOT_REPORT_SIZE, USB_DMA_MINALIGN));
543 /* Insert private data into USB device structure */
546 /* Set IRQ handler */
547 dev->irq_handle = usb_kbd_irq;
549 data->intpipe = usb_rcvintpipe(dev, ep->bEndpointAddress);
550 data->intpktsize = min(usb_maxpacket(dev, data->intpipe),
551 USB_KBD_BOOT_REPORT_SIZE);
552 data->intinterval = ep->bInterval;
553 data->last_report = -1;
555 /* We found a USB Keyboard, install it. */
556 debug("USB KBD: set boot protocol\n");
557 usb_set_protocol(dev, iface->desc.bInterfaceNumber, 0);
559 #if !defined(CONFIG_SYS_USB_EVENT_POLL_VIA_CONTROL_EP) && \
560 !defined(CONFIG_SYS_USB_EVENT_POLL_VIA_INT_QUEUE)
561 debug("USB KBD: set idle interval...\n");
562 usb_set_idle(dev, iface->desc.bInterfaceNumber, REPEAT_RATE / 4, 0);
564 debug("USB KBD: set idle interval=0...\n");
565 usb_set_idle(dev, iface->desc.bInterfaceNumber, 0, 0);
569 * Apple and Keychron keyboards do not report the device state. Reports
570 * are only returned during key presses.
572 if (quirks & USB_HID_QUIRK_POLL_NO_REPORT_IDLE) {
573 debug("USB KBD: quirk: skip testing device state\n");
576 debug("USB KBD: enable interrupt pipe...\n");
577 #ifdef CONFIG_SYS_USB_EVENT_POLL_VIA_INT_QUEUE
578 data->intq = create_int_queue(dev, data->intpipe, 1,
579 USB_KBD_BOOT_REPORT_SIZE, data->new,
582 #elif defined(CONFIG_SYS_USB_EVENT_POLL_VIA_CONTROL_EP)
583 if (usb_get_report(dev, iface->desc.bInterfaceNumber,
584 1, 0, data->new, USB_KBD_BOOT_REPORT_SIZE) < 0) {
586 if (usb_int_msg(dev, data->intpipe, data->new, data->intpktsize,
587 data->intinterval, false) < 0) {
589 printf("Failed to get keyboard state from device %04x:%04x\n",
590 dev->descriptor.idVendor, dev->descriptor.idProduct);
591 /* Abort, we don't want to use that non-functional keyboard. */
599 static int probe_usb_keyboard(struct usb_device *dev)
602 struct stdio_dev usb_kbd_dev;
604 unsigned int max_ifnum = min((unsigned int)USB_MAX_ACTIVE_INTERFACES,
605 (unsigned int)dev->config.no_of_if);
608 /* Try probing the keyboard */
609 for (ifnum = 0; ifnum < max_ifnum; ifnum++) {
610 if (usb_kbd_probe_dev(dev, ifnum) == 1)
613 if (ifnum >= max_ifnum)
616 /* Register the keyboard */
617 debug("USB KBD: register.\n");
618 memset(&usb_kbd_dev, 0, sizeof(struct stdio_dev));
619 strcpy(usb_kbd_dev.name, DEVNAME);
620 usb_kbd_dev.flags = DEV_FLAGS_INPUT | DEV_FLAGS_DM;
621 usb_kbd_dev.getc = usb_kbd_getc;
622 usb_kbd_dev.tstc = usb_kbd_testc;
623 usb_kbd_dev.priv = (void *)dev;
624 error = stdio_register(&usb_kbd_dev);
628 stdinname = env_get("stdin");
629 #if CONFIG_IS_ENABLED(CONSOLE_MUX)
630 if (strstr(stdinname, DEVNAME) != NULL) {
631 error = iomux_doenv(stdin, stdinname);
636 /* Check if this is the standard input device. */
637 if (!strcmp(stdinname, DEVNAME)) {
638 /* Reassign the console */
639 if (overwrite_console())
642 error = console_assign(stdin, DEVNAME);
651 static int usb_kbd_probe(struct udevice *dev)
653 struct usb_device *udev = dev_get_parent_priv(dev);
655 return probe_usb_keyboard(udev);
658 static int usb_kbd_remove(struct udevice *dev)
660 struct usb_device *udev = dev_get_parent_priv(dev);
661 struct usb_kbd_pdata *data;
662 struct stdio_dev *sdev;
665 sdev = stdio_get_by_name(DEVNAME);
670 data = udev->privptr;
671 #if CONFIG_IS_ENABLED(CONSOLE_MUX)
672 if (iomux_replace_device(stdin, DEVNAME, "nulldev")) {
677 if (stdio_deregister_dev(sdev, true)) {
681 #ifdef CONFIG_SYS_USB_EVENT_POLL_VIA_INT_QUEUE
682 destroy_int_queue(udev, data->intq);
689 printf("%s: warning, ret=%d", __func__, ret);
693 static const struct udevice_id usb_kbd_ids[] = {
694 { .compatible = "usb-keyboard" },
698 U_BOOT_DRIVER(usb_kbd) = {
700 .id = UCLASS_KEYBOARD,
701 .of_match = usb_kbd_ids,
702 .probe = usb_kbd_probe,
703 .remove = usb_kbd_remove,
706 static const struct usb_device_id kbd_id_table[] = {
708 .match_flags = USB_DEVICE_ID_MATCH_INT_CLASS |
709 USB_DEVICE_ID_MATCH_INT_SUBCLASS |
710 USB_DEVICE_ID_MATCH_INT_PROTOCOL,
711 .bInterfaceClass = USB_CLASS_HID,
712 .bInterfaceSubClass = USB_SUB_HID_BOOT,
713 .bInterfaceProtocol = USB_PROT_HID_KEYBOARD,
716 USB_DEVICE(USB_VENDOR_ID_APPLE,
717 USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_2021),
720 USB_DEVICE(USB_VENDOR_ID_APPLE,
721 USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_FINGERPRINT_2021),
724 USB_DEVICE(USB_VENDOR_ID_APPLE,
725 USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_NUMPAD_2021),
727 { } /* Terminating entry */
730 U_BOOT_USB_DEVICE(usb_kbd, kbd_id_table);