Update CORE build module to print out additional help information.
[pub/lufa.git] / LUFA / Build / lufa.build.in
index d39ab72..f777578 100644 (file)
@@ -6,11 +6,13 @@
 #           www.lufa-lib.org\r
 #\r
 \r
-LUFA_BUILD_MODULES += BUILD\r
-LUFA_BUILD_TARGETS += size checksource all elf hex clean\r
+LUFA_BUILD_MODULES        += BUILD\r
+LUFA_BUILD_TARGETS        += size checksource all elf hex lss gcc_version clean\r
+LUFA_BUILD_MANDATORY_VARS += TARGET ARCH MCU SRC F_USB LUFA_PATH\r
+LUFA_BUILD_OPTIONAL_VARS  += BOARD OPTIMIZATION C_STANDARD CPP_STANDARD F_CPU C_FLAGS CPP_FLAGS ASM_FLAGS CC_FLAGS LD_FLAGS\r
 \r
 # -----------------------------------------------------------------------------\r
-#               LUFA Compiler Buildsystem Makefile Module.\r
+#               LUFA GCC Compiler Buildsystem Makefile Module.\r
 # -----------------------------------------------------------------------------\r
 # DESCRIPTION:\r
 #   Provides a set of targets to build a C, C++ and/or Assembly application\r
@@ -23,6 +25,8 @@ LUFA_BUILD_TARGETS += size checksource all elf hex clean
 #    all                       - Build application and list size\r
 #    elf                       - Build application ELF debug object file\r
 #    hex                       - Build application HEX object files\r
+#    lss                       - Build application LSS assembly listing file\r
+#    gcc_version               - Print version of GCC used\r
 #    clean                     - Remove output files\r
 #\r
 # MANDATORY PARAMETERS:\r
@@ -42,47 +46,54 @@ LUFA_BUILD_TARGETS += size checksource all elf hex clean
 #    C_STANDARD                - C Language Standard to use\r
 #    CPP_STANDARD              - C++ Language Standard to use\r
 #    F_CPU                     - Speed of the CPU, in Hz\r
-#    CC_FLAGS                  - Flags to pass to the compiler\r
+#    C_FLAGS                   - Flags to pass to the C compiler only\r
+#    CPP_FLAGS                 - Flags to pass to the C++ compiler only\r
+#    ASM_FLAGS                 - Flags to pass to the assembler only\r
+#    CC_FLAGS                  - Common flags to pass to the C/C++ compiler and\r
+#                                assembler\r
 #    LD_FLAGS                  - Flags to pass to the linker\r
 #\r
 # -----------------------------------------------------------------------------\r
 \r
-# Output Messages\r
-MSG_BUILD_BEGIN = Begin compilation of project \"$(TARGET)\"...\r
-MSG_BUILD_END   = Finished building project \"$(TARGET)\"...\r
-MSG_COMPILE_CMD = '  [CC]      :'\r
-MSG_REMOVE_CMD  = '  [RM]      :'\r
-MSG_LINKER_CMD  = '  [LNK]     :'\r
-MSG_SIZE_CMD    = '  [SIZE]    :'\r
-MSG_OBJCPY_CMD  = '  [OBJCPY]  :'\r
-MSG_OBJDMP_CMD  = '  [OBJDMP]  :'\r
-\r
-# Sanity check the user MCU, TARGET, ARCH, SRC, F_USB and LUFA_PATH makefile options\r
-ifeq ($(TARGET),)\r
-   $(error Makefile TARGET value not set.)\r
-endif\r
-ifeq ($(ARCH),)\r
-   $(error Makefile ARCH value not set.)\r
-endif\r
-ifeq ($(MCU),)\r
-   $(error Makefile MCU value not set.)\r
-endif\r
-ifeq ($(SRC),)\r
-   $(error Makefile SRC value not set.)\r
-endif\r
-ifeq ($(F_USB),)\r
-   $(error Makefile F_USB value not set.)\r
-endif\r
-ifeq ($(LUFA_PATH),)\r
-   $(error Makefile LUFA_PATH value not set.)\r
+# Sanity-check values of mandatory user-supplied variables\r
+MCU            ?= $(error Makefile MCU value not set.)\r
+TARGET         ?= $(error Makefile TARGET value not set.)\r
+ARCH           ?= $(error Makefile ARCH value not set.)\r
+SRC            ?= $(error Makefile SRC value not set.)\r
+F_USB          ?= $(error Makefile F_USB value not set.)\r
+LUFA_PATH      ?= $(error Makefile LUFA_PATH value not set.)\r
+\r
+# Default values of optionally user-supplied variables\r
+BOARD          ?= NONE\r
+OPTIMIZATION   ?= s\r
+F_CPU          ?=\r
+C_STANDARD     ?= gnu99\r
+CPP_STANDARD   ?= gnu++98\r
+C_FLAGS        ?=\r
+CPP_FLAGS      ?=\r
+ASM_FLAGS      ?=\r
+CC_FLAGS       ?=\r
+\r
+# Determine the utility prefix to use for the selected architecture\r
+ifeq ($(ARCH), AVR8)\r
+   CROSS       := avr-\r
+else ifeq ($(ARCH), XMEGA)\r
+   CROSS       := avr-\r
+else ifeq ($(ARCH), UC3)\r
+   CROSS       := avr32-\r
+else\r
+    $(error Unsupported architecture.)\r
 endif\r
 \r
