Moved PrinterHost demo from Incomplete to LowLevel, as it is now near-complete.

7 files changed, 1497 insertions, 0 deletions

diff --git a/Demos/Host/LowLevel/PrinterHost/ConfigDescriptor.c b/Demos/Host/LowLevel/PrinterHost/ConfigDescriptor.c
new file mode 100644
index 000000000..d4eaff94a
--- /dev/null
+++ b/Demos/Host/LowLevel/PrinterHost/ConfigDescriptor.c
@@ -0,0 +1,152 @@
+/*

+             LUFA Library

+     Copyright (C) Dean Camera, 2009.

+              

+  dean [at] fourwalledcubicle [dot] com

+      www.fourwalledcubicle.com

+*/

+

+/*

+  Copyright 2009  Dean Camera (dean [at] fourwalledcubicle [dot] com)

+

+  Permission to use, copy, modify, and distribute this software

+  and its documentation for any purpose and without fee is hereby

+  granted, 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.

+*/

+

+#include "ConfigDescriptor.h"

+

+uint8_t PrinterInterfaceNumber;

+uint8_t PrinterAltSetting;

+

+

+uint8_t ProcessConfigurationDescriptor(void)

+{

+	uint8_t* ConfigDescriptorData;

+	uint16_t ConfigDescriptorSize;

+	uint8_t  ErrorCode;

+	uint8_t  FoundEndpoints = 0;

+	

+	/* Get Configuration Descriptor size from the device */

+	if (USB_GetDeviceConfigDescriptor(1, &ConfigDescriptorSize, NULL) != HOST_SENDCONTROL_Successful)

+	  return ControlError;

+	

+	/* Ensure that the Configuration Descriptor isn't too large */

+	if (ConfigDescriptorSize > MAX_CONFIG_DESCRIPTOR_SIZE)

+	  return DescriptorTooLarge;

+	  

+	/* Allocate enough memory for the entire config descriptor */

+	ConfigDescriptorData = alloca(ConfigDescriptorSize);

+

+	/* Retrieve the entire configuration descriptor into the allocated buffer */

+	USB_GetDeviceConfigDescriptor(1, &ConfigDescriptorSize, ConfigDescriptorData);

+	

+	/* Validate returned data - ensure first entry is a configuration header descriptor */

+	if (DESCRIPTOR_TYPE(ConfigDescriptorData) != DTYPE_Configuration)

+	  return InvalidConfigDataReturned;

+	

+	/* Get the printer interface from the configuration descriptor */

+	if ((ErrorCode = USB_GetNextDescriptorComp(&ConfigDescriptorSize, &ConfigDescriptorData,

+	                                           DComp_NextBidirectionalPrinterInterface)))

+	{

+		/* Descriptor not found, error out */

+		return NoInterfaceFound;

+	}

+	

+	PrinterInterfaceNumber = DESCRIPTOR_CAST(ConfigDescriptorData, USB_Descriptor_Interface_t).InterfaceNumber;

+	PrinterAltSetting      = DESCRIPTOR_CAST(ConfigDescriptorData, USB_Descriptor_Interface_t).AlternateSetting;

+

+	/* Get the IN and OUT data endpoints for the printer interface */

+	while (FoundEndpoints != ((1 << PRINTER_DATA_OUT_PIPE) | (1 << PRINTER_DATA_IN_PIPE)))

+	{

+		/* Fetch the next bulk endpoint from the current printer interface */

+		if ((ErrorCode = USB_GetNextDescriptorComp(&ConfigDescriptorSize, &ConfigDescriptorData,

+		                                           DComp_NextInterfaceBulkDataEndpoint)))

+		{

+			/* Descriptor not found, error out */

+			return NoEndpointFound;

+		}

+		

+		USB_Descriptor_Endpoint_t* EndpointData = DESCRIPTOR_PCAST(ConfigDescriptorData, USB_Descriptor_Endpoint_t);

+

+		/* Check if the endpoint is a bulk IN or bulk OUT endpoint, set appropriate globals */

+		if (EndpointData->EndpointAddress & ENDPOINT_DESCRIPTOR_DIR_IN)

+		{

+			/* Configure the data IN pipe */

+			Pipe_ConfigurePipe(PRINTER_DATA_IN_PIPE, EP_TYPE_BULK, PIPE_TOKEN_IN,

+			                   EndpointData->EndpointAddress, EndpointData->EndpointSize,

+			                   PIPE_BANK_SINGLE);

+

+			Pipe_SetInfiniteINRequests();

+

+			/* Set the flag indicating that the data IN pipe has been found */

+			FoundEndpoints |= (1 << PRINTER_DATA_IN_PIPE);

+		}

+		else

+		{

+			/* Configure the data OUT pipe */

+			Pipe_ConfigurePipe(PRINTER_DATA_OUT_PIPE, EP_TYPE_BULK, PIPE_TOKEN_OUT,

+			                   EndpointData->EndpointAddress, EndpointData->EndpointSize,

+			                   PIPE_BANK_SINGLE);

+

+			/* Set the flag indicating that the data OUT pipe has been found */

+			FoundEndpoints |= (1 << PRINTER_DATA_OUT_PIPE);

+		}		

+	}

+

+	/* Valid data found, return success */

+	return SuccessfulConfigRead;

+}

+

+uint8_t DComp_NextBidirectionalPrinterInterface(void* CurrentDescriptor)

+{

+	/* PURPOSE: Find next bidirectional protocol printer class interface descriptor */

+

+	if (DESCRIPTOR_TYPE(CurrentDescriptor) == DTYPE_Interface)

+	{

+		/* Check the descriptor class and protocol, break out if correct class/protocol interface found */

+		if ((DESCRIPTOR_CAST(CurrentDescriptor, USB_Descriptor_Interface_t).Class    == PRINTER_CLASS)    &&

+		    (DESCRIPTOR_CAST(CurrentDescriptor, USB_Descriptor_Interface_t).SubClass == PRINTER_SUBCLASS) &&

+			(DESCRIPTOR_CAST(CurrentDescriptor, USB_Descriptor_Interface_t).Protocol == PRINTER_PROTOCOL))

+		{

+			return DESCRIPTOR_SEARCH_Found;

+		}

+	}

+	

+	return DESCRIPTOR_SEARCH_NotFound;

+}

+

+uint8_t DComp_NextInterfaceBulkDataEndpoint(void* CurrentDescriptor)

+{

+	/* PURPOSE: Find next interface bulk endpoint descriptor before next interface descriptor */

+

+	if (DESCRIPTOR_TYPE(CurrentDescriptor) == DTYPE_Endpoint)

+	{

+		uint8_t EndpointType = (DESCRIPTOR_CAST(CurrentDescriptor,

+		                                        USB_Descriptor_Endpoint_t).Attributes & EP_TYPE_MASK);

+

+		/* Check the endpoint type, break out if correct BULK type endpoint found */

+		if (EndpointType == EP_TYPE_BULK)

+		  return DESCRIPTOR_SEARCH_Found;

+	}

+	else if (DESCRIPTOR_TYPE(CurrentDescriptor) == DTYPE_Interface)

+	{

+		return DESCRIPTOR_SEARCH_Fail;

+	}

+

+	return DESCRIPTOR_SEARCH_NotFound;

+}

diff --git a/Demos/Host/LowLevel/PrinterHost/ConfigDescriptor.h b/Demos/Host/LowLevel/PrinterHost/ConfigDescriptor.h
new file mode 100644
index 000000000..3e24adc11
--- /dev/null
+++ b/Demos/Host/LowLevel/PrinterHost/ConfigDescriptor.h
@@ -0,0 +1,82 @@
+/*

+             LUFA Library

+     Copyright (C) Dean Camera, 2009.

+              

+  dean [at] fourwalledcubicle [dot] com

+      www.fourwalledcubicle.com

+*/

