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 Custom commands
  72 ===============
  73
  74 To make U-Boot for OMAP3 support NAND device SW or HW ECC calculation, U-Boot
  75 for OMAP3 supports custom user command
  76
  77 nandecc hw/sw
  78
  79 To be compatible with NAND drivers using SW ECC (e.g. kernel code)
  80
  81 nandecc sw
  82
  83 enables SW ECC calculation. HW ECC enabled with
  84
  85 nandecc hw
  86
  87 is typically used to write 2nd stage bootloader (known as 'x-loader') which is
  88 executed by OMAP3's boot rom and therefore has to be written with HW ECC.
  89
  90 For all other commands see
  91
  92 help
  93
  94 Interfaces
  95 ==========
  96
  97 gpio
  98
  99 To set a bit :
 100
 101         if (!omap_request_gpio(N)) {
 102                 omap_set_gpio_direction(N, 0);
 103                 omap_set_gpio_dataout(N, 1);
 104         }
 105
 106 To clear a bit :
 107
 108         if (!omap_request_gpio(N)) {
 109                 omap_set_gpio_direction(N, 0);
 110                 omap_set_gpio_dataout(N, 0);
 111         }
 112
 113 To read a bit :
 114
 115         if (!omap_request_gpio(N)) {
 116                 omap_set_gpio_direction(N, 1);
 117                 val = omap_get_gpio_datain(N);
 118                 omap_free_gpio(N);
 119         }
 120         if (val)
 121                 printf("GPIO N is set\n");
 122         else
 123                 printf("GPIO N is clear\n");
 124
 125
 126 Acknowledgements
 127 ================
 128
 129 OMAP3 U-Boot is based on U-Boot tar ball [9] for BeagleBoard and EVM done by
 130 several TI employees.
 131
 132 Links
 133 =====
 134
 135 [1] OMAP3:
 136
 137 http://www.ti.com/omap3 (high volume) and
 138 http://www.ti.com/omap35x (broad market)
 139
 140 [2] OMAP3530 BeagleBoard:
 141
 142 http://beagleboard.org/
 143
 144 [3] Gumstix Overo:
 145
 146 http://www.gumstix.net/Overo/
 147
 148 [4] TI EVM:
 149
 150 http://focus.ti.com/docs/toolsw/folders/print/tmdxevm3503.html
 151
 152 [5] OpenPandora Ltd. Pandora:
 153
 154 http://openpandora.org/
 155
 156 [6] TI/Logic PD Zoom MDK:
 157
 158 http://www.logicpd.com/products/devkit/ti/zoom_mobile_development_kit
 159
 160 [7] TI/Logic PD Zoom 2
 161
 162 http://www.logicpd.com/sites/default/files/1012659A_Zoom_OMAP34x-II_MDP_Brief.pdf
 163
 164 [8] CompuLab Ltd. CM-T35:
 165
 166 http://www.compulab.co.il/t3530/html/t3530-cm-datasheet.htm
 167
 168 [9] TI OMAP3 U-Boot:
 169
 170 http://beagleboard.googlecode.com/files/u-boot_beagle_revb.tar.gz