board/ti/ks2_evm/README_K2HK

   1 U-Boot port for Texas Instruments XTCIEVMK2X
   2 ============================================
   3
   4 Author: Murali Karicheri <m-karicheri2@ti.com>
   5
   6 This README has information on the u-boot port for XTCIEVMK2X EVM board.
   7 Documentation for this board can be found at
   8   http://www.advantech.com/Support/TI-EVM/EVMK2HX_sd.aspx
   9
  10 The board is based on Texas Instruments Keystone2 family of SoCs : K2H, K2K.
  11 More details on these SoCs are available at company websites
  12  K2K: http://www.ti.com/product/tci6638k2k
  13  K2H: http://www.ti.com/product/tci6638k2h
  14
  15 Board configuration:
  16 ====================
  17
  18 Some of the peripherals that are configured by u-boot are:-
  19
  20 1. 2GB DDR3 (can support 8GB SO DIMM as well)
  21 2. 512M NAND (over ti emif16 bus)
  22 3. 6MB MSM SRAM (part of the SoC)
  23 4. two 1GBit Ethernet ports (SoC supports upto 4)
  24 5. two UART ports
  25 6. three i2c interfaces
  26 7. three spi interfaces (only 1 interface supported in driver)
  27
  28 There are seperate PLLs to drive clocks to Tetris ARM and Peripherals.
  29 To bring up SMP Linux on this board, there is a boot monitor
  30 code that will be installed in MSMC SRAM. There is command available
  31 to install this image from u-boot.
  32
  33 The port related files can be found at following folders
  34  keystone2 SoC related files: arch/arm/cpu/armv7/keystone/
  35  K2HK evm board files: board/ti/k2hk_evm/
  36
  37 board configuration file: include/configs/k2hk_evm.h
  38
  39 Supported boot modes:
  40  - SPI NOR boot
  41  - AEMIF NAND boot
  42
  43 Supported image formats:-
  44  - u-boot.bin: for loading and running u-boot.bin through Texas instruments
  45                code composure studio (CCS)
  46  - u-boot-spi.gph: gpimage for programming SPI NOR flash for SPI NOR boot
  47  - u-boot-nand.gph: gpimage for programming AEMIF NAND flash for NAND boot
  48
  49 Build instructions:
  50 ===================
  51
  52 To build u-boot.bin
  53   >make k2hk_evm_config
  54   >make u-boot-spi.gph
  55
  56 To build u-boot-spi.gph
  57   >make k2hk_evm_config
  58   >make u-boot-spi.gph
  59
  60 To build u-boot-nand.gph
  61   >make k2hk_evm_config
  62   >make u-boot-nand.gph
  63
  64 Load and Run U-Boot on K2HK EVM using CCS
  65 =========================================
  66
  67 Need Code Composer Studio (CCS) installed on a PC to load and run u-boot.bin
  68 on EVM. See instructions at below link for installing CCS on a Windows PC.
  69 http://processors.wiki.ti.com/index.php/MCSDK_UG_Chapter_Getting_Started#
  70 Installing_Code_Composer_Studio
  71 Use u-boot.bin from the build folder for loading annd running u-boot binary
  72 on EVM. Follow instructions at
  73 http://processors.wiki.ti.com/index.php/EVMK2H_Hardware_Setup
  74 to configure SW1 dip switch to use "No Boot/JTAG DSP Little Endian Boot Mode"
  75 and Power ON the EVM.  Follow instructions to connect serial port of EVM to
  76 PC and start TeraTerm or Hyper Terminal.
  77
  78 Start CCS on a Windows machine and Launch Target
  79 configuration as instructed at http://processors.wiki.ti.com/index.php/
  80 MCSDK_UG_Chapter_Exploring#Loading_and_Running_U-Boot_on_EVM_through_CCS.
  81 The instructions provided in the above link uses a script for
  82 loading the u-boot binary on the target EVM. Instead do the following:-
  83
  84 1. Right click to "Texas Instruments XDS2xx USB Emulator_0/CortexA15_1 core (D
  85    isconnected: Unknown)" at the debug window (This is created once Target
  86    configuration is launched) and select "Connect Target".
  87 2. Once target connect is successful, choose Tools->Load Memory option from the
  88    top level menu. At the Load Memory window, choose the file u-boot.bin
  89    through "Browse" button and click "next >" button. In the next window, enter
  90    Start address as 0xc001000, choose Type-size "32 bits" and click "Finish"
  91    button.
  92 3. Click View -> Registers from the top level menu to view registers window.
  93 4. From Registers, window expand "Core Registers" to view PC. Edit PC value
  94    to be 0xc001000. From the "Run" top level menu, select "Free Run"
  95 5. The U-Boot prompt is shown at the Tera Term/ Hyper terminal console as
  96    below and type any key to stop autoboot as instructed :=
  97
  98 U-Boot 2014.04-rc1-00201-gc215b5a (Mar 21 2014 - 12:47:59)
  99
 100 I2C:   ready
 101 Detected SO-DIMM [SQR-SD3T-2G1333SED]
 102 DRAM:  1.1 GiB
 103 NAND:  512 MiB
 104 Net:   K2HK_EMAC
 105 Warning: K2HK_EMAC using MAC address from net device
 106 , K2HK_EMAC1, K2HK_EMAC2, K2HK_EMAC3
 107 Hit any key to stop autoboot:  0
 108
 109 SPI NOR Flash programming instructions
 110 ======================================
 111 U-Boot image can be flashed to first 512KB of the NOR flash using following
 112 instructions:-
 113
 114 1. Start CCS and run U-boot as described above.
 115 2. Suspend Target. Select Run -> Suspend from top level menu
 116    CortexA15_1 (Free Running)"
 117 3. Load u-boot-spi.gph binary from build folder on to DDR address 0x87000000
 118    through CCS as described in step 2 of "Load and Run U-Boot on K2HK EVM
 119    using CCS", but using address 0x87000000.
 120 4. Free Run the target as desribed earlier (step 4) to get u-boot prompt
 121 5. At the U-Boot console type following to setup u-boot environment variables.
 122    setenv addr_uboot 0x87000000
 123    setenv filesize <size in hex of u-boot-spi.gph rounded to hex 0x10000>
 124    run burn_uboot_spi
 125    Once u-boot prompt is available, Power OFF the EVM. Set the SW1 dip switch
 126    to "SPI Little Endian Boot mode" as per instruction at
 127    http://processors.wiki.ti.com/index.php/EVMK2H_Hardware_Setup.
 128 6. Power ON the EVM. The EVM now boots with u-boot image on the NOR flash.
 129
 130 AEMIF NAND Flash programming instructions
 131 ======================================
 132 U-Boot image can be flashed to first 1024KB of the NAND flash using following
 133 instructions:-
 134
 135 1. Start CCS and run U-boot as described above.
 136 2. Suspend Target. Select Run -> Suspend from top level menu
 137    CortexA15_1 (Free Running)"
 138 3. Load u-boot-nand.gph binary from build folder on to DDR address 0x87000000
 139    through CCS as described in step 2 of "Load and Run U-Boot on K2HK EVM
 140    using CCS", but using address 0x87000000.
 141 4. Free Run the target as desribed earlier (step 4) to get u-boot prompt
 142 5. At the U-Boot console type following to setup u-boot environment variables.
 143    setenv filesize <size in hex of u-boot-nand.gph rounded to hex 0x10000>
 144    run burn_uboot_nand
 145    Once u-boot prompt is available, Power OFF the EVM. Set the SW1 dip switch
 146    to "ARM NAND Boot mode" as per instruction at
 147    http://processors.wiki.ti.com/index.php/EVMK2H_Hardware_Setup.
 148 6. Power ON the EVM. The EVM now boots with u-boot image on the NAND flash.