mirror of
				https://github.com/mfulz/qmk_firmware.git
				synced 2025-11-04 07:12:33 +01:00 
			
		
		
		
	
		
			
				
	
	
		
			78 lines
		
	
	
		
			2.5 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
			
		
		
	
	
			78 lines
		
	
	
		
			2.5 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
/** \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
 | 
						|
 *
 | 
						|
 *  \section SSec_Compat Demo Compatibility:
 | 
						|
 *
 | 
						|
 *  The following list indicates what microcontrollers are compatible with this demo.
 | 
						|
 *
 | 
						|
 *  - Series 7 USB AVRs
 | 
						|
 *  - Series 6 USB AVRs
 | 
						|
 *  - Series 4 USB AVRs
 | 
						|
 *  - Series 2 USB AVRs
 | 
						|
 *
 | 
						|
 *  \section SSec_Info USB Information:
 | 
						|
 *
 | 
						|
 *  The following table gives a rundown of the USB utilization of this demo.
 | 
						|
 *
 | 
						|
 *  <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 \n
 | 
						|
 *        USBIF HID Usage Tables</td>
 | 
						|
 *   </tr>
 | 
						|
 *   <tr>
 | 
						|
 *    <td><b>Usable Speeds:</b></td>
 | 
						|
 *    <td>Low Speed Mode \n
 | 
						|
 *        Full Speed Mode</td>
 | 
						|
 *   </tr>
 | 
						|
 *  </table>
 | 
						|
 *
 | 
						|
 *  \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
 | 
						|
 *  (i.e. no special drivers required). This example uses two separate HID
 | 
						|
 *  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).
 | 
						|
 *  
 | 
						|
 *  On start-up the system will automatically enumerate and function
 | 
						|
 *  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
 | 
						|
 *  on sending keyboard event and key presses.
 | 
						|
 *  
 | 
						|
 *  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>
 | 
						|
 */
 |