U-Boot port for Texas Instruments Keystone II EVM boards 
 | 
======================================================== 
 | 
  
 | 
Author: Murali Karicheri <m-karicheri2@ti.com> 
 | 
  
 | 
This README has information on the U-Boot port for K2HK, K2E, and K2L EVM boards. 
 | 
Documentation for this board can be found at 
 | 
http://www.advantech.com/Support/TI-EVM/EVMK2HX_sd.aspx 
 | 
https://www.einfochips.com/index.php/partnerships/texas-instruments/k2e-evm.html 
 | 
https://www.einfochips.com/index.php/partnerships/texas-instruments/k2l-evm.html 
 | 
  
 | 
The K2HK board is based on Texas Instruments Keystone2 family of SoCs: K2H, K2K. 
 | 
More details on these SoCs are available at company websites 
 | 
 K2K: http://www.ti.com/product/tci6638k2k 
 | 
 K2H: http://www.ti.com/product/tci6638k2h 
 | 
  
 | 
The K2E SoC details are available at 
 | 
 http://www.ti.com/lit/ds/symlink/66ak2e05.pdf 
 | 
  
 | 
The K2L SoC details are available at 
 | 
 http://www.ti.com/lit/ds/symlink/tci6630k2l.pdf 
 | 
  
 | 
The K2G SoC details are available at 
 | 
 http://www.ti.com/lit/ds/symlink/66ak2g02.pdf 
 | 
  
 | 
Board configuration: 
 | 
==================== 
 | 
  
 | 
Some of the peripherals that are configured by U-Boot 
 | 
+------+-------+-------+-----------+-----------+-------+-------+----+ 
 | 
|      |DDR3   |NAND   |MSM SRAM   |ETH ports  |UART   |I2C    |SPI | 
 | 
+------+-------+-------+-----------+-----------+-------+-------+----+ 
 | 
|K2HK  |2      |512MB  |6MB       |4(2)       |2      |3      |3   | 
 | 
|K2E   |4      |512MB  |2MB       |8(2)       |2      |3      |3   | 
 | 
|K2L   |2      |512MB  |2MB       |4(2)       |4      |3      |3   | 
 | 
|K2G   |2      |256MB  |1MB       |1          |1      |1      |1   | 
 | 
+------+-------+-------+-----------+-----------+-------+-------+----+ 
 | 
  
 | 
There are only 2 eth port installed on the boards. 
 | 
  
 | 
There are separate PLLs to drive clocks to Tetris ARM and Peripherals. 
 | 
To bring up SMP Linux on this board, there is a boot monitor 
 | 
code that will be installed in MSMC SRAM. There is command available 
 | 
to install this image from U-Boot. 
 | 
  
 | 
The port related files can be found at following folders 
 | 
 keystone2 SoC related files: arch/arm/cpu/armv7/keystone/ 
 | 
 EVMs board files: board/ti/k2s_evm/ 
 | 
  
 | 
Board configuration files: 
 | 
include/configs/k2hk_evm.h 
 | 
include/configs/k2e_evm.h 
 | 
include/configs/k2l_evm.h 
 | 
include/configs/k2g_evm.h 
 | 
  
 | 
As U-Boot is migrating to Kconfig there is also board defconfig files 
 | 
configs/k2e_evm_defconfig 
 | 
configs/k2hk_evm_defconfig 
 | 
configs/k2l_evm_defconfig 
 | 
configs/k2g_evm_defconfig 
 | 
  
 | 
Supported boot modes: 
 | 
 - SPI NOR boot 
 | 
 - AEMIF NAND boot (K2E, K2L and K2HK) 
 | 
 - UART boot 
 | 
 - MMC boot (Only on K2G) 
 | 
  
 | 
Supported image formats: 
 | 
 - u-boot.bin: for loading and running u-boot.bin through 
 | 
        Texas Instruments code composure studio (CCS) and for UART boot. 
 | 
 - u-boot-spi.gph: gpimage for programming SPI NOR flash for SPI NOR boot 
 | 
 - MLO: gpimage for programming NAND flash for NAND boot, MMC boot. 
 | 
  
 | 
