Re: [PATCH 1/3] doc: board: qualcomm: document SM8550/QCS8550 building/flashing

Hi William,

On 7/20/26 10:52, William Bright wrote:
> Introducing documentation support for Qualcomm SnapDragon Gen 2 SM8550
> and QualComm Dragonwing Q8 QCS8550. Documents the build and flashing
> steps.

Thanks for sending this series!

Do you think this could just be folded into dragonwing.rst? We're sorely 
missing some nice broader overview of the list of supported 
platforms/boards, but since there's a lot of overlap here I don't think 
we need to duplicate the instructions.

Please also rebase this on qcom-next from 
https://source.denx.de/u-boot/custodians/u-boot-snapdragon and add 
CONFIG_QCOM_GENERATE_MBN=y to the defconfig (instead of 
CONFIG_REMAKE_ELF), that should actually spit out a ready to flash 
u-boot.mbn.

You should also be able to drop patch 2 since the memory map should be 
parsed from SMEM automatically.

Thanks,
Casey

> 
> Signed-off-by: William Bright <[email protected]>
> ---
>   doc/board/qualcomm/index.rst  |  1 +
>   doc/board/qualcomm/sm8550.rst | 48 +++++++++++++++++++++++++++++++++++++++++++
>   2 files changed, 49 insertions(+)
> 
> diff --git a/doc/board/qualcomm/index.rst b/doc/board/qualcomm/index.rst
> index 3238a68e859..de5b24dd463 100644
> --- a/doc/board/qualcomm/index.rst
> +++ b/doc/board/qualcomm/index.rst
> @@ -14,3 +14,4 @@ Qualcomm
>      iq8
>      phones
>      rdp
> +   sm8550
> diff --git a/doc/board/qualcomm/sm8550.rst b/doc/board/qualcomm/sm8550.rst
> new file mode 100644
> index 00000000000..200420dcaf8
> --- /dev/null
> +++ b/doc/board/qualcomm/sm8550.rst
> @@ -0,0 +1,48 @@
> +.. SPDX-License-Identifier: GPL-2.0+
> +.. sectionauthor:: William Bright <[email protected]>
> +
> +Qualcomm SM8550
> +===============
> +
> +The SM8550 (Snapdragon 8 Gen 2) is a Qualcomm mobile SoC featuring an octa-core
> +Qualcomm Kryo CPU and a Qualcomm Adreno 740 GPU. The ``QCS8550``, part of the
> +Qualcomm Dragonwing Q8 series, is a child SoC of the SM8550 that drops the
> +RF modem. As the two SoCs are otherwise identical, the same
> +``qcom_sm8550_defconfig`` and flashing process can be used for both SoCs.
> +
> +More information can be found on the `Qualcomm's SM8550 product page`_ and the
> +`Qualcomm's QCS8550 product page`_.
> +
> +.. _Qualcomm's SM8550 product page:
> +   https://www.qualcomm.com/products/mobile/snapdragon/smartphones/snapdragon-8-series-mobile-platforms/snapdragon-8-gen-2-mobile-platform
> +.. _Qualcomm's QCS8550 product page:
> +   https://www.qualcomm.com/internet-of-things/products/q8-series/qcs8550
> +
> +Installation
> +------------
> +First, setup ``CROSS_COMPILE`` for aarch64. Then, build U-Boot for
> +``SM8550``::
> +
> +   $ export CROSS_COMPILE=<aarch64 toolchain prefix>
> +   $ make qcom_sm8550_defconfig
> +   $ make -j8
> +
> +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.
> +
> +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 the SM8550-HDK, as a
> +result, to flash back the original firmware, or new versions of the U-Boot, EDL
> +mode must be used.
> +
> +A tool like bkerler's `edl`_ can be used for flashing::
> +
> +   $ edl.py --loader /path/to/prog_firehose_ddr.elf w uefi_a u-boot.mbn
> +
> +.. _edl: https://github.com/bkerler/edl
>