MBI-A-TZV-I-LA-IV-AC-A-EATCA

Type: object

root family

The chip family name

Type: enum (of string)

NXP chip family identifier.

Must be one of:

  • "mcxa345"
  • "mcxn527"
  • "mcxa143"
  • "kw45z41083"
  • "lpc5504"
  • "lpc5536"
  • "mc56f81748"
  • "mcxc242"
  • "mcxa152"
  • "mimxrt595s"
  • "mimxrt735s"
  • "lpc55s69"
  • "mcxa266"
  • "mcxe247"
  • "lpc55s28"
  • "mcxa174"
  • "kw47z42092"
  • "lpc5516"
  • "mc56f81646"
  • "lpc55s66"
  • "mcxa156"
  • "lpc5514"
  • "mcxa356"
  • "mcxe245"
  • "kw45z41053"
  • "nhs52s04"
  • "mc56f81666"
  • "mcxa186"
  • "mcxa256"
  • "mcxc141"
  • "lpc5502"
  • "lpc55s06"
  • "mcxw727a"
  • "kw45z41082"
  • "kw47b42z97"
  • "kw45z41052"
  • "mcxl253"
  • "mcxe315"
  • "mcxe317"
  • "mcxa132"
  • "mwct2012a"
  • "mcxa153"
  • "mimxrt758s"
  • "mwct2012"
  • "mcxn236"
  • "mcxw727d"
  • "kw47z420b3"
  • "mcxa154"
  • "kw47b42zb7"
  • "mc56f81648"
  • "mcxa133"
  • "mcxc443"
  • "lpc5528"
  • "mcxc444"
  • "k32w148"
  • "mc56f81766"
  • "mc56f81868"
  • "mwct20d2a"
  • "lpc55s36"
  • "mcxa185"
  • "mimxrt685s"
  • "mwct20d2"
  • "mcxc144"
  • "rw610"
  • "lpc5534"
  • "mcxa145"
  • "mcxl254"
  • "mc56f81746"
  • "lpc5506"
  • "mcxa355"
  • "mcxc244"
  • "kw47b42zb2"
  • "mcxe31b"
  • "mcxn947"
  • "mimxrt798s"
  • "mcxa175"
  • "lpc55s14"
  • "mcxn546"
  • "kw47b42zb3"
  • "mcxa146"
  • "kw47z42082"
  • "mcxa173"
  • "mcxe246"
  • "mcxn557s"
  • "mcxw716c"
  • "mcxw727c"
  • "mcxn526"
  • "mcxn556s"
  • "mcxa176"
  • "mc56f81866"
  • "mcxn537"
  • "mcxe316"
  • "mimxrt555s"
  • "mcxa344"
  • "kw47z420b2"
  • "kw45b41z5"
  • "lpc5512"
  • "mcxw236"
  • "kw47b42z83"
  • "mc56f81768"
  • "lpc5526"
  • "mcxl255"
  • "mcxa343"
  • "mcxc142"
  • "lpc55s16"
  • "mcxa346"
  • "mcxa142"
  • "mc56f81668"
  • "mcxn247"
  • "mcxa365"
  • "kw47b42zb6"
  • "mcxc243"
  • "kw47b42z96"
  • "mcxw235"
  • "lpc55s26"
  • "mcxc041"
  • "mcxn536"
  • "mcxa366"
  • "mcxn946"
  • "mcxa265"
  • "mcxc143"
  • "mcxn547"
  • "mcxn235"
  • "lpc55s04"
  • "mcxw716a"
  • "mcxa144"
  • "rw612"
  • "mcxa155"
  • "mcxa255"
  • "mimxrt533s"
  • "kw45b41z8"
  • "lpc553x"
  • "rt5xx"
  • "lpc55s6x"
  • "lpc551x"
  • "mcxe24x"
  • "nhs52sxx"
  • "lpc55s0x"
  • "mwct2x12"
  • "mcxn23x"
  • "kw47xx"
  • "lpc552x"
  • "k32w1xx"
  • "mc56f818xx"
  • "lpc55s3x"
  • "rt6xx"
  • "mwct2xd2"
  • "lpc550x"
  • "mcxn94x"
  • "rt7xx"
  • "mcxn54x"
  • "mcxw71xx"
  • "mc56f817xx"
  • "lpc55s1x"
  • "mcxa1xx"
  • "mc56f816xx"
  • "lpc55s2x"
  • "mcxn9xx"
  • "rw61x"
  • "kw45xx"

root revision

MCU revision

Type: enum (of string)

Revision of silicon. The 'latest' name, means most current revision.

Must be one of:

  • "a0"
  • "latest"

root outputImageExecutionTarget

Application target

Type: enum (of string)

Definition if application is Execute in Place(XiP) or loaded to RAM during reset sequence.

Must be one of:

  • "xip"
  • "load-to-ram"
  • "Internal flash (XIP)"
  • "External flash (XIP)"
  • "Internal Flash (XIP)"
  • "External Flash (XIP)"
  • "RAM"
  • "ram"

