doc: board: qualcomm: document Dragonwing board building/flashing

Introducing documentation support for Qualcomm Dragonwing series
boards. Documents the build and flashing steps.

Signed-off-by: Balaji Selvanathan <balaji.selvanathan@oss.qualcomm.com>
Link: https://lore.kernel.org/r/20250529154931.1879976-2-quic_bselvana@quicinc.com
[Casey: add dragonwing to board/qualcomm/index.rst]
Signed-off-by: Casey Connolly <casey.connolly@linaro.org>
This commit is contained in:
Balaji Selvanathan 2025-05-29 21:19:26 +05:30 committed by Tom Rini
parent 787ef52288
commit e71cfbbae6
2 changed files with 47 additions and 0 deletions

View File

@ -0,0 +1,46 @@
.. SPDX-License-Identifier: GPL-2.0
.. sectionauthor:: Balaji Selvanathan <balaji.selvanathan@oss.qualcomm.com>
Qualcomm DragonWing
========================================
Qualcomm DragonWing are industrial-grade boards that provides various series
of processors such as IQ6 (QCS615), IQ8 (QCS8300) and IQ9 (QCS9100).
These SoCs are used for factory/industry based applications.
More information can be found on the `Qualcomm's IQ6 product page`_,
`Qualcomm's IQ8 product page`_ and `Qualcomm's IQ9 product page`_.
.. _Qualcomm's IQ6 product page: https://docs.qualcomm.com/bundle/publicresource/87-83838-1_REV_A_Qualcomm_IQ6_Series_Product_Brief.pdf
.. _Qualcomm's IQ8 product page: https://docs.qualcomm.com/bundle/publicresource/87-83839-1_REV_A_Qualcomm_IQ8_Series_Product_Brief________.pdf
.. _Qualcomm's IQ9 product page: https://docs.qualcomm.com/bundle/publicresource/87-83840-1_REV_A_Qualcomm_IQ9_Series_Product_Brief.pdf
Installation
------------
First, setup ``CROSS_COMPILE`` for aarch64. Then, build U-Boot for ``QCS615``, ``QCS8300`` or ``QCS9100``::
$ export CROSS_COMPILE=<aarch64 toolchain prefix>
$ make qcom_qcs8300_defconfig
$ make -j8 u-boot.mbn
This will build the signed ``u-boot.mbn`` in the configured output directory.
The firmware expects firmware ELF images to be "signed". The signature
does not provide any security in this case, but it provides the firmware
with some required metadata. More information
about image signing can be found in :doc:`signing`.
Then flash the resulting ``u-boot.mbn`` to the ``uefi_a`` partition
on your device with ``fastboot flash uefi_a u-boot.mbn``.
U-Boot should be running after a reboot (``fastboot reboot``).
Note that fastboot is not yet supported in U-Boot on Dragonwing boards, as a result, to flash
back the original firmware, or new versoins of the U-Boot, EDL mode must be used.
A tool like bkerler's `edl`_ can be used for flashing with the firehose loader (for example, for QCS9100
the firehose loader can be obtained from `dragonwing IQ9 bootbinaries`.) ::
$ edl.py --loader /path/to/prog_firehose_ddr.elf w uefi_a u-boot.mbn
.. _qtestsign: https://github.com/msm8916-mainline/qtestsign
.. _edl: https://github.com/bkerler/edl
.. _dragonwing IQ9 bootbinaries: https://artifacts.codelinaro.org/ui/native/qli-ci/flashable-binaries/qimpsdk/qcs9075-rb8-core-kit

View File

@ -8,6 +8,7 @@ Qualcomm
dragonboard410c
rb3gen2
dragonwing
board
phones
debugging