blob: f09fb5af1b3ba5f670e3da2b914708100f6b44cb [file] [log] [blame]
Sumit Gargb35aa4f2024-04-12 15:24:38 +05301.. SPDX-License-Identifier: GPL-2.0+
2.. sectionauthor:: Sumit Garg <sumit.garg@linaro.org>
3
4HMIBSC
5======
6
7The HMIBSC is an IIoT Edge Box Core board based on the Qualcomm APQ8016E SoC.
8More information can be found on the `SE product page`_.
9
10U-Boot can be used as a replacement for Qualcomm's original Android bootloader
11(a fork of Little Kernel/LK). Like LK, it is installed directly into the ``aboot``
12partition. Note that the U-Boot port used to be loaded as an Android boot image
13through LK. This is no longer the case, now U-Boot can replace LK entirely.
14
15.. _SE product page: https://www.se.com/us/en/product/HMIBSCEA53D1L0T/iiot-edge-box-core-harmony-ipc-emmc-dc-linux-tpm/
16
17Build steps
18-----------
19
20First, setup ``CROSS_COMPILE`` for aarch64. Then, build U-Boot for ``hmibsc``::
21
22 $ export CROSS_COMPILE=<aarch64 toolchain prefix>
23 $ make hmibsc_defconfig
24 $ make
25
26This will build ``u-boot.elf`` in the configured output directory.
27
28Installation
29------------
30
31Although the HMIBSC does not have secure boot set up by default, the firmware
32still expects firmware ELF images to be "signed". The signature does not provide
33any security in this case, but it provides the firmware with some required
34metadata.
35
36To "sign" ``u-boot.elf`` you can use e.g. `qtestsign`_::
37
38 $ ./qtestsign.py aboot u-boot.elf
39
40Then install the resulting ``u-boot-test-signed.mbn`` to the ``aboot`` partition
41on your device, e.g. with ``fastboot flash aboot u-boot-test-signed.mbn``.
42
43U-Boot should be running after a reboot (``fastboot reboot``).
44
45.. _qtestsign: https://github.com/msm8916-mainline/qtestsign