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 */ 6*09d40e0eSAntonio Nino Diaz 7b4315306SDan Handley #include <assert.h> 8b4315306SDan Handley #include <string.h> 9*09d40e0eSAntonio Nino Diaz 10*09d40e0eSAntonio Nino Diaz #include <platform_def.h> 11*09d40e0eSAntonio Nino Diaz 12*09d40e0eSAntonio Nino Diaz #include <common/debug.h> 13*09d40e0eSAntonio Nino Diaz #include <drivers/io/io_driver.h> 14*09d40e0eSAntonio Nino Diaz #include <drivers/io/io_fip.h> 15*09d40e0eSAntonio Nino Diaz #include <drivers/io/io_memmap.h> 16*09d40e0eSAntonio Nino Diaz #include <drivers/io/io_storage.h> 17*09d40e0eSAntonio Nino Diaz #include <lib/utils.h> 18*09d40e0eSAntonio Nino Diaz #include <plat/common/platform.h> 19*09d40e0eSAntonio Nino Diaz #include <tools_share/firmware_image_package.h> 20*09d40e0eSAntonio Nino Diaz 21*09d40e0eSAntonio Nino Diaz #include <plat_arm.h> 22b4315306SDan Handley 23b4315306SDan Handley /* IO devices */ 24b4315306SDan Handley static const io_dev_connector_t *fip_dev_con; 25b4315306SDan Handley static uintptr_t fip_dev_handle; 26b4315306SDan Handley static const io_dev_connector_t *memmap_dev_con; 27b4315306SDan Handley static uintptr_t memmap_dev_handle; 28b4315306SDan Handley 29b4315306SDan Handley static const io_block_spec_t fip_block_spec = { 30b4315306SDan Handley .offset = PLAT_ARM_FIP_BASE, 31b4315306SDan Handley .length = PLAT_ARM_FIP_MAX_SIZE 32b4315306SDan Handley }; 33b4315306SDan Handley 3416948ae1SJuan Castillo static const io_uuid_spec_t bl2_uuid_spec = { 3516948ae1SJuan Castillo .uuid = UUID_TRUSTED_BOOT_FIRMWARE_BL2, 36b4315306SDan Handley }; 37b4315306SDan Handley 38f59821d5SJuan Castillo static const io_uuid_spec_t scp_bl2_uuid_spec = { 39f59821d5SJuan Castillo .uuid = UUID_SCP_FIRMWARE_SCP_BL2, 40b4315306SDan Handley }; 41b4315306SDan Handley 4216948ae1SJuan Castillo static const io_uuid_spec_t bl31_uuid_spec = { 4316948ae1SJuan Castillo .uuid = UUID_EL3_RUNTIME_FIRMWARE_BL31, 44b4315306SDan Handley }; 45b4315306SDan Handley 4616948ae1SJuan Castillo static const io_uuid_spec_t bl32_uuid_spec = { 4716948ae1SJuan Castillo .uuid = UUID_SECURE_PAYLOAD_BL32, 48b4315306SDan Handley }; 49b4315306SDan Handley 5071fb3964SSummer Qin static const io_uuid_spec_t bl32_extra1_uuid_spec = { 5171fb3964SSummer Qin .uuid = UUID_SECURE_PAYLOAD_BL32_EXTRA1, 5271fb3964SSummer Qin }; 5371fb3964SSummer Qin 5471fb3964SSummer Qin static const io_uuid_spec_t bl32_extra2_uuid_spec = { 5571fb3964SSummer Qin .uuid = UUID_SECURE_PAYLOAD_BL32_EXTRA2, 5671fb3964SSummer Qin }; 5771fb3964SSummer Qin 5816948ae1SJuan Castillo static const io_uuid_spec_t bl33_uuid_spec = { 5916948ae1SJuan Castillo .uuid = UUID_NON_TRUSTED_FIRMWARE_BL33, 60b4315306SDan Handley }; 61b4315306SDan Handley 62c228956aSSoby Mathew static const io_uuid_spec_t tb_fw_config_uuid_spec = { 63c228956aSSoby Mathew .uuid = UUID_TB_FW_CONFIG, 64c228956aSSoby Mathew }; 65c228956aSSoby Mathew 66cab0b5b0SSoby Mathew static const io_uuid_spec_t hw_config_uuid_spec = { 67cab0b5b0SSoby Mathew .uuid = UUID_HW_CONFIG, 68cab0b5b0SSoby Mathew }; 69cab0b5b0SSoby Mathew 701d71ba14SSoby Mathew static const io_uuid_spec_t soc_fw_config_uuid_spec = { 711d71ba14SSoby Mathew .uuid = UUID_SOC_FW_CONFIG, 721d71ba14SSoby Mathew }; 731d71ba14SSoby Mathew 741d71ba14SSoby Mathew static const io_uuid_spec_t tos_fw_config_uuid_spec = { 751d71ba14SSoby Mathew .uuid = UUID_TOS_FW_CONFIG, 761d71ba14SSoby Mathew }; 771d71ba14SSoby Mathew 781d71ba14SSoby Mathew static const io_uuid_spec_t nt_fw_config_uuid_spec = { 791d71ba14SSoby Mathew .uuid = UUID_NT_FW_CONFIG, 801d71ba14SSoby Mathew }; 811d71ba14SSoby Mathew 82b4315306SDan Handley #if TRUSTED_BOARD_BOOT 83516beb58SJuan Castillo static const io_uuid_spec_t tb_fw_cert_uuid_spec = { 84516beb58SJuan Castillo .uuid = UUID_TRUSTED_BOOT_FW_CERT, 85b4315306SDan Handley }; 86b4315306SDan Handley 8716948ae1SJuan Castillo static const io_uuid_spec_t trusted_key_cert_uuid_spec = { 8816948ae1SJuan Castillo .uuid = UUID_TRUSTED_KEY_CERT, 89b4315306SDan Handley }; 90b4315306SDan Handley 91516beb58SJuan Castillo static const io_uuid_spec_t scp_fw_key_cert_uuid_spec = { 92516beb58SJuan Castillo .uuid = UUID_SCP_FW_KEY_CERT, 93b4315306SDan Handley }; 94b4315306SDan Handley 95516beb58SJuan Castillo static const io_uuid_spec_t soc_fw_key_cert_uuid_spec = { 96516beb58SJuan Castillo .uuid = UUID_SOC_FW_KEY_CERT, 97b4315306SDan Handley }; 98b4315306SDan Handley 99516beb58SJuan Castillo static const io_uuid_spec_t tos_fw_key_cert_uuid_spec = { 100516beb58SJuan Castillo .uuid = UUID_TRUSTED_OS_FW_KEY_CERT, 101b4315306SDan Handley }; 102b4315306SDan Handley 103516beb58SJuan Castillo static const io_uuid_spec_t nt_fw_key_cert_uuid_spec = { 104516beb58SJuan Castillo .uuid = UUID_NON_TRUSTED_FW_KEY_CERT, 105b4315306SDan Handley }; 106b4315306SDan Handley 107516beb58SJuan Castillo static const io_uuid_spec_t scp_fw_cert_uuid_spec = { 108516beb58SJuan Castillo .uuid = UUID_SCP_FW_CONTENT_CERT, 109b4315306SDan Handley }; 110b4315306SDan Handley 111516beb58SJuan Castillo static const io_uuid_spec_t soc_fw_cert_uuid_spec = { 112516beb58SJuan Castillo .uuid = UUID_SOC_FW_CONTENT_CERT, 113b4315306SDan Handley }; 114b4315306SDan Handley 115516beb58SJuan Castillo static const io_uuid_spec_t tos_fw_cert_uuid_spec = { 116516beb58SJuan Castillo .uuid = UUID_TRUSTED_OS_FW_CONTENT_CERT, 117b4315306SDan Handley }; 118b4315306SDan Handley 119516beb58SJuan Castillo static const io_uuid_spec_t nt_fw_cert_uuid_spec = { 120516beb58SJuan Castillo .uuid = UUID_NON_TRUSTED_FW_CONTENT_CERT, 121b4315306SDan Handley }; 122b4315306SDan Handley #endif /* TRUSTED_BOARD_BOOT */ 123b4315306SDan Handley 12416948ae1SJuan Castillo 125b4315306SDan Handley static int open_fip(const uintptr_t spec); 126b4315306SDan Handley static int open_memmap(const uintptr_t spec); 127b4315306SDan Handley 128b4315306SDan Handley struct plat_io_policy { 129b4315306SDan Handley uintptr_t *dev_handle; 130b4315306SDan Handley uintptr_t image_spec; 131b4315306SDan Handley int (*check)(const uintptr_t spec); 132b4315306SDan Handley }; 133b4315306SDan Handley 13416948ae1SJuan Castillo /* By default, ARM platforms load images from the FIP */ 135b4315306SDan Handley static const struct plat_io_policy policies[] = { 13616948ae1SJuan Castillo [FIP_IMAGE_ID] = { 137b4315306SDan Handley &memmap_dev_handle, 138b4315306SDan Handley (uintptr_t)&fip_block_spec, 139b4315306SDan Handley open_memmap 14016948ae1SJuan Castillo }, 14116948ae1SJuan Castillo [BL2_IMAGE_ID] = { 142b4315306SDan Handley &fip_dev_handle, 14316948ae1SJuan Castillo (uintptr_t)&bl2_uuid_spec, 144b4315306SDan Handley open_fip 14516948ae1SJuan Castillo }, 146f59821d5SJuan Castillo [SCP_BL2_IMAGE_ID] = { 147b4315306SDan Handley &fip_dev_handle, 148f59821d5SJuan Castillo (uintptr_t)&scp_bl2_uuid_spec, 149b4315306SDan Handley open_fip 15016948ae1SJuan Castillo }, 15116948ae1SJuan Castillo [BL31_IMAGE_ID] = { 152b4315306SDan Handley &fip_dev_handle, 15316948ae1SJuan Castillo (uintptr_t)&bl31_uuid_spec, 154b4315306SDan Handley open_fip 15516948ae1SJuan Castillo }, 15616948ae1SJuan Castillo [BL32_IMAGE_ID] = { 157b4315306SDan Handley &fip_dev_handle, 15816948ae1SJuan Castillo (uintptr_t)&bl32_uuid_spec, 159b4315306SDan Handley open_fip 16016948ae1SJuan Castillo }, 16171fb3964SSummer Qin [BL32_EXTRA1_IMAGE_ID] = { 16271fb3964SSummer Qin &fip_dev_handle, 16371fb3964SSummer Qin (uintptr_t)&bl32_extra1_uuid_spec, 16471fb3964SSummer Qin open_fip 16571fb3964SSummer Qin }, 16671fb3964SSummer Qin [BL32_EXTRA2_IMAGE_ID] = { 16771fb3964SSummer Qin &fip_dev_handle, 16871fb3964SSummer Qin (uintptr_t)&bl32_extra2_uuid_spec, 16971fb3964SSummer Qin open_fip 17071fb3964SSummer Qin }, 17116948ae1SJuan Castillo [BL33_IMAGE_ID] = { 172b4315306SDan Handley &fip_dev_handle, 17316948ae1SJuan Castillo (uintptr_t)&bl33_uuid_spec, 174b4315306SDan Handley open_fip 17516948ae1SJuan Castillo }, 176c228956aSSoby Mathew [TB_FW_CONFIG_ID] = { 177c228956aSSoby Mathew &fip_dev_handle, 178c228956aSSoby Mathew (uintptr_t)&tb_fw_config_uuid_spec, 179c228956aSSoby Mathew open_fip 180c228956aSSoby Mathew }, 181cab0b5b0SSoby Mathew [HW_CONFIG_ID] = { 182cab0b5b0SSoby Mathew &fip_dev_handle, 183cab0b5b0SSoby Mathew (uintptr_t)&hw_config_uuid_spec, 184cab0b5b0SSoby Mathew open_fip 185cab0b5b0SSoby Mathew }, 1861d71ba14SSoby Mathew [SOC_FW_CONFIG_ID] = { 1871d71ba14SSoby Mathew &fip_dev_handle, 1881d71ba14SSoby Mathew (uintptr_t)&soc_fw_config_uuid_spec, 1891d71ba14SSoby Mathew open_fip 1901d71ba14SSoby Mathew }, 1911d71ba14SSoby Mathew [TOS_FW_CONFIG_ID] = { 1921d71ba14SSoby Mathew &fip_dev_handle, 1931d71ba14SSoby Mathew (uintptr_t)&tos_fw_config_uuid_spec, 1941d71ba14SSoby Mathew open_fip 1951d71ba14SSoby Mathew }, 1961d71ba14SSoby Mathew [NT_FW_CONFIG_ID] = { 1971d71ba14SSoby Mathew &fip_dev_handle, 1981d71ba14SSoby Mathew (uintptr_t)&nt_fw_config_uuid_spec, 1991d71ba14SSoby Mathew open_fip 2001d71ba14SSoby Mathew }, 201b4315306SDan Handley #if TRUSTED_BOARD_BOOT 202516beb58SJuan Castillo [TRUSTED_BOOT_FW_CERT_ID] = { 203b4315306SDan Handley &fip_dev_handle, 204516beb58SJuan Castillo (uintptr_t)&tb_fw_cert_uuid_spec, 205b4315306SDan Handley open_fip 20616948ae1SJuan Castillo }, 20716948ae1SJuan Castillo [TRUSTED_KEY_CERT_ID] = { 208b4315306SDan Handley &fip_dev_handle, 20916948ae1SJuan Castillo (uintptr_t)&trusted_key_cert_uuid_spec, 210b4315306SDan Handley open_fip 21116948ae1SJuan Castillo }, 212516beb58SJuan Castillo [SCP_FW_KEY_CERT_ID] = { 213b4315306SDan Handley &fip_dev_handle, 214516beb58SJuan Castillo (uintptr_t)&scp_fw_key_cert_uuid_spec, 215b4315306SDan Handley open_fip 21616948ae1SJuan Castillo }, 217516beb58SJuan Castillo [SOC_FW_KEY_CERT_ID] = { 218b4315306SDan Handley &fip_dev_handle, 219516beb58SJuan Castillo (uintptr_t)&soc_fw_key_cert_uuid_spec, 220b4315306SDan Handley open_fip 22116948ae1SJuan Castillo }, 222516beb58SJuan Castillo [TRUSTED_OS_FW_KEY_CERT_ID] = { 223b4315306SDan Handley &fip_dev_handle, 224516beb58SJuan Castillo (uintptr_t)&tos_fw_key_cert_uuid_spec, 225b4315306SDan Handley open_fip 22616948ae1SJuan Castillo }, 227516beb58SJuan Castillo [NON_TRUSTED_FW_KEY_CERT_ID] = { 228b4315306SDan Handley &fip_dev_handle, 229516beb58SJuan Castillo (uintptr_t)&nt_fw_key_cert_uuid_spec, 230b4315306SDan Handley open_fip 23116948ae1SJuan Castillo }, 232516beb58SJuan Castillo [SCP_FW_CONTENT_CERT_ID] = { 233b4315306SDan Handley &fip_dev_handle, 234516beb58SJuan Castillo (uintptr_t)&scp_fw_cert_uuid_spec, 235b4315306SDan Handley open_fip 23616948ae1SJuan Castillo }, 237516beb58SJuan Castillo [SOC_FW_CONTENT_CERT_ID] = { 238b4315306SDan Handley &fip_dev_handle, 239516beb58SJuan Castillo (uintptr_t)&soc_fw_cert_uuid_spec, 240b4315306SDan Handley open_fip 24116948ae1SJuan Castillo }, 242516beb58SJuan Castillo [TRUSTED_OS_FW_CONTENT_CERT_ID] = { 243b4315306SDan Handley &fip_dev_handle, 244516beb58SJuan Castillo (uintptr_t)&tos_fw_cert_uuid_spec, 245b4315306SDan Handley open_fip 24616948ae1SJuan Castillo }, 247516beb58SJuan Castillo [NON_TRUSTED_FW_CONTENT_CERT_ID] = { 248b4315306SDan Handley &fip_dev_handle, 249516beb58SJuan Castillo (uintptr_t)&nt_fw_cert_uuid_spec, 250b4315306SDan Handley open_fip 25116948ae1SJuan Castillo }, 252b4315306SDan Handley #endif /* TRUSTED_BOARD_BOOT */ 253b4315306SDan Handley }; 254b4315306SDan Handley 255b4315306SDan Handley 256b4315306SDan Handley /* Weak definitions may be overridden in specific ARM standard platform */ 257b4315306SDan Handley #pragma weak plat_arm_io_setup 258b4315306SDan Handley #pragma weak plat_arm_get_alt_image_source 259b4315306SDan Handley 260b4315306SDan Handley 261b4315306SDan Handley static int open_fip(const uintptr_t spec) 262b4315306SDan Handley { 263b4315306SDan Handley int result; 264b4315306SDan Handley uintptr_t local_image_handle; 265b4315306SDan Handley 266b4315306SDan Handley /* See if a Firmware Image Package is available */ 26716948ae1SJuan Castillo result = io_dev_init(fip_dev_handle, (uintptr_t)FIP_IMAGE_ID); 268e098e244SJuan Castillo if (result == 0) { 269b4315306SDan Handley result = io_open(fip_dev_handle, spec, &local_image_handle); 270e098e244SJuan Castillo if (result == 0) { 271b4315306SDan Handley VERBOSE("Using FIP\n"); 272b4315306SDan Handley io_close(local_image_handle); 273b4315306SDan Handley } 274b4315306SDan Handley } 275b4315306SDan Handley return result; 276b4315306SDan Handley } 277b4315306SDan Handley 278b4315306SDan Handley 279b4315306SDan Handley static int open_memmap(const uintptr_t spec) 280b4315306SDan Handley { 281b4315306SDan Handley int result; 282b4315306SDan Handley uintptr_t local_image_handle; 283b4315306SDan Handley 284b4315306SDan Handley result = io_dev_init(memmap_dev_handle, (uintptr_t)NULL); 285e098e244SJuan Castillo if (result == 0) { 286b4315306SDan Handley result = io_open(memmap_dev_handle, spec, &local_image_handle); 287e098e244SJuan Castillo if (result == 0) { 288b4315306SDan Handley VERBOSE("Using Memmap\n"); 289b4315306SDan Handley io_close(local_image_handle); 290b4315306SDan Handley } 291b4315306SDan Handley } 292b4315306SDan Handley return result; 293b4315306SDan Handley } 294b4315306SDan Handley 295b4315306SDan Handley 296b4315306SDan Handley void arm_io_setup(void) 297b4315306SDan Handley { 298b4315306SDan Handley int io_result; 299b4315306SDan Handley 300b4315306SDan Handley io_result = register_io_dev_fip(&fip_dev_con); 301e098e244SJuan Castillo assert(io_result == 0); 302b4315306SDan Handley 303b4315306SDan Handley io_result = register_io_dev_memmap(&memmap_dev_con); 304e098e244SJuan Castillo assert(io_result == 0); 305b4315306SDan Handley 306b4315306SDan Handley /* Open connections to devices and cache the handles */ 307b4315306SDan Handley io_result = io_dev_open(fip_dev_con, (uintptr_t)NULL, 308b4315306SDan Handley &fip_dev_handle); 309e098e244SJuan Castillo assert(io_result == 0); 310b4315306SDan Handley 311b4315306SDan Handley io_result = io_dev_open(memmap_dev_con, (uintptr_t)NULL, 312b4315306SDan Handley &memmap_dev_handle); 313e098e244SJuan Castillo assert(io_result == 0); 314b4315306SDan Handley 315b4315306SDan Handley /* Ignore improbable errors in release builds */ 316b4315306SDan Handley (void)io_result; 317b4315306SDan Handley } 318b4315306SDan Handley 319b4315306SDan Handley void plat_arm_io_setup(void) 320b4315306SDan Handley { 321b4315306SDan Handley arm_io_setup(); 322b4315306SDan Handley } 323b4315306SDan Handley 324b4315306SDan Handley int plat_arm_get_alt_image_source( 32565cd299fSSoren Brinkmann unsigned int image_id __unused, 32665cd299fSSoren Brinkmann uintptr_t *dev_handle __unused, 32765cd299fSSoren Brinkmann uintptr_t *image_spec __unused) 328b4315306SDan Handley { 329b4315306SDan Handley /* By default do not try an alternative */ 330e098e244SJuan Castillo return -ENOENT; 331b4315306SDan Handley } 332b4315306SDan Handley 333b4315306SDan Handley /* Return an IO device handle and specification which can be used to access 334b4315306SDan Handley * an image. Use this to enforce platform load policy */ 33516948ae1SJuan Castillo int plat_get_image_source(unsigned int image_id, uintptr_t *dev_handle, 336b4315306SDan Handley uintptr_t *image_spec) 337b4315306SDan Handley { 338e098e244SJuan Castillo int result; 339b4315306SDan Handley const struct plat_io_policy *policy; 340b4315306SDan Handley 34116948ae1SJuan Castillo assert(image_id < ARRAY_SIZE(policies)); 34216948ae1SJuan Castillo 34316948ae1SJuan Castillo policy = &policies[image_id]; 344b4315306SDan Handley result = policy->check(policy->image_spec); 345e098e244SJuan Castillo if (result == 0) { 346b4315306SDan Handley *image_spec = policy->image_spec; 347b4315306SDan Handley *dev_handle = *(policy->dev_handle); 348b4315306SDan Handley } else { 34916948ae1SJuan Castillo VERBOSE("Trying alternative IO\n"); 35016948ae1SJuan Castillo result = plat_arm_get_alt_image_source(image_id, dev_handle, 35116948ae1SJuan Castillo image_spec); 352b4315306SDan Handley } 35316948ae1SJuan Castillo 354b4315306SDan Handley return result; 355b4315306SDan Handley } 356436223deSYatharth Kochar 357436223deSYatharth Kochar /* 358436223deSYatharth Kochar * See if a Firmware Image Package is available, 359436223deSYatharth Kochar * by checking if TOC is valid or not. 360436223deSYatharth Kochar */ 361436223deSYatharth Kochar int arm_io_is_toc_valid(void) 362436223deSYatharth Kochar { 363436223deSYatharth Kochar int result; 364436223deSYatharth Kochar 365436223deSYatharth Kochar result = io_dev_init(fip_dev_handle, (uintptr_t)FIP_IMAGE_ID); 366436223deSYatharth Kochar 367436223deSYatharth Kochar return (result == 0); 368436223deSYatharth Kochar } 369436223deSYatharth Kochar 370