-# Default values of user-supplied variables\r
-BOARD         ?= NONE\r
-OPTIMIZATION  ?= s\r
-F_CPU         ?=\r
-C_STANDARD    ?= gnu99\r
-CPP_STANDARD  ?= gnu++98\r
+# Output Messages\r
+MSG_BUILD_BEGIN := Begin compilation of project \"$(TARGET)\"...\r
+MSG_BUILD_END   := Finished building project \"$(TARGET)\".\r
+MSG_COMPILE_CMD := ' [CC]      :'\r
+MSG_REMOVE_CMD  := ' [RM]      :'\r
+MSG_LINKER_CMD  := ' [LNK]     :'\r
+MSG_SIZE_CMD    := ' [SIZE]    :'\r
+MSG_OBJCPY_CMD  := ' [OBJCPY]  :'\r
+MSG_OBJDMP_CMD  := ' [OBJDMP]  :'\r
 \r
 # Convert input source file list to differentiate them by type\r
 C_SOURCE   = $(filter %.c, $(SRC))\r
@@ -90,30 +101,33 @@ CPP_SOURCE = $(filter %.cpp, $(SRC))
 ASM_SOURCE = $(filter %.S, $(SRC))\r
 \r
 # Convert input source filenames into a list of required output object files\r
-OBJECT_FILES = $(filter %.o, $(C_SOURCE:%.c=%.o) $(CPP_SOURCE:%.cpp=%.o) $(ASM_SOURCE:%.S=%.o))\r
+OBJECT_FILES     = $(filter %.o, $(C_SOURCE:%.c=%.o) $(CPP_SOURCE:%.cpp=%.o) $(ASM_SOURCE:%.S=%.o))\r
+DEPENDENCY_FILES = $(OBJECT_FILES:%=%.d)\r
 \r
 # Create a list of flags to pass to the compiler\r
-ifneq ($(ARCH), AVR8)\r
- CC_FLAGS += -mmcu=$(MCU) -gdwarf-2 -fshort-enums -fno-inline-small-functions -fpack-struct\r
- CROSS     = avr-\r
+ifeq ($(ARCH), AVR8)\r
+   CC_FLAGS += -mmcu=$(MCU) -gdwarf-2 -fshort-enums -fno-inline-small-functions -fpack-struct\r
 else ifeq ($(ARCH), XMEGA)\r
- CC_FLAGS += -mmcu=$(MCU) -gdwarf-2 -fshort-enums -fno-inline-small-functions -fpack-struct\r
- CROSS     = avr-\r
+   CC_FLAGS += -mmcu=$(MCU) -gdwarf-2 -fshort-enums -fno-inline-small-functions -fpack-struct\r
 else ifeq ($(ARCH), UC3)\r
