MCSDK 3.0: fix minor comments error
[keystone-rtos/mcsdk-tools.git] / post / docs / README.txt
1 Power On Self Test Utility
3 POST is a test program that can be programmed to I2C EEPROM and boot directly from I2C bus address 0x50 after POR.
4 It performs board specific tests, such as external memory test, NAND/NOR/EEPROM read test, LED test, etc.
6 Steps to build POST:
8 1. Import the POST CCS project from tools\post\evmxxxx directory. (in CCSv5, Project->Import Existing CCS/
9    CCE Eclipse Projects)
11 2. Be sure the lite version of the Platform Lib is pre-built: 
12    pdk_xxxx_x_x_x_x\packages\ti\platform\evmxxxx\platform_lib\lib\debug\ti.platform.evmxxxx.lite.lib
13    If the lib is not pre-built, refer to Platform Lib User Guide under pdk_xxxx_x_x_x_x\packages\ti\platform\docs 
14    on how to build the platform library.
16    Note that the lite version of platform lib only contains the functions that are required by the POST, so that 
17    POST can be fit into the EEPROM.
19 3. Clean the POST project and re-build the project, after build is completed, post_evmxxxx.out and post_evmxxxx.map
20    will be generated under tools\post\evmxxxx\bin directory.
23 Steps to run POST in CCSv5:
25 1. Be sure to set the boot mode dip switch to no boot/EMIF16 boot mode on the EVM
27 2. Load the program tools\post\evmxxxx\bin\post_evmxxxx.out to CCS.
29 3. Connect the 3-pin RS-232 cable from the EVM to the serial port of the PC, and start Hyper Terminal.
31 4. Create a new connection with the Baud rate set to 115200 bps, Data bits 8, Parity none, Stop bits 1 and 
32    Flow control none. Be sure the COM port # is set correctly.
34 5. Run the program in CCS, POST will send the test status and result to the Hyper Terminal.
37 Steps to program POST to EEPROM:
39 1. Copy tools\post\evmxxxx\bin\post_i2crom.bin to tools\writer\eeprom\evmxxxx\bin directory
41 2. Navigate to tools\writer\eeprom\evmxxxx\bin\ and open eepromwriter_input.txt. Make the following changes:
42       - Set the file_name to post_i2crom.bin
43       - Set the bus_addr to 0x50
44       - Set start_addr to 0
45       - Set swap_data to 0
46    Save and close eepromwriter_input.txt
48 3. Refer to tools\writer\eeprom\evmxxxx\docs\README.txt on how to program the raw binary file to EEPROM
50 4. Once the programming is completed successfully, user can set the boot mode to I2C mode with bus address 0x50 and
51    boot the POST directly from the EEPROM after POR. The boot status and test result can be monitored using the Hyper
52    Terminal as mentioned in "Steps to run POST in CCSv5".
54 Please refer to C6678L/C6670L/C6657L/TCI6634K2K EVM boot mode dip switch settings:
55 http://processors.wiki.ti.com/index.php/TMDXEVM6678L_EVM_Hardware_Setup#Boot_Mode_Dip_Switch_Settings
56 http://processors.wiki.ti.com/index.php/TMDXEVM6670L_EVM_Hardware_Setup#Boot_Mode_Dip_Switch_Settings
57 http://processors.wiki.ti.com/index.php/TMDSEVM6657L_EVM_Hardware_Setup#Boot_Mode_Dip_Switch_Settings
58 http://processors.wiki.ti.com/index.php/TMDSEVMK2K_EVM_Hardware_Setup#Boot_Mode_Dip_Switch_Settings (TBD)
60 and User's Guide for more details:
61 http://processors.wiki.ti.com/index.php/BIOS_MCSDK_x.0_User_Guide