AVR-GCC Makefile 中文翻譯並加上我的理解(原發於:2007-11-20)

#××××××××××××××××××××××××××××××
# AVR-GCC  makefile 模板                                   ×
#  semilog                                                 ×
# E-mail: [email protected]                                  ×
# 時間:2007年11月9日                                      ×
# 地點:南京理工大學                                       ×
# 注:在原來的WinAVR 的例程的基礎上修改,翻譯,註釋,並且測試 ×
#××××××××××××××××××××××××××××××

#下面這一段是原作者,爲了尊重他們的勞動.
# Hey Emacs, this is a -*- makefile -*-
#----------------------------------------------------------------------------
# WinAVR Makefile Template written by Eric B. Weddington, Joerg Wunsch, et al.
#
# Released to the Public Domain
#
# Additional material for this makefile was written by:
# Peter Fleury
# Tim Henigan
# Colin O'Flynn
# Reiner Patommel
# Markus Pfaff
# Sander Pool
# Frederik Rouleau
# Carlos Lamas
#
#----------------------------------------------------------------------------

# 編譯操作命令如下:
#
# make all = 編譯整個工程.
#
# make clean = 刪除所有前一次編譯的整個工程所產生的文件
#
# make coff = 轉換 ELF 調試文件到 AVR 的 COFF 調試文件.適用於AVRStudio.3.X及以前的版本.         
#             VMLAB <3.10 
#
# make extcoff = 轉換 ELF 調試文件到 AVR 的 Extended COFF 調試文件.          VMLAT 3.10+
#                適用於AVRStudio.4.07 及以後的版本。也就是現在我們要使用的版本
#                但是好像AVRStdio.4.10及以上的版本開始支持 ELF 調試文
#
# make program = 用 avrdude(gnu的avr單片機下載軟件) 下載 hex 文件到AVR單片機內,
#                不要再這之前要先配置好 avrdude .注:我們可以用雙龍的下載軟件等。
#
# make debug = 啓動 simulavr 或 avarice 進行調試,你用 avr-gdb 或是avr-insight作的你的調試前端
#
# make filename.s = 單獨編譯 filename.c 到彙編文件filename.s .
#
# make filename.i = 通過這個命令進行預編譯,來查看GCC工程是否有錯.
#
# 說了這麼多,最有用的就是下面這兩句:
#  make clean 
#  make all 
# 這樣你的工程就編譯完成了。
#----------------------------------------------------------------------------

#下面對AVR-GCC參數的說明   
#注:關於Makefile的知識網上有很多,看看Makefile的手冊

# AVR單片機的名字。這個很重要,不可寫錯,因爲這個參數真接關係到<io.h>文件所包含的<iomxx.h>文件
# 這個<iomxx.h>文件包含了所以的對於 你所選的AVR 單片機的所有引腳和寄存器定義。
# 就如keil 51中的引用<at89x51>或<REG51.h>一樣  
MCU = atmega128

# MCU 的運行頻率.
#     下面是給出的一些典型值:
#         F_CPU =  1000000
#         F_CPU =  1843200
#         F_CPU =  2000000
#         F_CPU =  3686400
#         F_CPU =  4000000
#         F_CPU =  7372800
#         F_CPU =  8000000
#         F_CPU = 11059200
#         F_CPU = 14745600
#         F_CPU = 16000000
#         F_CPU = 18432000
#         F_CPU = 20000000
# 在使用<avr/delay.h> 中的延時程序時很有用

F_CPU = 7372800

# 輸出文件格式,對於單片機編程來說,一般我們先intel 的hex格式. (可以是: srec, ihex, binary)
FORMAT = ihex


# 目標文件名,一般就是你最main()函數所在文件名,也是最後輸的hex文年的文件名(不帶擴展名).
TARGET = m128

#目標文件的臨時目錄,就選 "obj"這個名子吧,一般不用修改
OBJDIR = obj

# 列出你的C語言的工程中的所有的 *.C 源文件名. (C 的所有的文件依賴關係會自己動建立,後面會說.)
# 對於只有一個源文的工程也可以寫成: SRC = $(TARGET).c
SRC = m128.c

# 列出你的 C++工程中的所有的 *.cpp源文件名. (C++的所有的文件依賴關係也會自己動建立.)
# 對於我們對AVR單片機編程來說,一般我們只用C語言就可以了。所以這裏我們什麼都不用寫
# 如果你要用C++也可以,這裏你就要配置下。
CPPSRC = 

