microcontrollers:avr_makefile_template
Table of Contents
AVR Makefile template
Pat Deegan
This is a copy of Pat Deegan's AVR makefile template that is mentioned in Pat's article on AVR Project Organization.
I am reproducing this here in case this resource become unavailable in the future.
One unresolved question I have regarding the template is the use of the -g switch in the CFLAGS. The avr-gcc documentation says that this creates stuff needed for debugging—but what I wonder is how much this bloats the generated code. In other words, should this switch be eliminated for release builds, or does the bloat get removed by other tools along the way?
- Makefile.tpl
######### AVR Project Makefile Template ######### ###### ###### ###### Copyright (C) 2003-2005,Pat Deegan, ###### ###### Psychogenic Inc ###### ###### All Rights Reserved ###### ###### ###### ###### You are free to use this code as part ###### ###### of your own applications provided ###### ###### you keep this copyright notice intact ###### ###### and acknowledge its authorship with ###### ###### the words: ###### ###### ###### ###### "Contains software by Pat Deegan of ###### ###### Psychogenic Inc (www.psychogenic.com)" ###### ###### ###### ###### If you use it as part of a web site ###### ###### please include a link to our site, ###### ###### http://electrons.psychogenic.com or ###### ###### http://www.psychogenic.com ###### ###### ###### #################################################### ##### This Makefile will make compiling Atmel AVR ##### micro controller projects simple with Linux ##### or other Unix workstations and the AVR-GCC ##### tools. ##### ##### It supports C, C++ and Assembly source files. ##### ##### Customize the values as indicated below and : ##### make ##### make disasm ##### make stats ##### make hex ##### make writeflash ##### make gdbinit ##### or make clean ##### ##### See the http://electrons.psychogenic.com/ ##### website for detailed instructions #################################################### ##### ##### ##### Configuration ##### ##### ##### ##### Customize the values in this section for ##### ##### your project. MCU, PROJECTNAME and ##### ##### PRJSRC must be setup for all projects, ##### ##### the remaining variables are only ##### ##### relevant to those needing additional ##### ##### include dirs or libraries and those ##### ##### who wish to use the avrdude programmer ##### ##### ##### ##### See http://electrons.psychogenic.com/ ##### ##### for further details. ##### ##### ##### #################################################### ##### Target Specific Details ##### ##### Customize these for your project ##### # Name of target controller # (e.g. 'at90s8515', see the available avr-gcc mmcu # options for possible values) MCU=atmega8 # id to use with programmer # default: PROGRAMMER_MCU=$(MCU) # In case the programer used, e.g avrdude, doesn't # accept the same MCU name as avr-gcc (for example # for ATmega8s, avr-gcc expects 'atmega8' and # avrdude requires 'm8') PROGRAMMER_MCU=m8 # Name of our project # (use a single word, e.g. 'myproject') PROJECTNAME=myproject # Source files # List C/C++/Assembly source files: # (list all files to compile, e.g. 'a.c b.cpp as.S'): # Use .cc, .cpp or .C suffix for C++ files, use .S # (NOT .s !!!) for assembly source code files. PRJSRC=main.c myclass.cpp lowlevelstuff.S # additional includes (e.g. -I/path/to/mydir) INC=-I/path/to/include # libraries to link in (e.g. -lmylib) LIBS= # Optimization level, # use s (size opt), 1, 2, 3 or 0 (off) OPTLEVEL=s ##### AVR Dude 'writeflash' options ##### ##### If you are using the avrdude program ##### (http://www.bsdhome.com/avrdude/) to write ##### to the MCU, you can set the following config ##### options and use 'make writeflash' to program ##### the device. # programmer id--check the avrdude for complete list # of available opts. These should include stk500, # avr910, avrisp, bsd, pony and more. Set this to # one of the valid "-c PROGRAMMER-ID" values # described in the avrdude info page. # AVRDUDE_PROGRAMMERID=stk500 # port--serial or parallel port to which your # hardware programmer is attached # AVRDUDE_PORT=/dev/ttyS1 #################################################### ##### Config Done ##### ##### ##### ##### You shouldn't need to edit anything ##### ##### below to use the makefile but may wish ##### ##### to override a few of the flags ##### ##### nonetheless ##### ##### ##### #################################################### ##### Flags #### # HEXFORMAT -- format for .hex file output HEXFORMAT=ihex # compiler CFLAGS=-I. $(INC) -g -mmcu=$(MCU) -O$(OPTLEVEL) \ -fpack-struct -fshort-enums \ -funsigned-bitfields -funsigned-char \ -Wall -Wstrict-prototypes \ -Wa,-ahlms=$(firstword \ $(filter %.lst, $(<:.c=.lst))) # c++ specific flags CPPFLAGS=-fno-exceptions \ -Wa,-ahlms=$(firstword \ $(filter %.lst, $(<:.cpp=.lst))\ $(filter %.lst, $(<:.cc=.lst)) \ $(filter %.lst, $(<:.C=.lst))) # assembler ASMFLAGS =-I. $(INC) -mmcu=$(MCU) \ -x assembler-with-cpp \ -Wa,-gstabs,-ahlms=$(firstword \ $(<:.S=.lst) $(<.s=.lst)) # linker LDFLAGS=-Wl,-Map,$(TRG).map -mmcu=$(MCU) \ -lm $(LIBS) ##### executables #### CC=avr-gcc OBJCOPY=avr-objcopy OBJDUMP=avr-objdump SIZE=avr-size AVRDUDE=avrdude REMOVE=rm -f ##### automatic target names #### TRG=$(PROJECTNAME).out DUMPTRG=$(PROJECTNAME).s HEXROMTRG=$(PROJECTNAME).hex HEXTRG=$(HEXROMTRG) $(PROJECTNAME).ee.hex GDBINITFILE=gdbinit-$(PROJECTNAME) # Define all object files. # Start by splitting source files by type # C++ CPPFILES=$(filter %.cpp, $(PRJSRC)) CCFILES=$(filter %.cc, $(PRJSRC)) BIGCFILES=$(filter %.C, $(PRJSRC)) # C CFILES=$(filter %.c, $(PRJSRC)) # Assembly ASMFILES=$(filter %.S, $(PRJSRC)) # List all object files we need to create OBJDEPS=$(CFILES:.c=.o) \ $(CPPFILES:.cpp=.o)\ $(BIGCFILES:.C=.o) \ $(CCFILES:.cc=.o) \ $(ASMFILES:.S=.o) # Define all lst files. LST=$(filter %.lst, $(OBJDEPS:.o=.lst)) # All the possible generated assembly # files (.s files) GENASMFILES=$(filter %.s, $(OBJDEPS:.o=.s)) .SUFFIXES : .c .cc .cpp .C .o .out .s .S \ .hex .ee.hex .h .hh .hpp .PHONY: writeflash clean stats gdbinit stats # Make targets: # all, disasm, stats, hex, writeflash/install, clean all: $(TRG) disasm: $(DUMPTRG) stats stats: $(TRG) $(OBJDUMP) -h $(TRG) $(SIZE) $(TRG) hex: $(HEXTRG) writeflash: hex $(AVRDUDE) -c $(AVRDUDE_PROGRAMMERID) \ -p $(PROGRAMMER_MCU) -P $(AVRDUDE_PORT) -e \ -U flash:w:$(HEXROMTRG) install: writeflash $(DUMPTRG): $(TRG) $(OBJDUMP) -S $< > $@ $(TRG): $(OBJDEPS) $(CC) $(LDFLAGS) -o $(TRG) $(OBJDEPS) #### Generating assembly #### # asm from C %.s: %.c $(CC) -S $(CFLAGS) $< -o $@ # asm from (hand coded) asm %.s: %.S $(CC) -S $(ASMFLAGS) $< > $@ # asm from C++ .cpp.s .cc.s .C.s : $(CC) -S $(CFLAGS) $(CPPFLAGS) $< -o $@ #### Generating object files #### # object from C .c.o: $(CC) $(CFLAGS) -c $< -o $@ # object from C++ (.cc, .cpp, .C files) .cc.o .cpp.o .C.o : $(CC) $(CFLAGS) $(CPPFLAGS) -c $< -o $@ # object from asm .S.o : $(CC) $(ASMFLAGS) -c $< -o $@ #### Generating hex files #### # hex files from elf ##### Generating a gdb initialisation file ##### .out.hex: $(OBJCOPY) -j .text \ -j .data \ -O $(HEXFORMAT) $< $@ .out.ee.hex: $(OBJCOPY) -j .eeprom \ --change-section-lma .eeprom=0 \ -O $(HEXFORMAT) $< $@ ##### Generating a gdb initialisation file ##### ##### Use by launching simulavr and avr-gdb: ##### ##### avr-gdb -x gdbinit-myproject ##### gdbinit: $(GDBINITFILE) $(GDBINITFILE): $(TRG) @echo "file $(TRG)" > $(GDBINITFILE) @echo "target remote localhost:1212" \ >> $(GDBINITFILE) @echo "load" >> $(GDBINITFILE) @echo "break main" >> $(GDBINITFILE) @echo "continue" >> $(GDBINITFILE) @echo @echo "Use 'avr-gdb -x $(GDBINITFILE)'" #### Cleanup #### clean: $(REMOVE) $(TRG) $(TRG).map $(DUMPTRG) $(REMOVE) $(OBJDEPS) $(REMOVE) $(LST) $(GDBINITFILE) $(REMOVE) $(GENASMFILES) $(REMOVE) $(HEXTRG) ##### EOF #####
Hookers and Booze
A variant of Pat Deegan's file is used by Hookers and Booze, reproduced here in case it becomes unavailable in the future. It too uses the -g swtich. Actually, this variant appears to be closer to the avr-libc makefile template.
- Makefile.tpl
PRG = uart_hello OBJ = main.o PROGRAMMER = avrispmkII PORT = usb MCU_TARGET = atmega328p AVRDUDE_TARGET = atmega328p OPTIMIZE = -Os DEFS = LIBS = HZ = 16000000 # You should not have to change anything below here. CC = avr-gcc # Override is only needed by avr-lib build system. override CFLAGS = -g -DF_CPU=$(HZ) -Wall $(OPTIMIZE) -mmcu=$(MCU_TARGET) $(DEFS) override LDFLAGS = -Wl,-Map,$(PRG).map OBJCOPY = avr-objcopy OBJDUMP = avr-objdump all: $(PRG).elf lst text #eeprom $(PRG).elf: $(OBJ) $(CC) $(CFLAGS) $(LDFLAGS) -o $@ $^ $(LIBS) clean: rm -rf *.o $(PRG).elf *.eps *.png *.pdf *.bak *.hex *.bin *.srec rm -rf *.lst *.map $(EXTRA_CLEAN_FILES) lst: $(PRG).lst %.lst: %.elf $(OBJDUMP) -h -S $< > $@ # Rules for building the .text rom images text: hex bin srec hex: $(PRG).hex bin: $(PRG).bin srec: $(PRG).srec %.hex: %.elf $(OBJCOPY) -j .text -j .data -O ihex $< $@ %.srec: %.elf $(OBJCOPY) -j .text -j .data -O srec $< $@ %.bin: %.elf $(OBJCOPY) -j .text -j .data -O binary $< $@ # Rules for building the .eeprom rom images eeprom: ehex ebin esrec ehex: $(PRG)_eeprom.hex #ebin: $(PRG)_eeprom.bin esrec: $(PRG)_eeprom.srec %_eeprom.hex: %.elf $(OBJCOPY) -j .eeprom --change-section-lma .eeprom=0 -O ihex $< $@ #%_eeprom.srec: %.elf # $(OBJCOPY) -j .eeprom --change-section-lma .eeprom=0 -O srec $< $@ %_eeprom.bin: %.elf $(OBJCOPY) -j .eeprom --change-section-lma .eeprom=0 -O binary $< $@ # command to program chip (invoked by running "make install") install: $(PRG).hex avrdude -p $(AVRDUDE_TARGET) -c $(PROGRAMMER) -P $(PORT) -v \ -U flash:w:$(PRG).hex fuse: avrdude -p $(AVRDUDE_TARGET) -c $(PROGRAMMER) -P $(PORT) -v \ -U lfuse:w:0xc6:m -U hfuse:w:0xd9:m ddd: gdbinit ddd --debugger "avr-gdb -x $(GDBINITFILE)" gdbserver: gdbinit simulavr --device $(MCU_TARGET) --gdbserver gdbinit: $(GDBINITFILE) $(GDBINITFILE): $(PRG).hex @echo "file $(PRG).elf" > $(GDBINITFILE) @echo "target remote localhost:1212" >> $(GDBINITFILE) @echo "load" >> $(GDBINITFILE) @echo "break main" >> $(GDBINITFILE) @echo @echo "Use 'avr-gdb -x $(GDBINITFILE)'"
microcontrollers/avr_makefile_template.txt · Last modified: 2012/01/15 12:36 by mithat