+

+/*

+  Copyright 2009  Dean Camera (dean [at] fourwalledcubicle [dot] com)

+

+  Permission to use, copy, modify, and distribute this software

+  and its documentation for any purpose and without fee is hereby

+  granted, 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.

+*/

+

+#ifndef _CONFIGDESCRIPTOR_H_

+#define _CONFIGDESCRIPTOR_H_

+

+	/* Includes: */

+		#include <LUFA/Drivers/USB/USB.h>

+		

+		#include "PrinterHost.h"

+		#include "Lib/PrinterCommands.h"

+		

+	/* Macros: */

+		/** Interface Class value for the Printer Device class */

+		#define PRINTER_CLASS                    0x07

+

+		/** Interface Subclass value for the Printer Device class */

+		#define PRINTER_SUBCLASS                 0x01

+

+		/** Interface Protocol value for a Bidirectional communication encapsulation */

+		#define PRINTER_PROTOCOL                 0x02

+		

+		/** Maximum size of a device configuration descriptor which can be processed by the host, in bytes */

+		#define MAX_CONFIG_DESCRIPTOR_SIZE       512

+

+	/* Enums: */

+		/** Enum for the possible return codes of the ProcessConfigurationDescriptor() function. */

+		enum PrinterHost_GetConfigDescriptorDataCodes_t

+		{

+			SuccessfulConfigRead            = 0, /**< Configuration Descriptor was processed successfully */

+			ControlError                    = 1, /**< A control request to the device failed to complete successfully */

+			DescriptorTooLarge              = 2, /**< The device's Configuration Descriptor is too large to process */

+			InvalidConfigDataReturned       = 3, /**< The device returned an invalid Configuration Descriptor */

+			NoInterfaceFound                = 4, /**< A compatible printer interface was not found in the device's Configuration Descriptor */

+			NoEndpointFound                 = 5, /**< The printer data endpoints were not found in the device's Configuration Descriptor */

+		};

+	

+	/* External Variables: */

+		/** Interface index of the Bidirectional Printer interface within the device, once the Configuration

+		 *  Descriptor has been processed.

+		 */

+		uint8_t PrinterInterfaceNumber;

+		

+		/** Interface Alternate Setting index of the Bidirectional Printer interface within the device, once

+		 *  the Configuration Descriptor has been processed.

+		 */

+		uint8_t PrinterAltSetting;

+

+	/* Function Prototypes: */

+		uint8_t ProcessConfigurationDescriptor(void);	

+

+		uint8_t DComp_NextBidirectionalPrinterInterface(void* CurrentDescriptor);

+		uint8_t DComp_NextInterfaceBulkDataEndpoint(void* CurrentDescriptor);

+

+#endif

diff --git a/Demos/Host/LowLevel/PrinterHost/Lib/PrinterCommands.c b/Demos/Host/LowLevel/PrinterHost/Lib/PrinterCommands.c
new file mode 100644
index 000000000..4e2a0d9db
--- /dev/null
+++ b/Demos/Host/LowLevel/PrinterHost/Lib/PrinterCommands.c
@@ -0,0 +1,140 @@
+/*

+             LUFA Library

+     Copyright (C) Dean Camera, 2009.

+              

+  dean [at] fourwalledcubicle [dot] com

+      www.fourwalledcubicle.com

+*/

+

+/*

+  Copyright 2009  Dean Camera (dean [at] fourwalledcubicle [dot] com)

+

+  Permission to use, copy, modify, and distribute this software

+  and its documentation for any purpose and without fee is hereby

+  granted, 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.

+*/

+

+#include "PrinterCommands.h"

+

+/** Sends the given data directly to the printer via the data endpoints, for the sending of print commands in printer

+ *  languages accepted by the attached printer (e.g. PCL).

+ *

+ *  \param[in] PrinterCommands  Pointer to a structure containing the commands and length of the data to send

+ *

+ *  \return A value from the Pipe_Stream_RW_ErrorCodes_t enum

+ */

+uint8_t Printer_SendData(Printer_Data_t* PrinterCommands)

+{

+	uint8_t ErrorCode;

+

+	Pipe_SelectPipe(PRINTER_DATA_OUT_PIPE);

+	Pipe_Unfreeze();

+	

+	if ((ErrorCode = Pipe_Write_Stream_LE(PrinterCommands->Data, PrinterCommands->Length)) != PIPE_RWSTREAM_NoError)

+	  return ErrorCode;

+

+	Pipe_ClearOUT();

+	while (!(Pipe_IsOUTReady()));

+	

+	Pipe_Freeze();

+

+	return PIPE_RWSTREAM_NoError;

+}

+

+/** Issues a Printer class Get Device ID command to the attached device, to retrieve the device ID string (which indicates

+ *  the accepted printer languages, the printer's model and other pertinent information).

+ *

+ *  \param[out] DeviceIDString Pointer to the destination where the returned string should be stored

+ *  \param[in] BufferSize  Size in bytes of the allocated buffer for the returned Device ID string

+ *

+ *  \return A value from the USB_Host_SendControlErrorCodes_t enum

+ */

+uint8_t Printer_GetDeviceID(char* DeviceIDString, uint16_t BufferSize)

+{

+	uint8_t  ErrorCode = HOST_SENDCONTROL_Successful;

+	uint16_t DeviceIDStringLength;

+

+	USB_ControlRequest = (USB_Request_Header_t)

+		{

+			bmRequestType: (REQDIR_DEVICETOHOST | REQTYPE_CLASS | REQREC_INTERFACE),

+			bRequest:      GET_DEVICE_ID,

+			wValue:        0,

+			wIndex:        0,

+			wLength:       sizeof(DeviceIDStringLength),

+		};

+

+	if ((ErrorCode = USB_Host_SendControlRequest(&DeviceIDStringLength)) != HOST_SENDCONTROL_Successful)

+	  return ErrorCode;

+	

+	DeviceIDStringLength = SwapEndian_16(DeviceIDStringLength);

+

+	if (DeviceIDStringLength > BufferSize)

+	  DeviceIDStringLength = BufferSize;

+

+	USB_ControlRequest.wLength = DeviceIDStringLength;

+	

+	if ((ErrorCode = USB_Host_SendControlRequest(DeviceIDString)) != HOST_SENDCONTROL_Successful)

+	  return ErrorCode;

+	  

+	/* Move string back two characters to remove the string length value from the start of the array */

+	memmove(&DeviceIDString[0], &DeviceIDString[2], DeviceIDStringLength - 2);

+

+	DeviceIDString[DeviceIDStringLength - 2] = 0x00;

+	

+	return HOST_SENDCONTROL_Successful;

+}

+

+/** Issues a Printer class Get Port Status command to the attached device, to retrieve the current status flags of the

+ *  printer.

+ *

+ *  \param[out] PortStatus  Pointer to the destination where the printer's status flag values should be stored

+ *

+ *  \return A value from the USB_Host_SendControlErrorCodes_t enum

+ */

+uint8_t Printer_GetPortStatus(uint8_t* PortStatus)

+{

+	USB_ControlRequest = (USB_Request_Header_t)

+		{

+			bmRequestType: (REQDIR_DEVICETOHOST | REQTYPE_CLASS | REQREC_INTERFACE),

+			bRequest:      GET_PORT_STATUS,

+			wValue:        0,

+			wIndex:        0,

+			wLength:       sizeof(uint8_t),

+		};

+

+	return USB_Host_SendControlRequest(PortStatus);

+}

+

