MBI-A-F-EABF

Type: object

Flash Configuration Field settings. Default values are always loaded from application first.
FCF can be provided in one of three ways:
1. As a nested dictionary under the 'fcf' key - copy values directly from the FCF.YAML template
2. As a path to a YAML file containing FCF configuration - use 'fcf: path/to/fcf.yaml'
3. As a path to a binary FCF file - use 'fcf: path/to/fcf.bin'

If any FCF configuration is provided, it will update the application values accordingly. The binary option completely replaces the FCF content, while the YAML and dictionary options selectively update FCF register values.

root family

The chip family name

Type: enum (of string)

NXP chip family identifier.

Must be one of:

  • "k32w148"
  • "k32w148"
  • "k32w148"
  • "kw45b41z5"
  • "kw45b41z5"
  • "kw45b41z5"
  • "kw45b41z8"
  • "kw45b41z8"
  • "kw45b41z8"
  • "kw45z41052"
  • "kw45z41052"
  • "kw45z41052"
  • "kw45z41053"
  • "kw45z41053"
  • "kw45z41053"
  • "kw45z41082"
  • "kw45z41082"
  • "kw45z41082"
  • "kw45z41083"
  • "kw45z41083"
  • "kw45z41083"
  • "kw47b42z83"
  • "kw47b42z83"
  • "kw47b42z96"
  • "kw47b42z96"
  • "kw47b42z97"
  • "kw47b42z97"
  • "kw47b42zb2"
  • "kw47b42zb2"
  • "kw47b42zb3"
  • "kw47b42zb3"
  • "kw47b42zb6"
  • "kw47b42zb6"
  • "kw47b42zb7"
  • "kw47b42zb7"
  • "kw47z42082"
  • "kw47z42082"
  • "kw47z42092"
  • "kw47z42092"
  • "kw47z420b2"
  • "kw47z420b2"
  • "kw47z420b3"
  • "kw47z420b3"
  • "lpc5502"
  • "lpc5504"
  • "lpc5506"
  • "lpc5512"
  • "lpc5514"
  • "lpc5516"
  • "lpc5526"
  • "lpc5526"
  • "lpc5528"
  • "lpc5528"
  • "lpc5534"
  • "lpc5534"
  • "lpc5536"
  • "lpc5536"
  • "lpc55s04"
  • "lpc55s06"
  • "lpc55s14"
  • "lpc55s16"
  • "lpc55s26"
  • "lpc55s26"
  • "lpc55s28"
  • "lpc55s28"
  • "lpc55s36"
  • "lpc55s36"
  • "lpc55s66"
  • "lpc55s66"
  • "lpc55s69"
  • "lpc55s69"
  • "mc56f81646"
  • "mc56f81648"
  • "mc56f81666"
  • "mc56f81668"
  • "mc56f81746"
  • "mc56f81748"
  • "mc56f81766"
  • "mc56f81768"
  • "mc56f81866"
  • "mc56f81868"
  • "mcxa132"
  • "mcxa133"
  • "mcxa142"
  • "mcxa143"
  • "mcxa144"
  • "mcxa145"
  • "mcxa146"
  • "mcxa152"
  • "mcxa153"
  • "mcxa154"
  • "mcxa155"
  • "mcxa156"
  • "mcxa275"
  • "mcxa276"
  • "mcxa345"
  • "mcxa346"
  • "mcxa355"
  • "mcxa356"
  • "mcxc041"
  • "mcxc141"
  • "mcxc142"
  • "mcxc143"
  • "mcxc144"
  • "mcxc242"
  • "mcxc243"
  • "mcxc244"
  • "mcxc443"
  • "mcxc444"
  • "mcxn235"
  • "mcxn236"
  • "mcxn546"
  • "mcxn546"
  • "mcxn547"
  • "mcxn547"
  • "mcxn946"
  • "mcxn946"
  • "mcxn947"
  • "mcxn947"
  • "mcxw235"
  • "mcxw236"
  • "mcxw716a"
  • "mcxw716a"
  • "mcxw716a"
  • "mcxw716c"
  • "mcxw716c"
  • "mcxw716c"
  • "mcxw727a"
  • "mcxw727a"
  • "mcxw727c"
  • "mcxw727c"
  • "mcxw727d"
  • "mcxw727d"
  • "mimxrt533s"
  • "mimxrt533s"
  • "mimxrt555s"
  • "mimxrt555s"
  • "mimxrt595s"
  • "mimxrt595s"
  • "mimxrt685s"
  • "mimxrt685s"
  • "mimxrt735s"
  • "mimxrt735s"
  • "mimxrt735s"
  • "mimxrt758s"
  • "mimxrt758s"
  • "mimxrt758s"
  • "mimxrt798s"
  • "mimxrt798s"
  • "mimxrt798s"
  • "mwct2012"
  • "mwct2012a"
  • "mwct20d2"
  • "mwct20d2a"
  • "nhs52s04"
  • "rw610"
  • "rw610"
  • "rw612"
  • "rw612"
  • "k32w1xx"
  • "kw45xx"
  • "kw47xx"
  • "lpc550x"
  • "lpc551x"
  • "lpc552x"
  • "lpc553x"
  • "lpc55s0x"
  • "lpc55s1x"
  • "lpc55s2x"
  • "lpc55s3x"
  • "lpc55s6x"
  • "mc56f816xx"
  • "mc56f817xx"
  • "mc56f818xx"
  • "mcxa1xx"
  • "mcxn23x"
  • "mcxn9xx"
  • "mcxn94x"
  • "mcxw71xx"
  • "rt5xx"
  • "rt6xx"
  • "rt7xx"
  • "mwct2x12"
  • "mwct2xd2"
  • "nhs52sxx"
  • "rw61x"