# 列出你的工程中的所有的彙編源程序
#     記住要用大寫.S保存你的彙編文件名,不要用小寫的.s 。要不然AVR-GCC不認爲它是個彙編源文件
#     而且在執行 make clean 時也刪除 .s 的文件,因爲它會認爲是編譯C文件生成的彙編過程文件
ASRC =

# AVR-GCC代碼優化級別,選項:[0, 1, 2, 3, s]. 級別越高,優化程度越大
#     0 = 不優化. s = 2 + 優化代碼大小,3 優化並不總是最好的.使用-O時表示-O1;
OPT = s

# 調試文件格式.
#     如果是用Winavr 的GDB調試的話選 dwarf-2 [默認] 或者stabs也行。
#     從AVR Studio 4.10 (我不知道是不是從這個版本開始,反正4.12是可以的)
#     開始AVRStudio已開始支持ELF/DWARF的調試文件,所以這時你可以選 dwarf-2.
#     編譯你的工程然後開始調試,我測試過,而且在AVRStudio4.12的幫助文檔中找到了
#     AVRStudio目前支持的 Debugging File 的說明,你們也可以自己去看一下。
#     當然 AVR [Extended] COFF 格式還是支持,不過你要在編譯時在這裏選 stabs 選項
#     然後在用"make all" 編譯後再用"make extcoff"調用avr-objcopy 生成 [Extended] COFF.
#     這時你會覺得有點煩,呵呵。那就選 dwarf-2選項吧,不用動它就可以了
DEBUG = dwarf-2

# 列出你的用#include 包含的.h頭文件的目錄.make 會在當前目錄或標準庫的目錄找不到時
# 到這個目錄在尋找 例: EXTRAINCDIRS = c:\m128\inc 如果是makefile當前目內的子目錄inc
# 那麼就直接寫 EXTRAINCDIRS = inc .如果有多個目錄,中間用空格隔開。都在一個目錄就不用寫
EXTRAINCDIRS = 

# 編譯標記,用來選標準C的級別,一般不用動
#     c89   = "ANSI" C
#     gnu89 = c89 plus GCC extensions
#     c99   = ISO C99 standard (還沒有完全完成)
#     gnu99 = c99 plus GCC extensions
CSTANDARD = -std=gnu99

# 在C語言源文件前面加上 -D or -U 選項(具體什麼意思我還沒有弄明白)
CDEFS = -DF_CPU=$(F_CPU)UL

# 這個和上面的說明一樣,不過是對於C++文件的
CPPDEFS = -DF_CPU=$(F_CPU)UL

#----------------------- C 編譯選項-------------------------------
#  -g*:          產生調試信息
#  -O*:          代碼優代級別
#  -f...:        用於改變內建一些默認的函數,具體的看avr-libc手冊
#  -Wall..:      警告的級別
#  -Wa,...:      告訴GCC 後面的選項不用管,把它傳給彙編選項.
#  -Wl,...:      和-Wa選項差不多,告訴GCC 傳遞後面的選項給liker鏈接器.
#  -a[cdhlmns=file]: 創建彙編列表文件,默認的一般選 -adhlns 
#  子選項如下: 
#  c 省略錯誤的條件 
#  d 省略調試的指令
#  h 包含最高層的源文件
#  l 包含彙編文件
#  m 包含宏的展開 
#  n 省略處理的框架(forms processing)(我不知是什麼意思) 
#  s 包含標號 
#  =file 設置生成的彙編列表文件的文件名,可以包含目錄名用"/"隔開. 

#-------------------------集合所有C編譯選項到變量 CFLAGS 中-------------------
#DUBUG選項
CFLAGS = -g$(DEBUG)

#CPU時鐘頻率
CFLAGS += $(CDEFS)

#優化級別
CFLAGS += -O$(OPT)

#把int 當成 8-bit integer,avr-libc並不真的支持,所以一般不要用.
#CFLAGS += -mint8

#在大於8K 單片機使用 rjmp/rcall (默認情況用jmp/call)
#CFLAGS += -mshort-calls

