blob: 3a1ac8101d64c76ec866816201d07add92c98454 [file] [log] [blame]
Dirk Behmef904cdb2009-01-27 18:19:12 +01001
2Summary
3=======
4
5This README is about U-Boot support for TI's ARM Cortex-A8 based OMAP3 [1]
6family of SoCs. TI's OMAP3 SoC family contains an ARM Cortex-A8. Additionally,
7some family members contain a TMS320C64x+ DSP and/or an Imagination SGX 2D/3D
8graphics processor and various other standard peripherals.
9
10Currently the following boards are supported:
11
12* OMAP3530 BeagleBoard [2]
13
Dirk Behme9d0fc812009-01-28 21:39:57 +010014* Gumstix Overo [3]
15
Dirk Behmead9bc8e2009-01-28 21:39:58 +010016* TI EVM [4]
17
Dirk Behme2be2c6c2009-01-28 21:39:58 +010018* OpenPandora Ltd. Pandora [5]
19
Dirk Behme7379f452009-01-28 21:40:16 +010020* TI/Logic PD Zoom MDK [6]
21
Tom Rix376aee72009-05-15 23:48:36 +020022* TI/Logic PD Zoom 2 [7]
23
Mike Rapoport36b4e2d2010-12-18 17:43:19 -050024* CompuLab Ltd. CM-T35 [8]
25
Dirk Behmef904cdb2009-01-27 18:19:12 +010026Build
27=====
28
29* BeagleBoard:
30
31make omap3_beagle_config
32make
33
Dirk Behme9d0fc812009-01-28 21:39:57 +010034* Gumstix Overo:
35
36make omap3_overo_config
37make
38
Dirk Behmead9bc8e2009-01-28 21:39:58 +010039* TI EVM:
40
41make omap3_evm_config
42make
43
Tom Rix376aee72009-05-15 23:48:36 +020044* Zoom 2:
45
46make omap3_zoom2_config
47make
48
Mike Rapoport36b4e2d2010-12-18 17:43:19 -050049* CM-T35:
50
51make cm_t35_config
52make
53
Michael Jones84d7a012011-11-04 13:53:44 -040054
Dirk Behmef904cdb2009-01-27 18:19:12 +010055Custom commands
56===============
57
58To make U-Boot for OMAP3 support NAND device SW or HW ECC calculation, U-Boot
59for OMAP3 supports custom user command
60
61nandecc hw/sw
62
63To be compatible with NAND drivers using SW ECC (e.g. kernel code)
64
65nandecc sw
66
67enables SW ECC calculation. HW ECC enabled with
68
69nandecc hw
70
71is typically used to write 2nd stage bootloader (known as 'x-loader') which is
72executed by OMAP3's boot rom and therefore has to be written with HW ECC.
73
74For all other commands see
75
76help
77
Tom Rix0c872ec2009-05-15 23:48:36 +020078Interfaces
79==========
80
81gpio
Simon Schwarz4c4bb192011-09-28 05:00:26 +000082----
Tom Rix0c872ec2009-05-15 23:48:36 +020083
84To set a bit :
85
Sanjeev Premi3b690eb2011-09-08 10:48:39 -040086 if (!gpio_request(N, "")) {
87 gpio_direction_output(N, 0);
88 gpio_set_value(N, 1);
Tom Rix0c872ec2009-05-15 23:48:36 +020089 }
90
91To clear a bit :
92
Sanjeev Premi3b690eb2011-09-08 10:48:39 -040093 if (!gpio_request(N, "")) {
94 gpio_direction_output(N, 0);
95 gpio_set_value(N, 0);
Tom Rix0c872ec2009-05-15 23:48:36 +020096 }
97
98To read a bit :
99
Sanjeev Premi3b690eb2011-09-08 10:48:39 -0400100 if (!gpio_request(N, "")) {
101 gpio_direction_input(N);
102 val = gpio_get_value(N);
103 gpio_free(N);
Tom Rix0c872ec2009-05-15 23:48:36 +0200104 }
105 if (val)
106 printf("GPIO N is set\n");
107 else
108 printf("GPIO N is clear\n");
109
Simon Schwarz4c4bb192011-09-28 05:00:26 +0000110dma
111---
112void omap3_dma_init(void)
113 Init the DMA module
114int omap3_dma_get_conf_chan(uint32_t chan, struct dma4_chan *config);
115 Read config of the channel
116int omap3_dma_conf_chan(uint32_t chan, struct dma4_chan *config);
117 Write config to the channel
118int omap3_dma_conf_transfer(uint32_t chan, uint32_t *src, uint32_t *dst,
119 uint32_t sze)
120 Config source, destination and size of a transfer
121int omap3_dma_wait_for_transfer(uint32_t chan)
122 Wait for a transfer to end - this hast to be called before a channel
123 or the data the channel transferd are used.
124int omap3_dma_get_revision(uint32_t *minor, uint32_t *major)
125 Read silicon Revision of the DMA module
126
Andreas Bießmann4a093002013-04-05 04:55:21 +0000127NAND
128====
129
130There are some OMAP3 devices out there with NAND attached. Due to the fact that
131OMAP3 ROM code can only handle 1-bit hamming ECC for accessing first page
132(place where SPL lives) we require this setup for u-boot at least when reading
133the second progam within SPL. A lot of newer NAND chips however require more
134than 1-bit ECC for the pages, some can live with 1-bit for the first page. To
135handle this we can switch to another ECC algorithm after reading the payload
136within SPL.
137
138BCH8
139----
140
141To enable hardware assisted BCH8 (8-bit BCH [Bose, Chaudhuri, Hocquenghem]) on
142OMAP3 devices we can use the BCH library in lib/bch.c. To do so add CONFIG_BCH
pekon gupta3f719062013-11-18 19:03:01 +0530143and set CONFIG_NAND_OMAP_ECCSCHEME=5 (refer README.nand) for selecting BCH8_SW.
Andreas Bießmann4a093002013-04-05 04:55:21 +0000144The NAND OOB layout is the same as in linux kernel, if the linux kernel BCH8
145implementation for OMAP3 works for you so the u-boot version should also.
146When you require the SPL to read with BCH8 there are two more configs to
147change:
148
Tom Rini4e590942022-11-12 17:36:51 -0500149 * CFG_SYS_NAND_ECCPOS (must be the same as .eccpos in
Andreas Bießmann4a093002013-04-05 04:55:21 +0000150 GPMC_NAND_HW_BCH8_ECC_LAYOUT defined in
151 arch/arm/include/asm/arch-omap3/omap_gpmc.h)
Tom Rini4e590942022-11-12 17:36:51 -0500152 * CFG_SYS_NAND_ECCSIZE must be 512
153 * CFG_SYS_NAND_ECCBYTES must be 13 for this BCH8 setup
Tom Rix0c872ec2009-05-15 23:48:36 +0200154
Dirk Behmef904cdb2009-01-27 18:19:12 +0100155Acknowledgements
156================
157
Mike Rapoport36b4e2d2010-12-18 17:43:19 -0500158OMAP3 U-Boot is based on U-Boot tar ball [9] for BeagleBoard and EVM done by
Dirk Behmef904cdb2009-01-27 18:19:12 +0100159several TI employees.
160
161Links
162=====
163
164[1] OMAP3:
165
166http://www.ti.com/omap3 (high volume) and
167http://www.ti.com/omap35x (broad market)
168
169[2] OMAP3530 BeagleBoard:
170
171http://beagleboard.org/
172
Dirk Behme9d0fc812009-01-28 21:39:57 +0100173[3] Gumstix Overo:
174
175http://www.gumstix.net/Overo/
176
Dirk Behmead9bc8e2009-01-28 21:39:58 +0100177[4] TI EVM:
178
179http://focus.ti.com/docs/toolsw/folders/print/tmdxevm3503.html
180
Dirk Behme2be2c6c2009-01-28 21:39:58 +0100181[5] OpenPandora Ltd. Pandora:
182
183http://openpandora.org/
184
Dirk Behme7379f452009-01-28 21:40:16 +0100185[6] TI/Logic PD Zoom MDK:
186
187http://www.logicpd.com/products/devkit/ti/zoom_mobile_development_kit
188
Tom Rix376aee72009-05-15 23:48:36 +0200189[7] TI/Logic PD Zoom 2
190
191http://www.logicpd.com/sites/default/files/1012659A_Zoom_OMAP34x-II_MDP_Brief.pdf
Mike Rapoport36b4e2d2010-12-18 17:43:19 -0500192
193[8] CompuLab Ltd. CM-T35:
194
195http://www.compulab.co.il/t3530/html/t3530-cm-datasheet.htm
196
197[9] TI OMAP3 U-Boot:
Dirk Behmef904cdb2009-01-27 18:19:12 +0100198
199http://beagleboard.googlecode.com/files/u-boot_beagle_revb.tar.gz