diff options
Diffstat (limited to 'tmk_core/protocol/lufa')
13 files changed, 2184 insertions, 2184 deletions
| diff --git a/tmk_core/protocol/lufa/LUFA-git/Bootloaders/CDC/asf.xml b/tmk_core/protocol/lufa/LUFA-git/Bootloaders/CDC/asf.xml index 72f3ff04c..02e7063c6 100644 --- a/tmk_core/protocol/lufa/LUFA-git/Bootloaders/CDC/asf.xml +++ b/tmk_core/protocol/lufa/LUFA-git/Bootloaders/CDC/asf.xml @@ -1,161 +1,161 @@ -<asf xmlversion="1.0">
 -	<project caption="CDC Bootloader - 128KB FLASH / 4KB Boot - AVR8 Architecture" id="lufa.bootloaders.cdc.avr8.128_4" force-caption="true" workspace-name="lufa_cdc_128kb_4kb_">
 -		<require idref="lufa.bootloaders.cdc"/>
 -		<require idref="lufa.boards.dummy.avr8"/>
 -		<generator value="as5_8"/>
 -
 -		<device-support value="at90usb1287"/>
 -		<config name="lufa.drivers.board.name" value="none"/>
 -
 -		<config name="config.compiler.optimization.level" value="size"/>
 -
 -		<build type="define" name="F_CPU" value="16000000UL"/>
 -		<build type="define" name="F_USB" value="16000000UL"/>
 -
 -		<build type="define" name="BOOT_START_ADDR" value="0x1F000"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.text=0x1F000"/>
 -
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_trampolines=0x1FFA0"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Trampolines"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_jumptable=0x1FFE0"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_JumpTable"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_signatures=0x1FFF8"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Signatures"/>
 -	</project>
 -
 -	<project caption="CDC Bootloader - 64KB FLASH / 4KB Boot - AVR8 Architecture" id="lufa.bootloaders.cdc.avr8.64_4" force-caption="true" workspace-name="lufa_cdc_64kb_4kb_">
 -		<require idref="lufa.bootloaders.cdc"/>
 -		<require idref="lufa.boards.dummy.avr8"/>
 -		<generator value="as5_8"/>
 -
 -		<device-support value="at90usb647"/>
 -		<config name="lufa.drivers.board.name" value="none"/>
 -
 -		<config name="config.compiler.optimization.level" value="size"/>
 -
 -		<build type="define" name="F_CPU" value="16000000UL"/>
 -		<build type="define" name="F_USB" value="16000000UL"/>
 -
 -		<build type="define" name="BOOT_START_ADDR" value="0xF000"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.text=0xF000"/>
 -
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_trampolines=0xFFA0"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Trampolines"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_jumptable=0xFFE0"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_JumpTable"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_signatures=0xFFF8"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Signatures"/>
 -	</project>
 -
 -	<project caption="CDC Bootloader - 32KB FLASH / 4KB Boot - AVR8 Architecture" id="lufa.bootloaders.cdc.avr8.32_4" force-caption="true" workspace-name="lufa_cdc_32kb_4kb_">
 -		<require idref="lufa.bootloaders.cdc"/>
 -		<require idref="lufa.boards.dummy.avr8"/>
 -		<generator value="as5_8"/>
 -
 -		<device-support value="atmega32u4"/>
 -		<config name="lufa.drivers.board.name" value="none"/>
 -
 -		<config name="config.compiler.optimization.level" value="size"/>
 -
 -		<build type="define" name="F_CPU" value="16000000UL"/>
 -		<build type="define" name="F_USB" value="16000000UL"/>
 -
 -		<build type="define" name="BOOT_START_ADDR" value="0x7000"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.text=0x7000"/>
 -
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_trampolines=0x7FA0"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Trampolines"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_jumptable=0x7FE0"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_JumpTable"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_signatures=0x7FF8"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Signatures"/>
 -	</project>
 -
 -	<project caption="CDC Bootloader - 16KB FLASH / 4KB Boot - AVR8 Architecture" id="lufa.bootloaders.cdc.avr8.16_4" force-caption="true" workspace-name="lufa_cdc_16kb_4kb_">
 -		<require idref="lufa.bootloaders.cdc"/>
 -		<require idref="lufa.boards.dummy.avr8"/>
 -		<generator value="as5_8"/>
 -
 -		<device-support value="atmega16u2"/>
 -		<config name="lufa.drivers.board.name" value="none"/>
 -
 -		<config name="config.compiler.optimization.level" value="size"/>
 -
 -		<build type="define" name="F_CPU" value="16000000UL"/>
 -		<build type="define" name="F_USB" value="16000000UL"/>
 -
 -		<build type="define" name="BOOT_START_ADDR" value="0x3000"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.text=0x3000"/>
 -
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_trampolines=0x3FA0"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Trampolines"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_jumptable=0x3FE0"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_JumpTable"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_signatures=0x3FF8"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Signatures"/>
 -	</project>
 -
 -	<project caption="CDC Bootloader - 8KB FLASH / 4KB Boot - AVR8 Architecture" id="lufa.bootloaders.cdc.avr8.8_4" force-caption="true" workspace-name="lufa_cdc_8kb_4kb_">
 -		<require idref="lufa.bootloaders.cdc"/>
 -		<require idref="lufa.boards.dummy.avr8"/>
 -		<generator value="as5_8"/>
 -
 -		<device-support value="atmega8u2"/>
 -		<config name="lufa.drivers.board.name" value="none"/>
 -
 -		<config name="config.compiler.optimization.level" value="size"/>
 -
 -		<build type="define" name="F_CPU" value="16000000UL"/>
 -		<build type="define" name="F_USB" value="16000000UL"/>
 -
 -		<build type="define" name="BOOT_START_ADDR" value="0x1000"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.text=0x1000"/>
 -
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_trampolines=0x1FA0"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Trampolines"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_jumptable=0x1FE0"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_JumpTable"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_signatures=0x1FF8"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Signatures"/>
 -	</project>
 -
 -	<module type="application" id="lufa.bootloaders.cdc" caption="CDC Bootloader">
 -		<info type="description" value="summary">
 -		CDC Class Bootloader, capable of reprogramming a device using avrdude or other AVR109 protocol compliant software when plugged into a host.
 -		</info>
 -
 - 		<info type="gui-flag" value="move-to-root"/>
 -
 -		<info type="keyword" value="Technology">
 -			<keyword value="Bootloaders"/>
 -			<keyword value="USB Device"/>
 -		</info>
 -
 - 		<device-support-alias value="lufa_avr8"/>
 -		<device-support-alias value="lufa_xmega"/>
 -		<device-support-alias value="lufa_uc3"/>
 -
 -		<build type="include-path" value="."/>
 -		<build type="c-source" value="BootloaderCDC.c"/>
 -		<build type="header-file" value="BootloaderCDC.h"/>
 -		<build type="c-source" value="Descriptors.c"/>
 -		<build type="header-file" value="Descriptors.h"/>
 -		<build type="c-source" value="BootloaderAPI.c"/>
 -		<build type="header-file" value="BootloaderAPI.h"/>
 -		<build type="asm-source" value="BootloaderAPITable.S"/>
 -
 -		<build type="module-config" subtype="path" value="Config"/>
 -		<build type="header-file" value="Config/LUFAConfig.h"/>
 -		<build type="header-file" value="Config/AppConfig.h"/>
 -
 -		<build type="distribute" subtype="user-file" value="doxyfile"/>
 -		<build type="distribute" subtype="user-file" value="BootloaderCDC.txt"/>
 -		<build type="distribute" subtype="user-file" value="LUFA CDC Bootloader.inf"/>
 -
 -		<require idref="lufa.common"/>
 -		<require idref="lufa.platform"/>
 -		<require idref="lufa.drivers.usb"/>
 -		<require idref="lufa.drivers.board"/>
 -		<require idref="lufa.drivers.board.leds"/>
 -	</module>
 -</asf>
 +<asf xmlversion="1.0"> +	<project caption="CDC Bootloader - 128KB FLASH / 4KB Boot - AVR8 Architecture" id="lufa.bootloaders.cdc.avr8.128_4" force-caption="true" workspace-name="lufa_cdc_128kb_4kb_"> +		<require idref="lufa.bootloaders.cdc"/> +		<require idref="lufa.boards.dummy.avr8"/> +		<generator value="as5_8"/> + +		<device-support value="at90usb1287"/> +		<config name="lufa.drivers.board.name" value="none"/> + +		<config name="config.compiler.optimization.level" value="size"/> + +		<build type="define" name="F_CPU" value="16000000UL"/> +		<build type="define" name="F_USB" value="16000000UL"/> + +		<build type="define" name="BOOT_START_ADDR" value="0x1F000"/> +		<build type="linker-config" subtype="flags" value="--section-start=.text=0x1F000"/> + +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_trampolines=0x1FFA0"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Trampolines"/> +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_jumptable=0x1FFE0"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_JumpTable"/> +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_signatures=0x1FFF8"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Signatures"/> +	</project> + +	<project caption="CDC Bootloader - 64KB FLASH / 4KB Boot - AVR8 Architecture" id="lufa.bootloaders.cdc.avr8.64_4" force-caption="true" workspace-name="lufa_cdc_64kb_4kb_"> +		<require idref="lufa.bootloaders.cdc"/> +		<require idref="lufa.boards.dummy.avr8"/> +		<generator value="as5_8"/> + +		<device-support value="at90usb647"/> +		<config name="lufa.drivers.board.name" value="none"/> + +		<config name="config.compiler.optimization.level" value="size"/> + +		<build type="define" name="F_CPU" value="16000000UL"/> +		<build type="define" name="F_USB" value="16000000UL"/> + +		<build type="define" name="BOOT_START_ADDR" value="0xF000"/> +		<build type="linker-config" subtype="flags" value="--section-start=.text=0xF000"/> + +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_trampolines=0xFFA0"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Trampolines"/> +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_jumptable=0xFFE0"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_JumpTable"/> +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_signatures=0xFFF8"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Signatures"/> +	</project> + +	<project caption="CDC Bootloader - 32KB FLASH / 4KB Boot - AVR8 Architecture" id="lufa.bootloaders.cdc.avr8.32_4" force-caption="true" workspace-name="lufa_cdc_32kb_4kb_"> +		<require idref="lufa.bootloaders.cdc"/> +		<require idref="lufa.boards.dummy.avr8"/> +		<generator value="as5_8"/> + +		<device-support value="atmega32u4"/> +		<config name="lufa.drivers.board.name" value="none"/> + +		<config name="config.compiler.optimization.level" value="size"/> + +		<build type="define" name="F_CPU" value="16000000UL"/> +		<build type="define" name="F_USB" value="16000000UL"/> + +		<build type="define" name="BOOT_START_ADDR" value="0x7000"/> +		<build type="linker-config" subtype="flags" value="--section-start=.text=0x7000"/> + +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_trampolines=0x7FA0"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Trampolines"/> +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_jumptable=0x7FE0"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_JumpTable"/> +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_signatures=0x7FF8"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Signatures"/> +	</project> + +	<project caption="CDC Bootloader - 16KB FLASH / 4KB Boot - AVR8 Architecture" id="lufa.bootloaders.cdc.avr8.16_4" force-caption="true" workspace-name="lufa_cdc_16kb_4kb_"> +		<require idref="lufa.bootloaders.cdc"/> +		<require idref="lufa.boards.dummy.avr8"/> +		<generator value="as5_8"/> + +		<device-support value="atmega16u2"/> +		<config name="lufa.drivers.board.name" value="none"/> + +		<config name="config.compiler.optimization.level" value="size"/> + +		<build type="define" name="F_CPU" value="16000000UL"/> +		<build type="define" name="F_USB" value="16000000UL"/> + +		<build type="define" name="BOOT_START_ADDR" value="0x3000"/> +		<build type="linker-config" subtype="flags" value="--section-start=.text=0x3000"/> + +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_trampolines=0x3FA0"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Trampolines"/> +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_jumptable=0x3FE0"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_JumpTable"/> +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_signatures=0x3FF8"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Signatures"/> +	</project> + +	<project caption="CDC Bootloader - 8KB FLASH / 4KB Boot - AVR8 Architecture" id="lufa.bootloaders.cdc.avr8.8_4" force-caption="true" workspace-name="lufa_cdc_8kb_4kb_"> +		<require idref="lufa.bootloaders.cdc"/> +		<require idref="lufa.boards.dummy.avr8"/> +		<generator value="as5_8"/> + +		<device-support value="atmega8u2"/> +		<config name="lufa.drivers.board.name" value="none"/> + +		<config name="config.compiler.optimization.level" value="size"/> + +		<build type="define" name="F_CPU" value="16000000UL"/> +		<build type="define" name="F_USB" value="16000000UL"/> + +		<build type="define" name="BOOT_START_ADDR" value="0x1000"/> +		<build type="linker-config" subtype="flags" value="--section-start=.text=0x1000"/> + +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_trampolines=0x1FA0"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Trampolines"/> +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_jumptable=0x1FE0"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_JumpTable"/> +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_signatures=0x1FF8"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Signatures"/> +	</project> + +	<module type="application" id="lufa.bootloaders.cdc" caption="CDC Bootloader"> +		<info type="description" value="summary"> +		CDC Class Bootloader, capable of reprogramming a device using avrdude or other AVR109 protocol compliant software when plugged into a host. +		</info> + + 		<info type="gui-flag" value="move-to-root"/> + +		<info type="keyword" value="Technology"> +			<keyword value="Bootloaders"/> +			<keyword value="USB Device"/> +		</info> + + 		<device-support-alias value="lufa_avr8"/> +		<device-support-alias value="lufa_xmega"/> +		<device-support-alias value="lufa_uc3"/> + +		<build type="include-path" value="."/> +		<build type="c-source" value="BootloaderCDC.c"/> +		<build type="header-file" value="BootloaderCDC.h"/> +		<build type="c-source" value="Descriptors.c"/> +		<build type="header-file" value="Descriptors.h"/> +		<build type="c-source" value="BootloaderAPI.c"/> +		<build type="header-file" value="BootloaderAPI.h"/> +		<build type="asm-source" value="BootloaderAPITable.S"/> + +		<build type="module-config" subtype="path" value="Config"/> +		<build type="header-file" value="Config/LUFAConfig.h"/> +		<build type="header-file" value="Config/AppConfig.h"/> + +		<build type="distribute" subtype="user-file" value="doxyfile"/> +		<build type="distribute" subtype="user-file" value="BootloaderCDC.txt"/> +		<build type="distribute" subtype="user-file" value="LUFA CDC Bootloader.inf"/> + +		<require idref="lufa.common"/> +		<require idref="lufa.platform"/> +		<require idref="lufa.drivers.usb"/> +		<require idref="lufa.drivers.board"/> +		<require idref="lufa.drivers.board.leds"/> +	</module> +</asf> diff --git a/tmk_core/protocol/lufa/LUFA-git/Bootloaders/DFU/asf.xml b/tmk_core/protocol/lufa/LUFA-git/Bootloaders/DFU/asf.xml index 6f3312b76..f56aba69f 100644 --- a/tmk_core/protocol/lufa/LUFA-git/Bootloaders/DFU/asf.xml +++ b/tmk_core/protocol/lufa/LUFA-git/Bootloaders/DFU/asf.xml @@ -1,156 +1,156 @@ -<asf xmlversion="1.0">
 -	<project caption="DFU Bootloader - 128KB FLASH / 4KB Boot - AVR8 Architecture" id="lufa.bootloaders.dfu.avr8.128_4" force-caption="true" workspace-name="lufa_dfu_128kb_4kb_">
 -		<require idref="lufa.bootloaders.dfu"/>
 -		<require idref="lufa.boards.dummy.avr8"/>
 -		<generator value="as5_8"/>
 -
 -		<device-support value="at90usb1287"/>
 -		<config name="lufa.drivers.board.name" value="none"/>
 -
 -		<config name="config.compiler.optimization.level" value="size"/>
 -
 -		<build type="define" name="F_CPU" value="16000000UL"/>
 -		<build type="define" name="F_USB" value="16000000UL"/>
 -
 -		<build type="define" name="BOOT_START_ADDR" value="0x1F000"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.text=0x1F000"/>
 -
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_trampolines=0x1FFA0"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Trampolines"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_jumptable=0x1FFE0"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_JumpTable"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_signatures=0x1FFF8"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Signatures"/>
 -	</project>
 -
 -	<project caption="DFU Bootloader - 64KB FLASH / 4KB Boot - AVR8 Architecture" id="lufa.bootloaders.dfu.avr8.64_4" force-caption="true" workspace-name="lufa_dfu_64kb_4kb_">
 -		<require idref="lufa.bootloaders.dfu"/>
 -		<require idref="lufa.boards.dummy.avr8"/>
 -		<generator value="as5_8"/>
 -
 -		<device-support value="at90usb647"/>
 -		<config name="lufa.drivers.board.name" value="none"/>
 -
 -		<config name="config.compiler.optimization.level" value="size"/>
 -
 -		<build type="define" name="F_CPU" value="16000000UL"/>
 -		<build type="define" name="F_USB" value="16000000UL"/>
 -
 -		<build type="define" name="BOOT_START_ADDR" value="0xF000"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.text=0xF000"/>
 -
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_trampolines=0xFFA0"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Trampolines"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_jumptable=0xFFE0"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_JumpTable"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_signatures=0xFFF8"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Signatures"/>
 -	</project>
 -
 -	<project caption="DFU Bootloader - 32KB FLASH / 4KB Boot - AVR8 Architecture" id="lufa.bootloaders.dfu.avr8.32_4" force-caption="true" workspace-name="lufa_dfu_32kb_4kb_">
 -		<require idref="lufa.bootloaders.dfu"/>
 -		<require idref="lufa.boards.dummy.avr8"/>
 -		<generator value="as5_8"/>
 -
 -		<device-support value="atmega32u4"/>
 -		<config name="lufa.drivers.board.name" value="none"/>
 -
 -		<config name="config.compiler.optimization.level" value="size"/>
 -
 -		<build type="define" name="F_CPU" value="16000000UL"/>
 -		<build type="define" name="F_USB" value="16000000UL"/>
 -
 -		<build type="define" name="BOOT_START_ADDR" value="0x7000"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.text=0x7000"/>
 -
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_trampolines=0x7FA0"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Trampolines"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_jumptable=0x7FE0"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_JumpTable"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_signatures=0x7FF8"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Signatures"/>
 -	</project>
 -
 -	<project caption="DFU Bootloader - 16KB FLASH / 4KB Boot - AVR8 Architecture" id="lufa.bootloaders.dfu.avr8.16_4" force-caption="true" workspace-name="lufa_dfu_16kb_4kb_">
 -		<require idref="lufa.bootloaders.dfu"/>
 -		<require idref="lufa.boards.dummy.avr8"/>
 -		<generator value="as5_8"/>
 -
 -		<device-support value="atmega16u2"/>
 -		<config name="lufa.drivers.board.name" value="none"/>
 -
 -		<build type="define" name="F_CPU" value="16000000UL"/>
 -		<build type="define" name="F_USB" value="16000000UL"/>
 -
 -		<build type="define" name="BOOT_START_ADDR" value="0x3000"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.text=0x3000"/>
 -
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_trampolines=0x3FA0"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Trampolines"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_jumptable=0x3FE0"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_JumpTable"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_signatures=0x3FF8"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Signatures"/>
 -	</project>
 -
 -	<project caption="DFU Bootloader - 8KB FLASH / 4KB Boot - AVR8 Architecture" id="lufa.bootloaders.dfu.avr8.8_4" force-caption="true" workspace-name="lufa_dfu_8kb_4kb_">
 -		<require idref="lufa.bootloaders.dfu"/>
 -		<require idref="lufa.boards.dummy.avr8"/>
 -		<generator value="as5_8"/>
 -
 -		<device-support value="atmega8u2"/>
 -		<config name="lufa.drivers.board.name" value="none"/>
 -
 -		<build type="define" name="F_CPU" value="16000000UL"/>
 -		<build type="define" name="F_USB" value="16000000UL"/>
 -
 -		<build type="define" name="BOOT_START_ADDR" value="0x1000"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.text=0x1000"/>
 -
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_trampolines=0x1FA0"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Trampolines"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_jumptable=0x1FE0"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_JumpTable"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_signatures=0x1FF8"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Signatures"/>
 -	</project>
 -
 -	<module type="application" id="lufa.bootloaders.dfu" caption="DFU Bootloader">
 -		<info type="description" value="summary">
 -		DFU Class Bootloader, capable of reprogramming a device using the Atmel FLIP or other AVR DFU programming software when plugged into a host.
 -		</info>
 -
 - 		<info type="gui-flag" value="move-to-root"/>
 -
 -		<info type="keyword" value="Technology">
 -			<keyword value="Bootloaders"/>
 -			<keyword value="USB Device"/>
 -		</info>
 -
 - 		<device-support-alias value="lufa_avr8"/>
 -		<device-support-alias value="lufa_xmega"/>
 -		<device-support-alias value="lufa_uc3"/>
 -
 -		<build type="include-path" value="."/>
 -		<build type="c-source" value="BootloaderDFU.c"/>
 -		<build type="header-file" value="BootloaderDFU.h"/>
 -		<build type="c-source" value="Descriptors.c"/>
 -		<build type="header-file" value="Descriptors.h"/>
 -		<build type="c-source" value="BootloaderAPI.c"/>
 -		<build type="header-file" value="BootloaderAPI.h"/>
 -		<build type="asm-source" value="BootloaderAPITable.S"/>
 -
 -		<build type="module-config" subtype="path" value="Config"/>
 -		<build type="header-file" value="Config/LUFAConfig.h"/>
 -		<build type="header-file" value="Config/AppConfig.h"/>
 -
 -		<build type="distribute" subtype="user-file" value="doxyfile"/>
 -		<build type="distribute" subtype="user-file" value="BootloaderDFU.txt"/>
 -
 -		<require idref="lufa.common"/>
 -		<require idref="lufa.platform"/>
 -		<require idref="lufa.drivers.usb"/>
 -		<require idref="lufa.drivers.board"/>
 -		<require idref="lufa.drivers.board.leds"/>
 -	</module>
 -</asf>
 +<asf xmlversion="1.0"> +	<project caption="DFU Bootloader - 128KB FLASH / 4KB Boot - AVR8 Architecture" id="lufa.bootloaders.dfu.avr8.128_4" force-caption="true" workspace-name="lufa_dfu_128kb_4kb_"> +		<require idref="lufa.bootloaders.dfu"/> +		<require idref="lufa.boards.dummy.avr8"/> +		<generator value="as5_8"/> + +		<device-support value="at90usb1287"/> +		<config name="lufa.drivers.board.name" value="none"/> + +		<config name="config.compiler.optimization.level" value="size"/> + +		<build type="define" name="F_CPU" value="16000000UL"/> +		<build type="define" name="F_USB" value="16000000UL"/> + +		<build type="define" name="BOOT_START_ADDR" value="0x1F000"/> +		<build type="linker-config" subtype="flags" value="--section-start=.text=0x1F000"/> + +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_trampolines=0x1FFA0"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Trampolines"/> +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_jumptable=0x1FFE0"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_JumpTable"/> +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_signatures=0x1FFF8"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Signatures"/> +	</project> + +	<project caption="DFU Bootloader - 64KB FLASH / 4KB Boot - AVR8 Architecture" id="lufa.bootloaders.dfu.avr8.64_4" force-caption="true" workspace-name="lufa_dfu_64kb_4kb_"> +		<require idref="lufa.bootloaders.dfu"/> +		<require idref="lufa.boards.dummy.avr8"/> +		<generator value="as5_8"/> + +		<device-support value="at90usb647"/> +		<config name="lufa.drivers.board.name" value="none"/> + +		<config name="config.compiler.optimization.level" value="size"/> + +		<build type="define" name="F_CPU" value="16000000UL"/> +		<build type="define" name="F_USB" value="16000000UL"/> + +		<build type="define" name="BOOT_START_ADDR" value="0xF000"/> +		<build type="linker-config" subtype="flags" value="--section-start=.text=0xF000"/> + +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_trampolines=0xFFA0"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Trampolines"/> +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_jumptable=0xFFE0"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_JumpTable"/> +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_signatures=0xFFF8"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Signatures"/> +	</project> + +	<project caption="DFU Bootloader - 32KB FLASH / 4KB Boot - AVR8 Architecture" id="lufa.bootloaders.dfu.avr8.32_4" force-caption="true" workspace-name="lufa_dfu_32kb_4kb_"> +		<require idref="lufa.bootloaders.dfu"/> +		<require idref="lufa.boards.dummy.avr8"/> +		<generator value="as5_8"/> + +		<device-support value="atmega32u4"/> +		<config name="lufa.drivers.board.name" value="none"/> + +		<config name="config.compiler.optimization.level" value="size"/> + +		<build type="define" name="F_CPU" value="16000000UL"/> +		<build type="define" name="F_USB" value="16000000UL"/> + +		<build type="define" name="BOOT_START_ADDR" value="0x7000"/> +		<build type="linker-config" subtype="flags" value="--section-start=.text=0x7000"/> + +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_trampolines=0x7FA0"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Trampolines"/> +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_jumptable=0x7FE0"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_JumpTable"/> +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_signatures=0x7FF8"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Signatures"/> +	</project> + +	<project caption="DFU Bootloader - 16KB FLASH / 4KB Boot - AVR8 Architecture" id="lufa.bootloaders.dfu.avr8.16_4" force-caption="true" workspace-name="lufa_dfu_16kb_4kb_"> +		<require idref="lufa.bootloaders.dfu"/> +		<require idref="lufa.boards.dummy.avr8"/> +		<generator value="as5_8"/> + +		<device-support value="atmega16u2"/> +		<config name="lufa.drivers.board.name" value="none"/> + +		<build type="define" name="F_CPU" value="16000000UL"/> +		<build type="define" name="F_USB" value="16000000UL"/> + +		<build type="define" name="BOOT_START_ADDR" value="0x3000"/> +		<build type="linker-config" subtype="flags" value="--section-start=.text=0x3000"/> + +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_trampolines=0x3FA0"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Trampolines"/> +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_jumptable=0x3FE0"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_JumpTable"/> +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_signatures=0x3FF8"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Signatures"/> +	</project> + +	<project caption="DFU Bootloader - 8KB FLASH / 4KB Boot - AVR8 Architecture" id="lufa.bootloaders.dfu.avr8.8_4" force-caption="true" workspace-name="lufa_dfu_8kb_4kb_"> +		<require idref="lufa.bootloaders.dfu"/> +		<require idref="lufa.boards.dummy.avr8"/> +		<generator value="as5_8"/> + +		<device-support value="atmega8u2"/> +		<config name="lufa.drivers.board.name" value="none"/> + +		<build type="define" name="F_CPU" value="16000000UL"/> +		<build type="define" name="F_USB" value="16000000UL"/> + +		<build type="define" name="BOOT_START_ADDR" value="0x1000"/> +		<build type="linker-config" subtype="flags" value="--section-start=.text=0x1000"/> + +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_trampolines=0x1FA0"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Trampolines"/> +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_jumptable=0x1FE0"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_JumpTable"/> +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_signatures=0x1FF8"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Signatures"/> +	</project> + +	<module type="application" id="lufa.bootloaders.dfu" caption="DFU Bootloader"> +		<info type="description" value="summary"> +		DFU Class Bootloader, capable of reprogramming a device using the Atmel FLIP or other AVR DFU programming software when plugged into a host. +		</info> + + 		<info type="gui-flag" value="move-to-root"/> + +		<info type="keyword" value="Technology"> +			<keyword value="Bootloaders"/> +			<keyword value="USB Device"/> +		</info> + + 		<device-support-alias value="lufa_avr8"/> +		<device-support-alias value="lufa_xmega"/> +		<device-support-alias value="lufa_uc3"/> + +		<build type="include-path" value="."/> +		<build type="c-source" value="BootloaderDFU.c"/> +		<build type="header-file" value="BootloaderDFU.h"/> +		<build type="c-source" value="Descriptors.c"/> +		<build type="header-file" value="Descriptors.h"/> +		<build type="c-source" value="BootloaderAPI.c"/> +		<build type="header-file" value="BootloaderAPI.h"/> +		<build type="asm-source" value="BootloaderAPITable.S"/> + +		<build type="module-config" subtype="path" value="Config"/> +		<build type="header-file" value="Config/LUFAConfig.h"/> +		<build type="header-file" value="Config/AppConfig.h"/> + +		<build type="distribute" subtype="user-file" value="doxyfile"/> +		<build type="distribute" subtype="user-file" value="BootloaderDFU.txt"/> + +		<require idref="lufa.common"/> +		<require idref="lufa.platform"/> +		<require idref="lufa.drivers.usb"/> +		<require idref="lufa.drivers.board"/> +		<require idref="lufa.drivers.board.leds"/> +	</module> +</asf> diff --git a/tmk_core/protocol/lufa/LUFA-git/Bootloaders/HID/asf.xml b/tmk_core/protocol/lufa/LUFA-git/Bootloaders/HID/asf.xml index 9394b1353..c67b9419e 100644 --- a/tmk_core/protocol/lufa/LUFA-git/Bootloaders/HID/asf.xml +++ b/tmk_core/protocol/lufa/LUFA-git/Bootloaders/HID/asf.xml @@ -1,123 +1,123 @@ -<asf xmlversion="1.0">
 -	<project caption="HID Bootloader - 128KB FLASH / 4KB Boot - AVR8 Architecture" id="lufa.bootloaders.hid.avr8.128_4" force-caption="true" workspace-name="lufa_hid_128kb_4kb_">
 -		<require idref="lufa.bootloaders.hid"/>
 -		<require idref="lufa.boards.dummy.avr8"/>
 -		<generator value="as5_8"/>
 -
 -		<device-support value="at90usb1287"/>
 -		<config name="lufa.drivers.board.name" value="none"/>
 -
 -		<config name="config.compiler.optimization.level" value="size"/>
 -
 -		<build type="define" name="F_CPU" value="16000000UL"/>
 -		<build type="define" name="F_USB" value="16000000UL"/>
 -
 -		<build type="define" name="BOOT_START_ADDR" value="0x1F000"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.text=0x1F000"/>
 -	</project>
 -
 -	<project caption="HID Bootloader - 64KB FLASH / 4KB Boot - AVR8 Architecture" id="lufa.bootloaders.hid.avr8.64_4" force-caption="true" workspace-name="lufa_hid_64kb_4kb_">
 -		<require idref="lufa.bootloaders.hid"/>
 -		<require idref="lufa.boards.dummy.avr8"/>
 -		<generator value="as5_8"/>
 -
 -		<device-support value="at90usb647"/>
 -		<config name="lufa.drivers.board.name" value="none"/>
 -
 -		<config name="config.compiler.optimization.level" value="size"/>
 -
 -		<build type="define" name="F_CPU" value="16000000UL"/>
 -		<build type="define" name="F_USB" value="16000000UL"/>
 -
 -		<build type="define" name="BOOT_START_ADDR" value="0xF000"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.text=0xF000"/>
 -	</project>
 -
 -	<project caption="HID Bootloader - 32KB FLASH / 4KB Boot - AVR8 Architecture" id="lufa.bootloaders.hid.avr8.32_4" force-caption="true" workspace-name="lufa_hid_32kb_4kb_">
 -		<require idref="lufa.bootloaders.hid"/>
 -		<require idref="lufa.boards.dummy.avr8"/>
 -		<generator value="as5_8"/>
 -
 -		<device-support value="atmega32u4"/>
 -		<config name="lufa.drivers.board.name" value="none"/>
 -
 -		<config name="config.compiler.optimization.level" value="size"/>
 -
 -		<build type="define" name="F_CPU" value="16000000UL"/>
 -		<build type="define" name="F_USB" value="16000000UL"/>
 -
 -		<build type="define" name="BOOT_START_ADDR" value="0x7000"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.text=0x7000"/>
 -	</project>
 -
 -	<project caption="HID Bootloader - 16KB FLASH / 2KB Boot - AVR8 Architecture" id="lufa.bootloaders.hid.avr8.16_2" force-caption="true" workspace-name="lufa_hid_16kb_2kb_">
 -		<require idref="lufa.bootloaders.hid"/>
 -		<require idref="lufa.boards.dummy.avr8"/>
 -		<generator value="as5_8"/>
 -
 -		<device-support value="atmega16u2"/>
 -		<config name="lufa.drivers.board.name" value="none"/>
 -
 -		<config name="config.compiler.optimization.level" value="size"/>
 -
 -		<build type="define" name="F_CPU" value="16000000UL"/>
 -		<build type="define" name="F_USB" value="16000000UL"/>
 -
 -		<build type="define" name="BOOT_START_ADDR" value="0x3800"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.text=0x3800"/>
 -	</project>
 -
 -	<project caption="HID Bootloader - 8KB FLASH / 2KB Boot - AVR8 Architecture" id="lufa.bootloaders.hid.avr8.8_2" force-caption="true" workspace-name="lufa_hid_8kb_2kb_">
 -		<require idref="lufa.bootloaders.hid"/>
 -		<require idref="lufa.boards.dummy.avr8"/>
 -		<generator value="as5_8"/>
 -
 -		<device-support value="atmega8u2"/>
 -		<config name="lufa.drivers.board.name" value="none"/>
 -
 -		<config name="config.compiler.optimization.level" value="size"/>
 -
 -		<build type="define" name="F_CPU" value="16000000UL"/>
 -		<build type="define" name="F_USB" value="16000000UL"/>
 -
 -		<build type="define" name="BOOT_START_ADDR" value="0x1800"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.text=0x1800"/>
 -	</project>
 -
 -	<module type="application" id="lufa.bootloaders.hid" caption="HID Bootloader">
 -		<info type="description" value="summary">
 -		HID Class Bootloader, capable of reprogramming a device via a custom cross-platform command line utility when plugged into a host.
 -		</info>
 -
 - 		<info type="gui-flag" value="move-to-root"/>
 -
 -		<info type="keyword" value="Technology">
 -			<keyword value="Bootloaders"/>
 -			<keyword value="USB Device"/>
 -		</info>
 -
 -		<device-support-alias value="lufa_avr8"/>
 -		<device-support-alias value="lufa_xmega"/>
 -		<device-support-alias value="lufa_uc3"/>
 -
 -		<build type="include-path" value="."/>
 -		<build type="c-source" value="BootloaderHID.c"/>
 -		<build type="header-file" value="BootloaderHID.h"/>
 -		<build type="c-source" value="Descriptors.c"/>
 -		<build type="header-file" value="Descriptors.h"/>
 -
 -		<build type="module-config" subtype="path" value="Config"/>
 -		<build type="header-file" value="Config/LUFAConfig.h"/>
 -
 -		<build type="distribute" subtype="user-file" value="doxyfile"/>
 -		<build type="distribute" subtype="user-file" value="BootloaderHID.txt"/>
 -		<build type="distribute" subtype="directory" value="HostLoaderApp"/>
 -		<build type="distribute" subtype="directory" value="HostLoaderApp_Python"/>
 -
 -		<require idref="lufa.common"/>
 -		<require idref="lufa.platform"/>
 -		<require idref="lufa.drivers.usb"/>
 -		<require idref="lufa.drivers.board"/>
 -		<require idref="lufa.drivers.board.leds"/>
 -	</module>
 -</asf>
 +<asf xmlversion="1.0"> +	<project caption="HID Bootloader - 128KB FLASH / 4KB Boot - AVR8 Architecture" id="lufa.bootloaders.hid.avr8.128_4" force-caption="true" workspace-name="lufa_hid_128kb_4kb_"> +		<require idref="lufa.bootloaders.hid"/> +		<require idref="lufa.boards.dummy.avr8"/> +		<generator value="as5_8"/> + +		<device-support value="at90usb1287"/> +		<config name="lufa.drivers.board.name" value="none"/> + +		<config name="config.compiler.optimization.level" value="size"/> + +		<build type="define" name="F_CPU" value="16000000UL"/> +		<build type="define" name="F_USB" value="16000000UL"/> + +		<build type="define" name="BOOT_START_ADDR" value="0x1F000"/> +		<build type="linker-config" subtype="flags" value="--section-start=.text=0x1F000"/> +	</project> + +	<project caption="HID Bootloader - 64KB FLASH / 4KB Boot - AVR8 Architecture" id="lufa.bootloaders.hid.avr8.64_4" force-caption="true" workspace-name="lufa_hid_64kb_4kb_"> +		<require idref="lufa.bootloaders.hid"/> +		<require idref="lufa.boards.dummy.avr8"/> +		<generator value="as5_8"/> + +		<device-support value="at90usb647"/> +		<config name="lufa.drivers.board.name" value="none"/> + +		<config name="config.compiler.optimization.level" value="size"/> + +		<build type="define" name="F_CPU" value="16000000UL"/> +		<build type="define" name="F_USB" value="16000000UL"/> + +		<build type="define" name="BOOT_START_ADDR" value="0xF000"/> +		<build type="linker-config" subtype="flags" value="--section-start=.text=0xF000"/> +	</project> + +	<project caption="HID Bootloader - 32KB FLASH / 4KB Boot - AVR8 Architecture" id="lufa.bootloaders.hid.avr8.32_4" force-caption="true" workspace-name="lufa_hid_32kb_4kb_"> +		<require idref="lufa.bootloaders.hid"/> +		<require idref="lufa.boards.dummy.avr8"/> +		<generator value="as5_8"/> + +		<device-support value="atmega32u4"/> +		<config name="lufa.drivers.board.name" value="none"/> + +		<config name="config.compiler.optimization.level" value="size"/> + +		<build type="define" name="F_CPU" value="16000000UL"/> +		<build type="define" name="F_USB" value="16000000UL"/> + +		<build type="define" name="BOOT_START_ADDR" value="0x7000"/> +		<build type="linker-config" subtype="flags" value="--section-start=.text=0x7000"/> +	</project> + +	<project caption="HID Bootloader - 16KB FLASH / 2KB Boot - AVR8 Architecture" id="lufa.bootloaders.hid.avr8.16_2" force-caption="true" workspace-name="lufa_hid_16kb_2kb_"> +		<require idref="lufa.bootloaders.hid"/> +		<require idref="lufa.boards.dummy.avr8"/> +		<generator value="as5_8"/> + +		<device-support value="atmega16u2"/> +		<config name="lufa.drivers.board.name" value="none"/> + +		<config name="config.compiler.optimization.level" value="size"/> + +		<build type="define" name="F_CPU" value="16000000UL"/> +		<build type="define" name="F_USB" value="16000000UL"/> + +		<build type="define" name="BOOT_START_ADDR" value="0x3800"/> +		<build type="linker-config" subtype="flags" value="--section-start=.text=0x3800"/> +	</project> + +	<project caption="HID Bootloader - 8KB FLASH / 2KB Boot - AVR8 Architecture" id="lufa.bootloaders.hid.avr8.8_2" force-caption="true" workspace-name="lufa_hid_8kb_2kb_"> +		<require idref="lufa.bootloaders.hid"/> +		<require idref="lufa.boards.dummy.avr8"/> +		<generator value="as5_8"/> + +		<device-support value="atmega8u2"/> +		<config name="lufa.drivers.board.name" value="none"/> + +		<config name="config.compiler.optimization.level" value="size"/> + +		<build type="define" name="F_CPU" value="16000000UL"/> +		<build type="define" name="F_USB" value="16000000UL"/> + +		<build type="define" name="BOOT_START_ADDR" value="0x1800"/> +		<build type="linker-config" subtype="flags" value="--section-start=.text=0x1800"/> +	</project> + +	<module type="application" id="lufa.bootloaders.hid" caption="HID Bootloader"> +		<info type="description" value="summary"> +		HID Class Bootloader, capable of reprogramming a device via a custom cross-platform command line utility when plugged into a host. +		</info> + + 		<info type="gui-flag" value="move-to-root"/> + +		<info type="keyword" value="Technology"> +			<keyword value="Bootloaders"/> +			<keyword value="USB Device"/> +		</info> + +		<device-support-alias value="lufa_avr8"/> +		<device-support-alias value="lufa_xmega"/> +		<device-support-alias value="lufa_uc3"/> + +		<build type="include-path" value="."/> +		<build type="c-source" value="BootloaderHID.c"/> +		<build type="header-file" value="BootloaderHID.h"/> +		<build type="c-source" value="Descriptors.c"/> +		<build type="header-file" value="Descriptors.h"/> + +		<build type="module-config" subtype="path" value="Config"/> +		<build type="header-file" value="Config/LUFAConfig.h"/> + +		<build type="distribute" subtype="user-file" value="doxyfile"/> +		<build type="distribute" subtype="user-file" value="BootloaderHID.txt"/> +		<build type="distribute" subtype="directory" value="HostLoaderApp"/> +		<build type="distribute" subtype="directory" value="HostLoaderApp_Python"/> + +		<require idref="lufa.common"/> +		<require idref="lufa.platform"/> +		<require idref="lufa.drivers.usb"/> +		<require idref="lufa.drivers.board"/> +		<require idref="lufa.drivers.board.leds"/> +	</module> +</asf> diff --git a/tmk_core/protocol/lufa/LUFA-git/Bootloaders/MassStorage/BootloaderAPITable.S b/tmk_core/protocol/lufa/LUFA-git/Bootloaders/MassStorage/BootloaderAPITable.S index 6844d4b01..91fc94966 100644 --- a/tmk_core/protocol/lufa/LUFA-git/Bootloaders/MassStorage/BootloaderAPITable.S +++ b/tmk_core/protocol/lufa/LUFA-git/Bootloaders/MassStorage/BootloaderAPITable.S @@ -1,102 +1,102 @@ -/*
 -             LUFA Library
 -     Copyright (C) Dean Camera, 2014.
 -
 -  dean [at] fourwalledcubicle [dot] com
 -           www.lufa-lib.org
 -*/
 -
 -/*
 -  Copyright 2014  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 disclaims 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.
 -*/
 -
 -#if AUX_BOOT_SECTION_SIZE > 0
 -#warning Using a AUX bootloader section in addition to the defined bootloader space (see documentation).
 -
 -; Trampoline to jump over the AUX bootloader section to the start of the bootloader,
 -; on devices where an AUX bootloader section is used.
 -.section .boot_aux_trampoline, "ax"
 -.global Boot_AUX_Trampoline
 -Boot_AUX_Trampoline:
 -	jmp BOOT_START_ADDR
 -#endif
 -
 -; Trampolines to actual API implementations if the target address is outside the
 -; range of a rjmp instruction (can happen with large bootloader sections)
 -.section .apitable_trampolines, "ax"
 -.global BootloaderAPI_Trampolines
 -BootloaderAPI_Trampolines:
 -
 -	BootloaderAPI_ErasePage_Trampoline:
 -		jmp BootloaderAPI_ErasePage
 -	BootloaderAPI_WritePage_Trampoline:
 -		jmp BootloaderAPI_WritePage
 -	BootloaderAPI_FillWord_Trampoline:
 -		jmp BootloaderAPI_FillWord
 -	BootloaderAPI_ReadSignature_Trampoline:
 -		jmp BootloaderAPI_ReadSignature
 -	BootloaderAPI_ReadFuse_Trampoline:
 -		jmp BootloaderAPI_ReadFuse
 -	BootloaderAPI_ReadLock_Trampoline:
 -		jmp BootloaderAPI_ReadLock
 -	BootloaderAPI_WriteLock_Trampoline:
 -		jmp BootloaderAPI_WriteLock
 -	BootloaderAPI_UNUSED1:
 -		ret
 -	BootloaderAPI_UNUSED2:
 -		ret
 -	BootloaderAPI_UNUSED3:
 -		ret
 -	BootloaderAPI_UNUSED4:
 -		ret
 -	BootloaderAPI_UNUSED5:
 -		ret
 -
 -
 -
 -; API function jump table
 -.section .apitable_jumptable, "ax"
 -.global BootloaderAPI_JumpTable
 -BootloaderAPI_JumpTable:
 -
 -	rjmp BootloaderAPI_ErasePage_Trampoline
 -	rjmp BootloaderAPI_WritePage_Trampoline
 -	rjmp BootloaderAPI_FillWord_Trampoline
 -	rjmp BootloaderAPI_ReadSignature_Trampoline
 -	rjmp BootloaderAPI_ReadFuse_Trampoline
 -	rjmp BootloaderAPI_ReadLock_Trampoline
 -	rjmp BootloaderAPI_WriteLock_Trampoline
 -	rjmp BootloaderAPI_UNUSED1 ; UNUSED ENTRY 1
 -	rjmp BootloaderAPI_UNUSED2 ; UNUSED ENTRY 2
 -	rjmp BootloaderAPI_UNUSED3 ; UNUSED ENTRY 3
 -	rjmp BootloaderAPI_UNUSED4 ; UNUSED ENTRY 4
 -	rjmp BootloaderAPI_UNUSED5 ; UNUSED ENTRY 5
 -
 -
 -
 -; Bootloader table signatures and information
 -.section .apitable_signatures, "ax"
 -.global BootloaderAPI_Signatures
 -BootloaderAPI_Signatures:
 -
 -	.long BOOT_START_ADDR ; Start address of the bootloader
 -	.word 0xDF30 ; Signature for the MS class bootloader, V1
 -	.word 0xDCFB ; Signature for a LUFA class bootloader
 +/* +             LUFA Library +     Copyright (C) Dean Camera, 2014. + +  dean [at] fourwalledcubicle [dot] com +           www.lufa-lib.org +*/ + +/* +  Copyright 2014  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 disclaims 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. +*/ + +#if AUX_BOOT_SECTION_SIZE > 0 +#warning Using a AUX bootloader section in addition to the defined bootloader space (see documentation). + +; Trampoline to jump over the AUX bootloader section to the start of the bootloader, +; on devices where an AUX bootloader section is used. +.section .boot_aux_trampoline, "ax" +.global Boot_AUX_Trampoline +Boot_AUX_Trampoline: +	jmp BOOT_START_ADDR +#endif + +; Trampolines to actual API implementations if the target address is outside the +; range of a rjmp instruction (can happen with large bootloader sections) +.section .apitable_trampolines, "ax" +.global BootloaderAPI_Trampolines +BootloaderAPI_Trampolines: + +	BootloaderAPI_ErasePage_Trampoline: +		jmp BootloaderAPI_ErasePage +	BootloaderAPI_WritePage_Trampoline: +		jmp BootloaderAPI_WritePage +	BootloaderAPI_FillWord_Trampoline: +		jmp BootloaderAPI_FillWord +	BootloaderAPI_ReadSignature_Trampoline: +		jmp BootloaderAPI_ReadSignature +	BootloaderAPI_ReadFuse_Trampoline: +		jmp BootloaderAPI_ReadFuse +	BootloaderAPI_ReadLock_Trampoline: +		jmp BootloaderAPI_ReadLock +	BootloaderAPI_WriteLock_Trampoline: +		jmp BootloaderAPI_WriteLock +	BootloaderAPI_UNUSED1: +		ret +	BootloaderAPI_UNUSED2: +		ret +	BootloaderAPI_UNUSED3: +		ret +	BootloaderAPI_UNUSED4: +		ret +	BootloaderAPI_UNUSED5: +		ret + + + +; API function jump table +.section .apitable_jumptable, "ax" +.global BootloaderAPI_JumpTable +BootloaderAPI_JumpTable: + +	rjmp BootloaderAPI_ErasePage_Trampoline +	rjmp BootloaderAPI_WritePage_Trampoline +	rjmp BootloaderAPI_FillWord_Trampoline +	rjmp BootloaderAPI_ReadSignature_Trampoline +	rjmp BootloaderAPI_ReadFuse_Trampoline +	rjmp BootloaderAPI_ReadLock_Trampoline +	rjmp BootloaderAPI_WriteLock_Trampoline +	rjmp BootloaderAPI_UNUSED1 ; UNUSED ENTRY 1 +	rjmp BootloaderAPI_UNUSED2 ; UNUSED ENTRY 2 +	rjmp BootloaderAPI_UNUSED3 ; UNUSED ENTRY 3 +	rjmp BootloaderAPI_UNUSED4 ; UNUSED ENTRY 4 +	rjmp BootloaderAPI_UNUSED5 ; UNUSED ENTRY 5 + + + +; Bootloader table signatures and information +.section .apitable_signatures, "ax" +.global BootloaderAPI_Signatures +BootloaderAPI_Signatures: + +	.long BOOT_START_ADDR ; Start address of the bootloader +	.word 0xDF30 ; Signature for the MS class bootloader, V1 +	.word 0xDCFB ; Signature for a LUFA class bootloader diff --git a/tmk_core/protocol/lufa/LUFA-git/Bootloaders/MassStorage/asf.xml b/tmk_core/protocol/lufa/LUFA-git/Bootloaders/MassStorage/asf.xml index f1d550d1e..700ffa26f 100644 --- a/tmk_core/protocol/lufa/LUFA-git/Bootloaders/MassStorage/asf.xml +++ b/tmk_core/protocol/lufa/LUFA-git/Bootloaders/MassStorage/asf.xml @@ -1,156 +1,156 @@ -<asf xmlversion="1.0">
 -	<project caption="Mass Storage Bootloader - 128KB FLASH / 8KB Boot - AVR8 Architecture" id="lufa.bootloaders.mass_storage.avr8.128_8" force-caption="true" workspace-name="lufa_ms_128kb_8kb_">
 -		<require idref="lufa.bootloaders.mass_storage"/>
 -		<require idref="lufa.boards.dummy.avr8"/>
 -		<generator value="as5_8"/>
 -
 -		<device-support value="at90usb1287"/>
 -		<config name="lufa.drivers.board.name" value="none"/>
 -
 -		<config name="config.compiler.optimization.level" value="size"/>
 -
 -		<build type="define" name="F_CPU" value="16000000UL"/>
 -		<build type="define" name="F_USB" value="16000000UL"/>
 -
 -		<build type="define" name="BOOT_START_ADDR" value="0x1E000"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.text=0x1E000"/>
 -
 -		<build type="define" name="AUX_BOOT_SECTION_SIZE" value="0"/>
 -
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_trampolines=0x1FFA0"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Trampolines"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_jumptable=0x1FFE0"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_JumpTable"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_signatures=0x1FFF8"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Signatures"/>
 -	</project>
 -
 -	<project caption="Mass Storage Bootloader - 64KB FLASH / 8KB Boot - AVR8 Architecture" id="lufa.bootloaders.mass_storage.avr8.64_8" force-caption="true" workspace-name="lufa_ms_64kb_8kb_">
 -		<require idref="lufa.bootloaders.mass_storage"/>
 -		<require idref="lufa.boards.dummy.avr8"/>
 -		<generator value="as5_8"/>
 -
 -		<device-support value="at90usb647"/>
 -		<config name="lufa.drivers.board.name" value="none"/>
 -
 -		<config name="config.compiler.optimization.level" value="size"/>
 -
 -		<build type="define" name="F_CPU" value="16000000UL"/>
 -		<build type="define" name="F_USB" value="16000000UL"/>
 -
 -		<build type="define" name="BOOT_START_ADDR" value="0xE000"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.text=0xE000"/>
 -
 -		<build type="define" name="AUX_BOOT_SECTION_SIZE" value="0"/>
 -
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_trampolines=0xFFA0"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Trampolines"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_jumptable=0xFFE0"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_JumpTable"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_signatures=0xFFF8"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Signatures"/>
 -	</project>
 -
 -	<project caption="Mass Storage Bootloader - 32KB FLASH / 4KB Boot (2KB AUX) - AVR8 Architecture" id="lufa.bootloaders.mass_storage.avr8.32_4" force-caption="true" workspace-name="lufa_ms_32kb_4kb_">
 -		<require idref="lufa.bootloaders.mass_storage"/>
 -		<require idref="lufa.boards.dummy.avr8"/>
 -		<generator value="as5_8"/>
 -
 -		<device-support value="atmega32u4"/>
 -		<config name="lufa.drivers.board.name" value="none"/>
 -
 -		<config name="config.compiler.optimization.level" value="size"/>
 -
 -		<build type="define" name="F_CPU" value="16000000UL"/>
 -		<build type="define" name="F_USB" value="16000000UL"/>
 -
 -		<build type="define" name="BOOT_START_ADDR" value="0x7000"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.text=0x7000"/>
 -
 -		<build type="define" name="AUX_BOOT_SECTION_SIZE" value="2048"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.boot_aux=0x6810"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.boot_aux_trampoline=0x6800"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=Boot_AUX_Trampoline"/>
 -
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_trampolines=0x7FA0"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Trampolines"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_jumptable=0x7FE0"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_JumpTable"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_signatures=0x7FF8"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Signatures"/>
 -	</project>
 -
 -	<project caption="Mass Storage Bootloader - 16KB FLASH / 4KB Boot (2KB AUX) - AVR8 Architecture" id="lufa.bootloaders.mass_storage.avr8.16_4" force-caption="true" workspace-name="lufa_ms_16kb_4kb_">
 -		<require idref="lufa.bootloaders.mass_storage"/>
 -		<require idref="lufa.boards.dummy.avr8"/>
 -		<generator value="as5_8"/>
 -
 -		<device-support value="atmega16u2"/>
 -		<config name="lufa.drivers.board.name" value="none"/>
 -
 -		<config name="config.compiler.optimization.level" value="size"/>
 -
 -		<build type="define" name="F_CPU" value="16000000UL"/>
 -		<build type="define" name="F_USB" value="16000000UL"/>
 -
 -		<build type="define" name="BOOT_START_ADDR" value="0x3000"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.text=0x3000"/>
 -
 -		<build type="define" name="AUX_BOOT_SECTION_SIZE" value="2048"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.boot_aux=0x2810"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.boot_aux_trampoline=0x2800"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=Boot_AUX_Trampoline"/>
 -
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_trampolines=0x3FA0"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Trampolines"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_jumptable=0x3FE0"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_JumpTable"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_signatures=0x3FF8"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Signatures"/>
 -	</project>
 -
 -	<module type="application" id="lufa.bootloaders.mass_storage" caption="Mass Storage Bootloader">
 -		<info type="description" value="summary">
 -		Mass Storage Class Bootloader, capable of reprogramming a device via binary BIN files copied to the virtual FAT12 file-system it creates when plugged into a host.
 -		</info>
 -
 - 		<info type="gui-flag" value="move-to-root"/>
 -
 -		<info type="keyword" value="Technology">
 -			<keyword value="Bootloaders"/>
 -			<keyword value="USB Device"/>
 -		</info>
 -
 -		<device-support-alias value="lufa_avr8"/>
 -		<device-support-alias value="lufa_xmega"/>
 -		<device-support-alias value="lufa_uc3"/>
 -
 -		<build type="include-path" value="."/>
 -		<build type="c-source" value="BootloaderMassStorage.c"/>
 -		<build type="header-file" value="BootloaderMassStorage.h"/>
 -		<build type="c-source" value="Descriptors.c"/>
 -		<build type="header-file" value="Descriptors.h"/>
 -		<build type="c-source" value="BootloaderAPI.c"/>
 -		<build type="header-file" value="BootloaderAPI.h"/>
 -		<build type="asm-source" value="BootloaderAPITable.S"/>
 -
 -		<build type="module-config" subtype="path" value="Config"/>
 -		<build type="header-file" value="Config/LUFAConfig.h"/>
 -		<build type="header-file" value="Config/AppConfig.h"/>
 -
 -		<build type="include-path" value="Lib"/>
 -		<build type="header-file" value="Lib/VirtualFAT.h"/>
 -		<build type="c-source" value="Lib/VirtualFAT.c"/>
 -		<build type="header-file" value="Lib/SCSI.h"/>
 -		<build type="c-source" value="Lib/SCSI.c"/>
 -
 -		<build type="distribute" subtype="user-file" value="doxyfile"/>
 -		<build type="distribute" subtype="user-file" value="BootloaderMassStorage.txt"/>
 -
 -		<require idref="lufa.common"/>
 -		<require idref="lufa.platform"/>
 -		<require idref="lufa.drivers.usb"/>
 -		<require idref="lufa.drivers.board"/>
 -		<require idref="lufa.drivers.board.leds"/>
 -	</module>
 -</asf>
 +<asf xmlversion="1.0"> +	<project caption="Mass Storage Bootloader - 128KB FLASH / 8KB Boot - AVR8 Architecture" id="lufa.bootloaders.mass_storage.avr8.128_8" force-caption="true" workspace-name="lufa_ms_128kb_8kb_"> +		<require idref="lufa.bootloaders.mass_storage"/> +		<require idref="lufa.boards.dummy.avr8"/> +		<generator value="as5_8"/> + +		<device-support value="at90usb1287"/> +		<config name="lufa.drivers.board.name" value="none"/> + +		<config name="config.compiler.optimization.level" value="size"/> + +		<build type="define" name="F_CPU" value="16000000UL"/> +		<build type="define" name="F_USB" value="16000000UL"/> + +		<build type="define" name="BOOT_START_ADDR" value="0x1E000"/> +		<build type="linker-config" subtype="flags" value="--section-start=.text=0x1E000"/> + +		<build type="define" name="AUX_BOOT_SECTION_SIZE" value="0"/> + +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_trampolines=0x1FFA0"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Trampolines"/> +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_jumptable=0x1FFE0"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_JumpTable"/> +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_signatures=0x1FFF8"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Signatures"/> +	</project> + +	<project caption="Mass Storage Bootloader - 64KB FLASH / 8KB Boot - AVR8 Architecture" id="lufa.bootloaders.mass_storage.avr8.64_8" force-caption="true" workspace-name="lufa_ms_64kb_8kb_"> +		<require idref="lufa.bootloaders.mass_storage"/> +		<require idref="lufa.boards.dummy.avr8"/> +		<generator value="as5_8"/> + +		<device-support value="at90usb647"/> +		<config name="lufa.drivers.board.name" value="none"/> + +		<config name="config.compiler.optimization.level" value="size"/> + +		<build type="define" name="F_CPU" value="16000000UL"/> +		<build type="define" name="F_USB" value="16000000UL"/> + +		<build type="define" name="BOOT_START_ADDR" value="0xE000"/> +		<build type="linker-config" subtype="flags" value="--section-start=.text=0xE000"/> + +		<build type="define" name="AUX_BOOT_SECTION_SIZE" value="0"/> + +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_trampolines=0xFFA0"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Trampolines"/> +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_jumptable=0xFFE0"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_JumpTable"/> +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_signatures=0xFFF8"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Signatures"/> +	</project> + +	<project caption="Mass Storage Bootloader - 32KB FLASH / 4KB Boot (2KB AUX) - AVR8 Architecture" id="lufa.bootloaders.mass_storage.avr8.32_4" force-caption="true" workspace-name="lufa_ms_32kb_4kb_"> +		<require idref="lufa.bootloaders.mass_storage"/> +		<require idref="lufa.boards.dummy.avr8"/> +		<generator value="as5_8"/> + +		<device-support value="atmega32u4"/> +		<config name="lufa.drivers.board.name" value="none"/> + +		<config name="config.compiler.optimization.level" value="size"/> + +		<build type="define" name="F_CPU" value="16000000UL"/> +		<build type="define" name="F_USB" value="16000000UL"/> + +		<build type="define" name="BOOT_START_ADDR" value="0x7000"/> +		<build type="linker-config" subtype="flags" value="--section-start=.text=0x7000"/> + +		<build type="define" name="AUX_BOOT_SECTION_SIZE" value="2048"/> +		<build type="linker-config" subtype="flags" value="--section-start=.boot_aux=0x6810"/> +		<build type="linker-config" subtype="flags" value="--section-start=.boot_aux_trampoline=0x6800"/> +		<build type="linker-config" subtype="flags" value="--undefined=Boot_AUX_Trampoline"/> + +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_trampolines=0x7FA0"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Trampolines"/> +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_jumptable=0x7FE0"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_JumpTable"/> +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_signatures=0x7FF8"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Signatures"/> +	</project> + +	<project caption="Mass Storage Bootloader - 16KB FLASH / 4KB Boot (2KB AUX) - AVR8 Architecture" id="lufa.bootloaders.mass_storage.avr8.16_4" force-caption="true" workspace-name="lufa_ms_16kb_4kb_"> +		<require idref="lufa.bootloaders.mass_storage"/> +		<require idref="lufa.boards.dummy.avr8"/> +		<generator value="as5_8"/> + +		<device-support value="atmega16u2"/> +		<config name="lufa.drivers.board.name" value="none"/> + +		<config name="config.compiler.optimization.level" value="size"/> + +		<build type="define" name="F_CPU" value="16000000UL"/> +		<build type="define" name="F_USB" value="16000000UL"/> + +		<build type="define" name="BOOT_START_ADDR" value="0x3000"/> +		<build type="linker-config" subtype="flags" value="--section-start=.text=0x3000"/> + +		<build type="define" name="AUX_BOOT_SECTION_SIZE" value="2048"/> +		<build type="linker-config" subtype="flags" value="--section-start=.boot_aux=0x2810"/> +		<build type="linker-config" subtype="flags" value="--section-start=.boot_aux_trampoline=0x2800"/> +		<build type="linker-config" subtype="flags" value="--undefined=Boot_AUX_Trampoline"/> + +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_trampolines=0x3FA0"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Trampolines"/> +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_jumptable=0x3FE0"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_JumpTable"/> +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_signatures=0x3FF8"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Signatures"/> +	</project> + +	<module type="application" id="lufa.bootloaders.mass_storage" caption="Mass Storage Bootloader"> +		<info type="description" value="summary"> +		Mass Storage Class Bootloader, capable of reprogramming a device via binary BIN files copied to the virtual FAT12 file-system it creates when plugged into a host. +		</info> + + 		<info type="gui-flag" value="move-to-root"/> + +		<info type="keyword" value="Technology"> +			<keyword value="Bootloaders"/> +			<keyword value="USB Device"/> +		</info> + +		<device-support-alias value="lufa_avr8"/> +		<device-support-alias value="lufa_xmega"/> +		<device-support-alias value="lufa_uc3"/> + +		<build type="include-path" value="."/> +		<build type="c-source" value="BootloaderMassStorage.c"/> +		<build type="header-file" value="BootloaderMassStorage.h"/> +		<build type="c-source" value="Descriptors.c"/> +		<build type="header-file" value="Descriptors.h"/> +		<build type="c-source" value="BootloaderAPI.c"/> +		<build type="header-file" value="BootloaderAPI.h"/> +		<build type="asm-source" value="BootloaderAPITable.S"/> + +		<build type="module-config" subtype="path" value="Config"/> +		<build type="header-file" value="Config/LUFAConfig.h"/> +		<build type="header-file" value="Config/AppConfig.h"/> + +		<build type="include-path" value="Lib"/> +		<build type="header-file" value="Lib/VirtualFAT.h"/> +		<build type="c-source" value="Lib/VirtualFAT.c"/> +		<build type="header-file" value="Lib/SCSI.h"/> +		<build type="c-source" value="Lib/SCSI.c"/> + +		<build type="distribute" subtype="user-file" value="doxyfile"/> +		<build type="distribute" subtype="user-file" value="BootloaderMassStorage.txt"/> + +		<require idref="lufa.common"/> +		<require idref="lufa.platform"/> +		<require idref="lufa.drivers.usb"/> +		<require idref="lufa.drivers.board"/> +		<require idref="lufa.drivers.board.leds"/> +	</module> +</asf> diff --git a/tmk_core/protocol/lufa/LUFA-git/Bootloaders/MassStorage/makefile b/tmk_core/protocol/lufa/LUFA-git/Bootloaders/MassStorage/makefile index 91bb4038e..a0edb2c4f 100644 --- a/tmk_core/protocol/lufa/LUFA-git/Bootloaders/MassStorage/makefile +++ b/tmk_core/protocol/lufa/LUFA-git/Bootloaders/MassStorage/makefile @@ -1,68 +1,68 @@ -#
 -#             LUFA Library
 -#     Copyright (C) Dean Camera, 2014.
 -#
 -#  dean [at] fourwalledcubicle [dot] com
 -#           www.lufa-lib.org
 -#
 -# --------------------------------------
 -#         LUFA Project Makefile.
 -# --------------------------------------
 -
 -# Run "make help" for target help.
 -
 -MCU          = at90usb1287
 -ARCH         = AVR8
 -BOARD        = USBKEY
 -F_CPU        = 8000000
 -F_USB        = $(F_CPU)
 -OPTIMIZATION = s
 -TARGET       = BootloaderMassStorage
 -SRC          = $(TARGET).c Descriptors.c BootloaderAPI.c BootloaderAPITable.S Lib/SCSI.c Lib/VirtualFAT.c $(LUFA_SRC_USB) $(LUFA_SRC_USBCLASS)
 -LUFA_PATH    = ../../LUFA
 -CC_FLAGS     = -DUSE_LUFA_CONFIG_HEADER -IConfig/ -DBOOT_START_ADDR=$(BOOT_START_OFFSET)
 -LD_FLAGS     = -Wl,--section-start=.text=$(BOOT_START_OFFSET) $(BOOT_API_LD_FLAGS)
 -
 -# Flash size and bootloader section sizes of the target, in KB. These must
 -# match the target's total FLASH size and the bootloader size set in the
 -# device's fuses.
 -FLASH_SIZE_KB         = 128
 -BOOT_SECTION_SIZE_KB  = 8
 -
 -# Bootloader address calculation formulas
 -# Do not modify these macros, but rather modify the dependent values above.
 -CALC_ADDRESS_IN_HEX   = $(shell printf "0x%X" $$(( $(1) )) )
 -BOOT_START_OFFSET     = $(call CALC_ADDRESS_IN_HEX, ($(FLASH_SIZE_KB) - $(BOOT_SECTION_SIZE_KB)) * 1024 )
 -BOOT_SEC_OFFSET       = $(call CALC_ADDRESS_IN_HEX, ($(FLASH_SIZE_KB) * 1024) - ($(strip $(1))) )
 -
 -# Bootloader linker section flags for relocating the API table sections to
 -# known FLASH addresses - these should not normally be user-edited.
 -BOOT_SECTION_LD_FLAG  = -Wl,--section-start=$(strip $(1))=$(call BOOT_SEC_OFFSET, $(3)) -Wl,--undefined=$(strip $(2))
 -BOOT_API_LD_FLAGS     = $(call BOOT_SECTION_LD_FLAG, .apitable_trampolines, BootloaderAPI_Trampolines, 96)
 -BOOT_API_LD_FLAGS    += $(call BOOT_SECTION_LD_FLAG, .apitable_jumptable,   BootloaderAPI_JumpTable,   32)
 -BOOT_API_LD_FLAGS    += $(call BOOT_SECTION_LD_FLAG, .apitable_signatures,  BootloaderAPI_Signatures,  8)
 -
 -# Check if the bootloader needs an AUX section, located before the real bootloader section to store some of the
 -# bootloader code. This is required for 32KB and smaller devices, where the actual bootloader is 6KB but the maximum
 -# bootloader section size is 4KB. The actual usable application space will be reduced by 6KB for these devices.
 -ifeq ($(BOOT_SECTION_SIZE_KB),8)
 -  CC_FLAGS           += -DAUX_BOOT_SECTION_SIZE=0
 -else
 -  AUX_BOOT_SECTION_SIZE_KB = (6 - $(BOOT_SECTION_SIZE_KB))
 -
 -  CC_FLAGS           += -DAUX_BOOT_SECTION_SIZE='($(AUX_BOOT_SECTION_SIZE_KB) * 1024)'
 -  LD_FLAGS           += -Wl,--section-start=.boot_aux=$(call BOOT_SEC_OFFSET, (($(BOOT_SECTION_SIZE_KB) + $(AUX_BOOT_SECTION_SIZE_KB)) * 1024 - 16))
 -  LD_FLAGS           += $(call BOOT_SECTION_LD_FLAG, .boot_aux_trampoline, Boot_AUX_Trampoline, ($(BOOT_SECTION_SIZE_KB) + $(AUX_BOOT_SECTION_SIZE_KB)) * 1024)
 -endif
 -
 -# Default target
 -all:
 -
 -# Include LUFA build script makefiles
 -include $(LUFA_PATH)/Build/lufa_core.mk
 -include $(LUFA_PATH)/Build/lufa_sources.mk
 -include $(LUFA_PATH)/Build/lufa_build.mk
 -include $(LUFA_PATH)/Build/lufa_cppcheck.mk
 -include $(LUFA_PATH)/Build/lufa_doxygen.mk
 -include $(LUFA_PATH)/Build/lufa_avrdude.mk
 -include $(LUFA_PATH)/Build/lufa_atprogram.mk
 +# +#             LUFA Library +#     Copyright (C) Dean Camera, 2014. +# +#  dean [at] fourwalledcubicle [dot] com +#           www.lufa-lib.org +# +# -------------------------------------- +#         LUFA Project Makefile. +# -------------------------------------- + +# Run "make help" for target help. + +MCU          = at90usb1287 +ARCH         = AVR8 +BOARD        = USBKEY +F_CPU        = 8000000 +F_USB        = $(F_CPU) +OPTIMIZATION = s +TARGET       = BootloaderMassStorage +SRC          = $(TARGET).c Descriptors.c BootloaderAPI.c BootloaderAPITable.S Lib/SCSI.c Lib/VirtualFAT.c $(LUFA_SRC_USB) $(LUFA_SRC_USBCLASS) +LUFA_PATH    = ../../LUFA +CC_FLAGS     = -DUSE_LUFA_CONFIG_HEADER -IConfig/ -DBOOT_START_ADDR=$(BOOT_START_OFFSET) +LD_FLAGS     = -Wl,--section-start=.text=$(BOOT_START_OFFSET) $(BOOT_API_LD_FLAGS) + +# Flash size and bootloader section sizes of the target, in KB. These must +# match the target's total FLASH size and the bootloader size set in the +# device's fuses. +FLASH_SIZE_KB         = 128 +BOOT_SECTION_SIZE_KB  = 8 + +# Bootloader address calculation formulas +# Do not modify these macros, but rather modify the dependent values above. +CALC_ADDRESS_IN_HEX   = $(shell printf "0x%X" $$(( $(1) )) ) +BOOT_START_OFFSET     = $(call CALC_ADDRESS_IN_HEX, ($(FLASH_SIZE_KB) - $(BOOT_SECTION_SIZE_KB)) * 1024 ) +BOOT_SEC_OFFSET       = $(call CALC_ADDRESS_IN_HEX, ($(FLASH_SIZE_KB) * 1024) - ($(strip $(1))) ) + +# Bootloader linker section flags for relocating the API table sections to +# known FLASH addresses - these should not normally be user-edited. +BOOT_SECTION_LD_FLAG  = -Wl,--section-start=$(strip $(1))=$(call BOOT_SEC_OFFSET, $(3)) -Wl,--undefined=$(strip $(2)) +BOOT_API_LD_FLAGS     = $(call BOOT_SECTION_LD_FLAG, .apitable_trampolines, BootloaderAPI_Trampolines, 96) +BOOT_API_LD_FLAGS    += $(call BOOT_SECTION_LD_FLAG, .apitable_jumptable,   BootloaderAPI_JumpTable,   32) +BOOT_API_LD_FLAGS    += $(call BOOT_SECTION_LD_FLAG, .apitable_signatures,  BootloaderAPI_Signatures,  8) + +# Check if the bootloader needs an AUX section, located before the real bootloader section to store some of the +# bootloader code. This is required for 32KB and smaller devices, where the actual bootloader is 6KB but the maximum +# bootloader section size is 4KB. The actual usable application space will be reduced by 6KB for these devices. +ifeq ($(BOOT_SECTION_SIZE_KB),8) +  CC_FLAGS           += -DAUX_BOOT_SECTION_SIZE=0 +else +  AUX_BOOT_SECTION_SIZE_KB = (6 - $(BOOT_SECTION_SIZE_KB)) + +  CC_FLAGS           += -DAUX_BOOT_SECTION_SIZE='($(AUX_BOOT_SECTION_SIZE_KB) * 1024)' +  LD_FLAGS           += -Wl,--section-start=.boot_aux=$(call BOOT_SEC_OFFSET, (($(BOOT_SECTION_SIZE_KB) + $(AUX_BOOT_SECTION_SIZE_KB)) * 1024 - 16)) +  LD_FLAGS           += $(call BOOT_SECTION_LD_FLAG, .boot_aux_trampoline, Boot_AUX_Trampoline, ($(BOOT_SECTION_SIZE_KB) + $(AUX_BOOT_SECTION_SIZE_KB)) * 1024) +endif + +# Default target +all: + +# Include LUFA build script makefiles +include $(LUFA_PATH)/Build/lufa_core.mk +include $(LUFA_PATH)/Build/lufa_sources.mk +include $(LUFA_PATH)/Build/lufa_build.mk +include $(LUFA_PATH)/Build/lufa_cppcheck.mk +include $(LUFA_PATH)/Build/lufa_doxygen.mk +include $(LUFA_PATH)/Build/lufa_avrdude.mk +include $(LUFA_PATH)/Build/lufa_atprogram.mk diff --git a/tmk_core/protocol/lufa/LUFA-git/Bootloaders/Printer/BootloaderAPITable.S b/tmk_core/protocol/lufa/LUFA-git/Bootloaders/Printer/BootloaderAPITable.S index ec499b74e..88c51da82 100644 --- a/tmk_core/protocol/lufa/LUFA-git/Bootloaders/Printer/BootloaderAPITable.S +++ b/tmk_core/protocol/lufa/LUFA-git/Bootloaders/Printer/BootloaderAPITable.S @@ -1,91 +1,91 @@ -/*
 -             LUFA Library
 -     Copyright (C) Dean Camera, 2014.
 -
 -  dean [at] fourwalledcubicle [dot] com
 -           www.lufa-lib.org
 -*/
 -
 -/*
 -  Copyright 2014  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 disclaims 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.
 -*/
 -
 -; Trampolines to actual API implementations if the target address is outside the
 -; range of a rjmp instruction (can happen with large bootloader sections)
 -.section .apitable_trampolines, "ax"
 -.global BootloaderAPI_Trampolines
 -BootloaderAPI_Trampolines:
 -
 -	BootloaderAPI_ErasePage_Trampoline:
 -		jmp BootloaderAPI_ErasePage
 -	BootloaderAPI_WritePage_Trampoline:
 -		jmp BootloaderAPI_WritePage
 -	BootloaderAPI_FillWord_Trampoline:
 -		jmp BootloaderAPI_FillWord
 -	BootloaderAPI_ReadSignature_Trampoline:
 -		jmp BootloaderAPI_ReadSignature
 -	BootloaderAPI_ReadFuse_Trampoline:
 -		jmp BootloaderAPI_ReadFuse
 -	BootloaderAPI_ReadLock_Trampoline:
 -		jmp BootloaderAPI_ReadLock
 -	BootloaderAPI_WriteLock_Trampoline:
 -		jmp BootloaderAPI_WriteLock
 -	BootloaderAPI_UNUSED1:
 -		ret
 -	BootloaderAPI_UNUSED2:
 -		ret
 -	BootloaderAPI_UNUSED3:
 -		ret
 -	BootloaderAPI_UNUSED4:
 -		ret
 -	BootloaderAPI_UNUSED5:
 -		ret
 -
 -
 -
 -; API function jump table
 -.section .apitable_jumptable, "ax"
 -.global BootloaderAPI_JumpTable
 -BootloaderAPI_JumpTable:
 -
 -	rjmp BootloaderAPI_ErasePage_Trampoline
 -	rjmp BootloaderAPI_WritePage_Trampoline
 -	rjmp BootloaderAPI_FillWord_Trampoline
 -	rjmp BootloaderAPI_ReadSignature_Trampoline
 -	rjmp BootloaderAPI_ReadFuse_Trampoline
 -	rjmp BootloaderAPI_ReadLock_Trampoline
 -	rjmp BootloaderAPI_WriteLock_Trampoline
 -	rjmp BootloaderAPI_UNUSED1 ; UNUSED ENTRY 1
 -	rjmp BootloaderAPI_UNUSED2 ; UNUSED ENTRY 2
 -	rjmp BootloaderAPI_UNUSED3 ; UNUSED ENTRY 3
 -	rjmp BootloaderAPI_UNUSED4 ; UNUSED ENTRY 4
 -	rjmp BootloaderAPI_UNUSED5 ; UNUSED ENTRY 5
 -
 -
 -
 -; Bootloader table signatures and information
 -.section .apitable_signatures, "ax"
 -.global BootloaderAPI_Signatures
 -BootloaderAPI_Signatures:
 -
 -	.long BOOT_START_ADDR ; Start address of the bootloader
 -	.word 0xDF20 ; Signature for the Printer class bootloader
 -	.word 0xDCFB ; Signature for a LUFA class bootloader
 +/* +             LUFA Library +     Copyright (C) Dean Camera, 2014. + +  dean [at] fourwalledcubicle [dot] com +           www.lufa-lib.org +*/ + +/* +  Copyright 2014  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 disclaims 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. +*/ + +; Trampolines to actual API implementations if the target address is outside the +; range of a rjmp instruction (can happen with large bootloader sections) +.section .apitable_trampolines, "ax" +.global BootloaderAPI_Trampolines +BootloaderAPI_Trampolines: + +	BootloaderAPI_ErasePage_Trampoline: +		jmp BootloaderAPI_ErasePage +	BootloaderAPI_WritePage_Trampoline: +		jmp BootloaderAPI_WritePage +	BootloaderAPI_FillWord_Trampoline: +		jmp BootloaderAPI_FillWord +	BootloaderAPI_ReadSignature_Trampoline: +		jmp BootloaderAPI_ReadSignature +	BootloaderAPI_ReadFuse_Trampoline: +		jmp BootloaderAPI_ReadFuse +	BootloaderAPI_ReadLock_Trampoline: +		jmp BootloaderAPI_ReadLock +	BootloaderAPI_WriteLock_Trampoline: +		jmp BootloaderAPI_WriteLock +	BootloaderAPI_UNUSED1: +		ret +	BootloaderAPI_UNUSED2: +		ret +	BootloaderAPI_UNUSED3: +		ret +	BootloaderAPI_UNUSED4: +		ret +	BootloaderAPI_UNUSED5: +		ret + + + +; API function jump table +.section .apitable_jumptable, "ax" +.global BootloaderAPI_JumpTable +BootloaderAPI_JumpTable: + +	rjmp BootloaderAPI_ErasePage_Trampoline +	rjmp BootloaderAPI_WritePage_Trampoline +	rjmp BootloaderAPI_FillWord_Trampoline +	rjmp BootloaderAPI_ReadSignature_Trampoline +	rjmp BootloaderAPI_ReadFuse_Trampoline +	rjmp BootloaderAPI_ReadLock_Trampoline +	rjmp BootloaderAPI_WriteLock_Trampoline +	rjmp BootloaderAPI_UNUSED1 ; UNUSED ENTRY 1 +	rjmp BootloaderAPI_UNUSED2 ; UNUSED ENTRY 2 +	rjmp BootloaderAPI_UNUSED3 ; UNUSED ENTRY 3 +	rjmp BootloaderAPI_UNUSED4 ; UNUSED ENTRY 4 +	rjmp BootloaderAPI_UNUSED5 ; UNUSED ENTRY 5 + + + +; Bootloader table signatures and information +.section .apitable_signatures, "ax" +.global BootloaderAPI_Signatures +BootloaderAPI_Signatures: + +	.long BOOT_START_ADDR ; Start address of the bootloader +	.word 0xDF20 ; Signature for the Printer class bootloader +	.word 0xDCFB ; Signature for a LUFA class bootloader diff --git a/tmk_core/protocol/lufa/LUFA-git/Bootloaders/Printer/asf.xml b/tmk_core/protocol/lufa/LUFA-git/Bootloaders/Printer/asf.xml index 86a56911e..b5c0c6b3a 100644 --- a/tmk_core/protocol/lufa/LUFA-git/Bootloaders/Printer/asf.xml +++ b/tmk_core/protocol/lufa/LUFA-git/Bootloaders/Printer/asf.xml @@ -1,159 +1,159 @@ -<asf xmlversion="1.0">
 -	<project caption="Printer Bootloader - 128KB FLASH / 4KB Boot - AVR8 Architecture" id="lufa.bootloaders.printer.avr8.128_4" force-caption="true" workspace-name="lufa_printer_128kb_4kb_">
 -		<require idref="lufa.bootloaders.printer"/>
 -		<require idref="lufa.boards.dummy.avr8"/>
 -		<generator value="as5_8"/>
 -
 -		<device-support value="at90usb1287"/>
 -		<config name="lufa.drivers.board.name" value="none"/>
 -
 -		<config name="config.compiler.optimization.level" value="size"/>
 -
 -		<build type="define" name="F_CPU" value="16000000UL"/>
 -		<build type="define" name="F_USB" value="16000000UL"/>
 -
 -		<build type="define" name="BOOT_START_ADDR" value="0x1F000"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.text=0x1F000"/>
 -
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_trampolines=0x1FFA0"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Trampolines"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_jumptable=0x1FFE0"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_JumpTable"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_signatures=0x1FFF8"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Signatures"/>
 -	</project>
 -
 -	<project caption="Printer Bootloader - 64KB FLASH / 4KB Boot - AVR8 Architecture" id="lufa.bootloaders.printer.avr8.64_4" force-caption="true" workspace-name="lufa_printer_64kb_4kb_">
 -		<require idref="lufa.bootloaders.printer"/>
 -		<require idref="lufa.boards.dummy.avr8"/>
 -		<generator value="as5_8"/>
 -
 -		<device-support value="at90usb647"/>
 -		<config name="lufa.drivers.board.name" value="none"/>
 -
 -		<config name="config.compiler.optimization.level" value="size"/>
 -
 -		<build type="define" name="F_CPU" value="16000000UL"/>
 -		<build type="define" name="F_USB" value="16000000UL"/>
 -
 -		<build type="define" name="BOOT_START_ADDR" value="0xF000"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.text=0xF000"/>
 -
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_trampolines=0xFFA0"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Trampolines"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_jumptable=0xFFE0"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_JumpTable"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_signatures=0xFFF8"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Signatures"/>
 -	</project>
 -
 -	<project caption="Printer Bootloader - 32KB FLASH / 4KB Boot - AVR8 Architecture" id="lufa.bootloaders.printer.avr8.32_4" force-caption="true" workspace-name="lufa_printer_32kb_4kb_">
 -		<require idref="lufa.bootloaders.printer"/>
 -		<require idref="lufa.boards.dummy.avr8"/>
 -		<generator value="as5_8"/>
 -
 -		<device-support value="atmega32u4"/>
 -		<config name="lufa.drivers.board.name" value="none"/>
 -
 -		<config name="config.compiler.optimization.level" value="size"/>
 -
 -		<build type="define" name="F_CPU" value="16000000UL"/>
 -		<build type="define" name="F_USB" value="16000000UL"/>
 -
 -		<build type="define" name="BOOT_START_ADDR" value="0x7000"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.text=0x7000"/>
 -
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_trampolines=0x7FA0"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Trampolines"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_jumptable=0x7FE0"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_JumpTable"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_signatures=0x7FF8"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Signatures"/>
 -	</project>
 -
 -	<project caption="Printer Bootloader - 16KB FLASH / 4KB Boot - AVR8 Architecture" id="lufa.bootloaders.printer.avr8.16_4" force-caption="true" workspace-name="lufa_printer_16kb_4kb_">
 -		<require idref="lufa.bootloaders.printer"/>
 -		<require idref="lufa.boards.dummy.avr8"/>
 -		<generator value="as5_8"/>
 -
 -		<device-support value="atmega16u2"/>
 -		<config name="lufa.drivers.board.name" value="none"/>
 -
 -		<config name="config.compiler.optimization.level" value="size"/>
 -
 -		<build type="define" name="F_CPU" value="16000000UL"/>
 -		<build type="define" name="F_USB" value="16000000UL"/>
 -
 -		<build type="define" name="BOOT_START_ADDR" value="0x3000"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.text=0x3000"/>
 -
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_trampolines=0x3FA0"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Trampolines"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_jumptable=0x3FE0"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_JumpTable"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_signatures=0x3FF8"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Signatures"/>
 -	</project>
 -
 -	<project caption="Printer Bootloader - 8KB FLASH / 4KB Boot - AVR8 Architecture" id="lufa.bootloaders.printer.avr8.8_4" force-caption="true" workspace-name="lufa_printer_8kb_4kb_">
 -		<require idref="lufa.bootloaders.printer"/>
 -		<require idref="lufa.boards.dummy.avr8"/>
 -		<generator value="as5_8"/>
 -
 -		<device-support value="atmega8u2"/>
 -		<config name="lufa.drivers.board.name" value="none"/>
 -
 -		<config name="config.compiler.optimization.level" value="size"/>
 -
 -		<build type="define" name="F_CPU" value="16000000UL"/>
 -		<build type="define" name="F_USB" value="16000000UL"/>
 -
 -		<build type="define" name="BOOT_START_ADDR" value="0x1000"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.text=0x1000"/>
 -
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_trampolines=0x1FA0"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Trampolines"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_jumptable=0x1FE0"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_JumpTable"/>
 -		<build type="linker-config" subtype="flags" value="--section-start=.apitable_signatures=0x1FF8"/>
 -		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Signatures"/>
 -	</project>
 -
 -	<module type="application" id="lufa.bootloaders.printer" caption="Printer Bootloader">
 -		<info type="description" value="summary">
 -		Printer Class Bootloader, capable of reprogramming a device by "printing" new HEX files to the virtual Plain-Text printer it creates when plugged into a host.
 -		</info>
 -
 - 		<info type="gui-flag" value="move-to-root"/>
 -
 -		<info type="keyword" value="Technology">
 -			<keyword value="Bootloaders"/>
 -			<keyword value="USB Device"/>
 -		</info>
 -
 -		<device-support-alias value="lufa_avr8"/>
 -		<device-support-alias value="lufa_xmega"/>
 -		<device-support-alias value="lufa_uc3"/>
 -
 -		<build type="include-path" value="."/>
 -		<build type="c-source" value="BootloaderPrinter.c"/>
 -		<build type="header-file" value="BootloaderPrinter.h"/>
 -		<build type="c-source" value="Descriptors.c"/>
 -		<build type="header-file" value="Descriptors.h"/>
 -		<build type="c-source" value="BootloaderAPI.c"/>
 -		<build type="header-file" value="BootloaderAPI.h"/>
 -		<build type="asm-source" value="BootloaderAPITable.S"/>
 -
 -		<build type="module-config" subtype="path" value="Config"/>
 -		<build type="header-file" value="Config/LUFAConfig.h"/>
 -
 -		<build type="distribute" subtype="user-file" value="doxyfile"/>
 -		<build type="distribute" subtype="user-file" value="BootloaderPrinter.txt"/>
 -
 -		<require idref="lufa.common"/>
 -		<require idref="lufa.platform"/>
 -		<require idref="lufa.drivers.usb"/>
 -		<require idref="lufa.drivers.board"/>
 -		<require idref="lufa.drivers.board.leds"/>
 -	</module>
 -</asf>
 +<asf xmlversion="1.0"> +	<project caption="Printer Bootloader - 128KB FLASH / 4KB Boot - AVR8 Architecture" id="lufa.bootloaders.printer.avr8.128_4" force-caption="true" workspace-name="lufa_printer_128kb_4kb_"> +		<require idref="lufa.bootloaders.printer"/> +		<require idref="lufa.boards.dummy.avr8"/> +		<generator value="as5_8"/> + +		<device-support value="at90usb1287"/> +		<config name="lufa.drivers.board.name" value="none"/> + +		<config name="config.compiler.optimization.level" value="size"/> + +		<build type="define" name="F_CPU" value="16000000UL"/> +		<build type="define" name="F_USB" value="16000000UL"/> + +		<build type="define" name="BOOT_START_ADDR" value="0x1F000"/> +		<build type="linker-config" subtype="flags" value="--section-start=.text=0x1F000"/> + +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_trampolines=0x1FFA0"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Trampolines"/> +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_jumptable=0x1FFE0"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_JumpTable"/> +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_signatures=0x1FFF8"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Signatures"/> +	</project> + +	<project caption="Printer Bootloader - 64KB FLASH / 4KB Boot - AVR8 Architecture" id="lufa.bootloaders.printer.avr8.64_4" force-caption="true" workspace-name="lufa_printer_64kb_4kb_"> +		<require idref="lufa.bootloaders.printer"/> +		<require idref="lufa.boards.dummy.avr8"/> +		<generator value="as5_8"/> + +		<device-support value="at90usb647"/> +		<config name="lufa.drivers.board.name" value="none"/> + +		<config name="config.compiler.optimization.level" value="size"/> + +		<build type="define" name="F_CPU" value="16000000UL"/> +		<build type="define" name="F_USB" value="16000000UL"/> + +		<build type="define" name="BOOT_START_ADDR" value="0xF000"/> +		<build type="linker-config" subtype="flags" value="--section-start=.text=0xF000"/> + +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_trampolines=0xFFA0"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Trampolines"/> +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_jumptable=0xFFE0"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_JumpTable"/> +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_signatures=0xFFF8"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Signatures"/> +	</project> + +	<project caption="Printer Bootloader - 32KB FLASH / 4KB Boot - AVR8 Architecture" id="lufa.bootloaders.printer.avr8.32_4" force-caption="true" workspace-name="lufa_printer_32kb_4kb_"> +		<require idref="lufa.bootloaders.printer"/> +		<require idref="lufa.boards.dummy.avr8"/> +		<generator value="as5_8"/> + +		<device-support value="atmega32u4"/> +		<config name="lufa.drivers.board.name" value="none"/> + +		<config name="config.compiler.optimization.level" value="size"/> + +		<build type="define" name="F_CPU" value="16000000UL"/> +		<build type="define" name="F_USB" value="16000000UL"/> + +		<build type="define" name="BOOT_START_ADDR" value="0x7000"/> +		<build type="linker-config" subtype="flags" value="--section-start=.text=0x7000"/> + +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_trampolines=0x7FA0"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Trampolines"/> +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_jumptable=0x7FE0"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_JumpTable"/> +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_signatures=0x7FF8"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Signatures"/> +	</project> + +	<project caption="Printer Bootloader - 16KB FLASH / 4KB Boot - AVR8 Architecture" id="lufa.bootloaders.printer.avr8.16_4" force-caption="true" workspace-name="lufa_printer_16kb_4kb_"> +		<require idref="lufa.bootloaders.printer"/> +		<require idref="lufa.boards.dummy.avr8"/> +		<generator value="as5_8"/> + +		<device-support value="atmega16u2"/> +		<config name="lufa.drivers.board.name" value="none"/> + +		<config name="config.compiler.optimization.level" value="size"/> + +		<build type="define" name="F_CPU" value="16000000UL"/> +		<build type="define" name="F_USB" value="16000000UL"/> + +		<build type="define" name="BOOT_START_ADDR" value="0x3000"/> +		<build type="linker-config" subtype="flags" value="--section-start=.text=0x3000"/> + +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_trampolines=0x3FA0"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Trampolines"/> +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_jumptable=0x3FE0"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_JumpTable"/> +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_signatures=0x3FF8"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Signatures"/> +	</project> + +	<project caption="Printer Bootloader - 8KB FLASH / 4KB Boot - AVR8 Architecture" id="lufa.bootloaders.printer.avr8.8_4" force-caption="true" workspace-name="lufa_printer_8kb_4kb_"> +		<require idref="lufa.bootloaders.printer"/> +		<require idref="lufa.boards.dummy.avr8"/> +		<generator value="as5_8"/> + +		<device-support value="atmega8u2"/> +		<config name="lufa.drivers.board.name" value="none"/> + +		<config name="config.compiler.optimization.level" value="size"/> + +		<build type="define" name="F_CPU" value="16000000UL"/> +		<build type="define" name="F_USB" value="16000000UL"/> + +		<build type="define" name="BOOT_START_ADDR" value="0x1000"/> +		<build type="linker-config" subtype="flags" value="--section-start=.text=0x1000"/> + +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_trampolines=0x1FA0"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Trampolines"/> +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_jumptable=0x1FE0"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_JumpTable"/> +		<build type="linker-config" subtype="flags" value="--section-start=.apitable_signatures=0x1FF8"/> +		<build type="linker-config" subtype="flags" value="--undefined=BootloaderAPI_Signatures"/> +	</project> + +	<module type="application" id="lufa.bootloaders.printer" caption="Printer Bootloader"> +		<info type="description" value="summary"> +		Printer Class Bootloader, capable of reprogramming a device by "printing" new HEX files to the virtual Plain-Text printer it creates when plugged into a host. +		</info> + + 		<info type="gui-flag" value="move-to-root"/> + +		<info type="keyword" value="Technology"> +			<keyword value="Bootloaders"/> +			<keyword value="USB Device"/> +		</info> + +		<device-support-alias value="lufa_avr8"/> +		<device-support-alias value="lufa_xmega"/> +		<device-support-alias value="lufa_uc3"/> + +		<build type="include-path" value="."/> +		<build type="c-source" value="BootloaderPrinter.c"/> +		<build type="header-file" value="BootloaderPrinter.h"/> +		<build type="c-source" value="Descriptors.c"/> +		<build type="header-file" value="Descriptors.h"/> +		<build type="c-source" value="BootloaderAPI.c"/> +		<build type="header-file" value="BootloaderAPI.h"/> +		<build type="asm-source" value="BootloaderAPITable.S"/> + +		<build type="module-config" subtype="path" value="Config"/> +		<build type="header-file" value="Config/LUFAConfig.h"/> + +		<build type="distribute" subtype="user-file" value="doxyfile"/> +		<build type="distribute" subtype="user-file" value="BootloaderPrinter.txt"/> + +		<require idref="lufa.common"/> +		<require idref="lufa.platform"/> +		<require idref="lufa.drivers.usb"/> +		<require idref="lufa.drivers.board"/> +		<require idref="lufa.drivers.board.leds"/> +	</module> +</asf> diff --git a/tmk_core/protocol/lufa/LUFA-git/Bootloaders/Printer/makefile b/tmk_core/protocol/lufa/LUFA-git/Bootloaders/Printer/makefile index 0716c3bbe..0db035de3 100644 --- a/tmk_core/protocol/lufa/LUFA-git/Bootloaders/Printer/makefile +++ b/tmk_core/protocol/lufa/LUFA-git/Bootloaders/Printer/makefile @@ -1,55 +1,55 @@ -#
 -#             LUFA Library
 -#     Copyright (C) Dean Camera, 2014.
 -#
 -#  dean [at] fourwalledcubicle [dot] com
 -#           www.lufa-lib.org
 -#
 -# --------------------------------------
 -#         LUFA Project Makefile.
 -# --------------------------------------
 -
 -# Run "make help" for target help.
 -
 -MCU          = at90usb1287
 -ARCH         = AVR8
 -BOARD        = USBKEY
 -F_CPU        = 8000000
 -F_USB        = $(F_CPU)
 -OPTIMIZATION = s
 -TARGET       = BootloaderPrinter
 -SRC          = $(TARGET).c Descriptors.c BootloaderAPI.c BootloaderAPITable.S $(LUFA_SRC_USB) $(LUFA_SRC_USBCLASS)
 -LUFA_PATH    = ../../LUFA
 -CC_FLAGS     = -DUSE_LUFA_CONFIG_HEADER -IConfig/ -DBOOT_START_ADDR=$(BOOT_START_OFFSET)
 -LD_FLAGS     = -Wl,--section-start=.text=$(BOOT_START_OFFSET) $(BOOT_API_LD_FLAGS)
 -
 -# Flash size and bootloader section sizes of the target, in KB. These must
 -# match the target's total FLASH size and the bootloader size set in the
 -# device's fuses.
 -FLASH_SIZE_KB         = 128
 -BOOT_SECTION_SIZE_KB  = 8
 -
 -# Bootloader address calculation formulas
 -# Do not modify these macros, but rather modify the dependent values above.
 -CALC_ADDRESS_IN_HEX   = $(shell printf "0x%X" $$(( $(1) )) )
 -BOOT_START_OFFSET     = $(call CALC_ADDRESS_IN_HEX, ($(FLASH_SIZE_KB) - $(BOOT_SECTION_SIZE_KB)) * 1024 )
 -BOOT_SEC_OFFSET       = $(call CALC_ADDRESS_IN_HEX, ($(FLASH_SIZE_KB) * 1024) - ($(strip $(1))) )
 -
 -# Bootloader linker section flags for relocating the API table sections to
 -# known FLASH addresses - these should not normally be user-edited.
 -BOOT_SECTION_LD_FLAG  = -Wl,--section-start=$(strip $(1))=$(call BOOT_SEC_OFFSET, $(3)) -Wl,--undefined=$(strip $(2))
 -BOOT_API_LD_FLAGS     = $(call BOOT_SECTION_LD_FLAG, .apitable_trampolines, BootloaderAPI_Trampolines, 96)
 -BOOT_API_LD_FLAGS    += $(call BOOT_SECTION_LD_FLAG, .apitable_jumptable,   BootloaderAPI_JumpTable,   32)
 -BOOT_API_LD_FLAGS    += $(call BOOT_SECTION_LD_FLAG, .apitable_signatures,  BootloaderAPI_Signatures,  8)
 -
 -# Default target
 -all:
 -
 -# Include LUFA build script makefiles
 -include $(LUFA_PATH)/Build/lufa_core.mk
 -include $(LUFA_PATH)/Build/lufa_sources.mk
 -include $(LUFA_PATH)/Build/lufa_build.mk
 -include $(LUFA_PATH)/Build/lufa_cppcheck.mk
 -include $(LUFA_PATH)/Build/lufa_doxygen.mk
 -include $(LUFA_PATH)/Build/lufa_avrdude.mk
 -include $(LUFA_PATH)/Build/lufa_atprogram.mk
 +# +#             LUFA Library +#     Copyright (C) Dean Camera, 2014. +# +#  dean [at] fourwalledcubicle [dot] com +#           www.lufa-lib.org +# +# -------------------------------------- +#         LUFA Project Makefile. +# -------------------------------------- + +# Run "make help" for target help. + +MCU          = at90usb1287 +ARCH         = AVR8 +BOARD        = USBKEY +F_CPU        = 8000000 +F_USB        = $(F_CPU) +OPTIMIZATION = s +TARGET       = BootloaderPrinter +SRC          = $(TARGET).c Descriptors.c BootloaderAPI.c BootloaderAPITable.S $(LUFA_SRC_USB) $(LUFA_SRC_USBCLASS) +LUFA_PATH    = ../../LUFA +CC_FLAGS     = -DUSE_LUFA_CONFIG_HEADER -IConfig/ -DBOOT_START_ADDR=$(BOOT_START_OFFSET) +LD_FLAGS     = -Wl,--section-start=.text=$(BOOT_START_OFFSET) $(BOOT_API_LD_FLAGS) + +# Flash size and bootloader section sizes of the target, in KB. These must +# match the target's total FLASH size and the bootloader size set in the +# device's fuses. +FLASH_SIZE_KB         = 128 +BOOT_SECTION_SIZE_KB  = 8 + +# Bootloader address calculation formulas +# Do not modify these macros, but rather modify the dependent values above. +CALC_ADDRESS_IN_HEX   = $(shell printf "0x%X" $$(( $(1) )) ) +BOOT_START_OFFSET     = $(call CALC_ADDRESS_IN_HEX, ($(FLASH_SIZE_KB) - $(BOOT_SECTION_SIZE_KB)) * 1024 ) +BOOT_SEC_OFFSET       = $(call CALC_ADDRESS_IN_HEX, ($(FLASH_SIZE_KB) * 1024) - ($(strip $(1))) ) + +# Bootloader linker section flags for relocating the API table sections to +# known FLASH addresses - these should not normally be user-edited. +BOOT_SECTION_LD_FLAG  = -Wl,--section-start=$(strip $(1))=$(call BOOT_SEC_OFFSET, $(3)) -Wl,--undefined=$(strip $(2)) +BOOT_API_LD_FLAGS     = $(call BOOT_SECTION_LD_FLAG, .apitable_trampolines, BootloaderAPI_Trampolines, 96) +BOOT_API_LD_FLAGS    += $(call BOOT_SECTION_LD_FLAG, .apitable_jumptable,   BootloaderAPI_JumpTable,   32) +BOOT_API_LD_FLAGS    += $(call BOOT_SECTION_LD_FLAG, .apitable_signatures,  BootloaderAPI_Signatures,  8) + +# Default target +all: + +# Include LUFA build script makefiles +include $(LUFA_PATH)/Build/lufa_core.mk +include $(LUFA_PATH)/Build/lufa_sources.mk +include $(LUFA_PATH)/Build/lufa_build.mk +include $(LUFA_PATH)/Build/lufa_cppcheck.mk +include $(LUFA_PATH)/Build/lufa_doxygen.mk +include $(LUFA_PATH)/Build/lufa_avrdude.mk +include $(LUFA_PATH)/Build/lufa_atprogram.mk diff --git a/tmk_core/protocol/lufa/LUFA-git/LUFA/Build/HID_EEPROM_Loader/makefile b/tmk_core/protocol/lufa/LUFA-git/LUFA/Build/HID_EEPROM_Loader/makefile index 9fd188c93..e839ba6b1 100644 --- a/tmk_core/protocol/lufa/LUFA-git/LUFA/Build/HID_EEPROM_Loader/makefile +++ b/tmk_core/protocol/lufa/LUFA-git/LUFA/Build/HID_EEPROM_Loader/makefile @@ -1,42 +1,42 @@ -#
 -#             LUFA Library
 -#     Copyright (C) Dean Camera, 2014.
 -#
 -#  dean [at] fourwalledcubicle [dot] com
 -#           www.lufa-lib.org
 -#
 -# --------------------------------------
 -#         LUFA Project Makefile.
 -# --------------------------------------
 -
 -# Run "make help" for target help.
 -
 -MCU          = at90usb1287
 -ARCH         = AVR8
 -F_CPU        = 1000000
 -F_USB        = $(F_CPU)
 -OPTIMIZATION = s
 -TARGET       = HID_EEPROM_Loader
 -SRC          = $(TARGET).c
 -LUFA_PATH    = ../../../LUFA
 -CC_FLAGS     =
 -LD_FLAGS     =
 -OBJECT_FILES = InputEEData.o
 -
 -# Default target
 -all:
 -
 -# Determine the AVR sub-architecture of the build main application object file
 -FIND_AVR_SUBARCH = avr$(shell avr-objdump -f $(TARGET).o | grep architecture | cut -d':' -f3 | cut -d',' -f1)
 -
 -# Create a linkable object file with the input binary EEPROM data stored in the FLASH section
 -InputEEData.o: InputEEData.bin $(TARGET).o $(MAKEFILE_LIST)
 -	@echo $(MSG_OBJCPY_CMD) Converting \"$<\" to a object file \"$@\"
 -	avr-objcopy -I binary -O elf32-avr -B $(call FIND_AVR_SUBARCH) --rename-section .data=.progmem.data,contents,alloc,readonly,data $< $@
 -
 -# Include LUFA build script makefiles
 -include $(LUFA_PATH)/Build/lufa_core.mk
 -include $(LUFA_PATH)/Build/lufa_build.mk
 -include $(LUFA_PATH)/Build/lufa_cppcheck.mk
 -include $(LUFA_PATH)/Build/lufa_doxygen.mk
 -include $(LUFA_PATH)/Build/lufa_hid.mk
 +# +#             LUFA Library +#     Copyright (C) Dean Camera, 2014. +# +#  dean [at] fourwalledcubicle [dot] com +#           www.lufa-lib.org +# +# -------------------------------------- +#         LUFA Project Makefile. +# -------------------------------------- + +# Run "make help" for target help. + +MCU          = at90usb1287 +ARCH         = AVR8 +F_CPU        = 1000000 +F_USB        = $(F_CPU) +OPTIMIZATION = s +TARGET       = HID_EEPROM_Loader +SRC          = $(TARGET).c +LUFA_PATH    = ../../../LUFA +CC_FLAGS     = +LD_FLAGS     = +OBJECT_FILES = InputEEData.o + +# Default target +all: + +# Determine the AVR sub-architecture of the build main application object file +FIND_AVR_SUBARCH = avr$(shell avr-objdump -f $(TARGET).o | grep architecture | cut -d':' -f3 | cut -d',' -f1) + +# Create a linkable object file with the input binary EEPROM data stored in the FLASH section +InputEEData.o: InputEEData.bin $(TARGET).o $(MAKEFILE_LIST) +	@echo $(MSG_OBJCPY_CMD) Converting \"$<\" to a object file \"$@\" +	avr-objcopy -I binary -O elf32-avr -B $(call FIND_AVR_SUBARCH) --rename-section .data=.progmem.data,contents,alloc,readonly,data $< $@ + +# Include LUFA build script makefiles +include $(LUFA_PATH)/Build/lufa_core.mk +include $(LUFA_PATH)/Build/lufa_build.mk +include $(LUFA_PATH)/Build/lufa_cppcheck.mk +include $(LUFA_PATH)/Build/lufa_doxygen.mk +include $(LUFA_PATH)/Build/lufa_hid.mk diff --git a/tmk_core/protocol/lufa/LUFA-git/LUFA/CodeTemplates/DeviceTemplate/asf.xml b/tmk_core/protocol/lufa/LUFA-git/LUFA/CodeTemplates/DeviceTemplate/asf.xml index fd65db283..e952714e1 100644 --- a/tmk_core/protocol/lufa/LUFA-git/LUFA/CodeTemplates/DeviceTemplate/asf.xml +++ b/tmk_core/protocol/lufa/LUFA-git/LUFA/CodeTemplates/DeviceTemplate/asf.xml @@ -1,55 +1,55 @@ -<asf xmlversion="1.0">
 -	<project caption="USB Device Template" id="lufa.templates.device.project.avr8">
 -		<require idref="lufa.templates.device"/>
 -		<require idref="lufa.boards.dummy.avr8"/>
 -		<generator value="as5_8_template"/>
 -
 -		<device-support value="at90usb1287"/>
 -		<config name="lufa.drivers.board.name" value="usbkey"/>
 -
 -		<build type="define" name="F_CPU" value="8000000UL"/>
 -		<build type="define" name="F_USB" value="8000000UL"/>
 -	</project>
 -
 -	<project caption="USB Device Template" id="lufa.templates.device.project.xmega">
 -		<require idref="lufa.templates.device"/>
 -		<require idref="lufa.boards.dummy.xmega"/>
 -		<generator value="as5_8_template"/>
 -
 -		<device-support value="atxmega256a3bu"/>
 -		<config name="lufa.drivers.board.name" value="a3bu_xplained"/>
 -
 -		<build type="define" name="F_CPU" value="32000000UL"/>
 -		<build type="define" name="F_USB" value="48000000UL"/>
 -	</project>
 -
 -	<module type="application" id="lufa.templates.device" caption="USB Device Template">
 -		<info type="description" value="summary">
 -		Template for a LUFA USB device mode application.
 -		</info>
 -
 - 		<info type="gui-flag" value="move-to-root"/>
 -
 -		<info type="keyword" value="Technology">
 -			<keyword value="USB Device"/>
 -			<keyword value="Template Projects"/>
 -		</info>
 -
 -		<device-support-alias value="lufa_avr8"/>
 -		<device-support-alias value="lufa_xmega"/>
 -		<device-support-alias value="lufa_uc3"/>
 -
 -		<build type="c-source" value="DeviceApplication.c"/>
 -		<build type="c-source" value="Descriptors.c"/>
 -		<build type="header-file" value="DeviceApplication.h"/>
 -		<build type="header-file" value="Descriptors.h"/>
 -
 -		<build type="module-config" subtype="path" value=".."/>
 -		<build type="header-file" value="../LUFAConfig.h"/>
 -
 -		<require idref="lufa.common"/>
 -		<require idref="lufa.platform"/>
 -		<require idref="lufa.drivers.usb"/>
 -		<require idref="lufa.drivers.board"/>
 -	</module>
 -</asf>
 +<asf xmlversion="1.0"> +	<project caption="USB Device Template" id="lufa.templates.device.project.avr8"> +		<require idref="lufa.templates.device"/> +		<require idref="lufa.boards.dummy.avr8"/> +		<generator value="as5_8_template"/> + +		<device-support value="at90usb1287"/> +		<config name="lufa.drivers.board.name" value="usbkey"/> + +		<build type="define" name="F_CPU" value="8000000UL"/> +		<build type="define" name="F_USB" value="8000000UL"/> +	</project> + +	<project caption="USB Device Template" id="lufa.templates.device.project.xmega"> +		<require idref="lufa.templates.device"/> +		<require idref="lufa.boards.dummy.xmega"/> +		<generator value="as5_8_template"/> + +		<device-support value="atxmega256a3bu"/> +		<config name="lufa.drivers.board.name" value="a3bu_xplained"/> + +		<build type="define" name="F_CPU" value="32000000UL"/> +		<build type="define" name="F_USB" value="48000000UL"/> +	</project> + +	<module type="application" id="lufa.templates.device" caption="USB Device Template"> +		<info type="description" value="summary"> +		Template for a LUFA USB device mode application. +		</info> + + 		<info type="gui-flag" value="move-to-root"/> + +		<info type="keyword" value="Technology"> +			<keyword value="USB Device"/> +			<keyword value="Template Projects"/> +		</info> + +		<device-support-alias value="lufa_avr8"/> +		<device-support-alias value="lufa_xmega"/> +		<device-support-alias value="lufa_uc3"/> + +		<build type="c-source" value="DeviceApplication.c"/> +		<build type="c-source" value="Descriptors.c"/> +		<build type="header-file" value="DeviceApplication.h"/> +		<build type="header-file" value="Descriptors.h"/> + +		<build type="module-config" subtype="path" value=".."/> +		<build type="header-file" value="../LUFAConfig.h"/> + +		<require idref="lufa.common"/> +		<require idref="lufa.platform"/> +		<require idref="lufa.drivers.usb"/> +		<require idref="lufa.drivers.board"/> +	</module> +</asf> diff --git a/tmk_core/protocol/lufa/LUFA-git/LUFA/CodeTemplates/HostTemplate/asf.xml b/tmk_core/protocol/lufa/LUFA-git/LUFA/CodeTemplates/HostTemplate/asf.xml index c1996ec71..c3860c056 100644 --- a/tmk_core/protocol/lufa/LUFA-git/LUFA/CodeTemplates/HostTemplate/asf.xml +++ b/tmk_core/protocol/lufa/LUFA-git/LUFA/CodeTemplates/HostTemplate/asf.xml @@ -1,41 +1,41 @@ -<asf xmlversion="1.0">
 -	<project caption="USB Host Template" id="lufa.templates.host.project">
 -		<require idref="lufa.templates.host"/>
 -		<require idref="lufa.boards.dummy.avr8"/>
 -		<generator value="as5_8_template"/>
 -
 -		<device-support value="at90usb1287"/>
 -		<config name="lufa.drivers.board.name" value="usbkey"/>
 -
 -		<build type="define" name="F_CPU" value="8000000UL"/>
 -		<build type="define" name="F_USB" value="8000000UL"/>
 -	</project>
 -
 -	<module type="application" id="lufa.templates.host" caption="USB Host Template">
 -		<info type="description" value="summary">
 -		Template for a LUFA USB host mode application.
 -		</info>
 -
 - 		<info type="gui-flag" value="move-to-root"/>
 -
 -		<info type="keyword" value="Technology">
 -			<keyword value="USB Host"/>
 -			<keyword value="Template Projects"/>
 -		</info>
 -
 -		<device-support-alias value="lufa_avr8"/>
 -		<device-support-alias value="lufa_xmega"/>
 -		<device-support-alias value="lufa_uc3"/>
 -
 -		<build type="c-source" value="HostApplication.c"/>
 -		<build type="header-file" value="HostApplication.h"/>
 -
 -		<build type="module-config" subtype="path" value=".."/>
 -		<build type="header-file" value="../LUFAConfig.h"/>
 -
 -		<require idref="lufa.common"/>
 -		<require idref="lufa.platform"/>
 -		<require idref="lufa.drivers.usb"/>
 -		<require idref="lufa.drivers.board"/>
 -	</module>
 -</asf>
 +<asf xmlversion="1.0"> +	<project caption="USB Host Template" id="lufa.templates.host.project"> +		<require idref="lufa.templates.host"/> +		<require idref="lufa.boards.dummy.avr8"/> +		<generator value="as5_8_template"/> + +		<device-support value="at90usb1287"/> +		<config name="lufa.drivers.board.name" value="usbkey"/> + +		<build type="define" name="F_CPU" value="8000000UL"/> +		<build type="define" name="F_USB" value="8000000UL"/> +	</project> + +	<module type="application" id="lufa.templates.host" caption="USB Host Template"> +		<info type="description" value="summary"> +		Template for a LUFA USB host mode application. +		</info> + + 		<info type="gui-flag" value="move-to-root"/> + +		<info type="keyword" value="Technology"> +			<keyword value="USB Host"/> +			<keyword value="Template Projects"/> +		</info> + +		<device-support-alias value="lufa_avr8"/> +		<device-support-alias value="lufa_xmega"/> +		<device-support-alias value="lufa_uc3"/> + +		<build type="c-source" value="HostApplication.c"/> +		<build type="header-file" value="HostApplication.h"/> + +		<build type="module-config" subtype="path" value=".."/> +		<build type="header-file" value="../LUFAConfig.h"/> + +		<require idref="lufa.common"/> +		<require idref="lufa.platform"/> +		<require idref="lufa.drivers.usb"/> +		<require idref="lufa.drivers.board"/> +	</module> +</asf> diff --git a/tmk_core/protocol/lufa/LUFA-git/LUFA/DoxygenPages/BuildSystem.txt b/tmk_core/protocol/lufa/LUFA-git/LUFA/DoxygenPages/BuildSystem.txt index 7ddfa1be3..0ae1dd678 100644 --- a/tmk_core/protocol/lufa/LUFA-git/LUFA/DoxygenPages/BuildSystem.txt +++ b/tmk_core/protocol/lufa/LUFA-git/LUFA/DoxygenPages/BuildSystem.txt @@ -1,975 +1,975 @@ -/** \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_BuildSystem_Overview 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.
 - *
 - *  For details on the prerequisites needed for Linux and Windows machines to be able to use the LUFA
 - *  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:
 - *  \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 <tt>make {TARGET_NAME}</tt>
 - *  from the command line, substituting in the appropriate target name.
 - *
 - *  \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 <i>must</i>
 - *  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_BuildSystem_Modules 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
 - *
 - *  If you have problems building using the LUFA build system, see \subpage Page_BuildTroubleshooting for resolution steps.
 - */
 -
 - /** \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 <b>PATH</b> 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
 - *
 - *  <table>
 - *   <tr>
 - *    <td><tt>size</tt></td>
 - *    <td>Display size of the compiled application FLASH and SRAM segments.</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>symbol-sizes</tt></td>
 - *    <td>Display a size-sorted list of symbols from the compiled application, in decimal bytes.</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>lib</tt></td>
 - *    <td>Build and archive all source files into a library A binary file.</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>all</tt></td>
 - *    <td>Build and link the application into ELF debug and HEX binary files.</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>elf</tt></td>
 - *    <td>Build and link the application into an ELF debug file.</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>bin</tt></td>
 - *    <td>Build and link the application and produce a BIN binary file.</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>hex</tt></td>
 - *    <td>Build and link the application and produce HEX and EEP binary files.</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>lss</tt></td>
 - *    <td>Build and link the application and produce a LSS source code/assembly code mixed listing file.</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>clean</tt></td>
 - *    <td>Remove all intermediary files and binary output files.</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>mostlyclean</tt></td>
 - *    <td>Remove all intermediary files but preserve any binary output files.</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt><i><filename></i>.s</tt></td>
 - *    <td>Create an assembly listing of a given input C/C++ source file.</td>
 - *   </tr>
 - *  </table>
 - *
 - *  \section SSec_BuildModule_BUILD_MandatoryParams Mandatory Parameters
 - *
 - *  <table>
 - *   <tr>
 - *    <td><tt>TARGET</tt></td>
 - *    <td>Name of the application output file prefix (e.g. <tt>TestApplication</tt>).</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>ARCH</tt></td>
 - *    <td>Architecture of the target processor (see \ref Page_DeviceSupport).</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>MCU</tt></td>
 - *    <td>Name of the Atmel processor model (e.g. <tt>at90usb1287</tt>).</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>SRC</tt></td>
 - *    <td>List of relative or absolute paths to the application C (.c), C++ (.cpp) and Assembly (.S) source files.</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>F_USB</tt></td>
 - *    <td>Speed in Hz of the input clock frequency to the target's USB controller.</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>LUFA_PATH</tt></td>
 - *    <td>Path to the LUFA library core, either relative or absolute (e.g. <tt>../LUFA-000000/LUFA/</tt>).</td>
 - *   </tr>
 - *  </table>
 - *
 - *  \section SSec_BuildModule_BUILD_OptionalParams Optional Parameters
 - *
 - *  <table>
 - *   <tr>
 - *    <td><tt>BOARD</tt></td>
 - *    <td>LUFA board hardware drivers to use (see \ref Page_DeviceSupport).</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>OPTIMIZATION</tt></td>
 - *    <td>Optimization level to use when compiling source files (see GCC manual).</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>C_STANDARD</tt></td>
 - *    <td>Version of the C standard to apply when compiling C++ source files (see GCC manual).</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>CPP_STANDARD</tt></td>
 - *    <td>Version of the C++ standard to apply when compiling C++ source files (see GCC manual).</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>DEBUG_FORMAT</tt></td>
 - *    <td>Format of the debug information to embed in the generated object files (see GCC manual).</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>DEBUG_LEVEL</tt></td>
 - *    <td>Level of the debugging information to embed in the generated object files (see GCC manual).</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>F_CPU</tt></td>
 - *    <td>Speed of the processor CPU clock, in Hz.</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>C_FLAGS</tt></td>
 - *    <td>Flags to pass to the C compiler only, after the automatically generated flags.</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>CPP_FLAGS</tt></td>
 - *    <td>Flags to pass to the C++ compiler only, after the automatically generated flags.</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>ASM_FLAGS</tt></td>
 - *    <td>Flags to pass to the assembler only, after the automatically generated flags.</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>CC_FLAGS</tt></td>
 - *    <td>Common flags to pass to the C/C++ compiler and assembler, after the automatically generated flags.</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>COMPILER_PATH</tt></td>
 - *    <td>Directory where the C/C++ toolchain is located, if not available in the system <tt>PATH</tt>.</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>LD_FLAGS</tt></td>
 - *    <td>Flags to pass to the linker, after the automatically generated flags.</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>LINKER_RELAXATIONS</tt></td>
 - *    <td>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 <tt>relocation truncated to fit: R_AVR_13_PCREL</tt>, disable this setting.</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>OBJDIR</tt></td>
 - *    <td>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 <b>must</b> be unique.</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>OBJECT_FILES</tt></td>
 - *    <td>List of additional object files that should be linked into the resulting binary.</td>
 - *   </tr>
 - *  </table>
 - *
 - *  \section SSec_BuildModule_BUILD_ProvidedVariables Module Provided Variables
 - *
 - *  <table>
 - *   <tr>
 - *    <td><i>None</i></td>
 - *   </tr>
 - *  </table>
 - *
 - *  \section SSec_BuildModule_BUILD_ProvidedMacros Module Provided Macros
 - *
 - *  <table>
 - *   <tr>
 - *    <td><i>None</i></td>
 - *   </tr>
 - *  </table>
 - */
 -
 -/** \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 <tt>sh</tt>
 - *  shell, GNU <tt>make</tt> and *nix CoreUtils (<tt>echo</tt>, <tt>printf</tt>, etc.).
 - *
 - *  \section SSec_BuildModule_CORE_Targets Targets
 - *
 - *  <table>
 - *   <tr>
 - *    <td><tt>help</tt></td>
 - *    <td>Display build system help and configuration information.</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>list_targets</tt></td>
 - *    <td>List all available build targets from the build system.</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>list_modules</tt></td>
 - *    <td>List all available build modules from the build system.</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>list_mandatory</tt></td>
 - *    <td>List all mandatory parameters required by the included modules.</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>list_optional</tt></td>
 - *    <td>List all optional parameters required by the included modules.</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>list_provided</tt></td>
 - *    <td>List all variables provided by the included modules.</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>list_macros</tt></td>
 - *    <td>List all macros provided by the included modules.</td>
 - *   </tr>
 - *  </table>
 - *
 - *  \section SSec_BuildModule_CORE_MandatoryParams Mandatory Parameters
 - *
 - *  <table>
 - *   <tr>
 - *    <td><i>None</i></td>
 - *   </tr>
 - *  </table>
 - *
 - *  \section SSec_BuildModule_CORE_OptionalParams Optional Parameters
 - *
 - *  <table>
 - *   <tr>
 - *    <td><i>None</i></td>
 - *   </tr>
 - *  </table>
 - *
 - *  \section SSec_BuildModule_CORE_ProvidedVariables Module Provided Variables
 - *
 - *  <table>
 - *   <tr>
 - *    <td><i>None</i></td>
 - *   </tr>
 - *  </table>
 - *
 - *  \section SSec_BuildModule_CORE_ProvidedMacros Module Provided Macros
 - *
 - *  <table>
 - *   <tr>
 - *    <td><i>None</i></td>
 - *   </tr>
 - *  </table>
 - */
 -
 -/** \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 <tt>atprogram.exe</tt> utility to be available in your system's <b>PATH</b>
 - *  variable. The <tt>atprogram.exe</tt> utility is distributed in Atmel AVR Studio 5.x and Atmel Studio 6.x
 - *  inside the application install folder's "\atbackend" subdirectory.
 - *
 - *  \section SSec_BuildModule_ATPROGRAM_Targets Targets
 - *
 - *  <table>
 - *   <tr>
 - *    <td><tt>atprogram</tt></td>
 - *    <td>Program the device FLASH memory with the application's executable data.</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>atprogram-ee</tt></td>
 - *    <td>Program the device EEPROM memory with the application's EEPROM data.</td>
 - *   </tr>
 - *  </table>
 - *
 - *  \section SSec_BuildModule_ATPROGRAM_MandatoryParams Mandatory Parameters
 - *
 - *  <table>
 - *   <tr>
 - *    <td><tt>MCU</tt></td>
 - *    <td>Name of the Atmel processor model (e.g. <tt>at90usb1287</tt>).</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>TARGET</tt></td>
 - *    <td>Name of the application output file prefix (e.g. <tt>TestApplication</tt>).</td>
 - *   </tr>
 - *  </table>
 - *
 - *  \section SSec_BuildModule_ATPROGRAM_OptionalParams Optional Parameters
 - *
 - *  <table>
 - *   <tr>
 - *    <td><tt>ATPROGRAM_PROGRAMMER</tt></td>
 - *    <td>Name of the Atmel programmer or debugger tool to communicate with (e.g. <tt>jtagice3</tt>).</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>ATPROGRAM_INTERFACE</tt></td>
 - *    <td>Name of the programming interface to use when programming the target (e.g. <tt>spi</tt>).</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>ATPROGRAM_PORT</tt></td>
 - *    <td>Name of the communication port to use when when programming with a serially connected tool (e.g. <tt>COM2</tt>).</td>
 - *   </tr>
 - *  </table>
 - *
 - *  \section SSec_BuildModule_ATPROGRAM_ProvidedVariables Module Provided Variables
 - *
 - *  <table>
 - *   <tr>
 - *    <td><i>None</i></td>
 - *   </tr>
 - *  </table>
 - *
 - *  \section SSec_BuildModule_ATPROGRAM_ProvidedMacros Module Provided Macros
 - *
 - *  <table>
 - *   <tr>
 - *    <td><i>None</i></td>
 - *   </tr>
 - *  </table>
 - */
 -
 -/** \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 <tt>avrdude</tt> utility to be available in your system's <b>PATH</b>
 - *  variable. The <tt>avrdude</tt> utility is distributed in the old WinAVR project releases for
 - *  Windows (<a>http://winavr.sourceforge.net</a>) or can be installed on *nix systems via the project's
 - *  source code (<a>https://savannah.nongnu.org/projects/avrdude</a>) or through the package manager.
 - *
 - *  \section SSec_BuildModule_AVRDUDE_Targets Targets
 - *
 - *  <table>
 - *   <tr>
 - *    <td><tt>avrdude</tt></td>
 - *    <td>Program the device FLASH memory with the application's executable data.</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>avrdude-ee</tt></td>
 - *    <td>Program the device EEPROM memory with the application's EEPROM data.</td>
 - *   </tr>
 - *  </table>
 - *
 - *  \section SSec_BuildModule_AVRDUDE_MandatoryParams Mandatory Parameters
 - *
 - *  <table>
 - *   <tr>
 - *    <td><tt>MCU</tt></td>
 - *    <td>Name of the Atmel processor model (e.g. <tt>at90usb1287</tt>).</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>TARGET</tt></td>
 - *    <td>Name of the application output file prefix (e.g. <tt>TestApplication</tt>).</td>
 - *   </tr>
 - *  </table>
 - *
 - *  \section SSec_BuildModule_AVRDUDE_OptionalParams Optional Parameters
 - *
 - *  <table>
 - *   <tr>
 - *    <td><tt>AVRDUDE_PROGRAMMER</tt></td>
 - *    <td>Name of the programmer or debugger tool to communicate with (e.g. <tt>jtagicemkii</tt>).</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>AVRDUDE_PORT</tt></td>
 - *    <td>Name of the communication port to use when when programming with the connected tool (e.g. <tt>COM2</tt>, <tt>/dev/ttyUSB0</tt> or <tt>usb</tt>).</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>AVRDUDE_FLAGS</tt></td>
 - *    <td>Additional flags to pass to avrdude when programming, applied after the automatically generated flags.</td>
 - *   </tr>
 - *  </table>
 - *
 - *  \section SSec_BuildModule_AVRDUDE_ProvidedVariables Module Provided Variables
 - *
 - *  <table>
 - *   <tr>
 - *    <td><i>None</i></td>
 - *   </tr>
 - *  </table>
 - *
 - *  \section SSec_BuildModule_AVRDUDE_ProvidedMacros Module Provided Macros
 - *
 - *  <table>
 - *   <tr>
 - *    <td><i>None</i></td>
 - *   </tr>
 - *  </table>
 - */
 -
 - /** \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 <tt>cppcheck</tt> utility to be available in your system's <b>PATH</b>
 - *  variable. The <tt>cppcheck</tt> utility is distributed through the project's home page
 - *  (<a>http://cppcheck.sourceforge.net</a>) 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
 - *
 - *  <table>
 - *   <tr>
 - *    <td><tt>cppcheck</tt></td>
 - *    <td>Statically analyze the project source code for issues.</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>cppcheck-config</tt></td>
 - *    <td>Check the <tt>cppcheck</tt> configuration - scan source code and warn about missing header files and other issues.</td>
 - *   </tr>
 - *  </table>
 - *
 - *  \section SSec_BuildModule_CPPCHECK_MandatoryParams Mandatory Parameters
 - *
 - *  <table>
 - *   <tr>
 - *    <td><tt>SRC</tt></td>
 - *    <td>List of source files to statically analyze.</td>
 - *   </tr>
 - *  </table>
 - *
 - *  \section SSec_BuildModule_CPPCHECK_OptionalParams Optional Parameters
 - *
 - *  <table>
 - *   <tr>
 - *    <td><tt>CPPCHECK_INCLUDES</tt></td>
 - *    <td>Path of extra directories to check when attemting to resolve C/C++ header file includes.</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>CPPCHECK_EXCLUDES</tt></td>
 - *    <td>Paths or path fragments to exclude when analyzing.</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>CPPCHECK_MSG_TEMPLATE</tt></td>
 - *    <td>Output message template to use when printing errors, warnings and information (see <tt>cppcheck</tt> documentation).</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>CPPCHECK_ENABLE</tt></td>
 - *    <td>Analysis rule categories to enable (see <tt>cppcheck</tt> documentation).</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>CPPCHECK_SUPPRESS</tt></td>
 - *    <td>Specific analysis rules to suppress (see <tt>cppcheck</tt> documentation).</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>CPPCHECK_FAIL_ON_WARNING</tt></td>
 - *    <td>Set to <b>Y</b> to fail the analysis job with an error exit code if warnings are found, <b>N</b> to continue without failing.</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>CPPCHECK_QUIET</tt></td>
 - *    <td>Set to <b>Y</b> to suppress all output except warnings and errors, <b>N</b> to show verbose output information.</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>CPPCHECK_FLAGS</tt></td>
 - *    <td>Extra flags to pass to <tt>cppcheck</tt>, after the automatically generated flags.</td>
 - *   </tr>
 - *  </table>
 - *
 - *  \section SSec_BuildModule_CPPCHECK_ProvidedVariables Module Provided Variables
 - *
 - *  <table>
 - *   <tr>
 - *    <td><i>None</i></td>
 - *   </tr>
 - *  </table>
 - *
 - *  \section SSec_BuildModule_CPPCHECK_ProvidedMacros Module Provided Macros
 - *
 - *  <table>
 - *   <tr>
 - *    <td><i>None</i></td>
 - *   </tr>
 - *  </table>
 - */
 -
 - /** \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 <tt>batchisp</tt> utility from Atmel's FLIP utility, or the open
 - *  source <tt>dfu-programmer</tt> utility (<a>http://dfu-programmer.sourceforge.net/</a>) to be
 - *  available in your system's <b>PATH</b> variable. On *nix systems the <tt>dfu-programmer</tt> utility
 - *  can be installed via the project's source code or through the package manager.
 - *
 - *  \section SSec_BuildModule_DFU_Targets Targets
 - *
 - *  <table>
 - *   <tr>
 - *    <td><tt>dfu</tt></td>
 - *    <td>Program the device FLASH memory with the application's executable data using <tt>dfu-programmer</tt>.</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>dfu-ee</tt></td>
 - *    <td>Program the device EEPROM memory with the application's EEPROM data using <tt>dfu-programmer</tt>.</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>flip</tt></td>
 - *    <td>Program the device FLASH memory with the application's executable data using <tt>batchisp</tt>.</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>flip-ee</tt></td>
 - *    <td>Program the device EEPROM memory with the application's EEPROM data using <tt>batchisp</tt>.</td>
 - *   </tr>
 - *  </table>
 - *
 - *  \section SSec_BuildModule_DFU_MandatoryParams Mandatory Parameters
 - *
 - *  <table>
 - *   <tr>
 - *    <td><tt>MCU</tt></td>
 - *    <td>Name of the Atmel processor model (e.g. <tt>at90usb1287</tt>).</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>TARGET</tt></td>
 - *    <td>Name of the application output file prefix (e.g. <tt>TestApplication</tt>).</td>
 - *   </tr>
 - *  </table>
 - *
 - *  \section SSec_BuildModule_DFU_OptionalParams Optional Parameters
 - *
 - *  <table>
 - *   <tr>
 - *    <td><i>None</i></td>
 - *   </tr>
 - *  </table>
 - *
 - *  \section SSec_BuildModule_DFU_ProvidedVariables Module Provided Variables
 - *
 - *  <table>
 - *   <tr>
 - *    <td><i>None</i></td>
 - *   </tr>
 - *  </table>
 - *
 - *  \section SSec_BuildModule_DFU_ProvidedMacros Module Provided Macros
 - *
 - *  <table>
 - *   <tr>
 - *    <td><i>None</i></td>
 - *   </tr>
 - *  </table>
 - */
 -
 - /** \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 <tt>doxygen</tt> utility from the Doxygen website
 - *  (<a>http://www.doxygen.org/</a>) to be available in your system's <b>PATH</b> variable. On *nix
 - *  systems the <tt>doxygen</tt> utility can be installed via the project's source code or through
 - *  the package manager.
 - *
 - *  \section SSec_BuildModule_DOXYGEN_Targets Targets
 - *
 - *  <table>
 - *   <tr>
 - *    <td><tt>doxygen</tt></td>
 - *    <td>Generate project documentation.</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>doxygen_create</tt></td>
 - *    <td>Create a new Doxygen configuration file using the latest template.</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>doxygen_upgrade</tt></td>
 - *    <td>Upgrade an existing Doxygen configuration file to the latest template</td>
 - *   </tr>
 - *  </table>
 - *
 - *  \section SSec_BuildModule_DOXYGEN_MandatoryParams Mandatory Parameters
 - *
 - *  <table>
 - *   <tr>
 - *    <td><tt>LUFA_PATH</tt></td>
 - *    <td>Path to the LUFA library core, either relative or absolute (e.g. <tt>../LUFA-000000/LUFA/</tt>).</td>
 - *   </tr>
 - *  </table>
 - *
 - *  \section SSec_BuildModule_DOXYGEN_OptionalParams Optional Parameters
 - *
 - *  <table>
 - *   <tr>
 - *    <td><tt>DOXYGEN_CONF</tt></td>
 - *    <td>Name and path of the base Doxygen configuration file for the project.</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>DOXYGEN_FAIL_ON_WARNING</tt></td>
 - *    <td>Set to <b>Y</b> to fail the generation with an error exit code if warnings are found other than unsupported configuration parameters, <b>N</b> to continue without failing.</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>DOXYGEN_OVERRIDE_PARAMS</tt></td>
 - *    <td>Extra Doxygen configuration parameters to apply, overriding the corresponding config entry in the project's configuration file (e.g. <tt>QUIET=YES</tt>).</td>
 - *   </tr>
 - *  </table>
 - *
 - *  \section SSec_BuildModule_DOXYGEN_ProvidedVariables Module Provided Variables
 - *
 - *  <table>
 - *   <tr>
 - *    <td><i>None</i></td>
 - *   </tr>
 - *  </table>
 - *
 - *  \section SSec_BuildModule_DOXYGEN_ProvidedMacros Module Provided Macros
 - *
 - *  <table>
 - *   <tr>
 - *    <td><i>None</i></td>
 - *   </tr>
 - *  </table>
 - */
 -
 - /** \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 (<a>http://www.pjrc.com/teensy/halfkay_protocol.html</a>).
 - *
 - *  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 <tt>hid_bootloader_cli</tt> utility from the included LUFA HID
 - *  class bootloader API subdirectory, or the <tt>teensy_loader_cli</tt> utility from PJRC
 - *  (<a>http://www.pjrc.com/teensy/loader_cli.html</a>) to be available in your system's <b>PATH</b>
 - *  variable.
 - *
 - *  \section SSec_BuildModule_HID_Targets Targets
 - *
 - *  <table>
 - *   <tr>
 - *    <td><tt>hid</tt></td>
 - *    <td>Program the device FLASH memory with the application's executable data using <tt>hid_bootloader_cli</tt>.</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>hid-ee</tt></td>
 - *    <td>Program the device EEPROM memory with the application's EEPROM data using <tt>hid_bootloader_cli</tt> and
 - *        a temporary AVR application programmed into the target's FLASH.
 - *        \note This will erase the currently loaded application in the target.</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>teensy</tt></td>
 - *    <td>Program the device FLASH memory with the application's executable data using <tt>teensy_loader_cli</tt>.</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>teensy-ee</tt></td>
 - *    <td>Program the device EEPROM memory with the application's EEPROM data using <tt>teensy_loader_cli</tt> and
 - *        a temporary AVR application programmed into the target's FLASH.
 - *        \note This will erase the currently loaded application in the target.</td>
 - *   </tr>
 - *  </table>
 - *
 - *  \section SSec_BuildModule_HID_MandatoryParams Mandatory Parameters
 - *
 - *  <table>
 - *   <tr>
 - *    <td><tt>MCU</tt></td>
 - *    <td>Name of the Atmel processor model (e.g. <tt>at90usb1287</tt>).</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>TARGET</tt></td>
 - *    <td>Name of the application output file prefix (e.g. <tt>TestApplication</tt>).</td>
 - *   </tr>
 - *  </table>
 - *
 - *  \section SSec_BuildModule_HID_OptionalParams Optional Parameters
 - *
 - *  <table>
 - *   <tr>
 - *    <td><i>None</i></td>
 - *   </tr>
 - *  </table>
 - *
 - *  \section SSec_BuildModule_HID_ProvidedVariables Module Provided Variables
 - *
 - *  <table>
 - *   <tr>
 - *    <td><i>None</i></td>
 - *   </tr>
 - *  </table>
 - *
 - *  \section SSec_BuildModule_HID_ProvidedMacros Module Provided Macros
 - *
 - *  <table>
 - *   <tr>
 - *    <td><i>None</i></td>
 - *   </tr>
 - *  </table>
 - */
 -
 - /** \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 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:
 - *  \code
 - *  include $(LUFA_PATH)/Build/lufa_sources.mk
 - *  \endcode
 - *
 - *  \section SSec_BuildModule_SOURCES_Requirements Requirements
 - *  None.
 - *
 - *  \section SSec_BuildModule_SOURCES_Targets Targets
 - *
 - *  <table>
 - *   <tr>
 - *    <td><i>None</i></td>
 - *   </tr>
 - *  </table>
 - *
 - *  \section SSec_BuildModule_SOURCES_MandatoryParams Mandatory Parameters
 - *
 - *  <table>
 - *   <tr>
 - *    <td><tt>LUFA_PATH</tt></td>
 - *    <td>Path to the LUFA library core, either relative or absolute (e.g. <tt>../LUFA-000000/LUFA/</tt>).</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>ARCH</tt></td>
 - *    <td>Architecture of the target processor (see \ref Page_DeviceSupport).</td>
 - *   </tr>
 - *  </table>
 - *
 - *  \section SSec_BuildModule_SOURCES_OptionalParams Optional Parameters
 - *
 - *  <table>
 - *   <tr>
 - *    <td><i>None</i></td>
 - *   </tr>
 - *  </table>
 - *
 - *  \section SSec_BuildModule_SOURCES_ProvidedVariables Module Provided Variables
 - *
 - *  <table>
 - *   <tr>
 - *    <td><tt>LUFA_SRC_USB</tt></td>
 - *    <td>List of LUFA USB driver source files.</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>LUFA_SRC_USBCLASS</tt></td>
 - *    <td>List of LUFA USB Class driver source files.</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>LUFA_SRC_TEMPERATURE</tt></td>
 - *    <td>List of LUFA temperature sensor driver source files.</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>LUFA_SRC_SERIAL</tt></td>
 - *    <td>List of LUFA Serial U(S)ART driver source files.</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>LUFA_SRC_TWI</tt></td>
 - *    <td>List of LUFA TWI driver source files.</td>
 - *   </tr>
 - *   <tr>
 - *    <td><tt>LUFA_SRC_PLATFORM</tt></td>
 - *    <td>List of LUFA architecture specific platform management source files.</td>
 - *   </tr>
 - *  </table>
 - *
 - *  \section SSec_BuildModule_SOURCES_ProvidedMacros Module Provided Macros
 - *
 - *  <table>
 - *   <tr>
 - *    <td><i>None</i></td>
 - *   </tr>
 - *  </table>
 - */
 -
 -/** \page Page_BuildTroubleshooting Troubleshooting Information
 - *
 - *  LUFA uses a lot of advanced features of the AVR-GCC compiler, linker, and surrounding binaries. This can sometimes lead to problems compiling applications if one of these
 - *  features is buggy in the version of the tools used in a build environment. Missing utilities and incorrectly set makefile configuration options can also result in different
 - *  errors being produced when compilation or other operations are attempted. The table below lists a set of commonly encountered errors and their resolutions.
 - *
 - *  <table>
 - *    <tr>
 - *    <th>Problem</th>
 - *    <th>Resolution</th>
 - *   </tr>
 - *   <tr>
 - *    <td>Error "<b><tt>relocation truncated to fit: R_AVR_13_PCREL against symbol <i>{X}</i></tt></b>" shown when compiling.</td>
 - *    <td>Try compiling with the setting <tt>LINKER_RELAXATIONS=N</tt> in your LUFA Build System 2.0 makefile, or remove the line <tt>-Wl,--relax</tt>
 - *        from other makefiles. Alternatively, make sure you have the latest version of the Atmel Toolchain installed for your system.</td>
 - *   </tr>
 - *   <tr>
 - *    <td>Error "<b><tt>error: ld terminated with signal 11 [Segmentation fault]</tt></b>" shown when compiling.</td>
 - *    <td>Try compiling with the setting <tt>DEBUG_LEVEL=2</tt> in your LUFA Build System 2.0 makefile, or make sure you are using <tt>binutils</tt> version 2.22 or later.</td>
 - *   </tr>
 - *   <tr>
 - *    <td>Error "<b><tt>EMERGENCY ABORT: INFINITE RECURSION DETECTED</tt></b>" shown when compiling.</td>
 - *    <td>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.</td>
 - *   </tr>
 - *   <tr>
 - *    <td>Error "<b><tt>Unsupported architecture "<i>{X}</i>"</tt></b>" shown when compiling.</td>
 - *    <td>Ensure your makefile's <tt>ARCH</tt> setting is set to one of the architecture names (case-sensitive) supported by the version of LUFA you are compiling against.</td>
 - *   </tr>
 - *   <tr>
 - *    <td>Error "<b><tt>Makefile <i>{X}</i> value not set</tt></b>" shown when compiling.</td>
 - *    <td>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.</td>
 - *   </tr>
 - *   <tr>
 - *    <td>Error "<b><tt>Makefile <i>{X}</i> option cannot be blank</tt></b>" shown when compiling.</td>
 - *    <td>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.</td>
 - *   </tr>
 - *   <tr>
 - *    <td>Error "<b><tt>Makefile <i>{X}</i> option must be Y or N</tt></b>" shown when compiling.</td>
 - *    <td>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.</td>
 - *   </tr>
 - *   <tr>
 - *    <td>Error "<b><tt>Unknown input source file formats: <i>{X}</i></tt></b>" shown when compiling.</td>
 - *    <td>The nominated source files, specified in your project's makefile in the <tt>SRC</tt> 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 (<tt>*.c</tt>, <tt>*.cpp</tt> or <tt>*.S</tt>).</td>
 - *   </tr>
 - *   <tr>
 - *    <td>Error "<b><tt>Cannot build with OBJDIR parameter set - one or more object file name is not unique</tt></b>" shown when compiling.</td>
 - *    <td>When a project is built with a non-empty <tt>OBJDIR</tt> 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.</td>
 - *   </tr>
 - *   <tr>
 - *    <td>Error "<b><tt>Source file does not exist: <i>{X}</i></tt></b>" shown when compiling.</td>
 - *    <td>The nominated input source file, specified in the user project's <tt>SRC</tt> 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.</td>
 - *   </tr>
 - *   <tr>
 - *    <td>Error "<b><tt>Doxygen configuration file <i>{X}</i> does not exist</tt></b>" shown when upgrading a Doxygen configuration file.</td>
 - *    <td>The nominated Doxygen configuration file, specified in the user project's <tt>DOXYGEN_CONF</tt> 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.</td>
 - *   </tr>
 - *   <tr>
 - *    <td>Error "<b><tt>avr-gcc: error: unrecognized option '<i>{X}</i>'</tt></b>" shown when compiling.</td>
 - *    <td>An unrecognised option was supplied to the compiler, usually in the <tt>C_FLAGS</tt>, <tt>CPP_FLAGS</tt>, <tt>ASM_FLAGS</tt> or <tt>CC_FLAGS</tt> 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.</td>
 - *   </tr>
 - *   <tr>
 - *    <td>Error "<b><tt>makefile:{X}: {Y}.mk: No such file or directory</tt></b>" shown when make is invoked.</td>
 - *    <td>The path to the nominated makefile module was incorrect. This usually indicates that the makefile <tt>LUFA_PATH</tt> option is not set to a valid relative or
 - *        absolute path to the LUFA library core.</td>
 - *   </tr>
 - *   <tr>
 - *    <td>Error "<b><tt>fatal error: LUFAConfig.h: No such file or directory</tt></b>" shown when compiling.</td>
 - *    <td>The <tt>USE_LUFA_CONFIG_HEADER</tt> compile time option was set in the user project makefile, but the user supplied <tt>LUFAConfig.h</tt> 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 <tt>CC_FLAGS</tt>
 - *        parameter.</td>
 - *   </tr>
 - *   <tr>
 - *    <td>Error "<b><tt>ld.exe: section .apitable_trampolines loaded at <i>{X}</i> overlaps section .text</tt></b>" shown when compiling a bootloader.</td>
 - *    <td>The bootloader is compiling too large for the given <tt>FLASH_SIZE_KB</tt> and <tt>BOOT_SECTION_SIZE_KB</tt> 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.</td>
 - *   </tr>
 - *   <tr>
 - *    <td>Error "<b><tt>unknown MCU '<i>{X}</i>' specified</tt></b>" shown when compiling.</td>
 - *    <td>The specified microcontroller device model name set in the user application's makefile as the <tt>MCU</tt> 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.</td>
 - *   </tr>
 - *   <tr>
 - *    <td>Error "<b><tt>undefined reference to `<i>{X}</i>'</tt></b>" shown when compiling.</td>
 - *    <td>This is usually caused by a missing source file in the user application's <tt>SRC</tt> 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).</td>
 - *   </tr>
 - *  </table>
 - *
 - *  For troubleshooting other errors you encounter, please see \ref Sec_ProjectHelp.
 - */
 +/** \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_BuildSystem_Overview 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. + * + *  For details on the prerequisites needed for Linux and Windows machines to be able to use the LUFA + *  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: + *  \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 <tt>make {TARGET_NAME}</tt> + *  from the command line, substituting in the appropriate target name. + * + *  \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 <i>must</i> + *  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_BuildSystem_Modules 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 + * + *  If you have problems building using the LUFA build system, see \subpage Page_BuildTroubleshooting for resolution steps. + */ + + /** \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 <b>PATH</b> 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 + * + *  <table> + *   <tr> + *    <td><tt>size</tt></td> + *    <td>Display size of the compiled application FLASH and SRAM segments.</td> + *   </tr> + *   <tr> + *    <td><tt>symbol-sizes</tt></td> + *    <td>Display a size-sorted list of symbols from the compiled application, in decimal bytes.</td> + *   </tr> + *   <tr> + *    <td><tt>lib</tt></td> + *    <td>Build and archive all source files into a library A binary file.</td> + *   </tr> + *   <tr> + *    <td><tt>all</tt></td> + *    <td>Build and link the application into ELF debug and HEX binary files.</td> + *   </tr> + *   <tr> + *    <td><tt>elf</tt></td> + *    <td>Build and link the application into an ELF debug file.</td> + *   </tr> + *   <tr> + *    <td><tt>bin</tt></td> + *    <td>Build and link the application and produce a BIN binary file.</td> + *   </tr> + *   <tr> + *    <td><tt>hex</tt></td> + *    <td>Build and link the application and produce HEX and EEP binary files.</td> + *   </tr> + *   <tr> + *    <td><tt>lss</tt></td> + *    <td>Build and link the application and produce a LSS source code/assembly code mixed listing file.</td> + *   </tr> + *   <tr> + *    <td><tt>clean</tt></td> + *    <td>Remove all intermediary files and binary output files.</td> + *   </tr> + *   <tr> + *    <td><tt>mostlyclean</tt></td> + *    <td>Remove all intermediary files but preserve any binary output files.</td> + *   </tr> + *   <tr> + *    <td><tt><i><filename></i>.s</tt></td> + *    <td>Create an assembly listing of a given input C/C++ source file.</td> + *   </tr> + *  </table> + * + *  \section SSec_BuildModule_BUILD_MandatoryParams Mandatory Parameters + * + *  <table> + *   <tr> + *    <td><tt>TARGET</tt></td> + *    <td>Name of the application output file prefix (e.g. <tt>TestApplication</tt>).</td> + *   </tr> + *   <tr> + *    <td><tt>ARCH</tt></td> + *    <td>Architecture of the target processor (see \ref Page_DeviceSupport).</td> + *   </tr> + *   <tr> + *    <td><tt>MCU</tt></td> + *    <td>Name of the Atmel processor model (e.g. <tt>at90usb1287</tt>).</td> + *   </tr> + *   <tr> + *    <td><tt>SRC</tt></td> + *    <td>List of relative or absolute paths to the application C (.c), C++ (.cpp) and Assembly (.S) source files.</td> + *   </tr> + *   <tr> + *    <td><tt>F_USB</tt></td> + *    <td>Speed in Hz of the input clock frequency to the target's USB controller.</td> + *   </tr> + *   <tr> + *    <td><tt>LUFA_PATH</tt></td> + *    <td>Path to the LUFA library core, either relative or absolute (e.g. <tt>../LUFA-000000/LUFA/</tt>).</td> + *   </tr> + *  </table> + * + *  \section SSec_BuildModule_BUILD_OptionalParams Optional Parameters + * + *  <table> + *   <tr> + *    <td><tt>BOARD</tt></td> + *    <td>LUFA board hardware drivers to use (see \ref Page_DeviceSupport).</td> + *   </tr> + *   <tr> + *    <td><tt>OPTIMIZATION</tt></td> + *    <td>Optimization level to use when compiling source files (see GCC manual).</td> + *   </tr> + *   <tr> + *    <td><tt>C_STANDARD</tt></td> + *    <td>Version of the C standard to apply when compiling C++ source files (see GCC manual).</td> + *   </tr> + *   <tr> + *    <td><tt>CPP_STANDARD</tt></td> + *    <td>Version of the C++ standard to apply when compiling C++ source files (see GCC manual).</td> + *   </tr> + *   <tr> + *    <td><tt>DEBUG_FORMAT</tt></td> + *    <td>Format of the debug information to embed in the generated object files (see GCC manual).</td> + *   </tr> + *   <tr> + *    <td><tt>DEBUG_LEVEL</tt></td> + *    <td>Level of the debugging information to embed in the generated object files (see GCC manual).</td> + *   </tr> + *   <tr> + *    <td><tt>F_CPU</tt></td> + *    <td>Speed of the processor CPU clock, in Hz.</td> + *   </tr> + *   <tr> + *    <td><tt>C_FLAGS</tt></td> + *    <td>Flags to pass to the C compiler only, after the automatically generated flags.</td> + *   </tr> + *   <tr> + *    <td><tt>CPP_FLAGS</tt></td> + *    <td>Flags to pass to the C++ compiler only, after the automatically generated flags.</td> + *   </tr> + *   <tr> + *    <td><tt>ASM_FLAGS</tt></td> + *    <td>Flags to pass to the assembler only, after the automatically generated flags.</td> + *   </tr> + *   <tr> + *    <td><tt>CC_FLAGS</tt></td> + *    <td>Common flags to pass to the C/C++ compiler and assembler, after the automatically generated flags.</td> + *   </tr> + *   <tr> + *    <td><tt>COMPILER_PATH</tt></td> + *    <td>Directory where the C/C++ toolchain is located, if not available in the system <tt>PATH</tt>.</td> + *   </tr> + *   <tr> + *    <td><tt>LD_FLAGS</tt></td> + *    <td>Flags to pass to the linker, after the automatically generated flags.</td> + *   </tr> + *   <tr> + *    <td><tt>LINKER_RELAXATIONS</tt></td> + *    <td>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 <tt>relocation truncated to fit: R_AVR_13_PCREL</tt>, disable this setting.</td> + *   </tr> + *   <tr> + *    <td><tt>OBJDIR</tt></td> + *    <td>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 <b>must</b> be unique.</td> + *   </tr> + *   <tr> + *    <td><tt>OBJECT_FILES</tt></td> + *    <td>List of additional object files that should be linked into the resulting binary.</td> + *   </tr> + *  </table> + * + *  \section SSec_BuildModule_BUILD_ProvidedVariables Module Provided Variables + * + *  <table> + *   <tr> + *    <td><i>None</i></td> + *   </tr> + *  </table> + * + *  \section SSec_BuildModule_BUILD_ProvidedMacros Module Provided Macros + * + *  <table> + *   <tr> + *    <td><i>None</i></td> + *   </tr> + *  </table> + */ + +/** \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 <tt>sh</tt> + *  shell, GNU <tt>make</tt> and *nix CoreUtils (<tt>echo</tt>, <tt>printf</tt>, etc.). + * + *  \section SSec_BuildModule_CORE_Targets Targets + * + *  <table> + *   <tr> + *    <td><tt>help</tt></td> + *    <td>Display build system help and configuration information.</td> + *   </tr> + *   <tr> + *    <td><tt>list_targets</tt></td> + *    <td>List all available build targets from the build system.</td> + *   </tr> + *   <tr> + *    <td><tt>list_modules</tt></td> + *    <td>List all available build modules from the build system.</td> + *   </tr> + *   <tr> + *    <td><tt>list_mandatory</tt></td> + *    <td>List all mandatory parameters required by the included modules.</td> + *   </tr> + *   <tr> + *    <td><tt>list_optional</tt></td> + *    <td>List all optional parameters required by the included modules.</td> + *   </tr> + *   <tr> + *    <td><tt>list_provided</tt></td> + *    <td>List all variables provided by the included modules.</td> + *   </tr> + *   <tr> + *    <td><tt>list_macros</tt></td> + *    <td>List all macros provided by the included modules.</td> + *   </tr> + *  </table> + * + *  \section SSec_BuildModule_CORE_MandatoryParams Mandatory Parameters + * + *  <table> + *   <tr> + *    <td><i>None</i></td> + *   </tr> + *  </table> + * + *  \section SSec_BuildModule_CORE_OptionalParams Optional Parameters + * + *  <table> + *   <tr> + *    <td><i>None</i></td> + *   </tr> + *  </table> + * + *  \section SSec_BuildModule_CORE_ProvidedVariables Module Provided Variables + * + *  <table> + *   <tr> + *    <td><i>None</i></td> + *   </tr> + *  </table> + * + *  \section SSec_BuildModule_CORE_ProvidedMacros Module Provided Macros + * + *  <table> + *   <tr> + *    <td><i>None</i></td> + *   </tr> + *  </table> + */ + +/** \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 <tt>atprogram.exe</tt> utility to be available in your system's <b>PATH</b> + *  variable. The <tt>atprogram.exe</tt> utility is distributed in Atmel AVR Studio 5.x and Atmel Studio 6.x + *  inside the application install folder's "\atbackend" subdirectory. + * + *  \section SSec_BuildModule_ATPROGRAM_Targets Targets + * + *  <table> + *   <tr> + *    <td><tt>atprogram</tt></td> + *    <td>Program the device FLASH memory with the application's executable data.</td> + *   </tr> + *   <tr> + *    <td><tt>atprogram-ee</tt></td> + *    <td>Program the device EEPROM memory with the application's EEPROM data.</td> + *   </tr> + *  </table> + * + *  \section SSec_BuildModule_ATPROGRAM_MandatoryParams Mandatory Parameters + * + *  <table> + *   <tr> + *    <td><tt>MCU</tt></td> + *    <td>Name of the Atmel processor model (e.g. <tt>at90usb1287</tt>).</td> + *   </tr> + *   <tr> + *    <td><tt>TARGET</tt></td> + *    <td>Name of the application output file prefix (e.g. <tt>TestApplication</tt>).</td> + *   </tr> + *  </table> + * + *  \section SSec_BuildModule_ATPROGRAM_OptionalParams Optional Parameters + * + *  <table> + *   <tr> + *    <td><tt>ATPROGRAM_PROGRAMMER</tt></td> + *    <td>Name of the Atmel programmer or debugger tool to communicate with (e.g. <tt>jtagice3</tt>).</td> + *   </tr> + *   <tr> + *    <td><tt>ATPROGRAM_INTERFACE</tt></td> + *    <td>Name of the programming interface to use when programming the target (e.g. <tt>spi</tt>).</td> + *   </tr> + *   <tr> + *    <td><tt>ATPROGRAM_PORT</tt></td> + *    <td>Name of the communication port to use when when programming with a serially connected tool (e.g. <tt>COM2</tt>).</td> + *   </tr> + *  </table> + * + *  \section SSec_BuildModule_ATPROGRAM_ProvidedVariables Module Provided Variables + * + *  <table> + *   <tr> + *    <td><i>None</i></td> + *   </tr> + *  </table> + * + *  \section SSec_BuildModule_ATPROGRAM_ProvidedMacros Module Provided Macros + * + *  <table> + *   <tr> + *    <td><i>None</i></td> + *   </tr> + *  </table> + */ + +/** \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 <tt>avrdude</tt> utility to be available in your system's <b>PATH</b> + *  variable. The <tt>avrdude</tt> utility is distributed in the old WinAVR project releases for + *  Windows (<a>http://winavr.sourceforge.net</a>) or can be installed on *nix systems via the project's + *  source code (<a>https://savannah.nongnu.org/projects/avrdude</a>) or through the package manager. + * + *  \section SSec_BuildModule_AVRDUDE_Targets Targets + * + *  <table> + *   <tr> + *    <td><tt>avrdude</tt></td> + *    <td>Program the device FLASH memory with the application's executable data.</td> + *   </tr> + *   <tr> + *    <td><tt>avrdude-ee</tt></td> + *    <td>Program the device EEPROM memory with the application's EEPROM data.</td> + *   </tr> + *  </table> + * + *  \section SSec_BuildModule_AVRDUDE_MandatoryParams Mandatory Parameters + * + *  <table> + *   <tr> + *    <td><tt>MCU</tt></td> + *    <td>Name of the Atmel processor model (e.g. <tt>at90usb1287</tt>).</td> + *   </tr> + *   <tr> + *    <td><tt>TARGET</tt></td> + *    <td>Name of the application output file prefix (e.g. <tt>TestApplication</tt>).</td> + *   </tr> + *  </table> + * + *  \section SSec_BuildModule_AVRDUDE_OptionalParams Optional Parameters + * + *  <table> + *   <tr> + *    <td><tt>AVRDUDE_PROGRAMMER</tt></td> + *    <td>Name of the programmer or debugger tool to communicate with (e.g. <tt>jtagicemkii</tt>).</td> + *   </tr> + *   <tr> + *    <td><tt>AVRDUDE_PORT</tt></td> + *    <td>Name of the communication port to use when when programming with the connected tool (e.g. <tt>COM2</tt>, <tt>/dev/ttyUSB0</tt> or <tt>usb</tt>).</td> + *   </tr> + *   <tr> + *    <td><tt>AVRDUDE_FLAGS</tt></td> + *    <td>Additional flags to pass to avrdude when programming, applied after the automatically generated flags.</td> + *   </tr> + *  </table> + * + *  \section SSec_BuildModule_AVRDUDE_ProvidedVariables Module Provided Variables + * + *  <table> + *   <tr> + *    <td><i>None</i></td> + *   </tr> + *  </table> + * + *  \section SSec_BuildModule_AVRDUDE_ProvidedMacros Module Provided Macros + * + *  <table> + *   <tr> + *    <td><i>None</i></td> + *   </tr> + *  </table> + */ + + /** \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 <tt>cppcheck</tt> utility to be available in your system's <b>PATH</b> + *  variable. The <tt>cppcheck</tt> utility is distributed through the project's home page + *  (<a>http://cppcheck.sourceforge.net</a>) 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 + * + *  <table> + *   <tr> + *    <td><tt>cppcheck</tt></td> + *    <td>Statically analyze the project source code for issues.</td> + *   </tr> + *   <tr> + *    <td><tt>cppcheck-config</tt></td> + *    <td>Check the <tt>cppcheck</tt> configuration - scan source code and warn about missing header files and other issues.</td> + *   </tr> + *  </table> + * + *  \section SSec_BuildModule_CPPCHECK_MandatoryParams Mandatory Parameters + * + *  <table> + *   <tr> + *    <td><tt>SRC</tt></td> + *    <td>List of source files to statically analyze.</td> + *   </tr> + *  </table> + * + *  \section SSec_BuildModule_CPPCHECK_OptionalParams Optional Parameters + * + *  <table> + *   <tr> + *    <td><tt>CPPCHECK_INCLUDES</tt></td> + *    <td>Path of extra directories to check when attemting to resolve C/C++ header file includes.</td> + *   </tr> + *   <tr> + *    <td><tt>CPPCHECK_EXCLUDES</tt></td> + *    <td>Paths or path fragments to exclude when analyzing.</td> + *   </tr> + *   <tr> + *    <td><tt>CPPCHECK_MSG_TEMPLATE</tt></td> + *    <td>Output message template to use when printing errors, warnings and information (see <tt>cppcheck</tt> documentation).</td> + *   </tr> + *   <tr> + *    <td><tt>CPPCHECK_ENABLE</tt></td> + *    <td>Analysis rule categories to enable (see <tt>cppcheck</tt> documentation).</td> + *   </tr> + *   <tr> + *    <td><tt>CPPCHECK_SUPPRESS</tt></td> + *    <td>Specific analysis rules to suppress (see <tt>cppcheck</tt> documentation).</td> + *   </tr> + *   <tr> + *    <td><tt>CPPCHECK_FAIL_ON_WARNING</tt></td> + *    <td>Set to <b>Y</b> to fail the analysis job with an error exit code if warnings are found, <b>N</b> to continue without failing.</td> + *   </tr> + *   <tr> + *    <td><tt>CPPCHECK_QUIET</tt></td> + *    <td>Set to <b>Y</b> to suppress all output except warnings and errors, <b>N</b> to show verbose output information.</td> + *   </tr> + *   <tr> + *    <td><tt>CPPCHECK_FLAGS</tt></td> + *    <td>Extra flags to pass to <tt>cppcheck</tt>, after the automatically generated flags.</td> + *   </tr> + *  </table> + * + *  \section SSec_BuildModule_CPPCHECK_ProvidedVariables Module Provided Variables + * + *  <table> + *   <tr> + *    <td><i>None</i></td> + *   </tr> + *  </table> + * + *  \section SSec_BuildModule_CPPCHECK_ProvidedMacros Module Provided Macros + * + *  <table> + *   <tr> + *    <td><i>None</i></td> + *   </tr> + *  </table> + */ + + /** \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 <tt>batchisp</tt> utility from Atmel's FLIP utility, or the open + *  source <tt>dfu-programmer</tt> utility (<a>http://dfu-programmer.sourceforge.net/</a>) to be + *  available in your system's <b>PATH</b> variable. On *nix systems the <tt>dfu-programmer</tt> utility + *  can be installed via the project's source code or through the package manager. + * + *  \section SSec_BuildModule_DFU_Targets Targets + * + *  <table> + *   <tr> + *    <td><tt>dfu</tt></td> + *    <td>Program the device FLASH memory with the application's executable data using <tt>dfu-programmer</tt>.</td> + *   </tr> + *   <tr> + *    <td><tt>dfu-ee</tt></td> + *    <td>Program the device EEPROM memory with the application's EEPROM data using <tt>dfu-programmer</tt>.</td> + *   </tr> + *   <tr> + *    <td><tt>flip</tt></td> + *    <td>Program the device FLASH memory with the application's executable data using <tt>batchisp</tt>.</td> + *   </tr> + *   <tr> + *    <td><tt>flip-ee</tt></td> + *    <td>Program the device EEPROM memory with the application's EEPROM data using <tt>batchisp</tt>.</td> + *   </tr> + *  </table> + * + *  \section SSec_BuildModule_DFU_MandatoryParams Mandatory Parameters + * + *  <table> + *   <tr> + *    <td><tt>MCU</tt></td> + *    <td>Name of the Atmel processor model (e.g. <tt>at90usb1287</tt>).</td> + *   </tr> + *   <tr> + *    <td><tt>TARGET</tt></td> + *    <td>Name of the application output file prefix (e.g. <tt>TestApplication</tt>).</td> + *   </tr> + *  </table> + * + *  \section SSec_BuildModule_DFU_OptionalParams Optional Parameters + * + *  <table> + *   <tr> + *    <td><i>None</i></td> + *   </tr> + *  </table> + * + *  \section SSec_BuildModule_DFU_ProvidedVariables Module Provided Variables + * + *  <table> + *   <tr> + *    <td><i>None</i></td> + *   </tr> + *  </table> + * + *  \section SSec_BuildModule_DFU_ProvidedMacros Module Provided Macros + * + *  <table> + *   <tr> + *    <td><i>None</i></td> + *   </tr> + *  </table> + */ + + /** \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 <tt>doxygen</tt> utility from the Doxygen website + *  (<a>http://www.doxygen.org/</a>) to be available in your system's <b>PATH</b> variable. On *nix + *  systems the <tt>doxygen</tt> utility can be installed via the project's source code or through + *  the package manager. + * + *  \section SSec_BuildModule_DOXYGEN_Targets Targets + * + *  <table> + *   <tr> + *    <td><tt>doxygen</tt></td> + *    <td>Generate project documentation.</td> + *   </tr> + *   <tr> + *    <td><tt>doxygen_create</tt></td> + *    <td>Create a new Doxygen configuration file using the latest template.</td> + *   </tr> + *   <tr> + *    <td><tt>doxygen_upgrade</tt></td> + *    <td>Upgrade an existing Doxygen configuration file to the latest template</td> + *   </tr> + *  </table> + * + *  \section SSec_BuildModule_DOXYGEN_MandatoryParams Mandatory Parameters + * + *  <table> + *   <tr> + *    <td><tt>LUFA_PATH</tt></td> + *    <td>Path to the LUFA library core, either relative or absolute (e.g. <tt>../LUFA-000000/LUFA/</tt>).</td> + *   </tr> + *  </table> + * + *  \section SSec_BuildModule_DOXYGEN_OptionalParams Optional Parameters + * + *  <table> + *   <tr> + *    <td><tt>DOXYGEN_CONF</tt></td> + *    <td>Name and path of the base Doxygen configuration file for the project.</td> + *   </tr> + *   <tr> + *    <td><tt>DOXYGEN_FAIL_ON_WARNING</tt></td> + *    <td>Set to <b>Y</b> to fail the generation with an error exit code if warnings are found other than unsupported configuration parameters, <b>N</b> to continue without failing.</td> + *   </tr> + *   <tr> + *    <td><tt>DOXYGEN_OVERRIDE_PARAMS</tt></td> + *    <td>Extra Doxygen configuration parameters to apply, overriding the corresponding config entry in the project's configuration file (e.g. <tt>QUIET=YES</tt>).</td> + *   </tr> + *  </table> + * + *  \section SSec_BuildModule_DOXYGEN_ProvidedVariables Module Provided Variables + * + *  <table> + *   <tr> + *    <td><i>None</i></td> + *   </tr> + *  </table> + * + *  \section SSec_BuildModule_DOXYGEN_ProvidedMacros Module Provided Macros + * + *  <table> + *   <tr> + *    <td><i>None</i></td> + *   </tr> + *  </table> + */ + + /** \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 (<a>http://www.pjrc.com/teensy/halfkay_protocol.html</a>). + * + *  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 <tt>hid_bootloader_cli</tt> utility from the included LUFA HID + *  class bootloader API subdirectory, or the <tt>teensy_loader_cli</tt> utility from PJRC + *  (<a>http://www.pjrc.com/teensy/loader_cli.html</a>) to be available in your system's <b>PATH</b> + *  variable. + * + *  \section SSec_BuildModule_HID_Targets Targets + * + *  <table> + *   <tr> + *    <td><tt>hid</tt></td> + *    <td>Program the device FLASH memory with the application's executable data using <tt>hid_bootloader_cli</tt>.</td> + *   </tr> + *   <tr> + *    <td><tt>hid-ee</tt></td> + *    <td>Program the device EEPROM memory with the application's EEPROM data using <tt>hid_bootloader_cli</tt> and + *        a temporary AVR application programmed into the target's FLASH. + *        \note This will erase the currently loaded application in the target.</td> + *   </tr> + *   <tr> + *    <td><tt>teensy</tt></td> + *    <td>Program the device FLASH memory with the application's executable data using <tt>teensy_loader_cli</tt>.</td> + *   </tr> + *   <tr> + *    <td><tt>teensy-ee</tt></td> + *    <td>Program the device EEPROM memory with the application's EEPROM data using <tt>teensy_loader_cli</tt> and + *        a temporary AVR application programmed into the target's FLASH. + *        \note This will erase the currently loaded application in the target.</td> + *   </tr> + *  </table> + * + *  \section SSec_BuildModule_HID_MandatoryParams Mandatory Parameters + * + *  <table> + *   <tr> + *    <td><tt>MCU</tt></td> + *    <td>Name of the Atmel processor model (e.g. <tt>at90usb1287</tt>).</td> + *   </tr> + *   <tr> + *    <td><tt>TARGET</tt></td> + *    <td>Name of the application output file prefix (e.g. <tt>TestApplication</tt>).</td> + *   </tr> + *  </table> + * + *  \section SSec_BuildModule_HID_OptionalParams Optional Parameters + * + *  <table> + *   <tr> + *    <td><i>None</i></td> + *   </tr> + *  </table> + * + *  \section SSec_BuildModule_HID_ProvidedVariables Module Provided Variables + * + *  <table> + *   <tr> + *    <td><i>None</i></td> + *   </tr> + *  </table> + * + *  \section SSec_BuildModule_HID_ProvidedMacros Module Provided Macros + * + *  <table> + *   <tr> + *    <td><i>None</i></td> + *   </tr> + *  </table> + */ + + /** \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 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: + *  \code + *  include $(LUFA_PATH)/Build/lufa_sources.mk + *  \endcode + * + *  \section SSec_BuildModule_SOURCES_Requirements Requirements + *  None. + * + *  \section SSec_BuildModule_SOURCES_Targets Targets + * + *  <table> + *   <tr> + *    <td><i>None</i></td> + *   </tr> + *  </table> + * + *  \section SSec_BuildModule_SOURCES_MandatoryParams Mandatory Parameters + * + *  <table> + *   <tr> + *    <td><tt>LUFA_PATH</tt></td> + *    <td>Path to the LUFA library core, either relative or absolute (e.g. <tt>../LUFA-000000/LUFA/</tt>).</td> + *   </tr> + *   <tr> + *    <td><tt>ARCH</tt></td> + *    <td>Architecture of the target processor (see \ref Page_DeviceSupport).</td> + *   </tr> + *  </table> + * + *  \section SSec_BuildModule_SOURCES_OptionalParams Optional Parameters + * + *  <table> + *   <tr> + *    <td><i>None</i></td> + *   </tr> + *  </table> + * + *  \section SSec_BuildModule_SOURCES_ProvidedVariables Module Provided Variables + * + *  <table> + *   <tr> + *    <td><tt>LUFA_SRC_USB</tt></td> + *    <td>List of LUFA USB driver source files.</td> + *   </tr> + *   <tr> + *    <td><tt>LUFA_SRC_USBCLASS</tt></td> + *    <td>List of LUFA USB Class driver source files.</td> + *   </tr> + *   <tr> + *    <td><tt>LUFA_SRC_TEMPERATURE</tt></td> + *    <td>List of LUFA temperature sensor driver source files.</td> + *   </tr> + *   <tr> + *    <td><tt>LUFA_SRC_SERIAL</tt></td> + *    <td>List of LUFA Serial U(S)ART driver source files.</td> + *   </tr> + *   <tr> + *    <td><tt>LUFA_SRC_TWI</tt></td> + *    <td>List of LUFA TWI driver source files.</td> + *   </tr> + *   <tr> + *    <td><tt>LUFA_SRC_PLATFORM</tt></td> + *    <td>List of LUFA architecture specific platform management source files.</td> + *   </tr> + *  </table> + * + *  \section SSec_BuildModule_SOURCES_ProvidedMacros Module Provided Macros + * + *  <table> + *   <tr> + *    <td><i>None</i></td> + *   </tr> + *  </table> + */ + +/** \page Page_BuildTroubleshooting Troubleshooting Information + * + *  LUFA uses a lot of advanced features of the AVR-GCC compiler, linker, and surrounding binaries. This can sometimes lead to problems compiling applications if one of these + *  features is buggy in the version of the tools used in a build environment. Missing utilities and incorrectly set makefile configuration options can also result in different + *  errors being produced when compilation or other operations are attempted. The table below lists a set of commonly encountered errors and their resolutions. + * + *  <table> + *    <tr> + *    <th>Problem</th> + *    <th>Resolution</th> + *   </tr> + *   <tr> + *    <td>Error "<b><tt>relocation truncated to fit: R_AVR_13_PCREL against symbol <i>{X}</i></tt></b>" shown when compiling.</td> + *    <td>Try compiling with the setting <tt>LINKER_RELAXATIONS=N</tt> in your LUFA Build System 2.0 makefile, or remove the line <tt>-Wl,--relax</tt> + *        from other makefiles. Alternatively, make sure you have the latest version of the Atmel Toolchain installed for your system.</td> + *   </tr> + *   <tr> + *    <td>Error "<b><tt>error: ld terminated with signal 11 [Segmentation fault]</tt></b>" shown when compiling.</td> + *    <td>Try compiling with the setting <tt>DEBUG_LEVEL=2</tt> in your LUFA Build System 2.0 makefile, or make sure you are using <tt>binutils</tt> version 2.22 or later.</td> + *   </tr> + *   <tr> + *    <td>Error "<b><tt>EMERGENCY ABORT: INFINITE RECURSION DETECTED</tt></b>" shown when compiling.</td> + *    <td>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.</td> + *   </tr> + *   <tr> + *    <td>Error "<b><tt>Unsupported architecture "<i>{X}</i>"</tt></b>" shown when compiling.</td> + *    <td>Ensure your makefile's <tt>ARCH</tt> setting is set to one of the architecture names (case-sensitive) supported by the version of LUFA you are compiling against.</td> + *   </tr> + *   <tr> + *    <td>Error "<b><tt>Makefile <i>{X}</i> value not set</tt></b>" shown when compiling.</td> + *    <td>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.</td> + *   </tr> + *   <tr> + *    <td>Error "<b><tt>Makefile <i>{X}</i> option cannot be blank</tt></b>" shown when compiling.</td> + *    <td>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.</td> + *   </tr> + *   <tr> + *    <td>Error "<b><tt>Makefile <i>{X}</i> option must be Y or N</tt></b>" shown when compiling.</td> + *    <td>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.</td> + *   </tr> + *   <tr> + *    <td>Error "<b><tt>Unknown input source file formats: <i>{X}</i></tt></b>" shown when compiling.</td> + *    <td>The nominated source files, specified in your project's makefile in the <tt>SRC</tt> 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 (<tt>*.c</tt>, <tt>*.cpp</tt> or <tt>*.S</tt>).</td> + *   </tr> + *   <tr> + *    <td>Error "<b><tt>Cannot build with OBJDIR parameter set - one or more object file name is not unique</tt></b>" shown when compiling.</td> + *    <td>When a project is built with a non-empty <tt>OBJDIR</tt> 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.</td> + *   </tr> + *   <tr> + *    <td>Error "<b><tt>Source file does not exist: <i>{X}</i></tt></b>" shown when compiling.</td> + *    <td>The nominated input source file, specified in the user project's <tt>SRC</tt> 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.</td> + *   </tr> + *   <tr> + *    <td>Error "<b><tt>Doxygen configuration file <i>{X}</i> does not exist</tt></b>" shown when upgrading a Doxygen configuration file.</td> + *    <td>The nominated Doxygen configuration file, specified in the user project's <tt>DOXYGEN_CONF</tt> 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.</td> + *   </tr> + *   <tr> + *    <td>Error "<b><tt>avr-gcc: error: unrecognized option '<i>{X}</i>'</tt></b>" shown when compiling.</td> + *    <td>An unrecognised option was supplied to the compiler, usually in the <tt>C_FLAGS</tt>, <tt>CPP_FLAGS</tt>, <tt>ASM_FLAGS</tt> or <tt>CC_FLAGS</tt> 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.</td> + *   </tr> + *   <tr> + *    <td>Error "<b><tt>makefile:{X}: {Y}.mk: No such file or directory</tt></b>" shown when make is invoked.</td> + *    <td>The path to the nominated makefile module was incorrect. This usually indicates that the makefile <tt>LUFA_PATH</tt> option is not set to a valid relative or + *        absolute path to the LUFA library core.</td> + *   </tr> + *   <tr> + *    <td>Error "<b><tt>fatal error: LUFAConfig.h: No such file or directory</tt></b>" shown when compiling.</td> + *    <td>The <tt>USE_LUFA_CONFIG_HEADER</tt> compile time option was set in the user project makefile, but the user supplied <tt>LUFAConfig.h</tt> 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 <tt>CC_FLAGS</tt> + *        parameter.</td> + *   </tr> + *   <tr> + *    <td>Error "<b><tt>ld.exe: section .apitable_trampolines loaded at <i>{X}</i> overlaps section .text</tt></b>" shown when compiling a bootloader.</td> + *    <td>The bootloader is compiling too large for the given <tt>FLASH_SIZE_KB</tt> and <tt>BOOT_SECTION_SIZE_KB</tt> 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.</td> + *   </tr> + *   <tr> + *    <td>Error "<b><tt>unknown MCU '<i>{X}</i>' specified</tt></b>" shown when compiling.</td> + *    <td>The specified microcontroller device model name set in the user application's makefile as the <tt>MCU</tt> 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.</td> + *   </tr> + *   <tr> + *    <td>Error "<b><tt>undefined reference to `<i>{X}</i>'</tt></b>" shown when compiling.</td> + *    <td>This is usually caused by a missing source file in the user application's <tt>SRC</tt> 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).</td> + *   </tr> + *  </table> + * + *  For troubleshooting other errors you encounter, please see \ref Sec_ProjectHelp. + */ | 