+/** Issues a Printer class Soft Reset command to the attached device, to reset the printer ready for new input without

+ *  physically cycling the printer's power.

+ *

+ *  \return A value from the USB_Host_SendControlErrorCodes_t enum

+ */

+uint8_t Printer_SoftReset(void)

+{

+	USB_ControlRequest = (USB_Request_Header_t)

+		{

+			bmRequestType: (REQDIR_HOSTTODEVICE | REQTYPE_CLASS | REQREC_INTERFACE),

+			bRequest:      SOFT_RESET,

+			wValue:        0,

+			wIndex:        0,

+			wLength:       0,

+		};

+

+	return USB_Host_SendControlRequest(NULL);

+}

+

diff --git a/Demos/Host/LowLevel/PrinterHost/Lib/PrinterCommands.h b/Demos/Host/LowLevel/PrinterHost/Lib/PrinterCommands.h
new file mode 100644
index 000000000..4656d190e
--- /dev/null
+++ b/Demos/Host/LowLevel/PrinterHost/Lib/PrinterCommands.h
@@ -0,0 +1,69 @@
+/*

+             LUFA Library

+     Copyright (C) Dean Camera, 2009.

+              

+  dean [at] fourwalledcubicle [dot] com

+      www.fourwalledcubicle.com

+*/

+

+/*

+  Copyright 2009  Dean Camera (dean [at] fourwalledcubicle [dot] com)

+

+  Permission to use, copy, modify, and distribute this software

+  and its documentation for any purpose and without fee is hereby

+  granted, 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.

+*/

+

+#ifndef _PRINTER_COMMANDS_H_

+#define _PRINTER_COMMANDS_H_

+

+	/* Includes: */

+		#include <avr/io.h>

+		#include <string.h>

+

+		#include <LUFA/Drivers/USB/USB.h>

+

+	/* Macros: */

+		/** Printer class-specific request to retrieve the printer's ID string */

+		#define GET_DEVICE_ID                0

+

+		/** Printer class-specific request to retrieve the printer's virtual port status flags */

+		#define GET_PORT_STATUS              1

+

+		/** Printer class-specific request to soft-reset the device */

+		#define SOFT_RESET                   2

+

+		/** Pipe number of the Printer data IN pipe */

+		#define PRINTER_DATA_IN_PIPE         1

+

+		/** Pipe number of the Printer data OUT pipe */

+		#define PRINTER_DATA_OUT_PIPE        2

+		

+	/* Type Defines: */

+		typedef struct

+		{

+			char*    Data;

+			uint16_t Length;

+		} Printer_Data_t;

+		

+	/* Function Prototypes: */

+		uint8_t Printer_SendData(Printer_Data_t* PrinterCommands);

+		uint8_t Printer_GetDeviceID(char* DeviceIDString, uint16_t BufferSize);

+		uint8_t Printer_GetPortStatus(uint8_t* PortStatus);

+		uint8_t Printer_SoftReset(void);

+	

+#endif

diff --git a/Demos/Host/LowLevel/PrinterHost/PrinterHost.c b/Demos/Host/LowLevel/PrinterHost/PrinterHost.c
new file mode 100644
index 000000000..79e6f9ee8
--- /dev/null
+++ b/Demos/Host/LowLevel/PrinterHost/PrinterHost.c
@@ -0,0 +1,237 @@
+/*

+             LUFA Library

+     Copyright (C) Dean Camera, 2009.

+              

+  dean [at] fourwalledcubicle [dot] com

+      www.fourwalledcubicle.com

+*/

+

+/*

+  Copyright 2009  Dean Camera (dean [at] fourwalledcubicle [dot] com)

+

+  Permission to use, copy, modify, and distribute this software

+  and its documentation for any purpose and without fee is hereby

+  granted, 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.

+*/

+

+/*

+	USB Printer host demo application.

+	

+	** NOT CURRENTLY FUNCTIONAL - DO NOT USE **

+*/

+

+#include "PrinterHost.h"

+

+

+int main(void)

+{

+	SetupHardware();

+

+	LEDs_SetAllLEDs(LEDMASK_USB_NOTREADY);

+

+	puts_P(PSTR(ESC_FG_CYAN "Printer Host Demo running.\r\n" ESC_FG_WHITE));

+	

+	for (;;)

+	{

+		USB_Printer_Host();

+		USB_USBTask();

+	}

+}

+

+void SetupHardware(void)

+{

+	/* Disable watchdog if enabled by bootloader/fuses */

+	MCUSR &= ~(1 << WDRF);

+	wdt_disable();

+

+	/* Disable clock division */

+	clock_prescale_set(clock_div_1);

+

+	/* Hardware Initialization */

+	SerialStream_Init(9600, false);

+	LEDs_Init();

+	USB_Init();

+}

+

+void EVENT_USB_DeviceAttached(void)

+{

+	puts_P(PSTR(ESC_FG_GREEN "Device Attached.\r\n" ESC_FG_WHITE));

+	LEDs_SetAllLEDs(LEDMASK_USB_ENUMERATING);

+}

+

+void EVENT_USB_DeviceUnattached(void)

+{

+	puts_P(PSTR(ESC_FG_GREEN "\r\nDevice Unattached.\r\n" ESC_FG_WHITE));

+	LEDs_SetAllLEDs(LEDMASK_USB_NOTREADY);

+}

+

+void EVENT_USB_HostError(uint8_t ErrorCode)

+{

+	USB_ShutDown();

+

+	puts_P(PSTR(ESC_FG_RED "Host Mode Error\r\n"));

+	printf_P(PSTR(" -- Error Code %d\r\n" ESC_FG_WHITE), ErrorCode);

+

+	LEDs_SetAllLEDs(LEDMASK_USB_ERROR);

+	for(;;);

+}

+

+void EVENT_USB_DeviceEnumerationFailed(uint8_t ErrorCode, uint8_t SubErrorCode)

+{

+	puts_P(PSTR(ESC_FG_RED "Dev Enum Error\r\n"));

+	printf_P(PSTR(" -- Error Code %d\r\n"), ErrorCode);

+	printf_P(PSTR(" -- In State %d\r\n" ESC_FG_WHITE), USB_HostState);

+

+	LEDs_SetAllLEDs(LEDMASK_USB_ERROR);

+}

+

+void EVENT_USB_DeviceEnumerationComplete(void)

+{

+	LEDs_SetAllLEDs(LEDMASK_USB_READY);

+}

+

+void USB_Printer_Host(void)

