mirror of
https://github.com/AsahiLinux/u-boot
synced 2024-12-13 14:53:06 +00:00
f8a1b33889
U-boot is intended to replace linux kernel in android boot image(ABL), and it's FIT payload to replace initramfs file. The boot process is similar to boot image with linux: - android bootloader (ABL) unpacks android boot image - ABL sets `linux,initrd-start property` in chosen node in unpacked FDT - ABL sets x0 register to FDT address, and passes control to u-boot - u-boot reads x0 register, and stores it in `prevbl_fdt_addr` env variable - u-boot reads `linux,initrd-start` property, and stores it in `prevbl_initrd_start_addr` In this way, u-boot bootcmd relies on `prevbl_initrd_start_addr` env variable, and boils down to `bootm $prevbl_initrd_start_addr`. If more control on boot process is desired, pack a boot script in FIT image, and put it to default configuration What done: - strip unneeded config options - add FIT image support - add framebuffer node, u-boot logo and video console - increase LMB_MAX_REGIONS, to store all linux dtb reserved memory regions - add linux kernel image header Uart driver causes hang, when u-boot is used in android boot image instead of linux. Temporary disable console driver, until investigated and fixed. Signed-off-by: Dzmitry Sankouski <dsankouski@gmail.com> Cc: Ramon Fried <rfried.dev@gmail.com>
83 lines
2.1 KiB
ReStructuredText
83 lines
2.1 KiB
ReStructuredText
.. SPDX-License-Identifier: GPL-2.0+
|
|
.. sectionauthor:: Dzmitry Sankouski <dsankouski@gmail.com>
|
|
|
|
Snapdragon 845
|
|
================
|
|
|
|
About this
|
|
----------
|
|
This document describes the information about Qualcomm Snapdragon 845
|
|
supported boards and it's usage steps.
|
|
|
|
SDM845 - hi-end qualcomm chip, introduced in late 2017.
|
|
Mostly used in flagship phones and tablets of 2018.
|
|
|
|
U-Boot can be used as a replacement for Qualcomm's original ABL (UEFI) bootloader.
|
|
It is loaded as an Android boot image through ABL
|
|
|
|
Installation
|
|
------------
|
|
Build
|
|
^^^^^
|
|
Setup ``CROSS_COMPILE`` for aarch64 and build U-Boot for your board::
|
|
|
|
$ export CROSS_COMPILE=<aarch64 toolchain prefix>
|
|
$ make <your board name here, see Boards section>_defconfig
|
|
$ make
|
|
|
|
This will build ``u-boot.bin`` in the configured output directory.
|
|
|
|
Generate FIT image
|
|
^^^^^^^^^^^^^^^^^^
|
|
See doc/uImage.FIT for more details
|
|
|
|
Pack android boot image
|
|
^^^^^^^^^^^^^^^^^^^^^^^
|
|
We'll assemble android boot image with ``u-boot.bin`` instead of linux kernel,
|
|
and FIT image instead of ``initramfs``. Android bootloader expect gzipped kernel
|
|
with appended dtb, so let's mimic linux to satisfy stock bootloader:
|
|
|
|
- create dump dtb::
|
|
|
|
workdir=/tmp/prepare_payload
|
|
mkdir -p "$workdir"
|
|
cd "$workdir"
|
|
mock_dtb="$workdir"/payload_mock.dtb
|
|
|
|
dtc -I dts -O dtb -o "$mock_dtb" << EOF
|
|
/dts-v1/;
|
|
/ {
|
|
memory {
|
|
/* We expect the bootloader to fill in the size */
|
|
reg = <0 0 0 0>;
|
|
};
|
|
|
|
chosen { };
|
|
};
|
|
EOF
|
|
|
|
- gzip u-boot ``gzip u-boot.bin``
|
|
- append dtb to gzipped u-boot: ``cat u-boot.bin.gz "$mock_dtb" > u-boot.bin.gz-dtb``
|
|
|
|
Now we've got everything to build android boot image:::
|
|
|
|
mkbootimg --base 0x0 --kernel_offset 0x00008000 \
|
|
--ramdisk_offset 0x02000000 --tags_offset 0x01e00000 \
|
|
--pagesize 4096 --second_offset 0x00f00000 \
|
|
--ramdisk "$fit_image" \
|
|
--kernel u-boot.bin.gz-dtb \
|
|
-o boot.img
|
|
|
|
Flash image with your phone's flashing method.
|
|
|
|
Boards
|
|
------------
|
|
starqlte
|
|
^^^^^^^^^^^^
|
|
|
|
The starqltechn is a production board for Samsung S9 (SM-G9600) phone,
|
|
based on the Qualcomm SDM845 SoC.
|
|
|
|
More information can be found on the `Samsung S9 page`_.
|
|
|
|
.. _Samsung S9 page: https://en.wikipedia.org/wiki/Samsung_Galaxy_S9
|