README.omap3 2.1 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152
  1. Overview of SPL on OMAP3 devices
  2. ================================
  3. Introduction
  4. ------------
  5. This document provides an overview of how SPL functions on OMAP3 (and related
  6. such as am35x and am37x) processors.
  7. Methodology
  8. -----------
  9. On these platforms the ROM supports trying a sequence of boot devices. Once
  10. one has been used successfully to load SPL this information is stored in memory
  11. and the location stored in a register. We will read this to determine where to
  12. read U-Boot from in turn.
  13. Memory Map
  14. ----------
  15. This is an example of a typical setup. See top-level README for documentation
  16. of which CONFIG variables control these values. For a given board and the
  17. amount of DRAM available to it different values may need to be used.
  18. Note that the size of the SPL text rodata and data is enforced with a CONFIG
  19. option and growing over that size results in a link error. The SPL stack
  20. starts at the top of SRAM (which is configurable) and grows downward. The
  21. space between the top of SRAM and the enforced upper bound on the size of the
  22. SPL text, data and rodata is considered the safe stack area. Details on
  23. confirming this behavior are shown below.
  24. A portion of the system memory map looks as follows:
  25. SRAM: 0x40200000 - 0x4020FFFF
  26. DDR1: 0x80000000 - 0xBFFFFFFF
  27. Option 1 (SPL only):
  28. 0x40200800 - 0x4020BBFF: Area for SPL text, data and rodata
  29. 0x4020E000 - 0x4020FFFC: Area for the SPL stack.
  30. 0x80000000 - 0x8007FFFF: Area for the SPL BSS.
  31. 0x80100000: CONFIG_SYS_TEXT_BASE of U-Boot
  32. 0x80208000 - 0x80307FFF: malloc() pool available to SPL.
  33. Option 2 (SPL or X-Loader):
  34. 0x40200800 - 0x4020BBFF: Area for SPL text, data and rodata
  35. 0x4020E000 - 0x4020FFFC: Area for the SPL stack.
  36. 0x80008000: CONFIG_SYS_TEXT_BASE of U-Boot
  37. 0x87000000 - 0x8707FFFF: Area for the SPL BSS.
  38. 0x87080000 - 0x870FFFFF: malloc() pool available to SPL.
  39. For the areas that reside within DDR1 they must not be used prior to s_init()
  40. completing. Note that CONFIG_SYS_TEXT_BASE must be clear of the areas that SPL
  41. uses while running. This is why we have two versions of the memory map that
  42. only vary in where the BSS and malloc pool reside.