Makefile 12.8 KB
Newer Older
1
#
2
# Copyright (c) 2013-2014, ARM Limited and Contributors. All rights reserved.
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# Redistributions of source code must retain the above copyright notice, this
# list of conditions and the following disclaimer.
#
# Redistributions in binary form must reproduce the above copyright notice,
# this list of conditions and the following disclaimer in the documentation
# and/or other materials provided with the distribution.
#
# Neither the name of ARM nor the names of its contributors may be used
# to endorse or promote products derived from this software without specific
# prior written permission.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.
#

# Decrease the verbosity of the make script
# can be made verbose by passing V=1 at the make command line
ifdef V
34
  KBUILD_VERBOSE = ${V}
35
36
37
38
else
  KBUILD_VERBOSE = 0
endif

Achin Gupta's avatar
Achin Gupta committed
39
40
41
42
43
# Checkpatch ignores
CHECK_IGNORE		=	--ignore COMPLEX_MACRO

CHECKPATCH_ARGS		=	--no-tree --no-signoff ${CHECK_IGNORE}
CHECKCODE_ARGS		=	--no-patch --no-tree --no-signoff ${CHECK_IGNORE}
44

45
ifeq "${KBUILD_VERBOSE}" "0"
46
	Q=@
47
	CHECKCODE_ARGS	+=	--no-summary --terse
48
49
50
51
else
	Q=
endif

52
53
export Q

54
DEBUG	?= 0
55
56
57
58
59
60
61

ifneq (${DEBUG}, 0)
	BUILD_TYPE	:=	debug
else
	BUILD_TYPE	:=	release
endif

62
63
64
BL_COMMON_OBJS		:=	misc_helpers.o		\
				cache_helpers.o		\
				tlb_helpers.o		\
65
				xlat_helpers.o		\
66
67
				std.o			\
				bl_common.o		\
James Morrissey's avatar
James Morrissey committed
68
69
				platform_helpers.o	\
				io_storage.o
70

71
72
73
74
ARCH 			?=	aarch64

# By default, build all platforms available
PLAT			?=	all
75
76
# By default, build no SPD component
SPD			?=	none
77
78
79
80
81
82
83
84
85

BUILD_BASE		:=	./build
BUILD_PLAT		:=	${BUILD_BASE}/${PLAT}/${BUILD_TYPE}
BUILD_BL1		:=	${BUILD_PLAT}/bl1
BUILD_BL2		:=	${BUILD_PLAT}/bl2
BUILD_BL31		:=	${BUILD_PLAT}/bl31
BUILD_DIRS		:=	${BUILD_BL1} ${BUILD_BL2} ${BUILD_BL31}

PLATFORMS		:=	$(shell ls -I common plat/)
86
SPDS			:=	$(shell ls -I none services/spd)
87
88
HELP_PLATFORMS		:=	$(shell echo ${PLATFORMS} | sed 's/ /|/g')

89
90
91
92
93
94
ifeq (${PLAT},)
  $(error "Error: Unknown platform. Please use PLAT=<platform name> to specify the platform.")
endif
ifeq ($(findstring ${PLAT},${PLATFORMS} all),)
  $(error "Error: Invalid platform. The following platforms are available: ${PLATFORMS}")
endif
95

96
97
98
ifeq (${PLAT},all)
all: ${PLATFORMS}
else
99
all: msg_start bl1 bl2 bl31 fip
100
endif
101

102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
msg_start:
	@echo "Building ${PLAT}"

${PLATFORMS}:
	${MAKE} PLAT=$@ all

ifneq (${PLAT},all)
  $(info Including ${PLAT}/platform.mk)
  include plat/${PLAT}/platform.mk
  $(info Including bl1.mk)
  include bl1/bl1.mk
  $(info Including bl2.mk)
  include bl2/bl2.mk
  $(info Including bl31.mk)
  include bl31/bl31.mk
endif
118

