Fix doxygen warning.
[bertos.git] / rules.mk
1 #
2 # $Id$
3 # Copyright 2002,2003,2004,2005,2006 Develer S.r.l. (http://www.develer.com/)
4 # All rights reserved.
5 #
6 # Based on:
7 #   GCC-AVR standard Makefile part 2
8 #   Volker Oth 1/2000
9 #
10 # Author: Bernardo Innocenti <bernie@develer.com>
11 #
12
13 # Remove all default pattern rules
14 .SUFFIXES:
15
16 # Verbosity
17 ifeq ($(V),1)
18 # Verbose build
19 Q :=
20 L := @echo >/dev/null
21 else
22 # Quiet build
23 Q := @
24 L := @echo
25 endif
26
27 # Select Bourne Again SHell as default make shell
28 SHELL := bash
29
30 # Checker build
31 ifeq ($(C),1)
32 CC = $(CHECKER)
33 CFLAGS += -Wundef -D__x86_64__=1 -D__unix__=1 -D__linux__=1 -D__STDC_VERSION__=199901L
34 endif
35
36 # Initialize $(top_srcdir) with current directory, unless it was already initialized
37 top_srcdir ?= $(shell pwd)
38
39 # Products
40 TRG_ELF = $(TRG:%=$(OUTDIR)/%.elf)
41 TRG_S19 = $(TRG:%=$(OUTDIR)/%.s19)
42 TRG_HEX = $(TRG:%=$(OUTDIR)/%.hex)
43 TRG_BIN = $(TRG:%=$(OUTDIR)/%.bin)
44 TRG_ROM = $(TRG:%=$(OUTDIR)/%.rom)
45 TRG_COF = $(TRG:%=$(OUTDIR)/%.cof)
46 TRG_EXE = $(TRG:%=$(OUTDIR)/%)
47
48
49 RECURSIVE_TARGETS = all-recursive install-recursive clean-recursive
50
51 # The default target
52 .PHONY: all
53 ifeq ($(EMBEDDED_TARGET),1)
54 all:: all-recursive $(TRG_S19) $(TRG_HEX) $(TRG_BIN)
55 else
56 all:: all-recursive $(TRG_EXE)
57 endif
58
59 # Generate project documentation
60 .PHONY: docs
61 docs:
62         $Q $(DOXYGEN)
63
64 define build_target
65
66 ifneq ($$(strip $$($(1)_MCU)),)
67 # Define all project specific object files
68 $(1)_CFLAGS    += -mmcu=$$($(1)_MCU)
69 $(1)_CXXFLAGS  += -mmcu=$$($(1)_MCU)
70 $(1)_ASFLAGS   += -mmcu=$$($(1)_MCU)
71 $(1)_CPPAFLAGS += -mmcu=$$($(1)_MCU)
72 $(1)_LDFLAGS   += -mmcu=$$($(1)_MCU)
73 endif
74 ifneq ($$(strip $$($(1)_CPU)),)
75 # Define all project specific object files
76 $(1)_CFLAGS    += -mcpu=$$($(1)_CPU)
77 $(1)_CXXFLAGS  += -mcpu=$$($(1)_CPU)
78 $(1)_ASFLAGS   += -mcpu=$$($(1)_CPU)
79 $(1)_CPPAFLAGS += -mcpu=$$($(1)_CPU)
80 $(1)_LDFLAGS   += -mcpu=$$($(1)_CPU)
81 endif
82 ifneq ($$(strip $$($(1)_LDSCRIPT)),)
83 $(1)_LDFLAGS += -Wl,-T$$($(1)_LDSCRIPT)
84 endif
85
86 $(1)_CC      = $$($(1)_CROSS)$$(CC)
87 $(1)_CXX     = $$($(1)_CROSS)$$(CXX)
88 $(1)_AS      = $$($(1)_CROSS)$$(AS)
89 $(1)_OBJCOPY = $$($(1)_CROSS)$$(OBJCOPY)
90
91 $(1)_COBJ    = $$(foreach file,$$($(1)_CSRC:%.c=%.o),$$(OBJDIR)/$(1)/$$(file))
92 $(1)_CXXOBJ  = $$(foreach file,$$($(1)_CXXSRC:%.cpp=%.o),$$(OBJDIR)/$(1)/$$(file))
93 $(1)_PCOBJ   = $$(foreach file,$$($(1)_PCSRC:%.c=%_P.o),$$(OBJDIR)/$(1)/$$(file))
94 $(1)_AOBJ    = $$(foreach file,$$($(1)_ASRC:%.s=%.o),$$(OBJDIR)/$(1)/$$(file))
95 $(1)_CPPAOBJ = $$(foreach file,$$($(1)_CPPASRC:%.S=%.o),$$(OBJDIR)/$(1)/$$(file))
96 $(1)_OBJ    := $$($(1)_COBJ) $$($(1)_CXXOBJ) $$($(1)_PCOBJ) $$($(1)_AOBJ) $$($(1)_CPPAOBJ)
97 $(1)_SRC    := $$($(1)_CSRC) $$($(1)_CXXSRC) $$($(1)_PCSRC) $$($(1)_ASRC) $$($(1)_CPPASRC)
98 OBJ         += $$($(1)_OBJ)
99
100 ifneq ($$(strip $$($(1)_CXXSRC)),)
101 $(1)_LD = $$($(1)_CROSS)$$(LDXX)
102 else
103 $(1)_LD = $$($(1)_CROSS)$$(LD)
104 endif
105
106 # Compile: instructions to create assembler and/or object files from C source
107 $$($(1)_COBJ) : $$(OBJDIR)/$(1)/%.o : %.c
108         $L "$(1): Compiling $$< (C)"
109         @$$(MKDIR_P) $$(dir $$@)
110         $Q $$($(1)_CC) -c $$(CFLAGS) $$($(1)_CFLAGS) $$($(1)_CPPFLAGS) $$(CPPFLAGS) $$< -o $$@
111
112 # Compile: instructions to create assembler and/or object files from C++ source
113 $$($(1)_CXXOBJ) : $$(OBJDIR)/$(1)/%.o : %.cpp
114         $L "$(1): Compiling $$< (C++)"
115         @$$(MKDIR_P) $$(dir $$@)
116         $Q $$($(1)_CXX) -c $$(CXXFLAGS) $$($(1)_CXXFLAGS) $$($(1)_CPPFLAGS) $$(CPPFLAGS) $$< -o $$@
117
118 # Generate assembly sources from C files (debug)
119 $$(OBJDIR)/$(1)/%.s : %.c
120         $L "$(1): Generating asm source $$<"
121         @$$(MKDIR_P) $$(dir $$@)
122         $Q $$($(1)_CC) -S $$(CFLAGS) $$($(1)_CFLAGS) $$($(1)_CPPFLAGS) $$< -o $$@
123
124 # Generate special progmem variant of a source file
125 $$($(1)_PCOBJ) : $$(OBJDIR)/$(1)/%_P.o : %.c
126         $L "$(1): Compiling $$< (PROGMEM)"
127         @$$(MKDIR_P) $$(dir $$@)
128         $Q $$($(1)_CC) -c -D_PROGMEM $$(CFLAGS) $$($(1)_CFLAGS) $$($(1)_CPPFLAGS) $$(CPPFLAGS) $$< -o $$@
129
130 # Assemble: instructions to create object file from assembler files
131 $$($(1)_AOBJ): $$(OBJDIR)/$(1)/%.o : %.s
132         $L "$(1): Assembling $$<"
133         @$$(MKDIR_P) $$(dir $$@)
134         $Q $$($(1)_AS) -c $$(ASFLAGS) $$($(1)_ASFLAGS) $$< -o $$@
135
136 $$($(1)_CPPAOBJ): $$(OBJDIR)/$(1)/%.o : %.S
137         $L "$(1): Assembling with CPP $$<"
138         @$$(MKDIR_P) $$(dir $$@)
139         $Q $$($(1)_CC) -c $$(CPPAFLAGS) $$($(1)_CPPAFLAGS) $$($(1)_CPPFLAGS) $$(CPPFLAGS) $$< -o $$@
140         
141
142 # Link: instructions to create elf output file from object files
143 $$(OUTDIR)/$(1).elf $$(OUTDIR)/$(1)_nostrip: bumprev $$($(1)_OBJ) $$($(1)_LDSCRIPT)
144         $L "$(1): Linking $$@"
145         @$$(MKDIR_P) $$(dir $$@)
146         $Q $$($(1)_LD) $$($(1)_OBJ) $$(LIB) $$(LDFLAGS) $$($(1)_LDFLAGS) -o $$@
147
148 # Strip debug info
149 $$(OUTDIR)/$(1): $$(OUTDIR)/$(1)_nostrip
150         $L "$(1): Generating stripped executable $$@"
151         $Q $$($(1)_STRIP) -o $$@ $$^
152  
153 # Compile and link (program-at-a-time)
154 $$(OUTDIR)/$(1)_whole.elf: bumprev $$($(1)_SRC) $$($(1)_LDSCRIPT)
155         $L "$(1): Compiling and Linking whole program $$@"
156         @$$(MKDIR_P) $$(dir $$@)
157         $Q $$($(1)_CC) $$($(1)_SRC) $$(CFLAGS) $$($(1)_CFLAGS) $$(LIB) $$(LDFLAGS) $$($(1)_LDFLAGS) -o $$@
158
159 # Flash target
160 # NOTE: we retry in case of failure because the STK500 programmer is crappy
161 .PHONY: flash_$(1)
162 flash_$(1): $(OUTDIR)/$(1).s19 flash_$(1)_local
163         if ! $(AVRDUDE) $(DPROG) -p $$($(1)_MCU) -U flash:w:$$< ; then \
164              $(AVRDUDE) $(DPROG) -p $$($(1)_MCU) -U flash:w:$$< ; \
165         fi
166         #avarice --mkII -j usb --erase --program --verify --file images/triface.elf
167
168 .PHONY: flash_$(1)_local
169 flash_$(1)_local:
170
171 .PHONY: fuses_$(!)
172 fuses_$(1):
173         if [ ! -z "$$($(1)_efuse)" ] ; then \
174                 if ! $(AVRDUDE) $(DPROG) -p $$($(1)_MCU) -U efuse:w:$$($(1)_efuse):m ; then \
175                      $(AVRDUDE) $(DPROG) -p $$($(1)_MCU) -U efuse:w:$$($(1)_efuse):m ; \
176                 fi \
177         fi
178         if [ ! -z "$$($(1)_hfuse)" ] ; then \
179                 if ! $(AVRDUDE) $(DPROG) -p $$($(1)_MCU) -U hfuse:w:$$($(1)_hfuse):m ; then \
180                      $(AVRDUDE) $(DPROG) -p $$($(1)_MCU) -U hfuse:w:$$($(1)_hfuse):m ; \
181                 fi \
182         fi
183         if [ ! -z "$$($(1)_lfuse)" ] ; then \
184                 if ! $(AVRDUDE) $(DPROG) -p $$($(1)_MCU) -U lfuse:w:$$($(1)_lfuse):m ; then \
185                      $(AVRDUDE) $(DPROG) -p $$($(1)_MCU) -U lfuse:w:$$($(1)_lfuse):m ; \
186                 fi \
187         fi
188         if [ ! -z "$$($(1)_lock)" ] ; then \
189                 if ! $(AVRDUDE) $(DPROG) -p $$($(1)_MCU) -U lock:w:$$($(1)_lock):m ; then \
190                      $(AVRDUDE) $(DPROG) -p $$($(1)_MCU) -U lock:w:$$($(1)_lock):m ; \
191                 fi \
192         fi
193
194 $$(OUTDIR)/$(1).hex: $$(OUTDIR)/$(1).elf
195         $$($(1)_OBJCOPY) -O ihex $$< $$@
196
197 $$(OUTDIR)/$(1).s19: $$(OUTDIR)/$(1).elf
198         $$($(1)_OBJCOPY) -O srec $$< $$@
199
200 $$(OUTDIR)/$(1).bin: $$(OUTDIR)/$(1).elf
201         $$($(1)_OBJCOPY) -O binary $$< $$@
202
203 $$(OUTDIR)/$(1).obj: $$(OUTDIR)/$(1).elf
204         $$($(1)_OBJCOPY) -O avrobj $$< $$@
205
206 $$(OUTDIR)/$(1).rom: $$(OUTDIR)/$(1).elf
207         $$($(1)_OBJCOPY) -O $$(FORMAT) $$< $$@
208 #       $$($(1)_OBJCOPY) -j .eeprom --set-section-flags=.eeprom="alloc,load" -O $$(FORMAT) $$< $$(@:.rom=.eep)
209
210 endef
211
212 # Generate build rules for all targets
213 $(foreach t,$(TRG),$(eval $(call build_target,$(t))))
214
215 # Generate Qt's moc files from headers
216 # NOTE: moc totally sucks and can generate empty files for some error conditions,
217 #       leading to puzzling linker errors.  Kill 'em and abort build.
218 %_moc.cpp: %.h
219         $(MOC) -o $@ $<
220         if [ ! -s $< ]; then \
221                 rm -f $@; \
222                 exit 1; \
223         fi
224
225
226 %.cof: %.elf
227         $(COFFCONVERT) -O coff-ext-avr $< $@
228 #       $(COFFCONVERT) -O coff-avr $< $@   # For use with AVRstudio 3
229
230 #make instruction to delete created files
231 clean: clean-recursive
232         -$(RM_R) $(OBJDIR)
233         -$(RM_R) $(OUTDIR)
234
235 $(RECURSIVE_TARGETS):
236         @target=`echo $@ | sed s/-recursive//`; \
237         for dir in $(SUBDIRS); do \
238                 if [ -e $$dir/configure.in ] || [ -e $$dir/configure.ac ] && [ ! -x $$dir/configure ]; then \
239                         echo "Running autogen.sh in $$dir..."; \
240                         ( cd $$dir && chmod a+x autogen.sh && ./autogen.sh && rm -f Makefile || exit 1 ); \
241                 fi; \
242                 if [ ! -e $$dir/Makefile ]; then \
243                         if [ -e "$$dir/build-$(ARCH)" ]; then \
244                                 echo "Running build script in $$dir..."; \
245                                 ( cd $$dir && chmod a+x build && ./build || exit 1 ); \
246                         else \
247                                 echo "Running configure in $$dir..."; \
248                                 ( cd $$dir && ./configure --prefix=$(PREFIX) || exit 1 ); \
249                         fi; \
250                 fi; \
251                 $(MAKE) -C $$dir $$target || exit 1; \
252         done
253
254 BUILDREV_H = buildrev.h
255
256 ifeq ($(shell [ -e verstag.c ] && echo yes),yes)
257 .PHONY: bumprev
258 bumprev:
259         @buildnr=0; \
260         if [ -f $(BUILDREV_H) ]; then \
261                 buildnr=`sed <"$(BUILDREV_H)" -n -e 's/#define VERS_BUILD \([0-9][0-9]*\)/\1/p'`; \
262         fi; \
263         buildnr=`expr $$buildnr + 1`; \
264         buildhost=`hostname`; \
265         echo "#define VERS_BUILD $$buildnr" >"$(BUILDREV_H)"; \
266         echo "#define VERS_HOST  \"$$buildhost\"" >>"$(BUILDREV_H)"; \
267         echo "Building revision $$buildnr"
268 else
269 .PHONY: bumprev
270 bumprev:
271
272 endif
273
274 # Include dependencies
275 ifneq ($(strip $(OBJ)),)
276 -include $(OBJ:%.o=%.d)
277 endif