Add svn:eol-style property to source files, so that the line endings are correctly...
[pub/lufa.git] / LUFA / Drivers / USB / Class / Common / CDC.h
index 9fb1202..b6ab82a 100644 (file)
-/*\r
-             LUFA Library\r
-     Copyright (C) Dean Camera, 2010.\r
-              \r
-  dean [at] fourwalledcubicle [dot] com\r
-      www.fourwalledcubicle.com\r
-*/\r
-\r
-/*\r
-  Copyright 2010  Dean Camera (dean [at] fourwalledcubicle [dot] com)\r
-\r
-  Permission to use, copy, modify, distribute, and sell this \r
-  software and its documentation for any purpose is hereby granted\r
-  without fee, provided that the above copyright notice appear in \r
-  all copies and that both that the copyright notice and this\r
-  permission notice and warranty disclaimer appear in supporting \r
-  documentation, and that the name of the author not be used in \r
-  advertising or publicity pertaining to distribution of the \r
-  software without specific, written prior permission.\r
-\r
-  The author disclaim all warranties with regard to this\r
-  software, including all implied warranties of merchantability\r
-  and fitness.  In no event shall the author be liable for any\r
-  special, indirect or consequential damages or any damages\r
-  whatsoever resulting from loss of use, data or profits, whether\r
-  in an action of contract, negligence or other tortious action,\r
-  arising out of or in connection with the use or performance of\r
-  this software.\r
-*/\r
-\r
-/** \file\r
- *  \brief Common definitions and declarations for the library USB CDC Class driver.\r
- *\r
- *  Common definitions and declarations for the library USB CDC Class driver.\r
- *\r
- *  \note This file should not be included directly. It is automatically included as needed by the class driver\r
- *        dispatch header located in LUFA/Drivers/USB/Class/CDC.h.\r
- */\r
-\r
-/** \ingroup Group_USBClassCDC\r
- *  @defgroup Group_USBClassCDCCommon  Common Class Definitions\r
- *\r
- *  \section Module Description\r
- *  Constants, Types and Enum definitions that are common to both Device and Host modes for the USB\r
- *  CDC Class.\r
- *\r
- *  @{\r
- */\r
\r
-#ifndef _CDC_CLASS_COMMON_H_\r
-#define _CDC_CLASS_COMMON_H_\r
-\r
-       /* Includes: */\r
-               #include "../../USB.h"\r
-\r
-               #include <string.h>\r
-\r
-       /* Enable C linkage for C++ Compilers: */\r
-               #if defined(__cplusplus)\r
-                       extern "C" {\r
-               #endif\r
-\r
-       /* Preprocessor Checks: */\r
-               #if !defined(__INCLUDE_FROM_CDC_DRIVER)\r
-                       #error Do not include this file directly. Include LUFA/Drivers/Class/CDC.h instead.\r
-               #endif\r
-               \r
-       /* Macros: */\r
-               /** CDC Class specific request to get the current virtual serial port configuration settings. */\r
-               #define REQ_GetLineEncoding              0x21\r
-\r
-               /** CDC Class specific request to set the current virtual serial port configuration settings. */\r
-               #define REQ_SetLineEncoding              0x20\r
-\r
-               /** CDC Class specific request to set the current virtual serial port handshake line states. */\r
-               #define REQ_SetControlLineState          0x22\r
-\r
-               /** CDC Class specific request to send a break to the receiver via the carrier channel. */\r
-               #define REQ_SendBreak                    0x23\r
-\r
-               /** CDC Class specific request to send an encapsulated command to the device. */\r
-               #define REQ_SendEncapsulatedCommand      0x00\r
-\r
-               /** CDC Class specific request to retrieve an encapsulated command response from the device. */\r
-               #define REQ_GetEncapsulatedResponse      0x01\r
-               \r
-               /** Notification type constant for a change in the virtual serial port handshake line states, for\r
-                *  use with a USB_Notification_Header_t notification structure when sent to the host via the CDC \r
-                *  notification endpoint.\r
-                */\r
-               #define NOTIF_SerialState                0x20\r
-\r
-               /** Mask for the DTR handshake line for use with the REQ_SetControlLineState class specific request\r
-                *  from the host, to indicate that the DTR line state should be high.\r
-                */\r
-               #define CDC_CONTROL_LINE_OUT_DTR         (1 << 0)\r
-\r
-               /** Mask for the RTS handshake line for use with the REQ_SetControlLineState class specific request\r
-                *  from the host, to indicate that theRTS line state should be high.\r
-                */\r
-               #define CDC_CONTROL_LINE_OUT_RTS         (1 << 1)\r
-               \r
-               /** Mask for the DCD handshake line for use with the a NOTIF_SerialState class specific notification\r
-                *  from the device to the host, to indicate that the DCD line state is currently high.\r
-                */\r
-               #define CDC_CONTROL_LINE_IN_DCD          (1 << 0)\r
-\r
-               /** Mask for the DSR handshake line for use with the a NOTIF_SerialState class specific notification\r
-                *  from the device to the host, to indicate that the DSR line state is currently high.\r
-                */\r
-               #define CDC_CONTROL_LINE_IN_DSR          (1 << 1)\r
-\r
-               /** Mask for the BREAK handshake line for use with the a NOTIF_SerialState class specific notification\r
-                *  from the device to the host, to indicate that the BREAK line state is currently high.\r
-                */\r
-               #define CDC_CONTROL_LINE_IN_BREAK        (1 << 2)\r
-\r
-               /** Mask for the RING handshake line for use with the a NOTIF_SerialState class specific notification\r
-                *  from the device to the host, to indicate that the RING line state is currently high.\r
-                */\r
-               #define CDC_CONTROL_LINE_IN_RING         (1 << 3)\r
-\r
-               /** Mask for use with the a NOTIF_SerialState class specific notification from the device to the host,\r
-                *  to indicate that a framing error has occurred on the virtual serial port.\r
-                */\r
-               #define CDC_CONTROL_LINE_IN_FRAMEERROR   (1 << 4)\r
-\r
-               /** Mask for use with the a NOTIF_SerialState class specific notification from the device to the host,\r
-                *  to indicate that a parity error has occurred on the virtual serial port.\r
-                */\r
-               #define CDC_CONTROL_LINE_IN_PARITYERROR  (1 << 5)\r
-\r
-               /** Mask for use with the a NOTIF_SerialState class specific notification from the device to the host,\r
-                *  to indicate that a data overrun error has occurred on the virtual serial port.\r
-                */\r
-               #define CDC_CONTROL_LINE_IN_OVERRUNERROR (1 << 6)\r
-               \r
-               /** Macro to define a CDC class-specific functional descriptor. CDC functional descriptors have a\r
-                *  uniform structure but variable sized data payloads, thus cannot be represented accurately by\r
-                *  a single typedef struct. A macro is used instead so that functional descriptors can be created\r
-                *  easily by specifying the size of the payload. This allows sizeof() to work correctly.\r
-                *\r
-                *  \param[in] DataSize  Size in bytes of the CDC functional descriptor's data payload\r
-                */\r
-               #define CDC_FUNCTIONAL_DESCRIPTOR(DataSize)        \\r
-                    struct                                        \\r
-                    {                                             \\r
-                         USB_Descriptor_Header_t Header;          \\r
-                             uint8_t                 SubType;         \\r
-                         uint8_t                 Data[DataSize];  \\r
-                    }\r
-\r
-       /* Enums: */\r
-               /** Enum for the possible line encoding formats of a virtual serial port. */\r
-               enum CDC_LineCodingFormats_t\r
-               {\r
-                       CDC_LINEENCODING_OneStopBit          = 0, /**< Each frame contains one stop bit */\r
-                       CDC_LINEENCODING_OneAndAHalfStopBits = 1, /**< Each frame contains one and a half stop bits */\r
-                       CDC_LINEENCODING_TwoStopBits         = 2, /**< Each frame contains two stop bits */\r
-               };\r
-               \r
-               /** Enum for the possible line encoding parity settings of a virtual serial port. */\r
-               enum CDC_LineCodingParity_t\r
-               {\r
-                       CDC_PARITY_None    = 0, /**< No parity bit mode on each frame */\r
-                       CDC_PARITY_Odd     = 1, /**< Odd parity bit mode on each frame */\r
-                       CDC_PARITY_Even    = 2, /**< Even parity bit mode on each frame */\r
-                       CDC_PARITY_Mark    = 3, /**< Mark parity bit mode on each frame */\r
-                       CDC_PARITY_Space   = 4, /**< Space parity bit mode on each frame */\r
-               };\r
-\r
-       /* Disable C linkage for C++ Compilers: */\r
-               #if defined(__cplusplus)\r
-                       }\r
-               #endif\r
-               \r
-#endif\r
-\r
-/** @} */\r
+/*
+             LUFA Library
+     Copyright (C) Dean Camera, 2010.
+              
+  dean [at] fourwalledcubicle [dot] com
+      www.fourwalledcubicle.com
+*/
+
+/*
+  Copyright 2010  Dean Camera (dean [at] fourwalledcubicle [dot] com)
+
+  Permission to use, copy, modify, distribute, and sell this 
+  software and its documentation for any purpose is hereby granted
+  without fee, provided that the above copyright notice appear in 
+  all copies and that both that the copyright notice and this
+  permission notice and warranty disclaimer appear in supporting 
+  documentation, and that the name of the author not be used in 
+  advertising or publicity pertaining to distribution of the 
+  software without specific, written prior permission.
+
+  The author disclaim all warranties with regard to this
+  software, including all implied warranties of merchantability
+  and fitness.  In no event shall the author be liable for any
+  special, indirect or consequential damages or any damages
+  whatsoever resulting from loss of use, data or profits, whether
+  in an action of contract, negligence or other tortious action,
+  arising out of or in connection with the use or performance of
+  this software.
+*/
+
+/** \file
+ *  \brief Common definitions and declarations for the library USB CDC Class driver.
+ *
+ *  Common definitions and declarations for the library USB CDC Class driver.
+ *
+ *  \note This file should not be included directly. It is automatically included as needed by the class driver
+ *        dispatch header located in LUFA/Drivers/USB/Class/CDC.h.
+ */
+
+/** \ingroup Group_USBClassCDC
+ *  @defgroup Group_USBClassCDCCommon  Common Class Definitions
+ *
+ *  \section Module Description
+ *  Constants, Types and Enum definitions that are common to both Device and Host modes for the USB
+ *  CDC Class.
+ *
+ *  @{
+ */
+#ifndef _CDC_CLASS_COMMON_H_
+#define _CDC_CLASS_COMMON_H_
+
+       /* Includes: */
+               #include "../../USB.h"
+
+               #include <string.h>
+
+       /* Enable C linkage for C++ Compilers: */
+               #if defined(__cplusplus)
+                       extern "C" {
+               #endif
+
+       /* Preprocessor Checks: */
+               #if !defined(__INCLUDE_FROM_CDC_DRIVER)
+                       #error Do not include this file directly. Include LUFA/Drivers/Class/CDC.h instead.
+               #endif
+               
+       /* Macros: */
+               /** CDC Class specific request to get the current virtual serial port configuration settings. */
+               #define REQ_GetLineEncoding              0x21
+
+               /** CDC Class specific request to set the current virtual serial port configuration settings. */
+               #define REQ_SetLineEncoding              0x20
+
+               /** CDC Class specific request to set the current virtual serial port handshake line states. */
+               #define REQ_SetControlLineState          0x22
+
+               /** CDC Class specific request to send a break to the receiver via the carrier channel. */
+               #define REQ_SendBreak                    0x23
+
+               /** CDC Class specific request to send an encapsulated command to the device. */
+               #define REQ_SendEncapsulatedCommand      0x00
+
+               /** CDC Class specific request to retrieve an encapsulated command response from the device. */
+               #define REQ_GetEncapsulatedResponse      0x01
+               
+               /** Notification type constant for a change in the virtual serial port handshake line states, for
+                *  use with a USB_Notification_Header_t notification structure when sent to the host via the CDC 
+                *  notification endpoint.
+                */
+               #define NOTIF_SerialState                0x20
+
+               /** Mask for the DTR handshake line for use with the REQ_SetControlLineState class specific request
+                *  from the host, to indicate that the DTR line state should be high.
+                */
+               #define CDC_CONTROL_LINE_OUT_DTR         (1 << 0)
+
+               /** Mask for the RTS handshake line for use with the REQ_SetControlLineState class specific request
+                *  from the host, to indicate that theRTS line state should be high.
+                */
+               #define CDC_CONTROL_LINE_OUT_RTS         (1 << 1)
+               
+               /** Mask for the DCD handshake line for use with the a NOTIF_SerialState class specific notification
+                *  from the device to the host, to indicate that the DCD line state is currently high.
+                */
+               #define CDC_CONTROL_LINE_IN_DCD          (1 << 0)
+
+               /** Mask for the DSR handshake line for use with the a NOTIF_SerialState class specific notification
+                *  from the device to the host, to indicate that the DSR line state is currently high.
+                */
+               #define CDC_CONTROL_LINE_IN_DSR          (1 << 1)
+
+               /** Mask for the BREAK handshake line for use with the a NOTIF_SerialState class specific notification
+                *  from the device to the host, to indicate that the BREAK line state is currently high.
+                */
+               #define CDC_CONTROL_LINE_IN_BREAK        (1 << 2)
+
+               /** Mask for the RING handshake line for use with the a NOTIF_SerialState class specific notification
+                *  from the device to the host, to indicate that the RING line state is currently high.
+                */
+               #define CDC_CONTROL_LINE_IN_RING         (1 << 3)
+
+               /** Mask for use with the a NOTIF_SerialState class specific notification from the device to the host,
+                *  to indicate that a framing error has occurred on the virtual serial port.
+                */
+               #define CDC_CONTROL_LINE_IN_FRAMEERROR   (1 << 4)
+
+               /** Mask for use with the a NOTIF_SerialState class specific notification from the device to the host,
+                *  to indicate that a parity error has occurred on the virtual serial port.
+                */
+               #define CDC_CONTROL_LINE_IN_PARITYERROR  (1 << 5)
+
+               /** Mask for use with the a NOTIF_SerialState class specific notification from the device to the host,
+                *  to indicate that a data overrun error has occurred on the virtual serial port.
+                */
+               #define CDC_CONTROL_LINE_IN_OVERRUNERROR (1 << 6)
+               
+               /** Macro to define a CDC class-specific functional descriptor. CDC functional descriptors have a
+                *  uniform structure but variable sized data payloads, thus cannot be represented accurately by
+                *  a single typedef struct. A macro is used instead so that functional descriptors can be created
+                *  easily by specifying the size of the payload. This allows sizeof() to work correctly.
+                *
+                *  \param[in] DataSize  Size in bytes of the CDC functional descriptor's data payload
+                */
+               #define CDC_FUNCTIONAL_DESCRIPTOR(DataSize)        \
+                    struct                                        \
+                    {                                             \
+                         USB_Descriptor_Header_t Header;          \
+                             uint8_t                 SubType;         \
+                         uint8_t                 Data[DataSize];  \
+                    }
+
+       /* Enums: */
+               /** Enum for the possible line encoding formats of a virtual serial port. */
+               enum CDC_LineCodingFormats_t
+               {
+                       CDC_LINEENCODING_OneStopBit          = 0, /**< Each frame contains one stop bit */
+                       CDC_LINEENCODING_OneAndAHalfStopBits = 1, /**< Each frame contains one and a half stop bits */
+                       CDC_LINEENCODING_TwoStopBits         = 2, /**< Each frame contains two stop bits */
+               };
+               
+               /** Enum for the possible line encoding parity settings of a virtual serial port. */
+               enum CDC_LineCodingParity_t
+               {
+                       CDC_PARITY_None    = 0, /**< No parity bit mode on each frame */
+                       CDC_PARITY_Odd     = 1, /**< Odd parity bit mode on each frame */
+                       CDC_PARITY_Even    = 2, /**< Even parity bit mode on each frame */
+                       CDC_PARITY_Mark    = 3, /**< Mark parity bit mode on each frame */
+                       CDC_PARITY_Space   = 4, /**< Space parity bit mode on each frame */
+               };
+
+       /* Disable C linkage for C++ Compilers: */
+               #if defined(__cplusplus)
+                       }
+               #endif
+               
+#endif
+
+/** @} */