LXR uboot/doc/README.davinci

   1Summary
   2=======
   3
   4Note: this document used to be about the entire family of DaVinci SOCs but the
   5support for the DM* family and DA830 has since been dropped.
   6
   7This README is about U-Boot support for TI's DA850 SoC. This SOC has an OMAP
   8part number but is very similar to the DaVinci series.
   9
  10Currently the following boards are supported:
  11
  12* TI DA850 EVM
  13
  14* TI OMAP-L138 LCDK
  15
  16* Lego EV3
  17
  18Build
  19=====
  20
  21* TI DA850 EVM:
  22
  23make da850evm_config
  24make
  25
  26* TI OMAP-L138 LCDK
  27
  28make omapl138_lcdk_defconfig
  29make
  30
  31* Lego EV3
  32
  33make legoev3_defconfig
  34make
  35
  36Bootloaders
  37===============
  38
  39For DA850 an SPL (secondary program loader, see doc/README.SPL) is provided
  40to load U-Boot from SPI flash, MMC or NAND. The SPL takes care of the low level
  41initialization.
  42
  43The SPL is built as u-boot.ais for all DA850 defconfigs except those booting
  44from NOR flash. The resulting image file can be programmed to the SPI flash
  45of the DA850 EVM/LCDK.
  46
  47Devices that support booting from NOR utilize execute in place (XIP) and do
  48not require SPL to perform low level initialization.
  49
  50Environment Variables
  51=====================
  52
  53The DA850 EVM allows the user to specify the maximum cpu clock allowed by the
  54silicon, in Hz, via an environment variable "maxcpuclk".
  55
  56The maximum clock rate allowed depends on the silicon populated on the EVM.
  57Please make sure you understand the restrictions placed on this clock in the
  58device specific datasheet before setting up this variable. This information is
  59passed to the Linux kernel using the ATAG_REVISION atag.
  60
  61If "maxcpuclk" is not defined, the configuration CONFIG_DA850_EVM_MAX_CPU_CLK
  62is used to obtain this information.
  63
  64Links
  65=====
  66
  671) TI DA850 EVM
  68http://focus.ti.com/docs/prod/folders/print/omap-l138.html
  69http://www.logicpd.com/products/development-kits/zoom-omap-l138-evm-development-kit
  70
  712) TI OMAP-L138 LCDK
  72http://focus.ti.com/docs/prod/folders/print/omap-l138.html
  73http://www.ti.com/tool/TMDXLCDK138
  74
  75Davinci special defines
  76=======================
  77
  78CONFIG_SYS_DV_NOR_BOOT_CFG:     AM18xx based boards, booting in NOR Boot mode
  79                                need a "NOR Boot Configuration Word" stored
  80                                in the NOR Flash. This define adds this.
  81                                More Info about this, see:
  82                                spraba5a.pdf chapter 3.1
  83