doc/README.davinci

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