Build instructions: 
 | 
=================== 
 | 
Examples for k2hk, for k2e, k2l and k2g just replace k2hk prefix accordingly. 
 | 
Don't forget to add ARCH=arm and CROSS_COMPILE. 
 | 
  
 | 
To build u-boot.bin, u-boot-spi.gph, MLO: 
 | 
  >make k2hk_evm_defconfig 
 | 
  >make 
 | 
  
 | 
Load and Run U-Boot on keystone EVMs using CCS 
 | 
========================================= 
 | 
  
 | 
Need Code Composer Studio (CCS) installed on a PC to load and run u-boot.bin 
 | 
on EVM. See instructions at below link for installing CCS on a Windows PC. 
 | 
http://processors.wiki.ti.com/index.php/MCSDK_UG_Chapter_Getting_Started# 
 | 
Installing_Code_Composer_Studio 
 | 
Use u-boot.bin from the build folder for loading and running U-Boot binary 
 | 
on EVM. Follow instructions at 
 | 
K2HK http://processors.wiki.ti.com/index.php/EVMK2H_Hardware_Setup 
 | 
K2E  http://processors.wiki.ti.com/index.php/EVMK2E_Hardware_Setup 
 | 
K2L  http://processors.wiki.ti.com/index.php/TCIEVMK2L_Hardware_Setup 
 | 
K2G  http://processors.wiki.ti.com/index.php/66AK2G02_GP_EVM_Hardware_Setup 
 | 
  
 | 
to configure SW1 dip switch to use "No Boot/JTAG DSP Little Endian Boot Mode" 
 | 
and Power ON the EVM.  Follow instructions to connect serial port of EVM to 
 | 
PC and start TeraTerm or Hyper Terminal. 
 | 
  
 | 
Start CCS on a Windows machine and Launch Target 
 | 
configuration as instructed at http://processors.wiki.ti.com/index.php/ 
 | 
MCSDK_UG_Chapter_Exploring#Loading_and_Running_U-Boot_on_EVM_through_CCS. 
 | 
The instructions provided in the above link uses a script for 
 | 
loading the U-Boot binary on the target EVM. Instead do the following:- 
 | 
  
 | 
1. Right click to "Texas Instruments XDS2xx USB Emulator_0/CortexA15_1 core (D 
 | 
   is connected: Unknown)" at the debug window (This is created once Target 
 | 
   configuration is launched) and select "Connect Target". 
 | 
2. Once target connect is successful, choose Tools->Load Memory option from the 
 | 
   top level menu. At the Load Memory window, choose the file u-boot.bin 
 | 
   through "Browse" button and click "next >" button. In the next window, enter 
 | 
   Start address as 0xc000000, choose Type-size "32 bits" and click "Finish" 
 | 
   button. 
 | 
3. Click View -> Registers from the top level menu to view registers window. 
 | 
4. From Registers, window expand "Core Registers" to view PC. Edit PC value 
 | 
   to be 0xc000000. From the "Run" top level menu, select "Free Run" 
 | 
5. The U-Boot prompt is shown at the Tera Term/ Hyper terminal console as 
 | 
   below and type any key to stop autoboot as instructed := 
 | 
  
 | 
U-Boot 2014.04-rc1-00201-gc215b5a (Mar 21 2014 - 12:47:59) 
 | 
  
 | 
I2C:   ready 
 | 
Detected SO-DIMM [SQR-SD3T-2G1333SED] 
 | 
DRAM:  1.1 GiB 
 | 
NAND:  512 MiB 
 | 
Net:   K2HK_EMAC 
 | 
Warning: K2HK_EMAC using MAC address from net device 
 | 
, K2HK_EMAC1, K2HK_EMAC2, K2HK_EMAC3 
 | 
