makefile

altera epxa1的例子程序

# Makefile
#
#
# Copyright (c) Altera Corporation 2002.
# All rights reserved.
#
# Author: IS
#
# This is the Makefile for the gnu directory of the hello_world example
# for Excalibur-ARM. The Makefile provides an alternative mechanism for 
# building the software using the gnu tools. The intention is that this 
# Makefile should follow the same build processes as that performed by 
# the Quartus software project provided in this directory.
#
# Targets
# -------
#
# The following targets are supported:
#
# debug   - build a debug version of the hello_world application
# release - build a release version of the hello_world application
# clean   - delete all generated files
#
# The default target is 'debug'.
#
# Environment Variables
# ---------------------
#
# In order to locate the makeprogfile utility and the boot library, either
# QUARTUS_ROOTDIR or QUTILITIES_ROOTDIR must be defined. These variables
# point to the installation directory of Quartus (QUARTUS_ROOTDIR), or 
# the Quartus utilities (QUTILITIES_ROOTDIR). On Windows these variables
# are set automatically when the tools are installed. One or other 
# should be set manually on unix.
#
# The following environment variables are required to locate the gnu
# newlib libraries and object files. 
#
# ALTERA_ARM9GP_ROOT - The installation directory of the gnu tools, e.g. 
#                      c:\Redhat.
# ALTERA_ARM9GP_VER  - The version of the tools being used, e.g. arm9-020404.
# ALTERA_ARM9GP_HOST - The host platform being used, e.g. H-i686-pc-cygwin.
#
# In addition it is assumed that the directory that contains the gnu 
# utilities are on you path. 
#
#################################################################

# The name of the project being built. This is used to create the names
# of the generated files.

PROJECT      := interrupt

# The names of the directories which will be used to hold the intermediate
# files.

DEBUG_DIR    := Debug
RELEASE_DIR  := Release

# The source files to be built. Note that the paths to locate the source files
# should be defined using the VPATH variable.

ASM_FILES    := crt0.S
C_FILES      := main.c epxa10.c exceptions.c irq.c uartcomm.c timer.c

# Search path used to locate the source code.
  
VPATH := software ../common ../hardware 

# the SBI file to use

SBI := ../hardware/arm_top.sbi

# The environment variables QUARTUS_ROOTDIR and QUTILITIES_ROOTDIR are 
# used to locate utilities and libraries privided by Altera. By default
# the tools provided by a full installation of Quartus are used (as
# defined through the QUARTUS_ROOTDIR environment variable). 
#
# If QUARTUS_ROOTDIR is not defined, then the utilities installed by
# the utilities and resources CD are used (as defined by the 
# QUTILITIES_ROOTDIR).
  
ifndef QUARTUS_ROOTDIR
QUARTUS_ROOTDIR := $(QUTILITIES_ROOTDIR)
endif

# Additional object files which should be linked into the application.

EXTRA_OBJ_FILES := $(ALTERA_ARM9GP_ROOT)/$(ALTERA_ARM9GP_VER)/$(ALTERA_ARM9GP_HOST)/lib/gcc-lib/arm-elf/2.96-$(ALTERA_ARM9GP_VER)/crtbegin.o \
                   $(ALTERA_ARM9GP_ROOT)/$(ALTERA_ARM9GP_VER)/$(ALTERA_ARM9GP_HOST)/lib/gcc-lib/arm-elf/2.96-$(ALTERA_ARM9GP_VER)/crtend.o 

# The name of bootable image that is to be generated. This is created
# in Intel Hex format, so that it can be programmed into flash using 
# the Altera flash programmer.

BOOT_FILE    := $(PROJECT)_flash.hex

# The tools that will be used to build the application.

MAKEPROGFILE := $(QUARTUS_ROOTDIR)/bin/makeprogfile
CC           := arm-elf-gcc
OBJCOPY      := arm-elf-objcopy 
LD           := arm-elf-ld   
ASM          := arm-elf-gcc -x assembler-with-cpp

# The path to search for include files when compiling the source.

INCLUDE_PATH := -I. -I../common -I../hardware

# Flags passed to the assembler.

ASM_FLAGS         := -WaEL -marm920t
ASM_DEBUG_FLAGS   := -Wagdwarf2 -WaL 
ASM_RELEASE_FLAGS := 

# Flags passed to the C compiler.

C_FLAGS         := -mlittle-endian -mcpu=arm920t 
C_DEBUG_FLAGS   := -g
C_RELEASE_FLAGS := -O3

