toolchain.inc

   1 ##
   2 ## This file is part of the coreboot project.
   3 ##
   4 ## Copyright (C) 2014 Google Inc
   5 ##
   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.
   9 ##
  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.
  14 ##
  15 ## You should have received a copy of the GNU General Public License
  16 ## along with this program; if not, write to the Free Software
  17 ## Foundation, Inc.
  18 ##
  19
  20 # ccache integration
  21 ifeq ($(CONFIG_CCACHE),y)
  22
  23 CCACHE:=$(word 1,$(wildcard $(addsuffix /ccache,$(subst :, ,$(PATH)))))
  24 ifeq ($(CCACHE),)
  25 $(error ccache selected, but not found in PATH)
  26 endif
  27
  28 export CCACHE_COMPILERCHECK=content
  29 export CCACHE_BASEDIR=$(top)
  30
  31 $(foreach arch,$(ARCH_SUPPORTED), \
  32         $(eval CC_$(arch):=$(CCACHE) $(CC_$(arch))))
  33
  34 HOSTCC:=$(CCACHE) $(HOSTCC)
  35 HOSTCXX:=$(CCACHE) $(HOSTCXX)
  36 ROMCC=$(CCACHE) $(ROMCC_BIN)
  37 endif
  38
  39 # scan-build integration
  40 ifneq ($(CCC_ANALYZER_OUTPUT_FORMAT),)
  41
  42 ifeq ($(CCC_ANALYZER_ANALYSIS),)
  43 export CCC_ANALYZER_ANALYSIS := -analyzer-opt-analyze-headers
  44 endif
  45
  46 $(foreach arch,$(ARCH_SUPPORTED), \
  47         $(eval CC_$(arch):=CCC_CC="$(CC_$(arch))" $(CC) ))
  48
  49 HOSTCC:=CCC_CC="$(HOSTCC)" $(CC)
  50 HOSTCXX:=CCC_CXX="$(HOSTCXX)" $(CXX)
  51 ROMCC=CCC_CC="$(ROMCC_BIN)" $(CC)
  52 endif
  53
  54 COREBOOT_STANDARD_STAGES := bootblock libverstage verstage romstage ramstage
  55 MAP-libverstage := verstage
  56
  57 ARCHDIR-i386    := x86
  58 ARCHDIR-x86_32  := x86
  59 ARCHDIR-x86_64  := x86
  60 ARCHDIR-arm     := arm
  61 ARCHDIR-arm64   := arm64
  62 ARCHDIR-riscv   := riscv
  63 ARCHDIR-mips    := mips
  64
  65 CFLAGS_arm      +=
  66 CFLAGS_arm64    += -mgeneral-regs-only
  67 CFLAGS_mips     += -mips32r2 -G 0 -mno-abicalls -fno-pic
  68 CFLAGS_riscv    +=
  69 CFLAGS_x86_32   +=
  70 CFLAGS_x86_64   += -mcmodel=large -mno-red-zone
  71
  72 # Some boards only provide 2K stacks, so storing lots of data there leads to
  73 # problems. Since C rules don't allow us to statically determine the maximum
  74 # stack use, we use 1.5K as heuristic, assuming that we typically have lots
  75 # of tiny stack frames and the odd large one.
  76 #
  77 # Store larger buffers in BSS, use MAYBE_STATIC to share code with __PRE_RAM__
  78 # on x86.
  79 # Since GCCs detection of dynamic array bounds unfortunately seems to be
  80 # very basic, you'll sometimes have to use a static upper bound for the
  81 # size and an assert() to make sure it's honored (see gpio_base3_value()
  82 # for an example).
  83 # (If you absolutely need a larger stack frame and are 100% sure it cannot
  84 # cause problems, you can whitelist it with #pragma diagnostic.)
  85 CFLAGS_arm      += -Wstack-usage=1536
  86 CFLAGS_arm64    += -Wstack-usage=1536
  87 CFLAGS_mips     += -Wstack-usage=1536
  88 CFLAGS_riscv    += -Wstack-usage=1536
  89
  90 toolchain_to_dir = \
  91         $(foreach arch,$(ARCH_SUPPORTED),\
  92         $(eval CPPFLAGS_$(arch) += \
  93         -Isrc/arch/$(ARCHDIR-$(arch))/include))
  94
  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),$(eval ARCH-$(1)-$($(shell echo CONFIG_ARCH_$(call map_stage,$(1))_$(arch) | tr '[:lower:]' '[:upper:]')) := $(arch)))
 105
 106 # create_class_compiler: Used to create compiler tool set for
 107 # special classes
 108 # @1: special class
 109 # @2: compiler set to be used
 110 # e.g.: smm special class uses i386 as compiler set
 111 define create_class_compiler
 112 $(if $(2),,$(error building $(1) without the required toolchain))
 113 CC_$(1) := $(CC_$(2))
 114 LD_$(1) := $(LD_$(2))
 115 NM_$(1) := $(NM_$(2))
 116 AR_$(1) := $(AR_$(2))
 117 OBJCOPY_$(1) := $(OBJCOPY_$(2))
 118 OBJDUMP_$(1) := $(OBJDUMP_$(2))
 119 STRIP_$(1) := $(STRIP_$(2))
 120 READELF_$(1) := $(READELF_$(2))
 121 CFLAGS_$(1) = $$(CFLAGS_common) $$(CFLAGS_$(2))
 122 CPPFLAGS_$(1) = $$(CPPFLAGS_common) $$(CPPFLAGS_$(2))
 123 COMPILER_RT_$(1) := $$(COMPILER_RT_$(2))
 124 COMPILER_RT_FLAGS_$(1) := $$(COMPILER_RT_FLAGS_$(2))
 125 LDFLAGS_$(1) = $$(LDFLAGS_common) $$(LDFLAGS_$(2))
 126 endef
 127
 128 # define_class: Allows defining any program as dynamic class and compiler tool
 129 # set for the same based on the architecture for which the program is to be
 130 # compiled
 131 # @1: program (class name)
 132 # @2: architecture for which the program needs to be compiled
 133 # IMP: Ensure that define_class is called before any .c or .S files are added to
 134 # the class of the program. Check subdirs-y for order of subdirectory inclusions
 135 define define_class
 136 classes-y += $(1)
 137 $(eval $(call create_class_compiler,$(1),$(2)))
 138 endef
 139
 140 # initialize standard toolchain (CC,AS and others) for give stage
 141 # @1 : stage for which the toolchain is to be initialized
 142 init_standard_toolchain = \
 143         $(eval $(call set_stage_toolchain,$(1))) \
 144         $(eval $(call create_class_compiler,$(1),$(ARCH-$(1)-y)))
 145
 146 init_stages = \
 147             $(foreach stage,$(COREBOOT_STANDARD_STAGES),$(eval $(call init_standard_toolchain,$(stage))))
 148
 149 $(eval $(call toolchain_to_dir))
 150
 151 $(call init_stages)
 152
 153 # Test for coreboot toolchain (except when explicitely not requested)
 154 ifneq ($(NOCOMPILE),1)
 155 # only run if we're doing a build (not for tests, kconfig, ...), using gcc
 156 # rationale: gcc versions by Linux distributions tend to be quite messed up
 157 COMPILERFAIL:=0
 158 ifeq ($(CONFIG_COMPILER_GCC),y)
 159 ifneq ($(CONFIG_ANY_TOOLCHAIN),y)
 160 $(foreach arch,$(sort $(foreach stage,$(COREBOOT_STANDARD_STAGES),$(ARCH-$(stage)-y))), \
 161         $(if $(shell $(CC_$(arch)) -v 2>&1 |grep -q "gcc version .*coreboot toolchain" || echo not-coreboot), \
 162                 $(eval COMPILERFAIL:=1)$(warning Please use the coreboot toolchain for '$(arch)' (or prove that your toolchain works))))
 163 endif
 164 endif
 165 endif
 166 ifeq ($(COMPILERFAIL),1)
 167 $(error consider building our compilers: make crossgcc)
 168 endif