diff options
| author | Jack Humbert <jack.humb@gmail.com> | 2016-08-27 14:54:55 -0400 | 
|---|---|---|
| committer | GitHub <noreply@github.com> | 2016-08-27 14:54:55 -0400 | 
| commit | f815b4871ebc5cc2f8d1a306eceec68c0a973a4c (patch) | |
| tree | 84c78137841ad83036de7e36579bc7973b024f7a /tmk_core/protocol | |
| parent | 36b6a96596e6cbca879d5304a586e279c15b04a9 (diff) | |
| parent | cff26bc48413ec62d4f4a37e3a6ba34721e7670c (diff) | |
| download | firmware-f815b4871ebc5cc2f8d1a306eceec68c0a973a4c.tar.gz firmware-f815b4871ebc5cc2f8d1a306eceec68c0a973a4c.tar.bz2 firmware-f815b4871ebc5cc2f8d1a306eceec68c0a973a4c.zip | |
Merge pull request #691 from fredizzimo/fix_line_endings
Fix line endings
Diffstat (limited to 'tmk_core/protocol')
16 files changed, 2507 insertions, 2507 deletions
| diff --git a/tmk_core/protocol/iwrap/suart.S b/tmk_core/protocol/iwrap/suart.S index 1b0290963..a873515e1 100644 --- a/tmk_core/protocol/iwrap/suart.S +++ b/tmk_core/protocol/iwrap/suart.S @@ -1,156 +1,156 @@ -;---------------------------------------------------------------------------;
 -; Software implemented UART module                                          ;
 -; (C)ChaN, 2005 (http://elm-chan.org/)                                      ;
 -;---------------------------------------------------------------------------;
 -; Bit rate settings:
 -;
 -;            1MHz  2MHz  4MHz  6MHz  8MHz  10MHz  12MHz  16MHz  20MHz
 -;   2.4kbps   138     -     -     -     -      -      -      -      -
 -;   4.8kbps    68   138     -     -     -      -      -      -      -
 -;   9.6kbps    33    68   138   208     -      -      -      -      -
 -;  19.2kbps     -    33    68   102   138    173    208      -      -
 -;  38.4kbps     -     -    33    50    68     85    102    138    172
 -;  57.6kbps     -     -    21    33    44     56     68     91    114
 -; 115.2kbps     -     -     -     -    21     27     33     44     56
 -
 -.nolist
 -#include <avr/io.h>
 -.list
 -
 -#define	BPS	102 	/* Bit delay. (see above table) */
 -#define	BIDIR	0	/* 0:Separated Tx/Rx, 1:Shared Tx/Rx */
 -
 -#define	OUT_1		sbi _SFR_IO_ADDR(SUART_OUT_PORT), SUART_OUT_BIT	/* Output 1 */
 -#define	OUT_0		cbi _SFR_IO_ADDR(SUART_OUT_PORT), SUART_OUT_BIT	/* Output 0 */
 -#define	SKIP_IN_1	sbis _SFR_IO_ADDR(SUART_IN_PIN), SUART_IN_BIT	/* Skip if 1 */
 -#define	SKIP_IN_0	sbic _SFR_IO_ADDR(SUART_IN_PIN), SUART_IN_BIT	/* Skip if 0 */
 -
 -
 -
 -#ifdef SPM_PAGESIZE
 -.macro	_LPMI	reg
 -	lpm	\reg, Z+
 -.endm
 -.macro	_MOVW	dh,dl, sh,sl
 -	movw	\dl, \sl
 -.endm
 -#else
 -.macro	_LPMI	reg
 -	lpm
 -	mov	\reg, r0
 -	adiw	ZL, 1
 -.endm
 -.macro	_MOVW	dh,dl, sh,sl
 -	mov	\dl, \sl
 -	mov	\dh, \sh
 -.endm
 -#endif
 -
 -
 -
 -;---------------------------------------------------------------------------;
 -; Transmit a byte in serial format of N81
 -;
 -;Prototype: void xmit (uint8_t data);
 -;Size: 16 words
 -
 -.global xmit
 -.func xmit
 -xmit:
 -#if BIDIR
 -	ldi	r23, BPS-1	;Pre-idle time for bidirectional data line
 -5:	dec	r23     	;
 -	brne	5b		;/
 -#endif
 -	in	r0, _SFR_IO_ADDR(SREG)	;Save flags
 -
 -	com	r24		;C = start bit
 -	ldi	r25, 10		;Bit counter
 -	cli			;Start critical section
 -
 -1:	ldi	r23, BPS-1	;----- Bit transferring loop 
 -2:	dec	r23     	;Wait for a bit time
 -	brne	2b		;/
 -	brcs	3f		;MISO = bit to be sent
 -	OUT_1			;
 -3:	brcc	4f		;
 -	OUT_0			;/
 -4:	lsr	r24     	;Get next bit into C
 -	dec	r25     	;All bits sent?
 -	brne	1b	     	;  no, coutinue
 -
 -	out	_SFR_IO_ADDR(SREG), r0	;End of critical section
 -	ret
 -.endfunc
 -
 -
 -
 -;---------------------------------------------------------------------------;
 -; Receive a byte
 -;
 -;Prototype: uint8_t rcvr (void);
 -;Size: 19 words
 -
 -.global rcvr
 -.func rcvr
 -rcvr:
 -	in	r0, _SFR_IO_ADDR(SREG)	;Save flags
 -
 -	ldi	r24, 0x80	;Receiving shift reg
 -	cli			;Start critical section
 -
 -1:	SKIP_IN_1		;Wait for idle
 -	rjmp	1b
 -2:	SKIP_IN_0		;Wait for start bit
 -	rjmp	2b
 -	ldi	r25, BPS/2	;Wait for half bit time
 -3:	dec	r25
 -	brne	3b
 -
 -4:	ldi	r25, BPS	;----- Bit receiving loop
 -5:	dec	r25     	;Wait for a bit time
 -	brne	5b		;/
 -	lsr	r24     	;Next bit
 -	SKIP_IN_0		;Get a data bit into r24.7
 -	ori	r24, 0x80
 -	brcc	4b	     	;All bits received?  no, continue
 -
 -	out	_SFR_IO_ADDR(SREG), r0	;End of critical section
 -	ret
 -.endfunc
 -
 -
 -; Not wait for start bit. This should be called after detecting start bit.
 -.global recv
 -.func recv
 -recv:
 -	in	r0, _SFR_IO_ADDR(SREG)	;Save flags
 -
 -	ldi	r24, 0x80	;Receiving shift reg
 -	cli			;Start critical section
 -
 -;1:	SKIP_IN_1		;Wait for idle
 -;	rjmp	1b
 -;2:	SKIP_IN_0		;Wait for start bit
 -;	rjmp	2b
 -	ldi	r25, BPS/2	;Wait for half bit time
 -3:	dec	r25
 -	brne	3b
 -
 -4:	ldi	r25, BPS	;----- Bit receiving loop
 -5:	dec	r25     	;Wait for a bit time
 -	brne	5b		;/
 -	lsr	r24     	;Next bit
 -	SKIP_IN_0		;Get a data bit into r24.7
 -	ori	r24, 0x80
 -	brcc	4b	     	;All bits received?  no, continue
 -
 -	ldi	r25, BPS/2	;Wait for half bit time
 -6:	dec	r25
 -	brne	6b
 -7:	SKIP_IN_1		;Wait for stop bit
 -	rjmp	7b
 -
 -	out	_SFR_IO_ADDR(SREG), r0	;End of critical section
 -	ret
 -.endfunc
 +;---------------------------------------------------------------------------; +; Software implemented UART module                                          ; +; (C)ChaN, 2005 (http://elm-chan.org/)                                      ; +;---------------------------------------------------------------------------; +; Bit rate settings: +; +;            1MHz  2MHz  4MHz  6MHz  8MHz  10MHz  12MHz  16MHz  20MHz +;   2.4kbps   138     -     -     -     -      -      -      -      - +;   4.8kbps    68   138     -     -     -      -      -      -      - +;   9.6kbps    33    68   138   208     -      -      -      -      - +;  19.2kbps     -    33    68   102   138    173    208      -      - +;  38.4kbps     -     -    33    50    68     85    102    138    172 +;  57.6kbps     -     -    21    33    44     56     68     91    114 +; 115.2kbps     -     -     -     -    21     27     33     44     56 + +.nolist +#include <avr/io.h> +.list + +#define	BPS	102 	/* Bit delay. (see above table) */ +#define	BIDIR	0	/* 0:Separated Tx/Rx, 1:Shared Tx/Rx */ + +#define	OUT_1		sbi _SFR_IO_ADDR(SUART_OUT_PORT), SUART_OUT_BIT	/* Output 1 */ +#define	OUT_0		cbi _SFR_IO_ADDR(SUART_OUT_PORT), SUART_OUT_BIT	/* Output 0 */ +#define	SKIP_IN_1	sbis _SFR_IO_ADDR(SUART_IN_PIN), SUART_IN_BIT	/* Skip if 1 */ +#define	SKIP_IN_0	sbic _SFR_IO_ADDR(SUART_IN_PIN), SUART_IN_BIT	/* Skip if 0 */ + + + +#ifdef SPM_PAGESIZE +.macro	_LPMI	reg +	lpm	\reg, Z+ +.endm +.macro	_MOVW	dh,dl, sh,sl +	movw	\dl, \sl +.endm +#else +.macro	_LPMI	reg +	lpm +	mov	\reg, r0 +	adiw	ZL, 1 +.endm +.macro	_MOVW	dh,dl, sh,sl +	mov	\dl, \sl +	mov	\dh, \sh +.endm +#endif + + + +;---------------------------------------------------------------------------; +; Transmit a byte in serial format of N81 +; +;Prototype: void xmit (uint8_t data); +;Size: 16 words + +.global xmit +.func xmit +xmit: +#if BIDIR +	ldi	r23, BPS-1	;Pre-idle time for bidirectional data line +5:	dec	r23     	; +	brne	5b		;/ +#endif +	in	r0, _SFR_IO_ADDR(SREG)	;Save flags + +	com	r24		;C = start bit +	ldi	r25, 10		;Bit counter +	cli			;Start critical section + +1:	ldi	r23, BPS-1	;----- Bit transferring loop  +2:	dec	r23     	;Wait for a bit time +	brne	2b		;/ +	brcs	3f		;MISO = bit to be sent +	OUT_1			; +3:	brcc	4f		; +	OUT_0			;/ +4:	lsr	r24     	;Get next bit into C +	dec	r25     	;All bits sent? +	brne	1b	     	;  no, coutinue + +	out	_SFR_IO_ADDR(SREG), r0	;End of critical section +	ret +.endfunc + + + +;---------------------------------------------------------------------------; +; Receive a byte +; +;Prototype: uint8_t rcvr (void); +;Size: 19 words + +.global rcvr +.func rcvr +rcvr: +	in	r0, _SFR_IO_ADDR(SREG)	;Save flags + +	ldi	r24, 0x80	;Receiving shift reg +	cli			;Start critical section + +1:	SKIP_IN_1		;Wait for idle +	rjmp	1b +2:	SKIP_IN_0		;Wait for start bit +	rjmp	2b +	ldi	r25, BPS/2	;Wait for half bit time +3:	dec	r25 +	brne	3b + +4:	ldi	r25, BPS	;----- Bit receiving loop +5:	dec	r25     	;Wait for a bit time +	brne	5b		;/ +	lsr	r24     	;Next bit +	SKIP_IN_0		;Get a data bit into r24.7 +	ori	r24, 0x80 +	brcc	4b	     	;All bits received?  no, continue + +	out	_SFR_IO_ADDR(SREG), r0	;End of critical section +	ret +.endfunc + + +; Not wait for start bit. This should be called after detecting start bit. +.global recv +.func recv +recv: +	in	r0, _SFR_IO_ADDR(SREG)	;Save flags + +	ldi	r24, 0x80	;Receiving shift reg +	cli			;Start critical section + +;1:	SKIP_IN_1		;Wait for idle +;	rjmp	1b +;2:	SKIP_IN_0		;Wait for start bit +;	rjmp	2b +	ldi	r25, BPS/2	;Wait for half bit time +3:	dec	r25 +	brne	3b + +4:	ldi	r25, BPS	;----- Bit receiving loop +5:	dec	r25     	;Wait for a bit time +	brne	5b		;/ +	lsr	r24     	;Next bit +	SKIP_IN_0		;Get a data bit into r24.7 +	ori	r24, 0x80 +	brcc	4b	     	;All bits received?  no, continue + +	ldi	r25, BPS/2	;Wait for half bit time +6:	dec	r25 +	brne	6b +7:	SKIP_IN_1		;Wait for stop bit +	rjmp	7b + +	out	_SFR_IO_ADDR(SREG), r0	;End of critical section +	ret +.endfunc diff --git a/tmk_core/protocol/iwrap/suart.h b/tmk_core/protocol/iwrap/suart.h index 72725b998..7d92be069 100644 --- a/tmk_core/protocol/iwrap/suart.h +++ b/tmk_core/protocol/iwrap/suart.h @@ -1,8 +1,8 @@ -#ifndef SUART
 -#define SUART
 -
 -void xmit(uint8_t);
 -uint8_t rcvr(void);
 -uint8_t recv(void);
 -
 -#endif	/* SUART */
 +#ifndef SUART +#define SUART + +void xmit(uint8_t); +uint8_t rcvr(void); +uint8_t recv(void); + +#endif	/* SUART */ diff --git a/tmk_core/protocol/iwrap/wd.h b/tmk_core/protocol/iwrap/wd.h index 99058f033..12395bf69 100644 --- a/tmk_core/protocol/iwrap/wd.h +++ b/tmk_core/protocol/iwrap/wd.h @@ -1,159 +1,159 @@ -/* This is from http://www.mtcnet.net/~henryvm/wdt/ */
 -#ifndef _AVR_WD_H_
 -#define _AVR_WD_H_
 -
 -#include <avr/io.h>
 -
 -/*
 -Copyright (c) 2009, Curt Van Maanen
 -
 -Permission to use, copy, modify, and/or distribute this software for any
 -purpose with or without fee is hereby granted, provided that the above
 -copyright notice and this permission notice appear in all copies.
 -
 -THE SOFTWARE IS PROVIDED "AS IS" AND 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, DIRECT, 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.
 -
 -
 -include usage-
 -    #include "wd.h"             //if in same directory as project
 -    #include <avr/wd.h>         //if wd.h is in avr directory
 -
 -set watchdog modes and prescale
 -
 -usage-
 -    WD_SET(mode,[timeout]);     //prescale always set
 -
 -modes-
 -    WD_OFF                      disabled
 -    WD_RST                      normal reset mode
 -    WD_IRQ                      interrupt only mode (if supported)
 -    WD_RST_IRQ                  interrupt+reset mode (if supported)
 -
 -timeout-
 -    WDTO_15MS                   default if no timeout provided
 -    WDTO_30MS
 -    WDTO_60MS
 -    WDTO_120MS
 -    WDTO_250MS
 -    WDTO_500MS
 -    WDTO_1S
 -    WDTO_2S
 -    WDTO_4S                     (if supported)
 -    WDTO_8S                     (if supported)
 -
 -examples-
 -    WD_SET(WD_RST,WDTO_1S);     //reset mode, 1s timeout
 -    WD_SET(WD_OFF);             //watchdog disabled (if not fused on)
 -    WD_SET(WD_RST);             //reset mode, 15ms (default timeout)
 -    WD_SET(WD_IRQ,WDTO_120MS);  //interrupt only mode, 120ms timeout
 -    WD_SET(WD_RST_IRQ,WDTO_2S); //interrupt+reset mode, 2S timeout
 -
 -
 -for enhanced watchdogs, if the watchdog is not being used WDRF should be
 -cleared on every power up or reset, along with disabling the watchdog-
 -    WD_DISABLE();               //clear WDRF, then turn off watchdog
 -
 -*/
 -
 -//reset registers to the same name (MCUCSR)
 -#if !defined(MCUCSR)
 -#define MCUCSR                  MCUSR
 -#endif
 -
 -//watchdog registers to the same name (WDTCSR)
 -#if !defined(WDTCSR)
 -#define WDTCSR                  WDTCR
 -#endif
 -
 -//if enhanced watchdog, define irq values, create disable macro
 -#if defined(WDIF)
 -#define WD_IRQ                  0xC0
 -#define WD_RST_IRQ              0xC8
 -#define WD_DISABLE()            do{                       \
 -                                    MCUCSR &= ~(1<<WDRF); \
 -                                    WD_SET(WD_OFF);       \
 -                                }while(0)
 -#endif
 -
 -//all watchdogs
 -#define WD_RST                  8
 -#define WD_OFF                  0
 -
 -//prescale values
 -#define WDTO_15MS               0
 -#define WDTO_30MS               1
 -#define WDTO_60MS               2
 -#define WDTO_120MS              3
 -#define WDTO_250MS              4
 -#define WDTO_500MS              5
 -#define WDTO_1S                 6
 -#define WDTO_2S                 7
 -
 -//prescale values for avrs with WDP3
 -#if defined(WDP3)
 -#define WDTO_4S                 0x20
 -#define WDTO_8S                 0x21
 -#endif
 -
 -//watchdog reset
 -#define WDR()                   __asm__ __volatile__("wdr")
 -
 -//avr reset using watchdog
 -#define WD_AVR_RESET()          do{                              \
 -                                    __asm__ __volatile__("cli"); \
 -                                    WD_SET_UNSAFE(WD_RST);       \
 -                                    while(1);                    \
 -                                }while(0)
 -
 -/*set the watchdog-
 -1. save SREG
 -2. turn off irq's
 -3. reset watchdog timer
 -4. enable watchdog change
 -5. write watchdog value
 -6. restore SREG (restoring irq status)
 -*/
 -#define WD_SET(val,...)                                 \
 -    __asm__ __volatile__(                               \
 -        "in __tmp_reg__,__SREG__"           "\n\t"      \
 -        "cli"                               "\n\t"      \
 -        "wdr"                               "\n\t"      \
 -        "sts %[wdreg],%[wden]"              "\n\t"      \
 -        "sts %[wdreg],%[wdval]"             "\n\t"      \
 -        "out __SREG__,__tmp_reg__"          "\n\t"      \
 -        :                                               \
 -        : [wdreg] "M" (&WDTCSR),                        \
 -          [wden]  "r" ((uint8_t)(0x18)),                \
 -          [wdval] "r" ((uint8_t)(val|(__VA_ARGS__+0)))  \
 -        : "r0"                                          \
 -)
 -
 -/*set the watchdog when I bit in SREG known to be clear-
 -1. reset watchdog timer
 -2. enable watchdog change
 -5. write watchdog value
 -*/
 -#define WD_SET_UNSAFE(val,...)                          \
 -    __asm__ __volatile__(                               \
 -        "wdr"                               "\n\t"      \
 -        "sts %[wdreg],%[wden]"              "\n\t"      \
 -        "sts %[wdreg],%[wdval]"             "\n\t"      \
 -        :                                               \
 -        : [wdreg] "M" (&WDTCSR),                        \
 -          [wden]  "r" ((uint8_t)(0x18)),                \
 -          [wdval] "r" ((uint8_t)(val|(__VA_ARGS__+0)))  \
 -)
 -
 -
 -//for compatibility with avr/wdt.h
 -#define wdt_enable(val) WD_SET(WD_RST,val)
 -#define wdt_disable()   WD_SET(WD_OFF)
 -
 -
 -#endif /* _AVR_WD_H_ */
 +/* This is from http://www.mtcnet.net/~henryvm/wdt/ */ +#ifndef _AVR_WD_H_ +#define _AVR_WD_H_ + +#include <avr/io.h> + +/* +Copyright (c) 2009, Curt Van Maanen + +Permission to use, copy, modify, and/or distribute this software for any +purpose with or without fee is hereby granted, provided that the above +copyright notice and this permission notice appear in all copies. + +THE SOFTWARE IS PROVIDED "AS IS" AND 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, DIRECT, 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. + + +include usage- +    #include "wd.h"             //if in same directory as project +    #include <avr/wd.h>         //if wd.h is in avr directory + +set watchdog modes and prescale + +usage- +    WD_SET(mode,[timeout]);     //prescale always set + +modes- +    WD_OFF                      disabled +    WD_RST                      normal reset mode +    WD_IRQ                      interrupt only mode (if supported) +    WD_RST_IRQ                  interrupt+reset mode (if supported) + +timeout- +    WDTO_15MS                   default if no timeout provided +    WDTO_30MS +    WDTO_60MS +    WDTO_120MS +    WDTO_250MS +    WDTO_500MS +    WDTO_1S +    WDTO_2S +    WDTO_4S                     (if supported) +    WDTO_8S                     (if supported) + +examples- +    WD_SET(WD_RST,WDTO_1S);     //reset mode, 1s timeout +    WD_SET(WD_OFF);             //watchdog disabled (if not fused on) +    WD_SET(WD_RST);             //reset mode, 15ms (default timeout) +    WD_SET(WD_IRQ,WDTO_120MS);  //interrupt only mode, 120ms timeout +    WD_SET(WD_RST_IRQ,WDTO_2S); //interrupt+reset mode, 2S timeout + + +for enhanced watchdogs, if the watchdog is not being used WDRF should be +cleared on every power up or reset, along with disabling the watchdog- +    WD_DISABLE();               //clear WDRF, then turn off watchdog + +*/ + +//reset registers to the same name (MCUCSR) +#if !defined(MCUCSR) +#define MCUCSR                  MCUSR +#endif + +//watchdog registers to the same name (WDTCSR) +#if !defined(WDTCSR) +#define WDTCSR                  WDTCR +#endif + +//if enhanced watchdog, define irq values, create disable macro +#if defined(WDIF) +#define WD_IRQ                  0xC0 +#define WD_RST_IRQ              0xC8 +#define WD_DISABLE()            do{                       \ +                                    MCUCSR &= ~(1<<WDRF); \ +                                    WD_SET(WD_OFF);       \ +                                }while(0) +#endif + +//all watchdogs +#define WD_RST                  8 +#define WD_OFF                  0 + +//prescale values +#define WDTO_15MS               0 +#define WDTO_30MS               1 +#define WDTO_60MS               2 +#define WDTO_120MS              3 +#define WDTO_250MS              4 +#define WDTO_500MS              5 +#define WDTO_1S                 6 +#define WDTO_2S                 7 + +//prescale values for avrs with WDP3 +#if defined(WDP3) +#define WDTO_4S                 0x20 +#define WDTO_8S                 0x21 +#endif + +//watchdog reset +#define WDR()                   __asm__ __volatile__("wdr") + +//avr reset using watchdog +#define WD_AVR_RESET()          do{                              \ +                                    __asm__ __volatile__("cli"); \ +                                    WD_SET_UNSAFE(WD_RST);       \ +                                    while(1);                    \ +                                }while(0) + +/*set the watchdog- +1. save SREG +2. turn off irq's +3. reset watchdog timer +4. enable watchdog change +5. write watchdog value +6. restore SREG (restoring irq status) +*/ +#define WD_SET(val,...)                                 \ +    __asm__ __volatile__(                               \ +        "in __tmp_reg__,__SREG__"           "\n\t"      \ +        "cli"                               "\n\t"      \ +        "wdr"                               "\n\t"      \ +        "sts %[wdreg],%[wden]"              "\n\t"      \ +        "sts %[wdreg],%[wdval]"             "\n\t"      \ +        "out __SREG__,__tmp_reg__"          "\n\t"      \ +        :                                               \ +        : [wdreg] "M" (&WDTCSR),                        \ +          [wden]  "r" ((uint8_t)(0x18)),                \ +          [wdval] "r" ((uint8_t)(val|(__VA_ARGS__+0)))  \ +        : "r0"                                          \ +) + +/*set the watchdog when I bit in SREG known to be clear- +1. reset watchdog timer +2. enable watchdog change +5. write watchdog value +*/ +#define WD_SET_UNSAFE(val,...)                          \ +    __asm__ __volatile__(                               \ +        "wdr"                               "\n\t"      \ +        "sts %[wdreg],%[wden]"              "\n\t"      \ +        "sts %[wdreg],%[wdval]"             "\n\t"      \ +        :                                               \ +        : [wdreg] "M" (&WDTCSR),                        \ +          [wden]  "r" ((uint8_t)(0x18)),                \ +          [wdval] "r" ((uint8_t)(val|(__VA_ARGS__+0)))  \ +) + + +//for compatibility with avr/wdt.h +#define wdt_enable(val) WD_SET(WD_RST,val) +#define wdt_disable()   WD_SET(WD_OFF) + + +#endif /* _AVR_WD_H_ */ 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. + */ | 