# Flags passed to the linker.

LD_PATH  := -L $(ALTERA_ARM9GP_ROOT)/$(ALTERA_ARM9GP_VER)/$(ALTERA_ARM9GP_HOST)/lib/gcc-lib/arm-elf/2.96-$(ALTERA_ARM9GP_VER) \
            -L $(ALTERA_ARM9GP_ROOT)/$(ALTERA_ARM9GP_VER)/$(ALTERA_ARM9GP_HOST)/arm-elf/lib 
LD_FLAGS := -EL -T software/armelf.x
LD_LIBS  := -lc -lgcc -lc

# Flags passed to the linker when linking the output of makeprogfile
# with the Altera boot library. Note that the -p flag is required, since
# the boot library has been generated using the ADS tools.
 
LD_BOOT_PATH  := -L $(QUARTUS_ROOTDIR)/libraries/software/boot
LD_BOOT_FLAGS := -p -entry=___altera_entry 
LD_BOOT_LIBS  := -lboot_xa_ads

# Flags passed to the utility used to convert the elf format application
# to Intel Hex.

OBJCOPY_FLAGS := -O ihex

# Flags passed to the utility used to convert the elf format application
# to Intel Hex.

OBJCOPY_BOOT_FLAGS := -O ihex --change-address=-0x8000

# flags passed to the makeprogfile utility.

MAKEPROG_FLAGS := -m memory -q

# These variables are used internally to generate dependancies. It is not expected that
# these will need to be modified

OBJ_FILES_ASM_DEBUG   := $(foreach file, $(ASM_FILES:.S=.o), $(DEBUG_DIR)/$(file))
OBJ_FILES_ASM_RELEASE := $(foreach file, $(ASM_FILES:.S=.o), $(RELEASE_DIR)/$(file))
OBJ_FILES_C_DEBUG     := $(foreach file, $(C_FILES:.c=.o), $(DEBUG_DIR)/$(file))
OBJ_FILES_C_RELEASE   := $(foreach file, $(C_FILES:.c=.o), $(RELEASE_DIR)/$(file))

#################################################################
#
# rules
#
# Below are the rules used to construct the supported targets. 'debug' is the 
# default target.

# In the case of cygwin Make on the PC, we have to make sure
# that we're using the win32 mode.

ifneq (, $(findstring Windows, $(OS)))
ifeq  (, $(findstring --win32, $(MAKEFLAGS)))

debug release clean:
	@$(MAKE) --win32 $@
	
DEFER_MAKE := true
	
endif
endif	

ifndef DEFER_MAKE

# generate a debug version of the bootable image.

debug: $(DEBUG_DIR)/$(BOOT_FILE)

# generate a release version of the bootable image.

release: $(RELEASE_DIR)/$(BOOT_FILE)

# Delete all generated files.
#
# Since rm doesn't exist on windows machines
# del has to be used instead. The environment variable OS is used to
# discover the machine architecture. I hope that is defined by default
# for all Windows hosts...

clean:
ifneq (,$(findstring Windows, $(OS)))
	-del /Q $(DEBUG_DIR)\* $(RELEASE_DIR)\*
	-del /Q $(BOOT_FILE)
