2 # Rules for NuttX binaries compilation of C, C++ and assembler
3 # sources using GNU toolchain.
5 # Interface to other rules:
6 # kernel_HEADERS .. list of the kernel-space public header files
7 # kernel_MODULES .. list of the kernel side modules/applications
10 # NUTTX_EXPORT - export directory of NuttX build
11 # it should contain subdirectories:
12 # arch build include libs registry startup)
13 # LIB_DIR - directory where compiled libraries are stored
14 # OBJS_DIR - directory where intermediate files (.o, .map, ...) are stored
15 # INCLUDE_DIR - where includes can be found
16 # from config.omk or Makefile.omk
17 # CROSS_COMPILE - target architecture tools prefix
18 # TARGET_ARCH, DEBUG, OPTIMIZE, DEFS - forms CFLAGS
19 # from base: SOURCES_DIR
20 # from Makefile.omk: lib_LOADLIBES
21 # xxx_PROGBUILTIN - list of builtin programs linked into final system image
22 # xxx_KMODBUILTIN - list of builtin programs linked into final system image
25 # SOURCES - all the source files that needs to be compiled (except for shared library sources)
26 # SOLIB_SOURCES - all the source files that needs to be compiled for a shared library
27 # OBJ_EXT - extension of object files
28 # LIB_EXT - extension of library files
29 # LIB_PREF - prefix for library files
30 # ASM_EXT - extension of assembler sources
33 # COMPILER_DEFS_template - definitions that should be defined before
34 # the following templates can be used. The input variables needs to be
35 # defined before evaluating this template
37 # COMPILE_c_o_template, COMPILE_cc_o_template, COMPILE_S_o_template -
38 # templates that create rules for compilation of sources
40 # PROGRAM_template, LIBRARY_template, SOLIB_template - templates that
41 # create rules for compilation of a program, library and shared
42 # library. The rules can use rules produced by COMPILE_xxx_template.
44 define COMPILER_DEFS_template
50 CC = $(CROSS_COMPILE)gcc
51 CXX = $(CROSS_COMPILE)g++
52 LINK = $(CROSS_COMPILE)ld
53 AR = $(CROSS_COMPILE)ar
54 OBJCOPY = $(CROSS_COMPILE)objcopy
55 NM = $(CROSS_COMPILE)nm
57 CFLAGS += $(TARGET_ARCH) $(DEBUG) $(OPTIMIZE)
59 CFLAGS += -I$(SOURCES_DIR)
60 CFLAGS += -I$(INCLUDE_DIR)
62 ELF_FILE_LDSCRIPT?=$(wildcard $(NUTTX_EXPORT)/build/gnu-elf.ld)
64 LOADLIBES += -L$(LIB_DIR)
65 LOADLIBES += $(lib_LOADLIBES:%=-l%)
68 -include $(OBJS_DIR)/*.d
70 SOURCES2OBJS = .o/.c .o/.cc .o/.cxx .o/.S .o/.s .o/.o
72 SOURCES2OBJSLO = .lo/.c .lo/.cc .lo/.cxx .lo/.S .lo/.s .lo/.lo
75 # $(CC) -o $@ $(LCFLAGS) -c $<
77 c_o_COMPILE = $$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(OMK_CPPFLAGS) \
78 $(CPPFLAGS) $(OMK_CFLAGS) $$(CFLAGS)
80 cc_o_COMPILE = $$(CXX) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(OMK_CPPFLAGS) \
81 $(CPPFLAGS) $(CXXFLAGS) $(OMK_CFLAGS) $$(CFLAGS)
83 S_o_COMPILE = $$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) \
84 $(CPPFLAGS) $(OMK_CFLAGS) $$(CFLAGS) $(ASFLAGS)
87 # Check GCC version for user build
88 ifndef CC_MAJOR_VERSION
89 CC_MAJOR_VERSION = $$(shell $$(CC) -dumpversion | $(SED4OMK) -e 's/\([^.]\)\..*/\1/')
91 # Prepare suitable define for dependency building
92 ifeq ($$(CC_MAJOR_VERSION),2)
93 CC_DEPFLAGS = -Wp,-MD,"$$@.d.tmp"
95 CC_DEPFLAGS = -MT $$@ -MD -MP -MF "$$@.d.tmp"
98 endef # COMPILER_DEFS_template
101 # Syntax: $(call COMPILE_c_o_template,<source>,<target>,<additional c-flags>)
102 define COMPILE_c_o_template
103 $(2): $(1) $$(GEN_HEADERS)
104 @$(QUIET_CMD_ECHO) " CC $$@"
105 $(Q) if $$(c_o_COMPILE) $$(CC_DEPFLAGS) $(3) -o $$@ -c $$< ; \
106 then mv -f "$$@.d.tmp" "$$@.d" ; \
107 else rm -f "$$@.d.tmp" ; exit 1; \
112 # Syntax: $(call COMPILE_cc_o_template,<source>,<target>,<additional c-flags>)
113 define COMPILE_cc_o_template
114 $(2): $(1) $$(GEN_HEADERS)
115 @$(QUIET_CMD_ECHO) " CXX $$@"
116 $(Q) if $$(cc_o_COMPILE) $$(CC_DEPFLAGS) $(3) -o $$@ -c $$< ; \
117 then mv -f "$$@.d.tmp" "$$@.d" ; \
118 else rm -f "$$@.d.tmp" ; exit 1; \
122 # Syntax: $(call COMPILE_S_o_template,<source>,<target>,<additional c-flags>)
123 define COMPILE_S_o_template
124 $(2): $(1) $$(GEN_HEADERS)
125 @$(QUIET_CMD_ECHO) " AS $$@"
126 $(Q) if $$(S_o_COMPILE) -D__ASSEMBLY__ $$(CC_DEPFLAGS) $(3) -o $$@ -c $$< ; \
127 then if [ -e "$$@.d.tmp" ] ; then mv -f "$$@.d.tmp" "$$@.d" ; fi ; \
128 else rm -f "$$@.d.tmp" ; exit 1; \
132 # Syntax: $(call PROGRAM_template,<executable-name>,<dir>,<link-variant>)
133 define PROGRAM_template
135 GEN_SOURCES += $$($(1)_GEN_SOURCES)
137 $(foreach x, $(SOURCES2OBJS),
138 $(1)_OBJS += $$(patsubst %$(notdir $(x)),%$(dir $(x)),$$(filter %$(notdir $(x)),\
139 $$($(1)_SOURCES) $$($(1)_GEN_SOURCES)))
141 $(1)_OBJS += $$($(1)_EMBEDROMFS:%=%_img.o)
142 $(1)_OBJS := $$(sort $$($(1)_OBJS:%/=%))
144 SOURCES += $$($(1)_SOURCES)
145 EMBEDROMFS += $$($(1)_EMBEDROMFS)
147 ifneq ($$($(1)_PROGBUILTIN),)
148 ifneq ($$($(1)_PROGBUILTIN),all)
149 $(1)_PROGBUILTIN_LIST = $$($(1)_PROGBUILTIN)
151 $(1)_PROGBUILTIN_TMP = $$(wildcard $$(USER_REGISTRY_DIR)/*.pbi)
152 $(1)_PROGBUILTIN_LIST = $$($(1)_PROGBUILTIN_TMP:$$(USER_REGISTRY_DIR)/%.pbi=%)
155 $(1)_PROGBUILTIN_OTHER=$$(filter-out $(1),$$($(1)_PROGBUILTIN_LIST))
156 $(1)_PROGBUILTIN_PBI=$$($(1)_PROGBUILTIN_OTHER:%=$$(USER_REGISTRY_DIR)/%.pbi)
157 $(1)_PROGBUILTIN_LDAT=$$($(1)_PROGBUILTIN_LIST:%=$$(USER_REGISTRY_DIR)/%.ldat)
158 $(1)_PROGBUILTIN_PDAT=$$($(1)_PROGBUILTIN_LIST:%=$$(USER_REGISTRY_DIR)/%.pdat) \
159 $$(wildcard $(NUTTXREGISTRY)/*.pdat)
160 $(1)_PROGBUILTIN_BDAT=$$($(1)_PROGBUILTIN_LIST:%=$$(USER_REGISTRY_DIR)/%.bdat) \
161 $$(wildcard $(NUTTXREGISTRY)/*.bdat)
163 ifneq ($$($(1)_KMODBUILTIN),all)
164 $(1)_KMODBUILTIN_LIBS = $$($(1)_KMODBUILTIN:%=$$(KERN_MODULES_DIR)/lib%.ka)
166 $(1)_KMODBUILTIN_LIBS = $$(wildcard $$(KERN_MODULES_DIR)/lib*.ka)
170 ifneq ($$($(1)_PROGBUILTIN_PDAT),)
171 $(1)_BUILTINTABLE = $(OBJS_DIR)/$(1)-builtintab.c
173 $$($(1)_BUILTINTABLE): $$($(1)_PROGBUILTIN_PDAT) $$($(1)_PROGBUILTIN_BDAT)
174 $(Q) cat $$($(1)_PROGBUILTIN_PDAT) >$$@
175 $(Q) echo "#include <nuttx/config.h>" >>$$@
176 $(Q) echo "#include <nuttx/lib/builtin.h>" >>$$@
177 $(Q) echo "const struct builtin_s g_builtins[] = {" >>$$@
178 $(Q) cat $$($(1)_PROGBUILTIN_BDAT) >>$$@
179 $(Q) echo "{ NULL, 0, 0, 0 }};" >>$$@
180 $(Q) echo "const int g_builtin_count = sizeof(g_builtins) / sizeof(g_builtins[0]);" >>$$@
182 GEN_SOURCES += $$($(1)_BUILTINTABLE)
184 $(1)_BUILTINWRAPMAIN = $(OBJS_DIR)/$(1)-builtinwrapmain.c
186 $$($(1)_BUILTINWRAPMAIN):
187 $(Q) echo "#include <nuttx/config.h>" >$$@
188 $(Q) echo "#include <nuttx/compiler.h>" >>$$@
189 $(Q) echo "int main(int argc, FAR char *argv[]);" >>$$@
190 $(Q) echo "int weak_function $(1)_main(int argc, FAR char *argv[]) {return main(argc, argv);}" >>$$@
192 GEN_SOURCES += $$($(1)_BUILTINWRAPMAIN)
197 ifneq ($$(LD_SCRIPT$(3:%=-%)),)
198 $(1)$(3:%=-%)_LD_SCRIPT_FN = $$(LD_SCRIPT$(3:%=-%))
200 $(1)$(3:%=-%)_LD_SCRIPT_FN = $$(LD_SCRIPT)
203 ifeq ($$(dir $$($(1)$(3:%=-%)_LD_SCRIPT_FN)),)
204 $(1)$(3:%=-%)_LD_SCRIPT = $$(LIB_DIR)/$$($(1)$(3:%=-%)_LD_SCRIPT_FN)
206 $(1)$(3:%=-%)_LD_SCRIPT = $$($(1)$(3:%=-%)_LD_SCRIPT_FN)
209 $(1)$(3:%=-%)_LDFLAGS = -Wl,-T,$$($(1)$(3:%=-%)_LD_SCRIPT)
211 $(2)/$(1)$(3:%=-%): $$($(1)_OBJS) $$($(1)_BUILTINTABLE:%.c=%.o) $$($(1)_BUILTINWRAPMAIN:%.c=%.o) $$($(1)_PROGBUILTIN_LDAT) $$($(1)$(3:%=-%)_LD_SCRIPT) $$($(1)_KMODBUILTIN_LIBS)
212 @$(QUIET_CMD_ECHO) " LINK $$@"
213 $(Q) $$(if $$(filter %.cc,$$($(1)_SOURCES)) , \
214 $$(CXX) $$(CPPFLAGS) $$(OMK_CPPFLAGS) $$(OMK_CXXFLAGS) $$(CXXFLAGS) , \
215 $$(CC) $$(CPPFLAGS) $$(OMK_CPPFLAGS) $$(OMK_CFLAGS) $$(CFLAGS) ) \
216 $$(OMK_LDFLAGS) $$(LDFLAGS) $$($(1)$(3:%=-%)_LDFLAGS) -Wl,-Map,$(1)$(3:%=-%).map \
217 $$($(1)_OBJS) $$($(1)_MOREOBJS) $$($(1)_BUILTINTABLE:%.c=%.o) $$($(1)_BUILTINWRAPMAIN:%.c=%.o) \
218 $$($(1)_PROGBUILTIN_PBI) $$(LOADLIBES) $$($(1)_LIBS:%=-l%) $$($(1)_KMODBUILTIN_LIBS) \
219 $$(shell for i in $$($(1)_PROGBUILTIN_LDAT); do cat $$$$i ; done) $$(NUTTXLIBES) \
221 @echo "$(2)/$(1)$(3:%=-%): \\" >$(OBJS_DIR)/$(1)$(3:%=-%).exe.d
222 @$(SED4OMK) -n -e 's|^LOAD \(.*\)$$$$| \1 \&|p' $(OBJS_DIR)/$(1)$(3:%=-%).map|tr '&' '\134' >>$(OBJS_DIR)/$(1)$(3:%=-%).exe.d
223 @echo >>$(OBJS_DIR)/$(1).exe.d
226 # Syntax: $(call ELF_template,<executable-name>,<dir>)
229 $(2)/$(1).elf: $$($(1)_OBJS)
230 @$(QUIET_CMD_ECHO) " ELF $$@"
232 -r -e main -T $(ELF_FILE_LDSCRIPT) \
234 $$($(1)_OBJS) $$($(1)_MOREOBJS) $$(LOADLIBES) $$($(1)_LIBS:%=-l%) \
236 @echo "$(2)/$(1).elf: \\" >$(OBJS_DIR)/$(1).elf.d
237 @echo " $(ELF_FILE_LDSCRIPT) \\" >>$(OBJS_DIR)/$(1).elf.d
238 @$(SED4OMK) -n -e 's|^LOAD \(.*\)$$$$| \1 \&|p' $(OBJS_DIR)/$(1).elf.map|tr '&' '\134' >>$(OBJS_DIR)/$(1).elf.d
239 @echo >>$(OBJS_DIR)/$(1).elf.d
242 # Syntax: $(call PROGBUILTIN_template,<executable-name>,<dir>,<registry-dir>)
243 define PROGBUILTIN_template
245 $(1)_PRIORITY ?= SCHED_PRIORITY_DEFAULT
246 $(1)_STACKSIZE ?= 2048
248 $(2)/$(1).pbi: $$($(1)_OBJS)
249 @$(QUIET_CMD_ECHO) " PROGMOD $$@"
251 -r -x --defsym=$(1)_main=main \
253 $$($(1)_OBJS) $$($(1)_MOREOBJS) \
254 -o $(OBJS_DIR)/$(1).pbo
255 $(Q) $(OBJCOPY) --keep-global-symbol=$(1)_main $(OBJS_DIR)/$(1).pbo $$@
256 @echo "$(2)/$(1).pbi: \\" >$(OBJS_DIR)/$(1).pbi.d
257 @$(SED4OMK) -n -e 's|^LOAD \(.*\)$$$$| \1 \&|p' $(OBJS_DIR)/$(1).pbi.map|tr '&' '\134' >>$(OBJS_DIR)/$(1).pbi.d
258 @echo >>$(OBJS_DIR)/$(1).pbi.d
259 @echo "{ \"$1\", $$($(1)_PRIORITY), $$($(1)_STACKSIZE), $(1)_main }," >$(3)/$(1).bdat
260 @echo "int $(1)_main(int argc, char *argv[]);" >$(3)/$(1).pdat
261 @echo "$$(LOADLIBES) $$($(1)_LIBS:%=-l%)" >$(3)/$(1).ldat
265 # Rules for other output formats (can be specified by OUTPUT_FORMATS)
267 @$(QUIET_CMD_ECHO) " OBJCOPY $@"
268 $(Q) $(OBJCOPY) --output-target=binary -S $< $@
271 @$(QUIET_CMD_ECHO) " OBJCOPY $@"
272 $(Q) $(OBJCOPY) --output-target=ihex -S $< $@
275 @$(QUIET_CMD_ECHO) " OBJCOPY $@"
276 $(Q) $(OBJCOPY) --output-target=srec -S $< $@
278 # Syntax: $(call LIBRARY_template,<library-name>)
279 define LIBRARY_template
281 GEN_SOURCES += $$($(1)_GEN_SOURCES)
283 $(foreach x, $(SOURCES2OBJS),
284 $(1)_OBJS += $$(patsubst %$(notdir $(x)),%$(dir $(x)),$$(filter %$(notdir $(x)),\
285 $$($(1)_SOURCES) $$($(1)_GEN_SOURCES)))
287 $(1)_OBJS += $$($(1)_EMBEDROMFS:%=%_img.o)
288 $(1)_OBJS := $$(sort $$($(1)_OBJS:%/=%))
290 SOURCES += $$($(1)_SOURCES)
291 EMBEDROMFS += $$($(1)_EMBEDROMFS)
293 $(LIB_DIR)/lib$(1).a: $$($(1)_OBJS)
294 @$(QUIET_CMD_ECHO) " AR $$@"
295 $(Q) $(AR) rcs $$@ $$^
299 # Syntax: $(call SOLIB_template,<library-name>)
300 define SOLIB_template
302 SOLIB_GEN_SOURCES += $$($(1)_GEN_SOURCES)
304 $(foreach x, $(SOURCES2OBJSLO),
305 $(1)_OBJSLO += $$(patsubst %$(notdir $(x)),%$(dir $(x)),$$(filter %$(notdir $(x)),\
306 $$($(1)_SOURCES) $$($(1)_GEN_SOURCES)))
308 $(1)_OBJSLO := $$(sort $$($(1)_OBJSLO:%/=%))
310 SOLIB_OBJS += $$($(1)_OBJSLO)
311 SOLIB_SOURCES += $$($(1)_SOURCES)
313 $(LIB_DIR)/lib$(1).so: $$($(1)_OBJSLO)
314 @$(QUIET_CMD_ECHO) " LINK $$@"
315 $(Q) $(LD) --shared --soname=lib$(1).so -o $$@ $$^
318 ifneq ($(bin_PROGRAMS),)
319 library-pass_HOOKS += force_builtin_library_hook
321 .PHONY: force_builtin_library_hook
322 force_builtin_library_hook:
326 # Syntax: $(call ROMFS_template,<filename>,<filename2>,<directory>) FIXME: Is this correct?
327 define ROMFS_template
332 $(Q) genromfs -f $(2).tmp -V $(1) -d $(3)
333 $(Q) if ( [ ! -e $(2) ] || ! cmp -s $(2).tmp $(2) ) ; then cp $(2).tmp $(2) ; fi
336 @$(QUIET_CMD_ECHO) " ROMFS $$@"
337 $(Q) $(LD) -r --accept-unknown-input-arch -b binary \
338 --defsym=$(2)_size=_binary_$(2)_size \
339 --defsym=$(2)_start=_binary_$(2)_start \
340 --defsym=$(2)_end=_binary_$(2)_end \
342 $(Q) $(OBJCOPY) --rename-section .data=.rodata,alloc,load,readonly,data,contents \