root / trunk / code / makefile_root.mk @ 1476
History | View | Annotate | Download (14 KB)
1 |
# This is makefile_root.mk |
---|---|
2 |
# |
3 |
################################### |
4 |
|
5 |
# Hey Emacs, this is a -*- makefile -*- |
6 |
#---------------------------------------------------------------------------- |
7 |
# WinAVR Makefile Template written by Eric B. Weddington, J?rg Wunsch, et al. |
8 |
# |
9 |
# Released to the Public Domain |
10 |
# |
11 |
# Additional material for this makefile was written by: |
12 |
# Peter Fleury |
13 |
# Tim Henigan |
14 |
# Colin O'Flynn |
15 |
# Reiner Patommel |
16 |
# Markus Pfaff |
17 |
# Sander Pool |
18 |
# Frederik Rouleau |
19 |
# |
20 |
#---------------------------------------------------------------------------- |
21 |
# On command line: |
22 |
# |
23 |
# make all = Make software. |
24 |
# |
25 |
# make clean = Clean out built project files. |
26 |
# |
27 |
# make coff = Convert ELF to AVR COFF. |
28 |
# |
29 |
# make extcoff = Convert ELF to AVR Extended COFF. |
30 |
# |
31 |
# make program = Download the hex file to the device, using avrdude. |
32 |
# Please customize the avrdude settings below first! |
33 |
# |
34 |
# make debug = Start either simulavr or avarice as specified for debugging, |
35 |
# with avr-gdb or avr-insight as the front end for debugging. |
36 |
# |
37 |
# make filename.s = Just compile filename.c into the assembler code only. |
38 |
# |
39 |
# make filename.i = Create a preprocessed source file for use in submitting |
40 |
# bug reports to the GCC project. |
41 |
# |
42 |
# To rebuild project do "make clean" then "make all". |
43 |
#---------------------------------------------------------------------------- |
44 |
|
45 |
#if you want your code to work on the Firefly++ and not Firefly+ |
46 |
#then add the -DFFPP line to CDEFS |
47 |
CDEFS = |
48 |
#-DFFPP |
49 |
|
50 |
# MCU name |
51 |
MCU = atmega128 |
52 |
|
53 |
# Processor frequency. |
54 |
# This will define a symbol, F_CPU, in all source code files equal to the |
55 |
# processor frequency. You can then use this symbol in your source code to |
56 |
# calculate timings. Do NOT tack on a 'UL' at the end, this will be done |
57 |
# automatically to create a 32-bit value in your source code. |
58 |
F_CPU = 8000000 |
59 |
|
60 |
# Output format. (can be srec, ihex, binary) |
61 |
FORMAT = ihex |
62 |
|
63 |
# List C source files here. (C dependencies are automatically generated.) |
64 |
SRC = $(wildcard *.c) |
65 |
|
66 |
# List Assembler source files here. |
67 |
# Make them always end in a capital .S. Files ending in a lowercase .s |
68 |
# will not be considered source files but generated files (assembler |
69 |
# output from the compiler), and will be deleted upon "make clean"! |
70 |
# Even though the DOS/Win* filesystem matches both .s and .S the same, |
71 |
# it will preserve the spelling of the filenames, and gcc itself does |
72 |
# care about how the name is spelled on its command-line. |
73 |
ASRC = |
74 |
|
75 |
# Optimization level, can be [0, 1, 2, 3, s]. |
76 |
# 0 = turn off optimization. s = optimize for size. |
77 |
# (Note: 3 is not always the best optimization level. See avr-libc FAQ.) |
78 |
OPT = s |
79 |
|
80 |
# Debugging format. |
81 |
# Native formats for AVR-GCC's -g are dwarf-2 [default] or stabs. |
82 |
# AVR Studio 4.10 requires dwarf-2. |
83 |
# AVR [Extended] COFF format requires stabs, plus an avr-objcopy run. |
84 |
DEBUG = |
85 |
|
86 |
# Compiler flag to set the C Standard level. |
87 |
# c89 = "ANSI" C |
88 |
# gnu89 = c89 plus GCC extensions |
89 |
# c99 = ISO C99 standard (not yet fully implemented) |
90 |
# gnu99 = c99 plus GCC extensions |
91 |
CSTANDARD = -std=gnu99 |
92 |
|
93 |
# Place -D or -U options here |
94 |
CDEFS += -DF_CPU=$(F_CPU)UL |
95 |
CDEFS += -DFFP |
96 |
# for wireless library |
97 |
ifdef USE_WIRELESS |
98 |
CDEFS += -DROBOT |
99 |
endif |
100 |
|
101 |
# Place -I, -L options here |
102 |
CINCS = -I$(COLONYROOT)/code/lib/include/libdragonfly |
103 |
CINCS += -L$(COLONYROOT)/code/lib/bin |
104 |
ifdef USE_WIRELESS |
105 |
CINCS += -I$(COLONYROOT)/code/lib/include/libwireless |
106 |
endif |
107 |
|
108 |
#---------------- Compiler Options ---------------- |
109 |
# -g*: generate debugging information |
110 |
# -O*: optimization level |
111 |
# -f...: tuning, see GCC manual and avr-libc documentation |
112 |
# -Wall...: warning level |
113 |
# -Wa,...: tell GCC to pass this to the assembler. |
114 |
# -adhlns...: create assembler listing |
115 |
CFLAGS = |
116 |
# CFLAGS = -g$(DEBUG) |
117 |
CFLAGS += $(CDEFS) $(CINCS) |
118 |
CFLAGS += -O$(OPT) |
119 |
CFLAGS += -funsigned-char -funsigned-bitfields -fpack-struct -fshort-enums |
120 |
CFLAGS += -Wall -Wstrict-prototypes |
121 |
CFLAGS += -Wa,-adhlns=$(<:.c=.lst) |
122 |
CFLAGS += $(CSTANDARD) |
123 |
|
124 |
#---------------- Assembler Options ---------------- |
125 |
# -Wa,...: tell GCC to pass this to the assembler. |
126 |
# -ahlms: create listing |
127 |
# -gstabs: have the assembler create line number information; note that |
128 |
# for use in COFF files, additional information about filenames |
129 |
# and function names needs to be present in the assembler source |
130 |
# files -- see avr-libc docs [FIXME: not yet described there] |
131 |
ASFLAGS = -Wa,-adhlns=$(<:.S=.lst),-gstabs |
132 |
|
133 |
|
134 |
#---------------- Library Options ---------------- |
135 |
# Minimalistic printf version |
136 |
PRINTF_LIB_MIN = -Wl,-u,vfprintf -lprintf_min |
137 |
|
138 |
# Floating point printf version (requires MATH_LIB = -lm below) |
139 |
PRINTF_LIB_FLOAT = -Wl,-u,vfprintf -lprintf_flt |
140 |
|
141 |
# If this is left blank, then it will use the Standard printf version. |
142 |
PRINTF_LIB = |
143 |
#PRINTF_LIB = $(PRINTF_LIB_MIN) |
144 |
#PRINTF_LIB = $(PRINTF_LIB_FLOAT) |
145 |
|
146 |
|
147 |
# Minimalistic scanf version |
148 |
SCANF_LIB_MIN = -Wl,-u,vfscanf -lscanf_min |
149 |
|
150 |
# Floating point + %[ scanf version (requires MATH_LIB = -lm below) |
151 |
SCANF_LIB_FLOAT = -Wl,-u,vfscanf -lscanf_flt |
152 |
|
153 |
# If this is left blank, then it will use the Standard scanf version. |
154 |
SCANF_LIB = |
155 |
#SCANF_LIB = $(SCANF_LIB_MIN) |
156 |
#SCANF_LIB = $(SCANF_LIB_FLOAT) |
157 |
|
158 |
MATH_LIB = -lm |
159 |
|
160 |
#---------------- External Memory Options ---------------- |
161 |
|
162 |
# 64 KB of external RAM, starting after internal RAM (ATmega128!), |
163 |
# used for variables (.data/.bss) and heap (malloc()). |
164 |
#EXTMEMOPTS = -Wl,-Tdata=0x801100,--defsym=__heap_end=0x80ffff |
165 |
|
166 |
# 64 KB of external RAM, starting after internal RAM (ATmega128!), |
167 |
# only used for heap (malloc()). |
168 |
#EXTMEMOPTS = -Wl,--defsym=__heap_start=0x801100,--defsym=__heap_end=0x80ffff |
169 |
|
170 |
EXTMEMOPTS = |
171 |
|
172 |
#---------------- Linker Options ---------------- |
173 |
# -Wl,...: tell GCC to pass this to linker. |
174 |
# -Map: create map file |
175 |
# --cref: add cross reference to map file |
176 |
LDFLAGS = -Wl,-Map=$(TARGET).map,--cref |
177 |
LDFLAGS += $(EXTMEMOPTS) |
178 |
LDFLAGS += $(PRINTF_LIB) $(SCANF_LIB) $(MATH_LIB) |
179 |
ifdef USE_WIRELESS |
180 |
LDFLAGS += -lwireless |
181 |
endif |
182 |
LDFLAGS += -ldragonfly |
183 |
|
184 |
|
185 |
|
186 |
#---------------- Programming Options (avrdude) ---------------- |
187 |
|
188 |
# Programming hardware: alf avr910 avrisp bascom bsd |
189 |
# dt006 pavr picoweb pony-stk200 sp12 stk200 stk500 |
190 |
# |
191 |
# Type: avrdude -c ? |
192 |
# to get a full listing. |
193 |
# |
194 |
AVRDUDE_PROGRAMMER = avrisp |
195 |
|
196 |
# programmer connected to serial device |
197 |
|
198 |
AVRDUDE_WRITE_FLASH = -b 57600 -U flash:w:$(TARGET).hex |
199 |
#AVRDUDE_WRITE_EEPROM = -U eeprom:w:$(TARGET).eep |
200 |
|
201 |
|
202 |
# Uncomment the following if you want avrdude's erase cycle counter. |
203 |
# Note that this counter needs to be initialized first using -Yn, |
204 |
# see avrdude manual. |
205 |
#AVRDUDE_ERASE_COUNTER = -y |
206 |
|
207 |
# Uncomment the following if you do /not/ wish a verification to be |
208 |
# performed after programming the device. |
209 |
#AVRDUDE_NO_VERIFY = -V |
210 |
|
211 |
# Increase verbosity level. Please use this when submitting bug |
212 |
# reports about avrdude. See <http://savannah.nongnu.org/projects/avrdude> |
213 |
# to submit bug reports. |
214 |
#AVRDUDE_VERBOSE = -v -v |
215 |
|
216 |
AVRDUDE_FLAGS = -p $(MCU) -P $(AVRDUDE_PORT) -c $(AVRDUDE_PROGRAMMER) |
217 |
AVRDUDE_FLAGS += $(AVRDUDE_NO_VERIFY) |
218 |
AVRDUDE_FLAGS += $(AVRDUDE_VERBOSE) |
219 |
AVRDUDE_FLAGS += $(AVRDUDE_ERASE_COUNTER) |
220 |
|
221 |
#don't check for device signature |
222 |
AVRDUDE_FLAGS += -F |
223 |
|
224 |
|
225 |
|
226 |
#---------------- Debugging Options ---------------- |
227 |
|
228 |
# For simulavr only - target MCU frequency. |
229 |
DEBUG_MFREQ = $(F_CPU) |
230 |
|
231 |
# Set the DEBUG_UI to either gdb or insight. |
232 |
# DEBUG_UI = gdb |
233 |
DEBUG_UI = insight |
234 |
|
235 |
# Set the debugging back-end to either avarice, simulavr. |
236 |
DEBUG_BACKEND = avarice |
237 |
#DEBUG_BACKEND = simulavr |
238 |
|
239 |
# GDB Init Filename. |
240 |
GDBINIT_FILE = __avr_gdbinit |
241 |
|
242 |
# When using avarice settings for the JTAG |
243 |
JTAG_DEV = /dev/com1 |
244 |
|
245 |
# Debugging port used to communicate between GDB / avarice / simulavr. |
246 |
DEBUG_PORT = 4242 |
247 |
|
248 |
# Debugging host used to communicate between GDB / avarice / simulavr, normally |
249 |
# just set to localhost unless doing some sort of crazy debugging when |
250 |
# avarice is running on a different computer. |
251 |
DEBUG_HOST = localhost |
252 |
|
253 |
|
254 |
|
255 |
#============================================================================ |
256 |
|
257 |
|
258 |
# Define programs and commands. |
259 |
SHELL = sh |
260 |
CC = avr-gcc |
261 |
OBJCOPY = avr-objcopy |
262 |
OBJDUMP = avr-objdump |
263 |
SIZE = avr-size |
264 |
NM = avr-nm |
265 |
AVRDUDE = avrdude |
266 |
REMOVE = rm -f |
267 |
REMOVEDIR = rm -rf |
268 |
COPY = cp |
269 |
WINSHELL = cmd |
270 |
|
271 |
|
272 |
# Define Messages |
273 |
# English |
274 |
MSG_ERRORS_NONE = Errors: none |
275 |
MSG_BEGIN = -------- begin -------- |
276 |
MSG_END = -------- end -------- |
277 |
MSG_SIZE_BEFORE = Size before: |
278 |
MSG_SIZE_AFTER = Size after: |
279 |
MSG_COFF = Converting to AVR COFF: |
280 |
MSG_EXTENDED_COFF = Converting to AVR Extended COFF: |
281 |
MSG_FLASH = Creating load file for Flash: |
282 |
MSG_EEPROM = Creating load file for EEPROM: |
283 |
MSG_EXTENDED_LISTING = Creating Extended Listing: |
284 |
MSG_SYMBOL_TABLE = Creating Symbol Table: |
285 |
MSG_LINKING = Linking: |
286 |
MSG_COMPILING = Compiling: |
287 |
MSG_ASSEMBLING = Assembling: |
288 |
MSG_CLEANING = Cleaning project: |
289 |
|
290 |
|
291 |
|
292 |
|
293 |
# Define all object files. |
294 |
OBJ = $(SRC:.c=.o) $(ASRC:.S=.o) |
295 |
|
296 |
# Define all listing files. |
297 |
LST = $(SRC:.c=.lst) $(ASRC:.S=.lst) |
298 |
|
299 |
|
300 |
# Compiler flags to generate dependency files. |
301 |
GENDEPFLAGS = -MD -MP -MF .dep/$(@F).d |
302 |
|
303 |
|
304 |
# Combine all necessary flags and optional flags. |
305 |
# Add target processor to flags. |
306 |
ALL_CFLAGS = -mmcu=$(MCU) -I. $(CFLAGS) $(GENDEPFLAGS) |
307 |
ALL_ASFLAGS = -mmcu=$(MCU) -I. -x assembler-with-cpp $(ASFLAGS) |
308 |
|
309 |
|
310 |
|
311 |
|
312 |
|
313 |
# Default target. |
314 |
all: begin gccversion sizebefore build sizeafter checksize end |
315 |
|
316 |
build: elf hex eep lss sym |
317 |
|
318 |
elf: $(TARGET).elf |
319 |
hex: $(TARGET).hex |
320 |
eep: $(TARGET).eep |
321 |
lss: $(TARGET).lss |
322 |
sym: $(TARGET).sym |
323 |
|
324 |
|
325 |
|
326 |
# Eye candy. |
327 |
# AVR Studio 3.x does not check make's exit code but relies on |
328 |
# the following magic strings to be generated by the compile job. |
329 |
begin: |
330 |
@echo |
331 |
@echo $(MSG_BEGIN) |
332 |
|
333 |
end: |
334 |
@echo $(MSG_END) |
335 |
@echo |
336 |
|
337 |
|
338 |
# Display size of file. |
339 |
HEXSIZE = $(SIZE) --target=$(FORMAT) $(TARGET).hex |
340 |
ELFSIZE = $(SIZE) -A $(TARGET).elf |
341 |
AVRMEM = avr-mem.sh $(TARGET).elf $(MCU) |
342 |
|
343 |
# check RAM size (make sure under 4 kB) |
344 |
AWK = $(shell if uname -s |grep -i w32 >/dev/null; then echo 'gawk'; else echo 'awk'; fi) |
345 |
DATASIZE = avr-size -A main.elf | grep 'data' | $(AWK) '{ print $$2 }' > 1.tmp |
346 |
BSSSIZE = avr-size -A main.elf | grep 'bss' | $(AWK) '{ print $$2 }' > 2.tmp |
347 |
ADD = expr `cat 1.tmp` + `cat 2.tmp` > 3.tmp |
348 |
CLEANSIZE = rm 1.tmp 2.tmp 3.tmp |
349 |
checksize: |
350 |
@$(DATASIZE) |
351 |
@$(BSSSIZE) |
352 |
@$(ADD) |
353 |
@if test `cat 3.tmp` -gt 4096; \ |
354 |
then echo "RAM size exceeded. Make .data or .bss smaller.";echo;exit 1; \ |
355 |
else echo ".data and .bss size fine";echo; fi |
356 |
@$(CLEANSIZE) |
357 |
|
358 |
sizebefore: |
359 |
@if test -f $(TARGET).elf; then echo; echo $(MSG_SIZE_BEFORE); $(ELFSIZE); \ |
360 |
$(AVRMEM) 2>/dev/null; echo; fi |
361 |
|
362 |
sizeafter: |
363 |
@if test -f $(TARGET).elf; then echo; echo $(MSG_SIZE_AFTER); $(ELFSIZE); \ |
364 |
$(AVRMEM) 2>/dev/null; echo; fi |
365 |
|
366 |
|
367 |
|
368 |
# Display compiler version information. |
369 |
gccversion : |
370 |
@$(CC) --version |
371 |
|
372 |
|
373 |
|
374 |
# Program the device. |
375 |
program: $(TARGET).hex $(TARGET).eep |
376 |
$(AVRDUDE) $(AVRDUDE_FLAGS) $(AVRDUDE_WRITE_FLASH) $(AVRDUDE_WRITE_EEPROM) |
377 |
|
378 |
|
379 |
# Generate avr-gdb config/init file which does the following: |
380 |
# define the reset signal, load the target file, connect to target, and set |
381 |
# a breakpoint at main(). |
382 |
gdb-config: |
383 |
@$(REMOVE) $(GDBINIT_FILE) |
384 |
@echo define reset >> $(GDBINIT_FILE) |
385 |
@echo SIGNAL SIGHUP >> $(GDBINIT_FILE) |
386 |
@echo end >> $(GDBINIT_FILE) |
387 |
@echo file $(TARGET).elf >> $(GDBINIT_FILE) |
388 |
@echo target remote $(DEBUG_HOST):$(DEBUG_PORT) >> $(GDBINIT_FILE) |
389 |
ifeq ($(DEBUG_BACKEND),simulavr) |
390 |
@echo load >> $(GDBINIT_FILE) |
391 |
endif |
392 |
@echo break main >> $(GDBINIT_FILE) |
393 |
|
394 |
debug: gdb-config $(TARGET).elf |
395 |
ifeq ($(DEBUG_BACKEND), avarice) |
396 |
@echo Starting AVaRICE - Press enter when "waiting to connect" message displays. |
397 |
@$(WINSHELL) /c start avarice --jtag $(JTAG_DEV) --erase --program --file \ |
398 |
$(TARGET).elf $(DEBUG_HOST):$(DEBUG_PORT) |
399 |
@$(WINSHELL) /c pause |
400 |
|
401 |
else |
402 |
@$(WINSHELL) /c start simulavr --gdbserver --device $(MCU) --clock-freq \ |
403 |
$(DEBUG_MFREQ) --port $(DEBUG_PORT) |
404 |
endif |
405 |
@$(WINSHELL) /c start avr-$(DEBUG_UI) --command=$(GDBINIT_FILE) |
406 |
|
407 |
|
408 |
|
409 |
|
410 |
# Convert ELF to COFF for use in debugging / simulating in AVR Studio or VMLAB. |
411 |
COFFCONVERT=$(OBJCOPY) --debugging \ |
412 |
--change-section-address .data-0x800000 \ |
413 |
--change-section-address .bss-0x800000 \ |
414 |
--change-section-address .noinit-0x800000 \ |
415 |
--change-section-address .eeprom-0x810000 |
416 |
|
417 |
|
418 |
coff: $(TARGET).elf |
419 |
@echo |
420 |
@echo $(MSG_COFF) $(TARGET).cof |
421 |
$(COFFCONVERT) -O coff-avr $< $(TARGET).cof |
422 |
|
423 |
|
424 |
extcoff: $(TARGET).elf |
425 |
@echo |
426 |
@echo $(MSG_EXTENDED_COFF) $(TARGET).cof |
427 |
$(COFFCONVERT) -O coff-ext-avr $< $(TARGET).cof |
428 |
|
429 |
|
430 |
|
431 |
# Create final output files (.hex, .eep) from ELF output file. |
432 |
%.hex: %.elf |
433 |
@echo |
434 |
@echo $(MSG_FLASH) $@ |
435 |
$(OBJCOPY) -O $(FORMAT) -R .eeprom $< $@ |
436 |
|
437 |
%.eep: %.elf |
438 |
@echo |
439 |
@echo $(MSG_EEPROM) $@ |
440 |
-$(OBJCOPY) -j .eeprom --set-section-flags=.eeprom="alloc,load" \ |
441 |
--change-section-lma .eeprom=0 -O $(FORMAT) $< $@ |
442 |
|
443 |
# Create extended listing file from ELF output file. |
444 |
%.lss: %.elf |
445 |
@echo |
446 |
@echo $(MSG_EXTENDED_LISTING) $@ |
447 |
$(OBJDUMP) -h -S $< > $@ |
448 |
|
449 |
# Create a symbol table from ELF output file. |
450 |
%.sym: %.elf |
451 |
@echo |
452 |
@echo $(MSG_SYMBOL_TABLE) $@ |
453 |
$(NM) -n $< > $@ |
454 |
|
455 |
|
456 |
|
457 |
# Link: create ELF output file from object files. |
458 |
.SECONDARY : $(TARGET).elf |
459 |
.PRECIOUS : $(OBJ) |
460 |
%.elf: $(OBJ) |
461 |
@echo |
462 |
@echo $(MSG_LINKING) $@ |
463 |
$(CC) $(ALL_CFLAGS) $^ --output $@ $(LDFLAGS) |
464 |
|
465 |
|
466 |
# Compile: create object files from C source files. |
467 |
%.o : %.c |
468 |
@echo |
469 |
@echo $(MSG_COMPILING) $< |
470 |
$(CC) -c $(ALL_CFLAGS) $< -o $@ |
471 |
|
472 |
|
473 |
# Compile: create assembler files from C source files. |
474 |
%.s : %.c |
475 |
$(CC) -S $(ALL_CFLAGS) $< -o $@ |
476 |
|
477 |
|
478 |
# Assemble: create object files from assembler source files. |
479 |
%.o : %.S |
480 |
@echo |
481 |
@echo $(MSG_ASSEMBLING) $< |
482 |
$(CC) -c $(ALL_ASFLAGS) $< -o $@ |
483 |
|
484 |
# Create preprocessed source for use in sending a bug report. |
485 |
%.i : %.c |
486 |
$(CC) -E -mmcu=$(MCU) -I. $(CFLAGS) $< -o $@ |
487 |
|
488 |
|
489 |
# Target: clean project. |
490 |
clean: begin clean_list end |
491 |
|
492 |
clean_list : |
493 |
@echo |
494 |
@echo $(MSG_CLEANING) |
495 |
$(REMOVE) $(TARGET).hex |
496 |
$(REMOVE) $(TARGET).eep |
497 |
$(REMOVE) $(TARGET).cof |
498 |
$(REMOVE) $(TARGET).elf |
499 |
$(REMOVE) $(TARGET).map |
500 |
$(REMOVE) $(TARGET).sym |
501 |
$(REMOVE) $(TARGET).lss |
502 |
$(REMOVE) $(OBJ) |
503 |
$(REMOVE) $(LST) |
504 |
$(REMOVE) $(SRC:.c=.s) |
505 |
$(REMOVE) $(SRC:.c=.d) |
506 |
$(REMOVEDIR) .dep |
507 |
|
508 |
|
509 |
|
510 |
# Include the dependency files. |
511 |
-include $(shell mkdir .dep 2>/dev/null) $(wildcard .dep/*) |
512 |
|
513 |
|
514 |
# Listing of phony targets. |
515 |
.PHONY : all begin finish end sizebefore sizeafter gccversion \ |
516 |
build elf hex eep lss sym coff extcoff \ |
517 |
clean clean_list program debug gdb-config |
518 |
|