+{

+	uint8_t ErrorCode;

+

+	switch (USB_HostState)

+	{

+		case HOST_STATE_Addressed:

+			puts_P(PSTR("Getting Config Data.\r\n"));

+			

+			/* Select the control pipe for the request transfer */

+			Pipe_SelectPipe(PIPE_CONTROLPIPE);			

+		

+			/* Get and process the configuration descriptor data */

+			if ((ErrorCode = ProcessConfigurationDescriptor()) != SuccessfulConfigRead)

+			{

+				if (ErrorCode == ControlError)

+				  puts_P(PSTR(ESC_FG_RED "Control Error (Get Configuration).\r\n"));

+				else

+				  puts_P(PSTR(ESC_FG_RED "Invalid Device.\r\n"));

+

+				printf_P(PSTR(" -- Error Code: %d\r\n"), ErrorCode);

+				

+				/* Indicate error via status LEDs */

+				LEDs_SetAllLEDs(LEDMASK_USB_ERROR);

+

+				/* Wait until USB device disconnected */

+				USB_HostState = HOST_STATE_WaitForDeviceRemoval;

+				break;

+			}

+				

+			/* Set the device configuration to the first configuration (rarely do devices use multiple configurations) */

+			if ((ErrorCode = USB_Host_SetDeviceConfiguration(1)) != HOST_SENDCONTROL_Successful)

+			{

+				puts_P(PSTR(ESC_FG_RED "Control Error (Set Configuration).\r\n"));

+				printf_P(PSTR(" -- Error Code: %d\r\n" ESC_FG_WHITE), ErrorCode);

+

+				/* Indicate error via status LEDs */

+				LEDs_SetAllLEDs(LEDMASK_USB_ERROR);

+

+				/* Wait until USB device disconnected */

+				USB_HostState = HOST_STATE_WaitForDeviceRemoval;

+				break;

+			}

+			

+			/* Some printers use alternate settings to determine the communication protocol used - if so, send a SetInterface

+			 * request to switch to the interface alternate setting with the Bidirectional protocol */

+			if (PrinterAltSetting)

+			{

+				USB_ControlRequest = (USB_Request_Header_t)

+					{

+						bmRequestType: (REQDIR_HOSTTODEVICE | REQTYPE_STANDARD | REQREC_INTERFACE),

+						bRequest:      REQ_SetInterface,

+						wValue:        PrinterAltSetting,

+						wIndex:        PrinterInterfaceNumber,

+						wLength:       0,

+					};

+					

+				if ((ErrorCode = USB_Host_SendControlRequest(NULL)) != HOST_SENDCONTROL_Successful)

+				{

+					puts_P(PSTR(ESC_FG_RED "Control Error (Set Interface).\r\n"));

+					printf_P(PSTR(" -- Error Code: %d\r\n" ESC_FG_WHITE), ErrorCode);

+

+					/* Indicate error via status LEDs */

+					LEDs_SetAllLEDs(LEDMASK_USB_ERROR);

+

+					/* Wait until USB device disconnected */

+					USB_HostState = HOST_STATE_WaitForDeviceRemoval;

+					break;					

+				}

+			}

+			

+			USB_HostState = HOST_STATE_Configured;

+			break;

+		case HOST_STATE_Configured:

+			puts_P(PSTR("Retrieving Device ID...\r\n"));

+		

+			char DeviceIDString[256];

+			if ((ErrorCode = Printer_GetDeviceID(DeviceIDString, sizeof(DeviceIDString))) != HOST_SENDCONTROL_Successful)

+			{

+				puts_P(PSTR(ESC_FG_RED "Control Error (Get DeviceID).\r\n"));

+				printf_P(PSTR(" -- Error Code: %d\r\n" ESC_FG_WHITE), ErrorCode);

+

+				/* Indicate error via status LEDs */

+				LEDs_SetAllLEDs(LEDMASK_USB_ERROR);

+

+				/* Wait until USB device disconnected */

+				USB_HostState = HOST_STATE_WaitForDeviceRemoval;

+				break;

+			}

+

+			printf_P(PSTR("Printer Device ID: %s\r\n"), DeviceIDString);

+

+			puts_P(PSTR("Printer Enumerated.\r\n"));

+					

+			USB_HostState = HOST_STATE_Ready;

+			break;

+		case HOST_STATE_Ready:

+			/* Indicate device busy via the status LEDs */

+			LEDs_SetAllLEDs(LEDMASK_USB_BUSY);

+		

+			Printer_Data_t TestPageData =

+				{

+//					"\033%-12345X\033E LUFA PCL Test Page \033E\033%-12345X",

+					"\033@\033i\001\033X\001\060\000\r\nLUFA ESCP/2 Test Page\r\n",

+					(sizeof(TestPageData.Data) - 1)

+				};

+		

+			printf_P(PSTR("Sending Test Page (%d bytes)...\r\n"), TestPageData.Length);

+

+			if ((ErrorCode = Printer_SendData(&TestPageData)) != PIPE_RWSTREAM_NoError)

+			{

+				puts_P(PSTR(ESC_FG_RED "Error Sending Test Page.\r\n"));

+				printf_P(PSTR(" -- Error Code: %d\r\n" ESC_FG_WHITE), ErrorCode);

+

+				/* Indicate error via status LEDs */

+				LEDs_SetAllLEDs(LEDMASK_USB_ERROR);

+

+				/* Wait until USB device disconnected */

+				USB_HostState = HOST_STATE_WaitForDeviceRemoval;

+				break;

+			}

+

+			puts_P(PSTR("Test Page Sent.\r\n"));

+		

+			/* Indicate device no longer busy */

+			LEDs_SetAllLEDs(LEDMASK_USB_READY);

+

+			USB_HostState = HOST_STATE_WaitForDeviceRemoval;

+			break;

+	}

+}

diff --git a/Demos/Host/LowLevel/PrinterHost/PrinterHost.h b/Demos/Host/LowLevel/PrinterHost/PrinterHost.h
new file mode 100644
index 000000000..5851349e4
--- /dev/null
+++ b/Demos/Host/LowLevel/PrinterHost/PrinterHost.h
@@ -0,0 +1,78 @@
+/*

+             LUFA Library

+     Copyright (C) Dean Camera, 2009.

+              

+  dean [at] fourwalledcubicle [dot] com

+      www.fourwalledcubicle.com

+*/

+

+/*

+  Copyright 2009  Dean Camera (dean [at] fourwalledcubicle [dot] com)

+

+  Permission to use, copy, modify, and distribute this software

+  and its documentation for any purpose and without fee is hereby

+  granted, 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.

+*/

+

+#ifndef _MASS_STORE_HOST_H_

+#define _MASS_STORE_HOST_H_

+

+	/* Includes: */

+		#include <avr/io.h>

+		#include <avr/wdt.h>

+		#include <avr/pgmspace.h>

+		#include <avr/power.h>

+		#include <stdio.h>

+		#include <string.h>

+

+		#include "ConfigDescriptor.h"

+		#include "Lib/PrinterCommands.h"

+

+		#include <LUFA/Version.h>
+		#include <LUFA/Drivers/Misc/TerminalCodes.h>

+		#include <LUFA/Drivers/USB/USB.h>

+		#include <LUFA/Drivers/Peripheral/SerialStream.h>

+		#include <LUFA/Drivers/Board/LEDs.h>

+

+	/* Macros: */

+		/** LED mask for the library LED driver, to indicate that the USB interface is not ready. */

+		#define LEDMASK_USB_NOTREADY      LEDS_LED1

+

+		/** LED mask for the library LED driver, to indicate that the USB interface is enumerating. */

+		#define LEDMASK_USB_ENUMERATING  (LEDS_LED2 | LEDS_LED3)

+

+		/** LED mask for the library LED driver, to indicate that the USB interface is ready. */

+		#define LEDMASK_USB_READY        (LEDS_LED2 | LEDS_LED4)

+

+		/** 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)

+	

+		/** LED mask for the library LED driver, to indicate that the USB interface is busy. */

+		#define LEDMASK_USB_BUSY         (LEDS_LED2)

+	

+	/* Function Prototypes: */

+		void EVENT_USB_DeviceAttached(void);

+		void EVENT_USB_DeviceUnattached(void);

+		void EVENT_USB_DeviceEnumerationComplete(void);

+		void EVENT_USB_HostError(uint8_t ErrorCode);

+		void EVENT_USB_DeviceEnumerationFailed(uint8_t ErrorCode, uint8_t SubErrorCode);

+

+		void SetupHardware(void);

+

+		void USB_Printer_Host(void);

+

+#endif

diff --git a/Demos/Host/LowLevel/PrinterHost/makefile b/Demos/Host/LowLevel/PrinterHost/makefile
new file mode 100644
index 000000000..ab2eaab23
--- /dev/null
+++ b/Demos/Host/LowLevel/PrinterHost/makefile
@@ -0,0 +1,739 @@
+# Hey Emacs, this is a -*- makefile -*-

