/** \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_BuildSystem The LUFA Build System * * \section Sec_BuildSystemOverview Overview of the LUFA Build System * The LUFA build system is an attempt at making a set of re-usable, modular build make files which * can be referenced in a LUFA powered project, to minimise the amount of code required in an * application makefile. The system is written in GNU Make, and each module is independant of * one-another. * * For details on the prerequisites needed for Linux and Windows machines to be able to use the LUFA * build system, see \ref Sec_Prerequisites. * * To use a LUFA build system module, simply add an include to your project makefile. All user projects * should at a minimum include \ref Page_BuildModule_CORE for base functionality: * \code * include $(LUFA_PATH)/Build/lufa_core.mk * \endcode * * Once included in your project makefile, the associated build module targets will be added to your * project's build makefile targets automatically. To call a build target, run make {TARGET_NAME} * from the command line, substituting in the appropriate target name. * * \see \ref Sec_AppConfigParams for a copy of the sample LUFA project makefile. * * Each build module may have one or more mandatory parameters (GNU Make variables) which must * be supplied in the project makefile for the module to work, and one or more optional parameters which * may be defined and which will assume a sensible default if not. * * \section SSec_BuildSystemModules Available Modules * * The following modules are included in this LUFA release: * * \li \subpage Page_BuildModule_ATPROGRAM - Device Programming * \li \subpage Page_BuildModule_AVRDUDE - Device Programming * \li \subpage Page_BuildModule_BUILD - Compiling/Assembling/Linking * \li \subpage Page_BuildModule_CORE - Core Build System Functions * \li \subpage Page_BuildModule_CPPCHECK - Static Code Analysis * \li \subpage Page_BuildModule_DFU - Device Programming * \li \subpage Page_BuildModule_DOXYGEN - Automated Source Code Documentation * \li \subpage Page_BuildModule_HID - Device Programming * \li \subpage Page_BuildModule_SOURCES - LUFA Module Source Code Variables */ /** \page Page_BuildModule_BUILD The BUILD build module * * The BUILD LUFA build system module, providing targets for the compilation, * assembling and linking of an application from source code into binary files * suitable for programming into a target device, using the GCC compiler. * * To use this module in your application makefile, add the following code: * \code * include $(LUFA_PATH)/Build/lufa_build.mk * \endcode * * \section SSec_BuildModule_BUILD_Requirements Requirements * This module requires the the architecture appropriate binaries of the GCC compiler are available in your * system's PATH variable. The GCC compiler and associated toolchain is distributed in Atmel AVR Studio * 5.x and Atmel Studio 6.x installation directories, as well as in many third party distribution packages. * * \section SSec_BuildModule_BUILD_Targets Targets * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
sizeDisplay size of the compiled application FLASH and SRAM segments.
symbol-sizesDisplay a size-sorted list of symbols from the compiled application, in decimal bytes.
check-sourceDisplay a list of input SRC source files which cannot be found (if any).
libBuild and archive all source files into a library A binary file.
allBuild and link the application into ELF debug and HEX binary files.
elfBuild and link the application into an ELF debug file.
hexBuild and link the application and produce HEX and EEP binary files.
lssBuild and link the application and produce a LSS source code/assembly code mixed listing file.
cleanRemove all intermediatary files and binary output files.
mostlycleanRemove all intermediatary files but preserve any binary output files.
* * \section SSec_BuildModule_BUILD_MandatoryParams Mandatory Parameters * * * * * * * * * * * * * * * * * * * * * * * * * * *
TARGETName of the application output file prefix (e.g. TestApplication).
ARCHArchitecture of the target processor (see \ref Page_DeviceSupport).
MCUName of the Atmel processor model (e.g. at90usb1287).
SRCList of relative or absolute paths to the application C (.c), C++ (.cpp) and Assembly (.S) source files.
F_USBSpeed in Hz of the input clock frequency to the target's USB controller.
LUFA_PATHPath to the LUFA library core, either relative or absolute (e.g. ../LUFA-000000/LUFA/).
* * \section SSec_BuildModule_BUILD_OptionalParams Optional Parameters * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
BOARDLUFA board hardware drivers to use (see \ref Page_DeviceSupport).
OPTIMIZATIONOptimization level to use when compiling source files (see GCC manual).
C_STANDARDVersion of the C standard to apply when compiling C++ source files (see GCC manual).
CPP_STANDARDVersion of the C++ standard to apply when compiling C++ source files (see GCC manual).
DEBUG_FORMATFormat of the debug information to embed in the generated object files (see GCC manual).
DEBUG_LEVELLevel of the debugging information to embed in the generated object files (see GCC manual).
F_CPUSpeed of the processor CPU clock, in Hz.
C_FLAGSFlags to pass to the C compiler only, after the automatically generated flags.
CPP_FLAGSFlags to pass to the C++ compiler only, after the automatically generated flags.
ASM_FLAGSFlags to pass to the assembler only, after the automatically generated flags.
CC_FLAGSCommon flags to pass to the C/C++ compiler and assembler, after the automatically generated flags.
LD_FLAGSFlags to pass to the linker, after the automatically generated flags.
OBJDIRDirectory to place the generated object and dependency files. If set to "." the same folder as the source file will be used. * \note When this option is enabled, all source filenames must be unique.
OBJECT_FILESList of additional object files that should be linked into the resulting binary.
* * \section SSec_BuildModule_BUILD_ProvidedVariables Module Provided Variables * * * * * *
None
* * \section SSec_BuildModule_BUILD_ProvidedMacros Module Provided Macros * * * * * *
None
*/ /** \page Page_BuildModule_CORE The CORE build module * * The core LUFA build system module, providing common build system help and information targets. * * To use this module in your application makefile, add the following code: * \code * include $(LUFA_PATH)/Build/lufa_core.mk * \endcode * * \section SSec_BuildModule_CORE_Requirements Requirements * This module has no requirements outside a standard *nix shell like environment; the sh * shell, GNU make and *nix CoreUtils (echo, printf, etc.). * * \section SSec_BuildModule_CORE_Targets Targets * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
helpDisplay build system help and configuration information.
list_targetsList all available build targets from the build system.
list_modulesList all available build modules from the build system.
list_mandatoryList all mandatory parameters required by the included modules.
list_optionalList all optional parameters required by the included modules.
list_providedList all variables provided by the included modules.
list_macrosList all macros provided by the included modules.
* * \section SSec_BuildModule_CORE_MandatoryParams Mandatory Parameters * * * * * *
None
* * \section SSec_BuildModule_CORE_OptionalParams Optional Parameters * * * * * *
None
* * \section SSec_BuildModule_CORE_ProvidedVariables Module Provided Variables * * * * * *
None
* * \section SSec_BuildModule_CORE_ProvidedMacros Module Provided Macros * * * * * *
None
*/ /** \page Page_BuildModule_ATPROGRAM The ATPROGRAM build module * * The ATPROGRAM programming utility LUFA build system module, providing targets to reprogram an * Atmel processor FLASH and EEPROM memories with a project's compiled binary output files. * * To use this module in your application makefile, add the following code: * \code * include $(LUFA_PATH)/Build/lufa_atprogram.mk * \endcode * * \section SSec_BuildModule_ATPROGRAM_Requirements Requirements * This module requires the atprogram.exe utility to be available in your system's PATH * variable. The atprogram.exe utility is distributed in Atmel AVR Studio 5.x and Atmel Studio 6.x * inside the application install folder's "\avrdbg" subdirectory. * * \section SSec_BuildModule_ATPROGRAM_Targets Targets * * * * * * * * * * *
atprogramProgram the device FLASH memory with the application's executable data.
atprogram-eeProgram the device EEPROM memory with the application's EEPROM data.
* * \section SSec_BuildModule_ATPROGRAM_MandatoryParams Mandatory Parameters * * * * * * * * * * *
MCUName of the Atmel processor model (e.g. at90usb1287).
TARGETName of the application output file prefix (e.g. TestApplication).
* * \section SSec_BuildModule_ATPROGRAM_OptionalParams Optional Parameters * * * * * * * * * * * * * * *
ATPROGRAM_PROGRAMMERName of the Atmel programmer or debugger tool to communicate with (e.g. jtagice3).
ATPROGRAM_INTERFACEName of the programming interface to use when programming the target (e.g. spi).
ATPROGRAM_PORTName of the communication port to use when when programming with a serially connected tool (e.g. COM2).
* * \section SSec_BuildModule_ATPROGRAM_ProvidedVariables Module Provided Variables * * * * * *
None
* * \section SSec_BuildModule_ATPROGRAM_ProvidedMacros Module Provided Macros * * * * * *
None
*/ /** \page Page_BuildModule_AVRDUDE The AVRDUDE build module * * The AVRDUDE programming utility LUFA build system module, providing targets to reprogram an * Atmel processor FLASH and EEPROM memories with a project's compiled binary output files. * * To use this module in your application makefile, add the following code: * \code * include $(LUFA_PATH)/Build/lufa_avrdude.mk * \endcode * * \section SSec_BuildModule_AVRDUDE_Requirements Requirements * This module requires the avrdude utility to be available in your system's PATH * variable. The avrdude utility is distributed in the old WinAVR project releases for * Windows (http://winavr.sourceforge.net) or can be installed on *nix systems via the project's * source code (https://savannah.nongnu.org/projects/avrdude) or through the package manager. * * \section SSec_BuildModule_AVRDUDE_Targets Targets * * * * * * * * * * *
avrdudeProgram the device FLASH memory with the application's executable data.
avrdude-eeProgram the device EEPROM memory with the application's EEPROM data.
* * \section SSec_BuildModule_AVRDUDE_MandatoryParams Mandatory Parameters * * * * * * * * * * *
MCUName of the Atmel processor model (e.g. at90usb1287).
TARGETName of the application output file prefix (e.g. TestApplication).
* * \section SSec_BuildModule_AVRDUDE_OptionalParams Optional Parameters * * * * * * * * * * * * * * *
AVRDUDE_PROGRAMMERName of the programmer or debugger tool to communicate with (e.g. jtagicemkii).
AVRDUDE_PORTName of the communication port to use when when programming with the connected tool (e.g. COM2, /dev/ttyUSB0 or usb).
AVRDUDE_FLAGSAdditional flags to pass to avrdude when programming, applied after the automatically generated flags.
* * \section SSec_BuildModule_AVRDUDE_ProvidedVariables Module Provided Variables * * * * * *
None
* * \section SSec_BuildModule_AVRDUDE_ProvidedMacros Module Provided Macros * * * * * *
None
*/ /** \page Page_BuildModule_CPPCHECK The CPPCHECK build module * * The CPPCHECK programming utility LUFA build system module, providing targets to statically * analyze C and C++ source code for errors and performance/style issues. * * To use this module in your application makefile, add the following code: * \code * include $(LUFA_PATH)/Build/lufa_cppcheck.mk * \endcode * * \section SSec_BuildModule_CPPCHECK_Requirements Requirements * This module requires the cppcheck utility to be available in your system's PATH * variable. The cppcheck utility is distributed through the project's home page * (http://cppcheck.sourceforge.net) for Windows, and can be installed on *nix systems via * the project's source code or through the package manager. * * \section SSec_BuildModule_CPPCHECK_Targets Targets * * * * * * * * * * *
cppcheckStatically analyze the project source code for issues.
cppcheck-configCheck the cppcheck configuration - scan source code and warn about missing header files and other issues.
* * \section SSec_BuildModule_CPPCHECK_MandatoryParams Mandatory Parameters * * * * * * *
SRCList of source files to statically analyze.
* * \section SSec_BuildModule_CPPCHECK_OptionalParams Optional Parameters * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
CPPCHECK_INCLUDESPath of extra directories to check when attemting to resolve C/C++ header file includes.
CPPCHECK_EXCLUDESPaths or path fragments to exclude when analyzing.
CPPCHECK_MSG_TEMPLATEOutput message template to use when printing errors, warnings and information (see cppcheck documentation).
CPPCHECK_ENABLEAnalysis rule categories to enable (see cppcheck documentation).
CPPCHECK_SUPPRESSSpecific analysis rules to suppress (see cppcheck documentation).
CPPCHECK_FAIL_ON_WARNINGSet to Y to fail the analysis job with an error exit code if warnings are found, N to continue without failing.
CPPCHECK_QUIETSet to Y to suppress all output except warnings and errors, N to show verbose output information.
CPPCHECK_FLAGSExtra flags to pass to cppcheck, after the automatically generated flags.
* * \section SSec_BuildModule_CPPCHECK_ProvidedVariables Module Provided Variables * * * * * *
None
* * \section SSec_BuildModule_CPPCHECK_ProvidedMacros Module Provided Macros * * * * * *
None
*/ /** \page Page_BuildModule_DFU The DFU build module * * The DFU programming utility LUFA build system module, providing targets to reprogram an * Atmel processor FLASH and EEPROM memories with a project's compiled binary output files. * This module requires a DFU class bootloader to be running in the target, compatible with * the DFU bootloader protocol as published by Atmel. * * To use this module in your application makefile, add the following code: * \code * include $(LUFA_PATH)/Build/lufa_dfu.mk * \endcode * * \section SSec_BuildModule_DFU_Requirements Requirements * This module requires either the batchisp utility from Atmel's FLIP utility, or the open * source dfu-programmer utility (http://dfu-programmer.sourceforge.net/) to be * available in your system's PATH variable. On *nix systems the dfu-programmer utility * can be installed via the project's source code or through the package manager. * * \section SSec_BuildModule_DFU_Targets Targets * * * * * * * * * * * * * * * * * * *
dfuProgram the device FLASH memory with the application's executable data using dfu-programmer.
dfu-eeProgram the device EEPROM memory with the application's EEPROM data using dfu-programmer.
flipProgram the device FLASH memory with the application's executable data using batchisp.
flip-eeProgram the device EEPROM memory with the application's EEPROM data using batchisp.
* * \section SSec_BuildModule_DFU_MandatoryParams Mandatory Parameters * * * * * * * * * * *
MCUName of the Atmel processor model (e.g. at90usb1287).
TARGETName of the application output file prefix (e.g. TestApplication).
* * \section SSec_BuildModule_DFU_OptionalParams Optional Parameters * * * * * *
None
* * \section SSec_BuildModule_DFU_ProvidedVariables Module Provided Variables * * * * * *
None
* * \section SSec_BuildModule_DFU_ProvidedMacros Module Provided Macros * * * * * *
None
*/ /** \page Page_BuildModule_DOXYGEN The DOXYGEN build module * * The DOXYGEN code documentation utility LUFA build system module, providing targets to generate * project HTML and other format documentation from a set of source files that include special * Doxygen comments. * * To use this module in your application makefile, add the following code: * \code * include $(LUFA_PATH)/Build/lufa_doxygen.mk * \endcode * * \section SSec_BuildModule_DOXYGEN_Requirements Requirements * This module requires the doxygen utility from the Doxygen website * (http://www.stack.nl/~dimitri/doxygen/) to be available in your system's PATH * variable. On *nix systems the doxygen utility can be installed via the project's source * code or through the package manager. * * \section SSec_BuildModule_DOXYGEN_Targets Targets * * * * * * *
doxygenGenerate project documentation.
* * \section SSec_BuildModule_DOXYGEN_MandatoryParams Mandatory Parameters * * * * * * *
LUFA_PATHPath to the LUFA library core, either relative or absolute (e.g. ../LUFA-000000/LUFA/).
* * \section SSec_BuildModule_DOXYGEN_OptionalParams Optional Parameters * * * * * * * * * * * * * * *
DOXYGEN_CONFName and path of the base Doxygen configuration file for the project.
DOXYGEN_FAIL_ON_WARNINGSet to Y to fail the generation with an error exit code if warnings are found other than unsupported configuration parameters, N to continue without failing.
DOXYGEN_OVERRIDE_PARAMSExtra Doxygen configuration parameters to apply, overriding the corresponding config entry in the project's configuration file (e.g. QUIET=YES).
* * \section SSec_BuildModule_DOXYGEN_ProvidedVariables Module Provided Variables * * * * * *
None
* * \section SSec_BuildModule_DOXYGEN_ProvidedMacros Module Provided Macros * * * * * *
None
*/ /** \page Page_BuildModule_HID The HID build module * * The HID programming utility LUFA build system module, providing targets to reprogram an * Atmel processor's FLASH memory with a project's compiled binary output file. This module * requires a HID class bootloader to be running in the target, using a protocol compatible * with the PJRC "HalfKay" protocol (http://www.pjrc.com/teensy/halfkay_protocol.html). * * To use this module in your application makefile, add the following code: * \code * include $(LUFA_PATH)/Build/lufa_hid.mk * \endcode * * \section SSec_BuildModule_HID_Requirements Requirements * This module requires either the hid_bootloader_cli utility from the included LUFA HID * class bootloader API subdirectory, or the teensy_loader_cli utility from PJRC * (http://www.pjrc.com/teensy/loader_cli.html) to be available in your system's PATH * variable. * * \section SSec_BuildModule_HID_Targets Targets * * * * * * * * * * * * * * * * * * *
hidProgram the device FLASH memory with the application's executable data using hid_bootloader_cli.
hid-eeProgram the device EEPROM memory with the application's EEPROM data using hid_bootloader_cli and * a temporary AVR application programmed into the target's FLASH. * \note This will erase the currently loaded application in the target.
teensyProgram the device FLASH memory with the application's executable data using teensy_loader_cli.
teensy-eeProgram the device EEPROM memory with the application's EEPROM data using teensy_loader_cli and * a temporary AVR application programmed into the target's FLASH. * \note This will erase the currently loaded application in the target.
* * \section SSec_BuildModule_HID_MandatoryParams Mandatory Parameters * * * * * * * * * * *
MCUName of the Atmel processor model (e.g. at90usb1287).
TARGETName of the application output file prefix (e.g. TestApplication).
* * \section SSec_BuildModule_HID_OptionalParams Optional Parameters * * * * * *
None
* * \section SSec_BuildModule_HID_ProvidedVariables Module Provided Variables * * * * * *
None
* * \section SSec_BuildModule_HID_ProvidedMacros Module Provided Macros * * * * * *
None
*/ /** \page Page_BuildModule_SOURCES The SOURCES build module * * The SOURCES LUFA build system module, providing variables listing the various LUFA source files * required to be build by a project for a given LUFA module. This module gives a way to reference * LUFA source files symbollically, so that changes to the library structure do not break the library * makefile. * * To use this module in your application makefile, add the following code: * \code * include $(LUFA_PATH)/Build/lufa_sources.mk * \endcode * * \section SSec_BuildModule_SOURCES_Requirements Requirements * None. * * \section SSec_BuildModule_SOURCES_Targets Targets * * * * * *
None
* * \section SSec_BuildModule_SOURCES_MandatoryParams Mandatory Parameters * * * * * * * * * * *
LUFA_PATHPath to the LUFA library core, either relative or absolute (e.g. ../LUFA-000000/LUFA/).
ARCHArchitecture of the target processor (see \ref Page_DeviceSupport).
* * \section SSec_BuildModule_SOURCES_OptionalParams Optional Parameters * * * * * *
None
* * \section SSec_BuildModule_SOURCES_ProvidedVariables Module Provided Variables * * * * * * * * * * * * * * * * * * * * * * * * * * *
LUFA_SRC_USBList of LUFA USB driver source files.
LUFA_SRC_USBCLASSList of LUFA USB Class driver source files.
LUFA_SRC_TEMPERATUREList of LUFA temperature sensor driver source files.
LUFA_SRC_SERIALList of LUFA Serial U(S)ART driver source files.
LUFA_SRC_TWIList of LUFA TWI driver source files.
LUFA_SRC_PLATFORMList of LUFA architecture specific platform management source files.
* * \section SSec_BuildModule_SOURCES_ProvidedMacros Module Provided Macros * * * * * *
None
*/