root revision

MCU revision

Type: enum (of string)

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

Must be one of:

  • "b1"
  • "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"
  • "Plain"
  • "CRC"
  • "Signed"
  • "Encrypted + Signed"
  • "NXP Signed"
  • "NXP 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 fcf

root fcf oneOf mc56f81866

mc56f81866

Type: object

root fcf oneOf mc56f81866 BACKDOOR_KEY

BACKDOOR_KEY


Offset: 0x00000000, Width: 64b; Backdoor key bytes

root fcf oneOf mc56f81866 BACKDOOR_KEY oneOf item 0
Type: string or number
root fcf oneOf mc56f81866 BACKDOOR_KEY oneOf item 1
Type: object
No Additional Properties

root fcf oneOf mc56f81866 BACKDOOR_KEY oneOf item 1 value
Type: string or number

root fcf oneOf mc56f81866 BackdoorKey

BACKDOOR_KEY


Offset: 0x00000000, Width: 64b; Backdoor key bytes

root fcf oneOf mc56f81866 BackdoorKey oneOf item 0
Type: string or number
root fcf oneOf mc56f81866 BackdoorKey oneOf item 1
Type: object
No Additional Properties

root fcf oneOf mc56f81866 BackdoorKey oneOf item 1 value
Type: string or number

root fcf oneOf mc56f81866 FLASH_PROTECTION

FLASH_PROTECTION


Offset: 0x00000008, Width: 32b; Flash protection bytes

root fcf oneOf mc56f81866 FLASH_PROTECTION oneOf item 0
Type: string or number
root fcf oneOf mc56f81866 FLASH_PROTECTION oneOf item 1
Type: object
No Additional Properties

root fcf oneOf mc56f81866 FLASH_PROTECTION oneOf item 1 value
Type: string or number

root fcf oneOf mc56f81866 FlashProtection

FLASH_PROTECTION


Offset: 0x00000008, Width: 32b; Flash protection bytes

root fcf oneOf mc56f81866 FlashProtection oneOf item 0
Type: string or number
root fcf oneOf mc56f81866 FlashProtection oneOf item 1
Type: object
No Additional Properties

root fcf oneOf mc56f81866 FlashProtection oneOf item 1 value
Type: string or number

root fcf oneOf mc56f81866 LIFECYCLE

LIFECYCLE


Offset: 0x0000000C, Width: 8b; DSA Secure Lifecycle state

root fcf oneOf mc56f81866 LIFECYCLE oneOf item 0
Type: string or number
root fcf oneOf mc56f81866 LIFECYCLE oneOf item 1
Type: object
No Additional Properties

root fcf oneOf mc56f81866 LIFECYCLE oneOf item 1 value
Type: string or number
root fcf oneOf mc56f81866 LIFECYCLE oneOf item 2
Type: object
No Additional Properties

