1# 2# Copyright (c) 2015-2017, ARM Limited and Contributors. All rights reserved. 3# 4# SPDX-License-Identifier: BSD-3-Clause 5# 6 7# This file defines the keys and certificates that must be created to establish 8# a Chain of Trust following the TBBR document. These definitions include the 9# command line options passed to the cert_create and fiptool commands. 10# 11# Expected environment: 12# 13# BUILD_PLAT: output directory 14# NEED_BL32: indicates whether BL32 is needed by the platform 15# BL2: image filename (optional). Default is IMG_BIN(2) (see macro IMG_BIN) 16# SCP_BL2: image filename (optional). Default is IMG_BIN(30) 17# BL31: image filename (optional). Default is IMG_BIN(31) 18# BL32: image filename (optional). Default is IMG_BIN(32) 19# BL33: image filename (optional). Default is IMG_BIN(33) 20# 21# Build options added by this file: 22# 23# KEY_ALG 24# ROT_KEY 25# TRUSTED_WORLD_KEY 26# NON_TRUSTED_WORLD_KEY 27# SCP_BL2_KEY 28# BL31_KEY 29# BL32_KEY 30# BL33_KEY 31# 32 33# Certificate generation tool default parameters 34TRUSTED_KEY_CERT := ${BUILD_PLAT}/trusted_key.crt 35FWU_CERT := ${BUILD_PLAT}/fwu_cert.crt 36 37# Default non-volatile counter values (overridable by the platform) 38TFW_NVCTR_VAL ?= 0 39NTFW_NVCTR_VAL ?= 0 40 41# Pass the non-volatile counters to the cert_create tool 42$(eval $(call CERT_ADD_CMD_OPT,${TFW_NVCTR_VAL},--tfw-nvctr)) 43$(eval $(call CERT_ADD_CMD_OPT,${NTFW_NVCTR_VAL},--ntfw-nvctr)) 44 45# Add Trusted Key certificate to the fiptool and cert_create command line options 46$(eval $(call FIP_ADD_PAYLOAD,${TRUSTED_KEY_CERT},--trusted-key-cert)) 47$(eval $(call CERT_ADD_CMD_OPT,${TRUSTED_KEY_CERT},--trusted-key-cert)) 48 49# Add fwu certificate to the fiptool and cert_create command line options 50$(eval $(call FWU_FIP_ADD_PAYLOAD,${FWU_CERT},--fwu-cert)) 51$(eval $(call FWU_CERT_ADD_CMD_OPT,${FWU_CERT},--fwu-cert)) 52 53# Add the keys to the cert_create command line options (private keys are NOT 54# packed in the FIP). Developers can use their own keys by specifying the proper 55# build option in the command line when building the Trusted Firmware 56$(if ${KEY_ALG},$(eval $(call CERT_ADD_CMD_OPT,${KEY_ALG},--key-alg))) 57$(if ${HASH_ALG},$(eval $(call CERT_ADD_CMD_OPT,${HASH_ALG},--hash-alg))) 58$(if ${ROT_KEY},$(eval $(call CERT_ADD_CMD_OPT,${ROT_KEY},--rot-key))) 59$(if ${ROT_KEY},$(eval $(call FWU_CERT_ADD_CMD_OPT,${ROT_KEY},--rot-key))) 60$(if ${TRUSTED_WORLD_KEY},$(eval $(call CERT_ADD_CMD_OPT,${TRUSTED_WORLD_KEY},--trusted-world-key))) 61$(if ${NON_TRUSTED_WORLD_KEY},$(eval $(call CERT_ADD_CMD_OPT,${NON_TRUSTED_WORLD_KEY},--non-trusted-world-key))) 62 63# Add the BL2 CoT (image cert + image) 64$(if ${BL2},$(eval $(call CERT_ADD_CMD_OPT,${BL2},--tb-fw,true)),\ 65 $(eval $(call CERT_ADD_CMD_OPT,$(call IMG_BIN,2),--tb-fw,true))) 66$(eval $(call CERT_ADD_CMD_OPT,${BUILD_PLAT}/tb_fw.crt,--tb-fw-cert)) 67ifeq (${BL2_AT_EL3}, 0) 68$(eval $(call FIP_ADD_PAYLOAD,${BUILD_PLAT}/tb_fw.crt,--tb-fw-cert)) 69endif 70 71# Add the SCP_BL2 CoT (key cert + img cert + image) 72ifneq (${SCP_BL2},) 73 $(eval $(call CERT_ADD_CMD_OPT,${SCP_BL2},--scp-fw,true)) 74 $(if ${SCP_BL2_KEY},$(eval $(call CERT_ADD_CMD_OPT,${SCP_BL2_KEY},--scp-fw-key))) 75 $(eval $(call CERT_ADD_CMD_OPT,${BUILD_PLAT}/scp_fw_content.crt,--scp-fw-cert)) 76 $(eval $(call CERT_ADD_CMD_OPT,${BUILD_PLAT}/scp_fw_key.crt,--scp-fw-key-cert)) 77 $(eval $(call FIP_ADD_PAYLOAD,${BUILD_PLAT}/scp_fw_content.crt,--scp-fw-cert)) 78 $(eval $(call FIP_ADD_PAYLOAD,${BUILD_PLAT}/scp_fw_key.crt,--scp-fw-key-cert)) 79endif 80 81ifeq (${ARCH},aarch64) 82ifeq (${NEED_BL31},yes) 83# Add the BL31 CoT (key cert + img cert + image) 84$(if ${BL31},$(eval $(call CERT_ADD_CMD_OPT,${BL31},--soc-fw,true)),\ 85 $(eval $(call CERT_ADD_CMD_OPT,$(call IMG_BIN,31),--soc-fw,true))) 86$(if ${BL31_KEY},$(eval $(call CERT_ADD_CMD_OPT,${BL31_KEY},--soc-fw-key))) 87$(eval $(call CERT_ADD_CMD_OPT,${BUILD_PLAT}/soc_fw_content.crt,--soc-fw-cert)) 88$(eval $(call CERT_ADD_CMD_OPT,${BUILD_PLAT}/soc_fw_key.crt,--soc-fw-key-cert)) 89$(eval $(call FIP_ADD_PAYLOAD,${BUILD_PLAT}/soc_fw_content.crt,--soc-fw-cert)) 90$(eval $(call FIP_ADD_PAYLOAD,${BUILD_PLAT}/soc_fw_key.crt,--soc-fw-key-cert)) 91endif 92endif 93 94# Add the BL32 CoT (key cert + img cert + image) 95ifeq (${NEED_BL32},yes) 96 $(if ${BL32},$(eval $(call CERT_ADD_CMD_OPT,${BL32},--tos-fw,true)),\ 97 $(if ${BL32_SOURCES},$(eval $(call CERT_ADD_CMD_OPT,$(call IMG_BIN,32),--tos-fw,true)))) 98 $(if ${BL32_KEY},$(eval $(call CERT_ADD_CMD_OPT,${BL32_KEY},--tos-fw-key))) 99 $(eval $(call CERT_ADD_CMD_OPT,${BUILD_PLAT}/tos_fw_content.crt,--tos-fw-cert)) 100 $(eval $(call CERT_ADD_CMD_OPT,${BUILD_PLAT}/tos_fw_key.crt,--tos-fw-key-cert)) 101 $(eval $(call FIP_ADD_PAYLOAD,${BUILD_PLAT}/tos_fw_content.crt,--tos-fw-cert)) 102 $(eval $(call FIP_ADD_PAYLOAD,${BUILD_PLAT}/tos_fw_key.crt,--tos-fw-key-cert)) 103ifneq (${BL32_EXTRA1},) 104 $(eval $(call CERT_ADD_CMD_OPT,${BL32_EXTRA1},--tos-fw-extra1,true)) 105endif 106ifneq (${BL32_EXTRA2},) 107 $(eval $(call CERT_ADD_CMD_OPT,${BL32_EXTRA2},--tos-fw-extra2,true)) 108endif 109endif 110 111# Add the BL33 CoT (key cert + img cert + image) 112ifneq (${BL33},) 113 $(eval $(call CERT_ADD_CMD_OPT,${BL33},--nt-fw,true)) 114 $(if ${BL33_KEY},$(eval $(call CERT_ADD_CMD_OPT,${BL33_KEY},--nt-fw-key))) 115 $(eval $(call CERT_ADD_CMD_OPT,${BUILD_PLAT}/nt_fw_content.crt,--nt-fw-cert)) 116 $(eval $(call CERT_ADD_CMD_OPT,${BUILD_PLAT}/nt_fw_key.crt,--nt-fw-key-cert)) 117 $(eval $(call FIP_ADD_PAYLOAD,${BUILD_PLAT}/nt_fw_content.crt,--nt-fw-cert)) 118 $(eval $(call FIP_ADD_PAYLOAD,${BUILD_PLAT}/nt_fw_key.crt,--nt-fw-key-cert)) 119endif 120 121# Add the BL2U image 122$(if ${BL2U},$(eval $(call FWU_CERT_ADD_CMD_OPT,${BL2U},--ap-fwu-cfg,true)),\ 123 $(eval $(call FWU_CERT_ADD_CMD_OPT,$(call IMG_BIN,2u),--ap-fwu-cfg,true))) 124 125# Add the SCP_BL2U image 126ifneq (${SCP_BL2U},) 127 $(eval $(call FWU_CERT_ADD_CMD_OPT,${SCP_BL2U},--scp-fwu-cfg,true)) 128endif 129 130# Add the NS_BL2U image 131ifneq (${NS_BL2U},) 132 $(eval $(call FWU_CERT_ADD_CMD_OPT,${NS_BL2U},--fwu,true)) 133endif 134