Add new MediaController project, a simple Media Playback control manipulator (Play/Pause/Next Track/Volume/etc.).
This commit is contained in:
		
							parent
							
								
									4343e68779
								
							
						
					
					
						commit
						b88e0a7b90
					
				
					 13 changed files with 2966 additions and 6 deletions
				
			
		
										
											
												File diff suppressed because one or more lines are too long
											
										
									
								
							| 
						 | 
				
			
			@ -33,12 +33,13 @@
 | 
			
		|||
  *  - Library Applications:
 | 
			
		||||
  *   - Added ability to write protect Mass Storage disk write operations from the host OS
 | 
			
		||||
  *   - Added new MIDIToneGenerator project
 | 
			
		||||
  *   - Added new MediaControl project
 | 
			
		||||
  *   - Added new KeyboardMouseMultiReport Device ClassDriver demo
 | 
			
		||||
  *   - Added new VirtualSerialMassStorage Device ClassDriver demo
 | 
			
		||||
  *   - Added HID class bootloader, compatible with a modified version of the command line Teensy loader from PJRC.com
 | 
			
		||||
  *   - Added LED flashing to the CDC and DFU class bootloaders to indicate when they are running
 | 
			
		||||
  *   - Added new incomplete AndroidAccessoryHost Host LowLevel demo
 | 
			
		||||
  *   - Added RNDIS device mode to the Webserver project
 | 
			
		||||
  *   - Added HID class bootloader, compatible with a modified version of the command line Teensy loader from PJRC.com
 | 
			
		||||
  *   - Added LED flashing to the CDC and DFU class bootloaders to indicate when they are running
 | 
			
		||||
  *
 | 
			
		||||
  *  <b>Changed:</b>
 | 
			
		||||
  *  - Core:
 | 
			
		||||
| 
						 | 
				
			
			
 | 
			
		|||
| 
						 | 
				
			
			@ -337,7 +337,7 @@
 | 
			
		|||
 *     0x2069
 | 
			
		||||
 *    </td>
 | 
			
		||||
 *    <td>
 | 
			
		||||
 *     <i>Currently Unallocated</i>
 | 
			
		||||
 *     Webserver Project
 | 
			
		||||
 *    </td>
 | 
			
		||||
 *   </tr>
 | 
			
		||||
 *
 | 
			
		||||
| 
						 | 
				
			
			@ -349,7 +349,7 @@
 | 
			
		|||
 *     0x206A
 | 
			
		||||
 *    </td>
 | 
			
		||||
 *    <td>
 | 
			
		||||
 *     <i>Currently Unallocated</i>
 | 
			
		||||
 *     Media Control Project
 | 
			
		||||
 *    </td>
 | 
			
		||||
 *   </tr>
 | 
			
		||||
 *
 | 
			
		||||
| 
						 | 
				
			
			
 | 
			
		|||
							
								
								
									
										246
									
								
								Projects/MediaController/Descriptors.c
									
										
									
									
									
										Normal file
									
								
							
							
						
						
									
										246
									
								
								Projects/MediaController/Descriptors.c
									
										
									
									
									
										Normal file
									
								
							| 
						 | 
				
			
			@ -0,0 +1,246 @@
 | 
			
		|||
/*
 | 
			
		||||
             LUFA Library
 | 
			
		||||
     Copyright (C) Dean Camera, 2011.
 | 
			
		||||
 | 
			
		||||
  dean [at] fourwalledcubicle [dot] com
 | 
			
		||||
           www.lufa-lib.org
 | 
			
		||||
*/
 | 
			
		||||
 | 
			
		||||
/*
 | 
			
		||||
  Copyright 2011  Dean Camera (dean [at] fourwalledcubicle [dot] com)
 | 
			
		||||
 | 
			
		||||
  Permission to use, copy, modify, distribute, and sell this
 | 
			
		||||
  software and its documentation for any purpose is hereby granted
 | 
			
		||||
  without fee, provided that the above copyright notice appear in
 | 
			
		||||
  all copies and that both that the copyright notice and this
 | 
			
		||||
  permission notice and warranty disclaimer appear in supporting
 | 
			
		||||
  documentation, and that the name of the author not be used in
 | 
			
		||||
  advertising or publicity pertaining to distribution of the
 | 
			
		||||
  software without specific, written prior permission.
 | 
			
		||||
 | 
			
		||||
  The author disclaim all warranties with regard to this
 | 
			
		||||
  software, including all implied warranties of merchantability
 | 
			
		||||
  and fitness.  In no event shall the author be liable for any
 | 
			
		||||
  special, indirect or consequential damages or any damages
 | 
			
		||||
  whatsoever resulting from loss of use, data or profits, whether
 | 
			
		||||
  in an action of contract, negligence or other tortious action,
 | 
			
		||||
  arising out of or in connection with the use or performance of
 | 
			
		||||
  this software.
 | 
			
		||||
*/
 | 
			
		||||
 | 
			
		||||
/** \file
 | 
			
		||||
 *
 | 
			
		||||
 *  USB Device Descriptors, for library use when in USB device mode. Descriptors are special
 | 
			
		||||
 *  computer-readable structures which the host requests upon device enumeration, to determine
 | 
			
		||||
 *  the device's capabilities and functions.
 | 
			
		||||
 */
 | 
			
		||||
 | 
			
		||||
#include "Descriptors.h"
 | 
			
		||||
 | 
			
		||||
/** HID class report descriptor. This is a special descriptor constructed with values from the
 | 
			
		||||
 *  USBIF HID class specification to describe the reports and capabilities of the HID device. This
 | 
			
		||||
 *  descriptor is parsed by the host and its contents used to determine what data (and in what encoding)
 | 
			
		||||
 *  the device will send, and what it may be sent back from the host. Refer to the HID specification for
 | 
			
		||||
 *  more details on HID report descriptors.
 | 
			
		||||
 */
 | 
			
		||||
const USB_Descriptor_HIDReport_Datatype_t PROGMEM MediaControlReport[] =
 | 
			
		||||
{
 | 
			
		||||
	HID_RI_USAGE_PAGE(8, 0x0C), /* Consumer Page */
 | 
			
		||||
	HID_RI_USAGE(8, 0x01), /* Consumer Controls */
 | 
			
		||||
	HID_RI_COLLECTION(8, 0x01), /* Application */
 | 
			
		||||
		HID_RI_USAGE_MINIMUM(8, 0xB0),
 | 
			
		||||
		HID_RI_USAGE_MAXIMUM(8, 0xB7),
 | 
			
		||||
		HID_RI_LOGICAL_MINIMUM(8, 0),
 | 
			
		||||
		HID_RI_LOGICAL_MAXIMUM(8, 1),
 | 
			
		||||
		HID_RI_REPORT_SIZE(8, 0x01),
 | 
			
		||||
		HID_RI_REPORT_COUNT(8, 0x08),
 | 
			
		||||
		HID_RI_INPUT(8, HID_IOF_DATA | HID_IOF_VARIABLE | HID_IOF_RELATIVE),
 | 
			
		||||
		HID_RI_USAGE(8, 0xCD),
 | 
			
		||||
		HID_RI_USAGE(8, 0xE2),
 | 
			
		||||
		HID_RI_USAGE(8, 0xE9),
 | 
			
		||||
		HID_RI_USAGE(8, 0xEA),
 | 
			
		||||
		HID_RI_REPORT_COUNT(8, 0x04),
 | 
			
		||||
		HID_RI_INPUT(8, HID_IOF_DATA | HID_IOF_VARIABLE | HID_IOF_RELATIVE),
 | 
			
		||||
		HID_RI_REPORT_COUNT(8, 0x04),
 | 
			
		||||
		HID_RI_INPUT(8, HID_IOF_CONSTANT),
 | 
			
		||||
	HID_RI_END_COLLECTION(0),
 | 
			
		||||
};
 | 
			
		||||
 | 
			
		||||