#這個選項會關掉自動內建的函數(但是可以在實際使用的函數前加上 __builtin_)
#當你使用這個參數時,void main() 不出現警告
#這個參數同時也會影響你的代碼的優化,使代碼增加。一般不使用就可以了。
#更多的說明請參考avr-libc說明。
#CFLAGS += -ffreestanding

#編譯器總認爲 char = unsigned char
CFLAGS += -funsigned-char

#當你定義一個位變量bit區時,總認爲它是unsigned bitfields, 所以定義 aa:4 = unsigned aa:4
CFLAGS += -funsigned-bitfields

#定義結構體的時候,使裏面的每一個元素的存儲空間都是連續,一個接一個存,中間沒有存儲間隔
CFLAGS += -fpack-struct

#定義枚舉類型的時候,使用裏面存儲空間最大的一個變量作爲整個枚舉變量的存儲空間
CFLAGS += -fshort-enums

#在製作執行文件前分析整個編譯單位。提供某些額外最佳化套用的機會,但會使用更多內存。
#這個參數我也不知是什麼意思。不用它吧。
#CPPFLAGS += -fno-unit-at-a-time

#很多警告的集合,具體參見GCC 手冊
CFLAGS += -Wall

#如果函數的聲明或定義沒有指出參數類型,編譯器就發出警告
CFLAGS += -Wstrict-prototypes

#如果使用未定義宏,則進行警告
CFLAGS += -Wundef

#對程序中沒有使用的代碼作出警告
#CFLAGS += -Wunreachable-code

#在有符號數和無符號數進行值比較時,有符號數可能在比較之前被轉換爲無符號數而導致結果錯誤
#CFLAGS += -Wsign-compare

#創建彙編列表文件, $(<:%.c=$(OBJDIR)/%.lst)的意思是把"<"表示的目標的
#所有.c文件換成.lst 文件,作爲輸出lst文件的文件名
CFLAGS += -Wa,-adhlns=$(<:%.c=$(OBJDIR)/%.lst)

#這句的意思是在$(EXTRAINCDIRS)定義目錄變量中,爲每一個用空格隔開的目錄前加上 -I
CFLAGS += $(patsubst %,-I%,$(EXTRAINCDIRS))

#標準C的級別
CFLAGS += $(CSTANDARD)

#--------------------------- C編譯選項 CFLAGS 結束---------------------------


#----------------下面是 C++ 的編譯選項(見C編譯選頂,不重複說了) -------------
#  -g*:          generate debugging information
#  -O*:          optimization level
#  -f...:        tuning, see GCC manual and avr-libc documentation
#  -Wall...:     warning level
#  -Wa,...:      tell GCC to pass this to the assembler.
#    -adhlns...: create assembler listing
CPPFLAGS = -g$(DEBUG)
CPPFLAGS += $(CPPDEFS)
CPPFLAGS += -O$(OPT)
#CPPFLAGS += -mint8
#CPPFLAGS += -mshort-calls
CPPFLAGS += -funsigned-char
CPPFLAGS += -funsigned-bitfields
CPPFLAGS += -fpack-struct
CPPFLAGS += -fshort-enums
CPPFLAGS += -fno-exceptions
#CPPFLAGS += -fno-unit-at-a-time
CPPFLAGS += -Wall
#CPPFLAGS += -Wstrict-prototypes
CPPFLAGS += -Wundef
#CPPFLAGS += -Wunreachable-code
#CPPFLAGS += -Wsign-compare
CPPFLAGS += -Wa,-adhlns=$(<:%.cpp=$(OBJDIR)/%.lst)
CPPFLAGS += $(patsubst %,-I%,$(EXTRAINCDIRS))
#CPPFLAGS += $(CSTANDARD)
#--------------------------- C++ 編譯選項 CFLAGS 結束-------------------------

#---------------- Assembler Options ----------------
#  -Wa,...:   告訴GCC 後面的選項不用管,把它傳給彙編選項..
#  -ahlms:    創建列表文件
#  -gstabs:   stabs debugging symbols for assembler source lines.
#             This enables avr-gdb to trace through assembler source files
#             當源文件中由C編譯產生的.s彙編文件時不要用這個選項,因爲
#             其已包含了合適的行信息。

#ASMFLAGS += -x assembler-with-cpp -Wa,-gdwarf2    #彙編文件由C產生時用            
ASFLAGS = -Wa,-adhlns=$(<:%.S=$(OBJDIR)/%.lst),-gstabs

