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> 13*1af540efSRoberto Vargas #include <plat_arm.h> 14*1af540efSRoberto Vargas #include <platform.h> 15b4315306SDan Handley #include <platform_def.h> 16b4315306SDan Handley #include <string.h> 17ed81f3ebSSandrine Bailleux #include <utils.h> 18b4315306SDan Handley 19b4315306SDan Handley /* IO devices */ 20b4315306SDan Handley static const io_dev_connector_t *fip_dev_con; 21b4315306SDan Handley static uintptr_t fip_dev_handle; 22b4315306SDan Handley static const io_dev_connector_t *memmap_dev_con; 23b4315306SDan Handley static uintptr_t memmap_dev_handle; 24b4315306SDan Handley 25b4315306SDan Handley static const io_block_spec_t fip_block_spec = { 26b4315306SDan Handley .offset = PLAT_ARM_FIP_BASE, 27b4315306SDan Handley .length = PLAT_ARM_FIP_MAX_SIZE 28b4315306SDan Handley }; 29b4315306SDan Handley 3016948ae1SJuan Castillo static const io_uuid_spec_t bl2_uuid_spec = { 3116948ae1SJuan Castillo .uuid = UUID_TRUSTED_BOOT_FIRMWARE_BL2, 32b4315306SDan Handley }; 33b4315306SDan Handley 34f59821d5SJuan Castillo static const io_uuid_spec_t scp_bl2_uuid_spec = { 35f59821d5SJuan Castillo .uuid = UUID_SCP_FIRMWARE_SCP_BL2, 36b4315306SDan Handley }; 37b4315306SDan Handley 3816948ae1SJuan Castillo static const io_uuid_spec_t bl31_uuid_spec = { 3916948ae1SJuan Castillo .uuid = UUID_EL3_RUNTIME_FIRMWARE_BL31, 40b4315306SDan Handley }; 41b4315306SDan Handley 4216948ae1SJuan Castillo static const io_uuid_spec_t bl32_uuid_spec = { 4316948ae1SJuan Castillo .uuid = UUID_SECURE_PAYLOAD_BL32, 44b4315306SDan Handley }; 45b4315306SDan Handley 4671fb3964SSummer Qin static const io_uuid_spec_t bl32_extra1_uuid_spec = { 4771fb3964SSummer Qin .uuid = UUID_SECURE_PAYLOAD_BL32_EXTRA1, 4871fb3964SSummer Qin }; 4971fb3964SSummer Qin 5071fb3964SSummer Qin static const io_uuid_spec_t bl32_extra2_uuid_spec = { 5171fb3964SSummer Qin .uuid = UUID_SECURE_PAYLOAD_BL32_EXTRA2, 5271fb3964SSummer Qin }; 5371fb3964SSummer Qin 5416948ae1SJuan Castillo static const io_uuid_spec_t bl33_uuid_spec = { 5516948ae1SJuan Castillo .uuid = UUID_NON_TRUSTED_FIRMWARE_BL33, 56b4315306SDan Handley }; 57b4315306SDan Handley 58c228956aSSoby Mathew static const io_uuid_spec_t tb_fw_config_uuid_spec = { 59c228956aSSoby Mathew .uuid = UUID_TB_FW_CONFIG, 60c228956aSSoby Mathew }; 61c228956aSSoby Mathew 62cab0b5b0SSoby Mathew static const io_uuid_spec_t hw_config_uuid_spec = { 63cab0b5b0SSoby Mathew .uuid = UUID_HW_CONFIG, 64cab0b5b0SSoby Mathew }; 65cab0b5b0SSoby Mathew 66b4315306SDan Handley #if TRUSTED_BOARD_BOOT 67516beb58SJuan Castillo static const io_uuid_spec_t tb_fw_cert_uuid_spec = { 68516beb58SJuan Castillo .uuid = UUID_TRUSTED_BOOT_FW_CERT, 69b4315306SDan Handley }; 70b4315306SDan Handley 7116948ae1SJuan Castillo static const io_uuid_spec_t trusted_key_cert_uuid_spec = { 7216948ae1SJuan Castillo .uuid = UUID_TRUSTED_KEY_CERT, 73b4315306SDan Handley }; 74b4315306SDan Handley 75516beb58SJuan Castillo static const io_uuid_spec_t scp_fw_key_cert_uuid_spec = { 76516beb58SJuan Castillo .uuid = UUID_SCP_FW_KEY_CERT, 77b4315306SDan Handley }; 78b4315306SDan Handley 79516beb58SJuan Castillo static const io_uuid_spec_t soc_fw_key_cert_uuid_spec = { 80516beb58SJuan Castillo .uuid = UUID_SOC_FW_KEY_CERT, 81b4315306SDan Handley }; 82b4315306SDan Handley 83516beb58SJuan Castillo static const io_uuid_spec_t tos_fw_key_cert_uuid_spec = { 84516beb58SJuan Castillo .uuid = UUID_TRUSTED_OS_FW_KEY_CERT, 85b4315306SDan Handley }; 86b4315306SDan Handley 87516beb58SJuan Castillo static const io_uuid_spec_t nt_fw_key_cert_uuid_spec = { 88516beb58SJuan Castillo .uuid = UUID_NON_TRUSTED_FW_KEY_CERT, 89b4315306SDan Handley }; 90b4315306SDan Handley 91516beb58SJuan Castillo static const io_uuid_spec_t scp_fw_cert_uuid_spec = { 92516beb58SJuan Castillo .uuid = UUID_SCP_FW_CONTENT_CERT, 93b4315306SDan Handley }; 94b4315306SDan Handley 95516beb58SJuan Castillo static const io_uuid_spec_t soc_fw_cert_uuid_spec = { 96516beb58SJuan Castillo .uuid = UUID_SOC_FW_CONTENT_CERT, 97b4315306SDan Handley }; 98b4315306SDan Handley 99516beb58SJuan Castillo static const io_uuid_spec_t tos_fw_cert_uuid_spec = { 100516beb58SJuan Castillo .uuid = UUID_TRUSTED_OS_FW_CONTENT_CERT, 101b4315306SDan Handley }; 102b4315306SDan Handley 103516beb58SJuan Castillo static const io_uuid_spec_t nt_fw_cert_uuid_spec = { 104516beb58SJuan Castillo .uuid = UUID_NON_TRUSTED_FW_CONTENT_CERT, 105b4315306SDan Handley }; 106b4315306SDan Handley #endif /* TRUSTED_BOARD_BOOT */ 107b4315306SDan Handley 10816948ae1SJuan Castillo 109b4315306SDan Handley static int open_fip(const uintptr_t spec); 110b4315306SDan Handley static int open_memmap(const uintptr_t spec); 111b4315306SDan Handley 112b4315306SDan Handley struct plat_io_policy { 113b4315306SDan Handley uintptr_t *dev_handle; 114b4315306SDan Handley uintptr_t image_spec; 115b4315306SDan Handley int (*check)(const uintptr_t spec); 116b4315306SDan Handley }; 117b4315306SDan Handley 11816948ae1SJuan Castillo /* By default, ARM platforms load images from the FIP */ 119b4315306SDan Handley static const struct plat_io_policy policies[] = { 12016948ae1SJuan Castillo [FIP_IMAGE_ID] = { 121b4315306SDan Handley &memmap_dev_handle, 122b4315306SDan Handley (uintptr_t)&fip_block_spec, 123b4315306SDan Handley open_memmap 12416948ae1SJuan Castillo }, 12516948ae1SJuan Castillo [BL2_IMAGE_ID] = { 126b4315306SDan Handley &fip_dev_handle, 12716948ae1SJuan Castillo (uintptr_t)&bl2_uuid_spec, 128b4315306SDan Handley open_fip 12916948ae1SJuan Castillo }, 130f59821d5SJuan Castillo [SCP_BL2_IMAGE_ID] = { 131b4315306SDan Handley &fip_dev_handle, 132f59821d5SJuan Castillo (uintptr_t)&scp_bl2_uuid_spec, 133b4315306SDan Handley open_fip 13416948ae1SJuan Castillo }, 13516948ae1SJuan Castillo [BL31_IMAGE_ID] = { 136b4315306SDan Handley &fip_dev_handle, 13716948ae1SJuan Castillo (uintptr_t)&bl31_uuid_spec, 138b4315306SDan Handley open_fip 13916948ae1SJuan Castillo }, 14016948ae1SJuan Castillo [BL32_IMAGE_ID] = { 141b4315306SDan Handley &fip_dev_handle, 14216948ae1SJuan Castillo (uintptr_t)&bl32_uuid_spec, 143b4315306SDan Handley open_fip 14416948ae1SJuan Castillo }, 14571fb3964SSummer Qin [BL32_EXTRA1_IMAGE_ID] = { 14671fb3964SSummer Qin &fip_dev_handle, 14771fb3964SSummer Qin (uintptr_t)&bl32_extra1_uuid_spec, 14871fb3964SSummer Qin open_fip 14971fb3964SSummer Qin }, 15071fb3964SSummer Qin [BL32_EXTRA2_IMAGE_ID] = { 15171fb3964SSummer Qin &fip_dev_handle, 15271fb3964SSummer Qin (uintptr_t)&bl32_extra2_uuid_spec, 15371fb3964SSummer Qin open_fip 15471fb3964SSummer Qin }, 15516948ae1SJuan Castillo [BL33_IMAGE_ID] = { 156b4315306SDan Handley &fip_dev_handle, 15716948ae1SJuan Castillo (uintptr_t)&bl33_uuid_spec, 158b4315306SDan Handley open_fip 15916948ae1SJuan Castillo }, 160c228956aSSoby Mathew [TB_FW_CONFIG_ID] = { 161c228956aSSoby Mathew &fip_dev_handle, 162c228956aSSoby Mathew (uintptr_t)&tb_fw_config_uuid_spec, 163c228956aSSoby Mathew open_fip 164c228956aSSoby Mathew }, 165cab0b5b0SSoby Mathew [HW_CONFIG_ID] = { 166cab0b5b0SSoby Mathew &fip_dev_handle, 167cab0b5b0SSoby Mathew (uintptr_t)&hw_config_uuid_spec, 168cab0b5b0SSoby Mathew open_fip 169cab0b5b0SSoby Mathew }, 170b4315306SDan Handley #if TRUSTED_BOARD_BOOT 171516beb58SJuan Castillo [TRUSTED_BOOT_FW_CERT_ID] = { 172b4315306SDan Handley &fip_dev_handle, 173516beb58SJuan Castillo (uintptr_t)&tb_fw_cert_uuid_spec, 174b4315306SDan Handley open_fip 17516948ae1SJuan Castillo }, 17616948ae1SJuan Castillo [TRUSTED_KEY_CERT_ID] = { 177b4315306SDan Handley &fip_dev_handle, 17816948ae1SJuan Castillo (uintptr_t)&trusted_key_cert_uuid_spec, 179b4315306SDan Handley open_fip 18016948ae1SJuan Castillo }, 181516beb58SJuan Castillo [SCP_FW_KEY_CERT_ID] = { 182b4315306SDan Handley &fip_dev_handle, 183516beb58SJuan Castillo (uintptr_t)&scp_fw_key_cert_uuid_spec, 184b4315306SDan Handley open_fip 18516948ae1SJuan Castillo }, 186516beb58SJuan Castillo [SOC_FW_KEY_CERT_ID] = { 187b4315306SDan Handley &fip_dev_handle, 188516beb58SJuan Castillo (uintptr_t)&soc_fw_key_cert_uuid_spec, 189b4315306SDan Handley open_fip 19016948ae1SJuan Castillo }, 191516beb58SJuan Castillo [TRUSTED_OS_FW_KEY_CERT_ID] = { 192b4315306SDan Handley &fip_dev_handle, 193516beb58SJuan Castillo (uintptr_t)&tos_fw_key_cert_uuid_spec, 194b4315306SDan Handley open_fip 19516948ae1SJuan Castillo }, 196516beb58SJuan Castillo [NON_TRUSTED_FW_KEY_CERT_ID] = { 197b4315306SDan Handley &fip_dev_handle, 198516beb58SJuan Castillo (uintptr_t)&nt_fw_key_cert_uuid_spec, 199b4315306SDan Handley open_fip 20016948ae1SJuan Castillo }, 201516beb58SJuan Castillo [SCP_FW_CONTENT_CERT_ID] = { 202b4315306SDan Handley &fip_dev_handle, 203516beb58SJuan Castillo (uintptr_t)&scp_fw_cert_uuid_spec, 204b4315306SDan Handley open_fip 20516948ae1SJuan Castillo }, 206516beb58SJuan Castillo [SOC_FW_CONTENT_CERT_ID] = { 207b4315306SDan Handley &fip_dev_handle, 208516beb58SJuan Castillo (uintptr_t)&soc_fw_cert_uuid_spec, 209b4315306SDan Handley open_fip 21016948ae1SJuan Castillo }, 211516beb58SJuan Castillo [TRUSTED_OS_FW_CONTENT_CERT_ID] = { 212b4315306SDan Handley &fip_dev_handle, 213516beb58SJuan Castillo (uintptr_t)&tos_fw_cert_uuid_spec, 214b4315306SDan Handley open_fip 21516948ae1SJuan Castillo }, 216516beb58SJuan Castillo [NON_TRUSTED_FW_CONTENT_CERT_ID] = { 217b4315306SDan Handley &fip_dev_handle, 218516beb58SJuan Castillo (uintptr_t)&nt_fw_cert_uuid_spec, 219b4315306SDan Handley open_fip 22016948ae1SJuan Castillo }, 221b4315306SDan Handley #endif /* TRUSTED_BOARD_BOOT */ 222b4315306SDan Handley }; 223b4315306SDan Handley 224b4315306SDan Handley 225b4315306SDan Handley /* Weak definitions may be overridden in specific ARM standard platform */ 226b4315306SDan Handley #pragma weak plat_arm_io_setup 227b4315306SDan Handley #pragma weak plat_arm_get_alt_image_source 228b4315306SDan Handley 229b4315306SDan Handley 230b4315306SDan Handley static int open_fip(const uintptr_t spec) 231b4315306SDan Handley { 232b4315306SDan Handley int result; 233b4315306SDan Handley uintptr_t local_image_handle; 234b4315306SDan Handley 235b4315306SDan Handley /* See if a Firmware Image Package is available */ 23616948ae1SJuan Castillo result = io_dev_init(fip_dev_handle, (uintptr_t)FIP_IMAGE_ID); 237e098e244SJuan Castillo if (result == 0) { 238b4315306SDan Handley result = io_open(fip_dev_handle, spec, &local_image_handle); 239e098e244SJuan Castillo if (result == 0) { 240b4315306SDan Handley VERBOSE("Using FIP\n"); 241b4315306SDan Handley io_close(local_image_handle); 242b4315306SDan Handley } 243b4315306SDan Handley } 244b4315306SDan Handley return result; 245b4315306SDan Handley } 246b4315306SDan Handley 247b4315306SDan Handley 248b4315306SDan Handley static int open_memmap(const uintptr_t spec) 249b4315306SDan Handley { 250b4315306SDan Handley int result; 251b4315306SDan Handley uintptr_t local_image_handle; 252b4315306SDan Handley 253b4315306SDan Handley result = io_dev_init(memmap_dev_handle, (uintptr_t)NULL); 254e098e244SJuan Castillo if (result == 0) { 255b4315306SDan Handley result = io_open(memmap_dev_handle, spec, &local_image_handle); 256e098e244SJuan Castillo if (result == 0) { 257b4315306SDan Handley VERBOSE("Using Memmap\n"); 258b4315306SDan Handley io_close(local_image_handle); 259b4315306SDan Handley } 260b4315306SDan Handley } 261b4315306SDan Handley return result; 262b4315306SDan Handley } 263b4315306SDan Handley 264b4315306SDan Handley 265b4315306SDan Handley void arm_io_setup(void) 266b4315306SDan Handley { 267b4315306SDan Handley int io_result; 268b4315306SDan Handley 269b4315306SDan Handley io_result = register_io_dev_fip(&fip_dev_con); 270e098e244SJuan Castillo assert(io_result == 0); 271b4315306SDan Handley 272b4315306SDan Handley io_result = register_io_dev_memmap(&memmap_dev_con); 273e098e244SJuan Castillo assert(io_result == 0); 274b4315306SDan Handley 275b4315306SDan Handley /* Open connections to devices and cache the handles */ 276b4315306SDan Handley io_result = io_dev_open(fip_dev_con, (uintptr_t)NULL, 277b4315306SDan Handley &fip_dev_handle); 278e098e244SJuan Castillo assert(io_result == 0); 279b4315306SDan Handley 280b4315306SDan Handley io_result = io_dev_open(memmap_dev_con, (uintptr_t)NULL, 281b4315306SDan Handley &memmap_dev_handle); 282e098e244SJuan Castillo assert(io_result == 0); 283b4315306SDan Handley 284b4315306SDan Handley /* Ignore improbable errors in release builds */ 285b4315306SDan Handley (void)io_result; 286b4315306SDan Handley } 287b4315306SDan Handley 288b4315306SDan Handley void plat_arm_io_setup(void) 289b4315306SDan Handley { 290b4315306SDan Handley arm_io_setup(); 291b4315306SDan Handley } 292b4315306SDan Handley 293b4315306SDan Handley int plat_arm_get_alt_image_source( 29465cd299fSSoren Brinkmann unsigned int image_id __unused, 29565cd299fSSoren Brinkmann uintptr_t *dev_handle __unused, 29665cd299fSSoren Brinkmann uintptr_t *image_spec __unused) 297b4315306SDan Handley { 298b4315306SDan Handley /* By default do not try an alternative */ 299e098e244SJuan Castillo return -ENOENT; 300b4315306SDan Handley } 301b4315306SDan Handley 302b4315306SDan Handley /* Return an IO device handle and specification which can be used to access 303b4315306SDan Handley * an image. Use this to enforce platform load policy */ 30416948ae1SJuan Castillo int plat_get_image_source(unsigned int image_id, uintptr_t *dev_handle, 305b4315306SDan Handley uintptr_t *image_spec) 306b4315306SDan Handley { 307e098e244SJuan Castillo int result; 308b4315306SDan Handley const struct plat_io_policy *policy; 309b4315306SDan Handley 31016948ae1SJuan Castillo assert(image_id < ARRAY_SIZE(policies)); 31116948ae1SJuan Castillo 31216948ae1SJuan Castillo policy = &policies[image_id]; 313b4315306SDan Handley result = policy->check(policy->image_spec); 314e098e244SJuan Castillo if (result == 0) { 315b4315306SDan Handley *image_spec = policy->image_spec; 316b4315306SDan Handley *dev_handle = *(policy->dev_handle); 317b4315306SDan Handley } else { 31816948ae1SJuan Castillo VERBOSE("Trying alternative IO\n"); 31916948ae1SJuan Castillo result = plat_arm_get_alt_image_source(image_id, dev_handle, 32016948ae1SJuan Castillo image_spec); 321b4315306SDan Handley } 32216948ae1SJuan Castillo 323b4315306SDan Handley return result; 324b4315306SDan Handley } 325436223deSYatharth Kochar 326436223deSYatharth Kochar /* 327436223deSYatharth Kochar * See if a Firmware Image Package is available, 328436223deSYatharth Kochar * by checking if TOC is valid or not. 329436223deSYatharth Kochar */ 330436223deSYatharth Kochar int arm_io_is_toc_valid(void) 331436223deSYatharth Kochar { 332436223deSYatharth Kochar int result; 333436223deSYatharth Kochar 334436223deSYatharth Kochar result = io_dev_init(fip_dev_handle, (uintptr_t)FIP_IMAGE_ID); 335436223deSYatharth Kochar 336436223deSYatharth Kochar return (result == 0); 337436223deSYatharth Kochar } 338436223deSYatharth Kochar 339