README.omap3 2.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170
  1. Summary
  2. =======
  3. This README is about U-Boot support for TI's ARM Cortex-A8 based OMAP3 [1]
  4. family of SoCs. TI's OMAP3 SoC family contains an ARM Cortex-A8. Additionally,
  5. some family members contain a TMS320C64x+ DSP and/or an Imagination SGX 2D/3D
  6. graphics processor and various other standard peripherals.
  7. Currently the following boards are supported:
  8. * OMAP3530 BeagleBoard [2]
  9. * Gumstix Overo [3]
  10. * TI EVM [4]
  11. * OpenPandora Ltd. Pandora [5]
  12. * TI/Logic PD Zoom MDK [6]
  13. * TI/Logic PD Zoom 2 [7]
  14. * CompuLab Ltd. CM-T35 [8]
  15. Toolchain
  16. =========
  17. While ARM Cortex-A8 support ARM v7 instruction set (-march=armv7a) we compile
  18. with -march=armv5 to allow more compilers to work. For U-Boot code this has
  19. no performance impact.
  20. Build
  21. =====
  22. * BeagleBoard:
  23. make omap3_beagle_config
  24. make
  25. * Gumstix Overo:
  26. make omap3_overo_config
  27. make
  28. * TI EVM:
  29. make omap3_evm_config
  30. make
  31. * Pandora:
  32. make omap3_pandora_config
  33. make
  34. * Zoom MDK:
  35. make omap3_zoom1_config
  36. make
  37. * Zoom 2:
  38. make omap3_zoom2_config
  39. make
  40. * CM-T35:
  41. make cm_t35_config
  42. make
  43. Custom commands
  44. ===============
  45. To make U-Boot for OMAP3 support NAND device SW or HW ECC calculation, U-Boot
  46. for OMAP3 supports custom user command
  47. nandecc hw/sw
  48. To be compatible with NAND drivers using SW ECC (e.g. kernel code)
  49. nandecc sw
  50. enables SW ECC calculation. HW ECC enabled with
  51. nandecc hw
  52. is typically used to write 2nd stage bootloader (known as 'x-loader') which is
  53. executed by OMAP3's boot rom and therefore has to be written with HW ECC.
  54. For all other commands see
  55. help
  56. Interfaces
  57. ==========
  58. gpio
  59. To set a bit :
  60. if (!omap_request_gpio(N)) {
  61. omap_set_gpio_direction(N, 0);
  62. omap_set_gpio_dataout(N, 1);
  63. }
  64. To clear a bit :
  65. if (!omap_request_gpio(N)) {
  66. omap_set_gpio_direction(N, 0);
  67. omap_set_gpio_dataout(N, 0);
  68. }
  69. To read a bit :
  70. if (!omap_request_gpio(N)) {
  71. omap_set_gpio_direction(N, 1);
  72. val = omap_get_gpio_datain(N);
  73. omap_free_gpio(N);
  74. }
  75. if (val)
  76. printf("GPIO N is set\n");
  77. else
  78. printf("GPIO N is clear\n");
  79. Acknowledgements
  80. ================
  81. OMAP3 U-Boot is based on U-Boot tar ball [9] for BeagleBoard and EVM done by
  82. several TI employees.
  83. Links
  84. =====
  85. [1] OMAP3:
  86. http://www.ti.com/omap3 (high volume) and
  87. http://www.ti.com/omap35x (broad market)
  88. [2] OMAP3530 BeagleBoard:
  89. http://beagleboard.org/
  90. [3] Gumstix Overo:
  91. http://www.gumstix.net/Overo/
  92. [4] TI EVM:
  93. http://focus.ti.com/docs/toolsw/folders/print/tmdxevm3503.html
  94. [5] OpenPandora Ltd. Pandora:
  95. http://openpandora.org/
  96. [6] TI/Logic PD Zoom MDK:
  97. http://www.logicpd.com/products/devkit/ti/zoom_mobile_development_kit
  98. [7] TI/Logic PD Zoom 2
  99. http://www.logicpd.com/sites/default/files/1012659A_Zoom_OMAP34x-II_MDP_Brief.pdf
  100. [8] CompuLab Ltd. CM-T35:
  101. http://www.compulab.co.il/t3530/html/t3530-cm-datasheet.htm
  102. [9] TI OMAP3 U-Boot:
  103. http://beagleboard.googlecode.com/files/u-boot_beagle_revb.tar.gz