Read the information about the manifest, that was used to boot the system.
In the SUIT-based system, the firmware is identified by its digest. There is no semantic version attached to the firmware. This function allows to inform an application about the current revision and digest of the manifest. This data may be forwarded to the tools that would like to read the device state.
- Parameters
-
[in] | manifest_class_id | Manifest class ID. |
[out] | seq_num | Pointer to the memory to store the current root manifest sequence number value. |
[out] | version | Manifest semantic version. |
[out] | status | Digest verification status |
[out] | alg_id | ID of an algorithm that was used to calculate the digest. |
[out] | digest | Pointer to the memory to store the digest of the current root manifest value. |
- Return values
-
SUIT_PLAT_SUCCESS | if successful. |
SUIT_PLAT_ERR_INVAL | if input parameters are invalid. |
SUIT_PLAT_ERR_SIZE | if the manifest version output buffer is too small. |
SUIT_PLAT_ERR_NOMEM | if the manifest digest output buffer is too small. |
SUIT_PLAT_ERR_HW_NOT_READY | if device manging SUIT storage is not initialized. |
SUIT_PLAT_ERR_BUSY | if SUIT decoder is currently busy. |
SUIT_PLAT_ERR_NOT_FOUND | if SUIT storage does not contain a valid manifest with the specified class ID. |
SUIT_PLAT_ERR_IPC | in case of SSF protocol error. |