diff options
author | Juan Castillo <juan.castillo@arm.com> | 2015-12-10 15:49:17 +0000 |
---|---|---|
committer | Juan Castillo <juan.castillo@arm.com> | 2015-12-14 12:31:16 +0000 |
commit | f59821d51255f14e0ac00eef7bc98ef75c686876 (patch) | |
tree | 2a62aec945a1c30ed695ba2a3336c08d94183ab3 /docs/user-guide.md | |
parent | 516beb585c23056820a854b12c77a6f62cbc5c8b (diff) | |
download | platform_external_arm-trusted-firmware-f59821d51255f14e0ac00eef7bc98ef75c686876.tar.gz platform_external_arm-trusted-firmware-f59821d51255f14e0ac00eef7bc98ef75c686876.tar.bz2 platform_external_arm-trusted-firmware-f59821d51255f14e0ac00eef7bc98ef75c686876.zip |
Replace all SCP FW (BL0, BL3-0) references
This patch replaces all references to the SCP Firmware (BL0, BL30,
BL3-0, bl30) with the image terminology detailed in the TF wiki
(https://github.com/ARM-software/arm-trusted-firmware/wiki):
BL0 --> SCP_BL1
BL30, BL3-0 --> SCP_BL2
bl30 --> scp_bl2
This change affects code, documentation, build system, tools and
platform ports that load SCP firmware. ARM plaforms have been
updated to the new porting API.
IMPORTANT: build option to specify the SCP FW image has changed:
BL30 --> SCP_BL2
IMPORTANT: This patch breaks compatibility for platforms that use BL2
to load SCP firmware. Affected platforms must be updated as follows:
BL30_IMAGE_ID --> SCP_BL2_IMAGE_ID
BL30_BASE --> SCP_BL2_BASE
bl2_plat_get_bl30_meminfo() --> bl2_plat_get_scp_bl2_meminfo()
bl2_plat_handle_bl30() --> bl2_plat_handle_scp_bl2()
Change-Id: I24c4c1a4f0e4b9f17c9e4929da815c4069549e58
Diffstat (limited to 'docs/user-guide.md')
-rw-r--r-- | docs/user-guide.md | 31 |
1 files changed, 16 insertions, 15 deletions
diff --git a/docs/user-guide.md b/docs/user-guide.md index f921f87ab..b4ef37c2f 100644 --- a/docs/user-guide.md +++ b/docs/user-guide.md @@ -139,11 +139,11 @@ Trusted Firmware source tree and follow these steps: For more information on FIPs, see the "Firmware Image Package" section in the [Firmware Design]. -2. (Optional) Some platforms may require a BL3-0 image to boot. This image can +2. (Optional) Some platforms may require a SCP_BL2 image to boot. This image can be included in the FIP when building the Trusted Firmware by specifying the - `BL30` build option: + `SCP_BL2` build option: - BL30=<path-to>/<bl30_image> + SCP_BL2=<path-to>/<scp_bl2_image> 3. Output binary files `bl1.bin` and `fip.bin` are both required to boot the system. How these files are used is platform specific. Refer to the @@ -180,8 +180,8 @@ performed. #### Common build options -* `BL30`: Path to BL3-0 image in the host file system. This image is optional. - If a BL3-0 image is present then this option must be passed for the `fip` +* `SCP_BL2`: Path to SCP_BL2 image in the host file system. This image is optional. + If a SCP_BL2 image is present then this option must be passed for the `fip` target. * `BL33`: Path to BL3-3 image in the host file system. This is mandatory for @@ -327,8 +327,8 @@ performed. specifies the file that contains the Non-Trusted World private key in PEM format. If `SAVE_KEYS=1`, this file name will be used to save the key. -* `BL30_KEY`: This option is used when `GENERATE_COT=1`. It specifies the - file that contains the BL3-0 private key in PEM format. If `SAVE_KEYS=1`, +* `SCP_BL2_KEY`: This option is used when `GENERATE_COT=1`. It specifies the + file that contains the SCP_BL2 private key in PEM format. If `SAVE_KEYS=1`, this file name will be used to save the key. * `BL31_KEY`: This option is used when `GENERATE_COT=1`. It specifies the @@ -767,7 +767,7 @@ complexity of developing EL3 baremetal code by: * putting the system into a known architectural state; * taking care of platform secure world initialization; -* loading the BL30 image if required by the platform. +* loading the SCP_BL2 image if required by the platform. When booting an EL3 payload on ARM standard platforms, the configuration of the TrustZone controller is simplified such that only region 0 is enabled and is @@ -1187,14 +1187,15 @@ deliverables on Juno][Juno Instructions]. ### Preparing Trusted Firmware images -The Juno platform requires a BL0 and a BL30 image to boot up. The BL0 image -contains the ROM firmware that runs on the SCP (System Control Processor), -whereas the BL30 image contains the SCP Runtime firmware. Both images are -embedded within the Juno board recovery image, these are the files `bl0.bin` -and `bl30.bin`. +The Juno platform requires a SCP_BL1 and a SCP_BL2 image to boot up. The +SCP_BL1 image contains the ROM firmware that runs on the SCP (System Control +Processor), whereas the SCP_BL2 image contains the SCP Runtime firmware. Both +images are embedded within the Juno board recovery image, these are the files +`bl0.bin` and `bl30.bin`, respectively. Please note that these filenames still +use the old terminology. -The BL30 file must be part of the FIP image. Therefore, its path must be -supplied using the `BL30` variable on the command line when building the +The SCP_BL2 file must be part of the FIP image. Therefore, its path must be +supplied using the `SCP_BL2` variable on the command line when building the FIP. Please refer to the section "Building the Trusted Firmware". After building Trusted Firmware, the files `bl1.bin` and `fip.bin` need copying |