#--------------------------------- 有關庫的選項-------------------------------
#  printf 函數最小的版本
PRINTF_LIB_MIN = -Wl,-u,vfprintf -lprintf_min

#  標準 printf 還加上 Floating point (requires MATH_LIB = -lm below)
PRINTF_LIB_FLOAT = -Wl,-u,vfprintf -lprintf_flt

# 如果PRINTF_LIB不寫爲空,那麼gcc-libc 就使用標準版的 printf 函數.
PRINTF_LIB = 
#PRINTF_LIB = $(PRINTF_LIB_MIN)
#PRINTF_LIB = $(PRINTF_LIB_FLOAT)

# 最小的 scanf 函數的版本
SCANF_LIB_MIN = -Wl,-u,vfscanf -lscanf_min

# Floating point + %[ scanf version (requires MATH_LIB = -lm below)
SCANF_LIB_FLOAT = -Wl,-u,vfscanf -lscanf_flt

# If this is left blank, then it will use the Standard scanf version.
SCANF_LIB = 
#SCANF_LIB = $(SCANF_LIB_MIN)
#SCANF_LIB = $(SCANF_LIB_FLOAT)

# -l[lib-name]  庫名去掉lib 和.a後綴 如 libm.a 則寫成 -lm 如下所示:
MATH_LIB = -lm

#----------------------外部存儲器選項 ---------------------------
#      關於--defsym 的說明
#      --defsym symbol=expr   #定義一個全局的標誌,用expr作爲symbol 的值.
#    -Tbss org    
#    -Tdata org
#    -Ttext org         

# 64 KB of external RAM, starting after internal RAM (ATmega128!),
# 64 KB的外部擴展的 RAM, 地址接在內部 RAM後面
# used for variables (.data/.bss) and heap (malloc()).
# 變量(.data/.bss)還有heap(malloc()),都使用這個區不用內部RAM 
# 前面加上0x800000 表示是RAM數據區,而不是程序區,因爲AVR 是哈弗結構
# EXTMEMOPTS = -Wl,-Tdata=0x801100,--defsym=__heap_end=0x80ffff

# 64 KB of external RAM, starting after internal RAM (ATmega128!),
# 外部RAM只用作 heap區,供malloc()分配的空間存儲,變量(.data/.bss)仍在內部RAM.
#EXTMEMOPTS = -Wl,--defsym=__heap_start=0x801100,--defsym=__heap_end=0x80ffff

EXTMEMOPTS = -Wl,--defsym=__heap_start=0x801100,--defsym=__heap_end=0x807fff

#顯示地註明堆棧最高地址,也就是棧頂地址,C語言堆棧是向下生長,一般定義在RAM的尾部
EXTMEMOPTS += -minit-stack=0x1100

#---------------- 鏈接選項 LDFLAGS----------------
#  -Wl,...:     告訴GCC 傳遞後面的選項給liker鏈接器.
#    -Map:      創建 map 文件
#    --cref:    把對照信息加到 map 文件中
LDFLAGS = -Wl,-Map=$(TARGET).map,--cref
LDFLAGS += $(EXTMEMOPTS)
LDFLAGS += $(PRINTF_LIB) $(SCANF_LIB) $(MATH_LIB)

#鏈接器使用linker_script.x腳本,avr-gcc自帶腳本存在 WinAVR\avr\lib\ldscripts下
#LDFLAGS += -T linker_script.x

#---------------- 編程下載選項 (avrdude) ----------------
# 用到少,我就不翻譯了,而且也很簡單。
# Programming hardware: alf avr910 avrisp bascom bsd 
# dt006 pavr picoweb pony-stk200 sp12 stk200 stk500
#
# Type: avrdude -c ?
# to get a full listing.
#
AVRDUDE_PROGRAMMER = stk500

# com1 = serial port. Use lpt1 to connect to parallel port.
AVRDUDE_PORT = com1    # programmer connected to serial device

AVRDUDE_WRITE_FLASH = -U flash:w:$(TARGET).hex
#AVRDUDE_WRITE_EEPROM = -U eeprom:w:$(TARGET).eep

# Uncomment the following if you want avrdude's erase cycle counter.
# Note that this counter needs to be initialized first using -Yn,
# see avrdude manual.
# AVRDUDE_ERASE_COUNTER = -y

