6 Directory Structure

Figure 1 shows the directory structure for the software package. The examples directory is organized to follow the convention.

Figure 1. Boot Example Directory Structure

Detailed description of the directory structure is given below:

• docs - directory contains ReadMe documents and the software manifest for the package.
• common - directory contains source and header files for helper functions that are used by the examples to configure MMU, CACHE, PLLs, UART and to set user defined entry point for their applications.
• include - directory contains all boot header files that applies to all the devices in the Keystone family.
• examples - directory contains source for single stage and multi stage boot examples for different boot modes.
  • k2e - directory contains boot examples for K2E devices.
    • build - directory contains linker command files that specify the memory configuration for each examples
    • cfg - directory contains header files that contain ddr configuration tables, boot parameter tables for different boot modes and tiboot.h file defined in the BootROM.
    • [peripheral] - directory contains boot example code for each peripheral (eth, i2c,nand,spi, uart)
      • [example type] - directory contains single stage/mulitstage example binaries.
    • uboot - directory contains build files required to create uboot binaries for different boot media.
  • k2h - directory contains boot examples for K2H devices.
    • build - directory contains linker command files that specify the memory configuration for each examples
    • cfg - directory contains header files that contain ddr configuration tables, boot parameter tables for different boot modes and tiboot.h file defined in the BootROM.
    • [peripheral] - directory contains boot example code for each peripheral (eth, i2c,nand,spi, uart)
      • [example type] - directory contains single stage/multi-stage example binaries.
    • uboot - directory contains build files required to create uboot binaries for different boot media.
  • src - directory contains source for sample applications that demonstrate single stage and multistage booting.
    • singleStage: directory contains source files for Single stage boot example
    • mulitStage: directory contains source files for two stage boot example
• utils - directory contains the utilities for building boot images
  • byteswap : directory contains the source and binaries for byteswapccs utility.
  • btoccs : directory contains source and binaries for b2ccs,catccs, ccs2bin utilities
  • ccsutil: directory contains source and binaries for ccsAddGphdr,ccsAddGptlr,ccspad utilities

Source files:

• Stage1.c
• Stage2.c

Configuration files:

• paramTables.h Boot Parameter table used for multi Stage boot examples are provided in this file.
• ddrConfigTable.h: DDR configuration table used in examples initialize are provided in this file.
• tiboot.h: BootROM header file that contains details of boot parameter structures, configuration tables and BOOTROM call table.