Optional Data - Optional Data - 2026.1 English - UG1283

Bootgen User Guide (UG1283)

Document ID
UG1283
Release Date
2026-06-23
Version
2026.1 English

Optional data is binary data placed in the PDI after the image header table (IHT). You can include your own optional data like data, version, and so on. For more information, refer to optionaldata.

The system authenticates this data as part of the IHT Signature. During encryption, it adds IHT as additional authenticated data (AAD) for the first secure header (SH) of the image header (IH), along with IHT. This implies that the optional data content remains as plain text.

As part of Authentication Optimization, the system places the partition hashes in Optional Data for partitions that use the same authentication keys. For more information, see Authentication Optimization.

The optional metadata support is always added in clear text and is not considered Image or Partition information. This comes immediately after the IHT. The Size of IHT Optional Data (offset 0x58) field in the IHT determines the size of this data. The content is a list of the following data structure:

Table 1. Optional Data
Offset Name Description
0x0 ID

The Data ID field identifies the type of data contained in the data structure.

0: None, can be used for padding

1: PLM Build Time configuration metadata as defined in the PLM Configuration document

2: Data structure version information used in In-Place PLM Update Compatibility Check

4: Reserved

0x2 Size

Total optional data size in words

The Size field specifies the number of words in the data structure.

The minimal value is 1 which indicates that no data or checksum is present. This is useful for padding.

Value 2 indicates that checksum is present, but no data.

0x4 Data Actual data including padding
Last Checksum Sum of all the previous words in this data structure