# Uncomment the following if you do /not/ wish a verification to be
# performed after programming the device.
# AVRDUDE_NO_VERIFY = -V

# Increase verbosity level.  Please use this when submitting bug
# reports about avrdude. See <http://savannah.nongnu.org/projects/avrdude> 
# to submit bug reports.
# AVRDUDE_VERBOSE = -v -v

AVRDUDE_FLAGS = -p $(MCU) -P $(AVRDUDE_PORT) -c $(AVRDUDE_PROGRAMMER)
AVRDUDE_FLAGS += $(AVRDUDE_NO_VERIFY)
AVRDUDE_FLAGS += $(AVRDUDE_VERBOSE)
AVRDUDE_FLAGS += $(AVRDUDE_ERASE_COUNTER)

#---------------------調試選項--------------------

# For simulavr only - target MCU frequency.
# MCU 的頻率 (only for simulavr)
DEBUG_MFREQ = $(F_CPU)

# Set the DEBUG_UI to either gdb or insight.
# DEBUG_UI = gdb
DEBUG_UI = insight

# Set the debugging back-end to either avarice, simulavr.
DEBUG_BACKEND = avarice
#DEBUG_BACKEND = simulavr

# GDB Init Filename.
GDBINIT_FILE = __avr_gdbinit

# When using avarice settings for the JTAG
JTAG_DEV = /dev/com1

# Debugging port used to communicate between GDB / avarice / simulavr.
DEBUG_PORT = 4242

# Debugging host used to communicate between GDB / avarice / simulavr, normally
#     just set to localhost unless doing some sort of crazy debugging when 
#     avarice is running on a different computer.
DEBUG_HOST = localhost

#============================================================================

#---------------定義編譯軟件和命令的別名,便於移植--------------------
SHELL = sh
CC = avr-gcc
#----------------------複製和翻譯目標文件成其他的格式,如: elf -> ihex
OBJCOPY = avr-objcopy
#----------------------avr-objdump 顯示關於目標文件和彙編文件的一些信息
OBJDUMP = avr-objdump
SIZE = avr-size
#-----------------------avr-nm 從目標文件中列出所有標號
NM = avr-nm
AVRDUDE = avrdude
REMOVE = rm -f
#------------------------刪除目標及目錄內文件
REMOVEDIR = rm -rf
COPY = cp
WINSHELL = cmd

#-------------------定義一些用於編譯時顯示的信息-------------------
# English (英文)
MSG_ERRORS_NONE = Errors: none
MSG_BEGIN = -------- begin --------
MSG_END = --------  end  --------
MSG_SIZE_BEFORE = Size before: 
MSG_SIZE_AFTER = Size after:
MSG_COFF = Converting to AVR COFF:
MSG_EXTENDED_COFF = Converting to AVR Extended COFF:
MSG_FLASH = Creating load file for Flash:
MSG_EEPROM = Creating load file for EEPROM:
MSG_EXTENDED_LISTING = Creating Extended Listing:
MSG_SYMBOL_TABLE = Creating Symbol Table:
MSG_LINKING = Linking:
MSG_COMPILING = Compiling C:
MSG_COMPILING_CPP = Compiling C++:
MSG_ASSEMBLING = Assembling:
MSG_CLEANING = Cleaning project:
MSG_CREATING_LIBRARY = Creating library:

# 定義所有的目標文件.
OBJ = $(SRC:%.c=$(OBJDIR)/%.o) $(CPPSRC:%.cpp=$(OBJDIR)/%.o) $(ASRC:%.S=$(OBJDIR)/%.o) 

# 定義所有的 listing 文件.
LST = $(SRC:%.c=$(OBJDIR)/%.lst) $(CPPSRC:%.cpp=$(OBJDIR)/%.lst) $(ASRC:%.S=$(OBJDIR)/%.lst) 

# 編譯選項,用來生成所有的依賴文件. -MF 用於指定寫入的.d的文件名,-MMD 不包系統頭文件名 
GENDEPFLAGS = -MD -MP -MF .dep/$(@F).d

