]> git.sur5r.net Git - u-boot/blob - doc/README.omap3
Merge branch 'master' of git://git.denx.de/u-boot-arm
[u-boot] / doc / README.omap3
1
2 Summary
3 =======
4
5 This README is about U-Boot support for TI's ARM Cortex-A8 based OMAP3 [1]
6 family of SoCs. TI's OMAP3 SoC family contains an ARM Cortex-A8. Additionally,
7 some family members contain a TMS320C64x+ DSP and/or an Imagination SGX 2D/3D
8 graphics processor and various other standard peripherals.
9
10 Currently the following boards are supported:
11
12 * OMAP3530 BeagleBoard [2]
13
14 * Gumstix Overo [3]
15
16 * TI EVM [4]
17
18 * OpenPandora Ltd. Pandora [5]
19
20 * TI/Logic PD Zoom MDK [6]
21
22 * TI/Logic PD Zoom 2 [7]
23
24 * CompuLab Ltd. CM-T35 [8]
25
26 Toolchain
27 =========
28
29 While ARM Cortex-A8 support ARM v7 instruction set (-march=armv7a) we compile
30 with -march=armv5 to allow more compilers to work. For U-Boot code this has
31 no performance impact.
32
33 Build
34 =====
35
36 * BeagleBoard:
37
38 make omap3_beagle_config
39 make
40
41 * Gumstix Overo:
42
43 make omap3_overo_config
44 make
45
46 * TI EVM:
47
48 make omap3_evm_config
49 make
50
51 * Pandora:
52
53 make omap3_pandora_config
54 make
55
56 * Zoom MDK:
57
58 make omap3_zoom1_config
59 make
60
61 * Zoom 2:
62
63 make omap3_zoom2_config
64 make
65
66 * CM-T35:
67
68 make cm_t35_config
69 make
70
71 * BlueLYNX-X:
72
73 make omap3_mvblx_config
74 make
75
76 Custom commands
77 ===============
78
79 To make U-Boot for OMAP3 support NAND device SW or HW ECC calculation, U-Boot
80 for OMAP3 supports custom user command
81
82 nandecc hw/sw
83
84 To be compatible with NAND drivers using SW ECC (e.g. kernel code)
85
86 nandecc sw
87
88 enables SW ECC calculation. HW ECC enabled with
89
90 nandecc hw
91
92 is typically used to write 2nd stage bootloader (known as 'x-loader') which is
93 executed by OMAP3's boot rom and therefore has to be written with HW ECC.
94
95 For all other commands see
96
97 help
98
99 Interfaces
100 ==========
101
102 gpio
103 ----
104
105 To set a bit :
106
107         if (!gpio_request(N, "")) {
108                 gpio_direction_output(N, 0);
109                 gpio_set_value(N, 1);
110         }
111
112 To clear a bit :
113
114         if (!gpio_request(N, "")) {
115                 gpio_direction_output(N, 0);
116                 gpio_set_value(N, 0);
117         }
118
119 To read a bit :
120
121         if (!gpio_request(N, "")) {
122                 gpio_direction_input(N);
123                 val = gpio_get_value(N);
124                 gpio_free(N);
125         }
126         if (val)
127                 printf("GPIO N is set\n");
128         else
129                 printf("GPIO N is clear\n");
130
131 dma
132 ---
133 void omap3_dma_init(void)
134         Init the DMA module
135 int omap3_dma_get_conf_chan(uint32_t chan, struct dma4_chan *config);
136         Read config of the channel
137 int omap3_dma_conf_chan(uint32_t chan, struct dma4_chan *config);
138         Write config to the channel
139 int omap3_dma_conf_transfer(uint32_t chan, uint32_t *src, uint32_t *dst,
140                 uint32_t sze)
141         Config source, destination and size of a transfer
142 int omap3_dma_wait_for_transfer(uint32_t chan)
143         Wait for a transfer to end - this hast to be called before a channel
144         or the data the channel transferd are used.
145 int omap3_dma_get_revision(uint32_t *minor, uint32_t *major)
146         Read silicon Revision of the DMA module
147
148
149 Acknowledgements
150 ================
151
152 OMAP3 U-Boot is based on U-Boot tar ball [9] for BeagleBoard and EVM done by
153 several TI employees.
154
155 Links
156 =====
157
158 [1] OMAP3:
159
160 http://www.ti.com/omap3 (high volume) and
161 http://www.ti.com/omap35x (broad market)
162
163 [2] OMAP3530 BeagleBoard:
164
165 http://beagleboard.org/
166
167 [3] Gumstix Overo:
168
169 http://www.gumstix.net/Overo/
170
171 [4] TI EVM:
172
173 http://focus.ti.com/docs/toolsw/folders/print/tmdxevm3503.html
174
175 [5] OpenPandora Ltd. Pandora:
176
177 http://openpandora.org/
178
179 [6] TI/Logic PD Zoom MDK:
180
181 http://www.logicpd.com/products/devkit/ti/zoom_mobile_development_kit
182
183 [7] TI/Logic PD Zoom 2
184
185 http://www.logicpd.com/sites/default/files/1012659A_Zoom_OMAP34x-II_MDP_Brief.pdf
186
187 [8] CompuLab Ltd. CM-T35:
188
189 http://www.compulab.co.il/t3530/html/t3530-cm-datasheet.htm
190
191 [9] TI OMAP3 U-Boot:
192
193 http://beagleboard.googlecode.com/files/u-boot_beagle_revb.tar.gz