1b4315306SDan Handley /* 2ed81f3ebSSandrine Bailleux * Copyright (c) 2015-2016, ARM Limited and Contributors. All rights reserved. 3b4315306SDan Handley * 4*82cb2c1aSdp-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 4416948ae1SJuan Castillo static const io_uuid_spec_t bl33_uuid_spec = { 4516948ae1SJuan Castillo .uuid = UUID_NON_TRUSTED_FIRMWARE_BL33, 46b4315306SDan Handley }; 47b4315306SDan Handley 48b4315306SDan Handley #if TRUSTED_BOARD_BOOT 49516beb58SJuan Castillo static const io_uuid_spec_t tb_fw_cert_uuid_spec = { 50516beb58SJuan Castillo .uuid = UUID_TRUSTED_BOOT_FW_CERT, 51b4315306SDan Handley }; 52b4315306SDan Handley 5316948ae1SJuan Castillo static const io_uuid_spec_t trusted_key_cert_uuid_spec = { 5416948ae1SJuan Castillo .uuid = UUID_TRUSTED_KEY_CERT, 55b4315306SDan Handley }; 56b4315306SDan Handley 57516beb58SJuan Castillo static const io_uuid_spec_t scp_fw_key_cert_uuid_spec = { 58516beb58SJuan Castillo .uuid = UUID_SCP_FW_KEY_CERT, 59b4315306SDan Handley }; 60b4315306SDan Handley 61516beb58SJuan Castillo static const io_uuid_spec_t soc_fw_key_cert_uuid_spec = { 62516beb58SJuan Castillo .uuid = UUID_SOC_FW_KEY_CERT, 63b4315306SDan Handley }; 64b4315306SDan Handley 65516beb58SJuan Castillo static const io_uuid_spec_t tos_fw_key_cert_uuid_spec = { 66516beb58SJuan Castillo .uuid = UUID_TRUSTED_OS_FW_KEY_CERT, 67b4315306SDan Handley }; 68b4315306SDan Handley 69516beb58SJuan Castillo static const io_uuid_spec_t nt_fw_key_cert_uuid_spec = { 70516beb58SJuan Castillo .uuid = UUID_NON_TRUSTED_FW_KEY_CERT, 71b4315306SDan Handley }; 72b4315306SDan Handley 73516beb58SJuan Castillo static const io_uuid_spec_t scp_fw_cert_uuid_spec = { 74516beb58SJuan Castillo .uuid = UUID_SCP_FW_CONTENT_CERT, 75b4315306SDan Handley }; 76b4315306SDan Handley 77516beb58SJuan Castillo static const io_uuid_spec_t soc_fw_cert_uuid_spec = { 78516beb58SJuan Castillo .uuid = UUID_SOC_FW_CONTENT_CERT, 79b4315306SDan Handley }; 80b4315306SDan Handley 81516beb58SJuan Castillo static const io_uuid_spec_t tos_fw_cert_uuid_spec = { 82516beb58SJuan Castillo .uuid = UUID_TRUSTED_OS_FW_CONTENT_CERT, 83b4315306SDan Handley }; 84b4315306SDan Handley 85516beb58SJuan Castillo static const io_uuid_spec_t nt_fw_cert_uuid_spec = { 86516beb58SJuan Castillo .uuid = UUID_NON_TRUSTED_FW_CONTENT_CERT, 87b4315306SDan Handley }; 88b4315306SDan Handley #endif /* TRUSTED_BOARD_BOOT */ 89b4315306SDan Handley 9016948ae1SJuan Castillo 91b4315306SDan Handley static int open_fip(const uintptr_t spec); 92b4315306SDan Handley static int open_memmap(const uintptr_t spec); 93b4315306SDan Handley 94b4315306SDan Handley struct plat_io_policy { 95b4315306SDan Handley uintptr_t *dev_handle; 96b4315306SDan Handley uintptr_t image_spec; 97b4315306SDan Handley int (*check)(const uintptr_t spec); 98b4315306SDan Handley }; 99b4315306SDan Handley 10016948ae1SJuan Castillo /* By default, ARM platforms load images from the FIP */ 101b4315306SDan Handley static const struct plat_io_policy policies[] = { 10216948ae1SJuan Castillo [FIP_IMAGE_ID] = { 103b4315306SDan Handley &memmap_dev_handle, 104b4315306SDan Handley (uintptr_t)&fip_block_spec, 105b4315306SDan Handley open_memmap 10616948ae1SJuan Castillo }, 10716948ae1SJuan Castillo [BL2_IMAGE_ID] = { 108b4315306SDan Handley &fip_dev_handle, 10916948ae1SJuan Castillo (uintptr_t)&bl2_uuid_spec, 110b4315306SDan Handley open_fip 11116948ae1SJuan Castillo }, 112f59821d5SJuan Castillo [SCP_BL2_IMAGE_ID] = { 113b4315306SDan Handley &fip_dev_handle, 114f59821d5SJuan Castillo (uintptr_t)&scp_bl2_uuid_spec, 115b4315306SDan Handley open_fip 11616948ae1SJuan Castillo }, 11716948ae1SJuan Castillo [BL31_IMAGE_ID] = { 118b4315306SDan Handley &fip_dev_handle, 11916948ae1SJuan Castillo (uintptr_t)&bl31_uuid_spec, 120b4315306SDan Handley open_fip 12116948ae1SJuan Castillo }, 12216948ae1SJuan Castillo [BL32_IMAGE_ID] = { 123b4315306SDan Handley &fip_dev_handle, 12416948ae1SJuan Castillo (uintptr_t)&bl32_uuid_spec, 125b4315306SDan Handley open_fip 12616948ae1SJuan Castillo }, 12716948ae1SJuan Castillo [BL33_IMAGE_ID] = { 128b4315306SDan Handley &fip_dev_handle, 12916948ae1SJuan Castillo (uintptr_t)&bl33_uuid_spec, 130b4315306SDan Handley open_fip 13116948ae1SJuan Castillo }, 132b4315306SDan Handley #if TRUSTED_BOARD_BOOT 133516beb58SJuan Castillo [TRUSTED_BOOT_FW_CERT_ID] = { 134b4315306SDan Handley &fip_dev_handle, 135516beb58SJuan Castillo (uintptr_t)&tb_fw_cert_uuid_spec, 136b4315306SDan Handley open_fip 13716948ae1SJuan Castillo }, 13816948ae1SJuan Castillo [TRUSTED_KEY_CERT_ID] = { 139b4315306SDan Handley &fip_dev_handle, 14016948ae1SJuan Castillo (uintptr_t)&trusted_key_cert_uuid_spec, 141b4315306SDan Handley open_fip 14216948ae1SJuan Castillo }, 143516beb58SJuan Castillo [SCP_FW_KEY_CERT_ID] = { 144b4315306SDan Handley &fip_dev_handle, 145516beb58SJuan Castillo (uintptr_t)&scp_fw_key_cert_uuid_spec, 146b4315306SDan Handley open_fip 14716948ae1SJuan Castillo }, 148516beb58SJuan Castillo [SOC_FW_KEY_CERT_ID] = { 149b4315306SDan Handley &fip_dev_handle, 150516beb58SJuan Castillo (uintptr_t)&soc_fw_key_cert_uuid_spec, 151b4315306SDan Handley open_fip 15216948ae1SJuan Castillo }, 153516beb58SJuan Castillo [TRUSTED_OS_FW_KEY_CERT_ID] = { 154b4315306SDan Handley &fip_dev_handle, 155516beb58SJuan Castillo (uintptr_t)&tos_fw_key_cert_uuid_spec, 156b4315306SDan Handley open_fip 15716948ae1SJuan Castillo }, 158516beb58SJuan Castillo [NON_TRUSTED_FW_KEY_CERT_ID] = { 159b4315306SDan Handley &fip_dev_handle, 160516beb58SJuan Castillo (uintptr_t)&nt_fw_key_cert_uuid_spec, 161b4315306SDan Handley open_fip 16216948ae1SJuan Castillo }, 163516beb58SJuan Castillo [SCP_FW_CONTENT_CERT_ID] = { 164b4315306SDan Handley &fip_dev_handle, 165516beb58SJuan Castillo (uintptr_t)&scp_fw_cert_uuid_spec, 166b4315306SDan Handley open_fip 16716948ae1SJuan Castillo }, 168516beb58SJuan Castillo [SOC_FW_CONTENT_CERT_ID] = { 169b4315306SDan Handley &fip_dev_handle, 170516beb58SJuan Castillo (uintptr_t)&soc_fw_cert_uuid_spec, 171b4315306SDan Handley open_fip 17216948ae1SJuan Castillo }, 173516beb58SJuan Castillo [TRUSTED_OS_FW_CONTENT_CERT_ID] = { 174b4315306SDan Handley &fip_dev_handle, 175516beb58SJuan Castillo (uintptr_t)&tos_fw_cert_uuid_spec, 176b4315306SDan Handley open_fip 17716948ae1SJuan Castillo }, 178516beb58SJuan Castillo [NON_TRUSTED_FW_CONTENT_CERT_ID] = { 179b4315306SDan Handley &fip_dev_handle, 180516beb58SJuan Castillo (uintptr_t)&nt_fw_cert_uuid_spec, 181b4315306SDan Handley open_fip 18216948ae1SJuan Castillo }, 183b4315306SDan Handley #endif /* TRUSTED_BOARD_BOOT */ 184b4315306SDan Handley }; 185b4315306SDan Handley 186b4315306SDan Handley 187b4315306SDan Handley /* Weak definitions may be overridden in specific ARM standard platform */ 188b4315306SDan Handley #pragma weak plat_arm_io_setup 189b4315306SDan Handley #pragma weak plat_arm_get_alt_image_source 190b4315306SDan Handley 191b4315306SDan Handley 192b4315306SDan Handley static int open_fip(const uintptr_t spec) 193b4315306SDan Handley { 194b4315306SDan Handley int result; 195b4315306SDan Handley uintptr_t local_image_handle; 196b4315306SDan Handley 197b4315306SDan Handley /* See if a Firmware Image Package is available */ 19816948ae1SJuan Castillo result = io_dev_init(fip_dev_handle, (uintptr_t)FIP_IMAGE_ID); 199e098e244SJuan Castillo if (result == 0) { 200b4315306SDan Handley result = io_open(fip_dev_handle, spec, &local_image_handle); 201e098e244SJuan Castillo if (result == 0) { 202b4315306SDan Handley VERBOSE("Using FIP\n"); 203b4315306SDan Handley io_close(local_image_handle); 204b4315306SDan Handley } 205b4315306SDan Handley } 206b4315306SDan Handley return result; 207b4315306SDan Handley } 208b4315306SDan Handley 209b4315306SDan Handley 210b4315306SDan Handley static int open_memmap(const uintptr_t spec) 211b4315306SDan Handley { 212b4315306SDan Handley int result; 213b4315306SDan Handley uintptr_t local_image_handle; 214b4315306SDan Handley 215b4315306SDan Handley result = io_dev_init(memmap_dev_handle, (uintptr_t)NULL); 216e098e244SJuan Castillo if (result == 0) { 217b4315306SDan Handley result = io_open(memmap_dev_handle, spec, &local_image_handle); 218e098e244SJuan Castillo if (result == 0) { 219b4315306SDan Handley VERBOSE("Using Memmap\n"); 220b4315306SDan Handley io_close(local_image_handle); 221b4315306SDan Handley } 222b4315306SDan Handley } 223b4315306SDan Handley return result; 224b4315306SDan Handley } 225b4315306SDan Handley 226b4315306SDan Handley 227b4315306SDan Handley void arm_io_setup(void) 228b4315306SDan Handley { 229b4315306SDan Handley int io_result; 230b4315306SDan Handley 231b4315306SDan Handley io_result = register_io_dev_fip(&fip_dev_con); 232e098e244SJuan Castillo assert(io_result == 0); 233b4315306SDan Handley 234b4315306SDan Handley io_result = register_io_dev_memmap(&memmap_dev_con); 235e098e244SJuan Castillo assert(io_result == 0); 236b4315306SDan Handley 237b4315306SDan Handley /* Open connections to devices and cache the handles */ 238b4315306SDan Handley io_result = io_dev_open(fip_dev_con, (uintptr_t)NULL, 239b4315306SDan Handley &fip_dev_handle); 240e098e244SJuan Castillo assert(io_result == 0); 241b4315306SDan Handley 242b4315306SDan Handley io_result = io_dev_open(memmap_dev_con, (uintptr_t)NULL, 243b4315306SDan Handley &memmap_dev_handle); 244e098e244SJuan Castillo assert(io_result == 0); 245b4315306SDan Handley 246b4315306SDan Handley /* Ignore improbable errors in release builds */ 247b4315306SDan Handley (void)io_result; 248b4315306SDan Handley } 249b4315306SDan Handley 250b4315306SDan Handley void plat_arm_io_setup(void) 251b4315306SDan Handley { 252b4315306SDan Handley arm_io_setup(); 253b4315306SDan Handley } 254b4315306SDan Handley 255b4315306SDan Handley int plat_arm_get_alt_image_source( 25665cd299fSSoren Brinkmann unsigned int image_id __unused, 25765cd299fSSoren Brinkmann uintptr_t *dev_handle __unused, 25865cd299fSSoren Brinkmann uintptr_t *image_spec __unused) 259b4315306SDan Handley { 260b4315306SDan Handley /* By default do not try an alternative */ 261e098e244SJuan Castillo return -ENOENT; 262b4315306SDan Handley } 263b4315306SDan Handley 264b4315306SDan Handley /* Return an IO device handle and specification which can be used to access 265b4315306SDan Handley * an image. Use this to enforce platform load policy */ 26616948ae1SJuan Castillo int plat_get_image_source(unsigned int image_id, uintptr_t *dev_handle, 267b4315306SDan Handley uintptr_t *image_spec) 268b4315306SDan Handley { 269e098e244SJuan Castillo int result; 270b4315306SDan Handley const struct plat_io_policy *policy; 271b4315306SDan Handley 27216948ae1SJuan Castillo assert(image_id < ARRAY_SIZE(policies)); 27316948ae1SJuan Castillo 27416948ae1SJuan Castillo policy = &policies[image_id]; 275b4315306SDan Handley result = policy->check(policy->image_spec); 276e098e244SJuan Castillo if (result == 0) { 277b4315306SDan Handley *image_spec = policy->image_spec; 278b4315306SDan Handley *dev_handle = *(policy->dev_handle); 279b4315306SDan Handley } else { 28016948ae1SJuan Castillo VERBOSE("Trying alternative IO\n"); 28116948ae1SJuan Castillo result = plat_arm_get_alt_image_source(image_id, dev_handle, 28216948ae1SJuan Castillo image_spec); 283b4315306SDan Handley } 28416948ae1SJuan Castillo 285b4315306SDan Handley return result; 286b4315306SDan Handley } 287436223deSYatharth Kochar 288436223deSYatharth Kochar /* 289436223deSYatharth Kochar * See if a Firmware Image Package is available, 290436223deSYatharth Kochar * by checking if TOC is valid or not. 291436223deSYatharth Kochar */ 292436223deSYatharth Kochar int arm_io_is_toc_valid(void) 293436223deSYatharth Kochar { 294436223deSYatharth Kochar int result; 295436223deSYatharth Kochar 296436223deSYatharth Kochar result = io_dev_init(fip_dev_handle, (uintptr_t)FIP_IMAGE_ID); 297436223deSYatharth Kochar 298436223deSYatharth Kochar return (result == 0); 299436223deSYatharth Kochar } 300436223deSYatharth Kochar 301