else
	-rm -f $(DEBUG_DIR)/* $(RELEASE_DIR)/*	
	-rm -f $(BOOT_FILE)
endif

# compile assembly files for debug.

$(OBJ_FILES_ASM_DEBUG): $(DEBUG_DIR)/%.o: %.S Makefile
	$(ASM) -c $(INCLUDE_PATH) $(ASM_FLAGS) $(ASM_DEBUG_FLAGS) -o $@ $<

# compile assembly files for release.

$(OBJ_FILES_ASM_RELEASE): $(RELEASE_DIR)/%.o: %.S Makefile
	$(ASM) -c  $(INCLUDE_PATH) $(ASM_FLAGS) $(ASM_RELEASE_FLAGS) -o $@ $<

# compile c files for debug

$(OBJ_FILES_C_DEBUG): $(DEBUG_DIR)/%.o: %.c Makefile
	$(CC) -c $(INCLUDE_PATH) $(C_FLAGS) $(C_DEBUG_FLAGS) -o $@ $<

# compile c files for release.

$(OBJ_FILES_C_RELEASE): $(RELEASE_DIR)/%.o: %.c Makefile
	$(CC) -c $(INCLUDE_PATH) $(C_FLAGS) $(C_RELEASE_FLAGS) -o $@ $<

# link all debug versions of the application object files

$(DEBUG_DIR)/$(PROJECT).elf: $(OBJ_FILES_ASM_DEBUG) $(OBJ_FILES_C_DEBUG) $(EXTRA_OBJ_FILES)
	$(LD) $(LD_PATH) $(LD_FLAGS) -o $@  $^ $(LD_LIBS)

# link all release versions of the application object files

$(RELEASE_DIR)/$(PROJECT).elf: $(OBJ_FILES_ASM_RELEASE) $(OBJ_FILES_C_RELEASE) $(EXTRA_OBJ_FILES)
	$(LD) $(LD_PATH) $(LD_FLAGS) -o $@  $^ $(LD_LIBS)	

# create an Intel hex file from the elf version of the application 

%/$(PROJECT).hex: %/$(PROJECT).elf
	$(OBJCOPY) $(OBJCOPY_FLAGS) $< $@

# create the bootdata used by the boot library to configure the device and 
# load the application

%/$(PROJECT)_bootdata.o: $(PROJECT).sbd $(SBI) %/$(PROJECT).hex   
	$(MAKEPROGFILE) $(MAKEPROG_FLAGS) -b $@ $^

# link the bootdata with the boot library

%/$(PROJECT)_flash.elf: %/$(PROJECT)_bootdata.o
	$(LD) $(LD_BOOT_PATH) $(LD_BOOT_FLAGS) -o $@ $< $(LD_BOOT_LIBS) 

# Convert the bootable executable into Intel hex format. As a side effect of this rule,
# a copy of the hex file is stored in the current directory. This is done in order to emulate
# the action of the Quartus project.

%/$(PROJECT)_flash.hex: %/$(PROJECT)_flash.elf
	$(OBJCOPY) $(OBJCOPY_BOOT_FLAGS) $< $@
	$(OBJCOPY) $(OBJCOPY_BOOT_FLAGS) $< $(BOOT_FILE)

# These intermediates are retained since they're useful for system debug.

.PRECIOUS: %/$(PROJECT)_bootdata.o  %/$(PROJECT).hex %/$(PROJECT)_flash.elf

# Remove any generated files, if there's an error in making them

.DELETE_ON_ERROR: 

# These rules are used to generate the automatic dependacy files. The method used here is 
# a little unorthodox. The motivation for this is to provide a solution that will work
# equally well on windows and unix systems. The regular method described in the gnu make 
# manual uses sed, which we don't necessarily have available on windows.

$(foreach dep,$(ASM_FILES:.S=.d),$(DEBUG_DIR)/$(dep)): $(DEBUG_DIR)/%.d: %.S
	@ echo building dependacy file $@ 
	@ echo $@ $(@:.d=.o) \> $@
	@ $(ASM) -M $(INCLUDE_PATH) $< >> $@  

$(foreach dep,$(ASM_FILES:.S=.d),$(RELEASE_DIR)/$(dep)): $(RELEASE_DIR)/%.d: %.S
	@ echo building dependacy file $@ 
	@ echo $@ $(@:.d=.o) \> $@
	@ $(ASM) -M $(INCLUDE_PATH) $< >> $@  

$(foreach dep,$(C_FILES:.c=.d),$(DEBUG_DIR)/$(dep)): $(DEBUG_DIR)/%.d: %.c
	@ echo building dependacy file $@ 
	@ echo $@ $(@:.d=.o) \> $@
	@ $(CC) -M $(INCLUDE_PATH) $< >> $@ 

$(foreach dep,$(C_FILES:.c=.d),$(RELEASE_DIR)/$(dep)): $(RELEASE_DIR)/%.d: %.c
	@ echo building dependacy file $@ 
	@ echo $@ $(@:.d=.o) \> $@
	@ $(CC) -M $(INCLUDE_PATH) $< >> $@ 

# Include the dependancy files

-include $(foreach dep,$(ASM_FILES:.S=.d),$(DEBUG_DIR)/$(dep))
-include $(foreach dep,$(ASM_FILES:.S=.d),$(RELEASE_DIR)/$(dep))
-include $(foreach dep,$(C_FILES:.c=.d),$(DEBUG_DIR)/$(dep))
-include $(foreach dep,$(C_FILES:.c=.d),$(RELEASE_DIR)/$(dep))

endif

# Declare these targets as phony to ensure that their associated rules will always run, even
# if a directory is created with these names.

.PHONY: debug release clean