diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/plat/fvp_ve.rst | 81 | ||||
| -rw-r--r-- | docs/plat/stm32mp1.rst | 7 |
2 files changed, 87 insertions, 1 deletions
diff --git a/docs/plat/fvp_ve.rst b/docs/plat/fvp_ve.rst new file mode 100644 index 000000000..c6d67c090 --- /dev/null +++ b/docs/plat/fvp_ve.rst @@ -0,0 +1,81 @@ +Description +=========== + +Versatile Express (VE) family development platform provides an +ultra fast environment for prototyping arm-v7 System-on-Chip designs. +VE Fixed Virtual Platforms (FVP) are simulations of Versatile Express boards. +The platform in arm-trusted-firmware has been verified with Arm Cortex-A5 +and Cortex-A7 VE FVP's. This platform is tested on and only expected to work +with single core models. + +Boot Sequence +============= + +BL1 --> BL2 --> BL32(sp_min) --> BL33(u-boot) --> Linux kernel + +How to build +============ + +Code Locations +--------------- +- `U-boot <https://git.linaro.org/landing-teams/working/arm/u-boot.git>`__ + +- `arm-trusted-firmware <https://github.com/ARM-software/arm-trusted-firmware>`__ + +Build Procedure +--------------- + +- Obtain arm toolchain. The software stack has been verified with linaro 6.2 + `arm-linux-gnueabihf <https://releases.linaro.org/components/toolchain/binaries/6.2-2016.11/arm-linux-gnueabihf/>`__. + Set the CROSS_COMPILE environment variable to point to the toolchain folder. + +- Fetch and build u-boot. + Make the .config file using the command: + + .. code:: shell + + make ARCH=arm vexpress_aemv8a_aarch32_config + + Make the u-boot binary for Cortex-A5 using the command: + + .. code:: shell + + make ARCH=arm SUPPORT_ARCH_TIMER=no + + Make the u-boot binary for Cortex-A7 using the command: + + .. code:: shell + + make ARCH=arm + + +- Build TF-A: + + The make command for Cortex-A5 is: + + .. code:: shell + + make PLAT=fvp_ve ARCH=aarch32 ARM_ARCH_MAJOR=7 ARM_CORTEX_A5=yes \ + AARCH32_SP=sp_min FVP_HW_CONFIG_DTS=fdts/fvp-ve-Cortex-A5x1.dts \ + ARM_XLAT_TABLES_LIB_V1=1 BL33=<path_to_u-boot.bin> all fip + + The make command for Cortex-A7 is: + + .. code:: shell + + make PLAT=fvp_ve ARCH=aarch32 ARM_ARCH_MAJOR=7 ARM_CORTEX_A7=yes \ + AARCH32_SP=sp_min FVP_HW_CONFIG_DTS=fdts/fvp-ve-Cortex-A7x1.dts \ + BL33=<path_to_u-boot.bin> all fip + +Run Procedure +------------- + +The following model parameters should be used to boot Linux using the build of +arm-trusted-firmware-a made using the above make commands: + + .. code:: shell + + ./<path_to_model> <path_to_bl1.elf> \ + -C motherboard.flashloader1.fname=<path_to_fip.bin> \ + --data cluster.cpu0=<path_to_zImage>@0x80080000 \ + --data cluster.cpu0=<path_to_ramdisk>@0x84000000 diff --git a/docs/plat/stm32mp1.rst b/docs/plat/stm32mp1.rst index f8379b4eb..bfae9ccc8 100644 --- a/docs/plat/stm32mp1.rst +++ b/docs/plat/stm32mp1.rst @@ -4,6 +4,8 @@ Trusted Firmware-A for STM32MP1 STM32MP1 is a microprocessor designed by STMicroelectronics based on a dual Arm Cortex-A7. It is an Armv7-A platform, using dedicated code from TF-A. +The STM32MP1 chip also embeds a Cortex-M4. +More information can be found on `STM32MP1 Series`_ page. Design @@ -78,7 +80,7 @@ To build: make CROSS_COMPILE=arm-linux-gnueabihf- PLAT=stm32mp1 ARCH=aarch32 ARM_ARCH_MAJOR=7 AARCH32_SP=sp_min cd <u-boot_directory> make stm32mp15_basic_defconfig - make DEVICE_TREE=stm32mp157c_ev1 all + make DEVICE_TREE=stm32mp157c-ev1 all ./tools/mkimage -T stm32image -a 0xC0100000 -e 0xC0100000 -d u-boot.bin u-boot.stm32 The following build options are supported: @@ -96,3 +98,6 @@ It should contain at least those partitions: - ssbl: to copy the u-boot.stm32 binary Usually, two copies of fsbl are used (fsbl1 and fsbl2) instead of one partition fsbl. + + +.. _STM32MP1 Series: https://www.st.com/en/microcontrollers-microprocessors/stm32mp1-series.html |