Add svn:eol-style property to source files, so that the line endings are correctly...
[pub/USBasp.git] / LUFA / Drivers / USB / Class / Common / RNDIS.h
index 74e22bd..ecbff51 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 RNDIS Class driver.\r
- *\r
- *  Common definitions and declarations for the library USB RNDIS 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/RNDIS.h.\r
- */\r
-\r
-/** \ingroup Group_USBClassRNDIS\r
- *  @defgroup Group_USBClassRNDISCommon  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
- *  RNDIS Class.\r
- *\r
- *  @{\r
- */\r
-\r
-#ifndef _RNDIS_CLASS_COMMON_H_\r
-#define _RNDIS_CLASS_COMMON_H_\r
-\r
-       /* Macros: */\r
-               #define __INCLUDE_FROM_CDC_DRIVER\r
-\r
-       /* Includes: */\r
-               #include "../../USB.h"\r
-               #include "RNDISConstants.h"\r
-               #include "CDC.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_RNDIS_DRIVER)\r
-                       #error Do not include this file directly. Include LUFA/Drivers/Class/RNDIS.h instead.\r
-               #endif\r
-               \r
-       /* Macros: */\r
-               /** Implemented RNDIS Version Major */\r
-               #define REMOTE_NDIS_VERSION_MAJOR             0x01\r
-\r
-               /** Implemented RNDIS Version Minor */\r
-               #define REMOTE_NDIS_VERSION_MINOR             0x00\r
-       \r
-               /** RNDIS request to issue a host-to-device NDIS command */\r
-               #define REQ_SendEncapsulatedCommand           0x00\r
-\r
-               /** RNDIS request to issue a device-to-host NDIS response */\r
-               #define REQ_GetEncapsulatedResponse           0x01\r
-               \r
-               /** Maximum size in bytes of a RNDIS control message which can be sent or received */\r
-               #define RNDIS_MESSAGE_BUFFER_SIZE             128\r
-\r
-               /** Maximum size in bytes of an Ethernet frame according to the Ethernet standard */\r
-               #define ETHERNET_FRAME_SIZE_MAX               1500\r
-               \r
-               /** Notification request value for a RNDIS Response Available notification */\r
-               #define NOTIF_ResponseAvailable               1\r
-               \r
-       /* Enums: */\r
-               /** Enum for the possible NDIS adapter states. */\r
-               enum RNDIS_States_t\r
-               {\r
-                       RNDIS_Uninitialized    = 0, /**< Adapter currently uninitialized */\r
-                       RNDIS_Initialized      = 1, /**< Adapter currently initialized but not ready for data transfers */\r
-                       RNDIS_Data_Initialized = 2, /**< Adapter currently initialized and ready for data transfers */\r
-               };\r
-\r
-               /** Enum for the NDIS hardware states */\r
-               enum NDIS_Hardware_Status_t\r
-               {\r
-                       NDIS_HardwareStatus_Ready, /**< Hardware Ready to accept commands from the host */\r
-                       NDIS_HardwareStatus_Initializing, /**< Hardware busy initializing */\r
-                       NDIS_HardwareStatus_Reset, /**< Hardware reset */\r
-                       NDIS_HardwareStatus_Closing, /**< Hardware currently closing */\r
-                       NDIS_HardwareStatus_NotReady /**< Hardware not ready to accept commands from the host */\r
-               };\r
-               \r
-       /* Type Defines: */\r
-               /** \brief MAC Address Structure.\r
-                *\r
-                *  Type define for a physical MAC address of a device on a network\r
-                */\r
-               typedef struct\r
-               {\r
-                       uint8_t       Octets[6]; /**< Individual bytes of a MAC address */\r
-               } MAC_Address_t;\r
-\r
-               /** \brief RNDIS Ethernet Frame Packet Information Structure.\r
-                *\r
-                *  Type define for an Ethernet frame buffer data and information structure.\r
-                */\r
-               typedef struct\r
-               {\r
-                       uint8_t       FrameData[ETHERNET_FRAME_SIZE_MAX]; /**< Ethernet frame contents */\r
-                       uint16_t      FrameLength; /**< Length in bytes of the Ethernet frame stored in the buffer */\r
-                       bool          FrameInBuffer; /**< Indicates if a frame is currently stored in the buffer */\r
-               } Ethernet_Frame_Info_t;\r
-\r
-               /** \brief RNDIS Common Message Header Structure.\r
-                *\r
-                *  Type define for a RNDIS message header, sent before RNDIS messages.\r
-                */\r
-               typedef struct\r
-               {\r
-                       uint32_t MessageType; /**< RNDIS message type, a REMOTE_NDIS_*_MSG constant */\r
-                       uint32_t MessageLength; /**< Total length of the RNDIS message, in bytes */\r
-               } RNDIS_Message_Header_t;\r
-\r
-               /** \brief RNDIS Message Structure.\r
-                *\r
-                *  Type define for a RNDIS packet message, used to encapsulate Ethernet packets sent to and from the adapter.\r
-                */\r
-               typedef struct\r
-               {\r
-                       uint32_t MessageType;\r
-                       uint32_t MessageLength;\r
-                       uint32_t DataOffset;\r
-                       uint32_t DataLength;\r
-                       uint32_t OOBDataOffset;\r
-                       uint32_t OOBDataLength;\r
-                       uint32_t NumOOBDataElements;\r
-                       uint32_t PerPacketInfoOffset;\r
-                       uint32_t PerPacketInfoLength;\r
-                       uint32_t VcHandle;\r
-                       uint32_t Reserved;\r
-               } RNDIS_Packet_Message_t;\r
-\r
-               /** \brief RNDIS Initialization Message Structure.\r
-                *\r
-                *  Type define for a RNDIS Initialize command message.\r
-                */\r
-               typedef struct\r
-               {\r
-                       uint32_t MessageType;\r
-                       uint32_t MessageLength;\r
-                       uint32_t RequestId;\r
-                       \r
-                       uint32_t MajorVersion;\r
-                       uint32_t MinorVersion;\r
-                       uint32_t MaxTransferSize;\r
-               } RNDIS_Initialize_Message_t;\r
-               \r
-               /** \brief RNDIS Initialize Complete Message Structure.\r
-                *\r
-                *  Type define for a RNDIS Initialize Complete response message.\r
-                */\r
-               typedef struct\r
-               {\r
-                       uint32_t MessageType;\r
-                       uint32_t MessageLength;\r
-                       uint32_t RequestId;\r
-                       uint32_t Status;\r
-                       \r
-                       uint32_t MajorVersion;\r
-                       uint32_t MinorVersion;\r
-                       uint32_t DeviceFlags;\r
-                       uint32_t Medium;\r
-                       uint32_t MaxPacketsPerTransfer;\r
-                       uint32_t MaxTransferSize;\r
-                       uint32_t PacketAlignmentFactor;\r
-                       uint32_t AFListOffset;\r
-                       uint32_t AFListSize;\r
-               } RNDIS_Initialize_Complete_t;\r
-               \r
-               /** \brief RNDIS Keep Alive Message Structure.\r
-                *\r
-                *  Type define for a RNDIS Keep Alive command message.\r
-                */\r
-               typedef struct\r
-               {\r
-                       uint32_t MessageType;\r
-                       uint32_t MessageLength;\r
-                       uint32_t RequestId;\r
-               } RNDIS_KeepAlive_Message_t;\r
-\r
-               /** \brief RNDIS Keep Alive Complete Message Structure.\r
-                *\r
-                *  Type define for a RNDIS Keep Alive Complete response message.\r
-                */\r
-               typedef struct\r
-               {\r
-                       uint32_t MessageType;\r
-                       uint32_t MessageLength;\r
-                       uint32_t RequestId;\r
-                       uint32_t Status;\r
-               } RNDIS_KeepAlive_Complete_t;\r
-\r
-               /** \brief RNDIS Reset Complete Message Structure.\r
-                *\r
-                *  Type define for a RNDIS Reset Complete response message.\r
-                */\r
-               typedef struct\r
-               {\r
-                       uint32_t MessageType;\r
-                       uint32_t MessageLength;\r
-                       uint32_t Status;\r
-\r
-                       uint32_t AddressingReset;\r
-               } RNDIS_Reset_Complete_t;\r
-               \r
-               /** \brief RNDIS OID Property Set Message Structure.\r
-                *\r
-                *  Type define for a RNDIS OID Property Set command message.\r
-                */\r
-               typedef struct\r
-               {\r
-                       uint32_t MessageType;\r
-                       uint32_t MessageLength;\r
-                       uint32_t RequestId;\r
-                       \r
-                       uint32_t Oid;\r
-                       uint32_t InformationBufferLength;\r
-                       uint32_t InformationBufferOffset;\r
-                       uint32_t DeviceVcHandle;\r
-               } RNDIS_Set_Message_t;\r
-\r
-               /** \brief RNDIS OID Property Set Complete Message Structure.\r
-                *\r
-                *  Type define for a RNDIS OID Property Set Complete response message.\r
-                */\r
-               typedef struct\r
-               {\r
-                       uint32_t MessageType;\r
-                       uint32_t MessageLength;\r
-                       uint32_t RequestId;\r
-                       uint32_t Status;\r
-               } RNDIS_Set_Complete_t;\r
-               \r
-               /** \brief RNDIS OID Property Query Message Structure.\r
-                *\r
-                *  Type define for a RNDIS OID Property Query command message.\r
-                */\r
-               typedef struct\r
-               {\r
-                       uint32_t MessageType;\r
-                       uint32_t MessageLength;\r
-                       uint32_t RequestId;\r
-                       \r
-                       uint32_t Oid;\r
-                       uint32_t InformationBufferLength;\r
-                       uint32_t InformationBufferOffset;\r
-                       uint32_t DeviceVcHandle;\r
-               } RNDIS_Query_Message_t;\r
-               \r
-               /** \brief RNDIS OID Property Query Complete Message Structure.\r
-                *\r
-                *  Type define for a RNDIS OID Property Query Complete response message.\r
-                */\r
-               typedef struct\r
-               {\r
-                       uint32_t MessageType;\r
-                       uint32_t MessageLength;\r
-                       uint32_t RequestId;\r
-                       uint32_t Status;\r
-                       \r
-                       uint32_t InformationBufferLength;\r
-                       uint32_t InformationBufferOffset;\r
-               } RNDIS_Query_Complete_t;\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 RNDIS Class driver.
+ *
+ *  Common definitions and declarations for the library USB RNDIS 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/RNDIS.h.
+ */
+
+/** \ingroup Group_USBClassRNDIS
+ *  @defgroup Group_USBClassRNDISCommon  Common Class Definitions
+ *
+ *  \section Module Description
+ *  Constants, Types and Enum definitions that are common to both Device and Host modes for the USB
+ *  RNDIS Class.
+ *
+ *  @{
+ */
+
+#ifndef _RNDIS_CLASS_COMMON_H_
+#define _RNDIS_CLASS_COMMON_H_
+
+       /* Macros: */
+               #define __INCLUDE_FROM_CDC_DRIVER
+
+       /* Includes: */
+               #include "../../USB.h"
+               #include "RNDISConstants.h"
+               #include "CDC.h"
+               
+               #include <string.h>
+       
+       /* Enable C linkage for C++ Compilers: */
+               #if defined(__cplusplus)
+                       extern "C" {
+               #endif
+
+       /* Preprocessor Checks: */
+               #if !defined(__INCLUDE_FROM_RNDIS_DRIVER)
+                       #error Do not include this file directly. Include LUFA/Drivers/Class/RNDIS.h instead.
+               #endif
+               
+       /* Macros: */
+               /** Implemented RNDIS Version Major */
+               #define REMOTE_NDIS_VERSION_MAJOR             0x01
+
+               /** Implemented RNDIS Version Minor */
+               #define REMOTE_NDIS_VERSION_MINOR             0x00
+       
+               /** RNDIS request to issue a host-to-device NDIS command */
+               #define REQ_SendEncapsulatedCommand           0x00
+
+               /** RNDIS request to issue a device-to-host NDIS response */
+               #define REQ_GetEncapsulatedResponse           0x01
+               
+               /** Maximum size in bytes of a RNDIS control message which can be sent or received */
+               #define RNDIS_MESSAGE_BUFFER_SIZE             128
+
+               /** Maximum size in bytes of an Ethernet frame according to the Ethernet standard */
+               #define ETHERNET_FRAME_SIZE_MAX               1500
+               
+               /** Notification request value for a RNDIS Response Available notification */
+               #define NOTIF_ResponseAvailable               1
+               
+       /* Enums: */
+               /** Enum for the possible NDIS adapter states. */
+               enum RNDIS_States_t
+               {
+                       RNDIS_Uninitialized    = 0, /**< Adapter currently uninitialized */
+                       RNDIS_Initialized      = 1, /**< Adapter currently initialized but not ready for data transfers */
+                       RNDIS_Data_Initialized = 2, /**< Adapter currently initialized and ready for data transfers */
+               };
+
+               /** Enum for the NDIS hardware states */
+               enum NDIS_Hardware_Status_t
+               {
+                       NDIS_HardwareStatus_Ready, /**< Hardware Ready to accept commands from the host */
+                       NDIS_HardwareStatus_Initializing, /**< Hardware busy initializing */
+                       NDIS_HardwareStatus_Reset, /**< Hardware reset */
+                       NDIS_HardwareStatus_Closing, /**< Hardware currently closing */
+                       NDIS_HardwareStatus_NotReady /**< Hardware not ready to accept commands from the host */
+               };
+               
+       /* Type Defines: */
+               /** \brief MAC Address Structure.
+                *
+                *  Type define for a physical MAC address of a device on a network
+                */
+               typedef struct
+               {
+                       uint8_t       Octets[6]; /**< Individual bytes of a MAC address */
+               } MAC_Address_t;
+
+               /** \brief RNDIS Ethernet Frame Packet Information Structure.
+                *
+                *  Type define for an Ethernet frame buffer data and information structure.
+                */
+               typedef struct
+               {
+                       uint8_t       FrameData[ETHERNET_FRAME_SIZE_MAX]; /**< Ethernet frame contents */
+                       uint16_t      FrameLength; /**< Length in bytes of the Ethernet frame stored in the buffer */
+                       bool          FrameInBuffer; /**< Indicates if a frame is currently stored in the buffer */
+               } Ethernet_Frame_Info_t;
+
+               /** \brief RNDIS Common Message Header Structure.
+                *
+                *  Type define for a RNDIS message header, sent before RNDIS messages.
+                */
+               typedef struct
+               {
+                       uint32_t MessageType; /**< RNDIS message type, a REMOTE_NDIS_*_MSG constant */
+                       uint32_t MessageLength; /**< Total length of the RNDIS message, in bytes */
+               } RNDIS_Message_Header_t;
+
+               /** \brief RNDIS Message Structure.
+                *
+                *  Type define for a RNDIS packet message, used to encapsulate Ethernet packets sent to and from the adapter.
+                */
+               typedef struct
+               {
+                       uint32_t MessageType;
+                       uint32_t MessageLength;
+                       uint32_t DataOffset;
+                       uint32_t DataLength;
+                       uint32_t OOBDataOffset;
+                       uint32_t OOBDataLength;
+                       uint32_t NumOOBDataElements;
+                       uint32_t PerPacketInfoOffset;
+                       uint32_t PerPacketInfoLength;
+                       uint32_t VcHandle;
+                       uint32_t Reserved;
+               } RNDIS_Packet_Message_t;
+
+               /** \brief RNDIS Initialization Message Structure.
+                *
+                *  Type define for a RNDIS Initialize command message.
+                */
+               typedef struct
+               {
+                       uint32_t MessageType;
+                       uint32_t MessageLength;
+                       uint32_t RequestId;
+                       
+                       uint32_t MajorVersion;
+                       uint32_t MinorVersion;
+                       uint32_t MaxTransferSize;
+               } RNDIS_Initialize_Message_t;
+               
+               /** \brief RNDIS Initialize Complete Message Structure.
+                *
+                *  Type define for a RNDIS Initialize Complete response message.
+                */
+               typedef struct
+               {
+                       uint32_t MessageType;
+                       uint32_t MessageLength;
+                       uint32_t RequestId;
+                       uint32_t Status;
+                       
+                       uint32_t MajorVersion;
+                       uint32_t MinorVersion;
+                       uint32_t DeviceFlags;
+                       uint32_t Medium;
+                       uint32_t MaxPacketsPerTransfer;
+                       uint32_t MaxTransferSize;
+                       uint32_t PacketAlignmentFactor;
+                       uint32_t AFListOffset;
+                       uint32_t AFListSize;
+               } RNDIS_Initialize_Complete_t;
+               
+               /** \brief RNDIS Keep Alive Message Structure.
+                *
+                *  Type define for a RNDIS Keep Alive command message.
+                */
+               typedef struct
+               {
+                       uint32_t MessageType;
+                       uint32_t MessageLength;
+                       uint32_t RequestId;
+               } RNDIS_KeepAlive_Message_t;
+
+               /** \brief RNDIS Keep Alive Complete Message Structure.
+                *
+                *  Type define for a RNDIS Keep Alive Complete response message.
+                */
+               typedef struct
+               {
+                       uint32_t MessageType;
+                       uint32_t MessageLength;
+                       uint32_t RequestId;
+                       uint32_t Status;
+               } RNDIS_KeepAlive_Complete_t;
+
+               /** \brief RNDIS Reset Complete Message Structure.
+                *
+                *  Type define for a RNDIS Reset Complete response message.
+                */
+               typedef struct
+               {
+                       uint32_t MessageType;
+                       uint32_t MessageLength;
+                       uint32_t Status;
+
+                       uint32_t AddressingReset;
+               } RNDIS_Reset_Complete_t;
+               
+               /** \brief RNDIS OID Property Set Message Structure.
+                *
+                *  Type define for a RNDIS OID Property Set command message.
+                */
+               typedef struct
+               {
+                       uint32_t MessageType;
+                       uint32_t MessageLength;
+                       uint32_t RequestId;
+                       
+                       uint32_t Oid;
+                       uint32_t InformationBufferLength;
+                       uint32_t InformationBufferOffset;
+                       uint32_t DeviceVcHandle;
+               } RNDIS_Set_Message_t;
+
+               /** \brief RNDIS OID Property Set Complete Message Structure.
+                *
+                *  Type define for a RNDIS OID Property Set Complete response message.
+                */
+               typedef struct
+               {
+                       uint32_t MessageType;
+                       uint32_t MessageLength;
+                       uint32_t RequestId;
+                       uint32_t Status;
+               } RNDIS_Set_Complete_t;
+               
+               /** \brief RNDIS OID Property Query Message Structure.
+                *
+                *  Type define for a RNDIS OID Property Query command message.
+                */
+               typedef struct
+               {
+                       uint32_t MessageType;
+                       uint32_t MessageLength;
+                       uint32_t RequestId;
+                       
+                       uint32_t Oid;
+                       uint32_t InformationBufferLength;
+                       uint32_t InformationBufferOffset;
+                       uint32_t DeviceVcHandle;
+               } RNDIS_Query_Message_t;
+               
+               /** \brief RNDIS OID Property Query Complete Message Structure.
+                *
+                *  Type define for a RNDIS OID Property Query Complete response message.
+                */
+               typedef struct
+               {
+                       uint32_t MessageType;
+                       uint32_t MessageLength;
+                       uint32_t RequestId;
+                       uint32_t Status;
+                       
+                       uint32_t InformationBufferLength;
+                       uint32_t InformationBufferOffset;
+               } RNDIS_Query_Complete_t;
+                               
+       /* Disable C linkage for C++ Compilers: */
+               #if defined(__cplusplus)
+                       }
+               #endif
+               
+#endif
+
+/** @} */