Add makefile target rule for debugging.
[bertos.git] / bertos / 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: Bernie Innocenti <bernie@codewiz.org>
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 # Virtual Product: based on target products may be different.
40 # e.g. Embedded target = hex, s19, bin
41 #      Hosted = exe
42 #      Library = lib.a
43 TRG_TGT = $(TRG:%=$(OUTDIR)/%.tgt)
44
45 RECURSIVE_TARGETS = all-recursive install-recursive clean-recursive
46
47 # The default target
48 .PHONY: all
49 all:: all-recursive $(TRG_TGT)
50
51 # Generate project documentation
52 .PHONY: docs
53 docs:
54         $L "Building documentation"
55         $Q $(DOXYGEN)
56
57 # Generate ctags
58 .PHONY: tags
59 tags:
60         $L "Rebuilding C tags database"
61         $Q ctags -R --exclude=doc
62
63 # Run testsuite
64 .PHONY: check
65 check:
66         $L "Running testsuite"
67         $Q test/run_tests.sh
68
69 define build_target
70
71 ifeq ($$($(1)_HOSTED),1)
72         #On Darwin architecture the assembly doesn't link correctly if these flags are set.
73         ifeq ($(shell uname | grep -c "Darwin"),1)
74                 LIST_FLAGS := ""
75                 MAP_FLAGS := ""
76                 LDFLAGS := ""
77         endif
78         #use hosted specific map flags
79         $(1)_MAP_FLAGS = $$(MAP_FLAGS_HOST)
80
81         #Handle library creation
82         ifeq ($$($(1)_MAKELIB),1)
83                 $$(OUTDIR)/$(1).tgt : $$(OUTDIR)/$(1).a
84         else
85                 #Otherwise in  hosted application we need only executable file.
86                 $$(OUTDIR)/$(1).tgt : $$(OUTDIR)/$(1)
87         endif
88 else
89         #use embedded specific map flags
90         $(1)_MAP_FLAGS = $$(MAP_FLAGS_EMB)
91         #In embedded we need s19, hex and bin
92         $$(OUTDIR)/$(1).tgt : $$(OUTDIR)/$(1).s19 $$(OUTDIR)/$(1).hex $$(OUTDIR)/$(1).bin
93 endif
94
95 $(1)_LDFLAGS += $$($(1)_MAP_FLAGS)
96
97 # In embedded systems the target CPU is needed,
98 # but there are different options on how to pass
99 # it to the compiler.
100 ifneq ($$(strip $$($(1)_MCU)),)
101         $(1)_MCPU = -mmcu=$$($(1)_MCU)
102 endif
103 ifneq ($$(strip $$($(1)_CPU)),)
104         $(1)_MCPU = -mcpu=$$($(1)_CPU)
105 endif
106
107 # If a CPU is specified add to
108 # project specific flags.
109 ifneq ($$($(1)_MCPU),)
110         $(1)_CFLAGS    += $$($(1)_MCPU)
111         $(1)_CXXFLAGS  += $$($(1)_MCPU)
112         $(1)_ASFLAGS   += $$($(1)_MCPU)
113         $(1)_CPPAFLAGS += $$($(1)_MCPU)
114         $(1)_LDFLAGS   += $$($(1)_MCPU)
115 endif
116
117 ifneq ($$(strip $$($(1)_LDSCRIPT)),)
118         $(1)_LDFLAGS += -Wl,-T$$($(1)_LDSCRIPT)
119 endif
120
121 ifneq ($$($(1)_CROSS),)
122         #deprecated: use PREFIX, SUFFIX and HOSTED mechanism instead
123         $(1)_PREFIX = $$($(1)_CROSS)
124         $(1)_SUFFIX =
125 endif
126
127 $(1)_CC      ?= $$($(1)_PREFIX)$$(CC)$$($(1)_SUFFIX)
128 $(1)_CXX     ?= $$($(1)_PREFIX)$$(CXX)$$($(1)_SUFFIX)
129 $(1)_AS      ?= $$($(1)_PREFIX)$$(AS)$$($(1)_SUFFIX)
130 $(1)_AR      ?= $$($(1)_PREFIX)$$(AR)$$($(1)_SUFFIX)
131 $(1)_OBJCOPY ?= $$($(1)_PREFIX)$$(OBJCOPY)$$($(1)_SUFFIX)
132 $(1)_STRIP   ?= $$($(1)_PREFIX)$$(STRIP)$$($(1)_SUFFIX)
133 ifneq ($$(strip $$($(1)_CXXSRC)),)
134         $(1)_LD = $$($(1)_PREFIX)$$(LDXX)$$($(1)_SUFFIX)
135 else
136         $(1)_LD = $$($(1)_PREFIX)$$(LD)$$($(1)_SUFFIX)
137 endif
138
139 # Debug stuff
140 ifeq ($$($(1)_DEBUG),1)
141         # AVR is an harvard processor
142         # and needs debug module
143         # to be compiled in program memory
144         ifeq ($$(findstring avr, $$($(1)_PREFIX)),avr)
145                 $(1)_DEBUGSRC = $(1)_PCSRC
146         else
147                 $(1)_DEBUGSRC = $(1)_CSRC
148         endif
149
150         $$($(1)_DEBUGSRC) += bertos/drv/kdebug.c
151
152         # Also add formatwr.c (printf) if not already present
153         ifneq ($$(findstring formatwr.c, $$($$($(1)_DEBUGSRC))),formatwr.c)
154                 $$($(1)_DEBUGSRC) += bertos/mware/formatwr.c
155         endif
156
157         # Also add hex.c (for printf) if not already present
158         ifneq ($$(findstring hex.c, $$($$($(1)_CSRC))),hex.c)
159                 $$($(1)_CSRC) += bertos/mware/hex.c
160         endif
161
162         $(1)_CFLAGS += -D_DEBUG
163         $(1)_CXXFLAGS += -D_DEBUG
164 endif
165
166 $(1)_COBJ    = $$(foreach file,$$($(1)_CSRC:%.c=%.o),$$(OBJDIR)/$(1)/$$(file))
167 $(1)_CXXOBJ  = $$(foreach file,$$($(1)_CXXSRC:%.cpp=%.o),$$(OBJDIR)/$(1)/$$(file))
168 $(1)_PCOBJ   = $$(foreach file,$$($(1)_PCSRC:%.c=%_P.o),$$(OBJDIR)/$(1)/$$(file))
169 $(1)_AOBJ    = $$(foreach file,$$($(1)_ASRC:%.s=%.o),$$(OBJDIR)/$(1)/$$(file))
170 $(1)_CPPAOBJ = $$(foreach file,$$($(1)_CPPASRC:%.S=%.o),$$(OBJDIR)/$(1)/$$(file))
171 $(1)_OBJ    := $$($(1)_COBJ) $$($(1)_CXXOBJ) $$($(1)_PCOBJ) $$($(1)_AOBJ) $$($(1)_CPPAOBJ)
172 $(1)_SRC    := $$($(1)_CSRC) $$($(1)_CXXSRC) $$($(1)_PCSRC) $$($(1)_ASRC) $$($(1)_CPPASRC)
173 OBJ         += $$($(1)_OBJ)
174
175 # Sometimes $(CC) is actually set to a C++ compiler in disguise, and it
176 # would whine if we passed it C-only flags.  Checking for the presence of
177 # "++" in the name is a kludge that seems to work mostly.
178 ifeq (++,$$(findstring ++,$$($(1)_CC)))
179         $(1)_REAL_CFLAGS = $$(CXXFLAGS)
180 else
181         $(1)_REAL_CFLAGS = $$(CFLAGS)
182 endif
183
184 # Compile: instructions to create assembler and/or object files from C source
185 $$($(1)_COBJ) : $$(OBJDIR)/$(1)/%.o : %.c
186         $L "$(1): Compiling $$< (C)"
187         @$$(MKDIR_P) $$(dir $$@)
188         $Q $$($(1)_CC) -c $$($(1)_REAL_CFLAGS) $$($(1)_CFLAGS) $$($(1)_CPPFLAGS) $$(CPPFLAGS) $$< -o $$@
189
190 # Compile: instructions to create assembler and/or object files from C++ source
191 $$($(1)_CXXOBJ) : $$(OBJDIR)/$(1)/%.o : %.cpp
192         $L "$(1): Compiling $$< (C++)"
193         @$$(MKDIR_P) $$(dir $$@)
194         $Q $$($(1)_CXX) -c $$(CXXFLAGS) $$($(1)_CXXFLAGS) $$($(1)_CPPFLAGS) $$(CPPFLAGS) $$< -o $$@
195
196 # Generate assembly sources from C files (debug)
197 $$(OBJDIR)/$(1)/%.s : %.c
198         $L "$(1): Generating asm source $$<"
199         @$$(MKDIR_P) $$(dir $$@)
200         $Q $$($(1)_CC) -S $$(CFLAGS) $$($(1)_CFLAGS) $$($(1)_CPPFLAGS) $$< -o $$@
201
202 # Generate special progmem variant of a source file
203 $$($(1)_PCOBJ) : $$(OBJDIR)/$(1)/%_P.o : %.c
204         $L "$(1): Compiling $$< (PROGMEM)"
205         @$$(MKDIR_P) $$(dir $$@)
206         $Q $$($(1)_CC) -c -D_PROGMEM $$(CFLAGS) $$($(1)_CFLAGS) $$($(1)_CPPFLAGS) $$(CPPFLAGS) $$< -o $$@
207
208 # Assemble: instructions to create object file from assembler files
209 $$($(1)_AOBJ): $$(OBJDIR)/$(1)/%.o : %.s
210         $L "$(1): Assembling $$<"
211         @$$(MKDIR_P) $$(dir $$@)
212         $Q $$($(1)_AS) -c $$(ASFLAGS) $$($(1)_ASFLAGS) $$< -o $$@
213
214 $$($(1)_CPPAOBJ): $$(OBJDIR)/$(1)/%.o : %.S
215         $L "$(1): Assembling with CPP $$<"
216         @$$(MKDIR_P) $$(dir $$@)
217         $Q $$($(1)_CC) -c $$(CPPAFLAGS) $$($(1)_CPPAFLAGS) $$($(1)_CPPFLAGS) $$(CPPFLAGS) $$< -o $$@
218
219
220 # Link: instructions to create elf output file from object files
221 $$(OUTDIR)/$(1).elf $$(OUTDIR)/$(1)_nostrip: bumprev $$($(1)_OBJ) $$($(1)_LDSCRIPT)
222         $L "$(1): Linking $$@"
223         @$$(MKDIR_P) $$(dir $$@)
224         $Q $$($(1)_LD) $$($(1)_OBJ) $$(LIB) $$(LDFLAGS) $$($(1)_LDFLAGS) -o $$@
225
226
227 # Instructions to create a static library from object files
228 $$(OUTDIR)/$(1).a: bumprev $$($(1)_OBJ)
229         $L "$(1): Creating static library $$@"
230         @$$(MKDIR_P) $$(dir $$@)
231         $Q $$($(1)_AR) $$(ARFLAGS) $$($(1)_ARFLAGS) $$@ $$($(1)_OBJ)
232
233 # Strip debug info
234 $$(OUTDIR)/$(1): $$(OUTDIR)/$(1)_nostrip
235         $L "$(1): Generating stripped executable $$@"
236         $Q $$($(1)_STRIP) -o $$@ $$^
237
238 # Compile and link (program-at-a-time)
239 $$(OUTDIR)/$(1)_whole.elf: bumprev $$($(1)_SRC) $$($(1)_LDSCRIPT)
240         $L "$(1): Compiling and Linking whole program $$@"
241         @$$(MKDIR_P) $$(dir $$@)
242         $Q $$($(1)_CC) $$($(1)_SRC) $$(CFLAGS) $$($(1)_CFLAGS) $$(LIB) $$(LDFLAGS) $$($(1)_LDFLAGS) -o $$@
243
244 # Flash target
245 .PHONY: flash_$(1)
246 flash_$(1): $(OUTDIR)/$(1).hex flash_$(1)_local
247         $L "$(1): Flashing target"
248         $Q if [ ! "$$($(1)_PROGRAMMER_TYPE)" == "none" ] ; then \
249                 PROGRAMMER_CPU=$$($(1)_PROGRAMMER_CPU) PROGRAMMER_TYPE=$$($(1)_PROGRAMMER_TYPE) \
250                 PROGRAMMER_PORT=$$($(1)_PROGRAMMER_PORT) IMAGE_FILE=$$< \
251                 $$($(1)_FLASH_SCRIPT) ; \
252         else \
253                 printf "No programmer interface configured, see http://dev.bertos.org/wiki/ProgrammerInterface\n" ; \
254                 exit 1 ; \
255         fi
256
257 .PHONY: flash_$(1)_local
258 flash_$(1)_local:
259
260 # Debug target
261 .PHONY: debug_$(1)
262 debug_$(1): $(OUTDIR)/$(1).elf
263         $L "$(1): Debugging target"
264         $Q if [ ! "$$($(1)_PROGRAMMER_TYPE)" == "none" ] ; then \
265                 PROGRAMMER_CPU=$$($(1)_PROGRAMMER_CPU) PROGRAMMER_TYPE=$$($(1)_PROGRAMMER_TYPE) \
266                 PROGRAMMER_PORT=$$($(1)_PROGRAMMER_PORT) GDB_PORT=3333 \
267                 ELF_FILE=$$< \
268                 $$($(1)_DEBUG_SCRIPT) ; \
269         else \
270                 printf "No programmer interface configured, see http://dev.bertos.org/wiki/ProgrammerInterface\n" ; \
271                 exit 1 ; \
272         fi
273
274 .PHONY: fuses_$(!)
275 fuses_$(1):
276         if [ ! -z "$$($(1)_efuse)" ] ; then \
277                 if ! $(AVRDUDE) $(DPROG) -p $$($(1)_MCU) -U efuse:w:$$($(1)_efuse):m ; then \
278                      $(AVRDUDE) $(DPROG) -p $$($(1)_MCU) -U efuse:w:$$($(1)_efuse):m ; \
279                 fi \
280         fi
281         if [ ! -z "$$($(1)_hfuse)" ] ; then \
282                 if ! $(AVRDUDE) $(DPROG) -p $$($(1)_MCU) -U hfuse:w:$$($(1)_hfuse):m ; then \
283                      $(AVRDUDE) $(DPROG) -p $$($(1)_MCU) -U hfuse:w:$$($(1)_hfuse):m ; \
284                 fi \
285         fi
286         if [ ! -z "$$($(1)_lfuse)" ] ; then \
287                 if ! $(AVRDUDE) $(DPROG) -p $$($(1)_MCU) -U lfuse:w:$$($(1)_lfuse):m ; then \
288                      $(AVRDUDE) $(DPROG) -p $$($(1)_MCU) -U lfuse:w:$$($(1)_lfuse):m ; \
289                 fi \
290         fi
291         if [ ! -z "$$($(1)_lock)" ] ; then \
292                 if ! $(AVRDUDE) $(DPROG) -p $$($(1)_MCU) -U lock:w:$$($(1)_lock):m ; then \
293                      $(AVRDUDE) $(DPROG) -p $$($(1)_MCU) -U lock:w:$$($(1)_lock):m ; \
294                 fi \
295         fi
296
297 $$(OUTDIR)/$(1).hex: $$(OUTDIR)/$(1).elf
298         $$($(1)_OBJCOPY) -O ihex $$< $$@
299
300 $$(OUTDIR)/$(1).s19: $$(OUTDIR)/$(1).elf
301         $$($(1)_OBJCOPY) -O srec $$< $$@
302
303 $$(OUTDIR)/$(1).bin: $$(OUTDIR)/$(1).elf
304         $$($(1)_OBJCOPY) -O binary $$< $$@
305
306 $$(OUTDIR)/$(1).obj: $$(OUTDIR)/$(1).elf
307         $$($(1)_OBJCOPY) -O avrobj $$< $$@
308
309 $$(OUTDIR)/$(1).rom: $$(OUTDIR)/$(1).elf
310         $$($(1)_OBJCOPY) -O $$(FORMAT) $$< $$@
311 #       $$($(1)_OBJCOPY) -j .eeprom --set-section-flags=.eeprom="alloc,load" -O $$(FORMAT) $$< $$(@:.rom=.eep)
312
313 endef
314
315 # Generate build rules for all targets
316 $(foreach t,$(TRG),$(eval $(call build_target,$(t))))
317
318 # Generate Qt's moc files from headers
319 # NOTE: moc totally sucks and can generate empty files for some error conditions,
320 #       leading to puzzling linker errors.  Kill 'em and abort build.
321 %_moc.cpp: %.h
322         $(QT_MOC) -o $@ $<
323         if [ ! -s $< ]; then \
324                 rm -f $@; \
325                 exit 1; \
326         fi
327
328
329 %.cof: %.elf
330         $(COFFCONVERT) -O coff-ext-avr $< $@
331 #       $(COFFCONVERT) -O coff-avr $< $@   # For use with AVRstudio 3
332
333 #make instruction to delete created files
334 cleanall: clean
335 clean: clean-recursive
336         -$(RM_R) $(OBJDIR)
337         -$(RM_R) $(OUTDIR)
338
339 $(RECURSIVE_TARGETS):
340         @target=`echo $@ | sed s/-recursive//`; \
341         for dir in $(SUBDIRS); do \
342                 if [ -e $$dir/configure.in ] || [ -e $$dir/configure.ac ] && [ ! -x $$dir/configure ]; then \
343                         echo "Running autogen.sh in $$dir..."; \
344                         ( cd $$dir && chmod a+x autogen.sh && ./autogen.sh && rm -f Makefile || exit 1 ); \
345                 fi; \
346                 if [ ! -e $$dir/Makefile ]; then \
347                         if [ -e "$$dir/build-$(ARCH)" ]; then \
348                                 echo "Running build script in $$dir..."; \
349                                 ( cd $$dir && chmod a+x build && ./build || exit 1 ); \
350                         else \
351                                 echo "Running configure in $$dir..."; \
352                                 ( cd $$dir && ./configure --prefix=$(PREFIX) || exit 1 ); \
353                         fi; \
354                 fi; \
355                 $(MAKE) -C $$dir $$target || exit 1; \
356         done
357
358 BUILDREV_H = buildrev.h
359
360 .PHONY: bumprev
361 bumprev:
362         @if [ -e bertos/verstag.c ]; then \
363                 buildnr=0; \
364                 if [ -f $(BUILDREV_H) ]; then \
365                         buildnr=`sed <"$(BUILDREV_H)" -n -e 's/#define VERS_BUILD \([0-9][0-9]*\)/\1/p'`; \
366                 fi; \
367                 buildnr=`expr $$buildnr + 1`; \
368                 buildhost=`hostname | sed -n -e '1h;2,$$H;$${g;s/\n//g;p;}'`; \
369                 echo "#define VERS_BUILD $$buildnr" >"$(BUILDREV_H)"; \
370                 echo "#define VERS_HOST  \"$$buildhost\"" >>"$(BUILDREV_H)"; \
371                 echo "Building revision $$buildnr"; \
372         fi; \
373         #
374
375 # Include dependencies
376 ifneq ($(strip $(OBJ)),)
377 -include $(OBJ:%.o=%.d)
378 endif