/** Device descriptor structure. This descriptor, located in FLASH memory, describes the overall
 | 
			
		||||
 *  device characteristics, including the supported USB version, control endpoint size and the
 | 
			
		||||
 *  number of device configurations. The descriptor is read out by the USB host when the enumeration
 | 
			
		||||
 *  process begins.
 | 
			
		||||
 */
 | 
			
		||||
const USB_Descriptor_Device_t PROGMEM DeviceDescriptor =
 | 
			
		||||
{
 | 
			
		||||
	.Header                 = {.Size = sizeof(USB_Descriptor_Device_t), .Type = DTYPE_Device},
 | 
			
		||||
 | 
			
		||||
	.USBSpecification       = VERSION_BCD(01.10),
 | 
			
		||||
	.Class                  = USB_CSCP_NoDeviceClass,
 | 
			
		||||
	.SubClass               = USB_CSCP_NoDeviceSubclass,
 | 
			
		||||
	.Protocol               = USB_CSCP_NoDeviceProtocol,
 | 
			
		||||
 | 
			
		||||
	.Endpoint0Size          = FIXED_CONTROL_ENDPOINT_SIZE,
 | 
			
		||||
 | 
			
		||||
	.VendorID               = 0x03EB,
 | 
			
		||||
	.ProductID              = 0x206A,
 | 
			
		||||
	.ReleaseNumber          = VERSION_BCD(00.01),
 | 
			
		||||
 | 
			
		||||
	.ManufacturerStrIndex   = 0x01,
 | 
			
		||||
	.ProductStrIndex        = 0x02,
 | 
			
		||||
	.SerialNumStrIndex      = NO_DESCRIPTOR,
 | 
			
		||||
 | 
			
		||||
	.NumberOfConfigurations = FIXED_NUM_CONFIGURATIONS
 | 
			
		||||
};
 | 
			
		||||
 | 
			
		||||
/** Configuration descriptor structure. This descriptor, located in FLASH memory, describes the usage
 | 
			
		||||
 *  of the device in one of its supported configurations, including information about any device interfaces
 | 
			
		||||
 *  and endpoints. The descriptor is read out by the USB host during the enumeration process when selecting
 | 
			
		||||
 *  a configuration so that the host may correctly communicate with the USB device.
 | 
			
		||||
 */
 | 
			
		||||
const USB_Descriptor_Configuration_t PROGMEM ConfigurationDescriptor =
 | 
			
		||||
{
 | 
			
		||||
	.Config =
 | 
			
		||||
		{
 | 
			
		||||
			.Header                 = {.Size = sizeof(USB_Descriptor_Configuration_Header_t), .Type = DTYPE_Configuration},
 | 
			
		||||
 | 
			
		||||
			.TotalConfigurationSize = sizeof(USB_Descriptor_Configuration_t),
 | 
			
		||||
			.TotalInterfaces        = 1,
 | 
			
		||||
 | 
			
		||||
			.ConfigurationNumber    = 1,
 | 
			
		||||
			.ConfigurationStrIndex  = NO_DESCRIPTOR,
 | 
			
		||||
 | 
			
		||||
			.ConfigAttributes       = (USB_CONFIG_ATTR_BUSPOWERED | USB_CONFIG_ATTR_SELFPOWERED),
 | 
			
		||||
 | 
			
		||||
			.MaxPowerConsumption    = USB_CONFIG_POWER_MA(100)
 | 
			
		||||
		},
 | 
			
		||||
 | 
			
		||||
	.HID_Interface =
 | 
			
		||||
		{
 | 
			
		||||
			.Header                 = {.Size = sizeof(USB_Descriptor_Interface_t), .Type = DTYPE_Interface},
 | 
			
		||||
 | 
			
		||||
			.InterfaceNumber        = 0x00,
 | 
			
		||||
			.AlternateSetting       = 0x00,
 | 
			
		||||
 | 
			
		||||
			.TotalEndpoints         = 1,
 | 
			
		||||
 | 
			
		||||
			.Class                  = HID_CSCP_HIDClass,
 | 
			
		||||
			.SubClass               = HID_CSCP_NonBootSubclass,
 | 
			
		||||
			.Protocol               = HID_CSCP_NonBootProtocol,
 | 
			
		||||
 | 
			
		||||
			.InterfaceStrIndex      = NO_DESCRIPTOR
 | 
			
		||||
		},
 | 
			
		||||
 | 
			
		||||
	.HID_MediaControlHID =
 | 
			
		||||
		{
 | 
			
		||||
			.Header                 = {.Size = sizeof(USB_HID_Descriptor_HID_t), .Type = HID_DTYPE_HID},
 | 
			
		||||
 | 
			
		||||
			.HIDSpec                = VERSION_BCD(01.11),
 | 
			
		||||
			.CountryCode            = 0x00,
 | 
			
		||||
			.TotalReportDescriptors = 1,
 | 
			
		||||
			.HIDReportType          = HID_DTYPE_Report,
 | 
			
		||||
			.HIDReportLength        = sizeof(MediaControlReport)
 | 
			
		||||
		},
 | 
			
		||||
 | 
			
		||||
	.HID_ReportINEndpoint =
 | 
			
		||||
		{
 | 
			
		||||
			.Header                 = {.Size = sizeof(USB_Descriptor_Endpoint_t), .Type = DTYPE_Endpoint},
 | 
			
		||||
 | 
			
		||||
			.EndpointAddress        = (ENDPOINT_DESCRIPTOR_DIR_IN | MEDIACONTROL_HID_EPNUM),
 | 
			
		||||
			.Attributes             = (EP_TYPE_INTERRUPT | ENDPOINT_ATTR_NO_SYNC | ENDPOINT_USAGE_DATA),
 | 
			
		||||
			.EndpointSize           = MEDIACONTROL_HID_EPSIZE,
 | 
			
		||||
			.PollingIntervalMS      = 0x01
 | 
			
		||||
		},
 | 
			
		||||
};
 | 
			
		||||
 | 
			
		||||
/** Language descriptor structure. This descriptor, located in FLASH memory, is returned when the host requests
 | 
			
		||||
 *  the string descriptor with index 0 (the first index). It is actually an array of 16-bit integers, which indicate
 | 
			
		||||
 *  via the language ID table available at USB.org what languages the device supports for its string descriptors.
 | 
			
		||||
 */
 | 
			
		||||
const USB_Descriptor_String_t PROGMEM LanguageString =
 | 
			
		||||
{
 | 
			
		||||
	.Header                 = {.Size = USB_STRING_LEN(1), .Type = DTYPE_String},
 | 
			
		||||
 | 
			
		||||
	.UnicodeString          = {LANGUAGE_ID_ENG}
 | 
			
		||||
};
 | 
			
		||||
 | 
			
		||||
/** Manufacturer descriptor string. This is a Unicode string containing the manufacturer's details in human readable
 | 
			
		||||
 *  form, and is read out upon request by the host when the appropriate string ID is requested, listed in the Device
 | 
			
		||||
 *  Descriptor.
 | 
			
		||||
 */
 | 
			
		||||
