SPRACN3 September   2019 66AK2E05 , 66AK2H06 , 66AK2H12 , 66AK2H14 , 66AK2L06 , AM5K2E02 , AM5K2E04

 

  1.   Using ARM ROM Bootloader on Keystone II Devices
    1.     Trademarks
    2. 1  Keystone2 Boot loader Overview
    3. 2  Boot Examples Package Download
    4. 3  Software Dependencies
    5. 4  Supported Hardware
    6. 5  Software Features
    7. 6  Directory Structure
    8. 7  Building the Examples
    9. 8  Description of the Examples
      1. 8.1 Single Stage Boot Examples
      2. 8.2 Multi-Stage Boot Example
      3. 8.3 Boot Media-Specific Details
        1. 8.3.1 SPI Boot Example
        2. 8.3.2 I2C Boot Examples
        3. 8.3.3 NAND Examples
        4. 8.3.4 UART Boot Examples
        5. 8.3.5 Ethernet boot examples
        6. 8.3.6 K2E Ethernet Boot Errata Workaround
      4. 8.4 Flashing and Running Boot Examples
        1. 8.4.1 Dip Switch Settings
        2. 8.4.2 Running I2C EEPROM example
        3. 8.4.3 Running SPI NOR Example
        4. 8.4.4 Running NAND Example
        5. 8.4.5 Running UART Example
        6. 8.4.6 Running Ethernet Examples
    10. 9  Boot Utilities
    11. 10 Frequently Asked Questions (FAQ)
    12. 11 References

9 Boot Utilities

Boot Utilities are host side utilities included in the package that are used to format the boot image based on the boot mode requirements. The utilities can be located in the package under the path "utils" directory. The following utilities are include in the package.

  • byteswapccs - byteswaps files in ccs format
    • Usage: byteswapccs <infile> <outfile> Both <infile> and <outfile> are .ccs files.
  • byteswapbin - Creates a byte swapped copy of a binary file
    • Usage: byteswapbin lt;infile> lt;outfile> Both lt;infile> and lt;outfile> are .bin files.
  • catccs - concatenates ccs format files
    • Usage: catccs <infile1> <infile2> [<infile3> [<infile4> [..]]] [-out <outfile>] [-addr <address>] <infile1>, <infile2>, <infile3>, <infile4> and <outfile> are .ccs files. address - load address for the concatenated ccs file.
  • ccs2bin - converts ccs format to binary
    • Usage: ccs2bin [-swap] <ccsfile> <binfile> <ccsfile> - input .ccs files. <binfile> - output .bin files.
  • b2ccs - converts a hex b file into a ccs data file
    • Usage: b2ccs [-noorg] <hexfile> <ccsfile> <hexfile> - Hexadecimal blob file. <ccsfile> - Output .ccs file. if -noorg is used there is only one header line
  • ccsAddGphdr - adds a general-purpose header to a ccs format file
    • Usage: ccsAddGphdr [baseAddress] [-infile <infile>] [-outfile <outfile>] -headerEndian BE <infile> Input CCS file with no GP header <outfile> Output CCS file with GP header headerEndian - Should always be forced to BE (big endian) for LE boot.
  • ccsAddGptlr - Adds the 8 byte General Purpose Trailer
    • Usage ccsAddGptlr [-h] [-infile <infile>] [-outfile <outfile>] <infile> Input CCS file with no GP trailer <outfile> Output CCS file with GP trailer
  • ccspad - Pad a ccs data file to a certain length. The length is in number of lines.
    • Usage ccspad <infile> <outfile> <pattern> <length> <infile> Input CCS file of length <outfile> Output CCS file padded with the <pattern>to size <length>

    NOTE

    Under Linux environment, these utilities can be used using a utility called wine, which allows you to run windows utilities in the Linux environment.