[people/ms/u-boot.git] / doc / README.marvell

Marvell U-Boot Build Instructions
=================================

This document describes how to compile the U-Boot and how to change U-Boot configuration

Build Procedure
----------------
1. Install required packages:

		# sudo apt-get install libssl-dev
		# sudo apt-get install device-tree-compiler
		# sudo apt-get install swig libpython-dev

2. Set the cross compiler:

		# export CROSS_COMPILE=/path/to/toolchain/aarch64-marvell-linux-gnu-

3. Clean-up old residuals:

		# make mrproper

4. Configure the U-Boot:

		# make <defconfig_file>

	- For the Armada-70x0/80x0 DB board use "mvebu_db_armada8k_defconfig"
	- For the Armada-80x0 MacchiatoBin use "make mvebu_mcbin-88f8040_defconfig"
	- For the Armada-3700 DB board use "make mvebu_db-88f3720_defconfig"
	- For the Armada-3700 EsspressoBin use "make mvebu_espressobin-88f3720_defconfig"

5. Configure the device-tree and build the U-Boot image:

	Compile u-boot and set the required device-tree using:

		# make DEVICE_TREE=<name>

	NOTE:
	Compilation with "mvebu_db_armada8k_defconfig" requires explicitly exporting DEVICE_TREE
	for the requested board.
	By default, u-boot is compiled with armada-8040-db device-tree.
        Using A80x0 device-tree on A70x0 might break the device.
        In order to prevent this, the required device-tree MUST be set during compilation.
        All device-tree files are located in ./arch/arm/dts/ folder.

	NOTE:
	The u-boot.bin should not be used as a stand-alone image.
	The ARM Trusted Firmware (ATF) build process uses this image to generate the
	flash image.

Configuration update
---------------------
	To update the U-Boot configuration, please refer to doc/README.kconfig
Commit	Line	Data
b6518b1e IL	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