KeyboardMouse.txt 2.21 KB
Newer Older
1
2
3
4
5
6
7
8
/** \file
 *
 *  This file contains special DoxyGen information for the generation of the main page and other special
 *  documentation pages. It is not a project source file.
 */
 
/** \mainpage Dual HID Keyboard and Mouse Device Demo
 *
9
10
11
 *  \section SSec_Info USB Information:
 *
 *  The following table gives a rundown of the USB utilization of this demo.
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
 *
 *  <table>
 *   <tr>
 *    <td><b>USB Mode:</b></td>
 *    <td>Device</td>
 *   </tr>
 *   <tr>
 *    <td><b>USB Class:</b></td>
 *    <td>Human Interface Device (HID)</td>
 *   </tr>
 *   <tr> 
 *    <td><b>USB Subclass:</b></td>
 *    <td>N/A</td>
 *   </tr>
 *   <tr>
 *    <td><b>Relevant Standards:</b></td>
 *    <td>USBIF HID Specification, USBIF HID Usage Tables</td>
 *   </tr>
 *   <tr>
 *    <td><b>Usable Speeds:</b></td>
 *    <td>Low Speed Mode, Full Speed Mode</td>
 *   </tr>
 *  </table>
35
36
37
38
39
40
 *
 *  \section SSec_Description Project Description: 
 *
 *  Keyboard/Mouse demonstration application. This gives a simple reference
 *  application for implementing a composite device containing both USB Keyboard
 *  and USB Mouse functionality using the basic USB HID drivers in all modern OSes
41
 *  (i.e. no special drivers required). This example uses two separate HID
42
43
44
 *  interfaces for each function. It is boot protocol compatible, and thus works under
 *  compatible BIOS as if it was a native keyboard and mouse (e.g. PS/2).
 *  
45
 *  On start-up the system will automatically enumerate and function
46
47
48
 *  as a keyboard when the USB connection to a host is present and the HWB is not
 *  pressed. When enabled, manipulate the joystick to send the letters
 *  a, b, c, d and e. See the USB HID documentation for more information
49
 *  on sending keyboard event and key presses.
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
 *  
 *  When the HWB is pressed, the mouse mode is enabled. When enabled, move the
 *  joystick to move the pointer, and push the joystick inwards to simulate a
 *  left-button click.
 *
 *  \section SSec_Options Project Options
 *
 *  The following defines can be found in this demo, which can control the demo behaviour when defined, or changed in value.
 *
 *  <table>
 *   <tr>
 *    <td>
 *     None
 *    </td>
 *   </tr>
 *  </table>
66
 */