diff options
Diffstat (limited to 'Demos/Host')
40 files changed, 194 insertions, 154 deletions
diff --git a/Demos/Host/ClassDriver/JoystickHostWithParser/JoystickHostWithParser.h b/Demos/Host/ClassDriver/JoystickHostWithParser/JoystickHostWithParser.h index 9ba8c7cb4..da667e632 100644 --- a/Demos/Host/ClassDriver/JoystickHostWithParser/JoystickHostWithParser.h +++ b/Demos/Host/ClassDriver/JoystickHostWithParser/JoystickHostWithParser.h @@ -64,19 +64,19 @@  		/** LED mask for the library LED driver, to indicate that an error has occurred in the USB interface. */  		#define LEDMASK_USB_ERROR           (LEDS_LED1 | LEDS_LED3) -		/** HID Report Descriptor Usage Page value for a toggle button */ +		/** HID Report Descriptor Usage Page value for a toggle button. */  		#define USAGE_PAGE_BUTTON           0x09 -		/** HID Report Descriptor Usage Page value for a Generic Desktop Control */ +		/** HID Report Descriptor Usage Page value for a Generic Desktop Control. */  		#define USAGE_PAGE_GENERIC_DCTRL    0x01 -		/** HID Report Descriptor Usage for a Joystick */ +		/** HID Report Descriptor Usage for a Joystick. */  		#define USAGE_JOYSTICK              0x04 -		/** HID Report Descriptor Usage value for a X axis movement */ +		/** HID Report Descriptor Usage value for a X axis movement. */  		#define USAGE_X                     0x30 -		/** HID Report Descriptor Usage value for a Y axis movement */ +		/** HID Report Descriptor Usage value for a Y axis movement. */  		#define USAGE_Y                     0x31  	/* Function Prototypes: */ diff --git a/Demos/Host/ClassDriver/KeyboardHostWithParser/KeyboardHostWithParser.h b/Demos/Host/ClassDriver/KeyboardHostWithParser/KeyboardHostWithParser.h index 1027d3cb9..8a0aeffd6 100644 --- a/Demos/Host/ClassDriver/KeyboardHostWithParser/KeyboardHostWithParser.h +++ b/Demos/Host/ClassDriver/KeyboardHostWithParser/KeyboardHostWithParser.h @@ -64,7 +64,7 @@  		/** LED mask for the library LED driver, to indicate that an error has occurred in the USB interface. */  		#define LEDMASK_USB_ERROR        (LEDS_LED1 | LEDS_LED3) -		/** HID Report Descriptor Usage Page value for a desktop keyboard */ +		/** HID Report Descriptor Usage Page value for a desktop keyboard. */  		#define USAGE_PAGE_KEYBOARD      0x07  	/* Function Prototypes: */ diff --git a/Demos/Host/ClassDriver/MouseHostWithParser/MouseHostWithParser.h b/Demos/Host/ClassDriver/MouseHostWithParser/MouseHostWithParser.h index 05f6f76c1..342dff79a 100644 --- a/Demos/Host/ClassDriver/MouseHostWithParser/MouseHostWithParser.h +++ b/Demos/Host/ClassDriver/MouseHostWithParser/MouseHostWithParser.h @@ -64,22 +64,22 @@  		/** LED mask for the library LED driver, to indicate that an error has occurred in the USB interface. */  		#define LEDMASK_USB_ERROR           (LEDS_LED1 | LEDS_LED3) -		/** HID Report Descriptor Usage Page value for a toggle button */ +		/** HID Report Descriptor Usage Page value for a toggle button. */  		#define USAGE_PAGE_BUTTON           0x09 -		/** HID Report Descriptor Usage Page value for a Generic Desktop Control */ +		/** HID Report Descriptor Usage Page value for a Generic Desktop Control. */  		#define USAGE_PAGE_GENERIC_DCTRL    0x01 -		/** HID Report Descriptor Usage for a Mouse */ +		/** HID Report Descriptor Usage for a Mouse. */  		#define USAGE_MOUSE                 0x02 -		/** HID Report Descriptor Usage value for a X axis movement */ +		/** HID Report Descriptor Usage value for a X axis movement. */  		#define USAGE_X                     0x30 -		/** HID Report Descriptor Usage value for a Y axis movement */ +		/** HID Report Descriptor Usage value for a Y axis movement. */  		#define USAGE_Y                     0x31 -		/** HID Report Descriptor Usage value for a Scroll Wheel movement */ +		/** HID Report Descriptor Usage value for a Scroll Wheel movement. */  		#define USAGE_SCROLL_WHEEL          0x38  	/* Function Prototypes: */ diff --git a/Demos/Host/Incomplete/BluetoothHost/BluetoothHost.c b/Demos/Host/Incomplete/BluetoothHost/BluetoothHost.c index 4aa1df537..1e75f477f 100644 --- a/Demos/Host/Incomplete/BluetoothHost/BluetoothHost.c +++ b/Demos/Host/Incomplete/BluetoothHost/BluetoothHost.c @@ -36,7 +36,7 @@  #include "BluetoothHost.h" -/** Bluetooth configuration structure. This structure configures the bluetooth stack's user alterable settings. */ +/** Bluetooth configuration structure. This structure configures the Bluetooth stack's user alterable settings. */  Bluetooth_Device_t Bluetooth_DeviceConfiguration =  	{  		Class:   (DEVICE_CLASS_SERVICE_CAPTURING | DEVICE_CLASS_MAJOR_COMPUTER | DEVICE_CLASS_MINOR_COMPUTER_PALM), @@ -214,7 +214,7 @@ void Bluetooth_StackInitialized(void)  	         Bluetooth_State.LocalBDADDR[5], Bluetooth_State.LocalBDADDR[4], Bluetooth_State.LocalBDADDR[3],  	         Bluetooth_State.LocalBDADDR[2], Bluetooth_State.LocalBDADDR[1], Bluetooth_State.LocalBDADDR[0]); -	/* Reinitialize the services placed on top of the bluetooth stack ready for new connections */ +	/* Reinitialize the services placed on top of the Bluetooth stack ready for new connections */  	SDP_Initialize();  	RFCOMM_Initialize();  } diff --git a/Demos/Host/Incomplete/BluetoothHost/ConfigDescriptor.c b/Demos/Host/Incomplete/BluetoothHost/ConfigDescriptor.c index db56f462b..0fd08fb93 100644 --- a/Demos/Host/Incomplete/BluetoothHost/ConfigDescriptor.c +++ b/Demos/Host/Incomplete/BluetoothHost/ConfigDescriptor.c @@ -65,7 +65,7 @@ uint8_t ProcessConfigurationDescriptor(void)  			return ControlError;  	} -	/* The bluetooth USB transport addendum mandates that the data (not streaming voice) endpoints +	/* The Bluetooth USB transport addendum mandates that the data (not streaming voice) endpoints  	   be in the first interface descriptor (interface 0) */  	USB_GetNextDescriptorOfType(&CurrConfigBytesRem, &CurrConfigLocation, DTYPE_Interface); @@ -73,11 +73,11 @@ uint8_t ProcessConfigurationDescriptor(void)  	if (!(CurrConfigBytesRem))  	  return NoBTInterfaceFound; -	/* Get the data IN, data OUT and event notification endpoints for the bluetooth interface */ +	/* Get the data IN, data OUT and event notification endpoints for the Bluetooth interface */  	while (FoundEndpoints != ((1 << BLUETOOTH_DATA_IN_PIPE) | (1 << BLUETOOTH_DATA_OUT_PIPE) |  	                          (1 << BLUETOOTH_EVENTS_PIPE)))  	{ -		/* Fetch the next endpoint from the current bluetooth interface */ +		/* Fetch the next endpoint from the current Bluetooth interface */  		if (USB_GetNextDescriptorComp(&CurrConfigBytesRem, &CurrConfigLocation,  		                              DComp_NextInterfaceBluetoothDataEndpoint))  		{ diff --git a/Demos/Host/Incomplete/BluetoothHost/DeviceDescriptor.h b/Demos/Host/Incomplete/BluetoothHost/DeviceDescriptor.h index 5dee7d996..fdde1e431 100644 --- a/Demos/Host/Incomplete/BluetoothHost/DeviceDescriptor.h +++ b/Demos/Host/Incomplete/BluetoothHost/DeviceDescriptor.h @@ -42,13 +42,13 @@  		#include "BluetoothHost.h"  	/* Macros: */ -		/** Device Class value for the Bluetooth Device class */ +		/** Device Class value for the Bluetooth Device class. */  		#define BLUETOOTH_DEVICE_CLASS           0xE0 -		/** Device Subclass value for the Bluetooth Device class */ +		/** Device Subclass value for the Bluetooth Device class. */  		#define BLUETOOTH_DEVICE_SUBCLASS        0x01 -		/** Device Protocol value for the Bluetooth Device class */ +		/** Device Protocol value for the Bluetooth Device class. */  		#define BLUETOOTH_DEVICE_PROTOCOL        0x01  	/* Enums: */ diff --git a/Demos/Host/Incomplete/BluetoothHost/Lib/BluetoothACLPackets.c b/Demos/Host/Incomplete/BluetoothHost/Lib/BluetoothACLPackets.c index 698210488..03d0f2aca 100644 --- a/Demos/Host/Incomplete/BluetoothHost/Lib/BluetoothACLPackets.c +++ b/Demos/Host/Incomplete/BluetoothHost/Lib/BluetoothACLPackets.c @@ -249,7 +249,7 @@ uint8_t Bluetooth_SendPacket(void* Data, const uint16_t DataLen, Bluetooth_Chann  	return BT_SENDPACKET_NoError;  } -/** Opens a bluetooth channel to the currently connected remote device, so that data can be exchanged. +/** Opens a Bluetooth channel to the currently connected remote device, so that data can be exchanged.   *   *  \note The channel is not immediately opened when this function returns - it must undergo a two way   *        connection and configuration process first as the main Bluetooth stack processing task is @@ -312,7 +312,7 @@ Bluetooth_Channel_t* Bluetooth_OpenChannel(const uint16_t PSM)  	return ChannelData;  } -/** Closes a bluetooth channel that is open to the currently connected remote device, so that no further data +/** Closes a Bluetooth channel that is open to the currently connected remote device, so that no further data   *  can be exchanged.   *   *  \note The channel is not immediately closed when this function returns - it must undergo an asynchronous diff --git a/Demos/Host/Incomplete/BluetoothHost/Lib/BluetoothACLPackets.h b/Demos/Host/Incomplete/BluetoothHost/Lib/BluetoothACLPackets.h index c655971fc..894c37003 100644 --- a/Demos/Host/Incomplete/BluetoothHost/Lib/BluetoothACLPackets.h +++ b/Demos/Host/Incomplete/BluetoothHost/Lib/BluetoothACLPackets.h @@ -51,13 +51,13 @@  		#define BT_ACL_DEBUG(l, s, ...)           do { if (ACL_DEBUG_LEVEL >= l) printf_P(PSTR("(ACL) " s "\r\n"), ##__VA_ARGS__); } while (0)  		#define ACL_DEBUG_LEVEL                   0 -		/** Lowest possible channel number for L2CAP data channels */ +		/** Lowest possible channel number for L2CAP data channels. */  		#define BT_CHANNELNUMBER_BASEOFFSET       0x0040 -		/** Bluetooth specification defined channel number for signalling commands */ +		/** Bluetooth specification defined channel number for signalling commands. */  		#define BT_CHANNEL_SIGNALING              0x0001 -		/** Bluetooth specification defined channel number for connectionless data */ +		/** Bluetooth specification defined channel number for connectionless data. */  		#define BT_CHANNEL_CONNECTIONLESS         0x0002  		#define BT_ACL_FIRST_AUTOFLUSH            (1 << 13) @@ -98,14 +98,14 @@  			uint16_t DataLength; /**< Length of the packet payload, in bytes */  		} BT_ACL_Header_t; -		/** Bluetooth ACL data packet header structure, for ACL packets containing L2CAP data */ +		/** Bluetooth ACL data packet header structure, for ACL packets containing L2CAP data. */  		typedef struct  		{  			uint16_t PayloadLength; /**< Size of the data payload, in bytes */  			uint16_t DestinationChannel; /**< Destination channel in the device the data is directed to */  		} BT_DataPacket_Header_t; -		/** Bluetooth signalling command header structure, for all ACL packets containing a signalling command */ +		/** Bluetooth signalling command header structure, for all ACL packets containing a signalling command. */  		typedef struct  		{  			uint8_t  Code; /**< Signal code, a BT_SIGNAL_* mask value */ diff --git a/Demos/Host/Incomplete/BluetoothHost/Lib/BluetoothHCICommands.c b/Demos/Host/Incomplete/BluetoothHost/Lib/BluetoothHCICommands.c index df97220a2..57b74e089 100644 --- a/Demos/Host/Incomplete/BluetoothHost/Lib/BluetoothHCICommands.c +++ b/Demos/Host/Incomplete/BluetoothHost/Lib/BluetoothHCICommands.c @@ -182,7 +182,7 @@ void Bluetooth_HCITask(void)  				ParameterLength: 0,  			}; -			/* Send the command to reset the bluetooth dongle controller */ +			/* Send the command to reset the Bluetooth dongle controller */  			Bluetooth_SendHCICommand(&HCICommandHeader, NULL, 0);  			Bluetooth_State.NextHCIState    = Bluetooth_Init_ReadBufferSize; @@ -197,7 +197,7 @@ void Bluetooth_HCITask(void)  				ParameterLength: 0,  			}; -			/* Send the command to read the bluetooth buffer size (mandatory before device sends any data) */ +			/* Send the command to read the Bluetooth buffer size (mandatory before device sends any data) */  			Bluetooth_SendHCICommand(&HCICommandHeader, NULL, 0);  			Bluetooth_State.NextHCIState    = Bluetooth_Init_GetBDADDR; @@ -212,7 +212,7 @@ void Bluetooth_HCITask(void)  				ParameterLength: 0,  			}; -			/* Send the command to retrieve the BDADDR of the inserted bluetooth dongle */ +			/* Send the command to retrieve the BDADDR of the inserted Bluetooth dongle */  			Bluetooth_SendHCICommand(&HCICommandHeader, NULL, 0);  			Bluetooth_State.NextHCIState    = Bluetooth_Init_SetLocalName; @@ -227,7 +227,7 @@ void Bluetooth_HCITask(void)  					ParameterLength: 248,  				}; -			/* Send the command to set the bluetooth dongle's name for other devices to see */ +			/* Send the command to set the Bluetooth dongle's name for other devices to see */  			Bluetooth_SendHCICommand(&HCICommandHeader, Bluetooth_DeviceConfiguration.Name, strlen(Bluetooth_DeviceConfiguration.Name));  			Bluetooth_State.NextHCIState    = Bluetooth_Init_SetDeviceClass; diff --git a/Demos/Host/Incomplete/BluetoothHost/Lib/BluetoothStack.h b/Demos/Host/Incomplete/BluetoothHost/Lib/BluetoothStack.h index fb25ec77d..060f4fffd 100644 --- a/Demos/Host/Incomplete/BluetoothHost/Lib/BluetoothStack.h +++ b/Demos/Host/Incomplete/BluetoothHost/Lib/BluetoothStack.h @@ -63,7 +63,7 @@  		#define MAXIMUM_CHANNEL_MTU            255  	/* Enums: */ -		/** Enum for the possible states for a bluetooth ACL channel. */ +		/** Enum for the possible states for a Bluetooth ACL channel. */  		enum BT_ChannelStates_t  		{  			Channel_Closed                = 0, /**< Channel is closed and inactive. No data may be sent or received. */ @@ -85,7 +85,7 @@  		enum BT_SendPacket_ErrorCodes_t  		{  			BT_SENDPACKET_NoError            = 0, /**< The packet was sent sucessfully. */ -			BT_SENDPACKET_NotConnected       = 1, /**< The bluetooth stack is not currently connected to a remote device. */ +			BT_SENDPACKET_NotConnected       = 1, /**< The Bluetooth stack is not currently connected to a remote device. */  			BT_SENDPACKET_ChannelNotOpen     = 2, /**< The given channel is not currently in the Open state. */  		}; @@ -122,7 +122,7 @@  		{  			uint32_t Class; /**< Class of the local device, a mask of DEVICE_CLASS_* masks. */  			char     PINCode[16]; /**< Pin code required to send or receive in order to authenticate with a remote device. */ -			char     Name[]; /**< Name of the local bluetooth device, up to 248 characters. */ +			char     Name[]; /**< Name of the local Bluetooth device, up to 248 characters. */  		} Bluetooth_Device_t;  		/** Bluetooth stack state information structure, for the containment of the Bluetooth stack state. The values in @@ -136,7 +136,7 @@  			bool    IsInitialized; /**< Indicates if the Bluetooth stack is currently initialized and ready for connections  			                        *   to or from a remote Bluetooth device.  			                        */ -			uint8_t LocalBDADDR[6]; /**< Local bluetooth adapter's BDADDR, valid when the stack is fully initialized. */ +			uint8_t LocalBDADDR[6]; /**< Local Bluetooth adapter's BDADDR, valid when the stack is fully initialized. */  		} Bluetooth_Stack_State_t;  	/* Includes: */ diff --git a/Demos/Host/Incomplete/BluetoothHost/Lib/RFCOMM.c b/Demos/Host/Incomplete/BluetoothHost/Lib/RFCOMM.c index 2d880771f..a441ae156 100644 --- a/Demos/Host/Incomplete/BluetoothHost/Lib/RFCOMM.c +++ b/Demos/Host/Incomplete/BluetoothHost/Lib/RFCOMM.c @@ -68,23 +68,56 @@ void RFCOMM_ProcessPacket(void* Data, Bluetooth_Channel_t* const Channel)  	switch (FrameHeader->FrameType & ~FRAME_POLL_FINAL)
  	{
  		case RFCOMM_Frame_SABM:
 -			BT_RFCOMM_DEBUG(1, "<< SABM Received");
 +			RFCOMM_ProcessSABM(FrameHeader, Channel);
  			break;
  		case RFCOMM_Frame_UA:
 -			BT_RFCOMM_DEBUG(1, "<< UA Received");
 +			RFCOMM_ProcessUA(FrameHeader, Channel);
  			break;
  		case RFCOMM_Frame_DM:
 -			BT_RFCOMM_DEBUG(1, "<< DM Received");
 +			RFCOMM_ProcessDM(FrameHeader, Channel);
  			break;
  		case RFCOMM_Frame_DISC:
 -			BT_RFCOMM_DEBUG(1, "<< DISC Received");
 +			RFCOMM_ProcessDISC(FrameHeader, Channel);
  			break;
  		case RFCOMM_Frame_UIH:
 -			BT_RFCOMM_DEBUG(1, "<< UIH Received");
 +			RFCOMM_ProcessUIH(FrameHeader, Channel);
  			break;
  	}
  }
 +static void RFCOMM_ProcessSABM(const RFCOMM_Header_t* const FrameHeader, Bluetooth_Channel_t* const Channel)
 +{
 +	uint8_t* CurrBufferPos = ((uint8_t*)FrameHeader + sizeof(RFCOMM_Header_t));
 +	uint16_t DataLen       = RFCOMM_GetFrameDataLength(&CurrBufferPos);
 +
 +	BT_RFCOMM_DEBUG(1, "<< SABM Received");
 +	BT_RFCOMM_DEBUG(2, "-- Data Length 0x%04X", DataLen);
 +
 +	for (uint16_t i = 0; i < DataLen; i++)
 +	  printf("0x%02X ", CurrBufferPos[i]);
 +	printf("\r\n");
 +}
 +
 +static void RFCOMM_ProcessUA(const RFCOMM_Header_t* const FrameHeader, Bluetooth_Channel_t* const Channel)
 +{
 +	BT_RFCOMM_DEBUG(1, "<< UA Received");
 +}
 +
 +static void RFCOMM_ProcessDM(const RFCOMM_Header_t* const FrameHeader, Bluetooth_Channel_t* const Channel)
 +{
 +	BT_RFCOMM_DEBUG(1, "<< DM Received");
 +}
 +
 +static void RFCOMM_ProcessDISC(const RFCOMM_Header_t* const FrameHeader, Bluetooth_Channel_t* const Channel)
 +{
 +	BT_RFCOMM_DEBUG(1, "<< DISC Received");
 +}
 +
 +static void RFCOMM_ProcessUIH(const RFCOMM_Header_t* const FrameHeader, Bluetooth_Channel_t* const Channel)
 +{
 +	BT_RFCOMM_DEBUG(1, "<< UIH Received");
 +}
 +
  static uint16_t RFCOMM_GetFrameDataLength(void** BufferPos)
  {
  	uint8_t FirstOctet = *((uint8_t*)*BufferPos);
 diff --git a/Demos/Host/Incomplete/BluetoothHost/Lib/RFCOMM.h b/Demos/Host/Incomplete/BluetoothHost/Lib/RFCOMM.h index ff04ed5a9..45f29ac21 100644 --- a/Demos/Host/Incomplete/BluetoothHost/Lib/RFCOMM.h +++ b/Demos/Host/Incomplete/BluetoothHost/Lib/RFCOMM.h @@ -55,6 +55,7 @@  		#define FRAME_POLL_FINAL                        (1 << 5)
  	/* Enums: */
 +		/** Enum for the types of RFCOMM frames which can be exchanged on a Bluetooth channel. */
  		enum RFCOMM_Frame_Types_t
  		{
  			RFCOMM_Frame_SABM  = 0x2F, /**< Set Asynchronous Balance Mode Field */
 @@ -70,7 +71,7 @@  			struct
  			{
  				unsigned char LogicalChannel   : 6;
 -				unsigned char CommandResponse  : 1;
 +				unsigned char PollResponse     : 1;
  				unsigned char LastAddressOctet : 1;
  			} Header;
 @@ -82,6 +83,12 @@  		void RFCOMM_ProcessPacket(void* Data, Bluetooth_Channel_t* const Channel);
  		#if defined(INCLUDE_FROM_RFCOMM_C)
 +			static void RFCOMM_ProcessSABM(const RFCOMM_Header_t* const FrameHeader, Bluetooth_Channel_t* const Channel);
 +			static void RFCOMM_ProcessUA(const RFCOMM_Header_t* const FrameHeader, Bluetooth_Channel_t* const Channel);
 +			static void RFCOMM_ProcessDM(const RFCOMM_Header_t* const FrameHeader, Bluetooth_Channel_t* const Channel);
 +			static void RFCOMM_ProcessDISC(const RFCOMM_Header_t* const FrameHeader, Bluetooth_Channel_t* const Channel);
 +			static void RFCOMM_ProcessUIH(const RFCOMM_Header_t* const FrameHeader, Bluetooth_Channel_t* const Channel);
 +
  			static uint16_t RFCOMM_GetFrameDataLength(void** BufferPos);
  		#endif
 diff --git a/Demos/Host/Incomplete/BluetoothHost/Lib/SDPServices.c b/Demos/Host/Incomplete/BluetoothHost/Lib/SDPServices.c index a06ebfede..ca47f9084 100644 --- a/Demos/Host/Incomplete/BluetoothHost/Lib/SDPServices.c +++ b/Demos/Host/Incomplete/BluetoothHost/Lib/SDPServices.c @@ -77,7 +77,7 @@ const struct  			(sizeof(ItemUUID_t) + sizeof(Item8Bit_t)),
  			{
  				{(SDP_DATATYPE_UUID | SDP_DATASIZE_128Bit), RFCOMM_UUID},
 -				{(SDP_DATATYPE_UnsignedInt | SDP_DATASIZE_8Bit), 0x03},
 +				{(SDP_DATATYPE_UnsignedInt | SDP_DATASIZE_8Bit), 0x00},
  			},
  		},
  	};
 diff --git a/Demos/Host/LowLevel/GenericHIDHost/ConfigDescriptor.h b/Demos/Host/LowLevel/GenericHIDHost/ConfigDescriptor.h index 8f98df1c7..3e25cd8f9 100644 --- a/Demos/Host/LowLevel/GenericHIDHost/ConfigDescriptor.h +++ b/Demos/Host/LowLevel/GenericHIDHost/ConfigDescriptor.h @@ -42,7 +42,7 @@  		#include "GenericHIDHost.h"  	/* Macros: */ -		/** Interface Class value for the Human Interface Device class */ +		/** Interface Class value for the Human Interface Device class. */  		#define HID_CLASS                   0x03  	/* Enums: */ diff --git a/Demos/Host/LowLevel/GenericHIDHost/GenericHIDHost.h b/Demos/Host/LowLevel/GenericHIDHost/GenericHIDHost.h index 493d4f4c4..8d0674eee 100644 --- a/Demos/Host/LowLevel/GenericHIDHost/GenericHIDHost.h +++ b/Demos/Host/LowLevel/GenericHIDHost/GenericHIDHost.h @@ -53,10 +53,10 @@  		#include "ConfigDescriptor.h"  	/* Macros: */ -		/** Pipe number for the HID data IN pipe */ +		/** Pipe number for the HID data IN pipe. */  		#define HID_DATA_IN_PIPE          1 -		/** Pipe number for the HID data OUT pipe */ +		/** Pipe number for the HID data OUT pipe. */  		#define HID_DATA_OUT_PIPE         2  		/** HID Class specific request to send a HID report to the device. */ diff --git a/Demos/Host/LowLevel/JoystickHostWithParser/ConfigDescriptor.h b/Demos/Host/LowLevel/JoystickHostWithParser/ConfigDescriptor.h index 6dad69067..d7badb821 100644 --- a/Demos/Host/LowLevel/JoystickHostWithParser/ConfigDescriptor.h +++ b/Demos/Host/LowLevel/JoystickHostWithParser/ConfigDescriptor.h @@ -42,16 +42,16 @@  		#include "HIDReport.h"  	/* Macros: */ -		/** Interface Class value for the Human Interface Device class */ +		/** Interface Class value for the Human Interface Device class. */  		#define JOYSTICK_CLASS              0x03 -		/** Interface Protocol value for a Boot Protocol Mouse compliant device */ +		/** Interface Protocol value for a Boot Protocol Mouse compliant device. */  		#define JOYSTICK_PROTOCOL           0x02 -		/** Descriptor header type constant for a HID descriptor */ +		/** Descriptor header type constant for a HID descriptor. */  		#define DTYPE_HID                   0x21 -		/** Descriptor header type constant for a HID report descriptor */ +		/** Descriptor header type constant for a HID report descriptor. */  		#define DTYPE_Report                0x22  	/* Enums: */ diff --git a/Demos/Host/LowLevel/JoystickHostWithParser/HIDReport.h b/Demos/Host/LowLevel/JoystickHostWithParser/HIDReport.h index 8fb0456ea..2e6c6f6a7 100644 --- a/Demos/Host/LowLevel/JoystickHostWithParser/HIDReport.h +++ b/Demos/Host/LowLevel/JoystickHostWithParser/HIDReport.h @@ -43,19 +43,19 @@  		#include "JoystickHostWithParser.h"  	/* Macros: */ -		/** HID Report Descriptor Usage for a Joystick */ +		/** HID Report Descriptor Usage for a Joystick. */  		#define USAGE_JOYSTICK              0x04 -		/** HID Report Descriptor Usage Page value for a toggle button */ +		/** HID Report Descriptor Usage Page value for a toggle button. */  		#define USAGE_PAGE_BUTTON           0x09 -		/** HID Report Descriptor Usage Page value for a Generic Desktop Control */ +		/** HID Report Descriptor Usage Page value for a Generic Desktop Control. */  		#define USAGE_PAGE_GENERIC_DCTRL    0x01 -		/** HID Report Descriptor Usage value for a X axis movement */ +		/** HID Report Descriptor Usage value for a X axis movement. */  		#define USAGE_X                     0x30 -		/** HID Report Descriptor Usage value for a Y axis movement */ +		/** HID Report Descriptor Usage value for a Y axis movement. */  		#define USAGE_Y                     0x31  	/* Enums: */ diff --git a/Demos/Host/LowLevel/JoystickHostWithParser/JoystickHostWithParser.h b/Demos/Host/LowLevel/JoystickHostWithParser/JoystickHostWithParser.h index c37cf3f05..cf6369b9b 100644 --- a/Demos/Host/LowLevel/JoystickHostWithParser/JoystickHostWithParser.h +++ b/Demos/Host/LowLevel/JoystickHostWithParser/JoystickHostWithParser.h @@ -54,7 +54,7 @@  		#include "HIDReport.h"  	/* Macros: */ -		/** Pipe number for the joystick report data pipe */ +		/** Pipe number for the joystick report data pipe. */  		#define JOYSTICK_DATAPIPE         1  		/** LED mask for the library LED driver, to indicate that the USB interface is not ready. */ diff --git a/Demos/Host/LowLevel/KeyboardHost/ConfigDescriptor.h b/Demos/Host/LowLevel/KeyboardHost/ConfigDescriptor.h index 6b0bf65ec..295e07341 100644 --- a/Demos/Host/LowLevel/KeyboardHost/ConfigDescriptor.h +++ b/Demos/Host/LowLevel/KeyboardHost/ConfigDescriptor.h @@ -42,10 +42,10 @@  		#include "KeyboardHost.h"  	/* Macros: */ -		/** Interface Class value for the Human Interface Device class */ +		/** Interface Class value for the Human Interface Device class. */  		#define KEYBOARD_CLASS                 0x03 -		/** Interface Protocol value for a Boot Protocol Keyboard compliant device */ +		/** Interface Protocol value for a Boot Protocol Keyboard compliant device. */  		#define KEYBOARD_PROTOCOL              0x01  	/* Enums: */ diff --git a/Demos/Host/LowLevel/KeyboardHost/KeyboardHost.h b/Demos/Host/LowLevel/KeyboardHost/KeyboardHost.h index 1cdb9bc68..dc09f84c9 100644 --- a/Demos/Host/LowLevel/KeyboardHost/KeyboardHost.h +++ b/Demos/Host/LowLevel/KeyboardHost/KeyboardHost.h @@ -53,10 +53,10 @@  		#include "ConfigDescriptor.h"  	/* Macros: */ -		/** Pipe number for the keyboard data IN pipe */ +		/** Pipe number for the keyboard data IN pipe. */  		#define KEYBOARD_DATAPIPE           1 -		/** HID Class Specific request to set the report protocol mode */ +		/** HID Class Specific request to set the report protocol mode. */  		#define REQ_SetProtocol             0x0B  		/** LED mask for the library LED driver, to indicate that the USB interface is not ready. */ @@ -72,7 +72,7 @@  		#define LEDMASK_USB_ERROR        (LEDS_LED1 | LEDS_LED3)  	/* Type Defines: */ -		/** Type define for a standard Boot Protocol Keyboard report */ +		/** Type define for a standard Boot Protocol Keyboard report. */  		typedef struct  		{  			uint8_t Modifier; /**< Keyboard modifier byte, indicating pressed modifier keys (such as Shift, Control, etc.) */ diff --git a/Demos/Host/LowLevel/KeyboardHostWithParser/ConfigDescriptor.h b/Demos/Host/LowLevel/KeyboardHostWithParser/ConfigDescriptor.h index 854c14b63..d0509349c 100644 --- a/Demos/Host/LowLevel/KeyboardHostWithParser/ConfigDescriptor.h +++ b/Demos/Host/LowLevel/KeyboardHostWithParser/ConfigDescriptor.h @@ -42,16 +42,16 @@  		#include "HIDReport.h"  	/* Macros: */ -		/** Interface Class value for the Human Interface Device class */ +		/** Interface Class value for the Human Interface Device class. */  		#define KEYBOARD_CLASS                 0x03 -		/** Interface Protocol value for a Boot Protocol Keyboard compliant device */ +		/** Interface Protocol value for a Boot Protocol Keyboard compliant device. */  		#define KEYBOARD_PROTOCOL              0x01 -		/** Descriptor header type constant for a HID descriptor */ +		/** Descriptor header type constant for a HID descriptor. */  		#define DTYPE_HID                      0x21 -		/** Descriptor header type constant for a HID report descriptor */ +		/** Descriptor header type constant for a HID report descriptor. */  		#define DTYPE_Report                   0x22  	/* Enums: */ diff --git a/Demos/Host/LowLevel/KeyboardHostWithParser/HIDReport.h b/Demos/Host/LowLevel/KeyboardHostWithParser/HIDReport.h index 1ccf9fcf9..b405e09b1 100644 --- a/Demos/Host/LowLevel/KeyboardHostWithParser/HIDReport.h +++ b/Demos/Host/LowLevel/KeyboardHostWithParser/HIDReport.h @@ -43,7 +43,7 @@  		#include "KeyboardHostWithParser.h"  	/* Macros: */ -		/** HID Report Descriptor Usage Page value for a desktop keyboard */ +		/** HID Report Descriptor Usage Page value for a desktop keyboard. */  		#define USAGE_PAGE_KEYBOARD             0x07  	/* Enums: */ diff --git a/Demos/Host/LowLevel/KeyboardHostWithParser/KeyboardHostWithParser.h b/Demos/Host/LowLevel/KeyboardHostWithParser/KeyboardHostWithParser.h index bfe95b778..500b7cb2c 100644 --- a/Demos/Host/LowLevel/KeyboardHostWithParser/KeyboardHostWithParser.h +++ b/Demos/Host/LowLevel/KeyboardHostWithParser/KeyboardHostWithParser.h @@ -49,7 +49,7 @@  		#include "HIDReport.h"  	/* Macros: */ -		/** Pipe number for the keyboard report data pipe */ +		/** Pipe number for the keyboard report data pipe. */  		#define KEYBOARD_DATAPIPE         1  		/** LED mask for the library LED driver, to indicate that the USB interface is not ready. */ diff --git a/Demos/Host/LowLevel/MIDIHost/ConfigDescriptor.h b/Demos/Host/LowLevel/MIDIHost/ConfigDescriptor.h index 933df79d9..af6d866e5 100644 --- a/Demos/Host/LowLevel/MIDIHost/ConfigDescriptor.h +++ b/Demos/Host/LowLevel/MIDIHost/ConfigDescriptor.h @@ -42,13 +42,13 @@  		#include "MIDIHost.h"  	/* Macros: */ -		/** Interface Class value for the MIDI Audio class */ +		/** Interface Class value for the MIDI Audio class. */  		#define MIDI_STREAMING_CLASS           0x01 -		/** Interface Class value for the MIDI Audio Streaming subclass */ +		/** Interface Class value for the MIDI Audio Streaming subclass. */  		#define MIDI_STREAMING_SUBCLASS        0x03 -		/** Interface Class value for the MIDI Audio Streaming protocol */ +		/** Interface Class value for the MIDI Audio Streaming protocol. */  		#define MIDI_STREAMING_PROTOCOL        0x00  	/* Enums: */ diff --git a/Demos/Host/LowLevel/MIDIHost/MIDIHost.h b/Demos/Host/LowLevel/MIDIHost/MIDIHost.h index 2be4d4efb..1338f6516 100644 --- a/Demos/Host/LowLevel/MIDIHost/MIDIHost.h +++ b/Demos/Host/LowLevel/MIDIHost/MIDIHost.h @@ -55,13 +55,13 @@  		#include "ConfigDescriptor.h"  	/* Macros: */ -		/** MIDI command for a note on (activation) event */ +		/** MIDI command for a note on (activation) event. */  		#define MIDI_COMMAND_NOTE_ON      0x90 -		/** MIDI command for a note off (deactivation) event */ +		/** MIDI command for a note off (deactivation) event. */  		#define MIDI_COMMAND_NOTE_OFF     0x80 -		/** Standard key press velocity value used for all note events, as no pressure sensor is mounted */ +		/** Standard key press velocity value used for all note events, as no pressure sensor is mounted. */  		#define MIDI_STANDARD_VELOCITY    64  		/** Convenience macro. MIDI channels are numbered from 1-10 (natural numbers) however the logical channel @@ -71,10 +71,10 @@  		 */  		#define MIDI_CHANNEL(channel)     (channel - 1) -		/** Pipe number for the MIDI data IN pipe */ +		/** Pipe number for the MIDI data IN pipe. */  		#define MIDI_DATAPIPE_IN          1 -		/** Pipe number for the MIDI data OUT pipe */ +		/** Pipe number for the MIDI data OUT pipe. */  		#define MIDI_DATAPIPE_OUT         2  		/** LED mask for the library LED driver, to indicate that the USB interface is not ready. */ diff --git a/Demos/Host/LowLevel/MassStorageHost/ConfigDescriptor.h b/Demos/Host/LowLevel/MassStorageHost/ConfigDescriptor.h index 1719a280d..d5a5cd9b1 100644 --- a/Demos/Host/LowLevel/MassStorageHost/ConfigDescriptor.h +++ b/Demos/Host/LowLevel/MassStorageHost/ConfigDescriptor.h @@ -42,13 +42,13 @@  		#include "MassStorageHost.h"  	/* Macros: */ -		/** Interface Class value for the Mass Storage Device class */ +		/** Interface Class value for the Mass Storage Device class. */  		#define MASS_STORE_CLASS               0x08 -		/** Interface Class value for the Mass Storage Device subclass */ +		/** Interface Class value for the Mass Storage Device subclass. */  		#define MASS_STORE_SUBCLASS            0x06 -		/** Interface Protocol value for the Bulk Only transport protocol */ +		/** Interface Protocol value for the Bulk Only transport protocol. */  		#define MASS_STORE_PROTOCOL            0x50  	/* Enums: */ diff --git a/Demos/Host/LowLevel/MassStorageHost/Lib/MassStoreCommands.h b/Demos/Host/LowLevel/MassStorageHost/Lib/MassStoreCommands.h index 546460607..baa36dabc 100644 --- a/Demos/Host/LowLevel/MassStorageHost/Lib/MassStoreCommands.h +++ b/Demos/Host/LowLevel/MassStorageHost/Lib/MassStoreCommands.h @@ -45,34 +45,34 @@  		#include <LUFA/Drivers/USB/USB.h>  	/* Macros: */ -		/** Class specific request to reset the Mass Storage interface of the attached device */ +		/** Class specific request to reset the Mass Storage interface of the attached device. */  		#define REQ_MassStorageReset                0xFF -		/** Class specific request to retrieve the maximum Logical Unit Number (LUN) index of the attached device */ +		/** Class specific request to retrieve the maximum Logical Unit Number (LUN) index of the attached device. */  		#define REQ_GetMaxLUN                       0xFE -		/** Command Block Wrapper signature byte, for verification of valid CBW blocks */ +		/** Command Block Wrapper signature byte, for verification of valid CBW blocks. */  		#define CBW_SIGNATURE                       0x43425355UL -		/** Command Static Wrapper signature byte, for verification of valid CSW blocks */ +		/** Command Static Wrapper signature byte, for verification of valid CSW blocks. */  		#define CSW_SIGNATURE                       0x53425355UL -		/** Data direction mask for the Flags field of a CBW, indicating Host-to-Device transfer direction */ +		/** Data direction mask for the Flags field of a CBW, indicating Host-to-Device transfer direction. */  		#define COMMAND_DIRECTION_DATA_OUT          (0 << 7) -		/** Data direction mask for the Flags field of a CBW, indicating Device-to-Host transfer direction */ +		/** Data direction mask for the Flags field of a CBW, indicating Device-to-Host transfer direction. */  		#define COMMAND_DIRECTION_DATA_IN           (1 << 7) -		/** Timeout period between the issuing of a CBW to a device, and the reception of the first packet */ +		/** Timeout period between the issuing of a CBW to a device, and the reception of the first packet. */  		#define COMMAND_DATA_TIMEOUT_MS             10000 -		/** Pipe number of the Mass Storage data IN pipe */ +		/** Pipe number of the Mass Storage data IN pipe. */  		#define MASS_STORE_DATA_IN_PIPE             1 -		/** Pipe number of the Mass Storage data OUT pipe */ +		/** Pipe number of the Mass Storage data OUT pipe. */  		#define MASS_STORE_DATA_OUT_PIPE            2 -		/** Additional error code for Mass Storage functions when a device returns a logical command failure */ +		/** Additional error code for Mass Storage functions when a device returns a logical command failure. */  		#define MASS_STORE_SCSI_COMMAND_FAILED      0xC0  	/* Type defines: */ @@ -175,7 +175,7 @@  		} SCSI_Capacity_t;  	/* Enums: */ -		/** CSW status return codes, indicating the overall status of the issued CBW */ +		/** CSW status return codes, indicating the overall status of the issued CBW. */  		enum MassStorageHost_CommandStatusCodes_t  		{  			Command_Pass = 0, /**< Command completed successfully */ diff --git a/Demos/Host/LowLevel/MouseHost/ConfigDescriptor.h b/Demos/Host/LowLevel/MouseHost/ConfigDescriptor.h index 698bdbd33..1e7c203aa 100644 --- a/Demos/Host/LowLevel/MouseHost/ConfigDescriptor.h +++ b/Demos/Host/LowLevel/MouseHost/ConfigDescriptor.h @@ -42,10 +42,10 @@  		#include "MouseHost.h"  	/* Macros: */ -		/** Interface Class value for the Human Interface Device class */ +		/** Interface Class value for the Human Interface Device class. */  		#define MOUSE_CLASS                 0x03 -		/** Interface Protocol value for a Boot Protocol Mouse compliant device */ +		/** Interface Protocol value for a Boot Protocol Mouse compliant device. */  		#define MOUSE_PROTOCOL              0x02  	/* Enums: */ diff --git a/Demos/Host/LowLevel/MouseHost/MouseHost.h b/Demos/Host/LowLevel/MouseHost/MouseHost.h index 4bb8791dc..f196dadcb 100644 --- a/Demos/Host/LowLevel/MouseHost/MouseHost.h +++ b/Demos/Host/LowLevel/MouseHost/MouseHost.h @@ -53,10 +53,10 @@  		#include "ConfigDescriptor.h"  	/* Macros: */ -		/** Pipe number for the mouse data IN pipe */ +		/** Pipe number for the mouse data IN pipe. */  		#define MOUSE_DATAPIPE            1 -		/** HID Class Specific request to set the report protocol mode */ +		/** HID Class Specific request to set the report protocol mode. */  		#define REQ_SetProtocol           0x0B  		/** LED mask for the library LED driver, to indicate that the USB interface is not ready. */ @@ -72,7 +72,7 @@  		#define LEDMASK_USB_ERROR        (LEDS_LED1 | LEDS_LED3)  	/* Type Defines: */ -		/** Type define for a standard Boot Protocol Mouse report */ +		/** Type define for a standard Boot Protocol Mouse report. */  		typedef struct  		{  			uint8_t Button; /**< Button mask for currently pressed buttons in the mouse */ diff --git a/Demos/Host/LowLevel/MouseHostWithParser/ConfigDescriptor.h b/Demos/Host/LowLevel/MouseHostWithParser/ConfigDescriptor.h index a4ed974ec..d659e577d 100644 --- a/Demos/Host/LowLevel/MouseHostWithParser/ConfigDescriptor.h +++ b/Demos/Host/LowLevel/MouseHostWithParser/ConfigDescriptor.h @@ -42,16 +42,16 @@  		#include "HIDReport.h"  	/* Macros: */ -		/** Interface Class value for the Human Interface Device class */ +		/** Interface Class value for the Human Interface Device class. */  		#define MOUSE_CLASS                 0x03 -		/** Interface Protocol value for a Boot Protocol Mouse compliant device */ +		/** Interface Protocol value for a Boot Protocol Mouse compliant device. */  		#define MOUSE_PROTOCOL              0x02 -		/** Descriptor header type constant for a HID descriptor */ +		/** Descriptor header type constant for a HID descriptor. */  		#define DTYPE_HID                   0x21 -		/** Descriptor header type constant for a HID report descriptor */ +		/** Descriptor header type constant for a HID report descriptor. */  		#define DTYPE_Report                0x22  	/* Enums: */ diff --git a/Demos/Host/LowLevel/MouseHostWithParser/HIDReport.h b/Demos/Host/LowLevel/MouseHostWithParser/HIDReport.h index d471c5dc6..50b62e009 100644 --- a/Demos/Host/LowLevel/MouseHostWithParser/HIDReport.h +++ b/Demos/Host/LowLevel/MouseHostWithParser/HIDReport.h @@ -43,22 +43,22 @@  		#include "MouseHostWithParser.h"  	/* Macros: */ -		/** HID Report Descriptor Usage for a Mouse */ +		/** HID Report Descriptor Usage for a Mouse. */  		#define USAGE_MOUSE                 0x02 -		/** HID Report Descriptor Usage Page value for a toggle button */ +		/** HID Report Descriptor Usage Page value for a toggle button. */  		#define USAGE_PAGE_BUTTON           0x09 -		/** HID Report Descriptor Usage Page value for a Generic Desktop Control */ +		/** HID Report Descriptor Usage Page value for a Generic Desktop Control. */  		#define USAGE_PAGE_GENERIC_DCTRL    0x01 -		/** HID Report Descriptor Usage value for a X axis movement */ +		/** HID Report Descriptor Usage value for a X axis movement. */  		#define USAGE_X                     0x30 -		/** HID Report Descriptor Usage value for a Y axis movement */ +		/** HID Report Descriptor Usage value for a Y axis movement. */  		#define USAGE_Y                     0x31 -		/** HID Report Descriptor Usage value for a Scroll Wheel movement */ +		/** HID Report Descriptor Usage value for a Scroll Wheel movement. */  		#define USAGE_SCROLL_WHEEL          0x38  	/* Enums: */ diff --git a/Demos/Host/LowLevel/MouseHostWithParser/MouseHostWithParser.h b/Demos/Host/LowLevel/MouseHostWithParser/MouseHostWithParser.h index bcfa8884f..2c11f110c 100644 --- a/Demos/Host/LowLevel/MouseHostWithParser/MouseHostWithParser.h +++ b/Demos/Host/LowLevel/MouseHostWithParser/MouseHostWithParser.h @@ -54,7 +54,7 @@  		#include "HIDReport.h"  	/* Macros: */ -		/** Pipe number for the mouse report data pipe */ +		/** Pipe number for the mouse report data pipe. */  		#define MOUSE_DATAPIPE            1  		/** LED mask for the library LED driver, to indicate that the USB interface is not ready. */ diff --git a/Demos/Host/LowLevel/PrinterHost/ConfigDescriptor.h b/Demos/Host/LowLevel/PrinterHost/ConfigDescriptor.h index b28a3379f..fdb9682c3 100644 --- a/Demos/Host/LowLevel/PrinterHost/ConfigDescriptor.h +++ b/Demos/Host/LowLevel/PrinterHost/ConfigDescriptor.h @@ -38,13 +38,13 @@  		#include "Lib/PrinterCommands.h"  	/* Macros: */ -		/** Interface Class value for the Printer Device class */ +		/** Interface Class value for the Printer Device class. */  		#define PRINTER_CLASS                    0x07 -		/** Interface Subclass value for the Printer Device class */ +		/** Interface Subclass value for the Printer Device class. */  		#define PRINTER_SUBCLASS                 0x01 -		/** Interface Protocol value for a Bidirectional communication encapsulation */ +		/** Interface Protocol value for a Bidirectional communication encapsulation. */  		#define PRINTER_PROTOCOL                 0x02  	/* Enums: */ diff --git a/Demos/Host/LowLevel/PrinterHost/Lib/PrinterCommands.h b/Demos/Host/LowLevel/PrinterHost/Lib/PrinterCommands.h index d908aae6c..cbc54564c 100644 --- a/Demos/Host/LowLevel/PrinterHost/Lib/PrinterCommands.h +++ b/Demos/Host/LowLevel/PrinterHost/Lib/PrinterCommands.h @@ -43,19 +43,19 @@  		#include <LUFA/Drivers/USB/USB.h>  	/* Macros: */ -		/** Printer class-specific request to retrieve the printer's ID string */ +		/** Printer class-specific request to retrieve the printer's ID string. */  		#define REQ_GetDeviceID              0 -		/** Printer class-specific request to retrieve the printer's virtual port status flags */ +		/** Printer class-specific request to retrieve the printer's virtual port status flags. */  		#define REQ_GetPortStatus            1 -		/** Printer class-specific request to soft-reset the device */ +		/** Printer class-specific request to soft-reset the device. */  		#define REQ_SoftReset                2 -		/** Pipe number of the Printer data IN pipe */ +		/** Pipe number of the Printer data IN pipe. */  		#define PRINTER_DATA_IN_PIPE         1 -		/** Pipe number of the Printer data OUT pipe */ +		/** Pipe number of the Printer data OUT pipe. */  		#define PRINTER_DATA_OUT_PIPE        2  	/* Function Prototypes: */ diff --git a/Demos/Host/LowLevel/RNDISEthernetHost/ConfigDescriptor.h b/Demos/Host/LowLevel/RNDISEthernetHost/ConfigDescriptor.h index 02bfca2c0..149d81bf7 100644 --- a/Demos/Host/LowLevel/RNDISEthernetHost/ConfigDescriptor.h +++ b/Demos/Host/LowLevel/RNDISEthernetHost/ConfigDescriptor.h @@ -42,22 +42,22 @@  		#include "RNDISEthernetHost.h"  	/* Macros: */ -		/** Interface Class value for the CDC class */ +		/** Interface Class value for the CDC class. */  		#define CDC_CONTROL_CLASS              0x02 -		/** Interface Class value for the CDC Communication Interface subclass */ +		/** Interface Class value for the CDC Communication Interface subclass. */  		#define CDC_CONTROL_SUBCLASS           0x02 -		/** Interface Class value for the CDC RNDIS vendor specific protocol */ +		/** Interface Class value for the CDC RNDIS vendor specific protocol. */  		#define CDC_CONTROL_PROTOCOL           0xFF -		/** Interface Class value for the CDC data class */ +		/** Interface Class value for the CDC data class. */  		#define CDC_DATA_CLASS                 0x0A -		/** Interface Class value for the CDC data subclass */ +		/** Interface Class value for the CDC data subclass. */  		#define CDC_DATA_SUBCLASS              0x00 -		/** Interface Class value for the CDC data protocol */ +		/** Interface Class value for the CDC data protocol. */  		#define CDC_DATA_PROTOCOL              0x00  	/* Enums: */ diff --git a/Demos/Host/LowLevel/RNDISEthernetHost/Lib/RNDISCommands.h b/Demos/Host/LowLevel/RNDISEthernetHost/Lib/RNDISCommands.h index 62d1c0893..a2f15c5a7 100644 --- a/Demos/Host/LowLevel/RNDISEthernetHost/Lib/RNDISCommands.h +++ b/Demos/Host/LowLevel/RNDISEthernetHost/Lib/RNDISCommands.h @@ -46,14 +46,14 @@  		#include "RNDISConstants.h"  	/* Type Defines: */ -		/** Type define for a RNDIS message header, sent before RNDIS messages */ +		/** 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; -		/** Type define for a RNDIS packet message, used to encapsulate Ethernet packets sent to and from the adapter */ +		/** Type define for a RNDIS packet message, used to encapsulate Ethernet packets sent to and from the adapter. */  		typedef struct  		{  			uint32_t MessageType; @@ -69,7 +69,7 @@  			uint32_t Reserved;  		} RNDIS_Packet_Message_t; -		/** Type define for a RNDIS Initialize command message */ +		/** Type define for a RNDIS Initialize command message. */  		typedef struct  		{  			uint32_t MessageType; @@ -81,7 +81,7 @@  			uint32_t MaxTransferSize;  		} RNDIS_Initialize_Message_t; -		/** Type define for a RNDIS Initialize complete response message */ +		/** Type define for a RNDIS Initialize complete response message. */  		typedef struct  		{  			uint32_t MessageType; @@ -100,7 +100,7 @@  			uint32_t AFListSize;  		} RNDIS_Initialize_Complete_t; -		/** Type define for a RNDIS Keepalive command message */ +		/** Type define for a RNDIS Keepalive command message. */  		typedef struct  		{  			uint32_t MessageType; @@ -108,7 +108,7 @@  			uint32_t RequestId;  		} RNDIS_KeepAlive_Message_t; -		/** Type define for a RNDIS Keepalive complete message */ +		/** Type define for a RNDIS Keepalive complete message. */  		typedef struct  		{  			uint32_t MessageType; @@ -117,7 +117,7 @@  			uint32_t Status;  		} RNDIS_KeepAlive_Complete_t; -		/** Type define for a RNDIS Reset complete message */ +		/** Type define for a RNDIS Reset complete message. */  		typedef struct  		{  			uint32_t MessageType; @@ -127,7 +127,7 @@  			uint32_t AddressingReset;  		} RNDIS_Reset_Complete_t; -		/** Type define for a RNDIS Set command message */ +		/** Type define for a RNDIS Set command message. */  		typedef struct  		{  			uint32_t MessageType; @@ -140,7 +140,7 @@  			uint32_t DeviceVcHandle;  		} RNDIS_Set_Message_t; -		/** Type define for a RNDIS Set complete response message */ +		/** Type define for a RNDIS Set complete response message. */  		typedef struct  		{  			uint32_t MessageType; @@ -149,7 +149,7 @@  			uint32_t Status;  		} RNDIS_Set_Complete_t; -		/** Type define for a RNDIS Query command message */ +		/** Type define for a RNDIS Query command message. */  		typedef struct  		{  			uint32_t MessageType; @@ -162,7 +162,7 @@  			uint32_t DeviceVcHandle;  		} RNDIS_Query_Message_t; -		/** Type define for a RNDIS Query complete response message */ +		/** Type define for a RNDIS Query complete response message. */  		typedef struct  		{  			uint32_t MessageType; @@ -175,28 +175,28 @@  		} RNDIS_Query_Complete_t;  	/* Macros: */ -		/** RNDIS request to issue a host-to-device NDIS command */ +		/** RNDIS request to issue a host-to-device NDIS command. */  		#define REQ_SendEncapsulatedCommand           0x00 -		/** RNDIS request to issue a device-to-host NDIS response */ +		/** RNDIS request to issue a device-to-host NDIS response. */  		#define REQ_GetEncapsulatedResponse           0x01 -		/** Implemented RNDIS Version Major */ +		/** Implemented RNDIS Version Major. */  		#define REMOTE_NDIS_VERSION_MAJOR             0x01 -		/** Implemented RNDIS Version Minor */ +		/** Implemented RNDIS Version Minor. */  		#define REMOTE_NDIS_VERSION_MINOR             0x00 -		/** Pipe number for the RNDIS data IN pipe */ +		/** Pipe number for the RNDIS data IN pipe. */  		#define RNDIS_DATAPIPE_IN                     1 -		/** Pipe number for the RNDIS data OUT pipe */ +		/** Pipe number for the RNDIS data OUT pipe. */  		#define RNDIS_DATAPIPE_OUT                    2 -		/** Pipe number for the RNDIS notification pipe */ +		/** Pipe number for the RNDIS notification pipe. */  		#define RNDIS_NOTIFICATIONPIPE                3 -		/** Additional error code for RNDIS functions when a device returns a logical command failure */ +		/** Additional error code for RNDIS functions when a device returns a logical command failure. */  		#define RNDIS_COMMAND_FAILED                  0xC0  	/* Function Prototypes: */ diff --git a/Demos/Host/LowLevel/StillImageHost/ConfigDescriptor.h b/Demos/Host/LowLevel/StillImageHost/ConfigDescriptor.h index 351b82583..66f9bfead 100644 --- a/Demos/Host/LowLevel/StillImageHost/ConfigDescriptor.h +++ b/Demos/Host/LowLevel/StillImageHost/ConfigDescriptor.h @@ -42,13 +42,13 @@  		#include "StillImageHost.h"  	/* Macros: */ -		/** Interface Class value for the Still Image Device class */ +		/** Interface Class value for the Still Image Device class. */  		#define SIMAGE_CLASS                   0x06 -		/** Interface Class value for the Still Image Device subclass */ +		/** Interface Class value for the Still Image Device subclass. */  		#define SIMAGE_SUBCLASS                0x01 -		/** Interface Class value for the Still Image Device protocol */ +		/** Interface Class value for the Still Image Device protocol. */  		#define SIMAGE_PROTOCOL                0x01  	/* Enums: */ diff --git a/Demos/Host/LowLevel/StillImageHost/Lib/StillImageCommands.h b/Demos/Host/LowLevel/StillImageHost/Lib/StillImageCommands.h index f309abf1b..a57ddaf2c 100644 --- a/Demos/Host/LowLevel/StillImageHost/Lib/StillImageCommands.h +++ b/Demos/Host/LowLevel/StillImageHost/Lib/StillImageCommands.h @@ -42,22 +42,22 @@  		#include "PIMACodes.h"  	/* Macros: */ -		/** Pipe number of the Still Image data IN pipe */ +		/** Pipe number of the Still Image data IN pipe. */  		#define SIMAGE_DATA_IN_PIPE            0x01 -		/** Pipe number of the Still Image data OUT pipe */ +		/** Pipe number of the Still Image data OUT pipe. */  		#define SIMAGE_DATA_OUT_PIPE           0x02 -		/** Pipe number of the Still Image events pipe */ +		/** Pipe number of the Still Image events pipe. */  		#define SIMAGE_EVENTS_PIPE             0x03 -		/** Length in bytes of a given Unicode string's character length +		/** Length in bytes of a given Unicode string's character length.  		 *  		 *  \param[in] chars  Total number of Unicode characters in the string  		 */  		#define UNICODE_STRING_LENGTH(chars)   ((chars) << 1) -		/** Timeout period between the issuing of a command to a device, and the reception of the first packet */ +		/** Timeout period between the issuing of a command to a device, and the reception of the first packet. */  		#define COMMAND_DATA_TIMEOUT_MS        10000  		/** Used in the DataLength field of a PIMA container, to give the total container size in bytes for diff --git a/Demos/Host/LowLevel/VirtualSerialHost/ConfigDescriptor.h b/Demos/Host/LowLevel/VirtualSerialHost/ConfigDescriptor.h index 29b94edce..8eae0e3fe 100644 --- a/Demos/Host/LowLevel/VirtualSerialHost/ConfigDescriptor.h +++ b/Demos/Host/LowLevel/VirtualSerialHost/ConfigDescriptor.h @@ -42,22 +42,22 @@  		#include "VirtualSerialHost.h"  	/* Macros: */ -		/** Interface Class value for the CDC class */ +		/** Interface Class value for the CDC class. */  		#define CDC_CONTROL_CLASS              0x02 -		/** Interface Class value for the CDC Communication Interface subclass */ +		/** Interface Class value for the CDC Communication Interface subclass. */  		#define CDC_CONTROL_SUBCLASS           0x02 -		/** Interface Class value for the CDC protocol */ +		/** Interface Class value for the CDC protocol. */  		#define CDC_CONTROL_PROTOCOL           0x01 -		/** Interface Class value for the CDC data class */ +		/** Interface Class value for the CDC data class. */  		#define CDC_DATA_CLASS                 0x0A -		/** Interface Class value for the CDC data subclass */ +		/** Interface Class value for the CDC data subclass. */  		#define CDC_DATA_SUBCLASS              0x00 -		/** Interface Class value for the CDC data protocol */ +		/** Interface Class value for the CDC data protocol. */  		#define CDC_DATA_PROTOCOL              0x00  	/* Enums: */ diff --git a/Demos/Host/LowLevel/VirtualSerialHost/VirtualSerialHost.h b/Demos/Host/LowLevel/VirtualSerialHost/VirtualSerialHost.h index eceb0d670..4227b5383 100644 --- a/Demos/Host/LowLevel/VirtualSerialHost/VirtualSerialHost.h +++ b/Demos/Host/LowLevel/VirtualSerialHost/VirtualSerialHost.h @@ -53,13 +53,13 @@  		#include "ConfigDescriptor.h"  	/* Macros: */ -		/** Pipe number for the CDC data IN pipe */ +		/** Pipe number for the CDC data IN pipe. */  		#define CDC_DATAPIPE_IN           1 -		/** Pipe number for the CDC data OUT pipe */ +		/** Pipe number for the CDC data OUT pipe. */  		#define CDC_DATAPIPE_OUT          2 -		/** Pipe number for the CDC notification pipe */ +		/** Pipe number for the CDC notification pipe. */  		#define CDC_NOTIFICATIONPIPE      3  		/** LED mask for the library LED driver, to indicate that the USB interface is not ready. */  | 
