Core#
Secure Engine Manager Core API.
API for initialization of SE Manager and SE command context with yield attribute.
Modules#
Functions#
Initialize the SE Manager.
Denitialize the SE Manager.
Set the yield attribute of the SE command context object.
From VSE mailbox read which command, if any, was executed.
Acknowledge and get status and output data of a completed command.
Initialize an SE command context object.
De-initialize an SE command context.
Macros#
Context initialization values.
Function Documentation#
sl_se_init#
sl_status_t sl_se_init (void )
Initialize the SE Manager.
| N/A |
Initialize the SE Manager by checking hardware availability and setting up internal module specific resources like mutexes etc.
Returns
Status code, sl_status.h.
89 of file platform/security/sl_component/se_manager/inc/sl_se_manager.hsl_se_deinit#
sl_status_t sl_se_deinit (void )
Denitialize the SE Manager.
| N/A |
Free resources held by the SE Manager.
Returns
Status code, sl_status.h.
101 of file platform/security/sl_component/se_manager/inc/sl_se_manager.hsl_se_set_yield#
sl_status_t sl_se_set_yield (sl_se_command_context_t * cmd_ctx, bool yield)
Set the yield attribute of the SE command context object.
| [inout] | cmd_ctx | Pointer to an SE command context object. |
| [in] | yield | The user may set this parameter to true in order to tell the SE Manager to yield the cpu core while waiting for the SE mailbox command to complete. If false, the SE Manager will busy-wait, by polling the SE mailbox response register until the SE mailbox command completes. |
Returns
Status code, sl_status.h.
120 of file platform/security/sl_component/se_manager/inc/sl_se_manager.hsl_se_read_executed_command#
sl_status_t sl_se_read_executed_command (sl_se_command_context_t * cmd_ctx)
From VSE mailbox read which command, if any, was executed.
| [inout] | cmd_ctx | Pointer to an SE command context object. If this function returns SL_STATUS_OK the command word of the SE command context object will be set. |
Returns
Status code, sl_status.h.
136 of file platform/security/sl_component/se_manager/inc/sl_se_manager.hsl_se_ack_command#
sl_status_t sl_se_ack_command (sl_se_command_context_t * cmd_ctx)
Acknowledge and get status and output data of a completed command.
| [inout] | cmd_ctx | Pointer to an SE command context object. |
This function acknowledges and gets the status and output data of a completed mailbox command. The acknowledge operation invalidates the contents of the output mailbox. The output data is copied into the linked list of output buffers pointed to in the given command data structure.
Returns
Status code, sl_status.h.
154 of file platform/security/sl_component/se_manager/inc/sl_se_manager.hsl_se_init_command_context#
sl_status_t sl_se_init_command_context (sl_se_command_context_t * cmd_ctx)
Initialize an SE command context object.
| [inout] | cmd_ctx | Pointer to an SE command context object to be initialized. This context object should be used in subsequent calls to the SE Manager API in order to execute SE mailbox commands. The same command context object cannot be used concurrently, e.g. by two different threads. However a command context object may be reused for the next and any subsequent mailbox operatons, except when streaming commands are in progress in which case only streaming commands of the same operation type is allowed until the streaming operation is finished (i.e. the corresponding sl_se_xxx_finish is called). |
Initialize an SE command context which can be used in subsequent calls to the SE Manager API in order to execute SE mailbox commands.
Returns
Status code, sl_status.h.
178 of file platform/security/sl_component/se_manager/inc/sl_se_manager.hsl_se_deinit_command_context#
sl_status_t sl_se_deinit_command_context (sl_se_command_context_t * cmd_ctx)
De-initialize an SE command context.
| [inout] | cmd_ctx | Pointer to an SE command context object to deinitialize. |
De-initialize an SE command context object.
Returns
Status code, sl_status.h.
193 of file platform/security/sl_component/se_manager/inc/sl_se_manager.hMacro Definition Documentation#
SL_SE_COMMAND_CONTEXT_INIT#
#define SL_SE_COMMAND_CONTEXT_INITValue:
{ SLI_SE_MAILBOX_COMMAND_DEFAULT(0), false }Context initialization values.
Some of the context values are not fully initialized. The user will need to call the corresponding initialization function in order to fully initialize the context objects for further use in the SE Manager API. The purpose of these initialization values is to set the context objects to a known safe state initially when the context object is declared.
456 of file platform/security/sl_component/se_manager/inc/sl_se_manager_defines.h