3 * Denis Peter, MPL AG Switzerland
5 * Part of this source has been derived from the Linux USB
8 * See file CREDITS for list of people who contributed to this
11 * This program is free software; you can redistribute it and/or
12 * modify it under the terms of the GNU General Public License as
13 * published by the Free Software Foundation; either version 2 of
14 * the License, or (at your option) any later version.
16 * This program is distributed in the hope that it will be useful,
17 * but WITHOUT ANY WARRANTY; without even the implied warranty of
18 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 * GNU General Public License for more details.
21 * You should have received a copy of the GNU General Public License
22 * along with this program; if not, write to the Free Software
23 * Foundation, Inc., 59 Temple Place, Suite 330, Boston,
30 #ifdef CONFIG_USB_KEYBOARD
36 * if overwrite_console returns 1, the stdin, stderr and stdout
37 * are switched to the serial port, else the settings in the
38 * environment are used
40 #ifdef CFG_CONSOLE_OVERWRITE_ROUTINE
41 extern int overwrite_console (void);
43 int overwrite_console (void)
50 #define USB_KBD_PRINTF(fmt,args...) printf (fmt ,##args)
52 #define USB_KBD_PRINTF(fmt,args...)
56 #define REPEAT_RATE 40/4 /* 40msec -> 25cps */
57 #define REPEAT_DELAY 10 /* 10 x REAPEAT_RATE = 400msec */
60 #define CAPS_LOCK 0x39
61 #define SCROLL_LOCK 0x47
74 #define USB_KBD_BUFFER_LEN 0x20 /* size of the keyboardbuffer */
76 static volatile char usb_kbd_buffer
[USB_KBD_BUFFER_LEN
];
77 static volatile int usb_in_pointer
= 0;
78 static volatile int usb_out_pointer
= 0;
83 #define DEVNAME "usbkbd"
84 static unsigned char num_lock
= 0;
85 static unsigned char caps_lock
= 0;
86 static unsigned char scroll_lock
= 0;
88 static unsigned char leds
__attribute__ ((aligned (0x4)));
90 static unsigned char usb_kbd_numkey
[] = {
91 '1', '2', '3', '4', '5', '6', '7', '8', '9', '0','\r',0x1b,'\b','\t',' ', '-',
92 '=', '[', ']','\\', '#', ';', '\'', '`', ',', '.', '/'
94 static unsigned char usb_kbd_numkey_shifted
[] = {
95 '!', '@', '#', '$', '%', '^', '&', '*', '(', ')','\r',0x1b,'\b','\t',' ', '_',
96 '+', '{', '}', '|', '~', ':', '"', '~', '<', '>', '?'
99 /******************************************************************
101 ******************************************************************/
102 /* puts character in the queue and sets up the in and out pointer */
103 static void usb_kbd_put_queue(char data
)
105 if((usb_in_pointer
+1)==USB_KBD_BUFFER_LEN
) {
106 if(usb_out_pointer
==0) {
107 return; /* buffer full */
112 if((usb_in_pointer
+1)==usb_out_pointer
)
113 return; /* buffer full */
116 usb_kbd_buffer
[usb_in_pointer
]=data
;
120 /* test if a character is in the queue */
121 static int usb_kbd_testc(void)
123 if(usb_in_pointer
==usb_out_pointer
)
124 return(0); /* no data */
128 /* gets the character from the queue */
129 static int usb_kbd_getc(void)
132 while(usb_in_pointer
==usb_out_pointer
);
133 if((usb_out_pointer
+1)==USB_KBD_BUFFER_LEN
)
137 c
=usb_kbd_buffer
[usb_out_pointer
];
142 /* forward decleration */
143 static int usb_kbd_probe(struct usb_device
*dev
, unsigned int ifnum
);
145 /* search for keyboard and register it if found */
146 int drv_usb_kbd_init(void)
149 device_t usb_kbd_dev
,*old_dev
;
150 struct usb_device
*dev
;
151 char *stdinname
= getenv ("stdin");
155 /* scan all USB Devices */
156 for(i
=0;i
<USB_MAX_DEVICE
;i
++) {
157 dev
=usb_get_dev_index(i
); /* get device */
158 if(dev
->devnum
!=-1) {
159 if(usb_kbd_probe(dev
,0)==1) { /* Ok, we found a keyboard */
160 /* check, if it is already registered */
161 USB_KBD_PRINTF("USB KBD found set up device.\n");
162 for (index
=1; index
<=ListNumItems(devlist
); index
++) {
163 old_dev
= ListGetPtrToItem(devlist
, index
);
164 if(strcmp(old_dev
->name
,DEVNAME
)==0) {
165 /* ok, already registered, just return ok */
166 USB_KBD_PRINTF("USB KBD is already registered.\n");
170 /* register the keyboard */
171 USB_KBD_PRINTF("USB KBD register.\n");
172 memset (&usb_kbd_dev
, 0, sizeof(device_t
));
173 strcpy(usb_kbd_dev
.name
, DEVNAME
);
174 usb_kbd_dev
.flags
= DEV_FLAGS_INPUT
| DEV_FLAGS_SYSTEM
;
175 usb_kbd_dev
.putc
= NULL
;
176 usb_kbd_dev
.puts
= NULL
;
177 usb_kbd_dev
.getc
= usb_kbd_getc
;
178 usb_kbd_dev
.tstc
= usb_kbd_testc
;
179 error
= device_register (&usb_kbd_dev
);
181 /* check if this is the standard input device */
182 if(strcmp(stdinname
,DEVNAME
)==0) {
183 /* reassign the console */
184 if(overwrite_console()) {
187 error
=console_assign(stdin
,DEVNAME
);
199 /* no USB Keyboard found */
204 /* deregistering the keyboard */
205 int usb_kbd_deregister(void)
207 return device_deregister(DEVNAME
);
210 /**************************************************************************
214 /* set the LEDs. Since this is used in the irq routine, the control job
215 is issued with a timeout of 0. This means, that the job is queued without
216 waiting for job completion */
218 static void usb_kbd_setled(struct usb_device
*dev
)
220 struct usb_interface_descriptor
*iface
;
221 iface
= &dev
->config
.if_desc
[0];
231 usb_control_msg(dev
, usb_sndctrlpipe(dev
, 0),
232 USB_REQ_SET_REPORT
, USB_TYPE_CLASS
| USB_RECIP_INTERFACE
,
233 0x200, iface
->bInterfaceNumber
,(void *)&leds
, 1, 0);
238 #define CAPITAL_MASK 0x20
239 /* Translate the scancode in ASCII */
240 static int usb_kbd_translate(unsigned char scancode
,unsigned char modifier
,int pressed
)
242 unsigned char keycode
;
251 if(repeat_delay
<REPEAT_DELAY
)
253 repeat_delay
=REPEAT_DELAY
;
256 if((scancode
>3) && (scancode
<0x1d)) { /* alpha numeric values */
257 keycode
=scancode
-4 + 0x61;
259 keycode
&=~CAPITAL_MASK
; /* switch to capital Letters */
260 if(((modifier
&(1<<LEFT_SHIFT
))!=0)||((modifier
&(1<<RIGHT_SHIFT
))!=0)) {
261 if(keycode
& CAPITAL_MASK
)
262 keycode
&=~CAPITAL_MASK
; /* switch to capital Letters */
264 keycode
|=CAPITAL_MASK
; /* switch to non capital Letters */
267 if((scancode
>0x1d) && (scancode
<0x3A)) {
268 if(((modifier
&(1<<LEFT_SHIFT
))!=0)||((modifier
&(1<<RIGHT_SHIFT
))!=0)) /* shifted */
269 keycode
=usb_kbd_numkey_shifted
[scancode
-0x1e];
270 else /* non shifted */
271 keycode
=usb_kbd_numkey
[scancode
-0x1e];
274 if(scancode
==NUM_LOCK
) {
278 if(scancode
==CAPS_LOCK
) {
279 caps_lock
=~caps_lock
;
282 if(scancode
==SCROLL_LOCK
) {
283 scroll_lock
=~scroll_lock
;
288 USB_KBD_PRINTF("%c",keycode
);
289 usb_kbd_put_queue(keycode
);
294 /* Interrupt service routine */
295 static int usb_kbd_irq(struct usb_device
*dev
)
299 if((dev
->irq_status
!=0)||(dev
->irq_act_len
!=8))
301 USB_KBD_PRINTF("usb_keyboard Error %lX, len %d\n",dev
->irq_status
,dev
->irq_act_len
);
305 for (i
= 2; i
< 8; i
++) {
306 if (old
[i
] > 3 && memscan(&new[2], old
[i
], 6) == &new[8]) {
307 res
|=usb_kbd_translate(old
[i
],new[0],0);
309 if (new[i
] > 3 && memscan(&old
[2], new[i
], 6) == &old
[8]) {
310 res
|=usb_kbd_translate(new[i
],new[0],1);
313 if((new[2]>3) && (old
[2]==new[2])) /* still pressed */
314 res
|=usb_kbd_translate(new[2],new[0],2);
317 memcpy(&old
[0],&new[0], 8);
318 return 1; /* install IRQ Handler again */
321 /* probes the USB device dev for keyboard type */
322 static int usb_kbd_probe(struct usb_device
*dev
, unsigned int ifnum
)
324 struct usb_interface_descriptor
*iface
;
325 struct usb_endpoint_descriptor
*ep
;
328 if (dev
->descriptor
.bNumConfigurations
!= 1) return 0;
329 iface
= &dev
->config
.if_desc
[ifnum
];
331 if (iface
->bInterfaceClass
!= 3) return 0;
332 if (iface
->bInterfaceSubClass
!= 1) return 0;
333 if (iface
->bInterfaceProtocol
!= 1) return 0;
334 if (iface
->bNumEndpoints
!= 1) return 0;
336 ep
= &iface
->ep_desc
[0];
338 if (!(ep
->bEndpointAddress
& 0x80)) return 0;
339 if ((ep
->bmAttributes
& 3) != 3) return 0;
340 USB_KBD_PRINTF("USB KBD found set protocol...\n");
341 /* ok, we found a USB Keyboard, install it */
342 /* usb_kbd_get_hid_desc(dev); */
343 usb_set_protocol(dev
, iface
->bInterfaceNumber
, 0);
344 USB_KBD_PRINTF("USB KBD found set idle...\n");
345 usb_set_idle(dev
, iface
->bInterfaceNumber
, REPEAT_RATE
, 0);
346 memset(&new[0], 0, 8);
347 memset(&old
[0], 0, 8);
349 pipe
= usb_rcvintpipe(dev
, ep
->bEndpointAddress
);
350 maxp
= usb_maxpacket(dev
, pipe
);
351 dev
->irq_handle
=usb_kbd_irq
;
352 USB_KBD_PRINTF("USB KBD enable interrupt pipe...\n");
353 usb_submit_int_msg(dev
,pipe
,&new[0], maxp
> 8 ? 8 : maxp
,ep
->bInterval
);
359 struct usb_hid_descriptor
{
360 unsigned char bLength
;
361 unsigned char bDescriptorType
; /* 0x21 for HID */
362 unsigned short bcdHID
; /* release number */
363 unsigned char bCountryCode
;
364 unsigned char bNumDescriptors
;
365 unsigned char bReportDescriptorType
;
366 unsigned short wDescriptorLength
;
367 } __attribute__ ((packed
));
370 * We parse each description item into this structure. Short items data
371 * values are expanded to 32-bit signed int, long items contain a pointer
372 * into the data area.
376 unsigned char format
;
387 unsigned char *longdata
;
392 * HID report item format
395 #define HID_ITEM_FORMAT_SHORT 0
396 #define HID_ITEM_FORMAT_LONG 1
399 * Special tag indicating long items
402 #define HID_ITEM_TAG_LONG 15
405 static struct usb_hid_descriptor usb_kbd_hid_desc
;
407 void usb_kbd_display_hid(struct usb_hid_descriptor
*hid
)
409 printf("USB_HID_DESC:\n");
410 printf(" bLenght 0x%x\n",hid
->bLength
);
411 printf(" bcdHID 0x%x\n",hid
->bcdHID
);
412 printf(" bCountryCode %d\n",hid
->bCountryCode
);
413 printf(" bNumDescriptors 0x%x\n",hid
->bNumDescriptors
);
414 printf(" bReportDescriptorType 0x%x\n",hid
->bReportDescriptorType
);
415 printf(" wDescriptorLength 0x%x\n",hid
->wDescriptorLength
);
420 * Fetch a report description item from the data stream. We support long
421 * items, though they are not used yet.
424 static int fetch_item(unsigned char *start
,unsigned char *end
, struct hid_item
*item
)
426 if((end
- start
) > 0) {
427 unsigned char b
= *start
++;
428 item
->type
= (b
>> 2) & 3;
429 item
->tag
= (b
>> 4) & 15;
430 if (item
->tag
== HID_ITEM_TAG_LONG
) {
431 item
->format
= HID_ITEM_FORMAT_LONG
;
432 if ((end
- start
) >= 2) {
433 item
->size
= *start
++;
434 item
->tag
= *start
++;
435 if ((end
- start
) >= item
->size
) {
436 item
->data
.longdata
= start
;
442 item
->format
= HID_ITEM_FORMAT_SHORT
;
444 switch (item
->size
) {
448 if ((end
- start
) >= 1) {
449 item
->data
.u8
= *start
++;
454 if ((end
- start
) >= 2) {
455 item
->data
.u16
= swap_16((unsigned short *)start
);
461 if ((end
- start
) >= 4) {
462 item
->data
.u32
= swap_32((unsigned long *)start
);
473 * HID report descriptor item type (prefix bit 2,3)
476 #define HID_ITEM_TYPE_MAIN 0
477 #define HID_ITEM_TYPE_GLOBAL 1
478 #define HID_ITEM_TYPE_LOCAL 2
479 #define HID_ITEM_TYPE_RESERVED 3
481 * HID report descriptor main item tags
484 #define HID_MAIN_ITEM_TAG_INPUT 8
485 #define HID_MAIN_ITEM_TAG_OUTPUT 9
486 #define HID_MAIN_ITEM_TAG_FEATURE 11
487 #define HID_MAIN_ITEM_TAG_BEGIN_COLLECTION 10
488 #define HID_MAIN_ITEM_TAG_END_COLLECTION 12
490 * HID report descriptor main item contents
493 #define HID_MAIN_ITEM_CONSTANT 0x001
494 #define HID_MAIN_ITEM_VARIABLE 0x002
495 #define HID_MAIN_ITEM_RELATIVE 0x004
496 #define HID_MAIN_ITEM_WRAP 0x008
497 #define HID_MAIN_ITEM_NONLINEAR 0x010
498 #define HID_MAIN_ITEM_NO_PREFERRED 0x020
499 #define HID_MAIN_ITEM_NULL_STATE 0x040
500 #define HID_MAIN_ITEM_VOLATILE 0x080
501 #define HID_MAIN_ITEM_BUFFERED_BYTE 0x100
504 * HID report descriptor collection item types
507 #define HID_COLLECTION_PHYSICAL 0
508 #define HID_COLLECTION_APPLICATION 1
509 #define HID_COLLECTION_LOGICAL 2
511 * HID report descriptor global item tags
514 #define HID_GLOBAL_ITEM_TAG_USAGE_PAGE 0
515 #define HID_GLOBAL_ITEM_TAG_LOGICAL_MINIMUM 1
516 #define HID_GLOBAL_ITEM_TAG_LOGICAL_MAXIMUM 2
517 #define HID_GLOBAL_ITEM_TAG_PHYSICAL_MINIMUM 3
518 #define HID_GLOBAL_ITEM_TAG_PHYSICAL_MAXIMUM 4
519 #define HID_GLOBAL_ITEM_TAG_UNIT_EXPONENT 5
520 #define HID_GLOBAL_ITEM_TAG_UNIT 6
521 #define HID_GLOBAL_ITEM_TAG_REPORT_SIZE 7
522 #define HID_GLOBAL_ITEM_TAG_REPORT_ID 8
523 #define HID_GLOBAL_ITEM_TAG_REPORT_COUNT 9
524 #define HID_GLOBAL_ITEM_TAG_PUSH 10
525 #define HID_GLOBAL_ITEM_TAG_POP 11
528 * HID report descriptor local item tags
531 #define HID_LOCAL_ITEM_TAG_USAGE 0
532 #define HID_LOCAL_ITEM_TAG_USAGE_MINIMUM 1
533 #define HID_LOCAL_ITEM_TAG_USAGE_MAXIMUM 2
534 #define HID_LOCAL_ITEM_TAG_DESIGNATOR_INDEX 3
535 #define HID_LOCAL_ITEM_TAG_DESIGNATOR_MINIMUM 4
536 #define HID_LOCAL_ITEM_TAG_DESIGNATOR_MAXIMUM 5
537 #define HID_LOCAL_ITEM_TAG_STRING_INDEX 7
538 #define HID_LOCAL_ITEM_TAG_STRING_MINIMUM 8
539 #define HID_LOCAL_ITEM_TAG_STRING_MAXIMUM 9
540 #define HID_LOCAL_ITEM_TAG_DELIMITER 10
543 static void usb_kbd_show_item(struct hid_item
*item
)
546 case HID_ITEM_TYPE_MAIN
:
548 case HID_MAIN_ITEM_TAG_INPUT
:
549 printf("Main Input");
551 case HID_MAIN_ITEM_TAG_OUTPUT
:
552 printf("Main Output");
554 case HID_MAIN_ITEM_TAG_FEATURE
:
555 printf("Main Feature");
557 case HID_MAIN_ITEM_TAG_BEGIN_COLLECTION
:
558 printf("Main Begin Collection");
560 case HID_MAIN_ITEM_TAG_END_COLLECTION
:
561 printf("Main End Collection");
564 printf("Main reserved %d",item
->tag
);
568 case HID_ITEM_TYPE_GLOBAL
:
570 case HID_GLOBAL_ITEM_TAG_USAGE_PAGE
:
571 printf("- Global Usage Page");
573 case HID_GLOBAL_ITEM_TAG_LOGICAL_MINIMUM
:
574 printf("- Global Logical Minimum");
576 case HID_GLOBAL_ITEM_TAG_LOGICAL_MAXIMUM
:
577 printf("- Global Logical Maximum");
579 case HID_GLOBAL_ITEM_TAG_PHYSICAL_MINIMUM
:
580 printf("- Global physical Minimum");
582 case HID_GLOBAL_ITEM_TAG_PHYSICAL_MAXIMUM
:
583 printf("- Global physical Maximum");
585 case HID_GLOBAL_ITEM_TAG_UNIT_EXPONENT
:
586 printf("- Global Unit Exponent");
588 case HID_GLOBAL_ITEM_TAG_UNIT
:
589 printf("- Global Unit");
591 case HID_GLOBAL_ITEM_TAG_REPORT_SIZE
:
592 printf("- Global Report Size");
594 case HID_GLOBAL_ITEM_TAG_REPORT_ID
:
595 printf("- Global Report ID");
597 case HID_GLOBAL_ITEM_TAG_REPORT_COUNT
:
598 printf("- Global Report Count");
600 case HID_GLOBAL_ITEM_TAG_PUSH
:
601 printf("- Global Push");
603 case HID_GLOBAL_ITEM_TAG_POP
:
604 printf("- Global Pop");
607 printf("- Global reserved %d",item
->tag
);
611 case HID_ITEM_TYPE_LOCAL
:
613 case HID_LOCAL_ITEM_TAG_USAGE
:
614 printf("-- Local Usage");
616 case HID_LOCAL_ITEM_TAG_USAGE_MINIMUM
:
617 printf("-- Local Usage Minimum");
619 case HID_LOCAL_ITEM_TAG_USAGE_MAXIMUM
:
620 printf("-- Local Usage Maximum");
622 case HID_LOCAL_ITEM_TAG_DESIGNATOR_INDEX
:
623 printf("-- Local Designator Index");
625 case HID_LOCAL_ITEM_TAG_DESIGNATOR_MINIMUM
:
626 printf("-- Local Designator Minimum");
628 case HID_LOCAL_ITEM_TAG_DESIGNATOR_MAXIMUM
:
629 printf("-- Local Designator Maximum");
631 case HID_LOCAL_ITEM_TAG_STRING_INDEX
:
632 printf("-- Local String Index");
634 case HID_LOCAL_ITEM_TAG_STRING_MINIMUM
:
635 printf("-- Local String Minimum");
637 case HID_LOCAL_ITEM_TAG_STRING_MAXIMUM
:
638 printf("-- Local String Maximum");
640 case HID_LOCAL_ITEM_TAG_DELIMITER
:
641 printf("-- Local Delimiter");
644 printf("-- Local reserved %d",item
->tag
);
649 printf("--- reserved %d",item
->type
);
654 printf(" %d",item
->data
.u8
);
657 printf(" %d",item
->data
.u16
);
660 printf(" %ld",item
->data
.u32
);
667 static int usb_kbd_get_hid_desc(struct usb_device
*dev
)
669 unsigned char buffer
[256];
670 struct usb_descriptor_header
*head
;
671 struct usb_config_descriptor
*config
;
673 unsigned char *start
, *end
;
674 struct hid_item item
;
676 if(usb_get_configuration_no(dev
,&buffer
[0],0)==-1)
678 head
=(struct usb_descriptor_header
*)&buffer
[0];
679 if(head
->bDescriptorType
!=USB_DT_CONFIG
) {
680 printf(" ERROR: NOT USB_CONFIG_DESC %x\n",head
->bDescriptorType
);
684 config
=(struct usb_config_descriptor
*)&buffer
[0];
685 len
=swap_16(config
->wTotalLength
);
686 /* Ok the first entry must be a configuration entry, now process the others */
687 head
=(struct usb_descriptor_header
*)&buffer
[index
];
688 while(index
+1 < len
) {
689 if(head
->bDescriptorType
==USB_DT_HID
) {
690 printf("HID desc found\n");
691 memcpy(&usb_kbd_hid_desc
,&buffer
[index
],buffer
[index
]);
692 usb_kbd_hid_desc
.bcdHID
=swap_16(usb_kbd_hid_desc
.bcdHID
);
693 usb_kbd_hid_desc
.wDescriptorLength
=swap_16(usb_kbd_hid_desc
.wDescriptorLength
);
694 usb_kbd_display_hid(&usb_kbd_hid_desc
);
698 index
+=head
->bLength
;
699 head
=(struct usb_descriptor_header
*)&buffer
[index
];
703 len
=usb_kbd_hid_desc
.wDescriptorLength
;
704 if((index
= usb_get_class_descriptor(dev
, 0, USB_DT_REPORT
, 0, &buffer
[0], len
)) < 0) {
705 printf("reading report descriptor failed\n");
708 printf(" report descriptor (size %u, read %d)\n", len
, index
);
713 index
=fetch_item(start
,end
,&item
);
717 usb_kbd_show_item(&item
);
728 #endif /* CONFIG_USB_KEYBOARD */