119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
# Include SPD Makefile if one has been specified
ifneq (${SPD},none)
  # We expect to locate an spd.mk under the specified SPD directory
  SPD_MAKE		:=	$(shell m="services/spd/${SPD}/${SPD}.mk"; [ -f "$$m" ] && echo "$$m")

  ifeq (${SPD_MAKE},)
    $(error Error: No services/spd/${SPD}/${SPD}.mk located)
  endif
  $(info Including ${SPD_MAKE})
  include ${SPD_MAKE}

  # If there's BL32 companion for the chosen SPD, and the SPD wants to build the
  # BL2 from source, we expect that the SPD's Makefile would set NEED_BL32
  # variable to "yes"
endif

135
.PHONY:			all msg_start ${PLATFORMS} dump clean realclean distclean bl1 bl2 bl31 cscope locate-checkpatch checkcodebase checkpatch fiptool fip locate-bl33
136
137
138
.SUFFIXES:


139
140
BL1_OBJS		:= 	$(addprefix ${BUILD_BL1}/,${BL1_OBJS} ${BL_COMMON_OBJS} ${PLAT_BL_COMMON_OBJS})
BL2_OBJS		:= 	$(addprefix ${BUILD_BL2}/,${BL2_OBJS} ${BL_COMMON_OBJS} ${PLAT_BL_COMMON_OBJS})
141
BL31_OBJS		:= 	$(addprefix ${BUILD_BL31}/,${BL31_OBJS} ${BL_COMMON_OBJS} ${PLAT_BL_COMMON_OBJS} ${SPD_OBJS})
142
143
144
145
146
147
BL1_MAPFILE		:= 	$(addprefix ${BUILD_BL1}/,${BL1_MAPFILE})
BL2_MAPFILE		:= 	$(addprefix ${BUILD_BL2}/,${BL2_MAPFILE})
BL31_MAPFILE		:= 	$(addprefix ${BUILD_BL31}/,${BL31_MAPFILE})
BL1_LINKERFILE		:= 	$(addprefix ${BUILD_BL1}/,${BL1_LINKERFILE})
BL2_LINKERFILE		:= 	$(addprefix ${BUILD_BL2}/,${BL2_LINKERFILE})
BL31_LINKERFILE		:= 	$(addprefix ${BUILD_BL31}/,${BL31_LINKERFILE})
148

149
INCLUDES		+=	-Ilib/include/			\
James Morrissey's avatar
James Morrissey committed
150
				-Idrivers/io			\
151
152
153
				-Iinclude/${ARCH}/		\
				-Iinclude/			\
				-Iarch/system/gic		\
154
				-Iservices/psci			\
155
156
157
				-Iinclude/stdlib		\
				-Iinclude/stdlib/sys		\
				-Iplat/${PLAT}			\
158
159
				${PLAT_INCLUDES}		\
				${SPD_INCLUDES}
160

161
ASFLAGS			+= 	-nostdinc -ffreestanding -Wa,--fatal-warnings	\
162
163
				-mgeneral-regs-only -D__ASSEMBLY__ ${INCLUDES}	\
				-DDEBUG=${DEBUG}
164
165
166
CFLAGS			:= 	-nostdinc -pedantic -ffreestanding -Wall	\
				-Werror -mgeneral-regs-only -std=c99 -c -Os	\
				-DDEBUG=${DEBUG} ${INCLUDES} ${CFLAGS}
167

168
LDFLAGS			+=	--fatal-warnings -O1
169
170
171
BL1_LDFLAGS		:=	-Map=${BL1_MAPFILE} --script ${BL1_LINKERFILE} --entry=${BL1_ENTRY_POINT}
BL2_LDFLAGS		:=	-Map=${BL2_MAPFILE} --script ${BL2_LINKERFILE} --entry=${BL2_ENTRY_POINT}
BL31_LDFLAGS		:=	-Map=${BL31_MAPFILE} --script ${BL31_LINKERFILE} --entry=${BL31_ENTRY_POINT}
172
173
174
175
176
177
178
179


vpath %.ld.S bl1:bl2:bl31
vpath %.c bl1:bl2:bl31
vpath %.c bl1/${ARCH}:bl2/${ARCH}:bl31/${ARCH}
vpath %.S bl1/${ARCH}:bl2/${ARCH}:bl31/${ARCH}


