1 // SPDX-License-Identifier: GPL-2.0-or-later
3 * Copyright (c) 1999-2001 Vojtech Pavlik
5 * USB HIDBP Keyboard support
10 * Should you need to contact me, the author, you can do so either by
11 * e-mail - mail your message to <vojtech@ucw.cz>, or by paper mail:
12 * Vojtech Pavlik, Simunkova 1594, Prague 8, 182 00 Czech Republic
15 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
17 #include <linux/kernel.h>
18 #include <linux/slab.h>
19 #include <linux/module.h>
20 #include <linux/init.h>
21 #include <linux/usb/input.h>
22 #include <linux/hid.h>
27 #define DRIVER_VERSION ""
28 #define DRIVER_AUTHOR "Vojtech Pavlik <vojtech@ucw.cz>"
29 #define DRIVER_DESC "USB HID Boot Protocol keyboard driver"
31 MODULE_AUTHOR(DRIVER_AUTHOR
);
32 MODULE_DESCRIPTION(DRIVER_DESC
);
33 MODULE_LICENSE("GPL");
35 static const unsigned char usb_kbd_keycode
[256] = {
36 0, 0, 0, 0, 30, 48, 46, 32, 18, 33, 34, 35, 23, 36, 37, 38,
37 50, 49, 24, 25, 16, 19, 31, 20, 22, 47, 17, 45, 21, 44, 2, 3,
38 4, 5, 6, 7, 8, 9, 10, 11, 28, 1, 14, 15, 57, 12, 13, 26,
39 27, 43, 43, 39, 40, 41, 51, 52, 53, 58, 59, 60, 61, 62, 63, 64,
40 65, 66, 67, 68, 87, 88, 99, 70,119,110,102,104,111,107,109,106,
41 105,108,103, 69, 98, 55, 74, 78, 96, 79, 80, 81, 75, 76, 77, 71,
42 72, 73, 82, 83, 86,127,116,117,183,184,185,186,187,188,189,190,
43 191,192,193,194,134,138,130,132,128,129,131,137,133,135,136,113,
44 115,114, 0, 0, 0,121, 0, 89, 93,124, 92, 94, 95, 0, 0, 0,
45 122,123, 90, 91, 85, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
46 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
47 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
48 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
49 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
50 29, 42, 56,125, 97, 54,100,126,164,166,165,163,161,115,114,113,
51 150,158,159,128,136,177,178,176,142,152,173,140
56 * struct usb_kbd - state of each attached keyboard
57 * @dev: input device associated with this keyboard
58 * @usbdev: usb device associated with this keyboard
59 * @old: data received in the past from the @irq URB representing which
60 * keys were pressed. By comparing with the current list of keys
61 * that are pressed, we are able to see key releases.
62 * @irq: URB for receiving a list of keys that are pressed when a
63 * new key is pressed or a key that was pressed is released.
64 * @led: URB for sending LEDs (e.g. numlock, ...)
65 * @newleds: data that will be sent with the @led URB representing which LEDs
67 * @name: Name of the keyboard. @dev's name field points to this buffer
68 * @phys: Physical path of the keyboard. @dev's phys field points to this
70 * @new: Buffer for the @irq URB
71 * @cr: Control request for @led URB
72 * @leds: Buffer for the @led URB
73 * @new_dma: DMA address for @irq URB
74 * @leds_dma: DMA address for @led URB
75 * @leds_lock: spinlock that protects @leds, @newleds, and @led_urb_submitted
76 * @led_urb_submitted: indicates whether @led is in progress, i.e. it has been
77 * submitted and its completion handler has not returned yet
78 * without resubmitting @led
81 struct input_dev
*dev
;
82 struct usb_device
*usbdev
;
84 struct urb
*irq
, *led
;
85 unsigned char newleds
;
90 struct usb_ctrlrequest
*cr
;
96 bool led_urb_submitted
;
100 static void usb_kbd_irq(struct urb
*urb
)
102 struct usb_kbd
*kbd
= urb
->context
;
105 switch (urb
->status
) {
106 case 0: /* success */
108 case -ECONNRESET
: /* unlink */
112 /* -EPIPE: should clear the halt */
117 for (i
= 0; i
< 8; i
++)
118 input_report_key(kbd
->dev
, usb_kbd_keycode
[i
+ 224], (kbd
->new[0] >> i
) & 1);
120 for (i
= 2; i
< 8; i
++) {
122 if (kbd
->old
[i
] > 3 && memscan(kbd
->new + 2, kbd
->old
[i
], 6) == kbd
->new + 8) {
123 if (usb_kbd_keycode
[kbd
->old
[i
]])
124 input_report_key(kbd
->dev
, usb_kbd_keycode
[kbd
->old
[i
]], 0);
127 "Unknown key (scancode %#x) released.\n",
131 if (kbd
->new[i
] > 3 && memscan(kbd
->old
+ 2, kbd
->new[i
], 6) == kbd
->old
+ 8) {
132 if (usb_kbd_keycode
[kbd
->new[i
]])
133 input_report_key(kbd
->dev
, usb_kbd_keycode
[kbd
->new[i
]], 1);
136 "Unknown key (scancode %#x) pressed.\n",
141 input_sync(kbd
->dev
);
143 memcpy(kbd
->old
, kbd
->new, 8);
146 i
= usb_submit_urb (urb
, GFP_ATOMIC
);
148 hid_err(urb
->dev
, "can't resubmit intr, %s-%s/input0, status %d",
149 kbd
->usbdev
->bus
->bus_name
,
150 kbd
->usbdev
->devpath
, i
);
153 static int usb_kbd_event(struct input_dev
*dev
, unsigned int type
,
154 unsigned int code
, int value
)
157 struct usb_kbd
*kbd
= input_get_drvdata(dev
);
162 spin_lock_irqsave(&kbd
->leds_lock
, flags
);
163 kbd
->newleds
= (!!test_bit(LED_KANA
, dev
->led
) << 3) | (!!test_bit(LED_COMPOSE
, dev
->led
) << 3) |
164 (!!test_bit(LED_SCROLLL
, dev
->led
) << 2) | (!!test_bit(LED_CAPSL
, dev
->led
) << 1) |
165 (!!test_bit(LED_NUML
, dev
->led
));
167 if (kbd
->led_urb_submitted
){
168 spin_unlock_irqrestore(&kbd
->leds_lock
, flags
);
172 if (*(kbd
->leds
) == kbd
->newleds
){
173 spin_unlock_irqrestore(&kbd
->leds_lock
, flags
);
177 *(kbd
->leds
) = kbd
->newleds
;
179 kbd
->led
->dev
= kbd
->usbdev
;
180 if (usb_submit_urb(kbd
->led
, GFP_ATOMIC
))
181 pr_err("usb_submit_urb(leds) failed\n");
183 kbd
->led_urb_submitted
= true;
185 spin_unlock_irqrestore(&kbd
->leds_lock
, flags
);
190 static void usb_kbd_led(struct urb
*urb
)
193 struct usb_kbd
*kbd
= urb
->context
;
196 hid_warn(urb
->dev
, "led urb status %d received\n",
199 spin_lock_irqsave(&kbd
->leds_lock
, flags
);
201 if (*(kbd
->leds
) == kbd
->newleds
){
202 kbd
->led_urb_submitted
= false;
203 spin_unlock_irqrestore(&kbd
->leds_lock
, flags
);
207 *(kbd
->leds
) = kbd
->newleds
;
209 kbd
->led
->dev
= kbd
->usbdev
;
210 if (usb_submit_urb(kbd
->led
, GFP_ATOMIC
)){
211 hid_err(urb
->dev
, "usb_submit_urb(leds) failed\n");
212 kbd
->led_urb_submitted
= false;
214 spin_unlock_irqrestore(&kbd
->leds_lock
, flags
);
218 static int usb_kbd_open(struct input_dev
*dev
)
220 struct usb_kbd
*kbd
= input_get_drvdata(dev
);
222 kbd
->irq
->dev
= kbd
->usbdev
;
223 if (usb_submit_urb(kbd
->irq
, GFP_KERNEL
))
229 static void usb_kbd_close(struct input_dev
*dev
)
231 struct usb_kbd
*kbd
= input_get_drvdata(dev
);
233 usb_kill_urb(kbd
->irq
);
236 static int usb_kbd_alloc_mem(struct usb_device
*dev
, struct usb_kbd
*kbd
)
238 if (!(kbd
->irq
= usb_alloc_urb(0, GFP_KERNEL
)))
240 if (!(kbd
->led
= usb_alloc_urb(0, GFP_KERNEL
)))
242 if (!(kbd
->new = usb_alloc_coherent(dev
, 8, GFP_ATOMIC
, &kbd
->new_dma
)))
244 if (!(kbd
->cr
= kmalloc(sizeof(struct usb_ctrlrequest
), GFP_KERNEL
)))
246 if (!(kbd
->leds
= usb_alloc_coherent(dev
, 1, GFP_ATOMIC
, &kbd
->leds_dma
)))
252 static void usb_kbd_free_mem(struct usb_device
*dev
, struct usb_kbd
*kbd
)
254 usb_free_urb(kbd
->irq
);
255 usb_free_urb(kbd
->led
);
256 usb_free_coherent(dev
, 8, kbd
->new, kbd
->new_dma
);
258 usb_free_coherent(dev
, 1, kbd
->leds
, kbd
->leds_dma
);
261 static int usb_kbd_probe(struct usb_interface
*iface
,
262 const struct usb_device_id
*id
)
264 struct usb_device
*dev
= interface_to_usbdev(iface
);
265 struct usb_host_interface
*interface
;
266 struct usb_endpoint_descriptor
*endpoint
;
268 struct input_dev
*input_dev
;
272 interface
= iface
->cur_altsetting
;
274 if (interface
->desc
.bNumEndpoints
!= 1)
277 endpoint
= &interface
->endpoint
[0].desc
;
278 if (!usb_endpoint_is_int_in(endpoint
))
281 pipe
= usb_rcvintpipe(dev
, endpoint
->bEndpointAddress
);
282 maxp
= usb_maxpacket(dev
, pipe
, usb_pipeout(pipe
));
284 kbd
= kzalloc(sizeof(struct usb_kbd
), GFP_KERNEL
);
285 input_dev
= input_allocate_device();
286 if (!kbd
|| !input_dev
)
289 if (usb_kbd_alloc_mem(dev
, kbd
))
293 kbd
->dev
= input_dev
;
294 spin_lock_init(&kbd
->leds_lock
);
296 if (dev
->manufacturer
)
297 strlcpy(kbd
->name
, dev
->manufacturer
, sizeof(kbd
->name
));
300 if (dev
->manufacturer
)
301 strlcat(kbd
->name
, " ", sizeof(kbd
->name
));
302 strlcat(kbd
->name
, dev
->product
, sizeof(kbd
->name
));
305 if (!strlen(kbd
->name
))
306 snprintf(kbd
->name
, sizeof(kbd
->name
),
307 "USB HIDBP Keyboard %04x:%04x",
308 le16_to_cpu(dev
->descriptor
.idVendor
),
309 le16_to_cpu(dev
->descriptor
.idProduct
));
311 usb_make_path(dev
, kbd
->phys
, sizeof(kbd
->phys
));
312 strlcat(kbd
->phys
, "/input0", sizeof(kbd
->phys
));
314 input_dev
->name
= kbd
->name
;
315 input_dev
->phys
= kbd
->phys
;
316 usb_to_input_id(dev
, &input_dev
->id
);
317 input_dev
->dev
.parent
= &iface
->dev
;
319 input_set_drvdata(input_dev
, kbd
);
321 input_dev
->evbit
[0] = BIT_MASK(EV_KEY
) | BIT_MASK(EV_LED
) |
323 input_dev
->ledbit
[0] = BIT_MASK(LED_NUML
) | BIT_MASK(LED_CAPSL
) |
324 BIT_MASK(LED_SCROLLL
) | BIT_MASK(LED_COMPOSE
) |
327 for (i
= 0; i
< 255; i
++)
328 set_bit(usb_kbd_keycode
[i
], input_dev
->keybit
);
329 clear_bit(0, input_dev
->keybit
);
331 input_dev
->event
= usb_kbd_event
;
332 input_dev
->open
= usb_kbd_open
;
333 input_dev
->close
= usb_kbd_close
;
335 usb_fill_int_urb(kbd
->irq
, dev
, pipe
,
336 kbd
->new, (maxp
> 8 ? 8 : maxp
),
337 usb_kbd_irq
, kbd
, endpoint
->bInterval
);
338 kbd
->irq
->transfer_dma
= kbd
->new_dma
;
339 kbd
->irq
->transfer_flags
|= URB_NO_TRANSFER_DMA_MAP
;
341 kbd
->cr
->bRequestType
= USB_TYPE_CLASS
| USB_RECIP_INTERFACE
;
342 kbd
->cr
->bRequest
= 0x09;
343 kbd
->cr
->wValue
= cpu_to_le16(0x200);
344 kbd
->cr
->wIndex
= cpu_to_le16(interface
->desc
.bInterfaceNumber
);
345 kbd
->cr
->wLength
= cpu_to_le16(1);
347 usb_fill_control_urb(kbd
->led
, dev
, usb_sndctrlpipe(dev
, 0),
348 (void *) kbd
->cr
, kbd
->leds
, 1,
350 kbd
->led
->transfer_dma
= kbd
->leds_dma
;
351 kbd
->led
->transfer_flags
|= URB_NO_TRANSFER_DMA_MAP
;
353 error
= input_register_device(kbd
->dev
);
357 usb_set_intfdata(iface
, kbd
);
358 device_set_wakeup_enable(&dev
->dev
, 1);
362 usb_kbd_free_mem(dev
, kbd
);
364 input_free_device(input_dev
);
369 static void usb_kbd_disconnect(struct usb_interface
*intf
)
371 struct usb_kbd
*kbd
= usb_get_intfdata (intf
);
373 usb_set_intfdata(intf
, NULL
);
375 usb_kill_urb(kbd
->irq
);
376 input_unregister_device(kbd
->dev
);
377 usb_kill_urb(kbd
->led
);
378 usb_kbd_free_mem(interface_to_usbdev(intf
), kbd
);
383 static const struct usb_device_id usb_kbd_id_table
[] = {
384 { USB_INTERFACE_INFO(USB_INTERFACE_CLASS_HID
, USB_INTERFACE_SUBCLASS_BOOT
,
385 USB_INTERFACE_PROTOCOL_KEYBOARD
) },
386 { } /* Terminating entry */
389 MODULE_DEVICE_TABLE (usb
, usb_kbd_id_table
);
391 static struct usb_driver usb_kbd_driver
= {
393 .probe
= usb_kbd_probe
,
394 .disconnect
= usb_kbd_disconnect
,
395 .id_table
= usb_kbd_id_table
,
398 module_usb_driver(usb_kbd_driver
);