1 U-Boot port for Texas Instruments Keystone II EVM boards
2 ========================================================
4 Author: Murali Karicheri <m-karicheri2@ti.com>
6 This README has information on the u-boot port for K2HK, K2E, and K2L EVM boards.
7 Documentation for this board can be found at
8 http://www.advantech.com/Support/TI-EVM/EVMK2HX_sd.aspx
9 https://www.einfochips.com/index.php/partnerships/texas-instruments/k2e-evm.html
10 https://www.einfochips.com/index.php/partnerships/texas-instruments/k2l-evm.html
12 The K2HK board is based on Texas Instruments Keystone2 family of SoCs: K2H, K2K.
13 More details on these SoCs are available at company websites
14 K2K: http://www.ti.com/product/tci6638k2k
15 K2H: http://www.ti.com/product/tci6638k2h
17 The K2E SoC details are available at
18 http://www.ti.com/lit/ds/symlink/66ak2e05.pdf
20 The K2L SoC details are available at
21 http://www.ti.com/lit/ds/symlink/tci6630k2l.pdf
26 Some of the peripherals that are configured by u-boot
27 +------+-------+-------+-----------+-----------+-------+-------+----+
28 | |DDR3 |NAND |MSM SRAM |ETH ports |UART |I2C |SPI |
29 +------+-------+-------+-----------+-----------+-------+-------+----+
30 |K2HK |2 |512MB |6MB |4(2) |2 |3 |3 |
31 |K2E |4 |512MB |2MB |8(2) |2 |3 |3 |
32 |K2L |2 |512MB |2MB |4(2) |4 |3 |3 |
33 +------+-------+-------+-----------+-----------+-------+-------+----+
35 There are only 2 eth port installed on the boards.
37 There are separate PLLs to drive clocks to Tetris ARM and Peripherals.
38 To bring up SMP Linux on this board, there is a boot monitor
39 code that will be installed in MSMC SRAM. There is command available
40 to install this image from u-boot.
42 The port related files can be found at following folders
43 keystone2 SoC related files: arch/arm/cpu/armv7/keystone/
44 EVMs board files: board/ti/k2s_evm/
46 Board configuration files:
47 include/configs/k2hk_evm.h
48 include/configs/k2e_evm.h
49 include/configs/k2l_evm.h
50 include/configs/k2l_evm.h
52 As u-boot is migrating to Kconfig there is also board defconfig files
53 configs/k2e_evm_defconfig
54 configs/k2hk_evm_defconfig
55 configs/k2l_evm_defconfig
61 Supported image formats:
62 - u-boot.bin: for loading and running u-boot.bin through Texas instruments
63 code composure studio (CCS)
64 - u-boot-spi.gph: gpimage for programming SPI NOR flash for SPI NOR boot
65 - u-boot-nand.gph: gpimage for programming AEMIF NAND flash for NAND boot
69 Examples for k2hk, for k2e and k2l just replace k2hk prefix accordingly.
70 Don't forget to add ARCH=arm and CROSS_COMPILE.
73 >make k2hk_evm_defconfig
76 To build u-boot-spi.gph
77 >make k2hk_evm_defconfig
80 To build u-boot-nand.gph
81 >make k2hk_evm_defconfig
84 Load and Run U-Boot on keystone EVMs using CCS
85 =========================================
87 Need Code Composer Studio (CCS) installed on a PC to load and run u-boot.bin
88 on EVM. See instructions at below link for installing CCS on a Windows PC.
89 http://processors.wiki.ti.com/index.php/MCSDK_UG_Chapter_Getting_Started#
90 Installing_Code_Composer_Studio
91 Use u-boot.bin from the build folder for loading and running u-boot binary
92 on EVM. Follow instructions at
93 K2HK http://processors.wiki.ti.com/index.php/EVMK2H_Hardware_Setup
94 K2E http://processors.wiki.ti.com/index.php/EVMK2E_Hardware_Setup
95 K2L http://processors.wiki.ti.com/index.php/TCIEVMK2L_Hardware_Setup
97 to configure SW1 dip switch to use "No Boot/JTAG DSP Little Endian Boot Mode"
98 and Power ON the EVM. Follow instructions to connect serial port of EVM to
99 PC and start TeraTerm or Hyper Terminal.
101 Start CCS on a Windows machine and Launch Target
102 configuration as instructed at http://processors.wiki.ti.com/index.php/
103 MCSDK_UG_Chapter_Exploring#Loading_and_Running_U-Boot_on_EVM_through_CCS.
104 The instructions provided in the above link uses a script for
105 loading the u-boot binary on the target EVM. Instead do the following:-
107 1. Right click to "Texas Instruments XDS2xx USB Emulator_0/CortexA15_1 core (D
108 is connected: Unknown)" at the debug window (This is created once Target
109 configuration is launched) and select "Connect Target".
110 2. Once target connect is successful, choose Tools->Load Memory option from the
111 top level menu. At the Load Memory window, choose the file u-boot.bin
112 through "Browse" button and click "next >" button. In the next window, enter
113 Start address as 0xc001000, choose Type-size "32 bits" and click "Finish"
115 3. Click View -> Registers from the top level menu to view registers window.
116 4. From Registers, window expand "Core Registers" to view PC. Edit PC value
117 to be 0xc001000. From the "Run" top level menu, select "Free Run"
118 5. The U-Boot prompt is shown at the Tera Term/ Hyper terminal console as
119 below and type any key to stop autoboot as instructed :=
121 U-Boot 2014.04-rc1-00201-gc215b5a (Mar 21 2014 - 12:47:59)
124 Detected SO-DIMM [SQR-SD3T-2G1333SED]
128 Warning: K2HK_EMAC using MAC address from net device
129 , K2HK_EMAC1, K2HK_EMAC2, K2HK_EMAC3
130 Hit any key to stop autoboot: 0
132 SPI NOR Flash programming instructions
133 ======================================
134 U-Boot image can be flashed to first 512KB of the NOR flash using following
137 1. Start CCS and run U-boot as described above.
138 2. Suspend Target. Select Run -> Suspend from top level menu
139 CortexA15_1 (Free Running)"
140 3. Load u-boot-spi.gph binary from build folder on to DDR address 0x87000000
141 through CCS as described in step 2 of "Load and Run U-Boot on K2HK/K2E/K2L
142 EVM using CCS", but using address 0x87000000.
143 4. Free Run the target as described earlier (step 4) to get u-boot prompt
144 5. At the U-Boot console type following to setup u-boot environment variables.
145 setenv addr_uboot 0x87000000
146 setenv filesize <size in hex of u-boot-spi.gph rounded to hex 0x10000>
148 Once u-boot prompt is available, Power OFF the EVM. Set the SW1 dip switch
149 to "SPI Little Endian Boot mode" as per instruction at
150 http://processors.wiki.ti.com/index.php/*_Hardware_Setup.
151 6. Power ON the EVM. The EVM now boots with u-boot image on the NOR flash.
153 AEMIF NAND Flash programming instructions
154 ======================================
155 U-Boot image can be flashed to first 1024KB of the NAND flash using following
158 1. Start CCS and run U-boot as described above.
159 2. Suspend Target. Select Run -> Suspend from top level menu
160 CortexA15_1 (Free Running)"
161 3. Load u-boot-nand.gph binary from build folder on to DDR address 0x87000000
162 through CCS as described in step 2 of "Load and Run U-Boot on K2HK EVM
163 using CCS", but using address 0x87000000.
164 4. Free Run the target as described earlier (step 4) to get u-boot prompt
165 5. At the U-Boot console type following to setup u-boot environment variables.
166 setenv filesize <size in hex of u-boot-nand.gph rounded to hex 0x10000>
168 Once u-boot prompt is available, Power OFF the EVM. Set the SW1 dip switch
169 to "ARM NAND Boot mode" as per instruction at
170 http://processors.wiki.ti.com/index.php/*_Hardware_Setup.
171 6. Power ON the EVM. The EVM now boots with u-boot image on the NAND flash.