sdrv_crypto_mailbox_basic_mgmt.h File Reference

#include "sdrv_crypto_mailbox_common.h"

Go to the source code of this file.

Data Structures
struct	cmd_get_device_info_t
struct	cmd_get_device_status_t
struct	cmd_rng_t
struct	cmd_generate_key_t
struct	cmd_failure_analysis_t
struct	cmd_self_destroy_t
struct	cmd_seip_jump_t
struct	cmd_seip_disable_t
struct	cmd_sensor_clk_cfg_t

Functions
sdrv_crypto_error_status_e	cmd_get_device_info (uint16_t key_id, uint32_t *device_info_buf, uint8_t *mac_buf)
sdrv_crypto_error_status_e	cmd_get_device_status (uint16_t key_id, uint32_t *device_status_buf, uint8_t *mac_buf)
sdrv_crypto_error_status_e	cmd_get_ske_hmac_256bit_key (uint16_t key_id, uint32_t *key, uint8_t *mac_buf)
sdrv_crypto_error_status_e	cmd_key_self_destroy (uint8_t *mac_buf)
sdrv_crypto_error_status_e	cmd_jump (uint32_t addr, uint8_t *mac_buf)
sdrv_crypto_error_status_e	cmd_disable_seip (void)
sdrv_crypto_error_status_e	cmd_sensor_clk_cfg (uint32_t reg_addr, uint32_t reg_value, uint32_t reg_max_value, uint32_t reg_min_value)

Detailed Description

Copyright

Copyright (c) 2021 Semidrive Semiconductor. All rights reserved.

Function Documentation

cmd_disable_seip()

sdrv_crypto_error_status_e cmd_disable_seip

(

void

)

disable seip

This function disable seip, pincode used for auth

Returns

CMD_RETURN_SUCCESS or error code.

cmd_get_device_info()

sdrv_crypto_error_status_e cmd_get_device_info	(	uint16_t	key_id,
		uint32_t *	device_info_buf,
		uint8_t *	mac_buf
	)

get device info.

This function get ehsm device info.

Parameters

[in]	key_id	internel key id, use for encrypt device info.
[in]	mac_buf	for auth.
[out]	device_info_buff	out buff.

Returns

CMD_RETURN_SUCCESS or error code.

cmd_get_device_status()

sdrv_crypto_error_status_e cmd_get_device_status	(	uint16_t	key_id,
		uint32_t *	device_status_buf,
		uint8_t *	mac_buf
	)

get device status.

This function get ehsm device status.

Parameters

[in]	key_id	internel key id, use for encrypt device status.
[in]	mac_buf	for auth.
[out]	device_status_buff	out buff.

Returns

CMD_RETURN_SUCCESS or error code.

cmd_get_ske_hmac_256bit_key()

sdrv_crypto_error_status_e cmd_get_ske_hmac_256bit_key	(	uint16_t	key_id,
		uint32_t *	key,
		uint8_t *	mac_buf
	)

get 256bit random key.

This function get 256bit random key use for ske or hmac, key_id must != 0.

Parameters

[in]	key_id	internel key id, use for encrypt random key.
[in]	mac_buf	for auth.
[out]	key	out buff.

Returns

CMD_RETURN_SUCCESS or error code.

cmd_jump()

sdrv_crypto_error_status_e cmd_jump	(	uint32_t	addr,
		uint8_t *	mac_buf
	)

jump to addr run

This function can set seip run addr, after set seip will jump to run

Parameters

[in]	addr	addr for seip run start
[in]	mac_buf	for auth

Returns

CMD_RETURN_SUCCESS or error code.

cmd_key_self_destroy()

sdrv_crypto_error_status_e cmd_key_self_destroy

(

uint8_t *

mac_buf

)

self destroy.

This function can destroy SSRK, this cmd only work when seip on high secure status.

Parameters

[in]

mac_buf

for auth.

Returns

CMD_RETURN_SUCCESS or error code.

cmd_sensor_clk_cfg()

sdrv_crypto_error_status_e cmd_sensor_clk_cfg	(	uint32_t	reg_addr,
		uint32_t	reg_value,
		uint32_t	reg_max_value,
		uint32_t	reg_min_value
	)

set sensor clk

This function config sensor clk, for protect seip

Parameters

[in]	reg_addr	sensor clk reg addr
[in]	reg_value	value
[in]	reg_max_value	max value
[in]	reg_min_value	min value

Returns

CMD_RETURN_SUCCESS or error code.