Update CORE build module to print out additional help information.
[pub/lufa.git] / LUFA / Build / lufa.build.in
index e76f5c3..f777578 100644 (file)
@@ -7,12 +7,12 @@
 #\r
 \r
 LUFA_BUILD_MODULES        += BUILD\r
-LUFA_BUILD_TARGETS        += size checksource all elf hex clean\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
@@ -25,6 +25,8 @@ LUFA_BUILD_OPTIONAL_VARS  += BOARD OPTIMIZATION C_STANDARD CPP_STANDARD F_CPU C_
 #    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
@@ -72,15 +74,26 @@ CPP_FLAGS      ?=
 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
 # 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
+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
@@ -88,20 +101,16 @@ 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
 ifeq ($(ARCH), AVR8)\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), 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
-else\r
-  $(error Unsupported architecture.)\r
+   CC_FLAGS += -mpart=$(MCU) -g3 -masm-addr-pseudos\r
 endif\r
 CC_FLAGS += -Wall -fno-strict-aliasing -funsigned-char -funsigned-bitfields -ffunction-sections\r
 CC_FLAGS += -I. -I$(patsubst %/,%,$(LUFA_PATH))/..\r
@@ -111,11 +120,14 @@ ifneq ($(F_CPU),)
 endif\r
 \r
 # Additional language specific compiler flags\r
-C_FLAGS   += -Wstrict-prototypes\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
@@ -126,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
@@ -150,11 +167,11 @@ 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 elf hex lss size end\r
-all: begin elf hex lss size end\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
@@ -162,11 +179,11 @@ lss: $(TARGET).lss
 \r
 %.o: %.c\r
        @echo $(MSG_COMPILE_CMD) Compiling C file \"$<\"\r
-       $(CROSS)gcc -c $(CC_FLAGS) $(C_FLAGS) -O$(OPTIMIZATION) -std=$(C_STANDARD) $< -o $@\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) $(CPP_FLAGS) -O$(OPTIMIZATION) -std=$(CPP_STANDARD) -x c++ $< -o $@\r
+       $(CROSS)gcc -c $(CC_FLAGS) $(CPP_FLAGS) -x c++ $< -o $@\r
        \r
 %.o: %.S\r
        @echo $(MSG_COMPILE_CMD) Assembling \"$<\"\r
@@ -175,7 +192,7 @@ lss: $(TARGET).lss
 .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
@@ -192,5 +209,10 @@ lss: $(TARGET).lss
 clean:\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