2.9.3 Bootstrap Image Format

A bootstrap image stored in NVM must have a defined format to be launched by the ROM code. Depending on the mode of operation and configuration, the format may differ.

In all formats, a valid image starts with a fixed size header:

Field NameSize (bits)Notes
Magic word32A magic value describing the type of image
Image size32Actual image size in bytes, not including header and security data
Authentication data32Parameters for authentication
Dual boot info32Dual boot identification information
Tag256Header tag (SHA256)
  • Magic word:
    • 0x42535031 -> ‘BSP1’: Plain text bootstrap image version 1
    • 0x42534331 -> ‘BSC1’: Secure bootstrap image version 1
  • Image size: Actual size in bytes of the padded bootstrap image. The image must be a multiple of 128-bit blocks.
  • Authentication data: Parameters for authentication are as follows:
    Bit3130292827262524
    StepsRFURFURFURFUAuth. algorithmRFU
    Bit2322212019181716
    RFU
    Bit15141312111098
    Security data size
    Bit76543210
    Security data size
    • Bit 31 – Steps: Used in image verification
      • 0: Single-step verification
      • 1: Double-step verification
    • Bit 26:25 – Authentication algorithm
      • 00: No authentication
      • 01: AES-CMAC
      • 10: RSA
      • 11: ECDSA
    • Bits 15:0 – Security data size: Size in bytes of security data present after the image
    • Other bits – RFU: Must be set to 0b0.
  • Dual boot info: Dual boot identification information as follows:
    FieldSizeDescription
    Bootstrap Major Version Number16Major version number
    Bootstrap Minor Version Number16Minor version number
  • Tag: Must be 256 bits long:
    • In Plain Text mode, contains the header SHA256 digest.
    • In Secure mode, refer to the following table:
    FieldSizeDescription
    Plain bootstrap TAG128AES-CMAC of the plain bootstrap image
    Header TAG128AES-CMAC of the image header

    To clear the bootstrap, the tag must be comprised of random values if the image is configured for a single-step verification.