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. ...@@ -44,7 +44,7 @@ time.
The first step is to get a bootloader for your board, u-boot is the The first step is to get a bootloader for your board, u-boot is the
recommended one: 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 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 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. ...@@ -52,40 +52,16 @@ serial port, or by using a JTAG.
Once you have the bootloader running, you can compile the kernel. Once you have the bootloader running, you can compile the kernel.
You can get the OMAP sources either from the BitKeeper tree, or by You can get the OMAP sources either from the OMAP GIT tree, or by
applying patches. The BitKeeper tree has the most up to date sources applying patches. The OMAP GIT tree has the most up to date sources
and is the recommended one. 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.muru.com/linux/omap/README_OMAP_GIT
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
Hint: If you are sitting behind a firewall and have to use a proxy for 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 envirionment variable:
http_proxy=http://proxy_username:proxy_password@proxy_name:proxy_port/ 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 ...@@ -104,7 +80,7 @@ abc.host.com: The name of your proxy you use for internet access
- Using Patches: - 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: Download the latest OMAP Linux patch from:
...@@ -125,8 +101,8 @@ $ cat ../Linux-2.6.4-omap1 | patch -p1 ...@@ -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, 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/ 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 Now, if you have a local kernel tree, either by GIT or by patch, you
should look into arch/arm/config/ to see which of the various omap_xxx 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 configurations there you want to use. For example, if you have a OMAP1510
based Innovator board, you select omap_innovator_1510_defconfig by 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: ...@@ -206,10 +182,13 @@ time of writing this document in March 2004 four boards are supported:
Innovator1510 (OMAP1510 processor), Innovator1610 (OMAP1610 processor), Innovator1510 (OMAP1510 processor), Innovator1610 (OMAP1610 processor),
Perseus2 (OMAP730 processor) and H2 (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? /* Discussion needed: How to handle the tons of compatible processors?
E.g. what to do if OMAP16xx is mainly identical with OMAP16yy? */ 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. option.
To add a new processor add a new config option to the "OMAP Core Type" choice. 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. ...@@ -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 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 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. OMAP_yyyy where yyyy is the board name like above.
Note: The elements of RMKs machine registration are used in 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. ...@@ -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/ 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 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 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 macros to these specific files have to be named OMAPxxxx_ with xxxx processor
number to make them unique. number to make them unique.
7a. Only for new boards: Add a file board-yyyy.c with yyyy board name to 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 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 MACH_TYPE_ section of machine registration (see arch/arm/tools/mach-types after
machine registration at RMKs registration system). 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 ...@@ -278,13 +257,13 @@ Put only code into this file that is board specific and not common. See other
board files for examples. board files for examples.
7b. Only for new processors: Add processor specific IO description and 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 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 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. board specific initialization code from 7a.
9. Check if other of the existing files have to be adjusted for the new 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: ...@@ -292,7 +271,7 @@ processor or board. Things to check:
- Pin multiplexing - Pin multiplexing
- GPIO configuration - GPIO configuration
- Powermanagement - Power Management
- Clocking - Clocking
- Interrupt controller and interrupt configuration - Interrupt controller and interrupt configuration
- Additional board specific things (e.g. FPGAs) - Additional board specific things (e.g. FPGAs)
...@@ -431,6 +410,6 @@ add a linux-c-mode to emacs. ...@@ -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 The OMAP Linux Kernel Team
Dirk Behme <dirk.behme@de.bosch.com> 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