Commit d1500f9c authored by Komal Shah's avatar Komal Shah Committed by Tony Lindgren

ARM: OMAP: Documentation/arm/OMAP/README update

Attached patch removes bk references and few changes to directory paths
for because of mach-omap2.
Signed-off-by: default avatarKomal Shah <komal_shah802003@yahoo.com>
Signed-off-by: default avatarTony Lindgren <tony@atomide.com>
parent a5f137d2
......@@ -44,7 +44,7 @@ time.
The first step is to get a bootloader for your board, u-boot is the
recommended one:
http://sourceforge.net/projects/uboot/
http://www.denx.de/en/Software/GIT
Then you need to compile it with the same cross compiler as you would use
for the Linux kernel. Then you need to flash it to the board either via the
......@@ -52,40 +52,16 @@ serial port, or by using a JTAG.
Once you have the bootloader running, you can compile the kernel.
You can get the OMAP sources either from the BitKeeper tree, or by
applying patches. The BitKeeper tree has the most up to date sources
You can get the OMAP sources either from the OMAP GIT tree, or by
applying patches. The OMAP GIT tree has the most up to date sources
and is the recommended one.
- Using BitKeeper:
- Using GIT and cloning OMAP GIT tree please follow the README at:
You need to download the bk tool from:
http://www.bitmover.com/
Download the dynamic one (x86-glibc22-linux) instead of the static
(x86-static-linux). Some users reported problems with the static version.
After bk tool is installed, to learn more about bitkeeper you can follow the
tutorial at:
http://www.bitkeeper.com/UG/
Then you can clone OMAP Linux by:
bk clone http://linux-omap.bkbits.net/main
Now, you have a copy (clone) of the reprository. To work with it and to
compile the kernel you have to check out the files from your local
repository by:
bk -r get (or: bk -r edit)
For kernel related BitKeeper information see also kernel documentation in:
Documentation/BK-usage/bk-kernel-howto.txt
http://www.muru.com/linux/omap/README_OMAP_GIT
Hint: If you are sitting behind a firewall and have to use a proxy for
internet access, you can access BitKeeper by http by setting the
internet access, you can access GIT by http by setting the
http_proxy envirionment variable:
http_proxy=http://proxy_username:proxy_password@proxy_name:proxy_port/
......@@ -104,7 +80,7 @@ abc.host.com: The name of your proxy you use for internet access
- Using Patches:
If you don't want to use BitKeeper, then you can do the same thing with patch.
If you don't want to use GIT, then you can do the same thing with patch.
Download the latest OMAP Linux patch from:
......@@ -125,8 +101,8 @@ $ cat ../Linux-2.6.4-omap1 | patch -p1
Note: If OMAP patch from muru.com is against a kernel release candidate,
marked by -rcX, then kernel can be found on kernel.org under v2.6/testing/
Now, if you have a local kernel tree, either by BitKeeper or by patch, you
should look into arch/arm/config/ to see which of the various omap_xxx
Now, if you have a local kernel tree, either by GIT or by patch, you
should look into arch/arm/configs/ to see which of the various omap_xxx
configurations there you want to use. For example, if you have a OMAP1510
based Innovator board, you select omap_innovator_1510_defconfig by
......@@ -206,10 +182,13 @@ time of writing this document in March 2004 four boards are supported:
Innovator1510 (OMAP1510 processor), Innovator1610 (OMAP1610 processor),
Perseus2 (OMAP730 processor) and H2 (OMAP1610 processor).
Please refer http://www.muru.com/linux/omap/ to get latest information on the
list of boards supported.
/* Discussion needed: How to handle the tons of compatible processors?
E.g. what to do if OMAP16xx is mainly identical with OMAP16yy? */
2. Start with arch/arm/mach-omap/Kconfig and add a new processor or board
2. Start with arch/arm/mach-omap[1/2]/Kconfig and add a new processor or board
option.
To add a new processor add a new config option to the "OMAP Core Type" choice.
......@@ -241,7 +220,7 @@ arch/arm/mm/Kconfig. E.g. ARCH_OMAP730 in CPU_ARM926T configuration.
3b. Only for new boards: Register the board within ARM Linux machine
registration system from RMK. For the CONFIG_ section use the same name like
in arch/arm/mach-omap/Kconfig. E.g. MACH_OMAP_yyyy. For MACH_TYPE_ section use
in arch/arm/mach-omap[1/2]/Kconfig. E.g. MACH_OMAP_yyyy. For MACH_TYPE_ section use
OMAP_yyyy where yyyy is the board name like above.
Note: The elements of RMKs machine registration are used in
......@@ -262,14 +241,14 @@ Use board-yyyy.h with yyyy board name or omapxxxx.h with xxxx processor number.
5. Add a processor or board specific section into include/asm-arm/arch-omap/
hardware.h. Use examples for syntax and use CONFIG_ names as defined in
arch/arm/mach-omap/Kconfig.
arch/arm/mach-omap[1/2]/Kconfig.
6. Add processor or board specific macros to board-yyyy.h or omapxxxx.h. The
macros to these specific files have to be named OMAPxxxx_ with xxxx processor
number to make them unique.
7a. Only for new boards: Add a file board-yyyy.c with yyyy board name to
arch/arm/mach-omap/. Put board specific initialization code and resource
arch/arm/mach-omap[1/2]/. Put board specific initialization code and resource
description into this file. The first element of MACHINE_START must be equal to
MACH_TYPE_ section of machine registration (see arch/arm/tools/mach-types after
machine registration at RMKs registration system).
......@@ -278,13 +257,13 @@ Put only code into this file that is board specific and not common. See other
board files for examples.
7b. Only for new processors: Add processor specific IO description and
iotable_init() to arch/arm/mach-omap/common.c. See examples for the syntax.
iotable_init() to arch/arm/mach-omap[1/2]/io.c. See examples for the syntax.
If you have introduced new clock definition in 2., add support for this new
clock in include/asm-arm/arch-omap/clocks.h and arch/arm/mach-omap/clocks.c.
clock in include/asm-arm/arch-omap/clocks.h and arch/arm/mach-omap[1/2]/clocks.c.
8. Only for new boards: Add "obj-$(CONFIG_MACH_OMAP_yyyy) += board-yyyy.o" with
yyyy board name to arch/arm/mach-omap/Makefile. This is used to compile your new
yyyy board name to arch/arm/mach-omap[1/2]/Makefile. This is used to compile your new
board specific initialization code from 7a.
9. Check if other of the existing files have to be adjusted for the new
......@@ -292,7 +271,7 @@ processor or board. Things to check:
- Pin multiplexing
- GPIO configuration
- Powermanagement
- Power Management
- Clocking
- Interrupt controller and interrupt configuration
- Additional board specific things (e.g. FPGAs)
......@@ -431,6 +410,6 @@ add a linux-c-mode to emacs.
------------------------------------------------------------------
Last modified 13. June 2004
Last modified 15. March 2006
The OMAP Linux Kernel Team
Dirk Behme <dirk.behme@de.bosch.com>
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment