1b4315306SDan Handley /* 2c228956aSSoby Mathew * Copyright (c) 2015-2018, 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 4471fb3964SSummer Qin static const io_uuid_spec_t bl32_extra1_uuid_spec = { 4571fb3964SSummer Qin .uuid = UUID_SECURE_PAYLOAD_BL32_EXTRA1, 4671fb3964SSummer Qin }; 4771fb3964SSummer Qin 4871fb3964SSummer Qin static const io_uuid_spec_t bl32_extra2_uuid_spec = { 4971fb3964SSummer Qin .uuid = UUID_SECURE_PAYLOAD_BL32_EXTRA2, 5071fb3964SSummer Qin }; 5171fb3964SSummer Qin 5216948ae1SJuan Castillo static const io_uuid_spec_t bl33_uuid_spec = { 5316948ae1SJuan Castillo .uuid = UUID_NON_TRUSTED_FIRMWARE_BL33, 54b4315306SDan Handley }; 55b4315306SDan Handley 56c228956aSSoby Mathew static const io_uuid_spec_t tb_fw_config_uuid_spec = { 57c228956aSSoby Mathew .uuid = UUID_TB_FW_CONFIG, 58c228956aSSoby Mathew }; 59c228956aSSoby Mathew 60*cab0b5b0SSoby Mathew static const io_uuid_spec_t hw_config_uuid_spec = { 61*cab0b5b0SSoby Mathew .uuid = UUID_HW_CONFIG, 62*cab0b5b0SSoby Mathew }; 63*cab0b5b0SSoby Mathew 64b4315306SDan Handley #if TRUSTED_BOARD_BOOT 65516beb58SJuan Castillo static const io_uuid_spec_t tb_fw_cert_uuid_spec = { 66516beb58SJuan Castillo .uuid = UUID_TRUSTED_BOOT_FW_CERT, 67b4315306SDan Handley }; 68b4315306SDan Handley 6916948ae1SJuan Castillo static const io_uuid_spec_t trusted_key_cert_uuid_spec = { 7016948ae1SJuan Castillo .uuid = UUID_TRUSTED_KEY_CERT, 71b4315306SDan Handley }; 72b4315306SDan Handley 73516beb58SJuan Castillo static const io_uuid_spec_t scp_fw_key_cert_uuid_spec = { 74516beb58SJuan Castillo .uuid = UUID_SCP_FW_KEY_CERT, 75b4315306SDan Handley }; 76b4315306SDan Handley 77516beb58SJuan Castillo static const io_uuid_spec_t soc_fw_key_cert_uuid_spec = { 78516beb58SJuan Castillo .uuid = UUID_SOC_FW_KEY_CERT, 79b4315306SDan Handley }; 80b4315306SDan Handley 81516beb58SJuan Castillo static const io_uuid_spec_t tos_fw_key_cert_uuid_spec = { 82516beb58SJuan Castillo .uuid = UUID_TRUSTED_OS_FW_KEY_CERT, 83b4315306SDan Handley }; 84b4315306SDan Handley 85516beb58SJuan Castillo static const io_uuid_spec_t nt_fw_key_cert_uuid_spec = { 86516beb58SJuan Castillo .uuid = UUID_NON_TRUSTED_FW_KEY_CERT, 87b4315306SDan Handley }; 88b4315306SDan Handley 89516beb58SJuan Castillo static const io_uuid_spec_t scp_fw_cert_uuid_spec = { 90516beb58SJuan Castillo .uuid = UUID_SCP_FW_CONTENT_CERT, 91b4315306SDan Handley }; 92b4315306SDan Handley 93516beb58SJuan Castillo static const io_uuid_spec_t soc_fw_cert_uuid_spec = { 94516beb58SJuan Castillo .uuid = UUID_SOC_FW_CONTENT_CERT, 95b4315306SDan Handley }; 96b4315306SDan Handley 97516beb58SJuan Castillo static const io_uuid_spec_t tos_fw_cert_uuid_spec = { 98516beb58SJuan Castillo .uuid = UUID_TRUSTED_OS_FW_CONTENT_CERT, 99b4315306SDan Handley }; 100b4315306SDan Handley 101516beb58SJuan Castillo static const io_uuid_spec_t nt_fw_cert_uuid_spec = { 102516beb58SJuan Castillo .uuid = UUID_NON_TRUSTED_FW_CONTENT_CERT, 103b4315306SDan Handley }; 104b4315306SDan Handley #endif /* TRUSTED_BOARD_BOOT */ 105b4315306SDan Handley 10616948ae1SJuan Castillo 107b4315306SDan Handley static int open_fip(const uintptr_t spec); 108b4315306SDan Handley static int open_memmap(const uintptr_t spec); 109b4315306SDan Handley 110b4315306SDan Handley struct plat_io_policy { 111b4315306SDan Handley uintptr_t *dev_handle; 112b4315306SDan Handley uintptr_t image_spec; 113b4315306SDan Handley int (*check)(const uintptr_t spec); 114b4315306SDan Handley }; 115b4315306SDan Handley 11616948ae1SJuan Castillo /* By default, ARM platforms load images from the FIP */ 117b4315306SDan Handley static const struct plat_io_policy policies[] = { 11816948ae1SJuan Castillo [FIP_IMAGE_ID] = { 119b4315306SDan Handley &memmap_dev_handle, 120b4315306SDan Handley (uintptr_t)&fip_block_spec, 121b4315306SDan Handley open_memmap 12216948ae1SJuan Castillo }, 12316948ae1SJuan Castillo [BL2_IMAGE_ID] = { 124b4315306SDan Handley &fip_dev_handle, 12516948ae1SJuan Castillo (uintptr_t)&bl2_uuid_spec, 126b4315306SDan Handley open_fip 12716948ae1SJuan Castillo }, 128f59821d5SJuan Castillo [SCP_BL2_IMAGE_ID] = { 129b4315306SDan Handley &fip_dev_handle, 130f59821d5SJuan Castillo (uintptr_t)&scp_bl2_uuid_spec, 131b4315306SDan Handley open_fip 13216948ae1SJuan Castillo }, 13316948ae1SJuan Castillo [BL31_IMAGE_ID] = { 134b4315306SDan Handley &fip_dev_handle, 13516948ae1SJuan Castillo (uintptr_t)&bl31_uuid_spec, 136b4315306SDan Handley open_fip 13716948ae1SJuan Castillo }, 13816948ae1SJuan Castillo [BL32_IMAGE_ID] = { 139b4315306SDan Handley &fip_dev_handle, 14016948ae1SJuan Castillo (uintptr_t)&bl32_uuid_spec, 141b4315306SDan Handley open_fip 14216948ae1SJuan Castillo }, 14371fb3964SSummer Qin [BL32_EXTRA1_IMAGE_ID] = { 14471fb3964SSummer Qin &fip_dev_handle, 14571fb3964SSummer Qin (uintptr_t)&bl32_extra1_uuid_spec, 14671fb3964SSummer Qin open_fip 14771fb3964SSummer Qin }, 14871fb3964SSummer Qin [BL32_EXTRA2_IMAGE_ID] = { 14971fb3964SSummer Qin &fip_dev_handle, 15071fb3964SSummer Qin (uintptr_t)&bl32_extra2_uuid_spec, 15171fb3964SSummer Qin open_fip 15271fb3964SSummer Qin }, 15316948ae1SJuan Castillo [BL33_IMAGE_ID] = { 154b4315306SDan Handley &fip_dev_handle, 15516948ae1SJuan Castillo (uintptr_t)&bl33_uuid_spec, 156b4315306SDan Handley open_fip 15716948ae1SJuan Castillo }, 158c228956aSSoby Mathew [TB_FW_CONFIG_ID] = { 159c228956aSSoby Mathew &fip_dev_handle, 160c228956aSSoby Mathew (uintptr_t)&tb_fw_config_uuid_spec, 161c228956aSSoby Mathew open_fip 162c228956aSSoby Mathew }, 163*cab0b5b0SSoby Mathew [HW_CONFIG_ID] = { 164*cab0b5b0SSoby Mathew &fip_dev_handle, 165*cab0b5b0SSoby Mathew (uintptr_t)&hw_config_uuid_spec, 166*cab0b5b0SSoby Mathew open_fip 167*cab0b5b0SSoby Mathew }, 168b4315306SDan Handley #if TRUSTED_BOARD_BOOT 169516beb58SJuan Castillo [TRUSTED_BOOT_FW_CERT_ID] = { 170b4315306SDan Handley &fip_dev_handle, 171516beb58SJuan Castillo (uintptr_t)&tb_fw_cert_uuid_spec, 172b4315306SDan Handley open_fip 17316948ae1SJuan Castillo }, 17416948ae1SJuan Castillo [TRUSTED_KEY_CERT_ID] = { 175b4315306SDan Handley &fip_dev_handle, 17616948ae1SJuan Castillo (uintptr_t)&trusted_key_cert_uuid_spec, 177b4315306SDan Handley open_fip 17816948ae1SJuan Castillo }, 179516beb58SJuan Castillo [SCP_FW_KEY_CERT_ID] = { 180b4315306SDan Handley &fip_dev_handle, 181516beb58SJuan Castillo (uintptr_t)&scp_fw_key_cert_uuid_spec, 182b4315306SDan Handley open_fip 18316948ae1SJuan Castillo }, 184516beb58SJuan Castillo [SOC_FW_KEY_CERT_ID] = { 185b4315306SDan Handley &fip_dev_handle, 186516beb58SJuan Castillo (uintptr_t)&soc_fw_key_cert_uuid_spec, 187b4315306SDan Handley open_fip 18816948ae1SJuan Castillo }, 189516beb58SJuan Castillo [TRUSTED_OS_FW_KEY_CERT_ID] = { 190b4315306SDan Handley &fip_dev_handle, 191516beb58SJuan Castillo (uintptr_t)&tos_fw_key_cert_uuid_spec, 192b4315306SDan Handley open_fip 19316948ae1SJuan Castillo }, 194516beb58SJuan Castillo [NON_TRUSTED_FW_KEY_CERT_ID] = { 195b4315306SDan Handley &fip_dev_handle, 196516beb58SJuan Castillo (uintptr_t)&nt_fw_key_cert_uuid_spec, 197b4315306SDan Handley open_fip 19816948ae1SJuan Castillo }, 199516beb58SJuan Castillo [SCP_FW_CONTENT_CERT_ID] = { 200b4315306SDan Handley &fip_dev_handle, 201516beb58SJuan Castillo (uintptr_t)&scp_fw_cert_uuid_spec, 202b4315306SDan Handley open_fip 20316948ae1SJuan Castillo }, 204516beb58SJuan Castillo [SOC_FW_CONTENT_CERT_ID] = { 205b4315306SDan Handley &fip_dev_handle, 206516beb58SJuan Castillo (uintptr_t)&soc_fw_cert_uuid_spec, 207b4315306SDan Handley open_fip 20816948ae1SJuan Castillo }, 209516beb58SJuan Castillo [TRUSTED_OS_FW_CONTENT_CERT_ID] = { 210b4315306SDan Handley &fip_dev_handle, 211516beb58SJuan Castillo (uintptr_t)&tos_fw_cert_uuid_spec, 212b4315306SDan Handley open_fip 21316948ae1SJuan Castillo }, 214516beb58SJuan Castillo [NON_TRUSTED_FW_CONTENT_CERT_ID] = { 215b4315306SDan Handley &fip_dev_handle, 216516beb58SJuan Castillo (uintptr_t)&nt_fw_cert_uuid_spec, 217b4315306SDan Handley open_fip 21816948ae1SJuan Castillo }, 219b4315306SDan Handley #endif /* TRUSTED_BOARD_BOOT */ 220b4315306SDan Handley }; 221b4315306SDan Handley 222b4315306SDan Handley 223b4315306SDan Handley /* Weak definitions may be overridden in specific ARM standard platform */ 224b4315306SDan Handley #pragma weak plat_arm_io_setup 225b4315306SDan Handley #pragma weak plat_arm_get_alt_image_source 226b4315306SDan Handley 227b4315306SDan Handley 228b4315306SDan Handley static int open_fip(const uintptr_t spec) 229b4315306SDan Handley { 230b4315306SDan Handley int result; 231b4315306SDan Handley uintptr_t local_image_handle; 232b4315306SDan Handley 233b4315306SDan Handley /* See if a Firmware Image Package is available */ 23416948ae1SJuan Castillo result = io_dev_init(fip_dev_handle, (uintptr_t)FIP_IMAGE_ID); 235e098e244SJuan Castillo if (result == 0) { 236b4315306SDan Handley result = io_open(fip_dev_handle, spec, &local_image_handle); 237e098e244SJuan Castillo if (result == 0) { 238b4315306SDan Handley VERBOSE("Using FIP\n"); 239b4315306SDan Handley io_close(local_image_handle); 240b4315306SDan Handley } 241b4315306SDan Handley } 242b4315306SDan Handley return result; 243b4315306SDan Handley } 244b4315306SDan Handley 245b4315306SDan Handley 246b4315306SDan Handley static int open_memmap(const uintptr_t spec) 247b4315306SDan Handley { 248b4315306SDan Handley int result; 249b4315306SDan Handley uintptr_t local_image_handle; 250b4315306SDan Handley 251b4315306SDan Handley result = io_dev_init(memmap_dev_handle, (uintptr_t)NULL); 252e098e244SJuan Castillo if (result == 0) { 253b4315306SDan Handley result = io_open(memmap_dev_handle, spec, &local_image_handle); 254e098e244SJuan Castillo if (result == 0) { 255b4315306SDan Handley VERBOSE("Using Memmap\n"); 256b4315306SDan Handley io_close(local_image_handle); 257b4315306SDan Handley } 258b4315306SDan Handley } 259b4315306SDan Handley return result; 260b4315306SDan Handley } 261b4315306SDan Handley 262b4315306SDan Handley 263b4315306SDan Handley void arm_io_setup(void) 264b4315306SDan Handley { 265b4315306SDan Handley int io_result; 266b4315306SDan Handley 267b4315306SDan Handley io_result = register_io_dev_fip(&fip_dev_con); 268e098e244SJuan Castillo assert(io_result == 0); 269b4315306SDan Handley 270b4315306SDan Handley io_result = register_io_dev_memmap(&memmap_dev_con); 271e098e244SJuan Castillo assert(io_result == 0); 272b4315306SDan Handley 273b4315306SDan Handley /* Open connections to devices and cache the handles */ 274b4315306SDan Handley io_result = io_dev_open(fip_dev_con, (uintptr_t)NULL, 275b4315306SDan Handley &fip_dev_handle); 276e098e244SJuan Castillo assert(io_result == 0); 277b4315306SDan Handley 278b4315306SDan Handley io_result = io_dev_open(memmap_dev_con, (uintptr_t)NULL, 279b4315306SDan Handley &memmap_dev_handle); 280e098e244SJuan Castillo assert(io_result == 0); 281b4315306SDan Handley 282b4315306SDan Handley /* Ignore improbable errors in release builds */ 283b4315306SDan Handley (void)io_result; 284b4315306SDan Handley } 285b4315306SDan Handley 286b4315306SDan Handley void plat_arm_io_setup(void) 287b4315306SDan Handley { 288b4315306SDan Handley arm_io_setup(); 289b4315306SDan Handley } 290b4315306SDan Handley 291b4315306SDan Handley int plat_arm_get_alt_image_source( 29265cd299fSSoren Brinkmann unsigned int image_id __unused, 29365cd299fSSoren Brinkmann uintptr_t *dev_handle __unused, 29465cd299fSSoren Brinkmann uintptr_t *image_spec __unused) 295b4315306SDan Handley { 296b4315306SDan Handley /* By default do not try an alternative */ 297e098e244SJuan Castillo return -ENOENT; 298b4315306SDan Handley } 299b4315306SDan Handley 300b4315306SDan Handley /* Return an IO device handle and specification which can be used to access 301b4315306SDan Handley * an image. Use this to enforce platform load policy */ 30216948ae1SJuan Castillo int plat_get_image_source(unsigned int image_id, uintptr_t *dev_handle, 303b4315306SDan Handley uintptr_t *image_spec) 304b4315306SDan Handley { 305e098e244SJuan Castillo int result; 306b4315306SDan Handley const struct plat_io_policy *policy; 307b4315306SDan Handley 30816948ae1SJuan Castillo assert(image_id < ARRAY_SIZE(policies)); 30916948ae1SJuan Castillo 31016948ae1SJuan Castillo policy = &policies[image_id]; 311b4315306SDan Handley result = policy->check(policy->image_spec); 312e098e244SJuan Castillo if (result == 0) { 313b4315306SDan Handley *image_spec = policy->image_spec; 314b4315306SDan Handley *dev_handle = *(policy->dev_handle); 315b4315306SDan Handley } else { 31616948ae1SJuan Castillo VERBOSE("Trying alternative IO\n"); 31716948ae1SJuan Castillo result = plat_arm_get_alt_image_source(image_id, dev_handle, 31816948ae1SJuan Castillo image_spec); 319b4315306SDan Handley } 32016948ae1SJuan Castillo 321b4315306SDan Handley return result; 322b4315306SDan Handley } 323436223deSYatharth Kochar 324436223deSYatharth Kochar /* 325436223deSYatharth Kochar * See if a Firmware Image Package is available, 326436223deSYatharth Kochar * by checking if TOC is valid or not. 327436223deSYatharth Kochar */ 328436223deSYatharth Kochar int arm_io_is_toc_valid(void) 329436223deSYatharth Kochar { 330436223deSYatharth Kochar int result; 331436223deSYatharth Kochar 332436223deSYatharth Kochar result = io_dev_init(fip_dev_handle, (uintptr_t)FIP_IMAGE_ID); 333436223deSYatharth Kochar 334436223deSYatharth Kochar return (result == 0); 335436223deSYatharth Kochar } 336436223deSYatharth Kochar 337