tegra_se.h

前往此文件文档。

/*
 * 版权所有 (c) 2020-2021，NVIDIA Corporation。保留所有权利。
 *
 * 特此授权，免费授予任何获得本软件和相关文档文件（“软件”）副本的人员
 * 在软件中进行交易，不受限制，包括但不限于权利
 * 使用、复制、修改、合并、发布、分发、再许可和/或销售
 * 软件副本，并允许向其提供软件的人员
 * 在以下条件下这样做：
 *
 * 上述版权声明和本许可声明应包含在
 * 软件的所有副本或主要部分中。
 *
 * 本软件按“原样”提供，不提供任何形式的明示或
 * 暗示保证，包括但不限于适销性保证，
 * 适用于特定用途和不侵权。在任何情况下，作者或版权持有人均不对任何索赔、损害或其他
 * 责任负责，无论是在合同、侵权行为或其他方面的诉讼中，由以下原因引起、
 * 由于或与软件或使用或软件中的其他交易相关。
 * 软件。
 */

 */

#ifndef __TEGRA_SE_H__
#define __TEGRA_SE_H__

#include <tegra_se_internal.h>

/*
 * @brief 获取 SE 硬件互斥锁并初始化 SE 驱动程序
 *
 * @return 如果成功，则返回 NO_ERROR
 *
 * @note 此函数应始终在与 SE 交互之前调用
 * 与 SE 交互
 */
uint32_t se_acquire(void);

/*
 * @brief 释放 SE 硬件
 *
 * @return 如果成功，则返回 NO_ERROR
 *
 * @note 此函数应始终在与 SE 交互后调用
 * 与 SE 交互
 */
void se_release(void);

/*
 * @brief 从 SE 密钥槽派生根密钥
 *
 * @param *root_key [out] 根密钥将写入此缓冲区
 * @param root_key_len [in] root_key 缓冲区的长度
 * @param *fv [in] 固定向量 (fv) 的基地址
 * @param fv_len [in] 固定向量的长度
 * @param keyslot [in] 根密钥源的密钥槽索引
 *
 * @return 如果成功，则返回 NO_ERROR
 */
uint32_t se_derive_root_key(uint8_t *root_key, size_t root_key_len, uint8_t *fv,
 size_t fv_len, uint32_t keyslot);

/*
 * @brief: 将密钥写入 SE 密钥槽
 *
 * @param *key_in [in] 密钥的基地址
 * @param keylen [in] 密钥长度
 * @param key_quad_sel [in] 密钥 QUAD 选择
 * @param keyslot [in] 密钥槽索引
 *
 * @return 如果成功，则返回 NO_ERROR
 */
int se_write_keyslot(uint8_t *key_in, uint32_t keylen, uint32_t key_quad_sel, uint32_t keyslot);

/*
 * @brief 清除保存密钥的 SE 密钥槽
 *
 * @return 如果成功，则返回 NO_ERROR
 *
 * @note 应始终调用此函数，以使密钥不会
 * 在 SE 密钥槽中持久存在。
 */
uint32_t se_clear_aes_keyslots(void);

typedef struct tegra_se_cmac_context se_cmac_ctx;

se_cmac_ctx *tegra_se_cmac_new(void);

void tegra_se_cmac_free(se_cmac_ctx *se_cmac);

int tegra_se_cmac_init(se_cmac_ctx *se_cmac, se_aes_keyslot_t keyslot,
 uint32_t keylen);
int tegra_se_cmac_update(se_cmac_ctx *se_cmac, void *data, uint32_t dlen);

int tegra_se_cmac_final(se_cmac_ctx *se_cmac, uint8_t *out, uint32_t *poutlen);

int se_nist_sp_800_108_with_cmac(se_aes_keyslot_t keyslot,
 uint32_t key_len,
 char const *context,
 char const *label,
 uint32_t dk_len,
 uint8_t *out_dk);

#endif /* __TEGRA_SE_H__ */