Merge git://www.denx.de/git/u-boot-marvell
[platform/kernel/u-boot.git] / doc / README.marvell
1 Marvell U-Boot Build Instructions
2 =================================
3
4 This document describes how to compile the U-Boot and how to change U-Boot configuration
5
6 Build Procedure
7 ----------------
8 1. Install required packages:
9
10                 # sudo apt-get install libssl-dev
11                 # sudo apt-get install device-tree-compiler
12                 # sudo apt-get install swig libpython-dev
13
14 2. Set the cross compiler:
15
16                 # export CROSS_COMPILE=/path/to/toolchain/aarch64-marvell-linux-gnu-
17
18 3. Clean-up old residuals:
19
20                 # make mrproper
21
22 4. Configure the U-Boot:
23
24                 # make <defconfig_file>
25
26         - For the Armada-70x0/80x0 DB board use "mvebu_db_armada8k_defconfig"
27         - For the Armada-80x0 MacchiatoBin use "make mvebu_mcbin-88f8040_defconfig"
28         - For the Armada-3700 DB board use "make mvebu_db-88f3720_defconfig"
29         - For the Armada-3700 EsspressoBin use "make mvebu_espressobin-88f3720_defconfig"
30
31 5. Configure the device-tree and build the U-Boot image:
32
33         Compile u-boot and set the required device-tree using:
34
35                 # make DEVICE_TREE=<name>
36
37         NOTE:
38         Compilation with "mvebu_db_armada8k_defconfig" requires explicitly exporting DEVICE_TREE
39         for the requested board.
40         By default, u-boot is compiled with armada-8040-db device-tree.
41         Using A80x0 device-tree on A70x0 might break the device.
42         In order to prevent this, the required device-tree MUST be set during compilation.
43         All device-tree files are located in ./arch/arm/dts/ folder.
44
45         NOTE:
46         The u-boot.bin should not be used as a stand-alone image.
47         The ARM Trusted Firmware (ATF) build process uses this image to generate the
48         flash image.
49
50 Configuration update
51 ---------------------
52         To update the U-Boot configuration, please refer to doc/README.kconfig
53