Merge pull request #93 from danh-arm:dh/tf-issues#68

Conflicts:
	bl2/bl2_main.c

Change-Id: I2f2ee2db6ee70536deaefc562a04037bf16c22a4

bl2/bl2_main.c

@@ -126,6 +126,7 @@ void bl2_main(void)
 				bl2_to_bl31_params->bl33_ep);
 
 
+#ifdef BL32_BASE
 	/*
 	 * Load the BL32 image if there's one. It is upto to platform
 	 * to specify where BL32 should be loaded if it exists. It
@@ -151,6 +152,7 @@ void bl2_main(void)
 		bl2_plat_bl32_loaded(bl2_to_bl31_params->bl32_image,
 					bl2_to_bl31_params->bl32_ep);
 	}
+#endif /* BL32_BASE */
 
 	/* Flush the params to be passed to memory */
 	bl2_plat_flush_bl31_params();

docs/porting-guide.md

@@ -582,23 +582,24 @@ using the `platform_is_primary_cpu()` function. BL1 passed control to BL2 at
     if the platform wants to restrict the amount of memory visible to BL3-1.
     Details of this function are given below.
 
-4.  Loading the BL3-2 binary image (if present) in platform provided memory
+4.  (Optional) Loading the BL3-2 binary image (if present) from platform
-    using semi-hosting. To load the BL3-2 image, BL2 makes use of the
+    provided non-volatile storage. To load the BL3-2 image, BL2 makes use of
-    `bl32_meminfo` field in the `bl31_args` structure to which a pointer is
+    the `bl32_meminfo` field in the `bl31_args` structure to which a pointer is
     returned by the `bl2_get_bl31_args_ptr()` function. The platform also
-    defines the address in memory where BL3-2 is loaded through the constant
+    defines the address in memory where BL3-2 is loaded through the optional
-    `BL32_BASE`. BL2 uses this information to determine if there is enough
+    constant `BL32_BASE`. BL2 uses this information to determine if there is
-    memory to load the BL3-2 image.
+    enough memory to load the BL3-2 image. If `BL32_BASE` is not defined then
+    this and the following two steps are not performed.
 
-5.  Arranging to pass control to the BL3-2 image (if present) that has been
+5.  (Optional) Arranging to pass control to the BL3-2 image (if present) that
-    pre-loaded at `BL32_BASE`. BL2 populates an `el_change_info` structure
+    has been pre-loaded at `BL32_BASE`. BL2 populates an `el_change_info`
-    in memory provided by the platform with information about how BL3-1 should
+    structure in memory provided by the platform with information about how
-    pass control to the BL3-2 image. This structure follows the
+    BL3-1 should pass control to the BL3-2 image. This structure follows the
     `el_change_info` structure populated for the normal world BL image in 2.
     above.
 
-6.  Populating a `meminfo` structure with the following information in
+6.  (Optional) Populating a `meminfo` structure with the following information
-    memory that is accessible by BL3-1 immediately upon entry.
+    in memory that is accessible by BL3-1 immediately upon entry.
 
         meminfo.total_base = Base address of memory visible to BL3-2
         meminfo.total_size = Size of memory visible to BL3-2
@@ -608,7 +609,7 @@ using the `platform_is_primary_cpu()` function. BL1 passed control to BL2 at
                              BL3-2
 
     BL2 populates this information in the `bl32_meminfo` field of the pointer
-    returned by the `bl2_get_bl31_args_ptr() function.
+    returned by the `bl2_get_bl31_args_ptr()` function.
 
 The following functions must be implemented by the platform port to enable BL2
 to perform the above tasks.

drivers/io/io_fip.c

@@ -65,7 +65,10 @@ typedef struct {
 static const plat_fip_name_uuid_t name_uuid[] = {
 	{BL2_IMAGE_NAME, UUID_TRUSTED_BOOT_FIRMWARE_BL2},
 	{BL31_IMAGE_NAME, UUID_EL3_RUNTIME_FIRMWARE_BL31},
+#ifdef BL32_IMAGE_NAME
+	/* BL3-2 is optional in the platform */
 	{BL32_IMAGE_NAME, UUID_SECURE_PAYLOAD_BL32},
+#endif /* BL32_IMAGE_NAME */
 	{BL33_IMAGE_NAME, UUID_NON_TRUSTED_FIRMWARE_BL33},
 };