Chris at 23:06, 5 April 2013

2013-04-05T23:06:22Z

← Older revision		Revision as of 23:06, 5 April 2013
Line 1:		Line 1:
			WORK IN PROGRESS

	== Adding a new Platform (Board) ==		== Adding a new Platform (Board) ==

			# add a line for the name of board and cpu to $UBOOT/boards.cfg
			# create a configuration file for the board


			=== Edit boards.cfg ===

			Add a line to the bottom of the boards.cfg file describing the new board and processor.
			* BOARD-NAME: Name of the board. This name is usually also used for the target name.
			* CPU-NAME: Name of the processor (Xtensa configuration); must match the directory name cpu-CPU-NAME.
			* VENDOR-NAME:

			BOARD-NAME CPU-NAME xtensa BOARD-NAME VENDOR-NAME
			#Target ARCH CPU Board name Vendor SoC Options

			=== Create a configuration file for the board ===

			<code> include/configs/ <code> directory, which is typically named after the board: <code> ''<board>''.h </code>. This file contains various board-specific macro definitions, such as FLASH location, device registers, etc.

			You should include ''addrspace.h'' from the Xtensa include directory. This file provides macros to

			#include <asm/addrspace.h>



			== OLD INFORMATION ==

	The easiest way to add new platform to U-Boot is usually to start from a similar board and modify the files as needed. The first step is to add the board to the main <code>Makefile</code> in the root directory.		The easiest way to add new platform to U-Boot is usually to start from a similar board and modify the files as needed. The first step is to add the board to the main <code>Makefile</code> in the root directory.

Chris: New page: == Adding a new Platform (Board) == The easiest way to add new platform to U-Boot is usually to start from a similar board and modify the files as needed. The first step is to add the boa...

2008-04-16T05:07:12Z

New page: == Adding a new Platform (Board) == The easiest way to add new platform to U-Boot is usually to start from a similar board and modify the files as needed. The first step is to add the boa...

New page

== Adding a new Platform (Board) ==

The easiest way to add new platform to U-Boot is usually to start from a similar board and modify the files as needed. The first step is to add the board to the main <code>Makefile</code> in the root directory.

Unlike other architectures, the processor configurations (''variants'') are defined inside the Xtensa include directory.

The following version allows for arbitrary Xtensa processor configuration. Instead of <code> make ''<board>''_config </code>, it requires an additional name to specify the ''<variant>''. This is the name of the processor configuration. The configuration <code> make ''variant''_''board''_config </code>, for example, the following command will configure U-Boot for the xtav60 board with a dc232l processor configuration: <code>make dc232l_xtav60_config</code>

%''<board>''_config: unconfig
@$(MKCONFIG) xtensa xtensa xtav60 avnet NULL $(*:_=)
@echo "VARIANT = $(*:_=)" >> $(obj)include/config.mk

''<board>''_config: unconfig
@$(MKCONFIG) xtensa xtensa ''<board>'' ''<vendor>'' NULL ''variant''

All board specific files are concentrated in one directory (the ''<vendor>'' sub-directory is optional):

board/[''<vendor>]''/''<board>''

This directory typically contains a README file describing the board and features, files for the build system (<code> Makefile </code> and <code> config.mk </code>), and one or more source files to initialize the board.

There is one additional configuration file in the <code> include/configs/ <code> directory, which is typically named after the board: <code> ''<board>''.h </code>. This file contains various board-specific macro definitions, such as FLASH location, device registers, etc.

You should include ''addrspace.h'' from the Xtensa include directory. This file provides macros to

#include <asm/addrspace.h>

== Adding a new Processor Configuration ==

U-Boot Porting - Revision history

Chris at 23:06, 5 April 2013

Chris: New page: == Adding a new Platform (Board) == The easiest way to add new platform to U-Boot is usually to start from a similar board and modify the files as needed. The first step is to add the boa...