Add new CPPCHECK build system module for static code analysis of projects.
[pub/lufa.git] / LUFA / Build / lufa.build.in
index d1b82d8..115763a 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 all elf hex lss 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
@@ -20,11 +20,11 @@ LUFA_BUILD_OPTIONAL_VARS  += BOARD OPTIMIZATION C_STANDARD CPP_STANDARD F_CPU C_
 # -----------------------------------------------------------------------------\r
 # TARGETS:\r
 #\r
-#    size                      - List application size\r
-#    checksource               - Check existance of listed input source files\r
+#    size                      - List built application size\r
 #    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
 #    clean                     - Remove output files\r
 #\r
 # MANDATORY PARAMETERS:\r
@@ -54,12 +54,25 @@ LUFA_BUILD_OPTIONAL_VARS  += BOARD OPTIMIZATION C_STANDARD CPP_STANDARD F_CPU C_
 # -----------------------------------------------------------------------------\r
 \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
+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
+ifeq ($(MCU),)\r
+   $(error Makefile MCU option cannot be blank)\r
+endif\r
+ifeq ($(TARGET),)\r
+   $(error Makefile TARGET option cannot be blank)\r
+endif\r
+ifeq ($(ARCH),)\r
+   $(error Makefile ARCH option cannot be blank)\r
+endif\r
+ifeq ($(F_USB),)\r
+   $(error Makefile F_USB option cannot be blank)\r
+endif\r
 \r
 # Default values of optionally user-supplied variables\r
 BOARD          ?= NONE\r
@@ -72,15 +85,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 "$(ARCH)".)\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 +112,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
 else ifeq ($(ARCH), XMEGA)\r
    CC_FLAGS += -mmcu=$(MCU) -gdwarf-2 -fshort-enums -fno-inline-small-functions -fpack-struct\r
-   CROSS     = avr-\r
 else ifeq ($(ARCH), UC3)\r
    CC_FLAGS += -mpart=$(MCU) -g3 -masm-addr-pseudos\r
-   CROSS     = avr32-\r
-else\r
-    $(error Unsupported architecture.)\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 +131,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,56 +149,67 @@ 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
-checksource:\r
-       @for f in $(SRC) $(CPPSRC) $(ASRC); do \\r
-               if [ -f $$f ]; then \\r
-                       echo "Found Source File: $$f" ; \\r
-               else \\r
-                       echo "Source File Not Found: $$f" ; \\r
+gcc_version:\r
+       @$(CROSS)gcc --version\r
+\r
+check_source:\r
+       @for f in $(SRC); do \\r
+               if [ ! -f $$f ]; then \\r
+                       echo "Error: Source file not found: $$f"; \\r
+                       exit 1; \\r
                fi; \\r
         done\r
 \r
 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
+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
+all: begin check_source 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
+%.o: %.c $(MAKEFILE_LIST)\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
+%.o: %.cpp $(MAKEFILE_LIST)\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
+%.o: %.S $(MAKEFILE_LIST)\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
@@ -189,8 +223,8 @@ lss: $(TARGET).lss
        @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 \"$(strip $(notdir $(OBJECT_FILES)))\"\r
-       rm -f $(OBJECT_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
+# Include build dependency files\r
+-include $(DEPENDENCY_FILES)\r
+\r
+# Phony build targets for this module\r
+.PHONY: begin end gcc_version check_source size elf hex lss clean
\ No newline at end of file