- CC_FLAGS += -mpart=$(MCU) -g3 -masm-addr-pseudos\r
- CROSS     = avr32-\r
+   CC_FLAGS += -mpart=$(MCU) -g3 -masm-addr-pseudos\r
 endif\r
-CC_FLAGS += -fno-strict-aliasing -funsigned-char -funsigned-bitfields -ffunction-sections\r
-CC_FLAGS += -Wall -Wstrict-prototypes\r
-CC_FLAGS += -I. -I$(LUFA_PATH)/..\r
+CC_FLAGS += -Wall -fno-strict-aliasing -funsigned-char -funsigned-bitfields -ffunction-sections\r
+CC_FLAGS += -I. -I$(patsubst %/,%,$(LUFA_PATH))/..\r
 CC_FLAGS += -DARCH=ARCH_$(ARCH) -DBOARD=BOARD_$(BOARD) -DF_USB=$(F_USB)UL\r
 ifneq ($(F_CPU),)\r
    CC_FLAGS += -DF_CPU=$(F_CPU)UL\r
 endif\r
 \r
+# Additional language specific compiler flags\r
+C_FLAGS   += -O$(OPTIMIZATION) -std=$(C_STANDARD) -MMD -MP -MF $@.d -Wstrict-prototypes \r
+CPP_FLAGS += -O$(OPTIMIZATION) -std=$(CPP_STANDARD) -MMD -MP -MF $@.d\r
+\r
 # Create a list of flags to pass to the linker\r
-LD_FLAGS += -Wl,-Map=$(TARGET).map,--cref -Wl,--gc-sections -lm\r
-ifneq ($(F_CPU), UC3)\r
+LD_FLAGS += -lm -Wl,-Map=$(TARGET).map,--cref -Wl,--gc-sections \r
+ifeq ($(ARCH), UC3)\r
+   LD_FLAGS += --rodata-writable --direct-data   \r
+else\r
    LD_FLAGS += -Wl,--relax\r
 endif\r
 \r
@@ -124,18 +138,23 @@ ifneq ($(UNKNOWN_SOURCE),)
 endif\r
 \r
 # Determine flags to pass to the size utility based on its reported features\r
-SIZE_MCU_FLAG    = $(shell avr-size --help | grep -- --mcu > /dev/null && echo --mcu=$(MCU) )\r
-SIZE_FORMAT_FLAG = $(shell avr-size --help | grep -- --format=.*avr > /dev/null && echo --format=avr )\r
+SIZE_MCU_FLAG    := $(shell $(CROSS)size --help | grep -- --mcu > /dev/null && echo --mcu=$(MCU) )\r
+SIZE_FORMAT_FLAG := $(shell $(CROSS)size --help | grep -- --format=.*avr > /dev/null && echo --format=avr )\r
 \r
 \r
 begin:\r
        @echo ""\r
        @echo $(MSG_BUILD_BEGIN)\r
+       @echo ""\r
        \r
 end:\r
+       @echo ""\r
        @echo $(MSG_BUILD_END)\r
        @echo ""\r
 \r
+gcc_version:\r
+       @$(CROSS)gcc --version\r
+\r
 checksource:\r
        @for f in $(SRC) $(CPPSRC) $(ASRC); do \\r
                if [ -f $$f ]; then \\r
@@ -148,47 +167,52 @@ checksource:
 size:\r
        @echo $(MSG_SIZE_CMD) Determining size of \"$(TARGET).elf\"\r
        @if test -f $(TARGET).elf; then \\r
-           avr-size $(SIZE_MCU_FLAG) $(SIZE_FORMAT_FLAG) $(TARGET).elf ; 2>/dev/null; \\r
+           $(CROSS)size $(SIZE_MCU_FLAG) $(SIZE_FORMAT_FLAG) $(TARGET).elf ; 2>/dev/null; \\r
         fi\r
 \r
-.PHONY: begin hex lss end size\r
-all: begin hex end size\r
+.PHONY: begin gcc_version elf hex lss size end\r
+all: begin gcc_version elf hex lss size end\r
 \r
 elf: $(TARGET).elf\r
 hex: $(TARGET).hex $(TARGET).eep\r
 lss: $(TARGET).lss\r
 \r
 %.o: %.c\r
