Libtropic API
SDK for the TROPIC01 secure element
Version: master (latest)
Loading...
Searching...
No Matches

◆ lt_ret_t

enum lt_ret_t
Note
Specific values are given for easier lookup of values.
Enumerator
LT_OK 

Operation was successful.

LT_FAIL 

Operation was not successful.

LT_PARAM_ERR 

Some parameter was not accepted by function.

LT_CRYPTO_ERR 

Error detected during cryptographic operation.

LT_APP_FW_TOO_NEW 

TROPIC01's Application FW is too new for the current version of Libtropic. Please update Libtropic to a newer release version.

LT_REBOOT_UNSUCCESSFUL 

TROPIC01 executed the Startup_Req L2 Request (invoked by calling lt_reboot()) successfully, but the mode TROPIC01 is in after the reboot is not the expected one based on the startup_id argument:

  • startup_id==TR01_REBOOT and TROPIC01's mode after successful reboot is not LT_TR01_APPLICATION (this can e.g. happen when the chip, for some reason, cannot execute the Application FW - it will stay in Start-up Mode no matter the startup_id), or
  • startup_id==TR01_MAINTENANCE_REBOOT and TROPIC01's mode after successful reboot is not LT_TR01_MAINTENANCE.
LT_L1_SPI_ERROR 

Some SPI related operation was not successful.

LT_L1_DATA_LEN_ERROR 

Data does not have an expected length.

LT_L1_CHIP_STARTUP_MODE 

Chip is in STARTUP mode.

LT_L1_CHIP_ALARM_MODE 

Chip is in ALARM mode.

LT_L1_CHIP_BUSY 

Chip is BUSY - typically chip is still booting.

LT_L1_INT_TIMEOUT 

Interrupt pin did not fire as expected.

LT_L3_SLOT_NOT_EMPTY 

L3 result [API R_Mem_Data_Write]: The target slot is already written.

LT_L3_SLOT_EXPIRED 

L3 result [API R_Mem_Data_Write]: The target FLASH slot has expired.

LT_L3_INVALID_KEY 

L3 result [API EDDSA_Sign, ECDSA_Sign, ECC_Key_Read]: The key in selected slot is invalid or corrupted.

LT_L3_UPDATE_ERR 

L3 result [API MCounter_Update]: Update operation failed (i.e. mcounter done at 0).

LT_L3_COUNTER_INVALID 

L3 result [API MCounter_Update, MCounter_Get]: The Monotonic Counter is disabled or locked.

LT_L3_SLOT_EMPTY 

L3 result [API Pairing_Key_Read]: The requested slot is empty and contains no valid data.

LT_L3_SLOT_INVALID 

L3 result [API Pairing_Key_Read]: The slot content is invalidated.

LT_L3_OK 

L3 Command successfully executed.

LT_L3_FAIL 

Error during processing of the L3 command.

LT_L3_UNAUTHORIZED 

Insufficient User Access Privileges.

LT_L3_INVALID_CMD 

Unknown L3 Command packet.

LT_L3_HARDWARE_FAIL 

L3 result [API Pairing_Key_Write, Pairing_Key_Invalidate, R_Config_Write, I_Config_Write, R_Mem_Data_Write]: A hardware error occurred during a write operation.

LT_L3_DATA_LEN_ERROR 

L3 data does not have an expected length.

LT_L3_RES_SIZE_ERROR 

L3 response RES_SIZE have an invalid size.

This can be caused by an attack or a bug.

LT_L3_BUFFER_TOO_SMALL 

L3 buffer is too small to parse this L3 command.

If this error is raised, either the buffer is too small to accept the result, or RES_SIZE field in the response is invalid (attack or a bug).

LT_L3_R_MEM_DATA_READ_SLOT_EMPTY 

User slot is empty.

LT_L3_RESULT_UNKNOWN 

Unknown L3 RESULT value.

LT_L2_REQ_CONT 

There is more than one chunk to be expected for a current request.

LT_L2_RES_CONT 

There is more than one chunk to be received for a current response.

LT_L2_RESP_DISABLED 

The L2 Request frame is disabled and can’t be executed.

LT_L2_HSK_ERR 

There were an error during handshake establishing.

LT_L2_NO_SESSION 

There is no secure session.

LT_L2_TAG_ERR 

There were error during checking message authenticity.

LT_L2_CRC_ERR 

l2 request contained crc error

LT_L2_GEN_ERR 

There were some other error.

LT_L2_NO_RESP 

Chip has no response to be transmitted.

LT_L2_UNKNOWN_REQ 

ID of last request is not known to TROPIC01.

LT_L2_IN_CRC_ERR 

l2 response frame contains CRC error

LT_L2_RSP_LEN_ERROR 

L2 data does not have an expected length (invalid value in RSP_LEN field)

LT_L2_STATUS_UNKNOWN 

Unknown L2 STATUS value.

LT_CERT_STORE_INVALID 

Certificate store likely does not contain valid data.

LT_CERT_UNSUPPORTED 

Certificate store contains ASN1-DER syntax that is beyond the supported subset.

LT_CERT_ITEM_NOT_FOUND 

Certificate does not contain requested item.

LT_NONCE_OVERFLOW 

The nonce has reached its maximum value.

LT_RET_T_LAST_VALUE 

Special helper value used to signalize the last enum value, used in lt_ret_verbose.