Hit any key to stop autoboot:  0 
 | 
  
 | 
SPI NOR Flash programming instructions 
 | 
====================================== 
 | 
U-Boot image can be flashed to first 512KB of the NOR flash using following 
 | 
instructions: 
 | 
  
 | 
1. Start CCS and run U-Boot as described above. 
 | 
2. Suspend Target. Select Run -> Suspend from top level menu 
 | 
   CortexA15_1 (Free Running)" 
 | 
3. Load u-boot-spi.gph binary from build folder on to DDR address 0x87000000 
 | 
   through CCS as described in step 2 of "Load and Run U-Boot on K2HK/K2E/K2L 
 | 
   EVM using CCS", but using address 0x87000000. 
 | 
4. Free Run the target as described earlier (step 4) to get U-Boot prompt 
 | 
5. At the U-Boot console type following to setup U-Boot environment variables. 
 | 
   setenv addr_uboot 0x87000000 
 | 
   setenv filesize <size in hex of u-boot-spi.gph rounded to hex 0x10000> 
 | 
   run burn_uboot_spi 
 | 
   Once U-Boot prompt is available, Power OFF the EVM. Set the SW1 dip switch 
 | 
   to "SPI Little Endian Boot mode" as per instruction at 
 | 
   http://processors.wiki.ti.com/index.php/*_Hardware_Setup. 
 | 
6. Power ON the EVM. The EVM now boots with U-Boot image on the NOR flash. 
 | 
  
 | 
AEMIF NAND Flash programming instructions 
 | 
====================================== 
 | 
U-Boot image can be flashed to first 1024KB of the NAND flash using following 
 | 
instructions: 
 | 
  
 | 
1. Start CCS and run U-Boot as described above. 
 | 
2. Suspend Target. Select Run -> Suspend from top level menu 
 | 
   CortexA15_1 (Free Running)" 
 | 
3. Load MLO binary from build folder on to DDR address 0x87000000 
 | 
   through CCS as described in step 2 of "Load and Run U-Boot on K2HK EVM 
 | 
   using CCS", but using address 0x87000000. 
 | 
4. Free Run the target as described earlier (step 4) to get U-Boot prompt 
 | 
5. At the U-Boot console type following to setup U-Boot environment variables. 
 | 
   setenv filesize <size in hex of MLO rounded to hex 0x10000> 
 | 
   run burn_uboot_nand 
 | 
   Once U-Boot prompt is available, Power OFF the EVM. Set the SW1 dip switch 
 | 
   to "ARM NAND Boot mode" as per instruction at 
 | 
   http://processors.wiki.ti.com/index.php/*_Hardware_Setup. 
 | 
6. Power ON the EVM. The EVM now boots with U-Boot image on the NAND flash. 
 | 
  
 | 
Load and Run U-Boot on keystone EVMs using UART download 
 | 
======================================================== 
 | 
  
 | 
Open BMC and regular UART terminals. 
 | 
  
 | 
1. On the regular UART port start xmodem transfer of the u-boot.bin 
 | 
2. Using BMC terminal set the ARM-UART bootmode and reboot the EVM 
 | 
   BMC> bootmode #4 
 | 
   MBC> reboot 
 | 
3. When xmodem is complete you should see the U-Boot starts on the UART port 
 | 
  
 | 
Load and Run U-Boot on K2G EVMs using MMC 
 | 
======================================================== 
 | 
  
 | 
Open BMC and regular UART terminals. 
 | 
  
 | 
1. Set the SW3 dip switch to "ARM MMC Boot mode" as per instruction at 
 | 
   http://processors.wiki.ti.com/index.php/66AK2G02_GP_EVM_Hardware_Setup 
 | 
2. Create SD card partitions as per steps given in Hardware Setup Guide. 
 | 
3. Copy MLO to Boot Partition. 
 | 
4. Insert SD card and Power on the EVM. 
 | 
   The EVM now boots with U-Boot image from SD card. 
 |