to fix prsdk 5675
[keystone-rtos/ibl.git] / doc / build_instructions.txt
1 =====================================================
2 C6x Bootloader Build Instructions
3 =====================================================
5 1) Supported EVM's:
6     - C6678 LC EVM
7     - C6670 LC EVM
8     - C6474 LC EVM
9     - C6474 Mezzanine EVM
10     - C6472 LC EVM
11     - C6457 LC EVM
12     - DSK6455 EVM
13     - C6657 LC EVM
14     - TCI6634K2K EVM
16 2) Supported ENDIAN
17     - big
18     - little
20 3) Required toolset
21     - TI CGEN compiler CGT_C6000_7.3.0
23    Requirements for building IBL on Windows:
24    For building on a Windows machine, a GNU development environment is
25    required. MinGW installation is required for this. 
26    MinGW project link: http://www.mingw.org/
27    MinGW installer can be obtained from the following link
28    http://sourceforge.net/projects/mingw/files/Automated%20MinGW%20Installer/mingw-get-inst/mingw-get-inst-20110316/mingw-get-inst-20110316.exe/download
29    While installing MinGW following options have to be chosen:
30     1.  MinGw Compiler Suite
31         -   C Compiler
32     2. MinGW Developer Toolkit 
33  
34 4) Build Instructions
36     - Change directory to ibl\src\make
37     - Modify the environment setup script to match the tool chain installation
38       directory:
39         For building in MINGW-MSYS Bash shell modify setupenvMsys.sh 
40         For building in Linux Bash shell modify setupenvLnx.sh 
41     - Set the environment variables:
42          On a Linux Bash shell run  "source setupenvLnx.sh"
43          On a MinGW-MSYS Bash shell "source setupenvMsys.sh"
44     - Following are the commands for building IBL:
46         For TCI6634K2K Low Cost EVM:
47         
48         make evm_tci6634k2k_i2c ENDIAN=little I2C_BUS_ADDR=0x51 
49         Output images:
50         IBL image: bin/i2crom_0x51_tci6634k2k_le.dat (CCS data format)
51                  : bin/i2crom_0x51_tci6634k2k_le.bin (raw binary)
53         make evm_tci6634k2k_i2c ENDIAN=big I2C_BUS_ADDR=0x51 
54         Output images:
55         IBL image: bin/i2crom_0x51_tci6634k2k_be.dat (CCS data format)
56                  : bin/i2crom_0x51_tci6634k2k_be.bin (raw binary)
58         For C6657 Low Cost EVM:
59         
60         make evm_c6657_i2c ENDIAN=little I2C_BUS_ADDR=0x51 
61         Output images:
62         IBL image: bin/i2crom_0x51_c6657_le.dat (CCS data format)
63                  : bin/i2crom_0x51_c6657_le.bin (raw binary)
65         make evm_c6657_i2c ENDIAN=big I2C_BUS_ADDR=0x51 
66         Output images:
67         IBL image: bin/i2crom_0x51_c6657_be.dat (CCS data format)
68                  : bin/i2crom_0x51_c6657_be.bin (raw binary)
71         For C6678 Low Cost EVM:
72         
73         make evm_c6678_i2c ENDIAN=little I2C_BUS_ADDR=0x51 
74         Output images:
75         IBL image: bin/i2crom_0x51_c6678_le.dat (CCS data format)
76                  : bin/i2crom_0x51_c6678_le.bin (raw binary)
78         make evm_c6678_i2c ENDIAN=big I2C_BUS_ADDR=0x51 
79         Output images:
80         IBL image: bin/i2crom_0x51_c6678_be.dat (CCS data format)
81                  : bin/i2crom_0x51_c6678_be.bin (raw binary)
83       
84         For C6670 Low Cost EVM:
85         
86         make evm_c6670_i2c ENDIAN=little I2C_BUS_ADDR=0x51 
87         Output images:
88         IBL image: bin/i2crom_0x51_c6670_le.dat (CCS data format)
89                  : bin/i2crom_0x51_c6670_le.bin (raw binary)
91         make evm_c6670_i2c ENDIAN=big I2C_BUS_ADDR=0x51 
92         Output images:
93         IBL image: bin/i2crom_0x51_c6670_be.dat (CCS data format)
94                  : bin/i2crom_0x51_c6670_be.bin (raw binary)
96         
98         For C6474 LC EVM
100         make evm_c6474l ENDIAN=little 
101         Output images:
102         IBL image: bin/i2crom_0x50_c6474l_le.dat (CCS data format)
103                  : bin/i2crom_0x50_c6474l_le.bin (raw binary)
105         make evm_c6474l ENDIAN=big 
106         Output images:
107         IBL image: bin/i2crom_0x50_c6474l_be.dat (CCS data format)
108                  : bin/i2crom_0x50_c6474l_be.bin (raw binary)
110         For C6474 Mezzanine EVM
112         make evm_c6474 ENDIAN=little 
113         Output images:
114         IBL image: bin/i2crom_0x50_c6474_le.dat (CCS data format)
115                  : bin/i2crom_0x50_c6474_le.bin (raw binary)
117         make evm_c6474 ENDIAN=big 
118         Output images:
119         IBL image: bin/i2crom_0x50_c6474_be.dat (CCS data format)
120                  : bin/i2crom_0x50_c6474_be.bin (raw binary)
122         For C6472 LC EVM
124         make evm_c6472 ENDIAN=little 
125         Output images:
126         IBL image: bin/i2crom_0x50_c6472_le.dat (CCS data format)
127                  : bin/i2crom_0x50_c6472_le.bin (raw binary)
129         make evm_c6472 ENDIAN=big 
130         Output images:
131         IBL image: bin/i2crom_0x50_c6472_be.dat (CCS data format)
132                  : bin/i2crom_0x50_c6472_be.bin (raw binary)
134         For C6457 LC EVM
136         make evm_c6457 ENDIAN=little 
137         Output images:
138         IBL image: bin/i2crom_0x50_c6457_le.dat (CCS data format)
139                  : bin/i2crom_0x50_c6457_le.bin (raw binary)
141         make evm_c6457 ENDIAN=big 
142         Output images:
143         IBL image: bin/i2crom_0x50_c6457_be.dat (CCS data format)
144                  : bin/i2crom_0x50_c6457_be.bin (raw binary)
147         For DSK 6455 EVM
149         make evm_c6455 ENDIAN=little 
150         Output images:
151         IBL image: bin/i2crom_0x50_c6455_le.dat (CCS data format)
152                  : bin/i2crom_0x50_c6455_le.bin (raw binary)
154         make evm_c6455 ENDIAN=big 
155         Output images:
156         IBL image: bin/i2crom_0x50_c6455_be.dat (CCS data format)
157                  : bin/i2crom_0x50_c6455_be.bin (raw binary)
160         
163                  
166