| atprogram | +Program the device FLASH memory with the application's executable data. | +
| atprogram-ee | +Program the device EEPROM memory with the application's EEPROM data. | +
| MCU | +Name of the Atmel processor model (e.g. `at90usb1287`). | +
| TARGET | +Name of the application output file prefix (e.g. `TestApplication`). | +
| ATPROGRAM_PROGRAMMER | +Name of the Atmel programmer or debugger tool to communicate with (e.g. `jtagice3`). Default is `atmelice`. | +
| ATPROGRAM_INTERFACE | +Name of the programming interface to use when programming the target (e.g. `spi`). Default is `jtag`. | +
| ATPROGRAM_PORT | +Name of the communication port to use when when programming with a serially connected tool (e.g. `COM2`). Default is `usb`. | +
| N/A | +This module provides no variables. | +
| N/A | +This module provides no macros. | +
| avrdude | +Program the device FLASH memory with the application's executable data. | +
| avrdude-ee | +Program the device EEPROM memory with the application's EEPROM data. | +
| MCU | +Name of the Atmel processor model (e.g. `at90usb1287`). | +
| TARGET | +Name of the application output file prefix (e.g. `TestApplication`). | +
| AVRDUDE_PROGRAMMER | +Name of the programmer/debugger tool or bootloader to communicate with (e.g. `jtagicemkii`). Default is `jtagicemkii`. | +
| AVRDUDE_PORT | +Name of the communication port to use when when programming with a serially connected tool (e.g. `COM2`). Default is `usb`. | +
| AVRDUDE_FLAGS | +Additional flags to pass to `avrdude` when invoking the tool. Default is empty (no additional flags). | +
| AVRDUDE_MEMORY | +Memory space to program when executing the `avrdude` target (e.g. 'application` for an XMEGA device). Default is `flash`. | +
| N/A | +This module provides no variables. | +
| N/A | +This module provides no macros. | +
| help | +Show help for the current project, including a list of all available targets, variables and macros from the imported modules. | +
| list_targets | +Show a list of all build targets from the imported modules. | +
| list_modules | +Show a list of all imported modules. | +
| list_mandatory | +Show a list of all mandatory variables from the imported modules. | +
| list_optional | +Show a list of all optional variables from the imported modules. | +
| list_provided | +Show a list of all variables provided by the imported modules. | +
| list_macros | +Show a list of all macros provided by the imported modules. | +
| N/A | +This module has no mandatory variables. | +
| N/A | +This module has no optional variables. | +
| DMBS_VERSION | +Current version of this DMBS release, as a ISO 8601 integer (such as `160403` for `2016-04-03`). | +
| DMBS_CHECK_VERSION | +Macro to check the current DMBS version against the first argument and abort if the required version is newer than the current version. | +
| ERROR_IF_UNSET | +Macro to check the given makefile variable name passed as the first argument, and abort if it has not been set by any makefile module. | +
| ERROR_IF_EMPTY | +Macro to check the given makefile variable name passed as the first argument, and abort if it has an empty value. | +
| ERROR_IF_NONBOOL | +Macro to check the given makefile variable name passed as the first argument, and abort if it has a value other than `Y` or `N`. | +
| cppcheck | +Scan the project with CPPCHECK, and show all discovered issues. | +
| cppcheck-config | +Check the project with CPPCHECK, to find missing header paths. | +
| SRC | +List of all project source files to scan. | +
| CPPCHECK_INCLUDES | +Extra include paths to search, for any missing header files. Default is empty (no additional paths). | +
| CPPCHECK_EXCLUDES | +List of source files, file paths or path fragments to exclude from the scan. Default is empty (no exclusions). | +
| CPPCHECK_MSG_TEMPLATE | +Template for error and warning message output. Default is `{file}:{line}: {severity} ({id}): {message}`. | +
| CPPCHECK_ENABLE | +List of CPPCHECK checks to enable. Default is `all`. | +
| CPPCHECK_SUPPRESS | +List of CPPCHECK checks to ignore. Default is `variableScope missingInclude`. | +
| CPPCHECK_FAIL_ON_WARNING | +Boolean, if `Y` the build will fail if CPPCHECK discovers any errors or warnings. If `N`, fail only on errors. Default is `Y`. | +
| CPPCHECK_QUIET | +Boolean, if `Y` CPPCHECK will suppress all output except for discovered errors or warnings. If `N`, scan progress will be emitted. Default is `Y`. | +
| CPPCHECK_FLAGS_ | +Additional flags to pass to CPPCHECK when scans are started. Default is empty (no additional flags). | +
| N/A | +This module provides no variables. | +
| N/A | +This module provides no macros. | +
| flip | +Program the application into the device's flash memory, using Atmel FLIP. | +
| flip-ee | +Program the application's EEPROM data into the device's EEPROM memory, using Atmel FLIP. | +
| dfu | +Program the application into the device's flash memory, using `dfu-programmer`. | +
| dfu-ee | +Program the application's EEPROM data into the device's EEPROM memory, using `dfu-programmer`. | +
| MCU | +Name of the Atmel processor model (e.g. `at90usb1287`). | +
| TARGET | +Name of the application output file prefix (e.g. `TestApplication`). | +
| N/A | +This module has no optional variables. | +
| N/A | +This module provides no variables. | +
| N/A | +This module provides no macros. | +
| doxygen | +Generate project documentation, via Doxygen. | +
| doxygen-create | +Create a new project Doxygen template, which can then be customized. | +
| doxygen-upgrade | +Upgrade an existing project Doxygen template to the latest Doxygen version. | +
| N/A | +This module has no mandatory variables. | +
| DOXYGEN_CONF | +Name of the Doxygen project configuration file that should be used when generating documentation, or creating/upgrading the configuration file. | +
| DOXYGEN_FAIL_ON_WARNING | +Boolean, if `Y` the build will fail if Doxygen encounters any errors or warnings. If `N`, fail only on errors. Default is `Y`. | +
| DOXYGEN_OVERRIDE_PARAMS | +List of `NAME=VALUE` parameters which should override the values specified in the project configuration file, when building documentation. | +
| N/A | +This module provides no variables. | +
| N/A | +This module provides no macros. | +
| size | +Show the compiled binary size for the various memory segments. | +
| symbol-sizes | +Show the size of each symbol in the compiled binary (useful to find large functions to optimize further). | +
| all | +Build application and generate all binary (BIN, ELF, HEX) and auxiliary (LSS, MAP, SYM, etc.) output files. | +
| lib | +Generate a static `.a` library from the application code, containing the flash region's data. | +
| elf | +Generate an ELF debug file from the application code, containing all region's data. | +
| bin | +Generate a flat BIN binary file from the application code, containing the flash region's data. | +
| hex | +Generate a pair of Intel HEX files from the application code, containing the flash region's data (HEX) and EEPROM data (EEP). | +
| lss | +Generate a LSS listing file showing the disassembly of the compiled application. | +
| clean | +Remove all generated project intermediary and binary output files. | +
| mostlyclean | +Remove all generated project intermediary output files, but preserve the binary output files. | +
| MCU | +Name of the Atmel processor model (e.g. `at90usb1287`). | +
| TARGET | +Name of the application output file prefix (e.g. `TestApplication`). | +
| ARCH | +Target device architecture (e.g. `AVR8`). | +
| SRC | +List of all project source files (C, C++, ASM). | +
| OPTIMIZATION | +Optimization level to use when compiling C and C++ source files. Default is `s` (optimize for smallest size). | +
| C_STANDARD | +C language standard used when compiling C language source files. Default is `gnu99` (C99 standard with GNU extensions)./td> + |
| CPP_STANDARD | +C++ language standard used when compiling C++ language source files. Default is `gnu++98` (C++98 standard with GNU extensions)./td> + |
| F_CPU | +Processor core clock frequency, in Hz. This is used by some architectures for functions such as software spin-loop delays. Default is blank (no value defined). | +
| C_FLAGS | +Common GCC flags passed to the compiler for C language (C) input files. Default is blank (no additional flags). | +
| CPP_FLAGS | +Common GCC flags passed to the compiler for C++ language (CPP) input files. Default is blank (no additional flags). | +
| ASM_FLAGS | +Common GCC flags passed to the assembler for assembly language (S) input files. Default is blank (no additional flags). | +
| CC_FLAGS | +Common GCC flags passed to the compiler for all source file types. Default is blank (no additional flags). | +
| LD_FLAGS | +Extra flags to pass to the GNU linker when linking the compiled object files into the resulting binary. Default is blank (no additional flags). | +
| LINKER_RELAXATIONS | +Boolean, if `Y` linker relaxations will be enabled to slightly reduce the resulting binary's size. Default is `Y`. | +
| OBJDIR | +Directory to store the intermediate object files, as they are generated from the source files. Default is `obj`. | +
| OBJECT_FILES | +List of additional `.o` object files to link into the final binary. Default is blank (no additional objects). | +
| DEBUG_FORMAT | +Debug ELF file format to generate. Default is `dwarf-2`. | +
| DEBUG_LEVEL | +Level of the debugging information to generate in the compiled object files. Debug is 2 (medium level debugging information). | +
| COMPILER_PATH | +Path to the compiler to use, in case a specific compiler should be substituted for the one in the system's `PATH` variable. Default is blank (use `PATH` provided compiler). | +
| N/A | +This module provides no variables. | +
| N/A | +This module provides no macros. | +
| hid | +Program a LUFA HID class bootloader device, using the `hid_bootloader_cli.py` Python script. | +
| hid-ee | +Program a LUFA HID class bootloader device's EEPROM, using the `hid_bootloader_cli.py` Python script and a shim application which is programmed into the target's flash. | +
| teensy | +Program a LUFA HID class bootloader device or Teensy board, using the `teensy_loader_cli` tool. | +
| teensy-ee | +Program a LUFA HID class bootloader device's EEPROM, using the `teensy_loader_cli` tool and a shim application which is programmed into the target's flash. | +
| MCU | +Name of the Atmel processor model (e.g. `at90usb1287`). | +
| TARGET | +Name of the application output file prefix (e.g. `TestApplication`). | +
| N/A | +This module has no optional variables. | +
| N/A | +This module provides no variables. | +
| N/A | +This module provides no macros. | +
| size | - *Display size of the compiled application FLASH and SRAM segments. | - *
| symbol-sizes | - *Display a size-sorted list of symbols from the compiled application, in decimal bytes. | - *
| lib | - *Build and archive all source files into a library A binary file. | - *
| all | - *Build and link the application into ELF debug and HEX binary files. | - *
| elf | - *Build and link the application into an ELF debug file. | - *
| bin | - *Build and link the application and produce a BIN binary file. | - *
| hex | - *Build and link the application and produce HEX and EEP binary files. | - *
| lss | - *Build and link the application and produce a LSS source code/assembly code mixed listing file. | - *
| clean | - *Remove all intermediary files and binary output files. | - *
| mostlyclean | - *Remove all intermediary files but preserve any binary output files. | - *
| <filename>.s | - *Create an assembly listing of a given input C/C++ source file. | - *
| TARGET | - *Name of the application output file prefix (e.g. TestApplication). | - *
| ARCH | - *Architecture of the target processor (see \ref Page_DeviceSupport). | - *
| MCU | - *Name of the Atmel processor model (e.g. at90usb1287). | - *
| SRC | - *List of relative or absolute paths to the application C (.c), C++ (.cpp) and Assembly (.S) source files. | - *
| F_USB | - *Speed in Hz of the input clock frequency to the target's USB controller. | - *
| LUFA_PATH | - *Path to the LUFA library core, either relative or absolute (e.g. ../LUFA-000000/LUFA/). | - *
| BOARD | - *LUFA board hardware drivers to use (see \ref Page_DeviceSupport). | - *
| OPTIMIZATION | - *Optimization level to use when compiling source files (see GCC manual). | - *
| C_STANDARD | - *Version of the C standard to apply when compiling C++ source files (see GCC manual). | - *
| CPP_STANDARD | - *Version of the C++ standard to apply when compiling C++ source files (see GCC manual). | - *
| DEBUG_FORMAT | - *Format of the debug information to embed in the generated object files (see GCC manual). | - *
| DEBUG_LEVEL | - *Level of the debugging information to embed in the generated object files (see GCC manual). | - *
| F_CPU | - *Speed of the processor CPU clock, in Hz. | - *
| C_FLAGS | - *Flags to pass to the C compiler only, after the automatically generated flags. | - *
| CPP_FLAGS | - *Flags to pass to the C++ compiler only, after the automatically generated flags. | - *
| ASM_FLAGS | - *Flags to pass to the assembler only, after the automatically generated flags. | - *
| CC_FLAGS | - *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. | - *
| LINKER_RELAXATIONS | - *Enables or disables linker relaxations when linking the application binary. This can reduce the total size - * of the application by replacing full \c CALL instructions with smaller \c RCALL instructions where possible. - * \note On some unpatched versions of binutils, this can cause link failures in some circumstances. If you - * receive a link error relocation truncated to fit: R_AVR_13_PCREL, disable this setting. | - *
| OBJDIR | - *Directory 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_FILES | - *List of additional object files that should be linked into the resulting binary. | - *
| None | - *
| None | - *
| help | - *Display build system help and configuration information. | - *
| list_targets | - *List all available build targets from the build system. | - *
| list_modules | - *List all available build modules from the build system. | - *
| list_mandatory | - *List all mandatory parameters required by the included modules. | - *
| list_optional | - *List all optional parameters required by the included modules. | - *
| list_provided | - *List all variables provided by the included modules. | - *
| list_macros | - *List all macros provided by the included modules. | - *
| None | - *
| None | - *
| None | - *
| None | - *
| atprogram | - *Program the device FLASH memory with the application's executable data. | - *
| atprogram-ee | - *Program the device EEPROM memory with the application's EEPROM data. | - *
| MCU | - *Name of the Atmel processor model (e.g. at90usb1287). | - *
| TARGET | - *Name of the application output file prefix (e.g. TestApplication). | - *
| ATPROGRAM_PROGRAMMER | - *Name of the Atmel programmer or debugger tool to communicate with (e.g. jtagice3). | - *
| ATPROGRAM_INTERFACE | - *Name of the programming interface to use when programming the target (e.g. spi). | - *
| ATPROGRAM_PORT | - *Name of the communication port to use when when programming with a serially connected tool (e.g. COM2). | - *
| None | - *
| None | - *
| avrdude | - *Program the device FLASH memory with the application's executable data. | - *
| avrdude-ee | - *Program the device EEPROM memory with the application's EEPROM data. | - *
| MCU | - *Name of the Atmel processor model (e.g. at90usb1287). | - *
| TARGET | - *Name of the application output file prefix (e.g. TestApplication). | - *
| AVRDUDE_PROGRAMMER | - *Name of the programmer or debugger tool to communicate with (e.g. jtagicemkii). | - *
| AVRDUDE_PORT | - *Name of the communication port to use when when programming with the connected tool (e.g. COM2, /dev/ttyUSB0 or usb). | - *
| AVRDUDE_FLAGS | - *Additional flags to pass to avrdude when programming, applied after the automatically generated flags. | - *
| None | - *
| None | - *
| cppcheck | - *Statically analyze the project source code for issues. | - *
| cppcheck-config | - *Check the cppcheck configuration - scan source code and warn about missing header files and other issues. | - *
| SRC | - *List of source files to statically analyze. | - *
| CPPCHECK_INCLUDES | - *Path of extra directories to check when attemting to resolve C/C++ header file includes. | - *
| CPPCHECK_EXCLUDES | - *Paths or path fragments to exclude when analyzing. | - *
| CPPCHECK_MSG_TEMPLATE | - *Output message template to use when printing errors, warnings and information (see cppcheck documentation). | - *
| CPPCHECK_ENABLE | - *Analysis rule categories to enable (see cppcheck documentation). | - *
| CPPCHECK_SUPPRESS | - *Specific analysis rules to suppress (see cppcheck documentation). | - *
| CPPCHECK_FAIL_ON_WARNING | - *Set to Y to fail the analysis job with an error exit code if warnings are found, N to continue without failing. | - *
| CPPCHECK_QUIET | - *Set to Y to suppress all output except warnings and errors, N to show verbose output information. | - *
| CPPCHECK_FLAGS | - *Extra flags to pass to cppcheck, after the automatically generated flags. | - *
| None | - *
| None | - *
| dfu | - *Program the device FLASH memory with the application's executable data using dfu-programmer. | - *
| dfu-ee | - *Program the device EEPROM memory with the application's EEPROM data using dfu-programmer. | - *
| flip | - *Program the device FLASH memory with the application's executable data using batchisp. | - *
| flip-ee | - *Program the device EEPROM memory with the application's EEPROM data using batchisp. | - *
| MCU | - *Name of the Atmel processor model (e.g. at90usb1287). | - *
| TARGET | - *Name of the application output file prefix (e.g. TestApplication). | - *
| None | - *
| None | - *
| None | - *
| doxygen | - *Generate project documentation. | - *
| doxygen_create | - *Create a new Doxygen configuration file using the latest template. | - *
| doxygen_upgrade | - *Upgrade an existing Doxygen configuration file to the latest template | - *
| LUFA_PATH | - *Path to the LUFA library core, either relative or absolute (e.g. ../LUFA-000000/LUFA/). | - *
| DOXYGEN_CONF | - *Name and path of the base Doxygen configuration file for the project. | - *
| DOXYGEN_FAIL_ON_WARNING | - *Set 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_PARAMS | - *Extra Doxygen configuration parameters to apply, overriding the corresponding config entry in the project's configuration file (e.g. QUIET=YES). | - *
| None | - *
| None | - *
| hid | - *Program the device FLASH memory with the application's executable data using hid_bootloader_cli. | - *
| hid-ee | - *Program 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. | - *
| teensy | - *Program the device FLASH memory with the application's executable data using teensy_loader_cli. | - *
| teensy-ee | - *Program 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. | - *
| MCU | - *Name of the Atmel processor model (e.g. at90usb1287). | - *
| TARGET | - *Name of the application output file prefix (e.g. TestApplication). | - *
| None | - *
| None | - *
| None | - *
| None | - *
| LUFA_PATH | - *Path to the LUFA library core, either relative or absolute (e.g. ../LUFA-000000/LUFA/). | - *
| ARCH | - *Architecture of the target processor (see \ref Page_DeviceSupport). | - *
| None | - *
| LUFA_SRC_USB | - *List of LUFA USB driver source files. | - *
| LUFA_SRC_USBCLASS | - *List of LUFA USB Class driver source files. | - *
| LUFA_SRC_TEMPERATURE | - *List of LUFA temperature sensor driver source files. | - *
| LUFA_SRC_SERIAL | - *List of LUFA Serial U(S)ART driver source files. | - *
| LUFA_SRC_TWI | - *List of LUFA TWI driver source files. | - *
| LUFA_SRC_PLATFORM | - *List of LUFA architecture specific platform management source files. | - *
| None | - *
| Problem | - *Resolution | - *
|---|---|
| Error "relocation truncated to fit: R_AVR_13_PCREL against symbol {X}" shown when compiling. | - *Try compiling with the setting LINKER_RELAXATIONS=N in your LUFA Build System 2.0 makefile, or remove the line -Wl,--relax - * from other makefiles. Alternatively, make sure you have the latest version of the Atmel Toolchain installed for your system. | - *
| Error "error: ld terminated with signal 11 [Segmentation fault]" shown when compiling. | - *Try compiling with the setting DEBUG_LEVEL=2 in your LUFA Build System 2.0 makefile, or make sure you are using binutils version 2.22 or later. | - *
| Error "EMERGENCY ABORT: INFINITE RECURSION DETECTED" shown when compiling. | - *Make sure you are using an up to date version of GNU Make when compiling. This error is a safety system added to the mid-level makefiles, to prevent an issue with - * GNU make or other variants of Make causing an infinitely recursive build. | - *
| Error "Unsupported architecture "{X}"" shown when compiling. | - *Ensure your makefile's ARCH setting is set to one of the architecture names (case-sensitive) supported by the version of LUFA you are compiling against. | - *
| Error "Makefile {X} value not set" shown when compiling. | - *The specified Makefile value was not configured in your project's makefile or on the command line, and the nominated setting is required by one or more LUFA - * build system modules. Define the value in your project makefile and try again. | - *
| Error "Makefile {X} option cannot be blank" shown when compiling. | - *The specified Makefile value was configured in your project's makefile or on the command line, but was set to an empty value. For the nominated configuration - * option, an empty value is not allowed. Define the nominated setting to a correct non-blank value and try again. | - *
| 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 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. | - *The nominated source files, specified in your project's makefile in the SRC configuration option, has an extension that the LUFA build system does not - * recognise. The file extensions are case sensitive, and must be one of the supported formats (*.c, *.cpp or *.S). | - *
| Error "Cannot build with OBJDIR parameter set - one or more object file name is not unique" shown when compiling. | - *When a project is built with a non-empty OBJDIR object directory name set, all input source files must have unique names, excluding extension and path. - * This means that input files that are named identically and differ only by their path or extension are invalid when this mode is used. | - *
| Error "Source file does not exist: {X}" shown when compiling. | - *The nominated input source file, specified in the user project's SRC parameter, could not be found. Ensure the source file exists and the absolute or - * relative path given in the user project makefile is correct and try again. | - *
| Error "Doxygen configuration file {X} does not exist" shown when upgrading a Doxygen configuration file. | - *The nominated Doxygen configuration file, specified in the user project's DOXYGEN_CONF parameter, could not be found. Ensure the configuration file exists - * and the absolute or relative path given in the user project makefile is correct and try again, or run the appropriate makefile target to generate a new configuration - * file. | - *
| Error "avr-gcc: error: unrecognized option '{X}'" shown when compiling. | - *An unrecognised option was supplied to the compiler, usually in the C_FLAGS, CPP_FLAGS, ASM_FLAGS or CC_FLAGS configuration - * options. The nominated compiler switch may be invalid, or unsupported by the version of AVR-GCC on the host system. Remove the unrecognised flag if invalid, or - * upgrade to the latest AVR-GCC. If the option is a valid linker option, use the prefix "-Wl," to ensure it is passed to the linker correctly. | - *
| Error "makefile:{X}: {Y}.mk: No such file or directory" shown when make is invoked. | - *The path to the nominated makefile module was incorrect. This usually indicates that the makefile LUFA_PATH option is not set to a valid relative or - * absolute path to the LUFA library core. | - *
| Error "fatal error: LUFAConfig.h: No such file or directory" shown when compiling. | - *The USE_LUFA_CONFIG_HEADER compile time option was set in the user project makefile, but the user supplied LUFAConfig.h header could not be - * found. Ensure that the directory that contains this configuration file is correctly passed to the compiler via the -I switch in the makefile CC_FLAGS - * parameter. | - *
| Error "ld.exe: section .apitable_trampolines loaded at {X} overlaps section .text" shown when compiling a bootloader. | - *The bootloader is compiling too large for the given FLASH_SIZE_KB and BOOT_SECTION_SIZE_KB parameters set in the bootloader makefile. This - * usually indicates that these values are incorrect for the specified device the bootloader is targeting. If these values are correct, a newer version of the - * compiler may need to be used to ensure that the bootloader is built within the section size constraints of the target device. | - *
| Error "unknown MCU '{X}' specified" shown when compiling. | - *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. | - *
| Error "undefined reference to `{X}'" shown when compiling. | - *This is usually caused by a missing source file in the user application's SRC configuration parameter. If the indicated symbol is one from the LUFA - * library, you may be missing a LUFA source makefile module (see \ref Page_BuildModule_SOURCES). | - *
| None | + *
| LUFA_PATH | + *Path to the LUFA library core, either relative or absolute (e.g. ../LUFA-000000/LUFA/). | + *
| ARCH | + *Architecture of the target processor (see \ref Page_DeviceSupport). | + *
| None | + *
| LUFA_SRC_USB | + *List of LUFA USB driver source files. | + *
| LUFA_SRC_USBCLASS | + *List of LUFA USB Class driver source files. | + *
| LUFA_SRC_TEMPERATURE | + *List of LUFA temperature sensor driver source files. | + *
| LUFA_SRC_SERIAL | + *List of LUFA Serial U(S)ART driver source files. | + *
| LUFA_SRC_TWI | + *List of LUFA TWI driver source files. | + *
| LUFA_SRC_PLATFORM | + *List of LUFA architecture specific platform management source files. | + *
| None | + *
| None | + *
| LUFA_PATH | + *Path to the LUFA library core, either relative or absolute (e.g. ../LUFA-000000/LUFA/). | + *
| BOARD | + *LUFA board hardware drivers to use (see \ref Page_DeviceSupport). | + *
| None | + *
| None | + *
| Problem | + *Resolution | + *
|---|---|
| Error "relocation truncated to fit: R_AVR_13_PCREL against symbol {X}" shown when compiling. | + *Try compiling with the setting LINKER_RELAXATIONS=N in your LUFA Build System 2.0 makefile, or remove the line -Wl,--relax + * from other makefiles. Alternatively, make sure you have the latest version of the Atmel Toolchain installed for your system. | + *
| Error "error: ld terminated with signal 11 [Segmentation fault]" shown when compiling. | + *Try compiling with the setting DEBUG_LEVEL=2 in your LUFA Build System 2.0 makefile, or make sure you are using binutils version 2.22 or later. | + *
| Error "EMERGENCY ABORT: INFINITE RECURSION DETECTED" shown when compiling. | + *Make sure you are using an up to date version of GNU Make when compiling. This error is a safety system added to the mid-level makefiles, to prevent an issue with + * GNU make or other variants of Make causing an infinitely recursive build. | + *
| Error "Unsupported architecture "{X}"" shown when compiling. | + *Ensure your makefile's ARCH setting is set to one of the architecture names (case-sensitive) supported by the version of LUFA you are compiling against. | + *
| Error "Makefile {X} value not set" shown when compiling. | + *The specified Makefile value was not configured in your project's makefile or on the command line, and the nominated setting is required by one or more LUFA + * build system modules. Define the value in your project makefile and try again. | + *
| Error "Makefile {X} option cannot be blank" shown when compiling. | + *The specified Makefile value was configured in your project's makefile or on the command line, but was set to an empty value. For the nominated configuration + * option, an empty value is not allowed. Define the nominated setting to a correct non-blank value and try again. | + *
| 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 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. | + *The nominated source files, specified in your project's makefile in the SRC configuration option, has an extension that the LUFA build system does not + * recognise. The file extensions are case sensitive, and must be one of the supported formats (*.c, *.cpp or *.S). | + *
| Error "Cannot build with OBJDIR parameter set - one or more object file name is not unique" shown when compiling. | + *When a project is built with a non-empty OBJDIR object directory name set, all input source files must have unique names, excluding extension and path. + * This means that input files that are named identically and differ only by their path or extension are invalid when this mode is used. | + *
| Error "Source file does not exist: {X}" shown when compiling. | + *The nominated input source file, specified in the user project's SRC parameter, could not be found. Ensure the source file exists and the absolute or + * relative path given in the user project makefile is correct and try again. | + *
| Error "Doxygen configuration file {X} does not exist" shown when upgrading a Doxygen configuration file. | + *The nominated Doxygen configuration file, specified in the user project's DOXYGEN_CONF parameter, could not be found. Ensure the configuration file exists + * and the absolute or relative path given in the user project makefile is correct and try again, or run the appropriate makefile target to generate a new configuration + * file. | + *
| Error "avr-gcc: error: unrecognized option '{X}'" shown when compiling. | + *An unrecognised option was supplied to the compiler, usually in the C_FLAGS, CPP_FLAGS, ASM_FLAGS or CC_FLAGS configuration + * options. The nominated compiler switch may be invalid, or unsupported by the version of AVR-GCC on the host system. Remove the unrecognised flag if invalid, or + * upgrade to the latest AVR-GCC. If the option is a valid linker option, use the prefix "-Wl," to ensure it is passed to the linker correctly. | + *
| Error "makefile:{X}: {Y}.mk: No such file or directory" shown when make is invoked. | + *The path to the nominated makefile module was incorrect. This usually indicates that the makefile LUFA_PATH option is not set to a valid relative or + * absolute path to the LUFA library core. | + *
| Error "fatal error: LUFAConfig.h: No such file or directory" shown when compiling. | + *The USE_LUFA_CONFIG_HEADER compile time option was set in the user project makefile, but the user supplied LUFAConfig.h header could not be + * found. Ensure that the directory that contains this configuration file is correctly passed to the compiler via the -I switch in the makefile CC_FLAGS + * parameter. | + *
| Error "ld.exe: section .apitable_trampolines loaded at {X} overlaps section .text" shown when compiling a bootloader. | + *The bootloader is compiling too large for the given FLASH_SIZE_KB and BOOT_SECTION_SIZE_KB parameters set in the bootloader makefile. This + * usually indicates that these values are incorrect for the specified device the bootloader is targeting. If these values are correct, a newer version of the + * compiler may need to be used to ensure that the bootloader is built within the section size constraints of the target device. | + *
| Error "unknown MCU '{X}' specified" shown when compiling. | + *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. | + *
| Error "undefined reference to `{X}'" shown when compiling. | + *This is usually caused by a missing source file in the user application's SRC configuration parameter. If the indicated symbol is one from the LUFA + * library, you may be missing a LUFA source makefile module (see \ref Page_BuildModule_LUFA_SOURCES). | + *
| Name | Color | Info | Active Level | Port Pin |
|---|---|---|---|---|
| LEDS_LED1 | Yellow | General Indicator | High | PORTC.7 |
| LEDS_LED2 | Green | Bootloader, USB-activity | Low | PORTD.5 |
| Name | Color | Info | Active Level | Port Pin |
|---|---|---|---|---|
| LEDS_LED1 | Yellow | RX | Low | PORTD.4 |
| LEDS_LED2 | Yellow | TX | Low | PORTD.5 |
| LEDS_LED1 | Yellow | RX | Low | PORTD.5 |
| LEDS_LED2 | Yellow | TX | Low | PORTD.4 |
| Name | Color | Info | Active Level | Port Pin |
|---|---|---|---|---|
| LEDS_LED1 | Green | General Indicator | Low | PORTC.6 |