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 ${ROT_KEY},$(eval $(call CERT_ADD_CMD_OPT,${ROT_KEY},--rot-key)))
58$(if ${ROT_KEY},$(eval $(call FWU_CERT_ADD_CMD_OPT,${ROT_KEY},--rot-key)))
59$(if ${TRUSTED_WORLD_KEY},$(eval $(call CERT_ADD_CMD_OPT,${TRUSTED_WORLD_KEY},--trusted-world-key)))
60$(if ${NON_TRUSTED_WORLD_KEY},$(eval $(call CERT_ADD_CMD_OPT,${NON_TRUSTED_WORLD_KEY},--non-trusted-world-key)))
61
62# Add the BL2 CoT (image cert + image)
63$(if ${BL2},$(eval $(call CERT_ADD_CMD_OPT,${BL2},--tb-fw,true)),\
64            $(eval $(call CERT_ADD_CMD_OPT,$(call IMG_BIN,2),--tb-fw,true)))
65$(eval $(call CERT_ADD_CMD_OPT,${BUILD_PLAT}/tb_fw.crt,--tb-fw-cert))
66$(eval $(call FIP_ADD_PAYLOAD,${BUILD_PLAT}/tb_fw.crt,--tb-fw-cert))
67
68# Add the SCP_BL2 CoT (key cert + img cert + image)
69ifneq (${SCP_BL2},)
70    $(eval $(call CERT_ADD_CMD_OPT,${SCP_BL2},--scp-fw,true))
71    $(if ${SCP_BL2_KEY},$(eval $(call CERT_ADD_CMD_OPT,${SCP_BL2_KEY},--scp-fw-key)))
72    $(eval $(call CERT_ADD_CMD_OPT,${BUILD_PLAT}/scp_fw_content.crt,--scp-fw-cert))
73    $(eval $(call CERT_ADD_CMD_OPT,${BUILD_PLAT}/scp_fw_key.crt,--scp-fw-key-cert))
74    $(eval $(call FIP_ADD_PAYLOAD,${BUILD_PLAT}/scp_fw_content.crt,--scp-fw-cert))
75    $(eval $(call FIP_ADD_PAYLOAD,${BUILD_PLAT}/scp_fw_key.crt,--scp-fw-key-cert))
76endif
77
78ifeq (${ARCH},aarch64)
79# Add the BL31 CoT (key cert + img cert + image)
80$(if ${BL31},$(eval $(call CERT_ADD_CMD_OPT,${BL31},--soc-fw,true)),\
81             $(eval $(call CERT_ADD_CMD_OPT,$(call IMG_BIN,31),--soc-fw,true)))
82$(if ${BL31_KEY},$(eval $(call CERT_ADD_CMD_OPT,${BL31_KEY},--soc-fw-key)))
83$(eval $(call CERT_ADD_CMD_OPT,${BUILD_PLAT}/soc_fw_content.crt,--soc-fw-cert))
84$(eval $(call CERT_ADD_CMD_OPT,${BUILD_PLAT}/soc_fw_key.crt,--soc-fw-key-cert))
85$(eval $(call FIP_ADD_PAYLOAD,${BUILD_PLAT}/soc_fw_content.crt,--soc-fw-cert))
86$(eval $(call FIP_ADD_PAYLOAD,${BUILD_PLAT}/soc_fw_key.crt,--soc-fw-key-cert))
87endif
88
89# Add the BL32 CoT (key cert + img cert + image)
90ifeq (${NEED_BL32},yes)
91    $(if ${BL32},$(eval $(call CERT_ADD_CMD_OPT,${BL32},--tos-fw,true)),\
92                 $(if ${BL32_SOURCES},$(eval $(call CERT_ADD_CMD_OPT,$(call IMG_BIN,32),--tos-fw,true))))
93    $(if ${BL32_KEY},$(eval $(call CERT_ADD_CMD_OPT,${BL32_KEY},--tos-fw-key)))
94    $(eval $(call CERT_ADD_CMD_OPT,${BUILD_PLAT}/tos_fw_content.crt,--tos-fw-cert))
95    $(eval $(call CERT_ADD_CMD_OPT,${BUILD_PLAT}/tos_fw_key.crt,--tos-fw-key-cert))
96    $(eval $(call FIP_ADD_PAYLOAD,${BUILD_PLAT}/tos_fw_content.crt,--tos-fw-cert))
97    $(eval $(call FIP_ADD_PAYLOAD,${BUILD_PLAT}/tos_fw_key.crt,--tos-fw-key-cert))
98ifneq (${BL32_EXTRA1},)
99    $(eval $(call CERT_ADD_CMD_OPT,${BL32_EXTRA1},--tos-fw-extra1,true))
100endif
101ifneq (${BL32_EXTRA2},)
102    $(eval $(call CERT_ADD_CMD_OPT,${BL32_EXTRA2},--tos-fw-extra2,true))
103endif
104endif
105
106# Add the BL33 CoT (key cert + img cert + image)
107ifneq (${BL33},)
108    $(eval $(call CERT_ADD_CMD_OPT,${BL33},--nt-fw,true))
109    $(if ${BL33_KEY},$(eval $(call CERT_ADD_CMD_OPT,${BL33_KEY},--nt-fw-key)))
110    $(eval $(call CERT_ADD_CMD_OPT,${BUILD_PLAT}/nt_fw_content.crt,--nt-fw-cert))
111    $(eval $(call CERT_ADD_CMD_OPT,${BUILD_PLAT}/nt_fw_key.crt,--nt-fw-key-cert))
112    $(eval $(call FIP_ADD_PAYLOAD,${BUILD_PLAT}/nt_fw_content.crt,--nt-fw-cert))
113    $(eval $(call FIP_ADD_PAYLOAD,${BUILD_PLAT}/nt_fw_key.crt,--nt-fw-key-cert))
114endif
115
116# Add the BL2U image
117$(if ${BL2U},$(eval $(call FWU_CERT_ADD_CMD_OPT,${BL2U},--ap-fwu-cfg,true)),\
118     $(eval $(call FWU_CERT_ADD_CMD_OPT,$(call IMG_BIN,2u),--ap-fwu-cfg,true)))
119
120# Add the SCP_BL2U image
121ifneq (${SCP_BL2U},)
122    $(eval $(call FWU_CERT_ADD_CMD_OPT,${SCP_BL2U},--scp-fwu-cfg,true))
123endif
124
125# Add the NS_BL2U image
126ifneq (${NS_BL2U},)
127    $(eval $(call FWU_CERT_ADD_CMD_OPT,${NS_BL2U},--fwu,true))
128endif
129