Dean Camera
9 years ago
parent
51d3adfe18
commit
0ecd09c3e1
@ -0,0 +1,43 @@
|
||||
#
|
||||
# LUFA Library
|
||||
# Copyright (C) Dean Camera, 2015.
|
||||
#
|
||||
# dean [at] fourwalledcubicle [dot] com
|
||||
# www.lufa-lib.org
|
||||
#
|
||||
|
||||
DMBS_BUILD_MODULES += LUFA_GCC
|
||||
DMBS_BUILD_TARGETS +=
|
||||
DMBS_BUILD_MANDATORY_VARS += LUFA_PATH ARCH F_USB
|
||||
DMBS_BUILD_OPTIONAL_VARS += BOARD
|
||||
DMBS_BUILD_PROVIDED_VARS +=
|
||||
DMBS_BUILD_PROVIDED_MACROS +=
|
||||
|
||||
SHELL = /bin/sh
|
||||
|
||||
ERROR_IF_UNSET ?= $(if $(filter undefined, $(origin $(strip $(1)))), $(error Makefile $(strip $(1)) value not set))
|
||||
ERROR_IF_EMPTY ?= $(if $(strip $($(strip $(1)))), , $(error Makefile $(strip $(1)) option cannot be blank))
|
||||
ERROR_IF_NONBOOL ?= $(if $(filter Y N, $($(strip $(1)))), , $(error Makefile $(strip $(1)) option must be Y or N))
|
||||
|
||||
# Sanity check user supplied values
|
||||
$(call ERROR_IF_EMPTY, LUFA_PATH)
|
||||
$(call ERROR_IF_EMPTY, ARCH)
|
||||
$(call ERROR_IF_EMPTY, F_USB)
|
||||
|
||||
# Default values of optionally user-supplied variables
|
||||
BOARD ?= NONE
|
||||
|
||||
# Determine the utility prefix to use for the selected architecture
|
||||
ifeq ($(ARCH), XMEGA)
|
||||
$(warning The XMEGA device support is currently EXPERIMENTAL (incomplete and/or non-functional), and is included for preview purposes only.)
|
||||
else ifeq ($(ARCH), UC3)
|
||||
$(warning The UC3 device support is currently EXPERIMENTAL (incomplete and/or non-functional), and is included for preview purposes only.)
|
||||
endif
|
||||
|
||||
# Common LUFA C/C++ includes/definitions
|
||||
LUFA_CXX_INCLUDES = -I. -I$(patsubst %/,%,$(LUFA_PATH))/..
|
||||
LUFA_CXX_DEFINES = -DARCH=ARCH_$(ARCH) -DBOARD=BOARD_$(BOARD) -DF_USB=$(F_USB)UL
|
||||
|
||||
# LUFA specific standard build options
|
||||
C_FLAGS += $(LUFA_CXX_INCLUDES) $(LUFA_CXX_DEFINES) $(LUFA_CXX_FLAGS)
|
||||
CPP_FLAGS += $(LUFA_CXX_INCLUDES) $(LUFA_CXX_DEFINES) $(LUFA_CXX_FLAGS)
|
||||
@ -0,0 +1,95 @@
|
||||
#
|
||||
# LUFA Library
|
||||
# Copyright (C) Dean Camera, 2015.
|
||||
#
|
||||
# dean [at] fourwalledcubicle [dot] com
|
||||
# www.lufa-lib.org
|
||||
#
|
||||
|
||||
DMBS_BUILD_MODULES += LUFA_SOURCES
|
||||
DMBS_BUILD_TARGETS +=
|
||||
DMBS_BUILD_MANDATORY_VARS += LUFA_PATH ARCH
|
||||
DMBS_BUILD_OPTIONAL_VARS +=
|
||||
DMBS_BUILD_PROVIDED_VARS += LUFA_SRC_USB_DEVICE LUFA_SRC_USB_HOST \
|
||||
LUFA_SRC_USB LUFA_SRC_USBCLASS_DEVICE \
|
||||
LUFA_SRC_USBCLASS_HOST LUFA_SRC_USBCLASS \
|
||||
LUFA_SRC_TEMPERATURE LUFA_SRC_SERIAL \
|
||||
LUFA_SRC_TWI LUFA_SRC_PLATFORM
|
||||
DMBS_BUILD_PROVIDED_MACROS +=
|
||||
|
||||
SHELL = /bin/sh
|
||||
|
||||
ERROR_IF_UNSET ?= $(if $(filter undefined, $(origin $(strip $(1)))), $(error Makefile $(strip $(1)) value not set))
|
||||
ERROR_IF_EMPTY ?= $(if $(strip $($(strip $(1)))), , $(error Makefile $(strip $(1)) option cannot be blank))
|
||||
ERROR_IF_NONBOOL ?= $(if $(filter Y N, $($(strip $(1)))), , $(error Makefile $(strip $(1)) option must be Y or N))
|
||||
|
||||
# Sanity check user supplied values
|
||||
$(foreach MANDATORY_VAR, $(LUFA_BUILD_MANDATORY_VARS), $(call ERROR_IF_UNSET, $(MANDATORY_VAR)))
|
||||
$(call ERROR_IF_EMPTY, LUFA_PATH)
|
||||
$(call ERROR_IF_EMPTY, ARCH)
|
||||
|
||||
# Allow LUFA_ROOT_PATH to be overridden elsewhere to support legacy LUFA makefiles
|
||||
LUFA_ROOT_PATH ?= $(patsubst %/,%,$(LUFA_PATH))
|
||||
|
||||
# Construct LUFA module source variables
|
||||
LUFA_SRC_USB_COMMON := $(LUFA_ROOT_PATH)/Drivers/USB/Core/$(ARCH)/USBController_$(ARCH).c \
|
||||
$(LUFA_ROOT_PATH)/Drivers/USB/Core/$(ARCH)/USBInterrupt_$(ARCH).c \
|
||||
$(LUFA_ROOT_PATH)/Drivers/USB/Core/ConfigDescriptors.c \
|
||||
$(LUFA_ROOT_PATH)/Drivers/USB/Core/Events.c \
|
||||
$(LUFA_ROOT_PATH)/Drivers/USB/Core/USBTask.c \
|
||||
$(LUFA_ROOT_PATH)/Drivers/USB/Class/Common/HIDParser.c \
|
||||
|
||||
LUFA_SRC_USB_HOST := $(LUFA_ROOT_PATH)/Drivers/USB/Core/$(ARCH)/Host_$(ARCH).c \
|
||||
$(LUFA_ROOT_PATH)/Drivers/USB/Core/$(ARCH)/Pipe_$(ARCH).c \
|
||||
$(LUFA_ROOT_PATH)/Drivers/USB/Core/$(ARCH)/PipeStream_$(ARCH).c \
|
||||
$(LUFA_ROOT_PATH)/Drivers/USB/Core/HostStandardReq.c \
|
||||
$(LUFA_SRC_USB_COMMON)
|
||||
|
||||
LUFA_SRC_USB_DEVICE := $(LUFA_ROOT_PATH)/Drivers/USB/Core/$(ARCH)/Device_$(ARCH).c \
|
||||
$(LUFA_ROOT_PATH)/Drivers/USB/Core/$(ARCH)/Endpoint_$(ARCH).c \
|
||||
$(LUFA_ROOT_PATH)/Drivers/USB/Core/$(ARCH)/EndpointStream_$(ARCH).c \
|
||||
$(LUFA_ROOT_PATH)/Drivers/USB/Core/DeviceStandardReq.c \
|
||||
$(LUFA_SRC_USB_COMMON)
|
||||
|
||||
LUFA_SRC_USBCLASS_DEVICE := $(LUFA_ROOT_PATH)/Drivers/USB/Class/Device/AudioClassDevice.c \
|
||||
$(LUFA_ROOT_PATH)/Drivers/USB/Class/Device/CDCClassDevice.c \
|
||||
$(LUFA_ROOT_PATH)/Drivers/USB/Class/Device/HIDClassDevice.c \
|
||||
$(LUFA_ROOT_PATH)/Drivers/USB/Class/Device/MassStorageClassDevice.c \
|
||||
$(LUFA_ROOT_PATH)/Drivers/USB/Class/Device/MIDIClassDevice.c \
|
||||
$(LUFA_ROOT_PATH)/Drivers/USB/Class/Device/PrinterClassDevice.c \
|
||||
$(LUFA_ROOT_PATH)/Drivers/USB/Class/Device/RNDISClassDevice.c \
|
||||
|
||||
LUFA_SRC_USBCLASS_HOST := $(LUFA_ROOT_PATH)/Drivers/USB/Class/Host/AndroidAccessoryClassHost.c \
|
||||
$(LUFA_ROOT_PATH)/Drivers/USB/Class/Host/AudioClassHost.c \
|
||||
$(LUFA_ROOT_PATH)/Drivers/USB/Class/Host/CDCClassHost.c \
|
||||
$(LUFA_ROOT_PATH)/Drivers/USB/Class/Host/HIDClassHost.c \
|
||||
$(LUFA_ROOT_PATH)/Drivers/USB/Class/Host/MassStorageClassHost.c \
|
||||
$(LUFA_ROOT_PATH)/Drivers/USB/Class/Host/MIDIClassHost.c \
|
||||
$(LUFA_ROOT_PATH)/Drivers/USB/Class/Host/PrinterClassHost.c \
|
||||
$(LUFA_ROOT_PATH)/Drivers/USB/Class/Host/RNDISClassHost.c \
|
||||
$(LUFA_ROOT_PATH)/Drivers/USB/Class/Host/StillImageClassHost.c
|
||||
|
||||
LUFA_SRC_USB := $(sort $(LUFA_SRC_USB_COMMON) $(LUFA_SRC_USB_HOST) $(LUFA_SRC_USB_DEVICE))
|
||||
|
||||
LUFA_SRC_USBCLASS := $(LUFA_SRC_USBCLASS_DEVICE) $(LUFA_SRC_USBCLASS_HOST)
|
||||
|
||||
LUFA_SRC_TEMPERATURE := $(LUFA_ROOT_PATH)/Drivers/Board/Temperature.c
|
||||
|
||||
LUFA_SRC_SERIAL := $(LUFA_ROOT_PATH)/Drivers/Peripheral/$(ARCH)/Serial_$(ARCH).c
|
||||
|
||||
LUFA_SRC_TWI := $(LUFA_ROOT_PATH)/Drivers/Peripheral/$(ARCH)/TWI_$(ARCH).c
|
||||
|
||||
ifeq ($(ARCH), UC3)
|
||||
LUFA_SRC_PLATFORM := $(LUFA_ROOT_PATH)/Platform/UC3/Exception.S \
|
||||
$(LUFA_ROOT_PATH)/Platform/UC3/InterruptManagement.c
|
||||
else
|
||||
LUFA_SRC_PLATFORM :=
|
||||
endif
|
||||
|
||||
# Build a list of all available module sources
|
||||
LUFA_SRC_ALL_FILES := $(LUFA_SRC_USB) \
|
||||
$(LUFA_SRC_USBCLASS) \
|
||||
$(LUFA_SRC_TEMPERATURE) \
|
||||
$(LUFA_SRC_SERIAL) \
|
||||
$(LUFA_SRC_TWI) \
|
||||
$(LUFA_SRC_PLATFORM)
|
||||
@ -1,112 +0,0 @@
|
||||
/** \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.
|
||||
*/
|
||||
|
||||
/** \page Page_ExportingLibrary Exporting the Library for IDE Use
|
||||
*
|
||||
* While LUFA was designed to allow for easy compilation in a makefile driven environment,
|
||||
* it is possible to export the library into a form suitable for drop-in use inside of an
|
||||
* IDE.
|
||||
*
|
||||
* \note <b>LUFA is also available as a native Atmel Studio 6.1 extension</b>, which integrates LUFA into
|
||||
* Atmel Studio including all demos and projects. If you are running Atmel Studio 6.1 or later, the
|
||||
* below instructions are not required; download and install the native LUFA extension from the
|
||||
* <a href="http://gallery.atmel.com">Atmel Gallery</a> instead.
|
||||
*
|
||||
* \section Sec_LibraryExport Exporting the Library
|
||||
* An export of the library is at its most basic, a direct copy of the main "LUFA" source folder from the
|
||||
* root download folder; this contains the library core which can be re-used within external projects.
|
||||
* However, as many IDEs attempt to automatically compile all included source files, it is necessary to
|
||||
* exclude some directories and files from the library core export to allow for easier integration into
|
||||
* an IDE project.
|
||||
*
|
||||
* \subsection SSec_ManualExport Manual Export
|
||||
* To manually export the library core, copy over the main LUFA library folder from the LUFA root directory,
|
||||
* renaming as desired. Within the library core folder, the following directories should be removed or
|
||||
* excluded from your IDE import:
|
||||
* - Documentation/
|
||||
* - DoxygenPages/
|
||||
* - CodeTemplates/
|
||||
* - StudioIntegration/
|
||||
*
|
||||
* If required, files from the CodeTemplates/ subdirectory may be copied to your IDE project as needed.
|
||||
*
|
||||
* The resulting copy of the library may then be imported into your chosen IDE according to the instructions
|
||||
* shown in \ref Sec_LibraryImport.
|
||||
*
|
||||
* \subsection SSec_AutomaticExport Automatic Export
|
||||
* If desired, the steps indicated in \ref SSec_ManualExport may be automatically performed, by running the
|
||||
* command <b><code>make export_tar</code></b> from the command line. This will generate two .tar files in the
|
||||
* current directory, named <code>LUFA_YYMMDD.tar</code> and <code>LUFA_YYMMDD_Code_Templates.tar</code> (where
|
||||
* "YYMMDD" is the version of the library being exported). The first archive contains the exported LUFA core
|
||||
* with the non-required files removed, while the second contains an archived copy of the code template files
|
||||
* for the current LUFA version.
|
||||
*
|
||||
* The resulting archived copy of the library may then be extracted to your chosen IDE project source directory
|
||||
* and imported according to the instructions shown in \ref Sec_LibraryImport.
|
||||
*
|
||||
* \section Sec_LibraryImport Importing the Library
|
||||
* An exported copy of the library may be imported wholesale into an IDE project, if the instructions detailed
|
||||
* in \ref Sec_LibraryExport are followed.
|
||||
*
|
||||
* Specific instructions for importing an exported version of LUFA into various IDEs are listed below.
|
||||
*
|
||||
* \subsection SSec_AS56_Import Importing into AVRStudio 5.x/Atmel Studio 6.0
|
||||
* To import LUFA into a new or existing project, the following steps must be followed.
|
||||
*
|
||||
* \subsubsection SSSec_AS56_Import_Step1 Copy over the exported library
|
||||
* Copy over the exported library archive created via the steps listed in \ref Sec_LibraryExport to your AS5/AS6
|
||||
* project directory.
|
||||
*
|
||||
* \image html Images/AS5_AS6_Import/AS5_AS6_Import_Step1.png
|
||||
*
|
||||
* \subsubsection SSSec_AS56_Import_Step2 Extract exported library
|
||||
* Extract out the contents of the archive to a new folder. This may be any name you wish, however keep in mind
|
||||
* that this name will need to be referenced within your user application under most circumstances. It is
|
||||
* suggested that this folder be named "LUFA", or "LUFA" followed by the version string for easy reference.
|
||||
*
|
||||
* \image html Images/AS5_AS6_Import/AS5_AS6_Import_Step2.png
|
||||
*
|
||||
* \subsubsection SSSec_AS56_Import_Step3 Add the library files
|
||||
* Open your AVRStudio 5/Atmel Studio 6 project. From the "Solution Explorer" pane, click the "Show All Files"
|
||||
* button on the toolbar to display ghosted icons of files and folders located in the project source directory
|
||||
* that are not currently added to the project.
|
||||
*
|
||||
* \image html Images/AS5_AS6_Import/AS5_AS6_Import_Step3.png
|
||||
*
|
||||
* Right-click the ghosted version of the extracted LUFA export folder in the Solution Explorer pane, and
|
||||
* choose the "Add to Project" option from the context menu. This will add the entire LUFA source tree to the
|
||||
* current project.
|
||||
*
|
||||
* \subsubsection SSSec_AS56_Import_Step4 Open Project Toolchain Properties
|
||||
* In the Solution Explorer pane, click the project node, and press the "Properties" button in the toolbar to
|
||||
* open the Project Properties window. This window allows you to configure the various project global compiler,
|
||||
* assembler and linker options.
|
||||
*
|
||||
* \image html Images/AS5_AS6_Import/AS5_AS6_Import_Step4.png
|
||||
*
|
||||
* Click the "Toolchain" tab on the left side of the Project Properties window.
|
||||
*
|
||||
* \subsubsection SSSec_AS56_Import_Step5 Configure Project Toolchain Properties
|
||||
*
|
||||
* In the GNU C Compiler section, open the "Symbols" page. Click the "Add Item" button to the top-right of the
|
||||
* "Defined Symbols" section to add new symbols.
|
||||
*
|
||||
* At a minimum, you will need to define the following symbols (for more information on these symbols, see
|
||||
* \ref Page_ConfiguringApps):
|
||||
* - ARCH
|
||||
* - F_CPU
|
||||
* - F_USB
|
||||
* - BOARD
|
||||
* \image html Images/AS5_AS6_Import/AS5_AS6_Import_Step5_1.png
|
||||
*
|
||||
* Next, open the GNU C Compiler section's "Optimization" page. Ensure that the option to prepare functions for
|
||||
* garbage collection is enabled.
|
||||
* \image html Images/AS5_AS6_Import/AS5_AS6_Import_Step5_2.png
|
||||
*
|
||||
* Finally, in the GNU C Linker section, open the "Optimization" page. Ensure that the option to garbage collect
|
||||
* unused sections is selected.
|
||||
* \image html Images/AS5_AS6_Import/AS5_AS6_Import_Step5_3.png
|
||||
*/
|
||||
|
Before Width: | Height: | Size: 96 KiB |
|
Before Width: | Height: | Size: 98 KiB |
|
Before Width: | Height: | Size: 32 KiB |
|
Before Width: | Height: | Size: 158 KiB |
|
Before Width: | Height: | Size: 43 KiB |
|
Before Width: | Height: | Size: 28 KiB |
|
Before Width: | Height: | Size: 23 KiB |
Loading…
Reference in new issue