root fcf oneOf mc56f81866 LIFECYCLE oneOf item 2 bitfields
Type: object

root fcf oneOf mc56f81866 LIFECYCLE oneOf item 2 bitfields LIFECYCLE_STATE

LIFECYCLE_STATE

Type: string or number

Offset: 0b, Width: 8b, DSA Secure Lifecycle state
- OEMOPENROP0, (254): Most permissive state - full ISP command set available in all conditions
- OEMCLOSEDROP1, (144): Moderate security - partial ISP commands on normal boot, full commands via ROMAPI
- OEMCLOSEDROP2, (149): Higher security - no ISP commands on normal boot, partial commands via ROMAPI or invalid image
- OEMCLOSEDROP3, (155): Very high security - no ISP commands except ReceiveSBFile via ROMAPI for secure devices only
- OEMCLOSEDNORETURN, (107): Maximum security - no ISP commands available in any condition, device cannot be reprogrammed

root fcf oneOf mc56f81866 LIFECYCLE oneOf item 3
Type: object
No Additional Properties

root fcf oneOf mc56f81866 LIFECYCLE oneOf item 3 LIFECYCLE_STATE

LIFECYCLE_STATE

Type: string or number

Offset: 0b, Width: 8b, DSA Secure Lifecycle state
- OEMOPENROP0, (254): Most permissive state - full ISP command set available in all conditions
- OEMCLOSEDROP1, (144): Moderate security - partial ISP commands on normal boot, full commands via ROMAPI
- OEMCLOSEDROP2, (149): Higher security - no ISP commands on normal boot, partial commands via ROMAPI or invalid image
- OEMCLOSEDROP3, (155): Very high security - no ISP commands except ReceiveSBFile via ROMAPI for secure devices only
- OEMCLOSEDNORETURN, (107): Maximum security - no ISP commands available in any condition, device cannot be reprogrammed

root fcf oneOf mc56f81866 field00C

LIFECYCLE


Offset: 0x0000000C, Width: 8b; DSA Secure Lifecycle state

root fcf oneOf mc56f81866 field00C oneOf item 0
Type: string or number
root fcf oneOf mc56f81866 field00C oneOf item 1
Type: object
No Additional Properties

root fcf oneOf mc56f81866 field00C oneOf item 1 value
Type: string or number
root fcf oneOf mc56f81866 field00C oneOf item 2
Type: object
No Additional Properties

root fcf oneOf mc56f81866 field00C oneOf item 2 bitfields
Type: object

root fcf oneOf mc56f81866 field00C oneOf item 2 bitfields LIFECYCLE_STATE

LIFECYCLE_STATE

Type: string or number

Offset: 0b, Width: 8b, DSA Secure Lifecycle state
- OEMOPENROP0, (254): Most permissive state - full ISP command set available in all conditions
- OEMCLOSEDROP1, (144): Moderate security - partial ISP commands on normal boot, full commands via ROMAPI
- OEMCLOSEDROP2, (149): Higher security - no ISP commands on normal boot, partial commands via ROMAPI or invalid image
- OEMCLOSEDROP3, (155): Very high security - no ISP commands except ReceiveSBFile via ROMAPI for secure devices only
- OEMCLOSEDNORETURN, (107): Maximum security - no ISP commands available in any condition, device cannot be reprogrammed

root fcf oneOf mc56f81866 field00C oneOf item 3
Type: object
No Additional Properties

root fcf oneOf mc56f81866 field00C oneOf item 3 LIFECYCLE_STATE

LIFECYCLE_STATE

Type: string or number

Offset: 0b, Width: 8b, DSA Secure Lifecycle state
- OEMOPENROP0, (254): Most permissive state - full ISP command set available in all conditions
- OEMCLOSEDROP1, (144): Moderate security - partial ISP commands on normal boot, full commands via ROMAPI
- OEMCLOSEDROP2, (149): Higher security - no ISP commands on normal boot, partial commands via ROMAPI or invalid image
- OEMCLOSEDROP3, (155): Very high security - no ISP commands except ReceiveSBFile via ROMAPI for secure devices only
- OEMCLOSEDNORETURN, (107): Maximum security - no ISP commands available in any condition, device cannot be reprogrammed

