Djam/u-boot
1
0
Fork 0
mirror of https://github.com/u-boot/u-boot.git synced 2025-04-20 11:55:03 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

doc: board/qualcomm: document rb3gen2 building/flashing

Browse source 
The process here is almost identical to the Dragonboard 410c, we've come
full circle!

Reviewed-by: Simon Glass <sjg@chromium.org>
Signed-off-by: Caleb Connolly <caleb.connolly@linaro.org>
This commit is contained in:
Caleb Connolly 2024-08-21 15:41:52 +02:00
parent adc310c7af
commit 224c90ede4
No known key found for this signature in database
GPG key ID: 7930459FB9303217
2 changed files with 54 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

1
doc/board/qualcomm/index.rst
View file

@ -7,5 +7,6 @@ Qualcomm
:maxdepth: 2
dragonboard410c
rb3gen2
board
debugging

53
doc/board/qualcomm/rb3gen2.rst Normal file
View file

@ -0,0 +1,53 @@
.. SPDX-License-Identifier: GPL-2.0+
.. sectionauthor:: Caleb Connolly <caleb.connolly@linaro.org>
Qualcomm Robotics RB3 Gen 2
===========================
The RB3 Gen 2 is a development board based on the Qualcomm QCM6490 SoC (a derivative
of SC7280). More information can be found on `Qualcomm's product page`_.
U-Boot can be used as a replacement for Qualcomm's original EDK2 bootloader by
flashing it directly to the uefi_a (or _b) partition.
.. _Qualcomm's product page: https://www.qualcomm.com/developer/hardware/rb3-gen-2-development-kit
Installation
------------
First, setup ``CROSS_COMPILE`` for aarch64. Then, build U-Boot for ``qcm6490``::
$ export CROSS_COMPILE=<aarch64 toolchain prefix>
$ make qcm6490_defconfig
$ make -j8
This will build ``u-boot.elf`` in the configured output directory.
Although the RB3 Gen 2 does not have secure boot set up by default,
the firmware still 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 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 this board, as a result,
to flash back the original firmware, or new versoins of the U-Boot, EDL mode
must be used. This can be accessed by pressing the EDL mode button as described
in the Qualcomm Linux documentation. A tool like bkerler's `edl`_ can be used
for flashing with the firehose loader binary appropriate for the board.
.. _qtestsign: https://github.com/msm8916-mainline/qtestsign
.. _edl: https://github.com/bkerler/edl
Usage
-----
The USB Type-A ports are connected via a PCIe USB hub, which is not supported yet.
However, the Type-C port can be used with a powered USB dock to connect peripherals
like a USB stick.