+#----------------------------------------------------------------------------

+# WinAVR Makefile Template written by Eric B. Weddington, Jörg Wunsch, et al.

+#  >> Modified for use with the LUFA project. <<

+#

+# Released to the Public Domain

+#

+# Additional material for this makefile was written by:

+# Peter Fleury

+# Tim Henigan

+# Colin O'Flynn

+# Reiner Patommel

+# Markus Pfaff

+# Sander Pool

+# Frederik Rouleau

+# Carlos Lamas

+# Dean Camera

+# Opendous Inc.

+# Denver Gingerich

+#

+#----------------------------------------------------------------------------

+# On command line:

+#

+# make all = Make software.

+#

+# make clean = Clean out built project files.

+#

+# make coff = Convert ELF to AVR COFF.

+#

+# make extcoff = Convert ELF to AVR Extended COFF.

+#

+# make program = Download the hex file to the device, using avrdude.

+#                Please customize the avrdude settings below first!

+#

+# make dfu = Download the hex file to the device, using dfu-programmer (must

+#            have dfu-programmer installed).

+#

+# make flip = Download the hex file to the device, using Atmel FLIP (must

+#             have Atmel FLIP installed).

+#

+# make dfu-ee = Download the eeprom file to the device, using dfu-programmer

+#               (must have dfu-programmer installed).

+#

+# make flip-ee = Download the eeprom file to the device, using Atmel FLIP

+#                (must have Atmel FLIP installed).

+#

+# make doxygen = Generate DoxyGen documentation for the project (must have

+#                DoxyGen installed)

+#

+# make debug = Start either simulavr or avarice as specified for debugging, 

+#              with avr-gdb or avr-insight as the front end for debugging.

+#

+# make filename.s = Just compile filename.c into the assembler code only.

+#

+# make filename.i = Create a preprocessed source file for use in submitting

+#                   bug reports to the GCC project.

+#

+# To rebuild project do "make clean" then "make all".

+#----------------------------------------------------------------------------

+

+

+# MCU name

+MCU = at90usb647

+

+

+# Target board (see library "Board Types" documentation, USER or blank for projects not requiring

+# LUFA board drivers). If USER is selected, put custom board drivers in a directory called 

+# "Board" inside the application directory.

+BOARD  = USBKEY

+

+

+# Processor frequency.

+#     This will define a symbol, F_CPU, in all source code files equal to the 

+#     processor frequency. You can then use this symbol in your source code to 

+#     calculate timings. Do NOT tack on a 'UL' at the end, this will be done

+#     automatically to create a 32-bit value in your source code.

+#     Typical values are:

+#         F_CPU =  1000000

+#         F_CPU =  1843200

+#         F_CPU =  2000000

+#         F_CPU =  3686400

+#         F_CPU =  4000000

+#         F_CPU =  7372800

+#         F_CPU =  8000000

+#         F_CPU = 11059200

+#         F_CPU = 14745600

+#         F_CPU = 16000000

+#         F_CPU = 18432000

+#         F_CPU = 20000000

+F_CPU = 8000000

+

+

+# Input clock frequency.

+#     This will define a symbol, F_CLOCK, in all source code files equal to the 

+#     input clock frequency (before any prescaling is performed). This value may

+#     differ from F_CPU if prescaling is used on the latter, and is required as the

+#     raw input clock is fed directly to the PLL sections of the AVR for high speed

+#     clock generation for the USB and other AVR subsections. Do NOT tack on a 'UL'

+#     at the end, this will be done automatically to create a 32-bit value in your

+#     source code.

+#

+#     If no clock division is performed on the input clock inside the AVR (via the

+#     CPU clock adjust registers or the clock division fuses), this will be equal to F_CPU.

+F_CLOCK = $(F_CPU)

+

+

+# Output format. (can be srec, ihex, binary)

+FORMAT = ihex

+

+

+# Target file name (without extension).

+TARGET = PrinterHost

+

+

+# Object files directory

+#     To put object files in current directory, use a dot (.), do NOT make

+#     this an empty or blank macro!

+OBJDIR = .

+

+

+# Path to the LUFA library

+LUFA_PATH = ../../../..

+

+

+# LUFA library compile-time options

+LUFA_OPTS  = -D USE_NONSTANDARD_DESCRIPTOR_NAMES

+LUFA_OPTS += -D USB_HOST_ONLY

+LUFA_OPTS += -D NO_STREAM_CALLBACKS

+LUFA_OPTS += -D USE_STATIC_OPTIONS="(USB_OPT_REG_ENABLED | USB_OPT_AUTO_PLL)"

+

+

+# List C source files here. (C dependencies are automatically generated.)

+SRC = $(TARGET).c                                                 \

+	  ConfigDescriptor.c                                          \

+	  Lib/PrinterCommands.c                                       \

+	  $(LUFA_PATH)/LUFA/Drivers/Peripheral/SerialStream.c         \

+	  $(LUFA_PATH)/LUFA/Drivers/Peripheral/Serial.c               \

+	  $(LUFA_PATH)/LUFA/Drivers/USB/LowLevel/DevChapter9.c        \

+	  $(LUFA_PATH)/LUFA/Drivers/USB/LowLevel/Endpoint.c           \

+	  $(LUFA_PATH)/LUFA/Drivers/USB/LowLevel/Host.c               \

+	  $(LUFA_PATH)/LUFA/Drivers/USB/LowLevel/HostChapter9.c       \

+	  $(LUFA_PATH)/LUFA/Drivers/USB/LowLevel/LowLevel.c           \

+ 	  $(LUFA_PATH)/LUFA/Drivers/USB/LowLevel/Pipe.c               \

+	  $(LUFA_PATH)/LUFA/Drivers/USB/HighLevel/Events.c            \

+	  $(LUFA_PATH)/LUFA/Drivers/USB/HighLevel/USBInterrupt.c      \

+	  $(LUFA_PATH)/LUFA/Drivers/USB/HighLevel/USBTask.c           \

+	  $(LUFA_PATH)/LUFA/Drivers/USB/HighLevel/ConfigDescriptor.c  \

+

+

+# List C++ source files here. (C dependencies are automatically generated.)

+CPPSRC = 

+

+

+# List Assembler source files here.

+#     Make them always end in a capital .S.  Files ending in a lowercase .s

+#     will not be considered source files but generated files (assembler

+#     output from the compiler), and will be deleted upon "make clean"!

+#     Even though the DOS/Win* filesystem matches both .s and .S the same,

+#     it will preserve the spelling of the filenames, and gcc itself does

+#     care about how the name is spelled on its command-line.

+ASRC =

+

+

+# Optimization level, can be [0, 1, 2, 3, s]. 

+#     0 = turn off optimization. s = optimize for size.

+#     (Note: 3 is not always the best optimization level. See avr-libc FAQ.)

+OPT = s

+

+

+# Debugging format.

+#     Native formats for AVR-GCC's -g are dwarf-2 [default] or stabs.

+#     AVR Studio 4.10 requires dwarf-2.

+#     AVR [Extended] COFF format requires stabs, plus an avr-objcopy run.

+DEBUG = dwarf-2

+

+

+# List any extra directories to look for include files here.

+#     Each directory must be seperated by a space.

+#     Use forward slashes for directory separators.

+#     For a directory that has spaces, enclose it in quotes.

+EXTRAINCDIRS = $(LUFA_PATH)/

+

+

+# Compiler flag to set the C Standard level.

+#     c89   = "ANSI" C

+#     gnu89 = c89 plus GCC extensions