root fcf oneOf mc56f81866 OPTION_BYTE

OPTION_BYTE


Offset: 0x0000000D, Width: 8b; Flash configuration options

root fcf oneOf mc56f81866 OPTION_BYTE oneOf item 0
Type: string or number
root fcf oneOf mc56f81866 OPTION_BYTE oneOf item 1
Type: object
No Additional Properties

root fcf oneOf mc56f81866 OPTION_BYTE oneOf item 1 value
Type: string or number
root fcf oneOf mc56f81866 OPTION_BYTE oneOf item 2
Type: object
No Additional Properties

root fcf oneOf mc56f81866 OPTION_BYTE oneOf item 2 bitfields
Type: object

root fcf oneOf mc56f81866 OPTION_BYTE oneOf item 2 bitfields POWER_MODE

POWER_MODE

Type: string or number

Offset: 0b, Width: 1b, Controls which power mode register takes effect
- SIMPWRMODE, (1): Writing SIMPWRMODE register takes effect, writing SIMPWR register doesn't take effect
- SIMPWR, (0): Writing SIMPWRMODE register doesn't take effect, writing SIMPWR register takes effect

root fcf oneOf mc56f81866 OPTION_BYTE oneOf item 2 bitfields RESERVED_BITS

RESERVED_BITS

Type: string or number

Offset: 1b, Width: 7b, N/A
root fcf oneOf mc56f81866 OPTION_BYTE oneOf item 3
Type: object
No Additional Properties

root fcf oneOf mc56f81866 OPTION_BYTE oneOf item 3 POWER_MODE

POWER_MODE

Type: string or number

Offset: 0b, Width: 1b, Controls which power mode register takes effect
- SIMPWRMODE, (1): Writing SIMPWRMODE register takes effect, writing SIMPWR register doesn't take effect
- SIMPWR, (0): Writing SIMPWRMODE register doesn't take effect, writing SIMPWR register takes effect

root fcf oneOf mc56f81866 OPTION_BYTE oneOf item 3 RESERVED_BITS

RESERVED_BITS

Type: string or number

Offset: 1b, Width: 7b, N/A

root fcf oneOf mc56f81866 OptionByte

OPTION_BYTE


Offset: 0x0000000D, Width: 8b; Flash configuration options

root fcf oneOf mc56f81866 OptionByte oneOf item 0
Type: string or number
root fcf oneOf mc56f81866 OptionByte oneOf item 1
Type: object
No Additional Properties

root fcf oneOf mc56f81866 OptionByte oneOf item 1 value
Type: string or number
root fcf oneOf mc56f81866 OptionByte oneOf item 2
Type: object
No Additional Properties

root fcf oneOf mc56f81866 OptionByte oneOf item 2 bitfields
Type: object

root fcf oneOf mc56f81866 OptionByte oneOf item 2 bitfields POWER_MODE

POWER_MODE

Type: string or number

Offset: 0b, Width: 1b, Controls which power mode register takes effect
- SIMPWRMODE, (1): Writing SIMPWRMODE register takes effect, writing SIMPWR register doesn't take effect
- SIMPWR, (0): Writing SIMPWRMODE register doesn't take effect, writing SIMPWR register takes effect

root fcf oneOf mc56f81866 OptionByte oneOf item 2 bitfields RESERVED_BITS

RESERVED_BITS

Type: string or number

Offset: 1b, Width: 7b, N/A
root fcf oneOf mc56f81866 OptionByte oneOf item 3
Type: object
No Additional Properties

root fcf oneOf mc56f81866 OptionByte oneOf item 3 POWER_MODE

POWER_MODE

Type: string or number

Offset: 0b, Width: 1b, Controls which power mode register takes effect
- SIMPWRMODE, (1): Writing SIMPWRMODE register takes effect, writing SIMPWR register doesn't take effect
- SIMPWR, (0): Writing SIMPWRMODE register doesn't take effect, writing SIMPWR register takes effect

root fcf oneOf mc56f81866 OptionByte oneOf item 3 RESERVED_BITS

RESERVED_BITS

Type: string or number

Offset: 1b, Width: 7b, N/A
root fcf oneOf item 1
Type: stringFormat: file

Path to FCF configuration or binary file