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