1 /* Copyright (c) 2010-2011 mbed.org, MIT License
3 * Permission is hereby granted, free of charge, to any person obtaining a copy of this software
4 * and associated documentation files (the "Software"), to deal in the Software without
5 * restriction, including without limitation the rights to use, copy, modify, merge, publish,
6 * distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the
7 * Software is furnished to do so, subject to the following conditions:
9 * The above copyright notice and this permission notice shall be included in all copies or
10 * substantial portions of the Software.
12 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING
13 * BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
14 * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
15 * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
16 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
21 #include "USBKeyboard.h"
23 #define REPORT_ID_KEYBOARD 1
24 #define REPORT_ID_VOLUME 3
29 unsigned char modifier
;
33 /* US keyboard (as HID standard) */
34 #define KEYMAP_SIZE (148)
35 const KEYMAP keymap
[KEYMAP_SIZE
] = {
44 {0x2a, 0}, /* BS */ /* Keyboard Delete (Backspace) */
45 {0x2b, 0}, /* TAB */ /* Keyboard Tab */
46 {0x28, 0}, /* LF */ /* Keyboard Return (Enter) */
69 {0x1e, KEY_SHIFT
}, /* ! */
70 {0x34, KEY_SHIFT
}, /* " */
71 {0x20, KEY_SHIFT
}, /* # */
72 {0x21, KEY_SHIFT
}, /* $ */
73 {0x22, KEY_SHIFT
}, /* % */
74 {0x24, KEY_SHIFT
}, /* & */
76 {0x26, KEY_SHIFT
}, /* ( */
77 {0x27, KEY_SHIFT
}, /* ) */
78 {0x25, KEY_SHIFT
}, /* * */
79 {0x2e, KEY_SHIFT
}, /* + */
94 {0x33, KEY_SHIFT
}, /* : */
96 {0x36, KEY_SHIFT
}, /* < */
98 {0x37, KEY_SHIFT
}, /* > */
99 {0x38, KEY_SHIFT
}, /* ? */
100 {0x1f, KEY_SHIFT
}, /* @ */
101 {0x04, KEY_SHIFT
}, /* A */
102 {0x05, KEY_SHIFT
}, /* B */
103 {0x06, KEY_SHIFT
}, /* C */
104 {0x07, KEY_SHIFT
}, /* D */
105 {0x08, KEY_SHIFT
}, /* E */
106 {0x09, KEY_SHIFT
}, /* F */
107 {0x0a, KEY_SHIFT
}, /* G */
108 {0x0b, KEY_SHIFT
}, /* H */
109 {0x0c, KEY_SHIFT
}, /* I */
110 {0x0d, KEY_SHIFT
}, /* J */
111 {0x0e, KEY_SHIFT
}, /* K */
112 {0x0f, KEY_SHIFT
}, /* L */
113 {0x10, KEY_SHIFT
}, /* M */
114 {0x11, KEY_SHIFT
}, /* N */
115 {0x12, KEY_SHIFT
}, /* O */
116 {0x13, KEY_SHIFT
}, /* P */
117 {0x14, KEY_SHIFT
}, /* Q */
118 {0x15, KEY_SHIFT
}, /* R */
119 {0x16, KEY_SHIFT
}, /* S */
120 {0x17, KEY_SHIFT
}, /* T */
121 {0x18, KEY_SHIFT
}, /* U */
122 {0x19, KEY_SHIFT
}, /* V */
123 {0x1a, KEY_SHIFT
}, /* W */
124 {0x1b, KEY_SHIFT
}, /* X */
125 {0x1c, KEY_SHIFT
}, /* Y */
126 {0x1d, KEY_SHIFT
}, /* Z */
130 {0x23, KEY_SHIFT
}, /* ^ */
131 {0x2d, KEY_SHIFT
}, /* _ */
159 {0x2f, KEY_SHIFT
}, /* { */
160 {0x31, KEY_SHIFT
}, /* | */
161 {0x30, KEY_SHIFT
}, /* } */
162 {0x35, KEY_SHIFT
}, /* ~ */
178 {0x46, 0}, /* PRINT_SCREEN */
179 {0x47, 0}, /* SCROLL_LOCK */
180 {0x39, 0}, /* CAPS_LOCK */
181 {0x53, 0}, /* NUM_LOCK */
182 {0x49, 0}, /* INSERT */
183 {0x4a, 0}, /* HOME */
184 {0x4b, 0}, /* PAGE_UP */
185 {0x4e, 0}, /* PAGE_DOWN */
190 #define KEYMAP_SIZE (148)
191 const KEYMAP keymap
[KEYMAP_SIZE
] = {
200 {0x2a, 0}, /* BS */ /* Keyboard Delete (Backspace) */
201 {0x2b, 0}, /* TAB */ /* Keyboard Tab */
202 {0x28, 0}, /* LF */ /* Keyboard Return (Enter) */
225 {0x1e, KEY_SHIFT
}, /* ! */
226 {0x1f, KEY_SHIFT
}, /* " */
228 {0x21, KEY_SHIFT
}, /* $ */
229 {0x22, KEY_SHIFT
}, /* % */
230 {0x24, KEY_SHIFT
}, /* & */
232 {0x26, KEY_SHIFT
}, /* ( */
233 {0x27, KEY_SHIFT
}, /* ) */
234 {0x25, KEY_SHIFT
}, /* * */
235 {0x2e, KEY_SHIFT
}, /* + */
250 {0x33, KEY_SHIFT
}, /* : */
252 {0x36, KEY_SHIFT
}, /* < */
254 {0x37, KEY_SHIFT
}, /* > */
255 {0x38, KEY_SHIFT
}, /* ? */
256 {0x34, KEY_SHIFT
}, /* @ */
257 {0x04, KEY_SHIFT
}, /* A */
258 {0x05, KEY_SHIFT
}, /* B */
259 {0x06, KEY_SHIFT
}, /* C */
260 {0x07, KEY_SHIFT
}, /* D */
261 {0x08, KEY_SHIFT
}, /* E */
262 {0x09, KEY_SHIFT
}, /* F */
263 {0x0a, KEY_SHIFT
}, /* G */
264 {0x0b, KEY_SHIFT
}, /* H */
265 {0x0c, KEY_SHIFT
}, /* I */
266 {0x0d, KEY_SHIFT
}, /* J */
267 {0x0e, KEY_SHIFT
}, /* K */
268 {0x0f, KEY_SHIFT
}, /* L */
269 {0x10, KEY_SHIFT
}, /* M */
270 {0x11, KEY_SHIFT
}, /* N */
271 {0x12, KEY_SHIFT
}, /* O */
272 {0x13, KEY_SHIFT
}, /* P */
273 {0x14, KEY_SHIFT
}, /* Q */
274 {0x15, KEY_SHIFT
}, /* R */
275 {0x16, KEY_SHIFT
}, /* S */
276 {0x17, KEY_SHIFT
}, /* T */
277 {0x18, KEY_SHIFT
}, /* U */
278 {0x19, KEY_SHIFT
}, /* V */
279 {0x1a, KEY_SHIFT
}, /* W */
280 {0x1b, KEY_SHIFT
}, /* X */
281 {0x1c, KEY_SHIFT
}, /* Y */
282 {0x1d, KEY_SHIFT
}, /* Z */
286 {0x23, KEY_SHIFT
}, /* ^ */
287 {0x2d, KEY_SHIFT
}, /* _ */
315 {0x2f, KEY_SHIFT
}, /* { */
316 {0x64, KEY_SHIFT
}, /* | */
317 {0x30, KEY_SHIFT
}, /* } */
318 {0x32, KEY_SHIFT
}, /* ~ */
334 {0x46, 0}, /* PRINT_SCREEN */
335 {0x47, 0}, /* SCROLL_LOCK */
336 {0x39, 0}, /* CAPS_LOCK */
337 {0x53, 0}, /* NUM_LOCK */
338 {0x49, 0}, /* INSERT */
339 {0x4a, 0}, /* HOME */
340 {0x4b, 0}, /* PAGE_UP */
341 {0x4e, 0}, /* PAGE_DOWN */
345 uint8_t * USBKeyboard::reportDesc() {
346 static uint8_t reportDescriptor
[] = {
347 USAGE_PAGE(1), 0x01, // Generic Desktop
348 USAGE(1), 0x06, // Keyboard
349 COLLECTION(1), 0x01, // Application
350 REPORT_ID(1), REPORT_ID_KEYBOARD
,
352 USAGE_PAGE(1), 0x07, // Key Codes
353 USAGE_MINIMUM(1), 0xE0,
354 USAGE_MAXIMUM(1), 0xE7,
355 LOGICAL_MINIMUM(1), 0x00,
356 LOGICAL_MAXIMUM(1), 0x01,
357 REPORT_SIZE(1), 0x01,
358 REPORT_COUNT(1), 0x08,
359 INPUT(1), 0x02, // Data, Variable, Absolute
360 REPORT_COUNT(1), 0x01,
361 REPORT_SIZE(1), 0x08,
362 INPUT(1), 0x01, // Constant
365 REPORT_COUNT(1), 0x05,
366 REPORT_SIZE(1), 0x01,
367 USAGE_PAGE(1), 0x08, // LEDs
368 USAGE_MINIMUM(1), 0x01,
369 USAGE_MAXIMUM(1), 0x05,
370 OUTPUT(1), 0x02, // Data, Variable, Absolute
371 REPORT_COUNT(1), 0x01,
372 REPORT_SIZE(1), 0x03,
373 OUTPUT(1), 0x01, // Constant
376 REPORT_COUNT(1), 0x06,
377 REPORT_SIZE(1), 0x08,
378 LOGICAL_MINIMUM(1), 0x00,
379 LOGICAL_MAXIMUM(1), 0x65,
380 USAGE_PAGE(1), 0x07, // Key Codes
381 USAGE_MINIMUM(1), 0x00,
382 USAGE_MAXIMUM(1), 0x65,
383 INPUT(1), 0x00, // Data, Array
390 REPORT_ID(1), REPORT_ID_VOLUME
,
392 LOGICAL_MINIMUM(1), 0x00,
393 LOGICAL_MAXIMUM(1), 0x01,
394 REPORT_SIZE(1), 0x01,
395 REPORT_COUNT(1), 0x07,
396 USAGE(1), 0xB5, // Next Track
397 USAGE(1), 0xB6, // Previous Track
398 USAGE(1), 0xB7, // Stop
399 USAGE(1), 0xCD, // Play / Pause
400 USAGE(1), 0xE2, // Mute
401 USAGE(1), 0xE9, // Volume Up
402 USAGE(1), 0xEA, // Volume Down
403 INPUT(1), 0x02, // Input (Data, Variable, Absolute)
404 REPORT_COUNT(1), 0x01,
408 reportLength
= sizeof(reportDescriptor
);
409 return reportDescriptor
;
413 bool USBKeyboard::EP1_OUT_callback() {
414 uint16_t bytesRead
= 0;
416 USBDevice::readEP(EPINT_OUT
, led
, &bytesRead
, MAX_HID_REPORT_SIZE
);
418 // we take led[1] because led[0] is the report ID
419 lock_status
= led
[1] & 0x07;
421 // We activate the endpoint to be able to recceive data
422 if (!readStart(EPINT_OUT
, MAX_HID_REPORT_SIZE
))
427 uint8_t USBKeyboard::lockStatus() {
431 int USBKeyboard::_putc(int c
) {
432 return keyCode(c
, keymap
[c
].modifier
);
435 bool USBKeyboard::keyCode(uint8_t key
, uint8_t modifier
) {
436 // Send a simulated keyboard keypress. Returns true if successful.
439 report
.data
[0] = REPORT_ID_KEYBOARD
;
440 report
.data
[1] = modifier
;
442 report
.data
[3] = keymap
[key
].usage
;
451 if (!send(&report
)) {
458 if (!send(&report
)) {
467 bool USBKeyboard::mediaControl(MEDIA_KEY key
) {
470 report
.data
[0] = REPORT_ID_VOLUME
;
471 report
.data
[1] = (1 << key
) & 0x7f;
475 if (!send(&report
)) {
479 report
.data
[0] = REPORT_ID_VOLUME
;
484 return send(&report
);