root outputImageAuthenticationType

Type of boot image authentication

Type: enum (of string)

Specification of final master boot image authentication.

Must be one of:

  • "plain"
  • "crc"
  • "signed"
  • "signed-encrypted"
  • "signed-nxp"
  • "nxp_signed"
  • "nbu-signed"
  • "Plain"
  • "CRC"
  • "Signed"
  • "Encrypted + Signed"
  • "NXP Signed"
  • "NXP signed"
  • "NBU Signed"
  • "encrypted"

root masterBootOutputFile

Output Image name

Type: stringFormat: file_name

The path for result binary file.

root inputImageFile

Plain application image

Type: stringFormat: file

The input application image to by modified to Master Boot Image.

root trustZonePresetFile

TrustZone Customization file in version 2

Type: stringFormat: optional_file

Specification of Trust Zone configuration file for advanced settings. It could be as YAML TrustZone configuration file as pre-prepared binary TrustZone configuration.

root outputImageExecutionAddress

Loading address of application

Type: number or string

Application loading address in RAM if not XiP, otherwise address of load in XiP.

root imageVersion

Image version.

Type: number or stringFormat: number

Image version is used for dual boot. The boot ROM decides which image to boot first based on the image version. It boots the one with the newer image version first, and in case of a failure, it boots the older one.

root add_crc_check

The additional CRC images check

Type: boolean

If true, add additional CRC image that is computed from all data execution mage and optionally TrustZone.

root srk_set

Super Root Key (SRK) set

Type: enum (of string)

Defines which set is used to authenticate the container.

Must be one of:

  • "oem"
  • "nxp"

root used_srk_id

Used SRK

Type: number or stringFormat: number

Which key from SRK set is being used.

root fuse_version

Fuse version

Type: number or stringFormat: number

The value must be equal or greater than the version stored in fuses or PFR to provide proper rollback protection. For example, on the MCXN556s series, the fuse version is used for rollback protection, where it is joined with the image version to create a firmware version 'fwversion = (imageVersion << 8) | (fuseversion)'. During rollback protection, the firmware version is checked against 'SECUREFWVERSION' in the CFPA page.

root signer

AHAB container signer

Type: string

Signature provider configuration in format 'type=<identifier>;<key1>=<value1>;<key2>=<value2>' or a private key used for sign the container header. Header can be signed by SRK. The referenced SRK must not have been revoked.

root signer_#2

AHAB container signer for second signature (PQC only)

Type: string

Signature provider configuration in format 'type=<identifier>;<key1>=<value1>;<key2>=<value2>' or a private key used for second sign (PQC only) of the container header. Header can be signed by SRK. The referenced SRK must not have been revoked.

root srk_table

SRK Table

Type: object

SRK (Super Root key) table definition.

root srk_table flag_ca

CA Flag

Type: boolean

CA Flag is used by HAB to indicate if the SRK is allowed to sign other keys

root srk_table srk_array

Super Root Key (SRK) table

Type: array of string

Table containing the used SRK records. All SRKs must be of the same type. Supported signing algorithms are: RSA-PSS, ECDSA, Dilithium or SM2. Supported hash algorithms: sha256, sha384, sha512, sha3256, sha3384, sha3_512, sm3. Supported key sizes/curves: prime256v1, sec384r1, sec512r1, rsa2048, rsa4096, dilithium3, sm2. Certificate may be of Certificate Authority. Dilithium algorithms are supported just in new type of AHAB container

Must contain a minimum of 4 items

Must contain a maximum of 4 items

No Additional Items

Each item of this array must be:

root srk_table srk_array SRK key

SRK key

Type: stringFormat: file

Path to SRK Key file.

root srk_table srk_table_#2

Second SRK Table

Type: object

root srk_table srk_table_#2 flag_ca

CA Flag

Type: boolean

CA Flag is used by HAB to indicate if the SRK is allowed to sign other keys

root srk_table srk_table_#2 srk_array

Super Root Key (SRK) table

Type: array of string

Table containing the used SRK Dilithium records. All SRKs must be of the same type. Supported signing algorithms are: Dilithium level 3. Supported hash algorithms: sha3256, sha3384, sha3_512. Certificate may be of Certificate Authority.

Must contain a minimum of 4 items

Must contain a maximum of 4 items

No Additional Items

Each item of this array must be:

root srk_table srk_table_#2 srk_array SRK key

SRK key

Type: stringFormat: file

Path to SRK Key file.

root certificate

The AHAB certificate

Type: stringFormat: file

The file that contains AHAB certificate. It could be used already prepared binary form signed by SRK, or it is possible to use configuration YAML file of certificate and the AHAB export process it will export it itself.

root image_hash_type

Images HASH type

Type: enum (of string)

HASH type of image.

Must be one of:

  • "sha256"
  • "sha384"
  • "sha512"

root core_id

Target Core ID

Type: enum (of string)

Target core id to select kind of image.

Must be one of:

  • "cortex-m33"
  • "nbu"