aboutsummaryrefslogtreecommitdiffstats
path: root/Demos/Device/DualCDC/DualCDC.txt
diff options
context:
space:
mode:
authorDean Camera <dean@fourwalledcubicle.com>2009-03-20 06:34:41 +0000
committerDean Camera <dean@fourwalledcubicle.com>2009-03-20 06:34:41 +0000
commited031c1df2f5b053b9cd9f48c63e66a42b7c049e (patch)
tree8e49d639484d53a6e00700b20e2b804e9775242f /Demos/Device/DualCDC/DualCDC.txt
parentecf7538430c01b95104682f0f7493e57b9168125 (diff)
downloadlufa-ed031c1df2f5b053b9cd9f48c63e66a42b7c049e.tar.gz
lufa-ed031c1df2f5b053b9cd9f48c63e66a42b7c049e.tar.bz2
lufa-ed031c1df2f5b053b9cd9f48c63e66a42b7c049e.zip
Seperated out OTG, Device and Host mode demos into seperate folders for clarity. Adjusted makefiles so that the path to the LUFA library can be set in one place.
Diffstat (limited to 'Demos/Device/DualCDC/DualCDC.txt')
-rw-r--r--Demos/Device/DualCDC/DualCDC.txt75
1 files changed, 75 insertions, 0 deletions
diff --git a/Demos/Device/DualCDC/DualCDC.txt b/Demos/Device/DualCDC/DualCDC.txt
new file mode 100644
index 000000000..6e086029b
--- /dev/null
+++ b/Demos/Device/DualCDC/DualCDC.txt
@@ -0,0 +1,75 @@
+/** \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 Communications Device Class Device (Dual Virtual Serial Port)
+ *
+ * \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>Miscellaneous Device Class</td>
+ * <td>( Sub-Interface: Communications Device Class (CDC) )</td>
+ * </tr>
+ * <tr>
+ * <td><b>USB Subclass:</b></td>
+ * <td>Common Class</td>
+ * <td>( Sub-Interface: Abstract Control Model (ACM) )</td>
+ * </tr>
+ * <tr>
+ * <td><b>Relevant Standards:</b></td>
+ * <td>USBIF Interface Association Descriptor ECN</td>
+ * <td>USBIF CDC Class Standard</td>
+ * </tr>
+ * <tr>
+ * <td><b>Usable Speeds:</b></td>
+ * <td>Full Speed Mode</td>
+ * </tr>
+ * </table>
+ *
+ * \section SSec_Description Project Description:
+ *
+ * Dual Communications Device Class demonstration application.
+ * This gives a simple reference application for implementing
+ * a compound device with dual CDC functions acting as a pair
+ * of virtual serial ports. This demo uses Interface Association
+ * Descriptors to link together the pair of related CDC
+ * descriptors for each virtual serial port, which may not be
+ * supported in all OSes - Windows Vista is supported, as is
+ * XP (although the latter may need a hotfix to function).
+ *
+ * Joystick actions are transmitted to the host as strings
+ * through the first serial port. The device does not respond to
+ * serial data sent from the host in the first serial port.
+ *
+ * The second serial port echoes back data sent from the host.
+ *
+ * After running this demo for the first time on a new computer,
+ * you will need to supply the .INF file located in this demo
+ * project's directory as the device's driver when running under
+ * Windows. This will enable Windows to use its inbuilt CDC drivers,
+ * negating the need for custom drivers for the device. Other
+ * Operating Systems should automatically use their own inbuilt
+ * CDC-ACM drivers.
+ *
+ * \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>
+ */ \ No newline at end of file