180
ifneq (${DEBUG}, 0)
181
182
183
184
#CFLAGS			+= 	-g -O0
CFLAGS			+= 	-g
# -save-temps -fverbose-asm
ASFLAGS			+= 	-g -Wa,--gdwarf-2
185
186
else
CFLAGS			+=	-DNDEBUG=1
187
188
189
endif


190
191
192
193
194
195
196
197
198
199
200
CC			:=	${CROSS_COMPILE}gcc
CPP			:=	${CROSS_COMPILE}cpp
AS			:=	${CROSS_COMPILE}gcc
AR			:=	${CROSS_COMPILE}ar
LD			:=	${CROSS_COMPILE}ld
OC			:=	${CROSS_COMPILE}objcopy
OD			:=	${CROSS_COMPILE}objdump
NM			:=	${CROSS_COMPILE}nm
PP			:=	${CROSS_COMPILE}gcc -E ${CFLAGS}


201
bl1:			${BUILD_BL1} ${BUILD_PLAT}/bl1.bin
202
203
FIP_DEPS		+= ${BUILD_PLAT}/bl1.bin

204
bl2:			${BUILD_BL2} ${BUILD_PLAT}/bl2.bin
205
206
FIP_DEPS		+= ${BUILD_PLAT}/bl2.bin

207
bl31:			${BUILD_BL31} ${BUILD_PLAT}/bl31.bin
208
FIP_DEPS		+= ${BUILD_PLAT}/bl31.bin
209

210
211
BASE_COMMIT		?=	origin/master

212
213
# Variables for use with Firmware Image Package
FIPTOOLPATH		?=	tools/fip_create
214
FIPTOOL			?=	${FIPTOOLPATH}/fip_create
215
216
217
fiptool:		${FIPTOOL}
fip:			${BUILD_PLAT}/fip.bin

218
219
220
221
222
ifeq (${PLAT},all)
  ifeq (${MAKECMDGOALS},clean)
    $(error "Please select a platform with PLAT=<platform>. You can use 'make distclean' to clean up all platform builds")
  endif
endif
223
224
225
226
227
228
229
230
231
232

locate-checkpatch:
ifndef CHECKPATCH
	$(error "Please set CHECKPATCH to point to the Linux checkpatch.pl file, eg: CHECKPATCH=../linux/script/checkpatch.pl")
else
ifeq (,$(wildcard ${CHECKPATCH}))
	$(error "The file CHECKPATCH points to cannot be found, use eg: CHECKPATCH=../linux/script/checkpatch.pl")
endif
endif

233
234
235
236
237
238
239
locate-bl33:
ifndef BL33
	$(error "Please set BL33 to point to the Normal World binary, eg: BL33=../uefi/FVP_AARCH64_EFI.fd")
else
ifeq (,$(wildcard ${BL33}))
	$(error "The file BL33 points to cannot be found (${BL33})")
endif
240
FIP_DEPS		+= ${BL33}
241
242
243
endif


244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
# If BL32 needs to be built, provide necessary build rules and targets
ifeq (${NEED_BL32},yes)
BUILD_BL32		:=	${BUILD_PLAT}/bl32
BUILD_DIRS		+=	${BUILD_BL32}

BL32_OBJS		:=	$(addprefix ${BUILD_BL32}/,${BL32_OBJS})
BL32_MAPFILE		:=	$(addprefix ${BUILD_BL32}/,${BL32_MAPFILE})
BL32_LINKERFILE	:=	$(addprefix ${BUILD_BL32}/,${BL32_LINKERFILE})
BL32_LDFLAGS		:=	-Map=${BL32_MAPFILE} --script ${BL32_LINKERFILE} --entry=${BL32_ENTRY_POINT}

bl32:			${BUILD_BL32} ${BUILD_PLAT}/bl32.bin
all:			bl32
dump:			bl32_dump
.PHONY:			bl32

# Add BL32 image to FIP's input image list
FIP_DEPS		:= bl32
FIP_ARGS		:= --bl32 ${BUILD_PLAT}/bl32.bin

${BUILD_BL32}/%.o:	%.S
			@echo "  AS      $<"
			${Q}${AS} ${ASFLAGS} -c $< -o $@

${BUILD_BL32}/%.o:	%.c
			@echo "  CC      $<"
			${Q}${CC} ${CFLAGS} -c $< -o $@