const USB_Descriptor_String_t PROGMEM ManufacturerString =
 | 
			
		||||
{
 | 
			
		||||
	.Header                 = {.Size = USB_STRING_LEN(11), .Type = DTYPE_String},
 | 
			
		||||
 | 
			
		||||
	.UnicodeString          = L"Dean Camera"
 | 
			
		||||
};
 | 
			
		||||
 | 
			
		||||
/** Product descriptor string. This is a Unicode string containing the product's details in human readable form,
 | 
			
		||||
 *  and is read out upon request by the host when the appropriate string ID is requested, listed in the Device
 | 
			
		||||
 *  Descriptor.
 | 
			
		||||
 */
 | 
			
		||||
const USB_Descriptor_String_t PROGMEM ProductString =
 | 
			
		||||
{
 | 
			
		||||
	.Header                 = {.Size = USB_STRING_LEN(21), .Type = DTYPE_String},
 | 
			
		||||
 | 
			
		||||
	.UnicodeString          = L"LUFA Media Controller"
 | 
			
		||||
};
 | 
			
		||||
 | 
			
		||||
/** This function is called by the library when in device mode, and must be overridden (see library "USB Descriptors"
 | 
			
		||||
 *  documentation) by the application code so that the address and size of a requested descriptor can be given
 | 
			
		||||
 *  to the USB library. When the device receives a Get Descriptor request on the control endpoint, this function
 | 
			
		||||
 *  is called so that the descriptor details can be passed back and the appropriate descriptor sent back to the
 | 
			
		||||
 *  USB host.
 | 
			
		||||
 */
 | 
			
		||||
