diff options
Diffstat (limited to 'docs')
-rw-r--r-- | docs/about/maintainers.rst | 10 | ||||
-rw-r--r-- | docs/plat/index.rst | 1 | ||||
-rw-r--r-- | docs/plat/marvell/armada/build.rst | 22 | ||||
-rw-r--r-- | docs/plat/marvell/armada/porting.rst | 7 | ||||
-rw-r--r-- | docs/plat/qti.rst | 41 |
5 files changed, 69 insertions, 12 deletions
diff --git a/docs/about/maintainers.rst b/docs/about/maintainers.rst index 0014d3b46..a62870452 100644 --- a/docs/about/maintainers.rst +++ b/docs/about/maintainers.rst @@ -446,6 +446,15 @@ QEMU platform port :F: docs/plat/qemu.rst :F: plat/qemu/ +QTI platform port +^^^^^^^^^^^^^^^^^ +:M: Saurabh Gorecha <sgorecha@codeaurora.org> +:G: `sgorecha`_ +:M: Debasish Mandal <dmandal@codeaurora.org> +:M: QTI TF Maintainers <qti.trustedfirmware.maintainers@codeaurora.org> +:F: docs/plat/qti.rst +:F: plat/qti/ + Raspberry Pi 3 platform port ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ :M: Ying-Chun Liu (PaulLiu) <paul.liu@linaro.org> @@ -614,6 +623,7 @@ Build system .. _remi-triplefault: https://github.com/repk .. _rockchip-linux: https://github.com/rockchip-linux .. _sandrine-bailleux-arm: https://github.com/sandrine-bailleux-arm +.. _sgorecha: https://github.com/sgorecha .. _shawnguo2: https://github.com/shawnguo2 .. _sivadur: https://github.com/sivadur .. _smaeul: https://github.com/smaeul diff --git a/docs/plat/index.rst b/docs/plat/index.rst index 6a38113fc..bd2341010 100644 --- a/docs/plat/index.rst +++ b/docs/plat/index.rst @@ -28,6 +28,7 @@ Platform Ports poplar qemu qemu-sbsa + qti rpi3 rpi4 rcar-gen3 diff --git a/docs/plat/marvell/armada/build.rst b/docs/plat/marvell/armada/build.rst index da4ba565a..6b9054c7c 100644 --- a/docs/plat/marvell/armada/build.rst +++ b/docs/plat/marvell/armada/build.rst @@ -26,7 +26,7 @@ BL33 should be ``~/project/u-boot/u-boot.bin`` *u-boot.bin* should be used and not *u-boot-spl.bin* -Set MSS/SCP image path (mandatory only for Armada80x0) +Set MSS/SCP image path (mandatory only for A7K/8K/CN913x) .. code:: shell @@ -92,22 +92,31 @@ There are several build options: - BLE_PATH - Points to BLE (Binary ROM extension) sources folder. Only required for A8K builds. + Points to BLE (Binary ROM extension) sources folder. + Only required for A7K/8K/CN913x builds. The parameter is optional, its default value is ``plat/marvell/armada/a8k/common/ble``. - MV_DDR_PATH - For A7/8K, use this parameter to point to mv_ddr driver sources to allow BLE build. For A37x0, + For A7K/8K/CN913x, use this parameter to point to mv_ddr driver sources to allow BLE build. For A37x0, it is used for ddr_tool build. Usage example: MV_DDR_PATH=path/to/mv_ddr - The parameter is optional for A7/8K, when this parameter is not set, the mv_ddr + The parameter is optional for A7K/8K/CN913x, when this parameter is not set, the mv_ddr sources are expected to be located at: drivers/marvell/mv_ddr. However, the parameter is necessary for A37x0. For the mv_ddr source location, check the section "Tools and external components installation" +- CP_NUM + + Total amount of CPs (South Bridge) connected to AP. When the parameter is omitted, + the build uses the default number of CPs, which is a number of embedded CPs inside the + package: 1 or 2 depending on the SoC used. The parameter is valid for OcteonTX2 CN913x SoC + family (PLAT=t9130), which can have external CPs connected to the MCI ports. Valid + values with CP_NUM are in a range of 1 to 3. + - DDR_TOPOLOGY For Armada37x0 only, the DDR topology map index/name, default is 0. @@ -191,7 +200,8 @@ There are several build options: - a70x0 - a70x0_amc (for AMC board) - a80x0 - - a80x0_mcbin (for MacciatoBin) + - a80x0_mcbin (for MacchiatoBin) + - t9130 (OcteonTX2 CN913x) Special Build Flags -------------------- @@ -199,7 +209,7 @@ Special Build Flags - PLAT_RECOVERY_IMAGE_ENABLE When set this option to enable secondary recovery function when build atf. In order to build UART recovery image this operation should be disabled for - a70x0 and a80x0 because of hardware limitation (boot from secondary image + A7K/8K/CN913x because of hardware limitation (boot from secondary image can interrupt UART recovery process). This MACRO definition is set in ``plat/marvell/armada/a8k/common/include/platform_def.h`` file. diff --git a/docs/plat/marvell/armada/porting.rst b/docs/plat/marvell/armada/porting.rst index 1723ebb57..ba8736dc6 100644 --- a/docs/plat/marvell/armada/porting.rst +++ b/docs/plat/marvell/armada/porting.rst @@ -36,7 +36,7 @@ memory map is required. .. note:: For a detailed information on how CCU, IOWIN, AXI-MBUS & IOB work, please refer to the SoC functional spec, and under - ``docs/marvell/misc/mvebu-[ccu/iob/amb/io-win].txt`` files. + ``docs/plat/marvell/armada/misc/mvebu-[ccu/iob/amb/io-win].rst`` files. boot loader recovery (marvell_plat_config.c) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -110,11 +110,6 @@ Comphy Porting (phy-porting-layer.h or phy-default-porting-layer.h) parameters need to be suited and the board designer should provide relevant values. - .. seealso:: - For XFI/SFI comphy type there is procedure "rx_training" which eases - process of suiting some of the parameters. Please see *uboot_cmd* - section: rx_training. - The PHY porting layer simplifies updating static values per board type, which are now grouped in one place. diff --git a/docs/plat/qti.rst b/docs/plat/qti.rst new file mode 100644 index 000000000..814e6726a --- /dev/null +++ b/docs/plat/qti.rst @@ -0,0 +1,41 @@ +Qualcomm Technologies, Inc. +=========================== + +Trusted Firmware-A (TF-A) implements the EL3 firmware layer for QTI SC7180. + + +Boot Trace +------------- + +Bootrom --> BL1/BL2 --> BL31 --> BL33 --> Linux kernel + +BL1/2 and BL33 can currently be supplied from Coreboot + Depthcharge + +How to build +------------ + +Code Locations +~~~~~~~~~~~~~~ + +- Trusted Firmware-A: + `link <https://git.trustedfirmware.org/TF-A/trusted-firmware-a.git>`__ + +Build Procedure +~~~~~~~~~~~~~~~ + +QTI SoC expects TF-A's BL31 to get integrated with other boot software +Coreboot, so only bl31.elf need to get build from the TF-A repository. + +The build command looks like + + make CROSS_COMPILE=aarch64-linux-gnu- PLAT=sc7180 COREBOOT=1 + +update value of CROSS_COMPILE argument with your cross-compilation toolchain. + +Additional QTISECLIB_PATH=<path to qtiseclib> can be added in build command. +if QTISECLIB_PATH is not added in build command stub implementation of qtiseclib +is picked. qtiseclib with stub implementation doesn't boot device. This was +added to satisfy compilation. + +QTISELIB for SC7180 is available at +`link <https://review.coreboot.org/cgit/qc_blobs.git/plain/sc7180/qtiseclib/libqtisec.a>`__ |