${BUILD_BL32}/%.ld:	%.ld.S
			@echo "  PP      $<"
			${Q}${AS} ${ASFLAGS} -P -E $< -o $@

${BUILD_BL32}/bl32.elf:	${BL32_OBJS} ${BL32_LINKERFILE}
			@echo "  LD      $@"
			${Q}${LD} -o $@ ${LDFLAGS} ${BL32_LDFLAGS} ${BL32_OBJS}

${BUILD_PLAT}/bl32.bin:	${BUILD_BL32}/bl32.elf
			@echo "  BIN     $@"
			${Q}${OC} -O binary $< $@
			@echo
			@echo "Built $@ successfully"
			@echo

bl32_dump:
	${Q}${OD} -d ${BUILD_BL32}/bl32.elf > ${BUILD_BL32}/bl32.dump
endif


291
292
clean:
			@echo "  CLEAN"
293
			${Q}rm -rf ${BUILD_PLAT}
294
			${Q}${MAKE} --no-print-directory -C ${FIPTOOLPATH} clean
295

296
297
298
realclean distclean:
			@echo "  REALCLEAN"
			${Q}rm -rf ${BUILD_BASE}
299
			${Q}rm -f ${CURDIR}/cscope.*
300
			${Q}${MAKE} --no-print-directory -C ${FIPTOOLPATH} clean
301
302
303

dump:
			@echo "  OBJDUMP"
304
305
306
			${Q}${OD} -d ${BUILD_BL1}/bl1.elf > ${BUILD_BL1}/bl1.dump
			${Q}${OD} -d ${BUILD_BL2}/bl2.elf > ${BUILD_BL2}/bl2.dump
			${Q}${OD} -d ${BUILD_BL31}/bl31.elf > ${BUILD_BL31}/bl31.dump
307

308
309
310
311
312
313
314
315
316
317
318
319
checkcodebase:		locate-checkpatch
			@echo "  CHECKING STYLE"
			@if test -d .git ; then	\
				git ls-files | while read GIT_FILE ; do ${CHECKPATCH} ${CHECKCODE_ARGS} -f $$GIT_FILE ; done ;	\
			 else			\
				 find . -type f -not -iwholename "*.git*" -not -iwholename "*build*" -exec ${CHECKPATCH} ${CHECKCODE_ARGS} -f {} \; ;	\
			 fi

checkpatch:		locate-checkpatch
			@echo "  CHECKING STYLE"
			@git format-patch --stdout ${BASE_COMMIT} | ${CHECKPATCH} ${CHECKPATCH_ARGS} - || true

320
${FIPTOOL}:
321
			${Q}${MAKE} --no-print-directory -C ${FIPTOOLPATH}
322
			@echo
323
			@echo "Built $@ successfully"
324
325
			@echo

326
327
328
329
330
331
332
333
334
${BUILD_DIRS}:
			${Q}mkdir -p "$@"


${BUILD_BL1}/%.o:	%.S
			@echo "  AS      $<"
			${Q}${AS} ${ASFLAGS} -c $< -o $@

${BUILD_BL2}/%.o:	%.S
335
			@echo "  AS      $<"
336
337
338
339
340
341
342
343
344
			${Q}${AS} ${ASFLAGS} -c $< -o $@

${BUILD_BL31}/%.o:	%.S
			@echo "  AS      $<"
			${Q}${AS} ${ASFLAGS} -c $< -o $@

${BUILD_BL1}/%.o:	%.c
			@echo "  CC      $<"
			${Q}${CC} ${CFLAGS} -c $< -o $@
345

346
${BUILD_BL2}/%.o:	%.c
347
			@echo "  CC      $<"
348
			${Q}${CC} ${CFLAGS} -c $< -o $@
349

350
351
352
353
354
${BUILD_BL31}/%.o:	%.c
			@echo "  CC      $<"
			${Q}${CC} ${CFLAGS} -c $< -o $@

${BUILD_BL1}/%.ld:	%.ld.S
355
			@echo "  PP      $<"
356
			${Q}${AS} ${ASFLAGS} -P -E $< -o $@
357