+#     c99   = ISO C99 standard (not yet fully implemented)

+#     gnu99 = c99 plus GCC extensions

+CSTANDARD = -std=gnu99

+

+

+# Place -D or -U options here for C sources

+CDEFS  = -DF_CPU=$(F_CPU)UL -DF_CLOCK=$(F_CLOCK)UL -DBOARD=BOARD_$(BOARD) $(LUFA_OPTS)

+

+

+# Place -D or -U options here for ASM sources

+ADEFS = -DF_CPU=$(F_CPU)

+

+

+# Place -D or -U options here for C++ sources

+CPPDEFS = -DF_CPU=$(F_CPU)UL

+#CPPDEFS += -D__STDC_LIMIT_MACROS

+#CPPDEFS += -D__STDC_CONSTANT_MACROS

+

+

+

+#---------------- Compiler Options C ----------------

+#  -g*:          generate debugging information

+#  -O*:          optimization level

+#  -f...:        tuning, see GCC manual and avr-libc documentation

+#  -Wall...:     warning level

+#  -Wa,...:      tell GCC to pass this to the assembler.

+#    -adhlns...: create assembler listing

+CFLAGS = -g$(DEBUG)

+CFLAGS += $(CDEFS)

+CFLAGS += -O$(OPT)

+CFLAGS += -funsigned-char

+CFLAGS += -funsigned-bitfields

+CFLAGS += -ffunction-sections

+CFLAGS += -fpack-struct

+CFLAGS += -fshort-enums

+CFLAGS += -finline-limit=20

+CFLAGS += -Wall

+CFLAGS += -Wstrict-prototypes

+CFLAGS += -Wundef

+#CFLAGS += -fno-unit-at-a-time

+#CFLAGS += -Wunreachable-code

+#CFLAGS += -Wsign-compare

+CFLAGS += -Wa,-adhlns=$(<:%.c=$(OBJDIR)/%.lst)

+CFLAGS += $(patsubst %,-I%,$(EXTRAINCDIRS))

+CFLAGS += $(CSTANDARD)

+

+

+#---------------- Compiler Options C++ ----------------

+#  -g*:          generate debugging information

+#  -O*:          optimization level

+#  -f...:        tuning, see GCC manual and avr-libc documentation

+#  -Wall...:     warning level

+#  -Wa,...:      tell GCC to pass this to the assembler.

+#    -adhlns...: create assembler listing

+CPPFLAGS = -g$(DEBUG)

+CPPFLAGS += $(CPPDEFS)

+CPPFLAGS += -O$(OPT)

+CPPFLAGS += -funsigned-char

+CPPFLAGS += -funsigned-bitfields

+CPPFLAGS += -fpack-struct

+CPPFLAGS += -fshort-enums

+CPPFLAGS += -fno-exceptions

+CPPFLAGS += -Wall

+CFLAGS += -Wundef

+#CPPFLAGS += -mshort-calls

+#CPPFLAGS += -fno-unit-at-a-time

+#CPPFLAGS += -Wstrict-prototypes

+#CPPFLAGS += -Wunreachable-code

+#CPPFLAGS += -Wsign-compare

+CPPFLAGS += -Wa,-adhlns=$(<:%.cpp=$(OBJDIR)/%.lst)

+CPPFLAGS += $(patsubst %,-I%,$(EXTRAINCDIRS))

+#CPPFLAGS += $(CSTANDARD)

+

+

+#---------------- Assembler Options ----------------

+#  -Wa,...:   tell GCC to pass this to the assembler.

+#  -adhlns:   create listing

+#  -gstabs:   have the assembler create line number information; note that

+#             for use in COFF files, additional information about filenames

+#             and function names needs to be present in the assembler source

+#             files -- see avr-libc docs [FIXME: not yet described there]

+#  -listing-cont-lines: Sets the maximum number of continuation lines of hex 

+#       dump that will be displayed for a given single line of source input.

+ASFLAGS = $(ADEFS) -Wa,-adhlns=$(<:%.S=$(OBJDIR)/%.lst),-gstabs,--listing-cont-lines=100

+

+

+#---------------- Library Options ----------------

+# Minimalistic printf version

+PRINTF_LIB_MIN = -Wl,-u,vfprintf -lprintf_min

+

+# Floating point printf version (requires MATH_LIB = -lm below)

+PRINTF_LIB_FLOAT = -Wl,-u,vfprintf -lprintf_flt

+

+# If this is left blank, then it will use the Standard printf version.

+PRINTF_LIB = 

+#PRINTF_LIB = $(PRINTF_LIB_MIN)

+#PRINTF_LIB = $(PRINTF_LIB_FLOAT)

+

+

+# Minimalistic scanf version

+SCANF_LIB_MIN = -Wl,-u,vfscanf -lscanf_min

+

+# Floating point + %[ scanf version (requires MATH_LIB = -lm below)

+SCANF_LIB_FLOAT = -Wl,-u,vfscanf -lscanf_flt

+

+# If this is left blank, then it will use the Standard scanf version.

+SCANF_LIB = 

+#SCANF_LIB = $(SCANF_LIB_MIN)

+#SCANF_LIB = $(SCANF_LIB_FLOAT)

+

+

+MATH_LIB = -lm

+

+

+# List any extra directories to look for libraries here.

+#     Each directory must be seperated by a space.

+#     Use forward slashes for directory separators.

+#     For a directory that has spaces, enclose it in quotes.

+EXTRALIBDIRS = 

+

+

+

+#---------------- External Memory Options ----------------

+

+# 64 KB of external RAM, starting after internal RAM (ATmega128!),

+# used for variables (.data/.bss) and heap (malloc()).

+#EXTMEMOPTS = -Wl,-Tdata=0x801100,--defsym=__heap_end=0x80ffff

+

+# 64 KB of external RAM, starting after internal RAM (ATmega128!),

+# only used for heap (malloc()).

+#EXTMEMOPTS = -Wl,--section-start,.data=0x801100,--defsym=__heap_end=0x80ffff

+

+EXTMEMOPTS =

+

+

+

+#---------------- Linker Options ----------------

+#  -Wl,...:     tell GCC to pass this to linker.

+#    -Map:      create map file

+#    --cref:    add cross reference to  map file

+LDFLAGS = -Wl,-Map=$(TARGET).map,--cref

+LDFLAGS += -Wl,--relax 

+LDFLAGS += -Wl,--gc-sections

+LDFLAGS += $(EXTMEMOPTS)

+LDFLAGS += $(patsubst %,-L%,$(EXTRALIBDIRS))

+LDFLAGS += $(PRINTF_LIB) $(SCANF_LIB) $(MATH_LIB)

+#LDFLAGS += -T linker_script.x

+

+

+

+#---------------- Programming Options (avrdude) ----------------

+

+# Programming hardware: alf avr910 avrisp bascom bsd 

+# dt006 pavr picoweb pony-stk200 sp12 stk200 stk500

+#

+# Type: avrdude -c ?

+# to get a full listing.

+#

+AVRDUDE_PROGRAMMER = jtagmkII

+

+# com1 = serial port. Use lpt1 to connect to parallel port.

+AVRDUDE_PORT = usb

+

+AVRDUDE_WRITE_FLASH = -U flash:w:$(TARGET).hex

+#AVRDUDE_WRITE_EEPROM = -U eeprom:w:$(TARGET).eep

+

+

+# Uncomment the following if you want avrdude's erase cycle counter.

+# Note that this counter needs to be initialized first using -Yn,

+# see avrdude manual.

+#AVRDUDE_ERASE_COUNTER = -y

+

+# Uncomment the following if you do /not/ wish a verification to be

+# performed after programming the device.

