Added support for C6657
[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
14 2) Supported ENDIAN
15     - big
16     - little
18 3) Required toolset
19     - TI CGEN compiler CGT_C6000_7.2.0
21    Requirements for building IBL on Windows:
22    For building on a Windows machine, a GNU development environment is
23    required. MinGW installation is required for this. 
24    MinGW project link: http://www.mingw.org/
25    MinGW installer can be obtained from the following link
26    http://sourceforge.net/projects/mingw/files/Automated%20MinGW%20Installer/mingw-get-inst/mingw-get-inst-20110316/mingw-get-inst-20110316.exe/download
27    While installing MinGW following options have to be chosen:
28     1.  MinGw Compiler Suite
29         -   C Compiler
30     2. MinGW Developer Toolkit 
31  
32 4) Build Instructions
34     - Change directory to ibl\src\make
35     - Modify the environment setup script to match the tool chain installation
36       directory:
37         For building in MINGW-MSYS Bash shell modify setupenvMsys.sh 
38         For building in Linux Bash shell modify setupenvLnx.sh 
39     - Set the environment variables:
40          On a Linux Bash shell run  "source setupenvLnx.sh"
41          On a MinGW-MSYS Bash shell "source setupenvMsys.sh"
42     - Following are the commands for building IBL:
44         For C6657 Low Cost EVM:
45         
46         make evm_c6657_i2c ENDIAN=little I2C_BUS_ADDR=0x51 
47         Output images:
48         IBL image: bin/i2crom_0x51_c6657_le.dat (CCS data format)
49                  : bin/i2crom_0x51_c6657_le.bin (raw binary)
51         make evm_c6657_i2c ENDIAN=big I2C_BUS_ADDR=0x51 
52         Output images:
53         IBL image: bin/i2crom_0x51_c6657_be.dat (CCS data format)
54                  : bin/i2crom_0x51_c6657_be.bin (raw binary)
57         For C6678 Low Cost EVM:
58         
59         make evm_c6678_i2c ENDIAN=little I2C_BUS_ADDR=0x51 
60         Output images:
61         IBL image: bin/i2crom_0x51_c6678_le.dat (CCS data format)
62                  : bin/i2crom_0x51_c6678_le.bin (raw binary)
64         make evm_c6678_i2c ENDIAN=big I2C_BUS_ADDR=0x51 
65         Output images:
66         IBL image: bin/i2crom_0x51_c6678_be.dat (CCS data format)
67                  : bin/i2crom_0x51_c6678_be.bin (raw binary)
69       
70         For C6670 Low Cost EVM:
71         
72         make evm_c6670_i2c ENDIAN=little I2C_BUS_ADDR=0x51 
73         Output images:
74         IBL image: bin/i2crom_0x51_c6670_le.dat (CCS data format)
75                  : bin/i2crom_0x51_c6670_le.bin (raw binary)
77         make evm_c6670_i2c ENDIAN=big I2C_BUS_ADDR=0x51 
78         Output images:
79         IBL image: bin/i2crom_0x51_c6670_be.dat (CCS data format)
80                  : bin/i2crom_0x51_c6670_be.bin (raw binary)
82         
84         For C6474 LC EVM
86         make evm_c6474l ENDIAN=little 
87         Output images:
88         IBL image: bin/i2crom_0x50_c6474l_le.dat (CCS data format)
89                  : bin/i2crom_0x50_c6474l_le.bin (raw binary)
91         make evm_c6474l ENDIAN=big 
92         Output images:
93         IBL image: bin/i2crom_0x50_c6474l_be.dat (CCS data format)
94                  : bin/i2crom_0x50_c6474l_be.bin (raw binary)
96         For C6474 Mezzanine EVM
98         make evm_c6474 ENDIAN=little 
99         Output images:
100         IBL image: bin/i2crom_0x50_c6474_le.dat (CCS data format)
101                  : bin/i2crom_0x50_c6474_le.bin (raw binary)
103         make evm_c6474 ENDIAN=big 
104         Output images:
105         IBL image: bin/i2crom_0x50_c6474_be.dat (CCS data format)
106                  : bin/i2crom_0x50_c6474_be.bin (raw binary)
108         For C6472 LC EVM
110         make evm_c6472 ENDIAN=little 
111         Output images:
112         IBL image: bin/i2crom_0x50_c6472_le.dat (CCS data format)
113                  : bin/i2crom_0x50_c6472_le.bin (raw binary)
115         make evm_c6472 ENDIAN=big 
116         Output images:
117         IBL image: bin/i2crom_0x50_c6472_be.dat (CCS data format)
118                  : bin/i2crom_0x50_c6472_be.bin (raw binary)
120         For C6457 LC EVM
122         make evm_c6457 ENDIAN=little 
123         Output images:
124         IBL image: bin/i2crom_0x50_c6457_le.dat (CCS data format)
125                  : bin/i2crom_0x50_c6457_le.bin (raw binary)
127         make evm_c6457 ENDIAN=big 
128         Output images:
129         IBL image: bin/i2crom_0x50_c6457_be.dat (CCS data format)
130                  : bin/i2crom_0x50_c6457_be.bin (raw binary)
133         For DSK 6455 EVM
135         make evm_c6455 ENDIAN=little 
136         Output images:
137         IBL image: bin/i2crom_0x50_c6455_le.dat (CCS data format)
138                  : bin/i2crom_0x50_c6455_le.bin (raw binary)
140         make evm_c6455 ENDIAN=big 
141         Output images:
142         IBL image: bin/i2crom_0x50_c6455_be.dat (CCS data format)
143                  : bin/i2crom_0x50_c6455_be.bin (raw binary)
146         
149                  
152