1#
2# Copyright (c) 2015-2023, 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,${NTFW_NVCTR_VAL},--ntfw-nvctr))
51ifeq (${COT},cca)
52$(eval $(call CERT_ADD_CMD_OPT,${CCAFW_NVCTR_VAL},--ccafw-nvctr))
53endif
54
55# Add Trusted Key certificate to the fiptool and cert_create command line options
56ifneq (${COT},cca)
57$(eval $(call TOOL_ADD_PAYLOAD,${TRUSTED_KEY_CERT},--trusted-key-cert))
58else
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
63
64# Add fwu certificate to the fiptool and cert_create command line options
65ifneq (${COT},cca)
66$(eval $(call TOOL_ADD_PAYLOAD,${FWU_CERT},--fwu-cert,,FWU_))
67endif
68
69# 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)))
73$(if ${KEY_ALG},$(eval $(call CERT_ADD_CMD_OPT,${KEY_ALG},--key-alg,FWU_)))
74$(if ${KEY_SIZE},$(eval $(call CERT_ADD_CMD_OPT,${KEY_SIZE},--key-size)))
75$(if ${KEY_SIZE},$(eval $(call CERT_ADD_CMD_OPT,${KEY_SIZE},--key-size,FWU_)))
76$(if ${HASH_ALG},$(eval $(call CERT_ADD_CMD_OPT,${HASH_ALG},--hash-alg)))
77$(if ${HASH_ALG},$(eval $(call CERT_ADD_CMD_OPT,${HASH_ALG},--hash-alg,FWU_)))
78$(if ${ROT_KEY},$(eval $(call CERT_ADD_CMD_OPT,${ROT_KEY},--rot-key)))
79$(if ${ROT_KEY},$(eval $(call CERT_ADD_CMD_OPT,${ROT_KEY},--rot-key,FWU_)))
80$(if ${PROT_KEY},$(eval $(call CERT_ADD_CMD_OPT,${PROT_KEY},--prot-key)))
81$(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)))
84$(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
87
88# Add the BL2 CoT (image cert)
89ifeq (${NEED_BL2},yes)
90ifeq (${RESET_TO_BL2}, 0)
91ifneq (${COT},cca)
92$(eval $(call TOOL_ADD_PAYLOAD,${BUILD_PLAT}/tb_fw.crt,--tb-fw-cert))
93endif
94endif
95endif
96
97# Add the SCP_BL2 CoT (key cert + img cert)
98ifneq (${SCP_BL2},)
99ifneq (${COT},cca)
100    $(if ${SCP_BL2_KEY},$(eval $(call CERT_ADD_CMD_OPT,${SCP_BL2_KEY},--scp-fw-key)))
101    $(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))
103endif
104endif
105
106ifeq (${ARCH},aarch64)
107ifeq (${NEED_BL31},yes)
108# Add the BL31 CoT (key cert + img cert)
109$(if ${BL31_KEY},$(eval $(call CERT_ADD_CMD_OPT,${BL31_KEY},--soc-fw-key)))
110ifneq (${COT},cca)
111$(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))
113endif
114endif
115endif
116
117# Add the BL32 CoT (key cert + img cert)
118ifeq (${NEED_BL32},yes)
119    $(if ${BL32_KEY},$(eval $(call CERT_ADD_CMD_OPT,${BL32_KEY},--tos-fw-key)))
120    $(eval $(call TOOL_ADD_PAYLOAD,${BUILD_PLAT}/tos_fw_content.crt,--tos-fw-cert))
121ifneq (${COT},cca)
122    $(eval $(call TOOL_ADD_PAYLOAD,${BUILD_PLAT}/tos_fw_key.crt,--tos-fw-key-cert))
123endif
124endif
125
126# Add the BL33 CoT (key cert + img cert)
127ifneq (${BL33},)
128    $(if ${BL33_KEY},$(eval $(call CERT_ADD_CMD_OPT,${BL33_KEY},--nt-fw-key)))
129    $(eval $(call TOOL_ADD_PAYLOAD,${BUILD_PLAT}/nt_fw_content.crt,--nt-fw-cert))
130ifneq (${COT},dualroot)
131    ifneq (${COT},cca)
132        $(eval $(call TOOL_ADD_PAYLOAD,${BUILD_PLAT}/nt_fw_key.crt,--nt-fw-key-cert))
133    endif
134endif
135endif
136
137# Add SiP owned Secure Partitions CoT (image cert)
138ifneq (${SP_LAYOUT_FILE},)
139    $(eval $(call TOOL_ADD_PAYLOAD,${BUILD_PLAT}/sip_sp_content.crt,--sip-sp-cert))
140ifeq (${COT},dualroot)
141    $(eval $(call TOOL_ADD_PAYLOAD,${BUILD_PLAT}/plat_sp_content.crt,--plat-sp-cert))
142endif
143ifeq (${COT},cca)
144    $(eval $(call TOOL_ADD_PAYLOAD,${BUILD_PLAT}/plat_sp_content.crt,--plat-sp-cert))
145endif
146endif
147