LXR uboot/doc/README.davinci

   1Summary
   2=======
   3
   4This README is about U-Boot support for TI's ARM 926EJS based family of SoCs.
   5These SOCs are used for cameras, video security and surveillance, DVR's, etc.
   6DaVinci SOC's comprise of DM644x, DM646x, DM35x and DM36x series of SOC's
   7Additionally there are some SOCs meant for the audio market which though have
   8an OMAP part number are very similar to the DaVinci series of SOC's
   9Additionally, some family members contain a TI DSP and/or graphics
  10co processors along with a host of other peripherals.
  11
  12Currently the following boards are supported:
  13
  14* TI DaVinci DM644x EVM
  15
  16* TI DaVinci DM646x EVM
  17
  18* TI DaVinci DM355 EVM
  19
  20* TI DaVinci DM365 EVM
  21
  22* TI DA830 EVM
  23
  24* TI DA850 EVM
  25
  26* DM355 based Leopard board
  27
  28* DM644x based schmoogie board
  29
  30* DM644x based sffsdr board
  31
  32* DM644x based sonata board
  33
  34Build
  35=====
  36
  37* TI DaVinci DM644x EVM:
  38
  39make davinci_dvevm_config
  40make
  41
  42* TI DaVinci DM646x EVM:
  43
  44make davinci_dm6467evm_config
  45make
  46
  47* TI DaVinci DM355 EVM:
  48
  49make davinci_dm355evm_config
  50make
  51
  52* TI DaVinci DM365 EVM:
  53
  54make davinci_dm365evm_config
  55make
  56
  57* TI DA830 EVM:
  58
  59make da830evm_config
  60make
  61
  62* TI DA850 EVM:
  63
  64make da850evm_config
  65make
  66
  67* DM355 based Leopard board:
  68
  69make davinci_dm355leopard_config
  70make
  71
  72* DM644x based schmoogie board:
  73
  74make davinci_schmoogie_config
  75make
  76
  77* DM644x based sffsdr board:
  78
  79make davinci_sffsdr_config
  80make
  81
  82* DM644x based sonata board:
  83
  84make davinci_sonata_config
  85make
  86
  87Bootloaders
  88===============
  89
  90The DaVinci SOC's use 2 bootloaders. The low level initialization
  91is done by a UBL(user boot loader). The UBL is written to a NAND/NOR/SPI flash
  92by a programmer. During initial bootup, the ROM Bootloader reads the UBL
  93from a storage device and loads it into the IRAM. The UBL then loads the U-Boot
  94into the RAM.
  95The programmers and UBL are always released as part of any standard TI
  96software release associated with an SOC.
  97
  98Alternative boot method (DA850 EVM only):
  99For the DA850 EVM an SPL (secondary program loader, see doc/README.SPL)
 100is provided to load U-Boot directly from SPI flash. In this case, the
 101SPL does the low level initialization that is otherwise done by the SPL.
 102To build U-Boot with this SPL, do
 103make da850evm_config
 104make u-boot.ais
 105and program the resulting u-boot.ais file to the SPI flash of the DA850 EVM.
 106
 107Environment Variables
 108=====================
 109
 110The DA850 EVM allows the user to specify the maximum cpu clock allowed by the
 111silicon, in Hz, via an environment variable "maxcpuclk".
 112
 113The maximum clock rate allowed depends on the silicon populated on the EVM.
 114Please make sure you understand the restrictions placed on this clock in the
 115device specific datasheet before setting up this variable. This information is
 116passed to the Linux kernel using the ATAG_REVISION atag.
 117
 118If "maxcpuclk" is not defined, the configuration CONFIG_DA850_EVM_MAX_CPU_CLK
 119is used to obtain this information.
 120
 121Links
 122=====
 123
 1241) TI DaVinci DM355 EVM:
 125http://focus.ti.com/docs/prod/folders/print/tms320dm355.html
 126http://www.spectrumdigital.com/product_info.php?cPath=103&products_id=203&osCsid=c499af6087317f11b3da19b4e8f1af32
 127
 1282) TI DaVinci DM365 EVM:
 129http://focus.ti.com/docs/prod/folders/print/tms320dm365.html?247SEM=
 130http://support.spectrumdigital.com/boards/evmdm365/revc/
 131
 1323) DaVinci DM355 based leopard board
 133http://designsomething.org/leopardboard/default.aspx
 134http://www.spectrumdigital.com/product_info.php?cPath=103&products_id=192&osCsid=67c20335668ffc57cb35727106eb24b1
 135
 1364) TI DaVinci DM6467 EVM:
 137http://focus.ti.com/docs/prod/folders/print/tms320dm6467.html
 138http://support.spectrumdigital.com/boards/evmdm6467/revf/
 139
 1405) TI DaVinci DM6446 EVM:
 141http://focus.ti.com/docs/prod/folders/print/tms320dm6446.html
 142http://www.spectrumdigital.com/product_info.php?cPath=103&products_id=222
 143
 1446) TI DA830 EVM
 145http://focus.ti.com/apps/docs/gencontent.tsp?appId=1&contentId=52385
 146http://www.spectrumdigital.com/product_info.php?cPath=37&products_id=214
 147
 1487) TI DA850 EVM
 149http://focus.ti.com/docs/prod/folders/print/omap-l138.html
 150http://www.logicpd.com/products/development-kits/zoom-omap-l138-evm-development-kit
 151
 152Davinci special defines
 153=======================
 154
 155CONFIG_SYS_DV_NOR_BOOT_CFG:     AM18xx based boards, booting in NOR Boot mode
 156                                need a "NOR Boot Configuration Word" stored
 157                                in the NOR Flash. This define adds this.
 158                                More Info about this, see:
 159                                spraba5a.pdf chapter 3.1
 160