+#AVRDUDE_NO_VERIFY = -V

+

+# Increase verbosity level.  Please use this when submitting bug

+# reports about avrdude. See <http://savannah.nongnu.org/projects/avrdude> 

+# to submit bug reports.

+#AVRDUDE_VERBOSE = -v -v

+

+AVRDUDE_FLAGS = -p $(MCU) -P $(AVRDUDE_PORT) -c $(AVRDUDE_PROGRAMMER)

+AVRDUDE_FLAGS += $(AVRDUDE_NO_VERIFY)

+AVRDUDE_FLAGS += $(AVRDUDE_VERBOSE)

+AVRDUDE_FLAGS += $(AVRDUDE_ERASE_COUNTER)

+

+

+

+#---------------- Debugging Options ----------------

+

+# For simulavr only - target MCU frequency.

+DEBUG_MFREQ = $(F_CPU)

+

+# Set the DEBUG_UI to either gdb or insight.

+# DEBUG_UI = gdb

+DEBUG_UI = insight

+

+# Set the debugging back-end to either avarice, simulavr.

+DEBUG_BACKEND = avarice

+#DEBUG_BACKEND = simulavr

+

+# GDB Init Filename.

+GDBINIT_FILE = __avr_gdbinit

+

+# When using avarice settings for the JTAG

+JTAG_DEV = /dev/com1

+

+# Debugging port used to communicate between GDB / avarice / simulavr.

+DEBUG_PORT = 4242

+

+# Debugging host used to communicate between GDB / avarice / simulavr, normally

+#     just set to localhost unless doing some sort of crazy debugging when 

+#     avarice is running on a different computer.

+DEBUG_HOST = localhost

+

+

+

+#============================================================================

+

+

+# Define programs and commands.

+SHELL = sh

+CC = avr-gcc

+OBJCOPY = avr-objcopy

+OBJDUMP = avr-objdump

+SIZE = avr-size

+AR = avr-ar rcs

+NM = avr-nm

+AVRDUDE = avrdude

+REMOVE = rm -f

+REMOVEDIR = rm -rf

+COPY = cp

+WINSHELL = cmd

+

+# Define Messages

+# English

+MSG_ERRORS_NONE = Errors: none

+MSG_BEGIN = -------- begin --------

+MSG_END = --------  end  --------

+MSG_SIZE_BEFORE = Size before: 

+MSG_SIZE_AFTER = Size after:

+MSG_COFF = Converting to AVR COFF:

+MSG_EXTENDED_COFF = Converting to AVR Extended COFF:

+MSG_FLASH = Creating load file for Flash:

+MSG_EEPROM = Creating load file for EEPROM:

+MSG_EXTENDED_LISTING = Creating Extended Listing:

+MSG_SYMBOL_TABLE = Creating Symbol Table:

+MSG_LINKING = Linking:

+MSG_COMPILING = Compiling C:

+MSG_COMPILING_CPP = Compiling C++:

+MSG_ASSEMBLING = Assembling:

+MSG_CLEANING = Cleaning project:

+MSG_CREATING_LIBRARY = Creating library:

+

+

+

+

+# Define all object files.

+OBJ = $(SRC:%.c=$(OBJDIR)/%.o) $(CPPSRC:%.cpp=$(OBJDIR)/%.o) $(ASRC:%.S=$(OBJDIR)/%.o) 

+

+# Define all listing files.

+LST = $(SRC:%.c=$(OBJDIR)/%.lst) $(CPPSRC:%.cpp=$(OBJDIR)/%.lst) $(ASRC:%.S=$(OBJDIR)/%.lst) 

+

+

+# Compiler flags to generate dependency files.

+GENDEPFLAGS = -MMD -MP -MF .dep/$(@F).d

+

+

+# Combine all necessary flags and optional flags.

+# Add target processor to flags.

+ALL_CFLAGS = -mmcu=$(MCU) -I. $(CFLAGS) $(GENDEPFLAGS)

+ALL_CPPFLAGS = -mmcu=$(MCU) -I. -x c++ $(CPPFLAGS) $(GENDEPFLAGS)

+ALL_ASFLAGS = -mmcu=$(MCU) -I. -x assembler-with-cpp $(ASFLAGS)

+

+

+

+

+

+# Default target.

+all: begin gccversion sizebefore build checkhooks checklibmode checkboard sizeafter end

+

+# Change the build target to build a HEX file or a library.

+build: elf hex eep lss sym

+#build: lib

+

+

+elf: $(TARGET).elf

+hex: $(TARGET).hex

+eep: $(TARGET).eep

+lss: $(TARGET).lss

+sym: $(TARGET).sym

+LIBNAME=lib$(TARGET).a

+lib: $(LIBNAME)

+

+

+

+# Eye candy.

+# AVR Studio 3.x does not check make's exit code but relies on

+# the following magic strings to be generated by the compile job.

+begin:

+	@echo

+	@echo $(MSG_BEGIN)

+

+end:

+	@echo $(MSG_END)

+	@echo

+

+

+# Display size of file.

+HEXSIZE = $(SIZE) --target=$(FORMAT) $(TARGET).hex

+ELFSIZE = $(SIZE) $(MCU_FLAG) $(FORMAT_FLAG) $(TARGET).elf

+MCU_FLAG = $(shell $(SIZE) --help | grep -- --mcu > /dev/null && echo --mcu=$(MCU) )

+FORMAT_FLAG = $(shell $(SIZE) --help | grep -- --format=.*avr > /dev/null && echo --format=avr )

+

+sizebefore:

+	@if test -f $(TARGET).elf; then echo; echo $(MSG_SIZE_BEFORE); $(ELFSIZE); \

+	2>/dev/null; echo; fi

+

+sizeafter:

+	@if test -f $(TARGET).elf; then echo; echo $(MSG_SIZE_AFTER); $(ELFSIZE); \

+	2>/dev/null; echo; fi

+

+checkhooks: build

+	@echo

+	@echo ------- Unhooked LUFA Events -------

+	@$(shell) (grep -s '^EVENT_.*LUFA/.*\\.o' $(TARGET).map | \

+	           cut -d' ' -f1 | cut -d'_' -f2- | grep ".*") || \

+			   echo "(None)"

+	@echo ------------------------------------

+

+checklibmode:

+	@echo

+	@echo ----------- Library Mode -----------

+	@$(shell) ($(CC) $(ALL_CFLAGS) -E -dM - < /dev/null \

+	          | grep 'USB_\(DEVICE\|HOST\)_ONLY' | cut -d' ' -f2 | grep ".*") \

+	          || echo "No specific mode (both device and host mode allowable)."

+	@echo ------------------------------------

+

+checkboard:

+	@echo

+	@echo ---------- Selected Board ----------

+	@echo Selected board model is $(BOARD).

+	@echo ------------------------------------

+	

+# Display compiler version information.

+gccversion : 

+	@$(CC) --version

+

+

+

+# Program the device.  

+program: $(TARGET).hex $(TARGET).eep

+	$(AVRDUDE) $(AVRDUDE_FLAGS) $(AVRDUDE_WRITE_FLASH) $(AVRDUDE_WRITE_EEPROM)

+

+flip: $(TARGET).hex

+	batchisp -hardware usb -device $(MCU) -operation erase f

+	batchisp -hardware usb -device $(MCU) -operation loadbuffer $(TARGET).hex program

+	batchisp -hardware usb -device $(MCU) -operation start reset 0

+

+dfu: $(TARGET).hex

+	dfu-programmer $(MCU) erase

+	dfu-programmer $(MCU) flash --debug 1 $(TARGET).hex

+	dfu-programmer $(MCU) reset

+

