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

Introducing documentation support for Qualcomm SnapDragon Gen 2 SM8550
and QualComm Dragonwing Q8 QCS8550. Documents the build and flashing
steps.

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

-- 
2.43.0