-       @echo $(MSG_COMPILE_CMD) Compiling C file \"$^\"\r
-       $(CROSS)gcc -c $(CC_FLAGS) -O$(OPTIMIZATION) -std=$(C_STANDARD) $< -o $@\r
+       @echo $(MSG_COMPILE_CMD) Compiling C file \"$<\"\r
+       $(CROSS)gcc -c $(CC_FLAGS) $(C_FLAGS) $< -o $@\r
 \r
 %.o: %.cpp\r
-       @echo $(MSG_COMPILE_CMD) Compiling C++ file \"$^\"\r
-       $(CROSS)gcc -c $(CC_FLAGS) -O$(OPTIMIZATION) -std=$(CPP_STANDARD) -x c++ $< -o $@\r
+       @echo $(MSG_COMPILE_CMD) Compiling C++ file \"$<\"\r
+       $(CROSS)gcc -c $(CC_FLAGS) $(CPP_FLAGS) -x c++ $< -o $@\r
        \r
 %.o: %.S\r
-       @echo $(MSG_COMPILE_CMD) Assembling \"$^\"\r
-       $(CROSS)gcc -c $(CC_FLAGS) -x assembler-with-cpp $< -o $@\r
+       @echo $(MSG_COMPILE_CMD) Assembling \"$<\"\r
+       $(CROSS)gcc -c $(CC_FLAGS) $(ASM_FLAGS) -x assembler-with-cpp $< -o $@\r
 \r
 .PRECIOUS : $(OBJECT_FILES)\r
 %.elf: $(OBJECT_FILES)\r
        @echo $(MSG_LINKER_CMD) Linking object files into \"$@\"\r
-       $(CROSS)gcc $^ $(CC_FLAGS) $(LD_FLAGS) -o $@\r
+       $(CROSS)gcc $(CC_FLAGS) $(LD_FLAGS) $^ -o $@\r
 \r
 %.hex: %.elf\r
-       @echo $(MSG_OBJCPY_CMD) Extracting HEX file data from \"$@\"\r
+       @echo $(MSG_OBJCPY_CMD) Extracting HEX file data from \"$<\"\r
        $(CROSS)objcopy -O ihex -R .eeprom -R .fuse -R .lock -R .signature $< $@\r
 \r
 %.eep: %.elf\r
-       @echo $(MSG_OBJCPY_CMD) Extracting EEP file data from \"$@\"\r
+       @echo $(MSG_OBJCPY_CMD) Extracting EEP file data from \"$<\"\r
        $(CROSS)objcopy -j .eeprom --set-section-flags=.eeprom="alloc,load" --change-section-lma .eeprom=0 --no-change-warnings -O ihex $< $@ || exit 0\r
 \r
 %.lss: %.elf\r
-       @echo $(MSG_OBJDMP_CMD) Extracting LSS file data from \"$@\"\r
+       @echo $(MSG_OBJDMP_CMD) Extracting LSS file data from \"$<\"\r
        $(CROSS)objdump -h -S -z $< > $@\r
 \r
 clean:\r
-       @echo $(MSG_REMOVE_CMD) Removing object files \"$(OBJECT_FILES)\"\r
+       @echo $(MSG_REMOVE_CMD) Removing object files \"$(strip $(notdir $(OBJECT_FILES)))\"\r
        rm -f $(OBJECT_FILES)\r
+       @echo $(MSG_REMOVE_CMD) Removing dependency files \"$(strip $(notdir $(DEPENDENCY_FILES)))\"\r
+       rm -f $(DEPENDENCY_FILES)\r
        @echo $(MSG_REMOVE_CMD) Removing output files \"$(TARGET).elf $(TARGET).hex $(TARGET).eep $(TARGET).map $(TARGET).lss\"\r
        rm -f $(TARGET).elf $(TARGET).hex $(TARGET).eep $(TARGET).map $(TARGET).lss\r
+\r
+# Include build dependency files\r
+-include $(DEPENDENCY_FILES)
\ No newline at end of file