Add svn:eol-style property to source files, so that the line endings are correctly...
[pub/USBasp.git] / Bootloaders / CDC / BootloaderCDC.h
index 8142211..64811c8 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
- *\r
- *  Header file for BootloaderCDC.c.\r
- */\r
\r
-#ifndef _CDC_H_\r
-#define _CDC_H_\r
-\r
-       /* Includes: */\r
-               #include <avr/io.h>\r
-               #include <avr/wdt.h>\r
-               #include <avr/boot.h>\r
-               #include <avr/eeprom.h>\r
-               #include <avr/power.h>\r
-               #include <avr/interrupt.h>\r
-               #include <stdbool.h>\r
-\r
-               #include "Descriptors.h"\r
-\r
-               #include <LUFA/Drivers/USB/USB.h>\r
-\r
-       /* Macros: */\r
-               /** CDC Class Specific request to get the line encoding on a CDC-ACM virtual serial port, including the\r
-                *  baud rate, parity, stop bits and data bits.\r
-                */\r
-               #define REQ_GetLineEncoding          0x21\r
-\r
-               /** CDC Class Specific request to set the line encoding on a CDC-ACM virtual serial port, including the\r
-                *  baud rate, parity, stop bits and data bits.\r
-                */\r
-               #define REQ_SetLineEncoding          0x20\r
-\r
-               /** CDC Class Specific request to set the state of the serial handshake lines (such as DCD and RTS) on\r
-                *  a CDC-ACM virtual serial port.\r
-                */\r
-               #define REQ_SetControlLineState      0x22\r
-               \r
-               /** Version major of the CDC bootloader. */\r
-               #define BOOTLOADER_VERSION_MAJOR     0x01\r
-\r
-               /** Version minor of the CDC bootloader. */\r
-               #define BOOTLOADER_VERSION_MINOR     0x00\r
-                               \r
-               /** Hardware version major of the CDC bootloader. */\r
-               #define BOOTLOADER_HWVERSION_MAJOR   0x01\r
-\r
-               /** Hardware version minor of the CDC bootloader. */\r
-               #define BOOTLOADER_HWVERSION_MINOR   0x00\r
-\r
-               /** Eight character bootloader firmware identifier reported to the host when requested */\r
-               #define SOFTWARE_IDENTIFIER          "LUFACDC"\r
-               \r
-       /* Type Defines: */\r
-               /** Type define for a non-returning pointer to the start of the loaded application in flash memory. */\r
-               typedef void (*AppPtr_t)(void) ATTR_NO_RETURN;\r
-\r
-               /** Type define for the CDC-ACM virtual serial port line encoding options, including baud rate, format, parity\r
-                *  and size of each data chunk in bits.\r
-                */\r
-               typedef struct\r
-               {\r
-                       uint32_t BaudRateBPS; /**< Baud rate in BPS */\r
-                       uint8_t  CharFormat; /**< Character format, an entry from the BootloaderCDC_CDC_LineCodingFormats_t enum */\r
-                       uint8_t  ParityType; /**< Parity mode, an entry from the BootloaderCDC_CDC_LineCodeingParity_t enum */\r
-                       uint8_t  DataBits; /**< Size of each data chunk, in bits */\r
-               } CDC_Line_Coding_t;\r
-               \r
-       /* Enums: */\r
-               /** Enum for the possible line encoding formats on a CDC-ACM virtual serial port */\r
-               enum BootloaderCDC_CDC_LineCodingFormats_t\r
-               {\r
-                       OneStopBit          = 0, /**< Single stop bit */\r
-                       OneAndAHalfStopBits = 1, /**< 1.5 stop bits */\r
-                       TwoStopBits         = 2, /**< Two stop bits */\r
-               };\r
-               \r
-               /** Enum for the possible parity modes on a CDC-ACM virtual serial port */\r
-               enum BootloaderCDC_CDC_LineCodingParity_t\r
-               {\r
-                       Parity_None         = 0, /**< No data parity checking */\r
-                       Parity_Odd          = 1, /**< Odd data parity checking */\r
-                       Parity_Even         = 2, /**< Even data parity checking */\r
-                       Parity_Mark         = 3, /**< Mark data parity checking */\r
-                       Parity_Space        = 4, /**< Space data parity checking */\r
-               };\r
-               \r
-       /* Function Prototypes: */\r
-               void CDC_Task(void);\r
-               void SetupHardware(void);\r
-\r
-               void EVENT_USB_Device_ConfigurationChanged(void);\r
-               void EVENT_USB_Device_UnhandledControlRequest(void);\r
-\r
-               #if defined(INCLUDE_FROM_BOOTLOADERCDC_C) || defined(__DOXYGEN__)\r
-                       static void    ReadWriteMemoryBlock(const uint8_t Command);\r
-                       static uint8_t FetchNextCommandByte(void);\r
-                       static void    WriteNextResponseByte(const uint8_t Response);\r
-               #endif\r
-\r
-#endif\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
+ *
+ *  Header file for BootloaderCDC.c.
+ */
+#ifndef _CDC_H_
+#define _CDC_H_
+
+       /* Includes: */
+               #include <avr/io.h>
+               #include <avr/wdt.h>
+               #include <avr/boot.h>
+               #include <avr/eeprom.h>
+               #include <avr/power.h>
+               #include <avr/interrupt.h>
+               #include <stdbool.h>
+
+               #include "Descriptors.h"
+
+               #include <LUFA/Drivers/USB/USB.h>
+
+       /* Macros: */
+               /** CDC Class Specific request to get the line encoding on a CDC-ACM virtual serial port, including the
+                *  baud rate, parity, stop bits and data bits.
+                */
+               #define REQ_GetLineEncoding          0x21
+
+               /** CDC Class Specific request to set the line encoding on a CDC-ACM virtual serial port, including the
+                *  baud rate, parity, stop bits and data bits.
+                */
+               #define REQ_SetLineEncoding          0x20
+
+               /** CDC Class Specific request to set the state of the serial handshake lines (such as DCD and RTS) on
+                *  a CDC-ACM virtual serial port.
+                */
+               #define REQ_SetControlLineState      0x22
+               
+               /** Version major of the CDC bootloader. */
+               #define BOOTLOADER_VERSION_MAJOR     0x01
+
+               /** Version minor of the CDC bootloader. */
+               #define BOOTLOADER_VERSION_MINOR     0x00
+                               
+               /** Hardware version major of the CDC bootloader. */
+               #define BOOTLOADER_HWVERSION_MAJOR   0x01
+
+               /** Hardware version minor of the CDC bootloader. */
+               #define BOOTLOADER_HWVERSION_MINOR   0x00
+
+               /** Eight character bootloader firmware identifier reported to the host when requested */
+               #define SOFTWARE_IDENTIFIER          "LUFACDC"
+               
+       /* Type Defines: */
+               /** Type define for a non-returning pointer to the start of the loaded application in flash memory. */
+               typedef void (*AppPtr_t)(void) ATTR_NO_RETURN;
+
+               /** Type define for the CDC-ACM virtual serial port line encoding options, including baud rate, format, parity
+                *  and size of each data chunk in bits.
+                */
+               typedef struct
+               {
+                       uint32_t BaudRateBPS; /**< Baud rate in BPS */
+                       uint8_t  CharFormat; /**< Character format, an entry from the BootloaderCDC_CDC_LineCodingFormats_t enum */
+                       uint8_t  ParityType; /**< Parity mode, an entry from the BootloaderCDC_CDC_LineCodeingParity_t enum */
+                       uint8_t  DataBits; /**< Size of each data chunk, in bits */
+               } CDC_Line_Coding_t;
+               
+       /* Enums: */
+               /** Enum for the possible line encoding formats on a CDC-ACM virtual serial port */
+               enum BootloaderCDC_CDC_LineCodingFormats_t
+               {
+                       OneStopBit          = 0, /**< Single stop bit */
+                       OneAndAHalfStopBits = 1, /**< 1.5 stop bits */
+                       TwoStopBits         = 2, /**< Two stop bits */
+               };
+               
+               /** Enum for the possible parity modes on a CDC-ACM virtual serial port */
+               enum BootloaderCDC_CDC_LineCodingParity_t
+               {
+                       Parity_None         = 0, /**< No data parity checking */
+                       Parity_Odd          = 1, /**< Odd data parity checking */
+                       Parity_Even         = 2, /**< Even data parity checking */
+                       Parity_Mark         = 3, /**< Mark data parity checking */
+                       Parity_Space        = 4, /**< Space data parity checking */
+               };
+               
+       /* Function Prototypes: */
+               void CDC_Task(void);
+               void SetupHardware(void);
+
+               void EVENT_USB_Device_ConfigurationChanged(void);
+               void EVENT_USB_Device_UnhandledControlRequest(void);
+
+               #if defined(INCLUDE_FROM_BOOTLOADERCDC_C) || defined(__DOXYGEN__)
+                       static void    ReadWriteMemoryBlock(const uint8_t Command);
+                       static uint8_t FetchNextCommandByte(void);
+                       static void    WriteNextResponseByte(const uint8_t Response);
+               #endif
+
+#endif