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
17 #include <stdio_dev.h>
19 #include <asm/byteorder.h>
24 * If overwrite_console returns 1, the stdin, stderr and stdout
25 * are switched to the serial port, else the settings in the
26 * environment are used
28 #ifdef CONFIG_SYS_CONSOLE_OVERWRITE_ROUTINE
29 extern int overwrite_console(void);
31 int overwrite_console(void)
37 /* Keyboard sampling rate */
38 #define REPEAT_RATE 40 /* 40msec -> 25cps */
39 #define REPEAT_DELAY 10 /* 10 x REPEAT_RATE = 400msec */
42 #define CAPS_LOCK 0x39
43 #define SCROLL_LOCK 0x47
46 #define LEFT_CNTR (1 << 0)
47 #define LEFT_SHIFT (1 << 1)
48 #define LEFT_ALT (1 << 2)
49 #define LEFT_GUI (1 << 3)
50 #define RIGHT_CNTR (1 << 4)
51 #define RIGHT_SHIFT (1 << 5)
52 #define RIGHT_ALT (1 << 6)
53 #define RIGHT_GUI (1 << 7)
55 /* Size of the keyboard buffer */
56 #define USB_KBD_BUFFER_LEN 0x20
59 #define DEVNAME "usbkbd"
62 static const unsigned char usb_kbd_numkey
[] = {
63 '1', '2', '3', '4', '5', '6', '7', '8', '9', '0',
64 '\r', 0x1b, '\b', '\t', ' ', '-', '=', '[', ']',
65 '\\', '#', ';', '\'', '`', ',', '.', '/'
67 static const unsigned char usb_kbd_numkey_shifted
[] = {
68 '!', '@', '#', '$', '%', '^', '&', '*', '(', ')',
69 '\r', 0x1b, '\b', '\t', ' ', '_', '+', '{', '}',
70 '|', '~', ':', '"', '~', '<', '>', '?'
73 static const unsigned char usb_kbd_num_keypad
[] = {
74 '/', '*', '-', '+', '\r',
75 '1', '2', '3', '4', '5', '6', '7', '8', '9', '0',
79 static const u8 usb_special_keys
[] = {
80 #ifdef CONFIG_USB_KEYBOARD_FN_KEYS
81 '2', 'H', '5', '3', 'F', '6', 'C', 'D', 'B', 'A'
88 * NOTE: It's important for the NUM, CAPS, SCROLL-lock bits to be in this
89 * order. See usb_kbd_setled() function!
91 #define USB_KBD_NUMLOCK (1 << 0)
92 #define USB_KBD_CAPSLOCK (1 << 1)
93 #define USB_KBD_SCROLLLOCK (1 << 2)
94 #define USB_KBD_CTRL (1 << 3)
96 #define USB_KBD_LEDMASK \
97 (USB_KBD_NUMLOCK | USB_KBD_CAPSLOCK | USB_KBD_SCROLLLOCK)
99 struct usb_kbd_pdata
{
100 unsigned long intpipe
;
103 unsigned long last_report
;
104 struct int_queue
*intq
;
106 uint32_t repeat_delay
;
108 uint32_t usb_in_pointer
;
109 uint32_t usb_out_pointer
;
110 uint8_t usb_kbd_buffer
[USB_KBD_BUFFER_LEN
];
113 uint8_t old
[USB_KBD_BOOT_REPORT_SIZE
];
118 extern int __maybe_unused net_busy_flag
;
120 /* The period of time between two calls of usb_kbd_testc(). */
121 static unsigned long __maybe_unused kbd_testc_tms
;
123 /* Puts character in the queue and sets up the in and out pointer. */
124 static void usb_kbd_put_queue(struct usb_kbd_pdata
*data
, u8 c
)
126 if (data
->usb_in_pointer
== USB_KBD_BUFFER_LEN
- 1) {
127 /* Check for buffer full. */
128 if (data
->usb_out_pointer
== 0)
131 data
->usb_in_pointer
= 0;
133 /* Check for buffer full. */
134 if (data
->usb_in_pointer
== data
->usb_out_pointer
- 1)
137 data
->usb_in_pointer
++;
140 data
->usb_kbd_buffer
[data
->usb_in_pointer
] = c
;
144 * Set the LEDs. Since this is used in the irq routine, the control job is
145 * issued with a timeout of 0. This means, that the job is queued without
146 * waiting for job completion.
148 static void usb_kbd_setled(struct usb_device
*dev
)
150 struct usb_interface
*iface
= &dev
->config
.if_desc
[0];
151 struct usb_kbd_pdata
*data
= dev
->privptr
;
152 ALLOC_ALIGN_BUFFER(uint32_t, leds
, 1, USB_DMA_MINALIGN
);
154 *leds
= data
->flags
& USB_KBD_LEDMASK
;
155 usb_control_msg(dev
, usb_sndctrlpipe(dev
, 0),
156 USB_REQ_SET_REPORT
, USB_TYPE_CLASS
| USB_RECIP_INTERFACE
,
157 0x200, iface
->desc
.bInterfaceNumber
, leds
, 1, 0);
160 #define CAPITAL_MASK 0x20
161 /* Translate the scancode in ASCII */
162 static int usb_kbd_translate(struct usb_kbd_pdata
*data
, unsigned char scancode
,
163 unsigned char modifier
, int pressed
)
169 data
->repeat_delay
= 0;
174 data
->repeat_delay
++;
175 if (data
->repeat_delay
< REPEAT_DELAY
)
178 data
->repeat_delay
= REPEAT_DELAY
;
181 /* Alphanumeric values */
182 if ((scancode
> 3) && (scancode
<= 0x1d)) {
183 keycode
= scancode
- 4 + 'a';
185 if (data
->flags
& USB_KBD_CAPSLOCK
)
186 keycode
&= ~CAPITAL_MASK
;
188 if (modifier
& (LEFT_SHIFT
| RIGHT_SHIFT
)) {
189 /* Handle CAPSLock + Shift pressed simultaneously */
190 if (keycode
& CAPITAL_MASK
)
191 keycode
&= ~CAPITAL_MASK
;
193 keycode
|= CAPITAL_MASK
;
197 if ((scancode
> 0x1d) && (scancode
< 0x39)) {
199 if (modifier
& (LEFT_SHIFT
| RIGHT_SHIFT
))
200 keycode
= usb_kbd_numkey_shifted
[scancode
- 0x1e];
202 keycode
= usb_kbd_numkey
[scancode
- 0x1e];
206 if ((scancode
>= 0x54) && (scancode
<= 0x67))
207 keycode
= usb_kbd_num_keypad
[scancode
- 0x54];
209 if (data
->flags
& USB_KBD_CTRL
)
210 keycode
= scancode
- 0x3;
213 if (scancode
== NUM_LOCK
) {
214 data
->flags
^= USB_KBD_NUMLOCK
;
218 if (scancode
== CAPS_LOCK
) {
219 data
->flags
^= USB_KBD_CAPSLOCK
;
222 if (scancode
== SCROLL_LOCK
) {
223 data
->flags
^= USB_KBD_SCROLLLOCK
;
228 /* Report keycode if any */
230 debug("%c", keycode
);
231 usb_kbd_put_queue(data
, keycode
);
235 #ifdef CONFIG_USB_KEYBOARD_FN_KEYS
236 if (scancode
< 0x3a || scancode
> 0x52 ||
237 scancode
== 0x46 || scancode
== 0x47)
240 usb_kbd_put_queue(data
, 0x1b);
241 if (scancode
< 0x3e) {
243 usb_kbd_put_queue(data
, 0x4f);
244 usb_kbd_put_queue(data
, scancode
- 0x3a + 'P');
247 usb_kbd_put_queue(data
, '[');
248 if (scancode
< 0x42) {
250 usb_kbd_put_queue(data
, '1');
251 if (scancode
== 0x3e)
253 keycode
= scancode
- 0x3f + '7';
254 } else if (scancode
< 0x49) {
256 usb_kbd_put_queue(data
, '2');
259 keycode
= scancode
- 0x42 + '0';
262 * INSERT, HOME, PAGE UP, DELETE, END, PAGE DOWN,
263 * RIGHT, LEFT, DOWN, UP
265 keycode
= usb_special_keys
[scancode
- 0x49];
267 usb_kbd_put_queue(data
, keycode
);
268 if (scancode
< 0x4f && scancode
!= 0x4a && scancode
!= 0x4d)
269 usb_kbd_put_queue(data
, '~');
272 /* Left, Right, Up, Down */
273 if (scancode
> 0x4e && scancode
< 0x53) {
274 usb_kbd_put_queue(data
, 0x1b);
275 usb_kbd_put_queue(data
, '[');
276 usb_kbd_put_queue(data
, usb_special_keys
[scancode
- 0x4f]);
280 #endif /* CONFIG_USB_KEYBOARD_FN_KEYS */
283 static uint32_t usb_kbd_service_key(struct usb_device
*dev
, int i
, int up
)
286 struct usb_kbd_pdata
*data
= dev
->privptr
;
299 (memscan(new + 2, old
[i
], USB_KBD_BOOT_REPORT_SIZE
- 2) ==
300 new + USB_KBD_BOOT_REPORT_SIZE
)) {
301 res
|= usb_kbd_translate(data
, old
[i
], data
->new[0], up
);
307 /* Interrupt service routine */
308 static int usb_kbd_irq_worker(struct usb_device
*dev
)
310 struct usb_kbd_pdata
*data
= dev
->privptr
;
313 /* No combo key pressed */
314 if (data
->new[0] == 0x00)
315 data
->flags
&= ~USB_KBD_CTRL
;
316 /* Left or Right Ctrl pressed */
317 else if ((data
->new[0] == LEFT_CNTR
) || (data
->new[0] == RIGHT_CNTR
))
318 data
->flags
|= USB_KBD_CTRL
;
320 for (i
= 2; i
< USB_KBD_BOOT_REPORT_SIZE
; i
++) {
321 res
|= usb_kbd_service_key(dev
, i
, 0);
322 res
|= usb_kbd_service_key(dev
, i
, 1);
325 /* Key is still pressed */
326 if ((data
->new[2] > 3) && (data
->old
[2] == data
->new[2]))
327 res
|= usb_kbd_translate(data
, data
->new[2], data
->new[0], 2);
332 memcpy(data
->old
, data
->new, USB_KBD_BOOT_REPORT_SIZE
);
337 /* Keyboard interrupt handler */
338 static int usb_kbd_irq(struct usb_device
*dev
)
340 if ((dev
->irq_status
!= 0) ||
341 (dev
->irq_act_len
!= USB_KBD_BOOT_REPORT_SIZE
)) {
342 debug("USB KBD: Error %lX, len %d\n",
343 dev
->irq_status
, dev
->irq_act_len
);
347 return usb_kbd_irq_worker(dev
);
350 /* Interrupt polling */
351 static inline void usb_kbd_poll_for_event(struct usb_device
*dev
)
353 #if defined(CONFIG_SYS_USB_EVENT_POLL)
354 struct usb_kbd_pdata
*data
= dev
->privptr
;
356 /* Submit an interrupt transfer request */
357 if (usb_int_msg(dev
, data
->intpipe
, &data
->new[0],
358 data
->intpktsize
, data
->intinterval
, true) >= 0)
359 usb_kbd_irq_worker(dev
);
360 #elif defined(CONFIG_SYS_USB_EVENT_POLL_VIA_CONTROL_EP) || \
361 defined(CONFIG_SYS_USB_EVENT_POLL_VIA_INT_QUEUE)
362 #if defined(CONFIG_SYS_USB_EVENT_POLL_VIA_CONTROL_EP)
363 struct usb_interface
*iface
;
364 struct usb_kbd_pdata
*data
= dev
->privptr
;
365 iface
= &dev
->config
.if_desc
[0];
366 usb_get_report(dev
, iface
->desc
.bInterfaceNumber
,
367 1, 0, data
->new, USB_KBD_BOOT_REPORT_SIZE
);
368 if (memcmp(data
->old
, data
->new, USB_KBD_BOOT_REPORT_SIZE
)) {
369 usb_kbd_irq_worker(dev
);
371 struct usb_kbd_pdata
*data
= dev
->privptr
;
372 if (poll_int_queue(dev
, data
->intq
)) {
373 usb_kbd_irq_worker(dev
);
374 /* We've consumed all queued int packets, create new */
375 destroy_int_queue(dev
, data
->intq
);
376 data
->intq
= create_int_queue(dev
, data
->intpipe
, 1,
377 USB_KBD_BOOT_REPORT_SIZE
, data
->new,
380 data
->last_report
= get_timer(0);
381 /* Repeat last usb hid report every REPEAT_RATE ms for keyrepeat */
382 } else if (data
->last_report
!= -1 &&
383 get_timer(data
->last_report
) > REPEAT_RATE
) {
384 usb_kbd_irq_worker(dev
);
385 data
->last_report
= get_timer(0);
390 /* test if a character is in the queue */
391 static int usb_kbd_testc(struct stdio_dev
*sdev
)
393 struct stdio_dev
*dev
;
394 struct usb_device
*usb_kbd_dev
;
395 struct usb_kbd_pdata
*data
;
397 #ifdef CONFIG_CMD_NET
399 * If net_busy_flag is 1, NET transfer is running,
400 * then we check key-pressed every second (first check may be
401 * less than 1 second) to improve TFTP booting performance.
403 if (net_busy_flag
&& (get_timer(kbd_testc_tms
) < CONFIG_SYS_HZ
))
405 kbd_testc_tms
= get_timer(0);
407 dev
= stdio_get_by_name(sdev
->name
);
408 usb_kbd_dev
= (struct usb_device
*)dev
->priv
;
409 data
= usb_kbd_dev
->privptr
;
411 usb_kbd_poll_for_event(usb_kbd_dev
);
413 return !(data
->usb_in_pointer
== data
->usb_out_pointer
);
416 /* gets the character from the queue */
417 static int usb_kbd_getc(struct stdio_dev
*sdev
)
419 struct stdio_dev
*dev
;
420 struct usb_device
*usb_kbd_dev
;
421 struct usb_kbd_pdata
*data
;
423 dev
= stdio_get_by_name(sdev
->name
);
424 usb_kbd_dev
= (struct usb_device
*)dev
->priv
;
425 data
= usb_kbd_dev
->privptr
;
427 while (data
->usb_in_pointer
== data
->usb_out_pointer
) {
429 usb_kbd_poll_for_event(usb_kbd_dev
);
432 if (data
->usb_out_pointer
== USB_KBD_BUFFER_LEN
- 1)
433 data
->usb_out_pointer
= 0;
435 data
->usb_out_pointer
++;
437 return data
->usb_kbd_buffer
[data
->usb_out_pointer
];
440 /* probes the USB device dev for keyboard type. */
441 static int usb_kbd_probe_dev(struct usb_device
*dev
, unsigned int ifnum
)
443 struct usb_interface
*iface
;
444 struct usb_endpoint_descriptor
*ep
;
445 struct usb_kbd_pdata
*data
;
447 if (dev
->descriptor
.bNumConfigurations
!= 1)
450 iface
= &dev
->config
.if_desc
[ifnum
];
452 if (iface
->desc
.bInterfaceClass
!= USB_CLASS_HID
)
455 if (iface
->desc
.bInterfaceSubClass
!= USB_SUB_HID_BOOT
)
458 if (iface
->desc
.bInterfaceProtocol
!= USB_PROT_HID_KEYBOARD
)
461 if (iface
->desc
.bNumEndpoints
!= 1)
464 ep
= &iface
->ep_desc
[0];
466 /* Check if endpoint 1 is interrupt endpoint */
467 if (!(ep
->bEndpointAddress
& 0x80))
470 if ((ep
->bmAttributes
& 3) != 3)
473 debug("USB KBD: found set protocol...\n");
475 data
= malloc(sizeof(struct usb_kbd_pdata
));
477 printf("USB KBD: Error allocating private data\n");
481 /* Clear private data */
482 memset(data
, 0, sizeof(struct usb_kbd_pdata
));
484 /* allocate input buffer aligned and sized to USB DMA alignment */
485 data
->new = memalign(USB_DMA_MINALIGN
,
486 roundup(USB_KBD_BOOT_REPORT_SIZE
, USB_DMA_MINALIGN
));
488 /* Insert private data into USB device structure */
491 /* Set IRQ handler */
492 dev
->irq_handle
= usb_kbd_irq
;
494 data
->intpipe
= usb_rcvintpipe(dev
, ep
->bEndpointAddress
);
495 data
->intpktsize
= min(usb_maxpacket(dev
, data
->intpipe
),
496 USB_KBD_BOOT_REPORT_SIZE
);
497 data
->intinterval
= ep
->bInterval
;
498 data
->last_report
= -1;
500 /* We found a USB Keyboard, install it. */
501 usb_set_protocol(dev
, iface
->desc
.bInterfaceNumber
, 0);
503 debug("USB KBD: found set idle...\n");
504 #if !defined(CONFIG_SYS_USB_EVENT_POLL_VIA_CONTROL_EP) && \
505 !defined(CONFIG_SYS_USB_EVENT_POLL_VIA_INT_QUEUE)
506 usb_set_idle(dev
, iface
->desc
.bInterfaceNumber
, REPEAT_RATE
/ 4, 0);
508 usb_set_idle(dev
, iface
->desc
.bInterfaceNumber
, 0, 0);
511 debug("USB KBD: enable interrupt pipe...\n");
512 #ifdef CONFIG_SYS_USB_EVENT_POLL_VIA_INT_QUEUE
513 data
->intq
= create_int_queue(dev
, data
->intpipe
, 1,
514 USB_KBD_BOOT_REPORT_SIZE
, data
->new,
517 #elif defined(CONFIG_SYS_USB_EVENT_POLL_VIA_CONTROL_EP)
518 if (usb_get_report(dev
, iface
->desc
.bInterfaceNumber
,
519 1, 0, data
->new, USB_KBD_BOOT_REPORT_SIZE
) < 0) {
521 if (usb_int_msg(dev
, data
->intpipe
, data
->new, data
->intpktsize
,
522 data
->intinterval
, false) < 0) {
524 printf("Failed to get keyboard state from device %04x:%04x\n",
525 dev
->descriptor
.idVendor
, dev
->descriptor
.idProduct
);
526 /* Abort, we don't want to use that non-functional keyboard. */
534 static int probe_usb_keyboard(struct usb_device
*dev
)
537 struct stdio_dev usb_kbd_dev
;
540 /* Try probing the keyboard */
541 if (usb_kbd_probe_dev(dev
, 0) != 1)
544 /* Register the keyboard */
545 debug("USB KBD: register.\n");
546 memset(&usb_kbd_dev
, 0, sizeof(struct stdio_dev
));
547 strcpy(usb_kbd_dev
.name
, DEVNAME
);
548 usb_kbd_dev
.flags
= DEV_FLAGS_INPUT
;
549 usb_kbd_dev
.getc
= usb_kbd_getc
;
550 usb_kbd_dev
.tstc
= usb_kbd_testc
;
551 usb_kbd_dev
.priv
= (void *)dev
;
552 error
= stdio_register(&usb_kbd_dev
);
556 stdinname
= env_get("stdin");
557 #if CONFIG_IS_ENABLED(CONSOLE_MUX)
558 error
= iomux_doenv(stdin
, stdinname
);
562 /* Check if this is the standard input device. */
563 if (strcmp(stdinname
, DEVNAME
))
566 /* Reassign the console */
567 if (overwrite_console())
570 error
= console_assign(stdin
, DEVNAME
);
578 #if !CONFIG_IS_ENABLED(DM_USB)
579 /* Search for keyboard and register it if found. */
580 int drv_usb_kbd_init(void)
584 debug("%s: Probing for keyboard\n", __func__
);
585 /* Scan all USB Devices */
586 for (i
= 0; i
< USB_MAX_DEVICE
; i
++) {
587 struct usb_device
*dev
;
589 /* Get USB device. */
590 dev
= usb_get_dev_index(i
);
594 if (dev
->devnum
== -1)
597 error
= probe_usb_keyboard(dev
);
600 if (error
&& error
!= -ENOENT
)
604 /* No USB Keyboard found */
608 /* Deregister the keyboard. */
609 int usb_kbd_deregister(int force
)
611 #if CONFIG_IS_ENABLED(SYS_STDIO_DEREGISTER)
612 struct stdio_dev
*dev
;
613 struct usb_device
*usb_kbd_dev
;
614 struct usb_kbd_pdata
*data
;
616 dev
= stdio_get_by_name(DEVNAME
);
618 usb_kbd_dev
= (struct usb_device
*)dev
->priv
;
619 data
= usb_kbd_dev
->privptr
;
620 if (stdio_deregister_dev(dev
, force
) != 0)
622 #if CONFIG_IS_ENABLED(CONSOLE_MUX)
623 if (iomux_doenv(stdin
, env_get("stdin")) != 0)
626 #ifdef CONFIG_SYS_USB_EVENT_POLL_VIA_INT_QUEUE
627 destroy_int_queue(usb_kbd_dev
, data
->intq
);
641 #if CONFIG_IS_ENABLED(DM_USB)
643 static int usb_kbd_probe(struct udevice
*dev
)
645 struct usb_device
*udev
= dev_get_parent_priv(dev
);
647 return probe_usb_keyboard(udev
);
650 static int usb_kbd_remove(struct udevice
*dev
)
652 struct usb_device
*udev
= dev_get_parent_priv(dev
);
653 struct usb_kbd_pdata
*data
;
654 struct stdio_dev
*sdev
;
657 sdev
= stdio_get_by_name(DEVNAME
);
662 data
= udev
->privptr
;
663 if (stdio_deregister_dev(sdev
, true)) {
667 #if CONFIG_IS_ENABLED(CONSOLE_MUX)
668 if (iomux_doenv(stdin
, env_get("stdin"))) {
673 #ifdef CONFIG_SYS_USB_EVENT_POLL_VIA_INT_QUEUE
674 destroy_int_queue(udev
, data
->intq
);
681 printf("%s: warning, ret=%d", __func__
, ret
);
685 static const struct udevice_id usb_kbd_ids
[] = {
686 { .compatible
= "usb-keyboard" },
690 U_BOOT_DRIVER(usb_kbd
) = {
692 .id
= UCLASS_KEYBOARD
,
693 .of_match
= usb_kbd_ids
,
694 .probe
= usb_kbd_probe
,
695 .remove
= usb_kbd_remove
,
698 static const struct usb_device_id kbd_id_table
[] = {
700 .match_flags
= USB_DEVICE_ID_MATCH_INT_CLASS
|
701 USB_DEVICE_ID_MATCH_INT_SUBCLASS
|
702 USB_DEVICE_ID_MATCH_INT_PROTOCOL
,
703 .bInterfaceClass
= USB_CLASS_HID
,
704 .bInterfaceSubClass
= USB_SUB_HID_BOOT
,
705 .bInterfaceProtocol
= USB_PROT_HID_KEYBOARD
,
707 { } /* Terminating entry */
710 U_BOOT_USB_DEVICE(usb_kbd
, kbd_id_table
);