On 6/23/26 08:48, Varadarajan Narayanan wrote:
Add details about the SPL & U-Boot proper build steps, converting to
flashable images, source URLs for the needed binaries and scripts.
Additionally, this should be updated to use mkmbn.py which includes mbn
v7 support.... As for create_multielf.py, does it do anything that "cat"
doesn't ????
I think it would be pretty simple to expand the match table in mkmbn.py
and have it check for the TME elf and append it when building for this
platform (so it would output a u-boot-spl.mbn AND u-boot-spl.melf), just
add another build target in board/qualcomm/config.mk.
Thanks,
// Casey>
Signed-off-by: Varadarajan Narayanan <[email protected]>
---
v5: Fix documentation related build errors
v4: Replace script based image creation with binman based command
v3: Use '-' for sub heading instead of '='
Add location for template.its and sort the list alphabetically
---
doc/board/qualcomm/rdp.rst | 98 ++++++++++++++++++++++++++++++++++++--
1 file changed, 93 insertions(+), 5 deletions(-)
diff --git a/doc/board/qualcomm/rdp.rst b/doc/board/qualcomm/rdp.rst
index 99cf8eba57c..5a0ce92e310 100644
--- a/doc/board/qualcomm/rdp.rst
+++ b/doc/board/qualcomm/rdp.rst
@@ -24,13 +24,17 @@ This will build ``u-boot.elf`` in the configured output
directory.
The firmware expects the ELF images to be in MBN format. The `elftombn.py`
tool
can be used to convert the ELF images to MBN format.
- IPQ9574: (MBN version 6)
+IPQ9574: (MBN version 6)
- $ python elftombn.py -f u-boot.elf -o u-boot.mbn -v6
+.. code-block:: bash
- IPQ5424: (MBN version 7)
+ python elftombn.py -f u-boot.elf -o u-boot.mbn -v6
- $ python elftombn.py -f u-boot.elf -o u-boot.mbn -v7
+IPQ5424: (MBN version 7)
+
+.. code-block:: bash
+
+ python elftombn.py -f u-boot.elf -o u-boot.mbn -v7
Then install the resulting ``u-boot.mbn`` to the ``0:APPSBL`` partition
on your device with::
@@ -42,17 +46,101 @@ on your device with::
U-Boot should be running after a reboot (``reset``).
+Build steps for IPQ5210 based Qualcomm Dragonwing F8 & N8 Platforms:
+--------------------------------------------------------------------
+
+Please refer to the following URLs for more details about the platforms.
+
+ F8:
https://www.qualcomm.com/networking-infrastructure/products/f-series/f8-platform
+
+ N8:
https://www.qualcomm.com/networking-infrastructure/products/n-series/n8-platform
+
+1. Since U-Boot SPL is enabled on these platforms, the build command generates
+ both the U-Boot SPL and U-Boot proper images. Assuming ${uboot_dir} is the
+ top of the U-Boot sources and ${out_dir} as the output directory,
+
+.. code-block:: bash
+
+ cd ${uboot_dir}
+ export CROSS_COMPILE=<aarch64 toolchain prefix>
+ make -j8 O=${out_dir} qcom_ipq5210_mmc_defconfig
+ make -j8 O=${out_dir}
+
+U-Boot SPL image: ${out_dir}/spl/u-boot-spl.wrap-elf
+U-Boot image: ${out_dir}/u-boot.elf
+
+2. Convert the SPL image to multi ELF
+
+.. code-block:: bash
+
+ cd ${out_dir}/spl
+ python elftombn.py -f u-boot-spl.wrap-elf -o u-boot-spl.mbn -v7
+ python `create_multielf.py` -f u-boot-spl.mbn,tmel-ipq52xx-patch.elf \
+ -o u-boot-spl.melf
+
+This u-boot-spl.melf should be flashed into 0:SPL partition.
+Please see below for the location of `tmel-ipq52xx-patch.elf`
+
+3. Convert the U-Boot image to bootloader image
+
+.. code-block:: bash
+
+ cd ${out_dir}
+ python elftombn.py -f u-boot.elf -o u-boot.mbn -v7
+
+The u-boot.mbn has to be combined with `qc_config.elf`, `QCLib.elf`, `TFA`
+and `OPTEE`. Please see below for the location for these ELFs. TFA and OPTEE
+can be built from the sources using the following commands
+
+TFA:
+
+.. code-block:: bash
+
+ make PLAT=ipq52xx QTISECLIB_PATH=path/to/`libqtisec_dbg.a` SPD=opteed
+
+OPTEE:
+
+.. code-block:: bash
+
+ make PLATFORM=qcom-ipq52xx -j16
+
+These binaries can be combined into a flashable image using `gen_its.py`.
+
+.. code-block:: bash
+
+ python gen_its.py --arch ipq5210 \
+ --qclib_path `QCLib.elf` \
+ --qcconfig_path `qc_config.elf` \
+ --tfa_bl31_path bl31.mbn \
+ --uboot_path u-boot.mbn \
+ --optee_path tee-raw.mbn \
+ -p qcconfig qclib \
+ -P tfa_bl31 uboot optee \
+ -o output/hm_503_test_uboot.img \
+ --template `template.its`
+
+This should be flashed into 0:BOOTLDR partition.
+
.. WARNING
Boards with newer software versions would automatically go the emergency
download (EDL) mode if U-Boot is not functioning as expected. If its a
runtime failure at Uboot, the system will get reset (due to watchdog)
and XBL will try to boot from next bank and if Bank B also doesn't have
a functional image and is not booting fine, then the system will enter
- EDL. A tool like bkerler's `edl`_ can be used for flashing with the
+ EDL. A tool like bkerler's `edl` can be used for flashing with the
firehose loader binary appropriate for the board.
Note that the support added is very basic. Restoring the original U-Boot
on boards with older version of the software requires a debugger.
+.. _create_multielf.py: https://raw.githubusercontent.com/coreboot/coreboot/refs/heads/main/util/qualcomm/create_multielf.py
.. _elftombn.py:
https://git.codelinaro.org/clo/qsdk/oss/system/tools/meta/-/tree/NHSS.QSDK.13.0.5.r2/scripts?ref_type=heads
.. _edl: https://github.com/bkerler/edl
+.. _gen_its.py:
https://git.codelinaro.org/clo/qsdk/oss/system/tools/meta/-/tree/win.platform_tools.1.0.r34/scripts?ref_type=heads
+.. _libqtisec_dbg.a:
https://softwarecenter.qualcomm.com/nexus/generic/product/chip/software-product/IPQ5210.NLQ.14.0/ipq5210.nlq.14.0-qca-oem-qartifact/r00036.1/WIN.TFA.1.0.R4/apss_proc/out/proprietary/qtiseclib/output/ipq52xx/release/libqtisec_dbg.a
+.. _OPTEE:
https://git.codelinaro.org/clo/trusted-firmware/optee_os/optee_os/-/tree/win.optee.1.0?ref_type=heads
+.. _qc_config.elf:
https://softwarecenter.qualcomm.com/nexus/generic/product/chip/software-product/IPQ5210.NLQ.14.0/ipq5210.nlq.14.0-qca-oem-qartifact/r00036.1/BOOT.MXF.2.3.1.1/boot_images/boot/QcomPkg/SocPkg/Hermosa/Bin/LC/RELEASE/qc_config.elf
+.. _QCLib.elf:
https://softwarecenter.qualcomm.com/nexus/generic/product/chip/software-product/IPQ5210.NLQ.14.0/ipq5210.nlq.14.0-qca-oem-qartifact/r00036.1/BOOT.MXF.2.3.1.1/boot_images/boot/QcomPkg/SocPkg/Hermosa/Bin/LC/RELEASE/QCLib.elf
+.. _template.its:
https://git.codelinaro.org/clo/qsdk/oss/system/tools/meta/-/tree/win.platform_tools.1.0.r34/scripts?ref_type=heads
+.. _TFA:
https://git.codelinaro.org/clo/trusted-firmware/tf-a/trusted-firmware-a/-/tree/win.tfa.1.0.r4?ref_type=heads
+.. _tmel-ipq52xx-patch.elf:
https://softwarecenter.qualcomm.com/nexus/generic/product/chip/software-product/IPQ5210.NLQ.14.0/ipq5210.nlq.14.0-qca-oem-qartifact/r00036.1/TMEL.WNS.2.4/tmel-ipq52xx-patch.elf
