blob: 820f591fc5bb5d408be2fdba8868e51cb8d85c8b [file] [log] [blame]
Tom Rini83d290c2018-05-06 17:58:06 -04001// SPDX-License-Identifier: GPL-2.0+
wdenkaffae2b2002-08-17 09:36:01 +00002/*
3 * (C) Copyright 2001
4 * Denis Peter, MPL AG Switzerland
5 *
6 * Part of this source has been derived from the Linux USB
7 * project.
wdenkaffae2b2002-08-17 09:36:01 +00008 */
Tom Rinid678a592024-05-18 20:20:43 -06009#include <common.h>
Simon Glass24b852a2015-11-08 23:47:45 -070010#include <console.h>
Simon Glass697033c2015-03-25 12:22:34 -060011#include <dm.h>
Simon Glass7b51b572019-08-01 09:46:52 -060012#include <env.h>
Hans de Goede0ea09df2014-09-20 16:54:34 +020013#include <errno.h>
Simon Glassf7ae49f2020-05-10 11:40:05 -060014#include <log.h>
Marek Vasut9a8c72a2011-10-10 16:34:26 +010015#include <malloc.h>
Simon Glasscf92e052015-09-02 17:24:58 -060016#include <memalign.h>
Jean-Christophe PLAGNIOL-VILLARD52cb4d42009-05-16 12:14:54 +020017#include <stdio_dev.h>
Michal Simekf8f3e0e2018-06-27 14:16:54 +020018#include <watchdog.h>
Christian Eggersc9182612008-05-21 22:12:00 +020019#include <asm/byteorder.h>
Thomas Watson96991e62022-02-10 15:13:14 -060020#ifdef CONFIG_SANDBOX
21#include <asm/state.h>
22#endif
wdenkaffae2b2002-08-17 09:36:01 +000023
wdenkaffae2b2002-08-17 09:36:01 +000024#include <usb.h>
25
wdenkaffae2b2002-08-17 09:36:01 +000026/*
Janne Grunau575c6822024-04-04 08:25:53 +020027 * USB vendor and product IDs used for quirks.
28 */
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
33
Janne Grunau63f6a442024-04-04 08:25:54 +020034#define USB_VENDOR_ID_KEYCHRON 0x3434
35
36#define USB_HID_QUIRK_POLL_NO_REPORT_IDLE BIT(0)
37
Janne Grunau575c6822024-04-04 08:25:53 +020038/*
Marek Vasut00b7d6e2011-10-10 05:34:25 +000039 * If overwrite_console returns 1, the stdin, stderr and stdout
wdenkaffae2b2002-08-17 09:36:01 +000040 * are switched to the serial port, else the settings in the
41 * environment are used
42 */
Jean-Christophe PLAGNIOL-VILLARD6d0f6bc2008-10-16 15:01:15 +020043#ifdef CONFIG_SYS_CONSOLE_OVERWRITE_ROUTINE
Marek Vasut00b7d6e2011-10-10 05:34:25 +000044extern int overwrite_console(void);
wdenkaffae2b2002-08-17 09:36:01 +000045#else
Marek Vasut00b7d6e2011-10-10 05:34:25 +000046int overwrite_console(void)
wdenkaffae2b2002-08-17 09:36:01 +000047{
Marek Vasut00b7d6e2011-10-10 05:34:25 +000048 return 0;
wdenkaffae2b2002-08-17 09:36:01 +000049}
50#endif
51
Marek Vasut9a8c72a2011-10-10 16:34:26 +010052/* Keyboard sampling rate */
Hans de Goede8454c842015-05-19 22:51:03 +020053#define REPEAT_RATE 40 /* 40msec -> 25cps */
Marek Vasut9a8c72a2011-10-10 16:34:26 +010054#define REPEAT_DELAY 10 /* 10 x REPEAT_RATE = 400msec */
wdenkaffae2b2002-08-17 09:36:01 +000055
56#define NUM_LOCK 0x53
Marek Vasut00b7d6e2011-10-10 05:34:25 +000057#define CAPS_LOCK 0x39
58#define SCROLL_LOCK 0x47
wdenkaffae2b2002-08-17 09:36:01 +000059
wdenkaffae2b2002-08-17 09:36:01 +000060/* Modifier bits */
Marek Vasut9a8c72a2011-10-10 16:34:26 +010061#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)
wdenkaffae2b2002-08-17 09:36:01 +000069
Marek Vasut9a8c72a2011-10-10 16:34:26 +010070/* Size of the keyboard buffer */
71#define USB_KBD_BUFFER_LEN 0x20
wdenkaffae2b2002-08-17 09:36:01 +000072
Marek Vasut9a8c72a2011-10-10 16:34:26 +010073/* Device name */
Marek Vasut00b7d6e2011-10-10 05:34:25 +000074#define DEVNAME "usbkbd"
wdenkaffae2b2002-08-17 09:36:01 +000075
Marek Vasut9a8c72a2011-10-10 16:34:26 +010076/* Keyboard maps */
77static const unsigned char usb_kbd_numkey[] = {
Marek Vasut00b7d6e2011-10-10 05:34:25 +000078 '1', '2', '3', '4', '5', '6', '7', '8', '9', '0',
79 '\r', 0x1b, '\b', '\t', ' ', '-', '=', '[', ']',
80 '\\', '#', ';', '\'', '`', ',', '.', '/'
wdenkaffae2b2002-08-17 09:36:01 +000081};
Marek Vasut9a8c72a2011-10-10 16:34:26 +010082static const unsigned char usb_kbd_numkey_shifted[] = {
Marek Vasut00b7d6e2011-10-10 05:34:25 +000083 '!', '@', '#', '$', '%', '^', '&', '*', '(', ')',
84 '\r', 0x1b, '\b', '\t', ' ', '_', '+', '{', '}',
85 '|', '~', ':', '"', '~', '<', '>', '?'
wdenkaffae2b2002-08-17 09:36:01 +000086};
87
Vincent Palatind53da842012-01-09 12:59:36 +000088static const unsigned char usb_kbd_num_keypad[] = {
89 '/', '*', '-', '+', '\r',
90 '1', '2', '3', '4', '5', '6', '7', '8', '9', '0',
91 '.', 0, 0, 0, '='
92};
93
Heinrich Schuchardt3352c212019-11-23 18:15:20 +010094static const u8 usb_special_keys[] = {
Heinrich Schuchardt87e91bc2019-11-23 18:15:21 +010095#ifdef CONFIG_USB_KEYBOARD_FN_KEYS
96 '2', 'H', '5', '3', 'F', '6', 'C', 'D', 'B', 'A'
97#else
Heinrich Schuchardt3352c212019-11-23 18:15:20 +010098 'C', 'D', 'B', 'A'
Heinrich Schuchardt87e91bc2019-11-23 18:15:21 +010099#endif
Allen Martin4151a402012-11-06 13:26:03 -0800100};
101
102/*
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100103 * NOTE: It's important for the NUM, CAPS, SCROLL-lock bits to be in this
104 * order. See usb_kbd_setled() function!
105 */
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)
Marek Vasut48c80732011-09-25 20:00:37 +0100110
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100111#define USB_KBD_LEDMASK \
112 (USB_KBD_NUMLOCK | USB_KBD_CAPSLOCK | USB_KBD_SCROLLLOCK)
113
114struct usb_kbd_pdata {
Hans de Goede8f8d7d22014-09-24 14:06:10 +0200115 unsigned long intpipe;
116 int intpktsize;
117 int intinterval;
Hans de Goede8454c842015-05-19 22:51:03 +0200118 unsigned long last_report;
Hans de Goede8e553112014-09-24 14:06:11 +0200119 struct int_queue *intq;
Hans de Goede8f8d7d22014-09-24 14:06:10 +0200120
Janne Grunau575c6822024-04-04 08:25:53 +0200121 uint32_t ifnum;
122
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100123 uint32_t repeat_delay;
124
125 uint32_t usb_in_pointer;
126 uint32_t usb_out_pointer;
127 uint8_t usb_kbd_buffer[USB_KBD_BUFFER_LEN];
128
Allen Martind7475382012-10-24 08:32:04 +0000129 uint8_t *new;
Adrian Cox08a98b82014-04-10 14:02:44 +0100130 uint8_t old[USB_KBD_BOOT_REPORT_SIZE];
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100131
132 uint8_t flags;
133};
134
Jim Lin07551f22013-08-13 19:04:22 +0800135extern int __maybe_unused net_busy_flag;
136
137/* The period of time between two calls of usb_kbd_testc(). */
Thomas Watson96991e62022-02-10 15:13:14 -0600138static unsigned long kbd_testc_tms;
Jim Lin07551f22013-08-13 19:04:22 +0800139
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100140/* Puts character in the queue and sets up the in and out pointer. */
Heinrich Schuchardt28dfa7d2019-11-23 18:15:19 +0100141static void usb_kbd_put_queue(struct usb_kbd_pdata *data, u8 c)
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100142{
143 if (data->usb_in_pointer == USB_KBD_BUFFER_LEN - 1) {
144 /* Check for buffer full. */
145 if (data->usb_out_pointer == 0)
146 return;
147
148 data->usb_in_pointer = 0;
149 } else {
150 /* Check for buffer full. */
151 if (data->usb_in_pointer == data->usb_out_pointer - 1)
152 return;
153
154 data->usb_in_pointer++;
155 }
156
157 data->usb_kbd_buffer[data->usb_in_pointer] = c;
158}
159
160/*
161 * Set the LEDs. Since this is used in the irq routine, the control job is
162 * issued with a timeout of 0. This means, that the job is queued without
163 * waiting for job completion.
164 */
165static void usb_kbd_setled(struct usb_device *dev)
166{
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100167 struct usb_kbd_pdata *data = dev->privptr;
Janne Grunau575c6822024-04-04 08:25:53 +0200168 struct usb_interface *iface = &dev->config.if_desc[data->ifnum];
Hans de Goede9b239382014-09-20 16:51:26 +0200169 ALLOC_ALIGN_BUFFER(uint32_t, leds, 1, USB_DMA_MINALIGN);
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100170
Hans de Goede9b239382014-09-20 16:51:26 +0200171 *leds = data->flags & USB_KBD_LEDMASK;
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100172 usb_control_msg(dev, usb_sndctrlpipe(dev, 0),
173 USB_REQ_SET_REPORT, USB_TYPE_CLASS | USB_RECIP_INTERFACE,
Hans de Goede9b239382014-09-20 16:51:26 +0200174 0x200, iface->desc.bInterfaceNumber, leds, 1, 0);
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100175}
176
177#define CAPITAL_MASK 0x20
178/* Translate the scancode in ASCII */
179static int usb_kbd_translate(struct usb_kbd_pdata *data, unsigned char scancode,
180 unsigned char modifier, int pressed)
181{
182 uint8_t keycode = 0;
183
184 /* Key released */
185 if (pressed == 0) {
186 data->repeat_delay = 0;
187 return 0;
188 }
189
190 if (pressed == 2) {
191 data->repeat_delay++;
192 if (data->repeat_delay < REPEAT_DELAY)
193 return 0;
194
195 data->repeat_delay = REPEAT_DELAY;
196 }
197
198 /* Alphanumeric values */
199 if ((scancode > 3) && (scancode <= 0x1d)) {
200 keycode = scancode - 4 + 'a';
201
202 if (data->flags & USB_KBD_CAPSLOCK)
203 keycode &= ~CAPITAL_MASK;
204
205 if (modifier & (LEFT_SHIFT | RIGHT_SHIFT)) {
206 /* Handle CAPSLock + Shift pressed simultaneously */
207 if (keycode & CAPITAL_MASK)
208 keycode &= ~CAPITAL_MASK;
209 else
210 keycode |= CAPITAL_MASK;
211 }
212 }
213
Marek Vasutbdbcbe72016-01-25 22:00:44 +0100214 if ((scancode > 0x1d) && (scancode < 0x39)) {
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100215 /* Shift pressed */
216 if (modifier & (LEFT_SHIFT | RIGHT_SHIFT))
217 keycode = usb_kbd_numkey_shifted[scancode - 0x1e];
218 else
219 keycode = usb_kbd_numkey[scancode - 0x1e];
220 }
221
Vincent Palatind53da842012-01-09 12:59:36 +0000222 /* Numeric keypad */
223 if ((scancode >= 0x54) && (scancode <= 0x67))
224 keycode = usb_kbd_num_keypad[scancode - 0x54];
225
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100226 if (data->flags & USB_KBD_CTRL)
227 keycode = scancode - 0x3;
228
229 if (pressed == 1) {
230 if (scancode == NUM_LOCK) {
231 data->flags ^= USB_KBD_NUMLOCK;
232 return 1;
233 }
234
235 if (scancode == CAPS_LOCK) {
236 data->flags ^= USB_KBD_CAPSLOCK;
237 return 1;
238 }
239 if (scancode == SCROLL_LOCK) {
240 data->flags ^= USB_KBD_SCROLLLOCK;
241 return 1;
242 }
243 }
244
245 /* Report keycode if any */
Heinrich Schuchardt3352c212019-11-23 18:15:20 +0100246 if (keycode) {
Vivek Gautamceb49722013-04-12 16:34:33 +0530247 debug("%c", keycode);
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100248 usb_kbd_put_queue(data, keycode);
Heinrich Schuchardt3352c212019-11-23 18:15:20 +0100249 return 0;
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100250 }
251
Heinrich Schuchardt87e91bc2019-11-23 18:15:21 +0100252#ifdef CONFIG_USB_KEYBOARD_FN_KEYS
253 if (scancode < 0x3a || scancode > 0x52 ||
254 scancode == 0x46 || scancode == 0x47)
255 return 1;
256
257 usb_kbd_put_queue(data, 0x1b);
258 if (scancode < 0x3e) {
259 /* F1 - F4 */
260 usb_kbd_put_queue(data, 0x4f);
261 usb_kbd_put_queue(data, scancode - 0x3a + 'P');
262 return 0;
263 }
264 usb_kbd_put_queue(data, '[');
265 if (scancode < 0x42) {
266 /* F5 - F8 */
267 usb_kbd_put_queue(data, '1');
268 if (scancode == 0x3e)
269 --scancode;
270 keycode = scancode - 0x3f + '7';
271 } else if (scancode < 0x49) {
272 /* F9 - F12 */
273 usb_kbd_put_queue(data, '2');
274 if (scancode > 0x43)
275 ++scancode;
276 keycode = scancode - 0x42 + '0';
277 } else {
278 /*
279 * INSERT, HOME, PAGE UP, DELETE, END, PAGE DOWN,
280 * RIGHT, LEFT, DOWN, UP
281 */
282 keycode = usb_special_keys[scancode - 0x49];
283 }
284 usb_kbd_put_queue(data, keycode);
285 if (scancode < 0x4f && scancode != 0x4a && scancode != 0x4d)
286 usb_kbd_put_queue(data, '~');
287 return 0;
288#else
Heinrich Schuchardt3352c212019-11-23 18:15:20 +0100289 /* Left, Right, Up, Down */
290 if (scancode > 0x4e && scancode < 0x53) {
291 usb_kbd_put_queue(data, 0x1b);
292 usb_kbd_put_queue(data, '[');
293 usb_kbd_put_queue(data, usb_special_keys[scancode - 0x4f]);
294 return 0;
295 }
296 return 1;
Heinrich Schuchardt87e91bc2019-11-23 18:15:21 +0100297#endif /* CONFIG_USB_KEYBOARD_FN_KEYS */
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100298}
299
300static uint32_t usb_kbd_service_key(struct usb_device *dev, int i, int up)
301{
302 uint32_t res = 0;
303 struct usb_kbd_pdata *data = dev->privptr;
304 uint8_t *new;
305 uint8_t *old;
306
307 if (up) {
308 new = data->old;
309 old = data->new;
310 } else {
311 new = data->new;
312 old = data->old;
313 }
314
Adrian Cox08a98b82014-04-10 14:02:44 +0100315 if ((old[i] > 3) &&
316 (memscan(new + 2, old[i], USB_KBD_BOOT_REPORT_SIZE - 2) ==
317 new + USB_KBD_BOOT_REPORT_SIZE)) {
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100318 res |= usb_kbd_translate(data, old[i], data->new[0], up);
Adrian Cox08a98b82014-04-10 14:02:44 +0100319 }
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100320
321 return res;
322}
323
324/* Interrupt service routine */
325static int usb_kbd_irq_worker(struct usb_device *dev)
326{
327 struct usb_kbd_pdata *data = dev->privptr;
328 int i, res = 0;
329
330 /* No combo key pressed */
331 if (data->new[0] == 0x00)
332 data->flags &= ~USB_KBD_CTRL;
333 /* Left or Right Ctrl pressed */
334 else if ((data->new[0] == LEFT_CNTR) || (data->new[0] == RIGHT_CNTR))
335 data->flags |= USB_KBD_CTRL;
336
Adrian Cox08a98b82014-04-10 14:02:44 +0100337 for (i = 2; i < USB_KBD_BOOT_REPORT_SIZE; i++) {
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100338 res |= usb_kbd_service_key(dev, i, 0);
339 res |= usb_kbd_service_key(dev, i, 1);
340 }
341
342 /* Key is still pressed */
343 if ((data->new[2] > 3) && (data->old[2] == data->new[2]))
344 res |= usb_kbd_translate(data, data->new[2], data->new[0], 2);
345
346 if (res == 1)
347 usb_kbd_setled(dev);
348
Adrian Cox08a98b82014-04-10 14:02:44 +0100349 memcpy(data->old, data->new, USB_KBD_BOOT_REPORT_SIZE);
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100350
351 return 1;
352}
353
354/* Keyboard interrupt handler */
355static int usb_kbd_irq(struct usb_device *dev)
356{
Adrian Cox08a98b82014-04-10 14:02:44 +0100357 if ((dev->irq_status != 0) ||
358 (dev->irq_act_len != USB_KBD_BOOT_REPORT_SIZE)) {
Vivek Gautamceb49722013-04-12 16:34:33 +0530359 debug("USB KBD: Error %lX, len %d\n",
360 dev->irq_status, dev->irq_act_len);
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100361 return 1;
362 }
363
364 return usb_kbd_irq_worker(dev);
365}
366
367/* Interrupt polling */
Marek Vasut48c80732011-09-25 20:00:37 +0100368static inline void usb_kbd_poll_for_event(struct usb_device *dev)
369{
Hans de Goede8454c842015-05-19 22:51:03 +0200370#if defined(CONFIG_SYS_USB_EVENT_POLL)
Hans de Goede8f8d7d22014-09-24 14:06:10 +0200371 struct usb_kbd_pdata *data = dev->privptr;
amartin@nvidia.comf9636e82011-12-20 14:56:16 +0000372
Heinrich Schuchardt216db3a2019-11-23 18:15:18 +0100373 /* Submit an interrupt transfer request */
Michal Suchanekfdd135b2019-08-18 10:55:25 +0200374 if (usb_int_msg(dev, data->intpipe, &data->new[0],
Michal Suchanek34371212019-08-18 10:55:27 +0200375 data->intpktsize, data->intinterval, true) >= 0)
Michal Suchanek3e816a22019-08-18 10:55:24 +0200376 usb_kbd_irq_worker(dev);
Hans de Goede8454c842015-05-19 22:51:03 +0200377#elif defined(CONFIG_SYS_USB_EVENT_POLL_VIA_CONTROL_EP) || \
378 defined(CONFIG_SYS_USB_EVENT_POLL_VIA_INT_QUEUE)
379#if defined(CONFIG_SYS_USB_EVENT_POLL_VIA_CONTROL_EP)
Marek Vasut48c80732011-09-25 20:00:37 +0100380 struct usb_interface *iface;
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100381 struct usb_kbd_pdata *data = dev->privptr;
Janne Grunau575c6822024-04-04 08:25:53 +0200382 iface = &dev->config.if_desc[data->ifnum];
Marek Vasut48c80732011-09-25 20:00:37 +0100383 usb_get_report(dev, iface->desc.bInterfaceNumber,
Adrian Cox08a98b82014-04-10 14:02:44 +0100384 1, 0, data->new, USB_KBD_BOOT_REPORT_SIZE);
Hans de Goede8454c842015-05-19 22:51:03 +0200385 if (memcmp(data->old, data->new, USB_KBD_BOOT_REPORT_SIZE)) {
Marek Vasut48c80732011-09-25 20:00:37 +0100386 usb_kbd_irq_worker(dev);
Hans de Goede8454c842015-05-19 22:51:03 +0200387#else
Hans de Goede8e553112014-09-24 14:06:11 +0200388 struct usb_kbd_pdata *data = dev->privptr;
389 if (poll_int_queue(dev, data->intq)) {
390 usb_kbd_irq_worker(dev);
391 /* We've consumed all queued int packets, create new */
392 destroy_int_queue(dev, data->intq);
393 data->intq = create_int_queue(dev, data->intpipe, 1,
Hans de Goede8bb6c1d2015-01-11 20:38:28 +0100394 USB_KBD_BOOT_REPORT_SIZE, data->new,
395 data->intinterval);
Hans de Goede8454c842015-05-19 22:51:03 +0200396#endif
397 data->last_report = get_timer(0);
398 /* Repeat last usb hid report every REPEAT_RATE ms for keyrepeat */
399 } else if (data->last_report != -1 &&
400 get_timer(data->last_report) > REPEAT_RATE) {
401 usb_kbd_irq_worker(dev);
402 data->last_report = get_timer(0);
Hans de Goede8e553112014-09-24 14:06:11 +0200403 }
Marek Vasut48c80732011-09-25 20:00:37 +0100404#endif
405}
406
wdenkaffae2b2002-08-17 09:36:01 +0000407/* test if a character is in the queue */
Simon Glass709ea542014-07-23 06:54:59 -0600408static int usb_kbd_testc(struct stdio_dev *sdev)
wdenkaffae2b2002-08-17 09:36:01 +0000409{
Marek Vasut48c80732011-09-25 20:00:37 +0100410 struct stdio_dev *dev;
411 struct usb_device *usb_kbd_dev;
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100412 struct usb_kbd_pdata *data;
Marek Vasut48c80732011-09-25 20:00:37 +0100413
Thomas Watson96991e62022-02-10 15:13:14 -0600414 /*
415 * Polling the keyboard for an event can take dozens of milliseconds.
416 * Add a delay between polls to avoid blocking activity which polls
417 * rapidly, like the UEFI console timer.
418 */
419 unsigned long poll_delay = CONFIG_SYS_HZ / 50;
420
Jim Linc95e2b92013-08-26 20:21:09 +0800421#ifdef CONFIG_CMD_NET
422 /*
423 * If net_busy_flag is 1, NET transfer is running,
424 * then we check key-pressed every second (first check may be
425 * less than 1 second) to improve TFTP booting performance.
426 */
Thomas Watson96991e62022-02-10 15:13:14 -0600427 if (net_busy_flag)
428 poll_delay = CONFIG_SYS_HZ;
Jim Linc95e2b92013-08-26 20:21:09 +0800429#endif
Thomas Watson96991e62022-02-10 15:13:14 -0600430
431#ifdef CONFIG_SANDBOX
432 /*
433 * Skip delaying polls if a test requests it.
434 */
435 if (state_get_skip_delays())
436 poll_delay = 0;
437#endif
438
Michal Simek4fb67f42018-06-27 14:35:07 +0200439 dev = stdio_get_by_name(sdev->name);
Marek Vasut48c80732011-09-25 20:00:37 +0100440 usb_kbd_dev = (struct usb_device *)dev->priv;
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100441 data = usb_kbd_dev->privptr;
Marek Vasut48c80732011-09-25 20:00:37 +0100442
Thomas Watson96991e62022-02-10 15:13:14 -0600443 if (get_timer(kbd_testc_tms) >= poll_delay) {
444 usb_kbd_poll_for_event(usb_kbd_dev);
445 kbd_testc_tms = get_timer(0);
446 }
Marek Vasut48c80732011-09-25 20:00:37 +0100447
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100448 return !(data->usb_in_pointer == data->usb_out_pointer);
wdenkaffae2b2002-08-17 09:36:01 +0000449}
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100450
wdenkaffae2b2002-08-17 09:36:01 +0000451/* gets the character from the queue */
Simon Glass709ea542014-07-23 06:54:59 -0600452static int usb_kbd_getc(struct stdio_dev *sdev)
wdenkaffae2b2002-08-17 09:36:01 +0000453{
Marek Vasut48c80732011-09-25 20:00:37 +0100454 struct stdio_dev *dev;
455 struct usb_device *usb_kbd_dev;
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100456 struct usb_kbd_pdata *data;
Marek Vasut48c80732011-09-25 20:00:37 +0100457
Michal Simek4fb67f42018-06-27 14:35:07 +0200458 dev = stdio_get_by_name(sdev->name);
Marek Vasut48c80732011-09-25 20:00:37 +0100459 usb_kbd_dev = (struct usb_device *)dev->priv;
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100460 data = usb_kbd_dev->privptr;
Marek Vasut48c80732011-09-25 20:00:37 +0100461
Michal Simekf8f3e0e2018-06-27 14:16:54 +0200462 while (data->usb_in_pointer == data->usb_out_pointer) {
Stefan Roese29caf932022-09-02 14:10:46 +0200463 schedule();
Marek Vasut48c80732011-09-25 20:00:37 +0100464 usb_kbd_poll_for_event(usb_kbd_dev);
Michal Simekf8f3e0e2018-06-27 14:16:54 +0200465 }
Marek Vasut48c80732011-09-25 20:00:37 +0100466
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100467 if (data->usb_out_pointer == USB_KBD_BUFFER_LEN - 1)
468 data->usb_out_pointer = 0;
wdenkaffae2b2002-08-17 09:36:01 +0000469 else
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100470 data->usb_out_pointer++;
wdenkaffae2b2002-08-17 09:36:01 +0000471
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100472 return data->usb_kbd_buffer[data->usb_out_pointer];
wdenkaffae2b2002-08-17 09:36:01 +0000473}
474
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100475/* probes the USB device dev for keyboard type. */
Simon Glass34ab37e2015-09-08 11:15:11 -0600476static int usb_kbd_probe_dev(struct usb_device *dev, unsigned int ifnum)
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100477{
478 struct usb_interface *iface;
479 struct usb_endpoint_descriptor *ep;
480 struct usb_kbd_pdata *data;
Janne Grunau63f6a442024-04-04 08:25:54 +0200481 unsigned int quirks = 0;
Stefan Brünsba0b9842021-02-20 17:26:06 +0100482 int epNum;
wdenkaffae2b2002-08-17 09:36:01 +0000483
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100484 if (dev->descriptor.bNumConfigurations != 1)
485 return 0;
486
487 iface = &dev->config.if_desc[ifnum];
488
Simon Glass2cdb58e2015-11-08 23:48:04 -0700489 if (iface->desc.bInterfaceClass != USB_CLASS_HID)
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100490 return 0;
491
Simon Glass2cdb58e2015-11-08 23:48:04 -0700492 if (iface->desc.bInterfaceSubClass != USB_SUB_HID_BOOT)
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100493 return 0;
494
Simon Glass2cdb58e2015-11-08 23:48:04 -0700495 if (iface->desc.bInterfaceProtocol != USB_PROT_HID_KEYBOARD)
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100496 return 0;
497
Stefan Brünsba0b9842021-02-20 17:26:06 +0100498 for (epNum = 0; epNum < iface->desc.bNumEndpoints; epNum++) {
499 ep = &iface->ep_desc[epNum];
500
501 /* Check if endpoint is interrupt IN endpoint */
502 if ((ep->bmAttributes & 3) != 3)
503 continue;
504
505 if (ep->bEndpointAddress & 0x80)
506 break;
507 }
508
509 if (epNum == iface->desc.bNumEndpoints)
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100510 return 0;
511
Stefan Brünsba0b9842021-02-20 17:26:06 +0100512 debug("USB KBD: found interrupt EP: 0x%x\n", ep->bEndpointAddress);
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100513
Janne Grunau63f6a442024-04-04 08:25:54 +0200514 switch (dev->descriptor.idVendor) {
515 case USB_VENDOR_ID_APPLE:
516 case USB_VENDOR_ID_KEYCHRON:
517 quirks |= USB_HID_QUIRK_POLL_NO_REPORT_IDLE;
518 break;
519 default:
520 break;
521 }
522
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100523 data = malloc(sizeof(struct usb_kbd_pdata));
524 if (!data) {
525 printf("USB KBD: Error allocating private data\n");
526 return 0;
527 }
528
529 /* Clear private data */
530 memset(data, 0, sizeof(struct usb_kbd_pdata));
531
Allen Martind7475382012-10-24 08:32:04 +0000532 /* allocate input buffer aligned and sized to USB DMA alignment */
Adrian Cox08a98b82014-04-10 14:02:44 +0100533 data->new = memalign(USB_DMA_MINALIGN,
534 roundup(USB_KBD_BOOT_REPORT_SIZE, USB_DMA_MINALIGN));
Allen Martind7475382012-10-24 08:32:04 +0000535
Janne Grunau575c6822024-04-04 08:25:53 +0200536 data->ifnum = ifnum;
537
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100538 /* Insert private data into USB device structure */
539 dev->privptr = data;
540
541 /* Set IRQ handler */
542 dev->irq_handle = usb_kbd_irq;
543
Hans de Goede8f8d7d22014-09-24 14:06:10 +0200544 data->intpipe = usb_rcvintpipe(dev, ep->bEndpointAddress);
545 data->intpktsize = min(usb_maxpacket(dev, data->intpipe),
546 USB_KBD_BOOT_REPORT_SIZE);
547 data->intinterval = ep->bInterval;
Hans de Goede8454c842015-05-19 22:51:03 +0200548 data->last_report = -1;
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100549
550 /* We found a USB Keyboard, install it. */
Stefan Brünsba0b9842021-02-20 17:26:06 +0100551 debug("USB KBD: set boot protocol\n");
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100552 usb_set_protocol(dev, iface->desc.bInterfaceNumber, 0);
553
Hans de Goede8454c842015-05-19 22:51:03 +0200554#if !defined(CONFIG_SYS_USB_EVENT_POLL_VIA_CONTROL_EP) && \
555 !defined(CONFIG_SYS_USB_EVENT_POLL_VIA_INT_QUEUE)
Stefan Brünsba0b9842021-02-20 17:26:06 +0100556 debug("USB KBD: set idle interval...\n");
Hans de Goede8454c842015-05-19 22:51:03 +0200557 usb_set_idle(dev, iface->desc.bInterfaceNumber, REPEAT_RATE / 4, 0);
Hans de Goedede451492015-06-18 22:34:34 +0200558#else
Stefan Brünsba0b9842021-02-20 17:26:06 +0100559 debug("USB KBD: set idle interval=0...\n");
Hans de Goedede451492015-06-18 22:34:34 +0200560 usb_set_idle(dev, iface->desc.bInterfaceNumber, 0, 0);
Hans de Goede8454c842015-05-19 22:51:03 +0200561#endif
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100562
Janne Grunau63f6a442024-04-04 08:25:54 +0200563 /*
564 * Apple and Keychron keyboards do not report the device state. Reports
565 * are only returned during key presses.
566 */
567 if (quirks & USB_HID_QUIRK_POLL_NO_REPORT_IDLE) {
568 debug("USB KBD: quirk: skip testing device state\n");
569 return 1;
570 }
Vivek Gautamceb49722013-04-12 16:34:33 +0530571 debug("USB KBD: enable interrupt pipe...\n");
Hans de Goede8e553112014-09-24 14:06:11 +0200572#ifdef CONFIG_SYS_USB_EVENT_POLL_VIA_INT_QUEUE
573 data->intq = create_int_queue(dev, data->intpipe, 1,
Hans de Goede8bb6c1d2015-01-11 20:38:28 +0100574 USB_KBD_BOOT_REPORT_SIZE, data->new,
575 data->intinterval);
Hans de Goede8e553112014-09-24 14:06:11 +0200576 if (!data->intq) {
Stephen Warrene4b70d82015-11-13 13:34:09 -0700577#elif defined(CONFIG_SYS_USB_EVENT_POLL_VIA_CONTROL_EP)
578 if (usb_get_report(dev, iface->desc.bInterfaceNumber,
579 1, 0, data->new, USB_KBD_BOOT_REPORT_SIZE) < 0) {
Hans de Goede8e553112014-09-24 14:06:11 +0200580#else
Michal Suchanekfdd135b2019-08-18 10:55:25 +0200581 if (usb_int_msg(dev, data->intpipe, data->new, data->intpktsize,
Michal Suchanek34371212019-08-18 10:55:27 +0200582 data->intinterval, false) < 0) {
Hans de Goede8e553112014-09-24 14:06:11 +0200583#endif
Vincent Palatin5da2dc92013-05-10 19:48:59 -0700584 printf("Failed to get keyboard state from device %04x:%04x\n",
585 dev->descriptor.idVendor, dev->descriptor.idProduct);
586 /* Abort, we don't want to use that non-functional keyboard. */
587 return 0;
588 }
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100589
590 /* Success. */
591 return 1;
592}
593
Simon Glass603afaf2015-03-25 12:22:33 -0600594static int probe_usb_keyboard(struct usb_device *dev)
595{
596 char *stdinname;
597 struct stdio_dev usb_kbd_dev;
Janne Grunau575c6822024-04-04 08:25:53 +0200598 unsigned int ifnum;
599 unsigned int max_ifnum = min((unsigned int)USB_MAX_ACTIVE_INTERFACES,
600 (unsigned int)dev->config.no_of_if);
Simon Glass603afaf2015-03-25 12:22:33 -0600601 int error;
602
603 /* Try probing the keyboard */
Janne Grunau575c6822024-04-04 08:25:53 +0200604 for (ifnum = 0; ifnum < max_ifnum; ifnum++) {
605 if (usb_kbd_probe_dev(dev, ifnum) == 1)
606 break;
607 }
608 if (ifnum >= max_ifnum)
Simon Glass603afaf2015-03-25 12:22:33 -0600609 return -ENOENT;
610
611 /* Register the keyboard */
612 debug("USB KBD: register.\n");
613 memset(&usb_kbd_dev, 0, sizeof(struct stdio_dev));
614 strcpy(usb_kbd_dev.name, DEVNAME);
Bin Meng1caf9342015-11-03 23:23:37 -0800615 usb_kbd_dev.flags = DEV_FLAGS_INPUT;
Simon Glass603afaf2015-03-25 12:22:33 -0600616 usb_kbd_dev.getc = usb_kbd_getc;
617 usb_kbd_dev.tstc = usb_kbd_testc;
618 usb_kbd_dev.priv = (void *)dev;
619 error = stdio_register(&usb_kbd_dev);
620 if (error)
621 return error;
622
Simon Glass00caae62017-08-03 12:22:12 -0600623 stdinname = env_get("stdin");
Simon Glassb0265422017-01-16 07:03:26 -0700624#if CONFIG_IS_ENABLED(CONSOLE_MUX)
Kory Maincent98ac7852022-06-22 10:59:31 +0200625 if (strstr(stdinname, DEVNAME) != NULL) {
626 error = iomux_doenv(stdin, stdinname);
627 if (error)
628 return error;
629 }
Simon Glass603afaf2015-03-25 12:22:33 -0600630#else
631 /* Check if this is the standard input device. */
Kory Maincent98ac7852022-06-22 10:59:31 +0200632 if (!strcmp(stdinname, DEVNAME)) {
633 /* Reassign the console */
634 if (overwrite_console())
635 return 1;
Simon Glass603afaf2015-03-25 12:22:33 -0600636
Kory Maincent98ac7852022-06-22 10:59:31 +0200637 error = console_assign(stdin, DEVNAME);
638 if (error)
639 return error;
640 }
Simon Glass603afaf2015-03-25 12:22:33 -0600641#endif
642
643 return 0;
644}
645
Sven Schwermerfd09c202018-11-21 08:43:56 +0100646#if !CONFIG_IS_ENABLED(DM_USB)
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100647/* Search for keyboard and register it if found. */
wdenkaffae2b2002-08-17 09:36:01 +0000648int drv_usb_kbd_init(void)
649{
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100650 int error, i;
wdenkaffae2b2002-08-17 09:36:01 +0000651
Simon Glass697033c2015-03-25 12:22:34 -0600652 debug("%s: Probing for keyboard\n", __func__);
Simon Glass697033c2015-03-25 12:22:34 -0600653 /* Scan all USB Devices */
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100654 for (i = 0; i < USB_MAX_DEVICE; i++) {
Simon Glass603afaf2015-03-25 12:22:33 -0600655 struct usb_device *dev;
656
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100657 /* Get USB device. */
658 dev = usb_get_dev_index(i);
659 if (!dev)
Simon Glass603afaf2015-03-25 12:22:33 -0600660 break;
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100661
662 if (dev->devnum == -1)
663 continue;
664
Simon Glass603afaf2015-03-25 12:22:33 -0600665 error = probe_usb_keyboard(dev);
666 if (!error)
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100667 return 1;
Simon Glass603afaf2015-03-25 12:22:33 -0600668 if (error && error != -ENOENT)
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100669 return error;
wdenkaffae2b2002-08-17 09:36:01 +0000670 }
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100671
672 /* No USB Keyboard found */
wdenkaffae2b2002-08-17 09:36:01 +0000673 return -1;
674}
675
Marek Vasut9a8c72a2011-10-10 16:34:26 +0100676/* Deregister the keyboard. */
Hans de Goede8a8a2252014-09-20 16:54:38 +0200677int usb_kbd_deregister(int force)
wdenkaffae2b2002-08-17 09:36:01 +0000678{
Simon Glass869588d2016-10-17 20:13:02 -0600679#if CONFIG_IS_ENABLED(SYS_STDIO_DEREGISTER)
Hans de Goededfe5b1c2014-09-24 14:06:08 +0200680 struct stdio_dev *dev;
681 struct usb_device *usb_kbd_dev;
682 struct usb_kbd_pdata *data;
683
684 dev = stdio_get_by_name(DEVNAME);
685 if (dev) {
686 usb_kbd_dev = (struct usb_device *)dev->priv;
687 data = usb_kbd_dev->privptr;
Simon Glassb0265422017-01-16 07:03:26 -0700688#if CONFIG_IS_ENABLED(CONSOLE_MUX)
Andy Shevchenkoeb5fd9e2021-02-11 17:09:44 +0200689 if (iomux_replace_device(stdin, DEVNAME, force ? "nulldev" : ""))
Hans de Goede3cbcb282015-01-11 20:34:44 +0100690 return 1;
691#endif
Andy Shevchenkoeb5fd9e2021-02-11 17:09:44 +0200692 if (stdio_deregister_dev(dev, force) != 0)
693 return 1;
Hans de Goede8e553112014-09-24 14:06:11 +0200694#ifdef CONFIG_SYS_USB_EVENT_POLL_VIA_INT_QUEUE
695 destroy_int_queue(usb_kbd_dev, data->intq);
696#endif
Hans de Goededfe5b1c2014-09-24 14:06:08 +0200697 free(data->new);
698 free(data);
699 }
Hans de Goede0ea09df2014-09-20 16:54:34 +0200700
701 return 0;
Jean-Christophe PLAGNIOL-VILLARDfea91ed2008-12-02 21:58:04 +0100702#else
703 return 1;
704#endif
wdenkaffae2b2002-08-17 09:36:01 +0000705}
Simon Glass34ab37e2015-09-08 11:15:11 -0600706
Hans de Goede9a80e712016-04-03 09:18:53 +0200707#endif
708
Sven Schwermerfd09c202018-11-21 08:43:56 +0100709#if CONFIG_IS_ENABLED(DM_USB)
Simon Glass34ab37e2015-09-08 11:15:11 -0600710
711static int usb_kbd_probe(struct udevice *dev)
712{
713 struct usb_device *udev = dev_get_parent_priv(dev);
Simon Glass34ab37e2015-09-08 11:15:11 -0600714
Masahiro Yamada8319aeb2016-09-06 22:17:35 +0900715 return probe_usb_keyboard(udev);
Simon Glass34ab37e2015-09-08 11:15:11 -0600716}
717
Simon Glass8a834872016-01-03 13:50:31 -0700718static int usb_kbd_remove(struct udevice *dev)
719{
720 struct usb_device *udev = dev_get_parent_priv(dev);
721 struct usb_kbd_pdata *data;
722 struct stdio_dev *sdev;
723 int ret;
724
725 sdev = stdio_get_by_name(DEVNAME);
726 if (!sdev) {
727 ret = -ENXIO;
728 goto err;
729 }
730 data = udev->privptr;
Simon Glassb0265422017-01-16 07:03:26 -0700731#if CONFIG_IS_ENABLED(CONSOLE_MUX)
Andy Shevchenkoeb5fd9e2021-02-11 17:09:44 +0200732 if (iomux_replace_device(stdin, DEVNAME, "nulldev")) {
Simon Glass8a834872016-01-03 13:50:31 -0700733 ret = -ENOLINK;
734 goto err;
735 }
736#endif
Andy Shevchenkoeb5fd9e2021-02-11 17:09:44 +0200737 if (stdio_deregister_dev(sdev, true)) {
738 ret = -EPERM;
739 goto err;
740 }
Simon Glass8a834872016-01-03 13:50:31 -0700741#ifdef CONFIG_SYS_USB_EVENT_POLL_VIA_INT_QUEUE
742 destroy_int_queue(udev, data->intq);
743#endif
744 free(data->new);
745 free(data);
746
747 return 0;
748err:
749 printf("%s: warning, ret=%d", __func__, ret);
750 return ret;
751}
752
Simon Glass34ab37e2015-09-08 11:15:11 -0600753static const struct udevice_id usb_kbd_ids[] = {
754 { .compatible = "usb-keyboard" },
755 { }
756};
757
758U_BOOT_DRIVER(usb_kbd) = {
759 .name = "usb_kbd",
760 .id = UCLASS_KEYBOARD,
761 .of_match = usb_kbd_ids,
762 .probe = usb_kbd_probe,
Simon Glass8a834872016-01-03 13:50:31 -0700763 .remove = usb_kbd_remove,
Simon Glass34ab37e2015-09-08 11:15:11 -0600764};
765
Simon Glass34ab37e2015-09-08 11:15:11 -0600766static const struct usb_device_id kbd_id_table[] = {
767 {
768 .match_flags = USB_DEVICE_ID_MATCH_INT_CLASS |
769 USB_DEVICE_ID_MATCH_INT_SUBCLASS |
770 USB_DEVICE_ID_MATCH_INT_PROTOCOL,
771 .bInterfaceClass = USB_CLASS_HID,
Simon Glass2cdb58e2015-11-08 23:48:04 -0700772 .bInterfaceSubClass = USB_SUB_HID_BOOT,
773 .bInterfaceProtocol = USB_PROT_HID_KEYBOARD,
Simon Glass34ab37e2015-09-08 11:15:11 -0600774 },
Janne Grunau575c6822024-04-04 08:25:53 +0200775 {
776 USB_DEVICE(USB_VENDOR_ID_APPLE,
777 USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_2021),
778 },
779 {
780 USB_DEVICE(USB_VENDOR_ID_APPLE,
781 USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_FINGERPRINT_2021),
782 },
783 {
784 USB_DEVICE(USB_VENDOR_ID_APPLE,
785 USB_DEVICE_ID_APPLE_MAGIC_KEYBOARD_NUMPAD_2021),
786 },
Simon Glass34ab37e2015-09-08 11:15:11 -0600787 { } /* Terminating entry */
788};
789
790U_BOOT_USB_DEVICE(usb_kbd, kbd_id_table);
791
792#endif