[PATCH v3 1/6] doc: board: qualcomm: document Dragonwing board building/flashing

[Casey Connolly]

Hi Balaji,

On 5/21/25 10:44, Balaji Selvanathan wrote:
> Introducing documentation support for Qualcomm Dragonwing series
> boards. Documents the build and flashing steps.

Thanks for adding this!

> 
> Signed-off-by: Balaji Selvanathan <balaji.selvanathan at oss.qualcomm.com>
> ---
> v3:
> - No changes to this patch in v3
> 
> v2:
> - This file is newly added in v2 based on suggestion from reviewer
> ---
>   doc/board/qualcomm/dragonwing.rst | 41 +++++++++++++++++++++++++++++++
>   1 file changed, 41 insertions(+)
>   create mode 100644 doc/board/qualcomm/dragonwing.rst
> 
> diff --git a/doc/board/qualcomm/dragonwing.rst b/doc/board/qualcomm/dragonwing.rst
> new file mode 100644
> index 00000000000..18788cd6167
> --- /dev/null
> +++ b/doc/board/qualcomm/dragonwing.rst
> @@ -0,0 +1,41 @@
> +.. SPDX-License-Identifier: GPL-2.0
> +.. sectionauthor:: Balaji Selvanathan <balaji.selvanathan at 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
> +
> +This will build ``u-boot.elf`` 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.
> +
> +To "sign" ``u-boot.elf`` you can use e.g. `qtestsign`_::
> +
> +  $ qtestsign -v6 aboot -o u-boot.mbn u-boot.elf
> +
> +Then install the resulting ``u-boot.mbn`` to the ``uefi_a`` partition
> +on your device.

The flashing steps here are a bit vague, with the edl tool it's 
something like

./edl.py --loader /path/to/prog_firehose_ddr.elf w uefi_a 
/path/to/u-boot.mbn

All the pages are a bit sparse in this regard, we should probably add a 
generic "edl flashing" page at some point.

As a final note, is the firehose loader for these boards published 
anywhere? Otherwise there is a major risk of bricking here. Could you 
include a link to them?

Sorry this is a higher standard than the rb3gen2 page, it also needs 
some improvements...

Thanks and kind regards,

> +
> +U-Boot should be running after a reboot (``reset``).
> +
> +.. _qtestsign: https://github.com/msm8916-mainline/qtestsign
> +.. _edl: https://github.com/bkerler/edl
-- 
Casey (she/they)