358
${BUILD_BL2}/%.ld:	%.ld.S
359
			@echo "  PP      $<"
360
361
362
			${Q}${AS} ${ASFLAGS} -P -E $< -o $@

${BUILD_BL31}/%.ld:	%.ld.S
363
			@echo "  PP      $<"
364
			${Q}${AS} ${ASFLAGS} -P -E $< -o $@
365

366
367

${BUILD_BL1}/bl1.elf:	${BL1_OBJS} ${BL1_LINKERFILE}
368
			@echo "  LD      $@"
369
			${Q}${LD} -o $@ ${LDFLAGS} ${BL1_LDFLAGS} ${BL1_OBJS}
370

371
${BUILD_BL2}/bl2.elf:	${BL2_OBJS} ${BL2_LINKERFILE}
372
			@echo "  LD      $@"
373
374
375
376
377
378
			${Q}${LD} -o $@ ${LDFLAGS} ${BL2_LDFLAGS} ${BL2_OBJS}

${BUILD_BL31}/bl31.elf:	${BL31_OBJS} ${BL31_LINKERFILE}
			@echo "  LD      $@"
			${Q}${LD} -o $@ ${LDFLAGS} ${BL31_LDFLAGS} ${BL31_OBJS}

379
380
${BUILD_PLAT}/bl1.bin:	${BUILD_BL1}/bl1.elf
			@echo "  BIN     $@"
381
382
			${Q}${OC} -O binary $< $@
			@echo
383
384
385
			@echo "Built $@ successfully"
			@echo

386
387
${BUILD_PLAT}/bl2.bin:	${BUILD_BL2}/bl2.elf
			@echo "  BIN     $@"
388
389
			${Q}${OC} -O binary $< $@
			@echo
390
391
392
			@echo "Built $@ successfully"
			@echo

393
394
${BUILD_PLAT}/bl31.bin:	${BUILD_BL31}/bl31.elf
			@echo "  BIN     $@"
395
396
397
398
			${Q}${OC} -O binary $< $@
			@echo
			@echo "Built $@ successfully"
			@echo
399

400
${BUILD_PLAT}/fip.bin:	locate-bl33 ${FIP_DEPS} ${FIPTOOL}
401
402
403
404
			${Q}${FIPTOOL} --dump \
				--bl2 ${BUILD_PLAT}/bl2.bin \
				--bl31 ${BUILD_PLAT}/bl31.bin \
				--bl33 ${BL33} \
405
				${FIP_ARGS} \
406
407
				$@
			@echo
408
409
			@echo "Built $@ successfully"
			@echo
410
411


412
413
414
415
416
cscope:
	@echo "  CSCOPE"
	${Q}find ${CURDIR} -name "*.[chsS]" > cscope.files
	${Q}cscope -b -q -k

417
help:
418
	@echo "usage: ${MAKE} PLAT=<all|${HELP_PLATFORMS}> <all|bl1|bl2|bl31|distclean|clean|checkcodebase|checkpatch|dump>"
419
420
421
422
	@echo ""
	@echo "PLAT is used to specify which platform you wish to build."
	@echo ""
	@echo "Supported Targets:"
423
	@echo "  all            Build the BL1, BL2 and BL31 binaries"
424
	@echo "  bl1            Build the BL1 binary"
425
	@echo "  bl2            Build the BL2 binary"
426
427
428
429
430
	@echo "  bl31           Build the BL31 binary"
	@echo "  checkcodebase  Check the coding style of the entire source tree"
	@echo "  checkpatch     Check the coding style on changes in the current"
	@echo "                 branch against BASE_COMMIT (default origin/master)"
	@echo "  clean          Clean the build for the selected platform"
431
	@echo "  cscope         Generate cscope index"
432
433
	@echo "  distclean      Remove all build artifacts for all platforms"
	@echo "  dump           Generate object file dumps"
434
	@echo "  fiptool        Build the Firmware Image Package(FIP) creation tool"
435
436
437
438
439
	@echo ""
	@echo "note: most build targets require PLAT to be set to a specific platform."
	@echo ""
	@echo "example: build all targets for the FVP platform:"
	@echo "  CROSS_COMPILE=aarch64-none-elf- make PLAT=fvp all"