# 合併所有需要的flags 和可選項的 flags
# 並且把 MCU 型號加入到 flags 中.
ALL_CFLAGS = -mmcu=$(MCU) -I. $(CFLAGS) $(GENDEPFLAGS)
ALL_CPPFLAGS = -mmcu=$(MCU) -I. -x c++ $(CPPFLAGS) $(GENDEPFLAGS)
ALL_ASFLAGS = -mmcu=$(MCU) -I. -x assembler-with-cpp $(ASFLAGS)

# 默認的目標,也就是Makefile中出現的第一個目標.
all: begin gccversion sizebefore build sizeafter end

# 把編譯工程生成的 目標文件轉換成.HEX 文件或是 .a庫文件等等.默認不生成庫文件
build: elf hex eep lss sym
#build: lib

elf: $(TARGET).elf
hex: $(TARGET).hex
eep: $(TARGET).eep
lss: $(TARGET).lss
sym: $(TARGET).sym
LIBNAME=lib$(TARGET).a
lib: $(LIBNAME)

# Eye candy.
# AVR Studio 3.x 不會檢查 make 退出的代碼,但是卻依賴下面的字符串
# echo 是用來顯示的命令,和DOS中的命令不一樣,不是一個顯示開關。
begin:
@echo
@echo $(MSG_BEGIN)

end:
@echo $(MSG_END)
@echo

# 顯示各個文件的大小
HEXSIZE = $(SIZE) --target=$(FORMAT) $(TARGET).hex
ELFSIZE = $(SIZE) -A $(TARGET).elf
AVRMEM = avr-mem.sh $(TARGET).elf $(MCU)

sizebefore:
@if test -f $(TARGET).elf; then echo; echo $(MSG_SIZE_BEFORE); $(ELFSIZE); \
$(AVRMEM) 2>/dev/null; echo; fi

sizeafter:
@if test -f $(TARGET).elf; then echo; echo $(MSG_SIZE_AFTER); $(ELFSIZE); \
$(AVRMEM) 2>/dev/null; echo; fi

# 顯示avr-gcc的版本信息.
gccversion: 
@$(CC) --version

#下載程序到目標MCU  
program: $(TARGET).hex $(TARGET).eep
$(AVRDUDE) $(AVRDUDE_FLAGS) $(AVRDUDE_WRITE_FLASH) $(AVRDUDE_WRITE_EEPROM)

# 生成 avr-gdb 配置/初始化文件,主要按下面來做:
# 定義復位信號,加載目標文件,連接目標,把斷點設置在main()函數 
gdb-config: 
@$(REMOVE) $(GDBINIT_FILE)
@echo define reset >> $(GDBINIT_FILE)
@echo SIGNAL SIGHUP >> $(GDBINIT_FILE)
@echo end >> $(GDBINIT_FILE)
@echo file $(TARGET).elf >> $(GDBINIT_FILE)
@echo target remote $(DEBUG_HOST):$(DEBUG_PORT)  >> $(GDBINIT_FILE)
ifeq ($(DEBUG_BACKEND),simulavr)
@echo load  >> $(GDBINIT_FILE)
endif
@echo break main >> $(GDBINIT_FILE)

debug: gdb-config $(TARGET).elf
ifeq ($(DEBUG_BACKEND), avarice)
@echo Starting AVaRICE - Press enter when "waiting to connect" message displays.
@$(WINSHELL) /c start avarice --jtag $(JTAG_DEV) --erase --program --file \
$(TARGET).elf $(DEBUG_HOST):$(DEBUG_PORT)
@$(WINSHELL) /c pause

else
@$(WINSHELL) /c start simulavr --gdbserver --device $(MCU) --clock-freq \
$(DEBUG_MFREQ) --port $(DEBUG_PORT)
endif
@$(WINSHELL) /c start avr-$(DEBUG_UI) --command=$(GDBINIT_FILE)

# 把 ELF 文件轉換成 COFF 文件,供 AVR Studio 或 VMLAB 調試與仿真.
COFFCONVERT = $(OBJCOPY) --debugging
COFFCONVERT += --change-section-address .data-0x800000
COFFCONVERT += --change-section-address .bss-0x800000
COFFCONVERT += --change-section-address .noinit-0x800000
COFFCONVERT += --change-section-address .eeprom-0x810000

coff: $(TARGET).elf
@echo
@echo $(MSG_COFF) $(TARGET).cof
$(COFFCONVERT) -O coff-avr $< $(TARGET).cof

