1b4315306SDan Handley /* 2*71fb3964SSummer Qin * Copyright (c) 2015-2017, ARM Limited and Contributors. All rights reserved. 3b4315306SDan Handley * 482cb2c1aSdp-arm * SPDX-License-Identifier: BSD-3-Clause 5b4315306SDan Handley */ 6b4315306SDan Handley #include <assert.h> 7b4315306SDan Handley #include <debug.h> 816948ae1SJuan Castillo #include <firmware_image_package.h> 9b4315306SDan Handley #include <io_driver.h> 10b4315306SDan Handley #include <io_fip.h> 11b4315306SDan Handley #include <io_memmap.h> 12b4315306SDan Handley #include <io_storage.h> 13b4315306SDan Handley #include <platform_def.h> 14b4315306SDan Handley #include <string.h> 15ed81f3ebSSandrine Bailleux #include <utils.h> 16b4315306SDan Handley 17b4315306SDan Handley /* IO devices */ 18b4315306SDan Handley static const io_dev_connector_t *fip_dev_con; 19b4315306SDan Handley static uintptr_t fip_dev_handle; 20b4315306SDan Handley static const io_dev_connector_t *memmap_dev_con; 21b4315306SDan Handley static uintptr_t memmap_dev_handle; 22b4315306SDan Handley 23b4315306SDan Handley static const io_block_spec_t fip_block_spec = { 24b4315306SDan Handley .offset = PLAT_ARM_FIP_BASE, 25b4315306SDan Handley .length = PLAT_ARM_FIP_MAX_SIZE 26b4315306SDan Handley }; 27b4315306SDan Handley 2816948ae1SJuan Castillo static const io_uuid_spec_t bl2_uuid_spec = { 2916948ae1SJuan Castillo .uuid = UUID_TRUSTED_BOOT_FIRMWARE_BL2, 30b4315306SDan Handley }; 31b4315306SDan Handley 32f59821d5SJuan Castillo static const io_uuid_spec_t scp_bl2_uuid_spec = { 33f59821d5SJuan Castillo .uuid = UUID_SCP_FIRMWARE_SCP_BL2, 34b4315306SDan Handley }; 35b4315306SDan Handley 3616948ae1SJuan Castillo static const io_uuid_spec_t bl31_uuid_spec = { 3716948ae1SJuan Castillo .uuid = UUID_EL3_RUNTIME_FIRMWARE_BL31, 38b4315306SDan Handley }; 39b4315306SDan Handley 4016948ae1SJuan Castillo static const io_uuid_spec_t bl32_uuid_spec = { 4116948ae1SJuan Castillo .uuid = UUID_SECURE_PAYLOAD_BL32, 42b4315306SDan Handley }; 43b4315306SDan Handley 44*71fb3964SSummer Qin static const io_uuid_spec_t bl32_extra1_uuid_spec = { 45*71fb3964SSummer Qin .uuid = UUID_SECURE_PAYLOAD_BL32_EXTRA1, 46*71fb3964SSummer Qin }; 47*71fb3964SSummer Qin 48*71fb3964SSummer Qin static const io_uuid_spec_t bl32_extra2_uuid_spec = { 49*71fb3964SSummer Qin .uuid = UUID_SECURE_PAYLOAD_BL32_EXTRA2, 50*71fb3964SSummer Qin }; 51*71fb3964SSummer Qin 5216948ae1SJuan Castillo static const io_uuid_spec_t bl33_uuid_spec = { 5316948ae1SJuan Castillo .uuid = UUID_NON_TRUSTED_FIRMWARE_BL33, 54b4315306SDan Handley }; 55b4315306SDan Handley 56b4315306SDan Handley #if TRUSTED_BOARD_BOOT 57516beb58SJuan Castillo static const io_uuid_spec_t tb_fw_cert_uuid_spec = { 58516beb58SJuan Castillo .uuid = UUID_TRUSTED_BOOT_FW_CERT, 59b4315306SDan Handley }; 60b4315306SDan Handley 6116948ae1SJuan Castillo static const io_uuid_spec_t trusted_key_cert_uuid_spec = { 6216948ae1SJuan Castillo .uuid = UUID_TRUSTED_KEY_CERT, 63b4315306SDan Handley }; 64b4315306SDan Handley 65516beb58SJuan Castillo static const io_uuid_spec_t scp_fw_key_cert_uuid_spec = { 66516beb58SJuan Castillo .uuid = UUID_SCP_FW_KEY_CERT, 67b4315306SDan Handley }; 68b4315306SDan Handley 69516beb58SJuan Castillo static const io_uuid_spec_t soc_fw_key_cert_uuid_spec = { 70516beb58SJuan Castillo .uuid = UUID_SOC_FW_KEY_CERT, 71b4315306SDan Handley }; 72b4315306SDan Handley 73516beb58SJuan Castillo static const io_uuid_spec_t tos_fw_key_cert_uuid_spec = { 74516beb58SJuan Castillo .uuid = UUID_TRUSTED_OS_FW_KEY_CERT, 75b4315306SDan Handley }; 76b4315306SDan Handley 77516beb58SJuan Castillo static const io_uuid_spec_t nt_fw_key_cert_uuid_spec = { 78516beb58SJuan Castillo .uuid = UUID_NON_TRUSTED_FW_KEY_CERT, 79b4315306SDan Handley }; 80b4315306SDan Handley 81516beb58SJuan Castillo static const io_uuid_spec_t scp_fw_cert_uuid_spec = { 82516beb58SJuan Castillo .uuid = UUID_SCP_FW_CONTENT_CERT, 83b4315306SDan Handley }; 84b4315306SDan Handley 85516beb58SJuan Castillo static const io_uuid_spec_t soc_fw_cert_uuid_spec = { 86516beb58SJuan Castillo .uuid = UUID_SOC_FW_CONTENT_CERT, 87b4315306SDan Handley }; 88b4315306SDan Handley 89516beb58SJuan Castillo static const io_uuid_spec_t tos_fw_cert_uuid_spec = { 90516beb58SJuan Castillo .uuid = UUID_TRUSTED_OS_FW_CONTENT_CERT, 91b4315306SDan Handley }; 92b4315306SDan Handley 93516beb58SJuan Castillo static const io_uuid_spec_t nt_fw_cert_uuid_spec = { 94516beb58SJuan Castillo .uuid = UUID_NON_TRUSTED_FW_CONTENT_CERT, 95b4315306SDan Handley }; 96b4315306SDan Handley #endif /* TRUSTED_BOARD_BOOT */ 97b4315306SDan Handley 9816948ae1SJuan Castillo 99b4315306SDan Handley static int open_fip(const uintptr_t spec); 100b4315306SDan Handley static int open_memmap(const uintptr_t spec); 101b4315306SDan Handley 102b4315306SDan Handley struct plat_io_policy { 103b4315306SDan Handley uintptr_t *dev_handle; 104b4315306SDan Handley uintptr_t image_spec; 105b4315306SDan Handley int (*check)(const uintptr_t spec); 106b4315306SDan Handley }; 107b4315306SDan Handley 10816948ae1SJuan Castillo /* By default, ARM platforms load images from the FIP */ 109b4315306SDan Handley static const struct plat_io_policy policies[] = { 11016948ae1SJuan Castillo [FIP_IMAGE_ID] = { 111b4315306SDan Handley &memmap_dev_handle, 112b4315306SDan Handley (uintptr_t)&fip_block_spec, 113b4315306SDan Handley open_memmap 11416948ae1SJuan Castillo }, 11516948ae1SJuan Castillo [BL2_IMAGE_ID] = { 116b4315306SDan Handley &fip_dev_handle, 11716948ae1SJuan Castillo (uintptr_t)&bl2_uuid_spec, 118b4315306SDan Handley open_fip 11916948ae1SJuan Castillo }, 120f59821d5SJuan Castillo [SCP_BL2_IMAGE_ID] = { 121b4315306SDan Handley &fip_dev_handle, 122f59821d5SJuan Castillo (uintptr_t)&scp_bl2_uuid_spec, 123b4315306SDan Handley open_fip 12416948ae1SJuan Castillo }, 12516948ae1SJuan Castillo [BL31_IMAGE_ID] = { 126b4315306SDan Handley &fip_dev_handle, 12716948ae1SJuan Castillo (uintptr_t)&bl31_uuid_spec, 128b4315306SDan Handley open_fip 12916948ae1SJuan Castillo }, 13016948ae1SJuan Castillo [BL32_IMAGE_ID] = { 131b4315306SDan Handley &fip_dev_handle, 13216948ae1SJuan Castillo (uintptr_t)&bl32_uuid_spec, 133b4315306SDan Handley open_fip 13416948ae1SJuan Castillo }, 135*71fb3964SSummer Qin [BL32_EXTRA1_IMAGE_ID] = { 136*71fb3964SSummer Qin &fip_dev_handle, 137*71fb3964SSummer Qin (uintptr_t)&bl32_extra1_uuid_spec, 138*71fb3964SSummer Qin open_fip 139*71fb3964SSummer Qin }, 140*71fb3964SSummer Qin [BL32_EXTRA2_IMAGE_ID] = { 141*71fb3964SSummer Qin &fip_dev_handle, 142*71fb3964SSummer Qin (uintptr_t)&bl32_extra2_uuid_spec, 143*71fb3964SSummer Qin open_fip 144*71fb3964SSummer Qin }, 14516948ae1SJuan Castillo [BL33_IMAGE_ID] = { 146b4315306SDan Handley &fip_dev_handle, 14716948ae1SJuan Castillo (uintptr_t)&bl33_uuid_spec, 148b4315306SDan Handley open_fip 14916948ae1SJuan Castillo }, 150b4315306SDan Handley #if TRUSTED_BOARD_BOOT 151516beb58SJuan Castillo [TRUSTED_BOOT_FW_CERT_ID] = { 152b4315306SDan Handley &fip_dev_handle, 153516beb58SJuan Castillo (uintptr_t)&tb_fw_cert_uuid_spec, 154b4315306SDan Handley open_fip 15516948ae1SJuan Castillo }, 15616948ae1SJuan Castillo [TRUSTED_KEY_CERT_ID] = { 157b4315306SDan Handley &fip_dev_handle, 15816948ae1SJuan Castillo (uintptr_t)&trusted_key_cert_uuid_spec, 159b4315306SDan Handley open_fip 16016948ae1SJuan Castillo }, 161516beb58SJuan Castillo [SCP_FW_KEY_CERT_ID] = { 162b4315306SDan Handley &fip_dev_handle, 163516beb58SJuan Castillo (uintptr_t)&scp_fw_key_cert_uuid_spec, 164b4315306SDan Handley open_fip 16516948ae1SJuan Castillo }, 166516beb58SJuan Castillo [SOC_FW_KEY_CERT_ID] = { 167b4315306SDan Handley &fip_dev_handle, 168516beb58SJuan Castillo (uintptr_t)&soc_fw_key_cert_uuid_spec, 169b4315306SDan Handley open_fip 17016948ae1SJuan Castillo }, 171516beb58SJuan Castillo [TRUSTED_OS_FW_KEY_CERT_ID] = { 172b4315306SDan Handley &fip_dev_handle, 173516beb58SJuan Castillo (uintptr_t)&tos_fw_key_cert_uuid_spec, 174b4315306SDan Handley open_fip 17516948ae1SJuan Castillo }, 176516beb58SJuan Castillo [NON_TRUSTED_FW_KEY_CERT_ID] = { 177b4315306SDan Handley &fip_dev_handle, 178516beb58SJuan Castillo (uintptr_t)&nt_fw_key_cert_uuid_spec, 179b4315306SDan Handley open_fip 18016948ae1SJuan Castillo }, 181516beb58SJuan Castillo [SCP_FW_CONTENT_CERT_ID] = { 182b4315306SDan Handley &fip_dev_handle, 183516beb58SJuan Castillo (uintptr_t)&scp_fw_cert_uuid_spec, 184b4315306SDan Handley open_fip 18516948ae1SJuan Castillo }, 186516beb58SJuan Castillo [SOC_FW_CONTENT_CERT_ID] = { 187b4315306SDan Handley &fip_dev_handle, 188516beb58SJuan Castillo (uintptr_t)&soc_fw_cert_uuid_spec, 189b4315306SDan Handley open_fip 19016948ae1SJuan Castillo }, 191516beb58SJuan Castillo [TRUSTED_OS_FW_CONTENT_CERT_ID] = { 192b4315306SDan Handley &fip_dev_handle, 193516beb58SJuan Castillo (uintptr_t)&tos_fw_cert_uuid_spec, 194b4315306SDan Handley open_fip 19516948ae1SJuan Castillo }, 196516beb58SJuan Castillo [NON_TRUSTED_FW_CONTENT_CERT_ID] = { 197b4315306SDan Handley &fip_dev_handle, 198516beb58SJuan Castillo (uintptr_t)&nt_fw_cert_uuid_spec, 199b4315306SDan Handley open_fip 20016948ae1SJuan Castillo }, 201b4315306SDan Handley #endif /* TRUSTED_BOARD_BOOT */ 202b4315306SDan Handley }; 203b4315306SDan Handley 204b4315306SDan Handley 205b4315306SDan Handley /* Weak definitions may be overridden in specific ARM standard platform */ 206b4315306SDan Handley #pragma weak plat_arm_io_setup 207b4315306SDan Handley #pragma weak plat_arm_get_alt_image_source 208b4315306SDan Handley 209b4315306SDan Handley 210b4315306SDan Handley static int open_fip(const uintptr_t spec) 211b4315306SDan Handley { 212b4315306SDan Handley int result; 213b4315306SDan Handley uintptr_t local_image_handle; 214b4315306SDan Handley 215b4315306SDan Handley /* See if a Firmware Image Package is available */ 21616948ae1SJuan Castillo result = io_dev_init(fip_dev_handle, (uintptr_t)FIP_IMAGE_ID); 217e098e244SJuan Castillo if (result == 0) { 218b4315306SDan Handley result = io_open(fip_dev_handle, spec, &local_image_handle); 219e098e244SJuan Castillo if (result == 0) { 220b4315306SDan Handley VERBOSE("Using FIP\n"); 221b4315306SDan Handley io_close(local_image_handle); 222b4315306SDan Handley } 223b4315306SDan Handley } 224b4315306SDan Handley return result; 225b4315306SDan Handley } 226b4315306SDan Handley 227b4315306SDan Handley 228b4315306SDan Handley static int open_memmap(const uintptr_t spec) 229b4315306SDan Handley { 230b4315306SDan Handley int result; 231b4315306SDan Handley uintptr_t local_image_handle; 232b4315306SDan Handley 233b4315306SDan Handley result = io_dev_init(memmap_dev_handle, (uintptr_t)NULL); 234e098e244SJuan Castillo if (result == 0) { 235b4315306SDan Handley result = io_open(memmap_dev_handle, spec, &local_image_handle); 236e098e244SJuan Castillo if (result == 0) { 237b4315306SDan Handley VERBOSE("Using Memmap\n"); 238b4315306SDan Handley io_close(local_image_handle); 239b4315306SDan Handley } 240b4315306SDan Handley } 241b4315306SDan Handley return result; 242b4315306SDan Handley } 243b4315306SDan Handley 244b4315306SDan Handley 245b4315306SDan Handley void arm_io_setup(void) 246b4315306SDan Handley { 247b4315306SDan Handley int io_result; 248b4315306SDan Handley 249b4315306SDan Handley io_result = register_io_dev_fip(&fip_dev_con); 250e098e244SJuan Castillo assert(io_result == 0); 251b4315306SDan Handley 252b4315306SDan Handley io_result = register_io_dev_memmap(&memmap_dev_con); 253e098e244SJuan Castillo assert(io_result == 0); 254b4315306SDan Handley 255b4315306SDan Handley /* Open connections to devices and cache the handles */ 256b4315306SDan Handley io_result = io_dev_open(fip_dev_con, (uintptr_t)NULL, 257b4315306SDan Handley &fip_dev_handle); 258e098e244SJuan Castillo assert(io_result == 0); 259b4315306SDan Handley 260b4315306SDan Handley io_result = io_dev_open(memmap_dev_con, (uintptr_t)NULL, 261b4315306SDan Handley &memmap_dev_handle); 262e098e244SJuan Castillo assert(io_result == 0); 263b4315306SDan Handley 264b4315306SDan Handley /* Ignore improbable errors in release builds */ 265b4315306SDan Handley (void)io_result; 266b4315306SDan Handley } 267b4315306SDan Handley 268b4315306SDan Handley void plat_arm_io_setup(void) 269b4315306SDan Handley { 270b4315306SDan Handley arm_io_setup(); 271b4315306SDan Handley } 272b4315306SDan Handley 273b4315306SDan Handley int plat_arm_get_alt_image_source( 27465cd299fSSoren Brinkmann unsigned int image_id __unused, 27565cd299fSSoren Brinkmann uintptr_t *dev_handle __unused, 27665cd299fSSoren Brinkmann uintptr_t *image_spec __unused) 277b4315306SDan Handley { 278b4315306SDan Handley /* By default do not try an alternative */ 279e098e244SJuan Castillo return -ENOENT; 280b4315306SDan Handley } 281b4315306SDan Handley 282b4315306SDan Handley /* Return an IO device handle and specification which can be used to access 283b4315306SDan Handley * an image. Use this to enforce platform load policy */ 28416948ae1SJuan Castillo int plat_get_image_source(unsigned int image_id, uintptr_t *dev_handle, 285b4315306SDan Handley uintptr_t *image_spec) 286b4315306SDan Handley { 287e098e244SJuan Castillo int result; 288b4315306SDan Handley const struct plat_io_policy *policy; 289b4315306SDan Handley 29016948ae1SJuan Castillo assert(image_id < ARRAY_SIZE(policies)); 29116948ae1SJuan Castillo 29216948ae1SJuan Castillo policy = &policies[image_id]; 293b4315306SDan Handley result = policy->check(policy->image_spec); 294e098e244SJuan Castillo if (result == 0) { 295b4315306SDan Handley *image_spec = policy->image_spec; 296b4315306SDan Handley *dev_handle = *(policy->dev_handle); 297b4315306SDan Handley } else { 29816948ae1SJuan Castillo VERBOSE("Trying alternative IO\n"); 29916948ae1SJuan Castillo result = plat_arm_get_alt_image_source(image_id, dev_handle, 30016948ae1SJuan Castillo image_spec); 301b4315306SDan Handley } 30216948ae1SJuan Castillo 303b4315306SDan Handley return result; 304b4315306SDan Handley } 305436223deSYatharth Kochar 306436223deSYatharth Kochar /* 307436223deSYatharth Kochar * See if a Firmware Image Package is available, 308436223deSYatharth Kochar * by checking if TOC is valid or not. 309436223deSYatharth Kochar */ 310436223deSYatharth Kochar int arm_io_is_toc_valid(void) 311436223deSYatharth Kochar { 312436223deSYatharth Kochar int result; 313436223deSYatharth Kochar 314436223deSYatharth Kochar result = io_dev_init(fip_dev_handle, (uintptr_t)FIP_IMAGE_ID); 315436223deSYatharth Kochar 316436223deSYatharth Kochar return (result == 0); 317436223deSYatharth Kochar } 318436223deSYatharth Kochar 319