X-Git-Url: http://git.linex4red.de/pub/USBasp.git/blobdiff_plain/148b434228cfa94160cc1dbfafc455fd86825fa1..51d3adfe1869e4a45c8368bb00a485be052eecdb:/LUFA/DoxygenPages/BuildSystem.txt diff --git a/LUFA/DoxygenPages/BuildSystem.txt b/LUFA/DoxygenPages/BuildSystem.txt index e8f0e5bec..d5e051b79 100644 --- a/LUFA/DoxygenPages/BuildSystem.txt +++ b/LUFA/DoxygenPages/BuildSystem.txt @@ -6,14 +6,27 @@ /** \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 minimize the amount of code required in an - * application makefile. The system is written in GNU Make, and each module is independent of - * one-another. + * \section Sec_BuildSystem_Overview Overview of the LUFA Build System + * The LUFA build system was originally an attempt at making a set of + * re-usable, modular build make files which could be referenced in a LUFA + * powered project, to minimize the amount of code required in an + * application makefile. + * + * As it turned out to be fairly generic in nature, it was split out into its + * own separate project, called DMBS (Dean's Makefile Build System) + * which is released into the public domain. LUFA specific portions of the + * LUFA build system extend DMBS, and provide a universal build system for all + * LUFA projects. + * + * The latest DMBS project information can be found at: + * https://github.com/abcminiuser/dmbs + * + * DMBS is written in GNU Make, and each module is independent of one-another. + * + * \section SSec_BuildSystem_Using Using the LUFA Build System * * For details on the prerequisites needed for Linux and Windows machines to be able to use the LUFA - * build system, see \ref Sec_Prerequisites. + * build system, see \ref Sec_CompilingApps_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: @@ -25,13 +38,13 @@ * 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_AppMakefileParams for a copy of the sample LUFA project makefile. + * \see \ref Sec_ConfiguringApps_AppMakefileParams 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 + * \section SSec_BuildSystem_Modules Available Modules * * The following modules are included in this LUFA release: * @@ -190,6 +203,10 @@ * Common flags to pass to the C/C++ compiler and assembler, after the automatically generated flags. * * + * COMPILER_PATH + * Directory where the C/C++ toolchain is located, if not available in the system PATH. + * + * * LD_FLAGS * Flags to pass to the linker, after the automatically generated flags. * @@ -320,7 +337,7 @@ * \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. + * inside the application install folder's "\atbackend" subdirectory. * * \section SSec_BuildModule_ATPROGRAM_Targets Targets * @@ -439,6 +456,10 @@ * AVRDUDE_FLAGS * Additional flags to pass to avrdude when programming, applied after the automatically generated flags. * + * + * AVRDUDE_MEMORY + * Main memory space used when programming in an application *e.g. application for a DFU bootloader, or flash for a regular programmer). + * * * * \section SSec_BuildModule_AVRDUDE_ProvidedVariables Module Provided Variables @@ -789,7 +810,7 @@ * * 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 + * LUFA source files symbolically, 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: @@ -909,7 +930,7 @@ * * Error "Makefile {X} option must be Y or N" shown when compiling. * The specified Makefile value was configured in your project's makefile or on the command line, but was set to a value other than a Y (for "Yes") or "N" (for "No"). - * This configuration option is required to be one of the aformentioned boolean values, and other values are invalid. Set this option to either Y or N and try again. + * This configuration option is required to be one of the aforementioned boolean values, and other values are invalid. Set this option to either Y or N and try again. * * * Error "Unknown input source file formats: {X}" shown when compiling. @@ -957,7 +978,7 @@ * * * Error "unknown MCU '{X}' specified" shown when compiling. - * The specified micocontroller device model name set in the user application's makefile as the MCU parameter is incorrect, or unsupported by the + * The specified microcontroller device model name set in the user application's makefile as the MCU parameter is incorrect, or unsupported by the * version of the compiler being used. Make sure the model name is correct, or upgrade to the latest Atmel Toolchain to obtain newer device support. * *