blob: f0adfe1cebdcaee10d88f3568f671a177c7c1466 [file] [log] [blame]
Juan Castilloa3487d12015-08-18 14:23:04 +01001#
Sandrine Bailleux172d5682020-02-03 14:57:53 +01002# Copyright (c) 2015-2020, ARM Limited and Contributors. All rights reserved.
Juan Castilloa3487d12015-08-18 14:23:04 +01003#
dp-armfa3cf0b2017-05-03 09:38:09 +01004# SPDX-License-Identifier: BSD-3-Clause
Juan Castilloa3487d12015-08-18 14:23:04 +01005#
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
dp-arm4972ec52016-05-25 16:20:20 +01009# command line options passed to the cert_create and fiptool commands.
Juan Castilloa3487d12015-08-18 14:23:04 +010010#
11# Expected environment:
12#
13# BUILD_PLAT: output directory
Juan Castillo7d199412015-12-14 09:35:25 +000014# NEED_BL32: indicates whether BL32 is needed by the platform
Juan Castilloa3487d12015-08-18 14:23:04 +010015# BL2: image filename (optional). Default is IMG_BIN(2) (see macro IMG_BIN)
Juan Castilloa72b6472015-12-10 15:49:17 +000016# SCP_BL2: image filename (optional). Default is IMG_BIN(30)
Juan Castilloa3487d12015-08-18 14:23:04 +010017# 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
Justin Chadwellfebe86c2019-07-29 17:13:45 +010024# KEY_SIZE
Juan Castilloa3487d12015-08-18 14:23:04 +010025# ROT_KEY
Sandrine Bailleux172d5682020-02-03 14:57:53 +010026# PROT_KEY
Juan Castilloa3487d12015-08-18 14:23:04 +010027# TRUSTED_WORLD_KEY
28# NON_TRUSTED_WORLD_KEY
Juan Castilloa72b6472015-12-10 15:49:17 +000029# SCP_BL2_KEY
Juan Castilloa3487d12015-08-18 14:23:04 +010030# BL31_KEY
31# BL32_KEY
32# BL33_KEY
33#
34
35# Certificate generation tool default parameters
36TRUSTED_KEY_CERT := ${BUILD_PLAT}/trusted_key.crt
Yatharth Kochard1a93432015-10-12 12:33:47 +010037FWU_CERT := ${BUILD_PLAT}/fwu_cert.crt
Juan Castilloa3487d12015-08-18 14:23:04 +010038
Juan Castillo43529982016-01-22 11:05:24 +000039# Default non-volatile counter values (overridable by the platform)
40TFW_NVCTR_VAL ?= 0
41NTFW_NVCTR_VAL ?= 0
42
43# Pass the non-volatile counters to the cert_create tool
44$(eval $(call CERT_ADD_CMD_OPT,${TFW_NVCTR_VAL},--tfw-nvctr))
45$(eval $(call CERT_ADD_CMD_OPT,${NTFW_NVCTR_VAL},--ntfw-nvctr))
46
dp-arm4972ec52016-05-25 16:20:20 +010047# Add Trusted Key certificate to the fiptool and cert_create command line options
Masahiro Yamada6c2b4592018-01-26 11:42:01 +090048$(eval $(call TOOL_ADD_PAYLOAD,${TRUSTED_KEY_CERT},--trusted-key-cert))
Juan Castilloa3487d12015-08-18 14:23:04 +010049
dp-arm4972ec52016-05-25 16:20:20 +010050# Add fwu certificate to the fiptool and cert_create command line options
Masahiro Yamada6c2b4592018-01-26 11:42:01 +090051$(eval $(call TOOL_ADD_PAYLOAD,${FWU_CERT},--fwu-cert,,FWU_))
Yatharth Kochard1a93432015-10-12 12:33:47 +010052
Juan Castilloa3487d12015-08-18 14:23:04 +010053# 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)))
Justin Chadwellfebe86c2019-07-29 17:13:45 +010057$(if ${KEY_SIZE},$(eval $(call CERT_ADD_CMD_OPT,${KEY_SIZE},--key-size)))
Qixiang Xu1a1f2912017-11-09 13:56:29 +080058$(if ${HASH_ALG},$(eval $(call CERT_ADD_CMD_OPT,${HASH_ALG},--hash-alg)))
Juan Castilloa3487d12015-08-18 14:23:04 +010059$(if ${ROT_KEY},$(eval $(call CERT_ADD_CMD_OPT,${ROT_KEY},--rot-key)))
Masahiro Yamada5ebfda32018-01-26 11:42:01 +090060$(if ${ROT_KEY},$(eval $(call CERT_ADD_CMD_OPT,${ROT_KEY},--rot-key,FWU_)))
Sandrine Bailleux172d5682020-02-03 14:57:53 +010061$(if ${PROT_KEY},$(eval $(call CERT_ADD_CMD_OPT,${PROT_KEY},--prot-key)))
Juan Castilloa3487d12015-08-18 14:23:04 +010062$(if ${TRUSTED_WORLD_KEY},$(eval $(call CERT_ADD_CMD_OPT,${TRUSTED_WORLD_KEY},--trusted-world-key)))
63$(if ${NON_TRUSTED_WORLD_KEY},$(eval $(call CERT_ADD_CMD_OPT,${NON_TRUSTED_WORLD_KEY},--non-trusted-world-key)))
64
Masahiro Yamadaec154ad2018-01-26 11:42:01 +090065
66# Add the BL2 CoT (image cert)
Roberto Vargas53c052b2018-01-02 11:23:41 +000067ifeq (${BL2_AT_EL3}, 0)
Masahiro Yamada6c2b4592018-01-26 11:42:01 +090068$(eval $(call TOOL_ADD_PAYLOAD,${BUILD_PLAT}/tb_fw.crt,--tb-fw-cert))
Roberto Vargas53c052b2018-01-02 11:23:41 +000069endif
Juan Castilloa3487d12015-08-18 14:23:04 +010070
Masahiro Yamadaec154ad2018-01-26 11:42:01 +090071# Add the SCP_BL2 CoT (key cert + img cert)
Juan Castilloa72b6472015-12-10 15:49:17 +000072ifneq (${SCP_BL2},)
Juan Castilloa72b6472015-12-10 15:49:17 +000073 $(if ${SCP_BL2_KEY},$(eval $(call CERT_ADD_CMD_OPT,${SCP_BL2_KEY},--scp-fw-key)))
Masahiro Yamada6c2b4592018-01-26 11:42:01 +090074 $(eval $(call TOOL_ADD_PAYLOAD,${BUILD_PLAT}/scp_fw_content.crt,--scp-fw-cert))
75 $(eval $(call TOOL_ADD_PAYLOAD,${BUILD_PLAT}/scp_fw_key.crt,--scp-fw-key-cert))
Juan Castilloa3487d12015-08-18 14:23:04 +010076endif
77
dp-armcdd03cb2017-02-15 11:07:55 +000078ifeq (${ARCH},aarch64)
Soby Mathewbf169232017-11-14 14:10:10 +000079ifeq (${NEED_BL31},yes)
Masahiro Yamadaec154ad2018-01-26 11:42:01 +090080# Add the BL31 CoT (key cert + img cert)
Juan Castillobe801202015-12-03 10:19:21 +000081$(if ${BL31_KEY},$(eval $(call CERT_ADD_CMD_OPT,${BL31_KEY},--soc-fw-key)))
Masahiro Yamada6c2b4592018-01-26 11:42:01 +090082$(eval $(call TOOL_ADD_PAYLOAD,${BUILD_PLAT}/soc_fw_content.crt,--soc-fw-cert))
83$(eval $(call TOOL_ADD_PAYLOAD,${BUILD_PLAT}/soc_fw_key.crt,--soc-fw-key-cert))
dp-armcdd03cb2017-02-15 11:07:55 +000084endif
Soby Mathewbf169232017-11-14 14:10:10 +000085endif
Juan Castilloa3487d12015-08-18 14:23:04 +010086
Masahiro Yamadaec154ad2018-01-26 11:42:01 +090087# Add the BL32 CoT (key cert + img cert)
Juan Castilloa3487d12015-08-18 14:23:04 +010088ifeq (${NEED_BL32},yes)
Juan Castillobe801202015-12-03 10:19:21 +000089 $(if ${BL32_KEY},$(eval $(call CERT_ADD_CMD_OPT,${BL32_KEY},--tos-fw-key)))
Masahiro Yamada6c2b4592018-01-26 11:42:01 +090090 $(eval $(call TOOL_ADD_PAYLOAD,${BUILD_PLAT}/tos_fw_content.crt,--tos-fw-cert))
91 $(eval $(call TOOL_ADD_PAYLOAD,${BUILD_PLAT}/tos_fw_key.crt,--tos-fw-key-cert))
Juan Castilloa3487d12015-08-18 14:23:04 +010092endif
93
Masahiro Yamadaec154ad2018-01-26 11:42:01 +090094# Add the BL33 CoT (key cert + img cert)
Juan Castilloa3487d12015-08-18 14:23:04 +010095ifneq (${BL33},)
Juan Castillobe801202015-12-03 10:19:21 +000096 $(if ${BL33_KEY},$(eval $(call CERT_ADD_CMD_OPT,${BL33_KEY},--nt-fw-key)))
Masahiro Yamada6c2b4592018-01-26 11:42:01 +090097 $(eval $(call TOOL_ADD_PAYLOAD,${BUILD_PLAT}/nt_fw_content.crt,--nt-fw-cert))
Sandrine Bailleux172d5682020-02-03 14:57:53 +010098ifneq (${COT},dualroot)
Masahiro Yamada6c2b4592018-01-26 11:42:01 +090099 $(eval $(call TOOL_ADD_PAYLOAD,${BUILD_PLAT}/nt_fw_key.crt,--nt-fw-key-cert))
Juan Castilloa3487d12015-08-18 14:23:04 +0100100endif
Sandrine Bailleux172d5682020-02-03 14:57:53 +0100101endif