+flip-ee: $(TARGET).hex $(TARGET).eep

+	copy $(TARGET).eep $(TARGET)eep.hex

+	batchisp -hardware usb -device $(MCU) -operation memory EEPROM erase

+	batchisp -hardware usb -device $(MCU) -operation memory EEPROM loadbuffer $(TARGET)eep.hex program

+	batchisp -hardware usb -device $(MCU) -operation start reset 0

+

+dfu-ee: $(TARGET).hex $(TARGET).eep

+	dfu-programmer $(MCU) flash-eeprom --debug 1 --suppress-bootloader-mem $(TARGET).eep

+	dfu-programmer $(MCU) reset

+

+

+# Generate avr-gdb config/init file which does the following:

+#     define the reset signal, load the target file, connect to target, and set 

+#     a breakpoint at main().

+gdb-config: 

+	@$(REMOVE) $(GDBINIT_FILE)

+	@echo define reset >> $(GDBINIT_FILE)

+	@echo SIGNAL SIGHUP >> $(GDBINIT_FILE)

+	@echo end >> $(GDBINIT_FILE)

+	@echo file $(TARGET).elf >> $(GDBINIT_FILE)

+	@echo target remote $(DEBUG_HOST):$(DEBUG_PORT)  >> $(GDBINIT_FILE)

+ifeq ($(DEBUG_BACKEND),simulavr)

+	@echo load  >> $(GDBINIT_FILE)

+endif

+	@echo break main >> $(GDBINIT_FILE)

+

+debug: gdb-config $(TARGET).elf

+ifeq ($(DEBUG_BACKEND), avarice)

+	@echo Starting AVaRICE - Press enter when "waiting to connect" message displays.

+	@$(WINSHELL) /c start avarice --jtag $(JTAG_DEV) --erase --program --file \

+	$(TARGET).elf $(DEBUG_HOST):$(DEBUG_PORT)

+	@$(WINSHELL) /c pause

+

+else

+	@$(WINSHELL) /c start simulavr --gdbserver --device $(MCU) --clock-freq \

+	$(DEBUG_MFREQ) --port $(DEBUG_PORT)

+endif

+	@$(WINSHELL) /c start avr-$(DEBUG_UI) --command=$(GDBINIT_FILE)

+

+

+

+

+# Convert ELF to COFF for use in debugging / simulating in AVR Studio or VMLAB.

+COFFCONVERT = $(OBJCOPY) --debugging

+COFFCONVERT += --change-section-address .data-0x800000

+COFFCONVERT += --change-section-address .bss-0x800000

+COFFCONVERT += --change-section-address .noinit-0x800000

+COFFCONVERT += --change-section-address .eeprom-0x810000

+

+

+

+coff: $(TARGET).elf

+	@echo

+	@echo $(MSG_COFF) $(TARGET).cof

+	$(COFFCONVERT) -O coff-avr $< $(TARGET).cof

+

+

+extcoff: $(TARGET).elf

+	@echo

+	@echo $(MSG_EXTENDED_COFF) $(TARGET).cof

+	$(COFFCONVERT) -O coff-ext-avr $< $(TARGET).cof

+

+

+

+# Create final output files (.hex, .eep) from ELF output file.

+%.hex: %.elf

+	@echo

+	@echo $(MSG_FLASH) $@

+	$(OBJCOPY) -O $(FORMAT) -R .eeprom $< $@

+

+%.eep: %.elf

+	@echo

+	@echo $(MSG_EEPROM) $@

+	-$(OBJCOPY) -j .eeprom --set-section-flags=.eeprom="alloc,load" \

+	--change-section-lma .eeprom=0 --no-change-warnings -O $(FORMAT) $< $@ || exit 0

+

+# Create extended listing file from ELF output file.

+%.lss: %.elf

+	@echo

+	@echo $(MSG_EXTENDED_LISTING) $@

+	$(OBJDUMP) -h -z -S $< > $@

+

+# Create a symbol table from ELF output file.

+%.sym: %.elf

+	@echo

+	@echo $(MSG_SYMBOL_TABLE) $@

+	$(NM) -n $< > $@

+

+

+

+# Create library from object files.

+.SECONDARY : $(TARGET).a

+.PRECIOUS : $(OBJ)

+%.a: $(OBJ)

+	@echo

+	@echo $(MSG_CREATING_LIBRARY) $@

+	$(AR) $@ $(OBJ)

+

+

+# Link: create ELF output file from object files.

+.SECONDARY : $(TARGET).elf

+.PRECIOUS : $(OBJ)

+%.elf: $(OBJ)

+	@echo

+	@echo $(MSG_LINKING) $@

+	$(CC) $(ALL_CFLAGS) $^ --output $@ $(LDFLAGS)

+

+

+# Compile: create object files from C source files.

+$(OBJDIR)/%.o : %.c

+	@echo

+	@echo $(MSG_COMPILING) $<

+	$(CC) -c $(ALL_CFLAGS) $< -o $@ 

+

+

+# Compile: create object files from C++ source files.

+$(OBJDIR)/%.o : %.cpp

+	@echo

+	@echo $(MSG_COMPILING_CPP) $<

+	$(CC) -c $(ALL_CPPFLAGS) $< -o $@ 

+

+

+# Compile: create assembler files from C source files.

+%.s : %.c

+	$(CC) -S $(ALL_CFLAGS) $< -o $@

+

+

+# Compile: create assembler files from C++ source files.

+%.s : %.cpp

+	$(CC) -S $(ALL_CPPFLAGS) $< -o $@

+

+

+# Assemble: create object files from assembler source files.

+$(OBJDIR)/%.o : %.S

+	@echo

+	@echo $(MSG_ASSEMBLING) $<

+	$(CC) -c $(ALL_ASFLAGS) $< -o $@

+

+

+# Create preprocessed source for use in sending a bug report.

+%.i : %.c

+	$(CC) -E -mmcu=$(MCU) -I. $(CFLAGS) $< -o $@ 

+	

+

+# Target: clean project.

+clean: begin clean_list clean_binary end

+

+clean_binary:

+	$(REMOVE) $(TARGET).hex

+	

+clean_list:

+	@echo $(MSG_CLEANING)

+	$(REMOVE) $(TARGET).eep

+	$(REMOVE) $(TARGET)eep.hex

+	$(REMOVE) $(TARGET).cof

+	$(REMOVE) $(TARGET).elf

+	$(REMOVE) $(TARGET).map

+	$(REMOVE) $(TARGET).sym

+	$(REMOVE) $(TARGET).lss

+	$(REMOVE) $(SRC:%.c=$(OBJDIR)/%.o)

+	$(REMOVE) $(SRC:%.c=$(OBJDIR)/%.lst)

+	$(REMOVE) $(SRC:.c=.s)

+	$(REMOVE) $(SRC:.c=.d)

+	$(REMOVE) $(SRC:.c=.i)

+	$(REMOVEDIR) .dep

+

+

+doxygen:

+	@echo Generating Project Documentation...

+	@doxygen Doxygen.conf

+	@echo Documentation Generation Complete.

+

+clean_doxygen:

+	rm -rf Documentation

+

+# Create object files directory

+$(shell mkdir $(OBJDIR) 2>/dev/null)

+

+

+# Include the dependency files.

+-include $(shell mkdir .dep 2>/dev/null) $(wildcard .dep/*)

+

+

+# Listing of phony targets.

+.PHONY : all checkhooks checklibmode checkboard   \

+begin finish end sizebefore sizeafter gccversion  \

+build elf hex eep lss sym coff extcoff clean      \

+clean_list clean_binary program debug gdb-config  \

+doxygen dfu flip flip-ee dfu-ee
\ No newline at end of file