1# 2# Copyright (c) 2015-2025, 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_BL2: indicates whether BL2 is needed by the platform 15# NEED_BL32: indicates whether BL32 is needed by the platform 16# BL2: image filename (optional). Default is IMG_BIN(2) (see macro IMG_BIN) 17# SCP_BL2: image filename (optional). Default is IMG_BIN(30) 18# BL31: image filename (optional). Default is IMG_BIN(31) 19# BL32: image filename (optional). Default is IMG_BIN(32) 20# BL33: image filename (optional). Default is IMG_BIN(33) 21# 22# Build options added by this file: 23# 24# KEY_ALG 25# KEY_SIZE 26# ROT_KEY 27# PROT_KEY 28# PLAT_KEY 29# SWD_ROT_KEY 30# CORE_SWD_KEY 31# TRUSTED_WORLD_KEY 32# NON_TRUSTED_WORLD_KEY 33# SCP_BL2_KEY 34# BL31_KEY 35# BL32_KEY 36# BL33_KEY 37# 38 39# Certificate generation tool default parameters 40TRUSTED_KEY_CERT ?= ${BUILD_PLAT}/trusted_key.crt 41FWU_CERT := ${BUILD_PLAT}/fwu_cert.crt 42 43# Default non-volatile counter values (overridable by the platform) 44TFW_NVCTR_VAL ?= 0 45NTFW_NVCTR_VAL ?= 0 46CCAFW_NVCTR_VAL ?= 0 47 48# Pass the non-volatile counters to the cert_create tool 49$(eval $(call CERT_ADD_CMD_OPT,${TFW_NVCTR_VAL},--tfw-nvctr)) 50$(eval $(call CERT_ADD_CMD_OPT,${TFW_NVCTR_VAL},--tfw-nvctr, BL2_)) 51$(eval $(call CERT_ADD_CMD_OPT,${NTFW_NVCTR_VAL},--ntfw-nvctr)) 52ifeq (${COT},cca) 53$(eval $(call CERT_ADD_CMD_OPT,${CCAFW_NVCTR_VAL},--ccafw-nvctr)) 54endif 55 56# Add Trusted Key certificate to the fiptool and cert_create command line options 57ifneq (${COT},cca) 58$(eval $(call TOOL_ADD_PAYLOAD,${TRUSTED_KEY_CERT},--trusted-key-cert)) 59else 60$(eval $(call TOOL_ADD_PAYLOAD,${BUILD_PLAT}/cca.crt,--cca-cert)) 61$(eval $(call TOOL_ADD_PAYLOAD,${BUILD_PLAT}/core-swd.crt,--core-swd-cert)) 62$(eval $(call TOOL_ADD_PAYLOAD,${BUILD_PLAT}/plat-key.crt,--plat-key-cert)) 63endif 64 65# Add fwu certificate to the fiptool and cert_create command line options 66ifneq (${COT},cca) 67$(eval $(call TOOL_ADD_PAYLOAD,${FWU_CERT},--fwu-cert,,FWU_)) 68endif 69 70# Add the keys to the cert_create command line options (private keys are NOT 71# packed in the FIP). Developers can use their own keys by specifying the proper 72# build option in the command line when building the Trusted Firmware 73$(if ${KEY_ALG},$(eval $(call CERT_ADD_CMD_OPT,${KEY_ALG},--key-alg))) 74$(if ${KEY_ALG},$(eval $(call CERT_ADD_CMD_OPT,${KEY_ALG},--key-alg,FWU_))) 75$(if ${KEY_ALG},$(eval $(call CERT_ADD_CMD_OPT,${KEY_ALG},--key-alg,BL2_))) 76$(if ${KEY_SIZE},$(eval $(call CERT_ADD_CMD_OPT,${KEY_SIZE},--key-size))) 77$(if ${KEY_SIZE},$(eval $(call CERT_ADD_CMD_OPT,${KEY_SIZE},--key-size,FWU_))) 78$(if ${KEY_SIZE},$(eval $(call CERT_ADD_CMD_OPT,${KEY_SIZE},--key-size,BL2_))) 79$(if ${HASH_ALG},$(eval $(call CERT_ADD_CMD_OPT,${HASH_ALG},--hash-alg))) 80$(if ${HASH_ALG},$(eval $(call CERT_ADD_CMD_OPT,${HASH_ALG},--hash-alg,FWU_))) 81$(if ${HASH_ALG},$(eval $(call CERT_ADD_CMD_OPT,${HASH_ALG},--hash-alg,BL2_))) 82$(if ${ROT_KEY},$(eval $(call CERT_ADD_CMD_OPT,${ROT_KEY},--rot-key))) 83$(if ${ROT_KEY},$(eval $(call CERT_ADD_CMD_OPT,${ROT_KEY},--rot-key,FWU_))) 84$(if ${ROT_KEY},$(eval $(call CERT_ADD_CMD_OPT,${ROT_KEY},--rot-key,BL2_))) 85$(if ${PROT_KEY},$(eval $(call CERT_ADD_CMD_OPT,${PROT_KEY},--prot-key))) 86$(if ${PLAT_KEY},$(eval $(call CERT_ADD_CMD_OPT,${PLAT_KEY},--plat-key))) 87$(if ${SWD_ROT_KEY},$(eval $(call CERT_ADD_CMD_OPT,${SWD_ROT_KEY},--swd-rot-key))) 88$(if ${CORE_SWD_KEY},$(eval $(call CERT_ADD_CMD_OPT,${CORE_SWD_KEY},--core-swd-key))) 89$(if ${TRUSTED_WORLD_KEY},$(eval $(call CERT_ADD_CMD_OPT,${TRUSTED_WORLD_KEY},--trusted-world-key))) 90$(if ${NON_TRUSTED_WORLD_KEY},$(eval $(call CERT_ADD_CMD_OPT,${NON_TRUSTED_WORLD_KEY},--non-trusted-world-key))) 91 92 93# Add the BL2 CoT (image cert) 94ifeq (${NEED_BL2},yes) 95ifeq (${RESET_TO_BL2}, 0) 96ifneq (${COT},cca) 97ifeq (${SEPARATE_BL2_FIP},1) 98$(eval $(call TOOL_ADD_PAYLOAD,${BUILD_PLAT}/tb_fw.crt,--tb-fw-cert,,BL2_)) 99endif 100$(eval $(call TOOL_ADD_PAYLOAD,${BUILD_PLAT}/tb_fw.crt,--tb-fw-cert)) 101endif 102endif 103endif 104 105# Add the SCP_BL2 CoT (key cert + img cert) 106ifneq (${SCP_BL2},) 107ifneq (${COT},cca) 108 $(if ${SCP_BL2_KEY},$(eval $(call CERT_ADD_CMD_OPT,${SCP_BL2_KEY},--scp-fw-key))) 109 $(eval $(call TOOL_ADD_PAYLOAD,${BUILD_PLAT}/scp_fw_content.crt,--scp-fw-cert)) 110 $(eval $(call TOOL_ADD_PAYLOAD,${BUILD_PLAT}/scp_fw_key.crt,--scp-fw-key-cert)) 111endif 112endif 113 114ifeq (${ARCH},aarch64) 115ifeq (${NEED_BL31},yes) 116# Add the BL31 CoT (key cert + img cert) 117$(if ${BL31_KEY},$(eval $(call CERT_ADD_CMD_OPT,${BL31_KEY},--soc-fw-key))) 118ifneq (${COT},cca) 119$(eval $(call TOOL_ADD_PAYLOAD,${BUILD_PLAT}/soc_fw_content.crt,--soc-fw-cert)) 120$(eval $(call TOOL_ADD_PAYLOAD,${BUILD_PLAT}/soc_fw_key.crt,--soc-fw-key-cert)) 121endif 122endif 123endif 124 125# Add the BL32 CoT (key cert + img cert) 126ifeq (${NEED_BL32},yes) 127 $(if ${BL32_KEY},$(eval $(call CERT_ADD_CMD_OPT,${BL32_KEY},--tos-fw-key))) 128 $(eval $(call TOOL_ADD_PAYLOAD,${BUILD_PLAT}/tos_fw_content.crt,--tos-fw-cert)) 129ifneq (${COT},cca) 130 $(eval $(call TOOL_ADD_PAYLOAD,${BUILD_PLAT}/tos_fw_key.crt,--tos-fw-key-cert)) 131endif 132endif 133 134# Add the BL33 CoT (key cert + img cert) 135ifneq (${BL33},) 136 $(if ${BL33_KEY},$(eval $(call CERT_ADD_CMD_OPT,${BL33_KEY},--nt-fw-key))) 137 $(eval $(call TOOL_ADD_PAYLOAD,${BUILD_PLAT}/nt_fw_content.crt,--nt-fw-cert)) 138ifneq (${COT},dualroot) 139 ifneq (${COT},cca) 140 $(eval $(call TOOL_ADD_PAYLOAD,${BUILD_PLAT}/nt_fw_key.crt,--nt-fw-key-cert)) 141 endif 142endif 143endif 144 145# Add SiP owned Secure Partitions CoT (image cert) 146ifneq (${SP_LAYOUT_FILE},) 147 $(eval $(call TOOL_ADD_PAYLOAD,${BUILD_PLAT}/sip_sp_content.crt,--sip-sp-cert)) 148ifeq (${COT},dualroot) 149 $(eval $(call TOOL_ADD_PAYLOAD,${BUILD_PLAT}/plat_sp_content.crt,--plat-sp-cert)) 150endif 151ifeq (${COT},cca) 152 $(eval $(call TOOL_ADD_PAYLOAD,${BUILD_PLAT}/plat_sp_content.crt,--plat-sp-cert)) 153endif 154endif 155