blob: a3351eb41800081132c9a5b133506c18ac80beb4 [file] [log] [blame]
Juan Castilloa3487d12015-08-18 14:23:04 +01001#
laurenw-arm7bf67832023-05-02 14:31:01 -05002# Copyright (c) 2015-2023, 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
Manish Pandey92ef7c32021-10-01 14:34:33 +010014# NEED_BL2: indicates whether BL2 is needed by the platform
Juan Castillo7d199412015-12-14 09:35:25 +000015# NEED_BL32: indicates whether BL32 is needed by the platform
Juan Castilloa3487d12015-08-18 14:23:04 +010016# BL2: image filename (optional). Default is IMG_BIN(2) (see macro IMG_BIN)
Juan Castilloa72b6472015-12-10 15:49:17 +000017# SCP_BL2: image filename (optional). Default is IMG_BIN(30)
Juan Castilloa3487d12015-08-18 14:23:04 +010018# 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
Justin Chadwellfebe86c2019-07-29 17:13:45 +010025# KEY_SIZE
Juan Castilloa3487d12015-08-18 14:23:04 +010026# ROT_KEY
Sandrine Bailleux172d5682020-02-03 14:57:53 +010027# PROT_KEY
laurenw-arm090a6842022-04-21 16:25:52 -050028# PLAT_KEY
29# SWD_ROT_KEY
30# CORE_SWD_KEY
Juan Castilloa3487d12015-08-18 14:23:04 +010031# TRUSTED_WORLD_KEY
32# NON_TRUSTED_WORLD_KEY
Juan Castilloa72b6472015-12-10 15:49:17 +000033# SCP_BL2_KEY
Juan Castilloa3487d12015-08-18 14:23:04 +010034# BL31_KEY
35# BL32_KEY
36# BL33_KEY
37#
38
39# Certificate generation tool default parameters
Pankaj Gupta4d493802021-01-26 21:04:16 +053040TRUSTED_KEY_CERT ?= ${BUILD_PLAT}/trusted_key.crt
Yatharth Kochard1a93432015-10-12 12:33:47 +010041FWU_CERT := ${BUILD_PLAT}/fwu_cert.crt
Juan Castilloa3487d12015-08-18 14:23:04 +010042
Juan Castillo43529982016-01-22 11:05:24 +000043# Default non-volatile counter values (overridable by the platform)
44TFW_NVCTR_VAL ?= 0
45NTFW_NVCTR_VAL ?= 0
laurenw-arm7bf67832023-05-02 14:31:01 -050046CCAFW_NVCTR_VAL ?= 0
Juan Castillo43529982016-01-22 11:05:24 +000047
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,${NTFW_NVCTR_VAL},--ntfw-nvctr))
laurenw-arm7bf67832023-05-02 14:31:01 -050051ifeq (${COT},cca)
52$(eval $(call CERT_ADD_CMD_OPT,${CCAFW_NVCTR_VAL},--ccafw-nvctr))
53endif
Juan Castillo43529982016-01-22 11:05:24 +000054
dp-arm4972ec52016-05-25 16:20:20 +010055# Add Trusted Key certificate to the fiptool and cert_create command line options
laurenw-arm090a6842022-04-21 16:25:52 -050056ifneq (${COT},cca)
Masahiro Yamada6c2b4592018-01-26 11:42:01 +090057$(eval $(call TOOL_ADD_PAYLOAD,${TRUSTED_KEY_CERT},--trusted-key-cert))
laurenw-arm090a6842022-04-21 16:25:52 -050058else
59$(eval $(call TOOL_ADD_PAYLOAD,${BUILD_PLAT}/cca.crt,--cca-cert))
60$(eval $(call TOOL_ADD_PAYLOAD,${BUILD_PLAT}/core-swd.crt,--core-swd-cert))
61$(eval $(call TOOL_ADD_PAYLOAD,${BUILD_PLAT}/plat-key.crt,--plat-key-cert))
62endif
Juan Castilloa3487d12015-08-18 14:23:04 +010063
dp-arm4972ec52016-05-25 16:20:20 +010064# Add fwu certificate to the fiptool and cert_create command line options
laurenw-arm090a6842022-04-21 16:25:52 -050065ifneq (${COT},cca)
Masahiro Yamada6c2b4592018-01-26 11:42:01 +090066$(eval $(call TOOL_ADD_PAYLOAD,${FWU_CERT},--fwu-cert,,FWU_))
laurenw-arm090a6842022-04-21 16:25:52 -050067endif
Yatharth Kochard1a93432015-10-12 12:33:47 +010068
Juan Castilloa3487d12015-08-18 14:23:04 +010069# Add the keys to the cert_create command line options (private keys are NOT
70# packed in the FIP). Developers can use their own keys by specifying the proper
71# build option in the command line when building the Trusted Firmware
72$(if ${KEY_ALG},$(eval $(call CERT_ADD_CMD_OPT,${KEY_ALG},--key-alg)))
Manish V Badarkhe57d2e742020-11-08 17:38:57 +000073$(if ${KEY_ALG},$(eval $(call CERT_ADD_CMD_OPT,${KEY_ALG},--key-alg,FWU_)))
Justin Chadwellfebe86c2019-07-29 17:13:45 +010074$(if ${KEY_SIZE},$(eval $(call CERT_ADD_CMD_OPT,${KEY_SIZE},--key-size)))
Manish V Badarkhe57d2e742020-11-08 17:38:57 +000075$(if ${KEY_SIZE},$(eval $(call CERT_ADD_CMD_OPT,${KEY_SIZE},--key-size,FWU_)))
Qixiang Xu1a1f2912017-11-09 13:56:29 +080076$(if ${HASH_ALG},$(eval $(call CERT_ADD_CMD_OPT,${HASH_ALG},--hash-alg)))
Manish V Badarkhe57d2e742020-11-08 17:38:57 +000077$(if ${HASH_ALG},$(eval $(call CERT_ADD_CMD_OPT,${HASH_ALG},--hash-alg,FWU_)))
Juan Castilloa3487d12015-08-18 14:23:04 +010078$(if ${ROT_KEY},$(eval $(call CERT_ADD_CMD_OPT,${ROT_KEY},--rot-key)))
Masahiro Yamada5ebfda32018-01-26 11:42:01 +090079$(if ${ROT_KEY},$(eval $(call CERT_ADD_CMD_OPT,${ROT_KEY},--rot-key,FWU_)))
Sandrine Bailleux172d5682020-02-03 14:57:53 +010080$(if ${PROT_KEY},$(eval $(call CERT_ADD_CMD_OPT,${PROT_KEY},--prot-key)))
laurenw-arm090a6842022-04-21 16:25:52 -050081$(if ${PLAT_KEY},$(eval $(call CERT_ADD_CMD_OPT,${PLAT_KEY},--plat-key)))
82$(if ${SWD_ROT_KEY},$(eval $(call CERT_ADD_CMD_OPT,${SWD_ROT_KEY},--swd-rot-key)))
83$(if ${CORE_SWD_KEY},$(eval $(call CERT_ADD_CMD_OPT,${CORE_SWD_KEY},--core-swd-key)))
Juan Castilloa3487d12015-08-18 14:23:04 +010084$(if ${TRUSTED_WORLD_KEY},$(eval $(call CERT_ADD_CMD_OPT,${TRUSTED_WORLD_KEY},--trusted-world-key)))
85$(if ${NON_TRUSTED_WORLD_KEY},$(eval $(call CERT_ADD_CMD_OPT,${NON_TRUSTED_WORLD_KEY},--non-trusted-world-key)))
86
Masahiro Yamadaec154ad2018-01-26 11:42:01 +090087
88# Add the BL2 CoT (image cert)
Manish Pandey92ef7c32021-10-01 14:34:33 +010089ifeq (${NEED_BL2},yes)
Arvind Ram Prakash11b9b492022-11-22 14:41:00 -060090ifeq (${RESET_TO_BL2}, 0)
laurenw-arm090a6842022-04-21 16:25:52 -050091ifneq (${COT},cca)
Masahiro Yamada6c2b4592018-01-26 11:42:01 +090092$(eval $(call TOOL_ADD_PAYLOAD,${BUILD_PLAT}/tb_fw.crt,--tb-fw-cert))
Roberto Vargas53c052b2018-01-02 11:23:41 +000093endif
laurenw-arm56f1e3e2021-03-03 14:19:38 -060094endif
laurenw-arm090a6842022-04-21 16:25:52 -050095endif
Juan Castilloa3487d12015-08-18 14:23:04 +010096
Masahiro Yamadaec154ad2018-01-26 11:42:01 +090097# Add the SCP_BL2 CoT (key cert + img cert)
Juan Castilloa72b6472015-12-10 15:49:17 +000098ifneq (${SCP_BL2},)
laurenw-arm090a6842022-04-21 16:25:52 -050099ifneq (${COT},cca)
Juan Castilloa72b6472015-12-10 15:49:17 +0000100 $(if ${SCP_BL2_KEY},$(eval $(call CERT_ADD_CMD_OPT,${SCP_BL2_KEY},--scp-fw-key)))
Masahiro Yamada6c2b4592018-01-26 11:42:01 +0900101 $(eval $(call TOOL_ADD_PAYLOAD,${BUILD_PLAT}/scp_fw_content.crt,--scp-fw-cert))
102 $(eval $(call TOOL_ADD_PAYLOAD,${BUILD_PLAT}/scp_fw_key.crt,--scp-fw-key-cert))
Juan Castilloa3487d12015-08-18 14:23:04 +0100103endif
laurenw-arm090a6842022-04-21 16:25:52 -0500104endif
Juan Castilloa3487d12015-08-18 14:23:04 +0100105
dp-armcdd03cb2017-02-15 11:07:55 +0000106ifeq (${ARCH},aarch64)
Soby Mathewbf169232017-11-14 14:10:10 +0000107ifeq (${NEED_BL31},yes)
Masahiro Yamadaec154ad2018-01-26 11:42:01 +0900108# Add the BL31 CoT (key cert + img cert)
Juan Castillobe801202015-12-03 10:19:21 +0000109$(if ${BL31_KEY},$(eval $(call CERT_ADD_CMD_OPT,${BL31_KEY},--soc-fw-key)))
laurenw-arm090a6842022-04-21 16:25:52 -0500110ifneq (${COT},cca)
Masahiro Yamada6c2b4592018-01-26 11:42:01 +0900111$(eval $(call TOOL_ADD_PAYLOAD,${BUILD_PLAT}/soc_fw_content.crt,--soc-fw-cert))
112$(eval $(call TOOL_ADD_PAYLOAD,${BUILD_PLAT}/soc_fw_key.crt,--soc-fw-key-cert))
dp-armcdd03cb2017-02-15 11:07:55 +0000113endif
Soby Mathewbf169232017-11-14 14:10:10 +0000114endif
laurenw-arm090a6842022-04-21 16:25:52 -0500115endif
Juan Castilloa3487d12015-08-18 14:23:04 +0100116
Masahiro Yamadaec154ad2018-01-26 11:42:01 +0900117# Add the BL32 CoT (key cert + img cert)
Juan Castilloa3487d12015-08-18 14:23:04 +0100118ifeq (${NEED_BL32},yes)
Juan Castillobe801202015-12-03 10:19:21 +0000119 $(if ${BL32_KEY},$(eval $(call CERT_ADD_CMD_OPT,${BL32_KEY},--tos-fw-key)))
Masahiro Yamada6c2b4592018-01-26 11:42:01 +0900120 $(eval $(call TOOL_ADD_PAYLOAD,${BUILD_PLAT}/tos_fw_content.crt,--tos-fw-cert))
121 $(eval $(call TOOL_ADD_PAYLOAD,${BUILD_PLAT}/tos_fw_key.crt,--tos-fw-key-cert))
Juan Castilloa3487d12015-08-18 14:23:04 +0100122endif
123
Masahiro Yamadaec154ad2018-01-26 11:42:01 +0900124# Add the BL33 CoT (key cert + img cert)
Juan Castilloa3487d12015-08-18 14:23:04 +0100125ifneq (${BL33},)
Juan Castillobe801202015-12-03 10:19:21 +0000126 $(if ${BL33_KEY},$(eval $(call CERT_ADD_CMD_OPT,${BL33_KEY},--nt-fw-key)))
Masahiro Yamada6c2b4592018-01-26 11:42:01 +0900127 $(eval $(call TOOL_ADD_PAYLOAD,${BUILD_PLAT}/nt_fw_content.crt,--nt-fw-cert))
Sandrine Bailleux172d5682020-02-03 14:57:53 +0100128ifneq (${COT},dualroot)
laurenw-arm090a6842022-04-21 16:25:52 -0500129 ifneq (${COT},cca)
130 $(eval $(call TOOL_ADD_PAYLOAD,${BUILD_PLAT}/nt_fw_key.crt,--nt-fw-key-cert))
131 endif
Juan Castilloa3487d12015-08-18 14:23:04 +0100132endif
Sandrine Bailleux172d5682020-02-03 14:57:53 +0100133endif
Manish Pandey0a658842020-05-22 12:27:28 +0100134
135# Add SiP owned Secure Partitions CoT (image cert)
136ifneq (${SP_LAYOUT_FILE},)
137 $(eval $(call TOOL_ADD_PAYLOAD,${BUILD_PLAT}/sip_sp_content.crt,--sip-sp-cert))
Manish Pandey3f0d7af2020-07-24 16:43:54 +0100138ifeq (${COT},dualroot)
139 $(eval $(call TOOL_ADD_PAYLOAD,${BUILD_PLAT}/plat_sp_content.crt,--plat-sp-cert))
140endif
laurenw-arm090a6842022-04-21 16:25:52 -0500141ifeq (${COT},cca)
142 $(eval $(call TOOL_ADD_PAYLOAD,${BUILD_PLAT}/plat_sp_content.crt,--plat-sp-cert))
143endif
Manish Pandey0a658842020-05-22 12:27:28 +0100144endif