diff --git a/docs/user-guide.md b/docs/user-guide.md index 00feacc..c1cadbb 100644 --- a/docs/user-guide.md +++ b/docs/user-guide.md @@ -62,7 +62,7 @@ * `libssl-dev` package to build the certificate generation tool when support for Trusted Board Boot is needed. -* (Optional) For debugging, ARM [Development Studio 5 (DS-5)][DS-5] v5.20. +* (Optional) For debugging, ARM [Development Studio 5 (DS-5)][DS-5] v5.21. 4. Building the Trusted Firmware @@ -546,7 +546,7 @@ cd edk2 git remote add -f --tags arm-software https://github.com/ARM-software/edk2.git - git checkout --detach v2.1-rc0 + git checkout --detach v3.0 2. Copy build config templates to local workspace @@ -625,7 +625,7 @@ cd linux git remote add -f --tags arm-software https://github.com/ARM-software/linux.git - git checkout --detach 1.3-Juno + git checkout --detach 1.6-Juno 2. Build with the Linaro GCC tools. @@ -700,8 +700,8 @@ NOTE: The unpacked disk image grows to 3 GiB in size. - wget http://releases.linaro.org/14.12/openembedded/aarch64/vexpress64-openembedded_lamp-armv8-gcc-4.9_20141211-701.img.gz - gunzip vexpress64-openembedded_lamp-armv8-gcc-4.9_20141211-701.img.gz + wget http://releases.linaro.org/15.03/members/arm/openembedded/aarch64/vexpress64-openembedded_lamp-armv8-gcc-4.9_20150324-715.img.gz + gunzip vexpress64-openembedded_lamp-armv8-gcc-4.9_20150324-715.img.gz 2. Make sure the Linux kernel has Virtio support enabled using `make ARCH=arm64 menuconfig`. @@ -763,14 +763,14 @@ 1. Download the file-system image: - wget http://releases.linaro.org/14.12/openembedded/aarch64/linaro-image-lamp-genericarmv8-20141212-729.rootfs.tar.gz + wget http://releases.linaro.org/15.03/members/arm/openembedded/aarch64/linaro-image-lamp-genericarmv8-20150323-747.rootfs.tar.gz 2. Modify the Linaro image: # Prepare for use as RAM-disk. Normally use MMC, NFS or VirtioBlock. # Be careful, otherwise you could damage your host file-system. mkdir tmp; cd tmp - sudo sh -c "zcat ../linaro-image-lamp-genericarmv8-20141212-729.rootfs.tar.gz | cpio -id" + sudo sh -c "zcat ../linaro-image-lamp-genericarmv8-20150323-747.rootfs.tar.gz | cpio -id" sudo ln -s sbin/init . sudo sh -c "echo 'devtmpfs /dev devtmpfs mode=0755,nosuid 0 0' >> etc/fstab" sudo sh -c "find . | cpio --quiet -H newc -o | gzip -3 -n > ../filesystem.cpio.gz" @@ -1068,10 +1068,19 @@ follow the recovery image update instructions in the [Juno Software Guide] on the [ARM Connected Community] website. -The Juno platform requires a BL3-0 image to boot up. This image contains the -runtime firmware that runs on the SCP (System Control Processor). This image is -embedded within the [Juno Board Recovery Image] but can also be -[downloaded directly][Juno SCP Firmware]. +Note that you must use the board recovery image provided in the Juno R1 Initial +Alpha release, even for Juno R0. This is because the Trusted Firmware now +supports the new [SCPI v1.0 final protocol][Juno SCP Protocols v1.0] +exclusively, which is not compatible with the SCP firmware provided in the +latest Juno R0 release. Although the Juno R1 Initial Alpha release is generally +not recommended for use with Juno R0 boards, it is suitable for Trusted Firmware +development. + +The Juno platform requires a BL0 and a BL3-0 image to boot up. The BL0 image +contains the ROM firmware that runs on the SCP (System Control Processor), +whereas the BL3-0 image contains the SCP Runtime firmware. Both images are +embedded within the [Juno Board Recovery Image] but they can also be downloaded +directly: [Juno SCP ROM Firmware] and [Juno SCP Runtime Firmware]. Rebuild the Trusted Firmware specifying the BL3-0 image. Refer to the section "Building the Trusted Firmware". Alternatively, the FIP image can be updated @@ -1083,7 +1092,7 @@ Juno's device tree blob is built along with the kernel. It is located in: - /arch/arm64/boot/dts/juno.dtb + /arch/arm64/boot/dts/arm/juno.dtb ### Other Juno software information @@ -1104,8 +1113,10 @@ [ARM FVP website]: http://www.arm.com/fvp [ARM Connected Community]: http://community.arm.com [Juno Software Guide]: http://community.arm.com/docs/DOC-8396 -[Juno Board Recovery Image]: http://community.arm.com/servlet/JiveServlet/download/9427-1-15432/board_recovery_image_0.10.1.zip -[Juno SCP Firmware]: http://community.arm.com/servlet/JiveServlet/download/9427-1-15422/bl30.bin.zip +[Juno Board Recovery Image]: http://community.arm.com/servlet/JiveServlet/download/10177-1-18236/board_recovery_image_0.11.3.zip +[Juno SCP ROM Firmware]: http://community.arm.com/servlet/JiveServlet/download/10177-1-18187/bl0.bin.zip +[Juno SCP Runtime Firmware]: http://community.arm.com/servlet/JiveServlet/download/10177-1-18193/bl30.bin.zip +[Juno SCP Protocols v1.0]: http://community.arm.com/servlet/JiveServlet/download/8401-40-18262/DUI0922A_scp_message_interface.pdf [Linaro Toolchain]: http://releases.linaro.org/14.07/components/toolchain/binaries/ [EDK2]: http://github.com/tianocore/edk2 [DS-5]: http://www.arm.com/products/tools/software-tools/ds-5/index.php