summaryrefslogtreecommitdiff
path: root/doc/board/samsung/exynos-mobile.rst
blob: d0173b1f8cb69ae00d6978644b4bc38126701686 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
.. SPDX-License-Identifier: GPL-2.0+
.. sectionauthor:: Kaustabh Chakraborty <kauschluss@disroot.org>

Samsung Exynos Generic ARMv8 Boards (for mobile devices)
========================================================

Overview
--------
This document describes how to build and run U-Boot for Samsung Exynos generic
boards. Boards are expected to boot with a primary bootloader, such as S-BOOT or
S-LK, which hands off control to U-Boot. Presently, only ARMv8 devices are
supported.

The U-Boot image is built with all device tree blobs packed in a single FIT
image. During boot, it uses simple heuristics to detect the target board, and
subsequently the appropriate FDT is selected.

Installation
------------
Building
^^^^^^^^
If a cross-compiler is required, install it and set it up like so:

.. prompt:: bash $

	export CROSS_COMPILE=aarch64-linux-gnu-

Then, run the following commands to build U-Boot (replace ``<dtb>`` with the
upstream DTB path for the target device):

.. prompt:: bash $

	make O=.output exynos-mobile_defconfig
	make DEVICE_TREE=<dtb> O=.output -j$(nproc)

If successful, the U-Boot binary will be present in ``.output/u-boot.bin``.

Preparation and Flashing
^^^^^^^^^^^^^^^^^^^^^^^^
Since U-Boot supports multiple boards, and devices have different requirements,
this step will vary depending on your target.

.. toctree::
	:maxdepth: 1

	exynos-mobile/exynos7870