Listing manifest hierarchy

nRF Util

tags
nRF Util

The following command prints the hierarchy of the manifests for the provided nordic-top.suit envelope file:

nrfutil suit envelope-hierarchy --envelope-file nordic-top.suit

This subcommand lists the root manifest, and then manifests of the dependencies (and dependencies of those, if any). This command prints output similar to the following one:

root:
  version: 1
  sequence_number: 1
  component_id: INSTLD_MFST/0xf03d385ea7315605b15d037f6da6097f (nRF54H20_nordic_top)
  digest:
    algorithm_id: sha256
    bytes: 68b3b7a8e2be6d46ab1d21fa463a649c0f03a74951bc733930717840b91e2fa1
  common:
    components:
    - CAND_MFST/0
    - INSTLD_MFST/0xd96b40b7092b5cd1a59f9af80c337eba (nRF54H20_sec)
    - INSTLD_MFST/0xc08a25d735e6592cb7ad43acc8d1d1c8 (nRF54H20_sys)
    dependencies:
    - CAND_MFST/0
    - INSTLD_MFST/0xd96b40b7092b5cd1a59f9af80c337eba (nRF54H20_sec)
    - INSTLD_MFST/0xc08a25d735e6592cb7ad43acc8d1d1c8 (nRF54H20_sys)
  integrated_dependencies: []

In this output:

  • version - version of the manifest format; corresponds to suit-manifest-version.
  • sequence_number - used as anti-rollback counter; corresponds to suit-manifest-sequence-number.
  • component_id - references suit-components that are to be targeted by the manifest.
  • digest - calculated over the manifest.
  • common - components - IDs for all components from suit-components. Component IDs are interpreted using Nordic conventions. Any component IDs that do not match known conventions are printed out in their raw format as lists of hex encoded bytestrings.
  • common - dependencies - IDs for components from suit-components that are to be treated as Dependency Manifest Envelopes.