extcoff: $(TARGET).elf
@echo
@echo $(MSG_EXTENDED_COFF) $(TARGET).cof
$(COFFCONVERT) -O coff-ext-avr $< $(TARGET).cof

# 通過輸出的 ELF 文件創建最終的(.hex, .eep)文件.
%.hex: %.elf
@echo
@echo $(MSG_FLASH) $@
$(OBJCOPY) -O $(FORMAT) -R .eeprom $< $@

%.eep: %.elf
@echo
@echo $(MSG_EEPROM) $@
-$(OBJCOPY) -j .eeprom --set-section-flags=.eeprom="alloc,load" \
--change-section-lma .eeprom=0 -O $(FORMAT) $< $@

# 通過 ELF 文件創建擴展的列表文件.
%.lss: %.elf
@echo
@echo $(MSG_EXTENDED_LISTING) $@
$(OBJDUMP) -h -S $< > $@

# 通過 ELF 文件創建列表文件
%.sym: %.elf
@echo
@echo $(MSG_SYMBOL_TABLE) $@
$(NM) -n $< > $@

#.SECONDARY 和 .PRECIOUS 都表示保存產生的過程文件,不進行刪除
# 通過.o目標文件創建.a 庫文
.SECONDARY : $(TARGET).a
.PRECIOUS : $(OBJ)
%.a: $(OBJ)
@echo
@echo $(MSG_CREATING_LIBRARY) $@
$(AR) $@ $(OBJ)

# 鏈 接: 通過.o目標文件創建 ELF 文件
.SECONDARY : $(TARGET).elf
.PRECIOUS : $(OBJ)
%.elf: $(OBJ)
@echo
@echo $(MSG_LINKING) $@
$(CC) $(ALL_CFLAGS) $^ --output $@ $(LDFLAGS)

# 編 譯: 編譯 C 源文件創建 .o 目標文件
$(OBJDIR)/%.o : %.c
@echo
@echo $(MSG_COMPILING) $<
$(CC) -c $(ALL_CFLAGS) $< -o $@ 

# 編 譯: 編譯 C++ 源文件創建 .o 目標文件
$(OBJDIR)/%.o : %.cpp
@echo
@echo $(MSG_COMPILING_CPP) $<
$(CC) -c $(ALL_CPPFLAGS) $< -o $@ 

# 編 譯: 編譯 C 源文件創建 .s 彙編文件
%.s : %.c
$(CC) -S $(ALL_CFLAGS) $< -o $@

# 編 譯: 編譯 C++ 源文件創建 .s 彙編文件
%.s : %.cpp
$(CC) -S $(ALL_CPPFLAGS) $< -o $@

# 匯 編: 編譯 .S 彙編源文件創建 .o 目標文件(必須大寫"S"作後綴)
$(OBJDIR)/%.o : %.S
@echo
@echo $(MSG_ASSEMBLING) $<
$(CC) -c $(ALL_ASFLAGS) $< -o $@

# 只對源文件進行預處理,查看是源文件是否有錯
%.i : %.c
$(CC) -E -mmcu=$(MCU) -I. $(CFLAGS) $< -o $@ 

# 目 標: 清除整個工程,便於下次編譯
clean: begin clean_list end

clean_list :
@echo
@echo $(MSG_CLEANING)
$(REMOVE) $(TARGET).hex
$(REMOVE) $(TARGET).eep
$(REMOVE) $(TARGET).cof
$(REMOVE) $(TARGET).elf
$(REMOVE) $(TARGET).map
$(REMOVE) $(TARGET).sym
$(REMOVE) $(TARGET).lss
$(REMOVEDIR) $(OBJDIR)
$(REMOVE) $(SRC:.c=.s)
$(REMOVE) $(SRC:.c=.d)
$(REMOVEDIR) .dep

# 創建用於存目標文件的目錄 $(OBJDIR)
$(shell mkdir $(OBJDIR) 2>/dev/null)

# 包含依賴文件
-include $(shell mkdir .dep 2>/dev/null) $(wildcard .dep/*)

# 把所有的目標都定義成僞目標
.PHONY : all begin finish end sizebefore sizeafter gccversion \
build elf hex eep lss sym coff extcoff \
clean clean_list program debug gdb-config

發佈了28 篇原創文章 · 獲贊 9 · 訪問量 10萬+
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章