uint16_t CALLBACK_USB_GetDescriptor(const uint16_t wValue,
 | 
			
		||||
                                    const uint8_t wIndex,
 | 
			
		||||
                                    const void** const DescriptorAddress)
 | 
			
		||||
{
 | 
			
		||||
	const uint8_t  DescriptorType   = (wValue >> 8);
 | 
			
		||||
	const uint8_t  DescriptorNumber = (wValue & 0xFF);
 | 
			
		||||
 | 
			
		||||
	const void* Address = NULL;
 | 
			
		||||
	uint16_t    Size    = NO_DESCRIPTOR;
 | 
			
		||||
 | 
			
		||||
	switch (DescriptorType)
 | 
			
		||||
	{
 | 
			
		||||
		case DTYPE_Device:
 | 
			
		||||
			Address = &DeviceDescriptor;
 | 
			
		||||
			Size    = sizeof(USB_Descriptor_Device_t);
 | 
			
		||||
			break;
 | 
			
		||||
		case DTYPE_Configuration:
 | 
			
		||||
			Address = &ConfigurationDescriptor;
 | 
			
		||||
			Size    = sizeof(USB_Descriptor_Configuration_t);
 | 
			
		||||
			break;
 | 
			
		||||
		case DTYPE_String:
 | 
			
		||||
			switch (DescriptorNumber)
 | 
			
		||||
			{
 | 
			
		||||
				case 0x00:
 | 
			
		||||
					Address = &LanguageString;
 | 
			
		||||
					Size    = pgm_read_byte(&LanguageString.Header.Size);
 | 
			
		||||
					break;
 | 
			
		||||
				case 0x01:
 | 
			
		||||
					Address = &ManufacturerString;
 | 
			
		||||
					Size    = pgm_read_byte(&ManufacturerString.Header.Size);
 | 
			
		||||
					break;
 | 
			
		||||
				case 0x02:
 | 
			
		||||
					Address = &ProductString;
 | 
			
		||||
					Size    = pgm_read_byte(&ProductString.Header.Size);
 | 
			
		||||
					break;
 | 
			
		||||
			}
 | 
			
		||||
 | 
			
		||||
			break;
 | 
			
		||||
		case HID_DTYPE_HID:
 | 
			
		||||
			Address = &ConfigurationDescriptor.HID_MediaControlHID;
 | 
			
		||||
			Size    = sizeof(USB_HID_Descriptor_HID_t);
 | 
			
		||||
			break;
 | 
			
		||||
		case HID_DTYPE_Report:
 | 
			
		||||
			Address = &MediaControlReport;
 | 
			
		||||
			Size    = sizeof(MediaControlReport);
 | 
			
		||||
			break;
 | 
			
		||||
	}
 | 
			
		||||
 | 
			
		||||
	*DescriptorAddress = Address;
 | 
			
		||||
	return Size;
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
							
								
								
									
										71
									
								
								Projects/MediaController/Descriptors.h
									
										
									
									
									
										Normal file
									
								
							
							
						
						
									
										71
									
								
								Projects/MediaController/Descriptors.h
									
										
									
									
									
										Normal file
									
								
							| 
						 | 
				
			
			@ -0,0 +1,71 @@
 | 
			
		|||
/*
 | 
			
		||||
             LUFA Library
 | 
			
		||||
     Copyright (C) Dean Camera, 2011.
 | 
			
		||||
 | 
			
		||||
  dean [at] fourwalledcubicle [dot] com
 | 
			
		||||
           www.lufa-lib.org
 | 
			
		||||
*/
 | 
			
		||||
 | 
			
		||||
/*
 | 
			
		||||
  Copyright 2011  Dean Camera (dean [at] fourwalledcubicle [dot] com)
 | 
			
		||||
 | 
			
		||||
  Permission to use, copy, modify, distribute, and sell this
 | 
			
		||||
  software and its documentation for any purpose is hereby granted
 | 
			
		||||
  without fee, provided that the above copyright notice appear in
 | 
			
		||||
  all copies and that both that the copyright notice and this
 | 
			
		||||
  permission notice and warranty disclaimer appear in supporting
 | 
			
		||||
  documentation, and that the name of the author not be used in
 | 
			
		||||
  advertising or publicity pertaining to distribution of the
 | 
			
		||||
  software without specific, written prior permission.
 | 
			
		||||
 | 
			
		||||
  The author disclaim all warranties with regard to this
 | 
			
		||||
  software, including all implied warranties of merchantability
 | 
			
		||||
  and fitness.  In no event shall the author be liable for any
 | 
			
		||||
  special, indirect or consequential damages or any damages
 | 
			
		||||
  whatsoever resulting from loss of use, data or profits, whether
 | 
			
		||||
  in an action of contract, negligence or other tortious action,
 | 
			
		||||
  arising out of or in connection with the use or performance of
 | 
			
		||||
  this software.
 | 
			
		||||
*/
 | 
			
		||||
 | 
			
		||||
/** \file
 | 
			
		||||
 *
 | 
			
		||||
 *  Header file for Descriptors.c.
 | 
			
		||||
 */
 | 
			
		||||
 | 
			
		||||
#ifndef _DESCRIPTORS_H_
 | 
			
		||||
#define _DESCRIPTORS_H_
 | 
			
		||||
 | 
			
		||||
	/* Includes: */
 | 
			
		||||
		#include <avr/pgmspace.h>
 | 
			
		||||
 | 
			
		||||
		#include <LUFA/Drivers/USB/USB.h>
 | 
			
		||||
 | 
			
		||||
	/* Type Defines: */
 | 
			
		||||
		/** Type define for the device configuration descriptor structure. This must be defined in the
 | 
			
		||||
		 *  application code, as the configuration descriptor contains several sub-descriptors which
 | 
			
		||||
		 *  vary between devices, and which describe the device's usage to the host.
 | 
			
		||||
		 */
 | 
			
		||||
		typedef struct
 | 
			
		||||
		{
 | 
			
		||||
			USB_Descriptor_Configuration_Header_t Config;
 | 
			
		||||
			USB_Descriptor_Interface_t            HID_Interface;
 | 
			
		||||
			USB_HID_Descriptor_HID_t              HID_MediaControlHID;
 | 
			
		||||
	        USB_Descriptor_Endpoint_t             HID_ReportINEndpoint;
 | 
			
		||||
		} USB_Descriptor_Configuration_t;
 | 
			
		||||
 | 
			
		||||
	/* Macros: */
 | 
			
		||||
		/** Endpoint number of the Media Control HID reporting IN endpoint. */
 | 
			
		||||
		#define MEDIACONTROL_HID_EPNUM               1
 | 
			
		||||
 | 
			
		||||
		/** Size in bytes of the Media Control HID reporting IN and OUT endpoints. */
 | 
			
		||||
		#define MEDIACONTROL_HID_EPSIZE              8
 | 
			
		||||
 | 
			
		||||
	/* Function Prototypes: */
 | 
			
		||||
		uint16_t CALLBACK_USB_GetDescriptor(const uint16_t wValue,
 | 
			
		||||
		                                    const uint8_t wIndex,
 | 
			
		||||
		                                    const void** const DescriptorAddress)
 | 
			
		||||
		                                    ATTR_WARN_UNUSED_RESULT ATTR_NON_NULL_PTR_ARG(3);
 | 
			
		||||
 | 
			
		||||
#endif
 | 
			
		||||
 | 
			
		||||
							
								
								
									
										1565
									
								
								Projects/MediaController/Doxygen.conf
									
										
									
									
									
										Normal file
									
								
							
							
						
						
									
										1565
									
								
								Projects/MediaController/Doxygen.conf
									
										
									
									
									
										Normal file
									
								
							
										
											
												File diff suppressed because it is too large
												Load diff
											
										
									
								
							
							
								
								
									
										1
									
								
								Projects/MediaController/MediaController.aps
									
										
									
									
									
										Normal file
									
								
							
							
						
						
									
										1
									
								
								Projects/MediaController/MediaController.aps
									
										
									
									
									
										Normal file
									
								
							| 
						 | 
				
			
			@ -0,0 +1 @@
 | 
			
		|||
<AVRStudio><MANAGEMENT><ProjectName>MediaController</ProjectName><Created>23-May-2011 21:50:04</Created><LastEdit>23-May-2011 21:50:04</LastEdit><ICON>241</ICON><ProjectType>0</ProjectType><Created>23-May-2011 21:50:04</Created><Version>4</Version><Build>4, 18, 0, 685</Build><ProjectTypeName>AVR GCC</ProjectTypeName></MANAGEMENT><CODE_CREATION><ObjectFile>MediaController.elf</ObjectFile><EntryFile></EntryFile><SaveFolder>C:\Users\Dean\Documents\Electronics\Projects\WORK\LUFAWORK\Projects\MediaController\</SaveFolder></CODE_CREATION><DEBUG_TARGET><CURRENT_TARGET></CURRENT_TARGET><CURRENT_PART></CURRENT_PART><BREAKPOINTS></BREAKPOINTS><IO_EXPAND><HIDE>false</HIDE></IO_EXPAND><REGISTERNAMES><Register>R00</Register><Register>R01</Register><Register>R02</Register><Register>R03</Register><Register>R04</Register><Register>R05</Register><Register>R06</Register><Register>R07</Register><Register>R08</Register><Register>R09</Register><Register>R10</Register><Register>R11</Register><Register>R12</Register><Register>R13</Register><Register>R14</Register><Register>R15</Register><Register>R16</Register><Register>R17</Register><Register>R18</Register><Register>R19</Register><Register>R20</Register><Register>R21</Register><Register>R22</Register><Register>R23</Register><Register>R24</Register><Register>R25</Register><Register>R26</Register><Register>R27</Register><Register>R28</Register><Register>R29</Register><Register>R30</Register><Register>R31</Register></REGISTERNAMES><COM></COM><COMType>0</COMType><WATCHNUM>0</WATCHNUM><WATCHNAMES><Pane0></Pane0><Pane1></Pane1><Pane2></Pane2><Pane3></Pane3></WATCHNAMES><BreakOnTrcaeFull>0</BreakOnTrcaeFull></DEBUG_TARGET><Debugger><Triggers></Triggers></Debugger><AVRGCCPLUGIN><FILES><SOURCEFILE>Descriptors.c</SOURCEFILE><SOURCEFILE>MediaController.c</SOURCEFILE><HEADERFILE>Descriptors.h</HEADERFILE><HEADERFILE>MediaController.h</HEADERFILE><OTHERFILE>makefile</OTHERFILE></FILES><CONFIGS><CONFIG><NAME>default</NAME><USESEXTERNALMAKEFILE>YES</USESEXTERNALMAKEFILE><EXTERNALMAKEFILE>makefile</EXTERNALMAKEFILE><PART>atmega128</PART><HEX>1</HEX><LIST>1</LIST><MAP>1</MAP><OUTPUTFILENAME>MediaController.elf</OUTPUTFILENAME><OUTPUTDIR>default\</OUTPUTDIR><ISDIRTY>1</ISDIRTY><OPTIONS/><INCDIRS/><LIBDIRS/><LIBS/><LINKOBJECTS/><OPTIONSFORALL>-Wall -gdwarf-2 -std=gnu99 -Os -funsigned-char -funsigned-bitfields -fpack-struct -fshort-enums</OPTIONSFORALL><LINKEROPTIONS></LINKEROPTIONS><SEGMENTS/></CONFIG></CONFIGS><LASTCONFIG>default</LASTCONFIG><USES_WINAVR>1</USES_WINAVR><GCC_LOC>C:\WinAVR-20100110\bin\avr-gcc.exe</GCC_LOC><MAKE_LOC>C:\WinAVR-20100110\utils\bin\make.exe</MAKE_LOC></AVRGCCPLUGIN><ProjectFiles><Files><Name>C:\Users\Dean\Documents\Electronics\Projects\WORK\LUFAWORK\Projects\MediaController\Descriptors.h</Name><Name>C:\Users\Dean\Documents\Electronics\Projects\WORK\LUFAWORK\Projects\MediaController\MediaController.h</Name><Name>C:\Users\Dean\Documents\Electronics\Projects\WORK\LUFAWORK\Projects\MediaController\Descriptors.c</Name><Name>C:\Users\Dean\Documents\Electronics\Projects\WORK\LUFAWORK\Projects\MediaController\MediaController.c</Name></Files></ProjectFiles><IOView><usergroups/><sort sorted="0" column="0" ordername="0" orderaddress="0" ordergroup="0"/></IOView><Files></Files><Events><Bookmarks></Bookmarks></Events><Trace><Filters></Filters></Trace></AVRStudio>
 | 
			
		||||
							
								
								
									
										178
									
								
								Projects/MediaController/MediaController.c
									
										
									
									
									
										Normal file
									
								
							
							
						
						
									
										178
									
								
								Projects/MediaController/MediaController.c
									
										
									
									
									
										Normal file
									
								
							| 
						 | 
				
			
			@ -0,0 +1,178 @@
 | 
			
		|||
/*
 | 
			
		||||
             LUFA Library
 | 
			
		||||
     Copyright (C) Dean Camera, 2011.
 | 
			
		||||
 | 
			
		||||
  dean [at] fourwalledcubicle [dot] com
 | 
			
		||||
           www.lufa-lib.org
 | 
			
		||||
*/
 | 
			
		||||
 | 
			
		||||
/*
 | 
			
		||||
  Copyright 2011  Dean Camera (dean [at] fourwalledcubicle [dot] com)
 | 
			
		||||
  
 | 
			
		||||
  Permission to use, copy, modify, distribute, and sell this
 | 
			
		||||
  software and its documentation for any purpose is hereby granted
 | 
			
		||||
  without fee, provided that the above copyright notice appear in
 | 
			
		||||
  all copies and that both that the copyright notice and this
 | 
			
		||||
  permission notice and warranty disclaimer appear in supporting
 | 
			
		||||
  documentation, and that the name of the author not be used in
 | 
			
		||||
  advertising or publicity pertaining to distribution of the
 | 
			
		||||
  software without specific, written prior permission.
 | 
			
		||||
 | 
			
		||||
  The author disclaim all warranties with regard to this
 | 
			
		||||
  software, including all implied warranties of merchantability
 | 
			
		||||
  and fitness.  In no event shall the author be liable for any
 | 
			
		||||
  special, indirect or consequential damages or any damages
 | 
			
		||||
  whatsoever resulting from loss of use, data or profits, whether
 | 
			
		||||
  in an action of contract, negligence or other tortious action,
 | 
			
		||||
  arising out of or in connection with the use or performance of
 | 
			
		||||
  this software.
 | 
			
		||||
*/
 | 
			
		||||
 | 
			
		||||
/** \file
 | 
			
		||||
 *
 | 
			
		||||
 *  Main source file for the MediaControl project. This file contains the main tasks of
 | 
			
		||||
 *  the demo and is responsible for the initial application hardware configuration.
 | 
			
		||||
 */
 | 
			
		||||
 | 
			
		||||
#include "MediaController.h"
 | 
			
		||||
 | 
			
		||||
/** Buffer to hold the previously generated Media Control HID report, for comparison purposes inside the HID class driver. */
 | 
			
		||||
static uint8_t PrevMediaControlHIDReportBuffer[sizeof(USB_MediaReport_Data_t)];
 | 
			
		||||
 | 
			
		||||
/** LUFA HID Class driver interface configuration and state information. This structure is
 | 
			
		||||
 *  passed to all HID Class driver functions, so that multiple instances of the same class
 | 
			
		||||
 *  within a device can be differentiated from one another.
 | 
			
		||||
 */
 | 
			
		||||
USB_ClassInfo_HID_Device_t MediaControl_HID_Interface =
 | 
			
		||||
 	{
 | 
			
		||||
		.Config =
 | 
			
		||||
			{
 | 
			
		||||
				.InterfaceNumber              = 0,
 | 
			
		||||
 | 
			
		||||
				.ReportINEndpointNumber       = MEDIACONTROL_HID_EPNUM,
 | 
			
		||||
				.ReportINEndpointSize         = MEDIACONTROL_HID_EPSIZE,
 | 
			
		||||
				.ReportINEndpointDoubleBank   = false,
 | 
			
		||||
 | 
			
		||||
				.PrevReportINBuffer           = PrevMediaControlHIDReportBuffer,
 | 
			
		||||
				.PrevReportINBufferSize       = sizeof(PrevMediaControlHIDReportBuffer),
 | 
			
		||||
			},
 | 
			
		||||
    };
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
/** Main program entry point. This routine contains the overall program flow, including initial
 | 
			
		||||
 *  setup of all components and the main program loop.
 | 
			
		||||
 */
 | 
			
		||||
int main(void)
 | 
			
		||||
{
 | 
			
		||||
	SetupHardware();
 | 
			
		||||
 | 
			
		||||
	LEDs_SetAllLEDs(LEDMASK_USB_NOTREADY);
 | 
			
		||||
	sei();
 | 
			
		||||
 | 
			
		||||
	for (;;)
 | 
			
		||||
	{
 | 
			
		||||
		HID_Device_USBTask(&MediaControl_HID_Interface);
 | 
			
		||||
		USB_USBTask();
 | 
			
		||||
	}
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/** Configures the board hardware and chip peripherals for the demo's functionality. */
 | 
			
		||||
void SetupHardware()
 | 
			
		||||
{
 | 
			
		||||
	/* Disable watchdog if enabled by bootloader/fuses */
 | 
			
		||||
	MCUSR &= ~(1 << WDRF);
 | 
			
		||||
	wdt_disable();
 | 
			
		||||
 | 
			
		||||
	/* Disable clock division */
 | 
			
		||||
	clock_prescale_set(clock_div_1);
 | 
			
		||||
 | 
			
		||||
	/* Hardware Initialization */
 | 
			
		||||
	Joystick_Init();
 | 
			
		||||
	LEDs_Init();
 | 
			
		||||
	Buttons_Init();
 | 
			
		||||
	USB_Init();
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/** Event handler for the library USB Connection event. */
 | 
			
		||||
void EVENT_USB_Device_Connect(void)
 | 
			
		||||
{
 | 
			
		||||
	LEDs_SetAllLEDs(LEDMASK_USB_ENUMERATING);
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/** Event handler for the library USB Disconnection event. */
 | 
			
		||||
void EVENT_USB_Device_Disconnect(void)
 | 
			
		||||
{
 | 
			
		||||
	LEDs_SetAllLEDs(LEDMASK_USB_NOTREADY);
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/** Event handler for the library USB Configuration Changed event. */
 | 
			
		||||
void EVENT_USB_Device_ConfigurationChanged(void)
 | 
			
		||||
{
 | 
			
		||||
	bool ConfigSuccess = true;
 | 
			
		||||
 | 
			
		||||
	ConfigSuccess &= HID_Device_ConfigureEndpoints(&MediaControl_HID_Interface);
 | 
			
		||||
 | 
			
		||||
	USB_Device_EnableSOFEvents();
 | 
			
		||||
 | 
			
		||||
	LEDs_SetAllLEDs(ConfigSuccess ? LEDMASK_USB_READY : LEDMASK_USB_ERROR);
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/** Event handler for the library USB Control Request reception event. */
 | 
			
		||||
void EVENT_USB_Device_ControlRequest(void)
 | 
			
		||||
{
 | 
			
		||||
	HID_Device_ProcessControlRequest(&MediaControl_HID_Interface);
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/** Event handler for the USB device Start Of Frame event. */
 | 
			
		||||
void EVENT_USB_Device_StartOfFrame(void)
 | 
			
		||||
{
 | 
			
		||||
	HID_Device_MillisecondElapsed(&MediaControl_HID_Interface);
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/** HID class driver callback function for the creation of HID reports to the host.
 | 
			
		||||
 *
 | 
			
		||||
 *  \param[in]     HIDInterfaceInfo  Pointer to the HID class interface configuration structure being referenced
 | 
			
		||||
 *  \param[in,out] ReportID    Report ID requested by the host if non-zero, otherwise callback should set to the generated report ID
 | 
			
		||||
 *  \param[in]     ReportType  Type of the report to create, either HID_REPORT_ITEM_In or HID_REPORT_ITEM_Feature
 | 
			
		||||
 *  \param[out]    ReportData  Pointer to a buffer where the created report should be stored
 | 
			
		||||
 *  \param[out]    ReportSize  Number of bytes written in the report (or zero if no report is to be sent
 | 
			
		||||
 *
 | 
			
		||||
 *  \return Boolean true to force the sending of the report, false to let the library determine if it needs to be sent
 | 
			
		||||
 */
 | 
			
		||||
bool CALLBACK_HID_Device_CreateHIDReport(USB_ClassInfo_HID_Device_t* const HIDInterfaceInfo, uint8_t* const ReportID,
 | 
			
		||||
                                         const uint8_t ReportType, void* ReportData, uint16_t* const ReportSize)
 | 
			
		||||
{
 | 
			
		||||
	USB_MediaReport_Data_t* MediaReport = (USB_MediaReport_Data_t*)ReportData;
 | 
			
		||||
 | 
			
		||||
	uint8_t JoyStatus_LCL    = Joystick_GetStatus();
 | 
			
		||||
	uint8_t ButtonStatus_LCL = Buttons_GetStatus();
 | 
			
		||||
 | 
			
		||||
	/* Update the Media Control report with the user button pressess */
 | 
			
		||||
	MediaReport->Mute          = ((ButtonStatus_LCL & BUTTONS_BUTTON1) ? true : false);
 | 
			
		||||
	MediaReport->PlayPause     = ((JoyStatus_LCL & JOY_PRESS) ? true : false);
 | 
			
		||||
	MediaReport->VolumeUp      = ((JoyStatus_LCL & JOY_UP)    ? true : false);
 | 
			
		||||
	MediaReport->VolumeDown    = ((JoyStatus_LCL & JOY_DOWN)  ? true : false);
 | 
			
		||||
	MediaReport->PreviousTrack = ((JoyStatus_LCL & JOY_LEFT)  ? true : false);
 | 
			
		||||
	MediaReport->NextTrack     = ((JoyStatus_LCL & JOY_RIGHT) ? true : false);
 | 
			
		||||
 | 
			
		||||
	*ReportSize = sizeof(USB_MediaReport_Data_t);
 | 
			
		||||
	return false;
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/** HID class driver callback function for the processing of HID reports from the host.
 | 
			
		||||
 *
 | 
			
		||||
 *  \param[in] HIDInterfaceInfo  Pointer to the HID class interface configuration structure being referenced
 | 
			
		||||
 *  \param[in] ReportID    Report ID of the received report from the host
 | 
			
		||||
 *  \param[in] ReportType  The type of report that the host has sent, either HID_REPORT_ITEM_Out or HID_REPORT_ITEM_Feature
 | 
			
		||||
 *  \param[in] ReportData  Pointer to a buffer where the created report has been stored
 | 
			
		||||
 *  \param[in] ReportSize  Size in bytes of the received HID report
 | 
			
		||||
 */
 | 
			
		||||
void CALLBACK_HID_Device_ProcessHIDReport(USB_ClassInfo_HID_Device_t* const HIDInterfaceInfo,
 | 
			
		||||
                                          const uint8_t ReportID,
 | 
			
		||||
                                          const uint8_t ReportType,
 | 
			
		||||
                                          const void* ReportData,
 | 
			
		||||
                                          const uint16_t ReportSize)
 | 
			
		||||
{
 | 
			
		||||
	// Unused (but mandatory for the HID class driver) in this demo, since there are no Host->Device reports
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
							
								
								
									
										111
									
								
								Projects/MediaController/MediaController.h
									
										
									
									
									
										Normal file
									
								
							
							
						
						
									
										111
									
								
								Projects/MediaController/MediaController.h
									
										
									
									
									
										Normal file
									
								
							| 
						 | 
				
			
			@ -0,0 +1,111 @@
 | 
			
		|||
/*
 | 
			
		||||
             LUFA Library
 | 
			
		||||
     Copyright (C) Dean Camera, 2011.
 | 
			
		||||
 | 
			
		||||
  dean [at] fourwalledcubicle [dot] com
 | 
			
		||||
           www.lufa-lib.org
 | 
			
		||||
*/
 | 
			
		||||
 | 
			
		||||
/*
 | 
			
		||||
  Copyright 2011  Dean Camera (dean [at] fourwalledcubicle [dot] com)
 | 
			
		||||
 | 
			
		||||
  Permission to use, copy, modify, distribute, and sell this
 | 
			
		||||
  software and its documentation for any purpose is hereby granted
 | 
			
		||||
  without fee, provided that the above copyright notice appear in
 | 
			
		||||
  all copies and that both that the copyright notice and this
 | 
			
		||||
  permission notice and warranty disclaimer appear in supporting
 | 
			
		||||
  documentation, and that the name of the author not be used in
 | 
			
		||||
  advertising or publicity pertaining to distribution of the
 | 
			
		||||
  software without specific, written prior permission.
 | 
			
		||||
 | 
			
		||||
  The author disclaim all warranties with regard to this
 | 
			
		||||
  software, including all implied warranties of merchantability
 | 
			
		||||
  and fitness.  In no event shall the author be liable for any
 | 
			
		||||
  special, indirect or consequential damages or any damages
 | 
			
		||||
  whatsoever resulting from loss of use, data or profits, whether
 | 
			
		||||
  in an action of contract, negligence or other tortious action,
 | 
			
		||||
  arising out of or in connection with the use or performance of
 | 
			
		||||
  this software.
 | 
			
		||||
*/
 | 
			
		||||
 | 
			
		||||
/** \file
 | 
			
		||||
 *
 | 
			
		||||
 *  Header file for MediaControl.c.
 | 
			
		||||
 */
 | 
			
		||||
 | 
			
		||||
#ifndef _MEDIACONTROL_H_
 | 
			
		||||
#define _MEDIACONTROL_H_
 | 
			
		||||
 | 
			
		||||
	/* Includes: */
 | 
			
		||||
		#include <avr/io.h>
 | 
			
		||||
		#include <avr/wdt.h>
 | 
			
		||||
		#include <avr/power.h>
 | 
			
		||||
		#include <avr/interrupt.h>
 | 
			
		||||
		#include <stdbool.h>
 | 
			
		||||
		#include <string.h>
 | 
			
		||||
 | 
			
		||||
		#include "Descriptors.h"
 | 
			
		||||
 | 
			
		||||
		#include <LUFA/Version.h>
 | 
			
		||||
		#include <LUFA/Drivers/Board/Joystick.h>
 | 
			
		||||
		#include <LUFA/Drivers/Board/LEDs.h>
 | 
			
		||||
		#include <LUFA/Drivers/Board/Buttons.h>
 | 
			
		||||
		#include <LUFA/Drivers/USB/USB.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)
 | 
			
		||||
 | 
			
		||||
	/* Type Defines: */
 | 
			
		||||
		/** Type define for a Media Control HID report. This report contains the bits to match the usages defined
 | 
			
		||||
		 *  in the HID report of the device. When set to a true value, the relevant media controls on the host will
 | 
			
		||||
		 *  be triggered.
 | 
			
		||||
		 */
 | 
			
		||||
		typedef struct
 | 
			
		||||
		{
 | 
			
		||||
			unsigned Play           : 1;
 | 
			
		||||
			unsigned Pause          : 1;
 | 
			
		||||
			unsigned Record         : 1;
 | 
			
		||||
			unsigned FForward       : 1;
 | 
			
		||||
			unsigned Rewind         : 1;
 | 
			
		||||
			unsigned NextTrack      : 1;
 | 
			
		||||
			unsigned PreviousTrack  : 1;
 | 
			
		||||
			unsigned Stop           : 1;
 | 
			
		||||
			unsigned PlayPause      : 1;
 | 
			
		||||
			unsigned Mute           : 1;
 | 
			
		||||
			unsigned VolumeUp       : 1;
 | 
			
		||||
			unsigned VolumeDown     : 1;
 | 
			
		||||
			unsigned PADDING        : 4;
 | 
			
		||||
		} ATTR_PACKED USB_MediaReport_Data_t;
 | 
			
		||||
 | 
			
		||||
	/* Function Prototypes: */
 | 
			
		||||
		void SetupHardware(void);
 | 
			
		||||
 | 
			
		||||
		void EVENT_USB_Device_Connect(void);
 | 
			
		||||
		void EVENT_USB_Device_Disconnect(void);
 | 
			
		||||
		void EVENT_USB_Device_ConfigurationChanged(void);
 | 
			
		||||
		void EVENT_USB_Device_ControlRequest(void);
 | 
			
		||||
		void EVENT_USB_Device_StartOfFrame(void);
 | 
			
		||||
 | 
			
		||||
		bool CALLBACK_HID_Device_CreateHIDReport(USB_ClassInfo_HID_Device_t* const HIDInterfaceInfo,
 | 
			
		||||
		                                         uint8_t* const ReportID,
 | 
			
		||||
		                                         const uint8_t ReportType,
 | 
			
		||||
		                                         void* ReportData,
 | 
			
		||||
		                                         uint16_t* const ReportSize);
 | 
			
		||||
		void CALLBACK_HID_Device_ProcessHIDReport(USB_ClassInfo_HID_Device_t* const HIDInterfaceInfo,
 | 
			
		||||
		                                          const uint8_t ReportID,
 | 
			
		||||
		                                          const uint8_t ReportType,
 | 
			
		||||
		                                          const void* ReportData,
 | 
			
		||||
		                                          const uint16_t ReportSize);
 | 
			
		||||
 | 
			
		||||
#endif
 | 
			
		||||
 | 
			
		||||
							
								
								
									
										66
									
								
								Projects/MediaController/MediaController.txt
									
										
									
									
									
										Normal file
									
								
							
							
						
						
									
										66
									
								
								Projects/MediaController/MediaController.txt
									
										
									
									
									
										Normal file
									
								
							| 
						 | 
				
			
			@ -0,0 +1,66 @@
 | 
			
		|||
/** \file
 | 
			
		||||
 *
 | 
			
		||||
 *  This file contains special DoxyGen information for the generation of the main page and other special
 | 
			
		||||
 *  documentation pages. It is not a project source file.
 | 
			
		||||
 */
 | 
			
		||||
 | 
			
		||||
/** \mainpage Media Controller Project
 | 
			
		||||
 *
 | 
			
		||||
 *  \section Sec_Compat Project Compatibility:
 | 
			
		||||
 *
 | 
			
		||||
 *  The following list indicates what microcontrollers are compatible with this project.
 | 
			
		||||
 *
 | 
			
		||||
 *  - Series 7 USB AVRs (AT90USBxxx7)
 | 
			
		||||
 *  - Series 6 USB AVRs (AT90USBxxx6)
 | 
			
		||||
 *  - Series 4 USB AVRs (ATMEGAxxU4)
 | 
			
		||||
 *  - Series 2 USB AVRs (AT90USBxx2, ATMEGAxxU2)
 | 
			
		||||
 *
 | 
			
		||||
 *  \section Sec_Info USB Information:
 | 
			
		||||
 *
 | 
			
		||||
 *  The following table gives a rundown of the USB utilization of this demo.
 | 
			
		||||
 *
 | 
			
		||||
 *  <table>
 | 
			
		||||
 *   <tr>
 | 
			
		||||
 *    <td><b>USB Mode:</b></td>
 | 
			
		||||
 *    <td>Device</td>
 | 
			
		||||
 *   </tr>
 | 
			
		||||
 *   <tr>
 | 
			
		||||
 *    <td><b>USB Class:</b></td>
 | 
			
		||||
 *    <td>Human Interface Device (HID)</td>
 | 
			
		||||
 *   </tr>
 | 
			
		||||
 *   <tr>
 | 
			
		||||
 *    <td><b>USB Subclass:</b></td>
 | 
			
		||||
 *    <td>N/A</td>
 | 
			
		||||
 *   </tr>
 | 
			
		||||
 *   <tr>
 | 
			
		||||
 *    <td><b>Relevant Standards:</b></td>
 | 
			
		||||
 *    <td>USBIF HID Specification \n
 | 
			
		||||
 *        USBIF HID Usage Tables</td>
 | 
			
		||||
 *   </tr>
 | 
			
		||||
 *   <tr>
 | 
			
		||||
 *    <td><b>Usable Speeds:</b></td>
 | 
			
		||||
 *    <td>Low Speed Mode \n
 | 
			
		||||
 *        Full Speed Mode</td>
 | 
			
		||||
 *   </tr>
 | 
			
		||||
 *  </table>
 | 
			
		||||
 *
 | 
			
		||||
 *  \section Sec_Description Project Description:
 | 
			
		||||
 *
 | 
			
		||||
 *  Media Controller project. This project implements a basic Media Control device, to signal the host to play, pause, toggle playback,
 | 
			
		||||
 *  mute and/or adjust the host volume, in addition to other such media commands. This project may be extended to create a dedicated
 | 
			
		||||
 *  media playback control device, for home media centers or other equipment. By default, some of the most commonly used playback controls
 | 
			
		||||
 *  are controlled by the board joystick and LEDs, however this may be altered as desired.
 | 
			
		||||
 *
 | 
			
		||||
 *  \section Sec_Options Project Options
 | 
			
		||||
 *
 | 
			
		||||
 *  The following defines can be found in this project, which can control the project behaviour when defined, or changed in value.
 | 
			
		||||
 *
 | 
			
		||||
 *  <table>
 | 
			
		||||
 *   <tr>
 | 
			
		||||
 *    <td>
 | 
			
		||||
 *     None
 | 
			
		||||
 *    </td>
 | 
			
		||||
 *   </tr>
 | 
			
		||||
 *  </table>
 | 
			
		||||
 */
 | 
			
		||||
 | 
			
		||||
							
								
								
									
										717
									
								
								Projects/MediaController/makefile
									
										
									
									
									
										Normal file
									
								
							
							
						
						
									
										717
									
								
								Projects/MediaController/makefile
									
										
									
									
									
										Normal file
									
								
							| 
						 | 
				
			
			@ -0,0 +1,717 @@
 | 
			
		|||
# 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 = at90usb1287
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
# Target architecture (see library "Board Types" documentation).
 | 
			
		||||
ARCH = AVR8
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
# Target board (see library "Board Types" documentation, NONE 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 in Hz. 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.
 | 
			
		||||
#
 | 
			
		||||
#     This will be an integer division of F_USB below, as it is sourced by
 | 
			
		||||
#     F_USB after it has run through any CPU prescalers. Note that this value
 | 
			
		||||
#     does not *change* the processor frequency - it should merely be updated to
 | 
			
		||||
#     reflect the processor speed set externally so that the code can use accurate
 | 
			
		||||
#     software delays.
 | 
			
		||||
F_CPU = 8000000
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
# Input clock frequency.
 | 
			
		||||
#     This will define a symbol, F_USB, in all source code files equal to the
 | 
			
		||||
#     input clock frequency (before any prescaling is performed) in Hz. 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_USB = $(F_CPU)
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
# Output format. (can be srec, ihex, binary)
 | 
			
		||||
FORMAT = ihex
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
# Target file name (without extension).
 | 
			
		||||
TARGET = MediaController
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
# 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 and predefined tokens
 | 
			
		||||
LUFA_OPTS  = -D USB_DEVICE_ONLY
 | 
			
		||||
LUFA_OPTS += -D FIXED_CONTROL_ENDPOINT_SIZE=8
 | 
			
		||||
LUFA_OPTS += -D FIXED_NUM_CONFIGURATIONS=1
 | 
			
		||||
LUFA_OPTS += -D USE_FLASH_DESCRIPTORS
 | 
			
		||||
LUFA_OPTS += -D USE_STATIC_OPTIONS="(USB_DEVICE_OPT_FULLSPEED | USB_OPT_REG_ENABLED | USB_OPT_AUTO_PLL)"
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
# Create the LUFA source path variables by including the LUFA root makefile
 | 
			
		||||
include $(LUFA_PATH)/LUFA/makefile
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
# List C source files here. (C dependencies are automatically generated.)
 | 
			
		||||
SRC = $(TARGET).c                                                 \
 | 
			
		||||
	  Descriptors.c                                               \
 | 
			
		||||
	  $(LUFA_SRC_USB)                                             \
 | 
			
		||||
	  $(LUFA_SRC_USBCLASS)
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
# 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=c99
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
# Place -D or -U options here for C sources
 | 
			
		||||
CDEFS  = -DF_CPU=$(F_CPU)UL
 | 
			
		||||
CDEFS += -DF_USB=$(F_USB)UL
 | 
			
		||||
CDEFS += -DBOARD=BOARD_$(BOARD) -DARCH=ARCH_$(ARCH)
 | 
			
		||||
CDEFS += $(LUFA_OPTS)
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
# Place -D or -U options here for ASM sources
 | 
			
		||||
ADEFS  = -DF_CPU=$(F_CPU)
 | 
			
		||||
ADEFS += -DF_USB=$(F_USB)UL
 | 
			
		||||
ADEFS += -DBOARD=BOARD_$(BOARD) -DARCH=ARCH_$(ARCH)
 | 
			
		||||
ADEFS += $(LUFA_OPTS)
 | 
			
		||||
 | 
			
		||||
# Place -D or -U options here for C++ sources
 | 
			
		||||
CPPDEFS  = -DF_CPU=$(F_CPU)UL
 | 
			
		||||
CPPDEFS += -DF_USB=$(F_USB)UL
 | 
			
		||||
CPPDEFS += -DBOARD=BOARD_$(BOARD) -DARCH=ARCH_$(ARCH)
 | 
			
		||||
CPPDEFS += $(LUFA_OPTS)
 | 
			
		||||
#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 += -fno-inline-small-functions
 | 
			
		||||
CFLAGS += -fpack-struct
 | 
			
		||||
CFLAGS += -fshort-enums
 | 
			
		||||
CFLAGS += -fno-strict-aliasing
 | 
			
		||||
CFLAGS += -Wall
 | 
			
		||||
CFLAGS += -Wstrict-prototypes
 | 
			
		||||
#CFLAGS += -mshort-calls
 | 
			
		||||
#CFLAGS += -fno-unit-at-a-time
 | 
			
		||||
#CFLAGS += -Wundef
 | 
			
		||||
#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
 | 
			
		||||
CPPFLAGS += -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
 | 
			
		||||
# 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 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
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
# 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 $(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
 | 
			
		||||
	$(REMOVE) $(TARGET)eep.hex
 | 
			
		||||
 | 
			
		||||
dfu-ee: $(TARGET).hex $(TARGET).eep
 | 
			
		||||
	dfu-programmer $(MCU) eeprom-flash $(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 -R .fuse -R .lock $< $@
 | 
			
		||||
 | 
			
		||||
%.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 -S -z $< > $@
 | 
			
		||||
 | 
			
		||||
# 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 end
 | 
			
		||||
 | 
			
		||||
clean_list :
 | 
			
		||||
	@echo
 | 
			
		||||
	@echo $(MSG_CLEANING)
 | 
			
		||||
	$(REMOVE) $(TARGET).hex
 | 
			
		||||
	$(REMOVE) $(TARGET).eep
 | 
			
		||||
	$(REMOVE) $(TARGET).cof
 | 
			
		||||
	$(REMOVE) $(TARGET).elf
 | 
			
		||||
	$(REMOVE) $(TARGET).map
 | 
			
		||||
	$(REMOVE) $(TARGET).sym
 | 
			
		||||
	$(REMOVE) $(TARGET).lss
 | 
			
		||||
	$(REMOVE) $(SRC:%.c=$(OBJDIR)/%.o) $(CPPSRC:%.cpp=$(OBJDIR)/%.o) $(ASRC:%.S=$(OBJDIR)/%.o)
 | 
			
		||||
	$(REMOVE) $(SRC:%.c=$(OBJDIR)/%.lst) $(CPPSRC:%.cpp=$(OBJDIR)/%.lst) $(ASRC:%.S=$(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 begin finish end sizebefore sizeafter gccversion \
 | 
			
		||||
build elf hex eep lss sym coff extcoff doxygen clean          \
 | 
			
		||||
clean_list clean_doxygen program dfu flip flip-ee dfu-ee      \
 | 
			
		||||
debug gdb-config
 | 
			
		||||
 | 
			
		||||
| 
						 | 
				
			
			@ -67,7 +67,7 @@ const USB_Descriptor_Device_t PROGMEM DeviceDescriptor =
 | 
			
		|||
 | 
			
		||||
	.VendorID               = 0x03EB,
 | 
			
		||||
	.ProductID              = 0x2069,
 | 
			
		||||
	.ReleaseNumber          = VERSION_BCD(00.10),
 | 
			
		||||
	.ReleaseNumber          = VERSION_BCD(00.01),
 | 
			
		||||
 | 
			
		||||
	.ManufacturerStrIndex   = 0x01,
 | 
			
		||||
	.ProductStrIndex        = 0x02,
 | 
			
		||||
| 
						 | 
				
			
			
 | 
			
		|||
| 
						 | 
				
			
			@ -26,6 +26,9 @@ all:
 | 
			
		|||
	$(MAKE) -C Magstripe clean
 | 
			
		||||
	$(MAKE) -C Magstripe all
 | 
			
		||||
 | 
			
		||||
	$(MAKE) -C MediaControl clean
 | 
			
		||||
	$(MAKE) -C MediaControl all
 | 
			
		||||
 | 
			
		||||
	$(MAKE) -C MIDIToneGenerator clean
 | 
			
		||||
	$(MAKE) -C MIDIToneGenerator all
 | 
			
		||||
 | 
			
		||||
| 
						 | 
				
			
			@ -52,6 +55,7 @@ all:
 | 
			
		|||
	$(MAKE) -C Benito $@
 | 
			
		||||
	$(MAKE) -C LEDNotifier $@
 | 
			
		||||
	$(MAKE) -C Magstripe $@
 | 
			
		||||
	$(MAKE) -C MediaControl $@
 | 
			
		||||
	$(MAKE) -C MissileLauncher $@
 | 
			
		||||
	$(MAKE) -C RelayBoard $@
 | 
			
		||||
	$(MAKE) -C TempDataLogger $@
 | 
			
		||||
| 
						 | 
				
			
			
 | 
			
		|||
		Loading…
	
	Add table
		Add a link
		
	
		Reference in a new issue