2 ## This file is part of the coreboot project.
4 ## Copyright (C) 2014 Google Inc
6 ## This program is free software; you can redistribute it and/or modify
7 ## it under the terms of the GNU General Public License as published by
8 ## the Free Software Foundation; version 2 of the License.
10 ## This program is distributed in the hope that it will be useful,
11 ## but WITHOUT ANY WARRANTY; without even the implied warranty of
12 ## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 ## GNU General Public License for more details.
17 ifeq ($(CONFIG_CCACHE),y)
19 CCACHE:=$(word 1,$(wildcard $(addsuffix /ccache,$(subst :, ,$(PATH)))))
21 $(error ccache selected, but not found in PATH)
24 export CCACHE_COMPILERCHECK=content
25 export CCACHE_BASEDIR=$(top)
27 $(foreach arch,$(ARCH_SUPPORTED), \
28 $(eval CC_$(arch):=$(CCACHE) $(CC_$(arch))))
30 HOSTCC:=$(CCACHE) $(HOSTCC)
31 HOSTCXX:=$(CCACHE) $(HOSTCXX)
32 ROMCC=$(CCACHE) $(ROMCC_BIN)
35 # scan-build integration
36 ifneq ($(CCC_ANALYZER_OUTPUT_FORMAT),)
38 ifeq ($(CCC_ANALYZER_ANALYSIS),)
39 export CCC_ANALYZER_ANALYSIS := -analyzer-opt-analyze-headers
42 $(foreach arch,$(ARCH_SUPPORTED), \
43 $(eval CC_$(arch):=CCC_CC="$(CC_$(arch))" $(CC) ))
45 HOSTCC:=CCC_CC="$(HOSTCC)" $(CC)
46 HOSTCXX:=CCC_CXX="$(HOSTCXX)" $(CXX)
47 ROMCC=CCC_CC="$(ROMCC_BIN)" $(CC)
50 COREBOOT_STANDARD_STAGES := bootblock verstage romstage ramstage
56 ARCHDIR-arm64 := arm64
57 ARCHDIR-riscv := riscv
59 ARCHDIR-power8 := power8
62 CFLAGS_arm64 += -mgeneral-regs-only
63 CFLAGS_mips += -mips32r2 -G 0 -mno-abicalls -fno-pic
66 CFLAGS_x86_64 += -mcmodel=large -mno-red-zone
69 # Some boards only provide 2K stacks, so storing lots of data there leads to
70 # problems. Since C rules don't allow us to statically determine the maximum
71 # stack use, we use 1.5K as heuristic, assuming that we typically have lots
72 # of tiny stack frames and the odd large one.
74 # Store larger buffers in BSS, use MAYBE_STATIC to share code with __PRE_RAM__
76 # Since GCCs detection of dynamic array bounds unfortunately seems to be
77 # very basic, you'll sometimes have to use a static upper bound for the
78 # size and an assert() to make sure it's honored (see gpio_base3_value()
80 # (If you absolutely need a larger stack frame and are 100% sure it cannot
81 # cause problems, you can whitelist it with #pragma diagnostic.)
82 ifeq ($(CONFIG_COMPILER_GCC),y)
83 CFLAGS_arm += -Wstack-usage=1536
84 CFLAGS_arm64 += -Wstack-usage=1536
85 CFLAGS_mips += -Wstack-usage=1536
86 CFLAGS_riscv += -Wstack-usage=1536
87 CFLAGS_power8 += -Wstack-usage=1536
91 $(foreach arch,$(ARCH_SUPPORTED),\
92 $(eval CPPFLAGS_$(arch) += \
93 -Isrc/arch/$(ARCHDIR-$(arch))/include))
95 # set_stage_toolchain: Decides the toolchain to be used by every stage
96 # E.g.: If bootblock is x86_32, it sets ARCH-BOOTBLOCK-y = x86_32, whereas
97 # ARCH-BOOTBLOCK-n = armv7. Then, ARCH-BOOTBLOCK-y can be used anywhere to
98 # decide the compiler toolchain for bootblock stage
99 # This step is essential for initializing the toolchain for coreboot standard
100 # stages i.e. bootblock, romstage and ramstage, since it acts as the second
101 # parameter to create_class_compiler below in init_standard_toolchain
102 map_stage = $(strip $(if $(MAP-$(1)),$(MAP-$(1)),$(1)))
103 set_stage_toolchain= \
104 $(foreach arch,$(ARCH_SUPPORTED), \
105 $(eval ARCH-$(1)-$($(shell \
106 echo CONFIG_ARCH_$(call map_stage,$(1))_$(arch) | \
107 tr '[:lower:]' '[:upper:]')) := $(arch)))
109 # standard-archs: Tell which architectures are used by the standard stages.
110 standard-archs = $(sort $(foreach stagearch, \
111 $(patsubst %,ARCH-%-y,$(COREBOOT_STANDARD_STAGES)), \
114 # create_class_compiler: Used to create compiler tool set for
117 # @2: compiler set to be used
118 # e.g.: smm special class uses i386 as compiler set
119 define create_class_compiler
120 $(if $(2),,$(warning *** The toolchain architecture for $(1) is unknown.) \
121 $(error Check your .config file for CONFIG_ARCH_$(1)_* settings))
122 CC_$(1) := $(CC_$(2))
123 GCC_$(1) := $(GCC_CC_$(2))
124 LD_$(1) := $(LD_$(2))
125 NM_$(1) := $(NM_$(2))
126 AR_$(1) := $(AR_$(2))
127 GNATBIND_$(1) := $(GNATBIND_$(2))
128 OBJCOPY_$(1) := $(OBJCOPY_$(2))
129 OBJDUMP_$(1) := $(OBJDUMP_$(2))
130 STRIP_$(1) := $(STRIP_$(2))
131 READELF_$(1) := $(READELF_$(2))
132 CFLAGS_$(1) = $$(CFLAGS_common) $$(CFLAGS_$(2))
133 ADAFLAGS_$(1) = --RTS=$$(obj)/libgnat-$(2)/ $$(ADAFLAGS_common) $$(GCC_CFLAGS_$(2))
134 CPPFLAGS_$(1) = $$(CPPFLAGS_common) $$(CPPFLAGS_$(2)) -D__ARCH_$(2)__
135 COMPILER_RT_$(1) := $$(COMPILER_RT_$(2))
136 COMPILER_RT_FLAGS_$(1) := $$(COMPILER_RT_FLAGS_$(2))
137 LDFLAGS_$(1) = $$(LDFLAGS_common) $$(LDFLAGS_$(2))
140 # define_class: Allows defining any program as dynamic class and compiler tool
141 # set for the same based on the architecture for which the program is to be
143 # @1: program (class name)
144 # @2: architecture for which the program needs to be compiled
145 # IMP: Ensure that define_class is called before any .c or .S files are added to
146 # the class of the program. Check subdirs-y for order of subdirectory inclusions
149 $(eval $(call create_class_compiler,$(1),$(2)))
152 # initialize standard toolchain (CC,AS and others) for give stage
153 # @1 : stage for which the toolchain is to be initialized
154 init_standard_toolchain = \
155 $(eval $(call set_stage_toolchain,$(1))) \
156 $(eval $(call create_class_compiler,$(1),$(ARCH-$(1)-y)))
159 $(foreach stage,$(COREBOOT_STANDARD_STAGES), \
160 $(eval $(call init_standard_toolchain,$(stage))))
162 $(eval $(call toolchain_to_dir))
166 # Test for coreboot toolchain (except when explicitly not requested)
167 ifneq ($(NOCOMPILE),1)
168 # Only run if we're doing a build (not for tests, kconfig, ...)
169 # rationale: gcc versions by Linux distributions tend to be quite messed up
170 # llvm/clang also needs patches supplied by the coreboot build
174 ifneq ($(CONFIG_ANY_TOOLCHAIN),y)
175 # Verify that the coreboot toolchain is being used.
176 $(foreach arch,$(sort $(foreach stage,\
177 $(COREBOOT_STANDARD_STAGES),$(ARCH-$(stage)-y))), \
178 $(if $(shell if [ -n "$(CC_$(arch))" ]; then \
179 $(CC_$(arch)) -v 2>&1 | grep -q "coreboot toolchain" || \
180 echo not-coreboot; else echo not-coreboot; fi), \
181 $(eval COMPILERFAIL:=1)\
182 $(warning The coreboot toolchain for '$(arch)'\
183 architecture was not found.)))
184 # If iasl doesn't match the current coreboot version, fail the test
185 # TODO: Figure out if iasl is even needed for the build.
186 $(if $(shell if [ -n "$(IASL)" ]; then \
187 $(IASL) -v 2>&1 | grep -q "coreboot toolchain" || \
188 echo not-coreboot; else echo not-coreboot; fi), \
189 $(eval COMPILERFAIL:=1)$(eval IASLFAIL:=1)\
190 $(warning The coreboot toolchain version of iasl \
191 '$(shell util/crossgcc/buildgcc -s iasl)' was not found))
192 else #$(CONFIG_ANY_TOOLCHAIN)
193 # If the coreboot toolchain isn't being used, verify that there is A toolchain
194 $(foreach arch,$(sort \
195 $(foreach stage,$(COREBOOT_STANDARD_STAGES),$(ARCH-$(stage)-y))), \
196 $(if $(CC_$(arch)),, $(eval COMPILERFAIL:=1) \
197 $(warning No compiler found for '$(arch)' architecture. \
198 Install one or use the coreboot toolchain?)) )
199 # If iasl isn't present, fail
200 # TODO: Figure out if iasl is even needed for the build.
201 $(if $(IASL),, $(eval COMPILERFAIL:=1)$(eval IASLFAIL:=1) \
202 $(warning iasl not found. \
203 Please install it or use the coreboot toolchain.))
206 # If the compiler check failed, print out warnings
207 ifeq ($(COMPILERFAIL),1)
210 $(warning Path to your toolchain is currently set to '$(XGCCPATH)')
213 $(warning To build the entire coreboot toolchain: run 'make crossgcc')
215 $(warning To build just IASL: run 'make iasl')
216 endif #($(IASLFAIL),1)
217 $(warning For more toolchain build targets: run 'make help_toolchain')
219 ifneq ($(CONFIG_ANY_TOOLCHAIN),y)
220 $(warning To try to use any toolchain in your path, \
221 run 'make menuconfig', then select)
222 $(warning the config option: 'General setup', \
223 and 'Allow building with any toolchain')
224 $(warning Note that this is NOT supported. \
225 Using it means you're on your own.)
227 endif #($(CONFIG_ANY_TOOLCHAIN),y)
228 $(error Halting the build)
229 endif #($(COMPILERFAIL),1)
231 endif #($(NOCOMPILE),1)
233 # Run the toolchain version checks if the requested target is 'test-toolchain'
234 # Checks the versions of GCC, binutils, clang, and IASL
235 ifneq ($(MAKECMDGOALS),)
236 ifneq ($(filter test-toolchain,$(MAKECMDGOALS)),)
237 $(foreach arch, $(ARCH_SUPPORTED), \
238 $(if $(shell if [ -n "$(GCC_CC_$(arch))" ]; then \
239 $(GCC_CC_$(arch)) -v 2>&1 | \
240 grep -q "$(shell util/crossgcc/buildgcc -s gcc)" || \
241 echo not-current; fi), \
242 $(eval COMPILER_OUT_OF_DATE:=1) \
243 $(warning The coreboot toolchain version of gcc for '$(arch)' \
244 architecture is not the current version.)) \
245 $(if $(shell if [ -n "$(CLANG_CC_$(arch))" ]; then \
246 $(CLANG_CC_$(arch)) -v 2>&1 | \
247 grep -q "$(shell util/crossgcc/buildgcc -s clang)" || \
248 echo not-current; fi), \
249 $(eval COMPILER_OUT_OF_DATE:=1)\
250 $(warning The coreboot toolchain version of clang for \
251 '$(arch)' architecture is not the current version.)) \
252 $(if $(shell if [ "$(OBJDUMP_$(arch))" != "invalidobjdump" ]; then \
253 $(OBJDUMP_$(arch)) -v 2>&1 | \
254 grep -q "$(shell util/crossgcc/buildgcc -s binutils)" || \
255 echo not-current; fi), \
256 $(eval COMPILER_OUT_OF_DATE:=1)\
257 $(warning The coreboot toolchain version of binutils for \
258 '$(arch)' architecture is not the current version.)) \
260 $(if $(shell if [ -n "$(IASL)" ]; then $(IASL) -v 2>&1 | \
261 grep -q "$(shell util/crossgcc/buildgcc -s iasl)" || \
262 echo not-coreboot; fi), \
263 $(eval COMPILER_OUT_OF_DATE:=1)\
264 $(warning The coreboot toolchain version of iasl \
265 is not the current version))
266 endif #($(filter crossgcc_check%,$(MAKECMDGOALS)),)
267 endif #($(MAKECMDGOALS),)