PKE
头文件清单
接口清单
Functions
uapi_drv_cipher_pke_ecc_gen_key
errcode_t uapi_drv_cipher_pke_ecc_gen_key(uapi_drv_cipher_pke_ecc_curve_type_t curve_type, const uapi_drv_cipher_pke_data_t *input_priv_key, const uapi_drv_cipher_pke_data_t *output_priv_key, const uapi_drv_cipher_pke_ecc_point_t *output_pub_key)
头文件清单
功能说明
- 生成ECC密钥对，根据指定的ECC曲线类型生成私钥和公钥
- 输入私钥可以为空指针，为空时由硬件随机生成私钥
- 调用期间会添加睡眠否决标记，防止系统进入深度睡眠，调用结束后移除
前置条件
- PKE模块已通过驱动初始化完成，CONFIG_PKE_SUPPORT_ECC_GEN_KEY宏已开启
- 调用方需确保output_priv_key和output_pub_key指向的缓冲区已申请成功，且长度满足对应曲线的密钥长度要求
入参
名称 参数类型 详细说明 约束取值范围 curve_type uapi_drv_cipher_pke_ecc_curve_type_t ECC曲线类型 UAPI_DRV_CIPHER_PKE_ECC_TYPE_RFC5639_P256(0) ~ UAPI_DRV_CIPHER_PKE_ECC_TYPE_SM2(11) input_priv_key const uapi_drv_cipher_pke_data_t * 输入私钥，可以为空指针 NULL或有效的data指针，length对应曲线密钥长度 output_priv_key const uapi_drv_cipher_pke_data_t * 输出私钥 非NULL，data指向已申请缓冲区，length对应曲线密钥长度 output_pub_key const uapi_drv_cipher_pke_ecc_point_t * 输出公钥 非NULL，x、y指向已申请缓冲区，length对应曲线密钥长度
出参
名称 数据类型 输出说明 output_priv_key uapi_drv_cipher_pke_data_t * 输出的私钥数据 output_pub_key uapi_drv_cipher_pke_ecc_point_t * 输出的公钥数据，包含X坐标和Y坐标
返回值
返回值 文字含义 触发场景 ERRCODE_SUCC(0x00) 执行成功 ECC密钥对生成成功 Other 其他错误码，参考errcode_t 执行失败
Kconfig配置
配置项 宏类型 说明 默认值 CONFIG_PKE_SUPPORT_ECC_GEN_KEY 功能宏 支持ECC密钥对生成功能 y
uapi_drv_cipher_pke_ecdsa_sign
errcode_t uapi_drv_cipher_pke_ecdsa_sign(uapi_drv_cipher_pke_ecc_curve_type_t curve_type, const uapi_drv_cipher_pke_data_t *priv_key, const uapi_drv_cipher_pke_data_t *hash, const uapi_drv_cipher_pke_ecc_sig_t *sig)
头文件清单
功能说明
- 使用ECDSA算法对摘要数据进行椭圆曲线数字签名
- 输入私钥和摘要数据，输出签名值R和S
- 调用期间会添加睡眠否决标记，防止系统进入深度睡眠，调用结束后移除
前置条件
- PKE模块已通过驱动初始化完成
- 调用方需确保priv_key、hash、sig指向的缓冲区已申请成功，且长度满足对应曲线要求
入参
名称 参数类型 详细说明 约束取值范围 curve_type uapi_drv_cipher_pke_ecc_curve_type_t ECC曲线类型 UAPI_DRV_CIPHER_PKE_ECC_TYPE_RFC5639_P256(0) ~ UAPI_DRV_CIPHER_PKE_ECC_TYPE_SM2(11) priv_key const uapi_drv_cipher_pke_data_t * 输入私钥 非NULL，length对应曲线密钥长度 hash const uapi_drv_cipher_pke_data_t * 输入摘要 非NULL，length对应摘要算法输出长度 sig const uapi_drv_cipher_pke_ecc_sig_t * 输出签名 非NULL，r、s指向已申请缓冲区，length对应曲线签名长度
出参
名称 数据类型 输出说明 sig uapi_drv_cipher_pke_ecc_sig_t * 输出的签名值，包含R和S分量
返回值
返回值 文字含义 触发场景 ERRCODE_SUCC(0x00) 执行成功 ECDSA签名成功 Other 其他错误码，参考errcode_t 执行失败
Kconfig配置
配置项 宏类型 说明 默认值 CONFIG_PKE_SUPPORT_ECC_SIGN 功能宏 支持ECC签名功能 y
参考案例
uapi_drv_cipher_pke_ecdsa_verify
errcode_t uapi_drv_cipher_pke_ecdsa_verify(uapi_drv_cipher_pke_ecc_curve_type_t curve_type, const uapi_drv_cipher_pke_ecc_point_t *pub_key, const uapi_drv_cipher_pke_data_t *hash, const uapi_drv_cipher_pke_ecc_sig_t *sig)
头文件清单
功能说明
- 使用ECDSA算法对签名数据进行椭圆曲线数字验签
- 输入公钥、摘要和签名值，验证签名是否合法
- 调用期间会添加睡眠否决标记，防止系统进入深度睡眠，调用结束后移除
前置条件
- PKE模块已通过驱动初始化完成
- 调用方需确保pub_key、hash、sig指向的缓冲区已申请成功，且长度满足对应曲线要求
入参
名称 参数类型 详细说明 约束取值范围 curve_type uapi_drv_cipher_pke_ecc_curve_type_t ECC曲线类型 UAPI_DRV_CIPHER_PKE_ECC_TYPE_RFC5639_P256(0) ~ UAPI_DRV_CIPHER_PKE_ECC_TYPE_SM2(11) pub_key const uapi_drv_cipher_pke_ecc_point_t * 输入公钥 非NULL，x、y指向有效数据，length对应曲线密钥长度 hash const uapi_drv_cipher_pke_data_t * 输入摘要 非NULL，length对应摘要算法输出长度 sig const uapi_drv_cipher_pke_ecc_sig_t * 输入签名 非NULL，r、s指向有效数据，length对应曲线签名长度
返回值
返回值 文字含义 触发场景 ERRCODE_SUCC(0x00) 执行成功 ECDSA验签通过 Other 其他错误码，参考errcode_t 验签失败或执行失败
Kconfig配置
配置项 宏类型 说明 默认值 CONFIG_PKE_SUPPORT_ECC_VERIFY 功能宏 支持ECC验签功能 y 出参
无
参考案例
uapi_drv_cipher_pke_eddsa_sign
errcode_t uapi_drv_cipher_pke_eddsa_sign(uapi_drv_cipher_pke_ecc_curve_type_t curve_type, const uapi_drv_cipher_pke_data_t *priv_key, const uapi_drv_cipher_pke_msg_t *msg, const uapi_drv_cipher_pke_ecc_sig_t *sig)
头文件清单
功能说明
- 使用EdDSA算法对消息数据进行爱德华兹曲线数字签名
- 输入私钥和原始消息（非摘要），输出签名值R和S
- 调用期间会添加睡眠否决标记，防止系统进入深度睡眠，调用结束后移除
前置条件
- PKE模块已通过驱动初始化完成，CONFIG_PKE_SUPPORT_EDWARD宏已开启
- 调用方需确保priv_key、msg、sig指向的缓冲区已申请成功，且长度满足对应曲线要求
入参
名称 参数类型 详细说明 约束取值范围 curve_type uapi_drv_cipher_pke_ecc_curve_type_t ECC曲线类型 UAPI_DRV_CIPHER_PKE_ECC_TYPE_RFC8032(10) priv_key const uapi_drv_cipher_pke_data_t * 输入私钥 非NULL，length对应曲线密钥长度 msg const uapi_drv_cipher_pke_msg_t * 输入消息 非NULL，data指向有效消息数据，length对应消息长度 sig const uapi_drv_cipher_pke_ecc_sig_t * 输出签名 非NULL，r、s指向已申请缓冲区，length对应曲线签名长度
出参
名称 数据类型 输出说明 sig uapi_drv_cipher_pke_ecc_sig_t * 输出的签名值，包含R和S分量
返回值
返回值 文字含义 触发场景 ERRCODE_SUCC(0x00) 执行成功 EdDSA签名成功 Other 其他错误码，参考errcode_t 执行失败
Kconfig配置
配置项 宏类型 说明 默认值 CONFIG_PKE_SUPPORT_EDWARD 功能宏 支持EdDSA爱德华兹曲线签名验签功能 y
uapi_drv_cipher_pke_eddsa_verify
errcode_t uapi_drv_cipher_pke_eddsa_verify(uapi_drv_cipher_pke_ecc_curve_type_t curve_type, const uapi_drv_cipher_pke_ecc_point_t *pub_key, const uapi_drv_cipher_pke_msg_t *msg, const uapi_drv_cipher_pke_ecc_sig_t *sig)
头文件清单
功能说明
- 使用EdDSA算法对签名数据进行爱德华兹曲线数字验签
- 输入公钥、原始消息和签名值，验证签名是否合法
- 调用期间会添加睡眠否决标记，防止系统进入深度睡眠，调用结束后移除
前置条件
- PKE模块已通过驱动初始化完成，CONFIG_PKE_SUPPORT_EDWARD宏已开启
- 调用方需确保pub_key、msg、sig指向的缓冲区已申请成功，且长度满足对应曲线要求
入参
名称 参数类型 详细说明 约束取值范围 curve_type uapi_drv_cipher_pke_ecc_curve_type_t ECC曲线类型 UAPI_DRV_CIPHER_PKE_ECC_TYPE_RFC8032(10) pub_key const uapi_drv_cipher_pke_ecc_point_t * 输入公钥 非NULL，x、y指向有效数据，length对应曲线密钥长度 msg const uapi_drv_cipher_pke_msg_t * 输入消息 非NULL，data指向有效消息数据，length对应消息长度 sig const uapi_drv_cipher_pke_ecc_sig_t * 输入签名 非NULL，r、s指向有效数据，length对应曲线签名长度
返回值
返回值 文字含义 触发场景 ERRCODE_SUCC(0x00) 执行成功 EdDSA验签通过 Other 其他错误码，参考errcode_t 验签失败或执行失败
Kconfig配置
配置项 宏类型 说明 默认值 CONFIG_PKE_SUPPORT_EDWARD 功能宏 支持EdDSA爱德华兹曲线签名验签功能 y 出参
无
uapi_drv_cipher_pke_ecc_gen_ecdh_key
errcode_t uapi_drv_cipher_pke_ecc_gen_ecdh_key(uapi_drv_cipher_pke_ecc_curve_type_t curve_type, const uapi_drv_cipher_pke_ecc_point_t *input_pub_key, const uapi_drv_cipher_pke_data_t *input_priv_key, const uapi_drv_cipher_pke_data_t *output_shared_key)
头文件清单
功能说明
- 使用ECDH算法进行椭圆曲线密钥协商，生成共享密钥
- 输入对端公钥和本地私钥，输出协商后的共享密钥
- 调用期间会添加睡眠否决标记，防止系统进入深度睡眠，调用结束后移除
前置条件
- PKE模块已通过驱动初始化完成，CONFIG_PKE_SUPPORT_ECC_ECDH宏已开启
- 调用方需确保input_pub_key、input_priv_key、output_shared_key指向的缓冲区已申请成功，且长度满足对应曲线要求
入参
名称 参数类型 详细说明 约束取值范围 curve_type uapi_drv_cipher_pke_ecc_curve_type_t ECC曲线类型 UAPI_DRV_CIPHER_PKE_ECC_TYPE_RFC5639_P256(0) ~ UAPI_DRV_CIPHER_PKE_ECC_TYPE_SM2(11) input_pub_key const uapi_drv_cipher_pke_ecc_point_t * 输入公钥 非NULL，x、y指向有效数据，length对应曲线密钥长度 input_priv_key const uapi_drv_cipher_pke_data_t * 输入私钥 非NULL，length对应曲线密钥长度 output_shared_key const uapi_drv_cipher_pke_data_t * 输出协商密钥 非NULL，data指向已申请缓冲区，length对应曲线密钥长度
出参
名称 数据类型 输出说明 output_shared_key uapi_drv_cipher_pke_data_t * 协商生成的共享密钥
返回值
返回值 文字含义 触发场景 ERRCODE_SUCC(0x00) 执行成功 ECDH密钥协商成功 Other 其他错误码，参考errcode_t 执行失败
Kconfig配置
配置项 宏类型 说明 默认值 CONFIG_PKE_SUPPORT_ECC_ECDH 功能宏 支持ECDH密钥协商功能 y
uapi_drv_cipher_pke_check_dot_on_curve
errcode_t uapi_drv_cipher_pke_check_dot_on_curve(uapi_drv_cipher_pke_ecc_curve_type_t curve_type, const uapi_drv_cipher_pke_ecc_point_t *pub_key, bool *is_on_curve)
头文件清单
功能说明
- 检查给定的点是否在指定的椭圆曲线上
- 输入公钥点坐标，输出布尔值表示该点是否在曲线上
- 调用期间会添加睡眠否决标记，防止系统进入深度睡眠，调用结束后移除
前置条件
- PKE模块已通过驱动初始化完成，CONFIG_PKE_SUPPORT_ECC_CAL宏已开启
- 调用方需确保pub_key指向的缓冲区已申请成功，is_on_curve指针非NULL
入参
名称 参数类型 详细说明 约束取值范围 curve_type uapi_drv_cipher_pke_ecc_curve_type_t ECC曲线类型 UAPI_DRV_CIPHER_PKE_ECC_TYPE_RFC5639_P256(0) ~ UAPI_DRV_CIPHER_PKE_ECC_TYPE_SM2(11) pub_key const uapi_drv_cipher_pke_ecc_point_t * 输入公钥点 非NULL，x、y指向有效数据，length对应曲线密钥长度 is_on_curve bool * 输出结果 非NULL
出参
名称 数据类型 输出说明 is_on_curve bool * 点是否在椭圆曲线上，true表示在曲线上，false表示不在曲线上
返回值
返回值 文字含义 触发场景 ERRCODE_SUCC(0x00) 执行成功 检查操作完成 Other 其他错误码，参考errcode_t 执行失败
Kconfig配置
配置项 宏类型 说明 默认值 CONFIG_PKE_SUPPORT_ECC_CAL 功能宏 支持ECC点校验功能 y
uapi_drv_cipher_pke_sm2_dsa_hash
errcode_t uapi_drv_cipher_pke_sm2_dsa_hash(const uapi_drv_cipher_pke_data_t *sm2_id, const uapi_drv_cipher_pke_ecc_point_t *pub_key, const uapi_drv_cipher_pke_msg_t *msg, uapi_drv_cipher_pke_data_t *hash)
头文件清单
功能说明
- 计算SM2杂凑的SM3摘要，用于SM2签名验签前的摘要预处理
- 输入SM2 ID、公钥和消息，输出SM3杂凑摘要
- 调用期间会添加睡眠否决标记，防止系统进入深度睡眠，调用结束后移除
前置条件
- PKE模块已通过驱动初始化完成，CONFIG_PKE_SUPPORT_SM2_SIGN或CONFIG_PKE_SUPPORT_SM2_VERIFY宏至少开启一个
- 调用方需确保sm2_id、pub_key、msg、hash指向的缓冲区已申请成功，且长度满足SM2要求
入参
名称 参数类型 详细说明 约束取值范围 sm2_id const uapi_drv_cipher_pke_data_t * SM2 ID 非NULL，data指向有效ID数据 pub_key const uapi_drv_cipher_pke_ecc_point_t * 输入公钥 非NULL，x、y指向有效数据，length对应SM2密钥长度 msg const uapi_drv_cipher_pke_msg_t * 输入消息 非NULL，data指向有效消息数据
出参
名称 数据类型 输出说明 hash uapi_drv_cipher_pke_data_t * 输出的SM3杂凑摘要
返回值
返回值 文字含义 触发场景 ERRCODE_SUCC(0x00) 执行成功 SM3摘要计算成功 Other 其他错误码，参考errcode_t 执行失败
Kconfig配置
配置项 宏类型 说明 默认值 CONFIG_PKE_SUPPORT_SM2_SIGN 功能宏 支持SM2签名功能 y CONFIG_PKE_SUPPORT_SM2_VERIFY 功能宏 支持SM2验签功能 y
uapi_drv_cipher_pke_sm2_public_encrypt
errcode_t uapi_drv_cipher_pke_sm2_public_encrypt(const uapi_drv_cipher_pke_ecc_point_t *pub_key, const uapi_drv_cipher_pke_data_t *plain_text, const uapi_drv_cipher_pke_data_t *cipher_text)
头文件清单
功能说明
- 使用SM2公钥加密算法对明文数据进行加密
- 输入公钥和明文，输出密文
- 调用期间会添加睡眠否决标记，防止系统进入深度睡眠，调用结束后移除
前置条件
- PKE模块已通过驱动初始化完成，CONFIG_PKE_SUPPORT_SM2_CRYPTO宏已开启
- 调用方需确保pub_key、plain_text、cipher_text指向的缓冲区已申请成功，cipher_text缓冲区长度不小于SM2密文长度要求
入参
名称 参数类型 详细说明 约束取值范围 pub_key const uapi_drv_cipher_pke_ecc_point_t * 输入公钥 非NULL，x、y指向有效数据，length对应SM2密钥长度 plain_text const uapi_drv_cipher_pke_data_t * 输入明文 非NULL，data指向有效明文数据 cipher_text const uapi_drv_cipher_pke_data_t * 输出密文 非NULL，data指向已申请缓冲区，长度不小于SM2密文长度
出参
名称 数据类型 输出说明 cipher_text uapi_drv_cipher_pke_data_t * 输出的SM2密文数据
返回值
返回值 文字含义 触发场景 ERRCODE_SUCC(0x00) 执行成功 SM2加密成功 Other 其他错误码，参考errcode_t 执行失败
Kconfig配置
配置项 宏类型 说明 默认值 CONFIG_PKE_SUPPORT_SM2_CRYPTO 功能宏 支持SM2加解密功能 y
uapi_drv_cipher_pke_sm2_private_decrypt
errcode_t uapi_drv_cipher_pke_sm2_private_decrypt(const uapi_drv_cipher_pke_data_t *priv_key, const uapi_drv_cipher_pke_data_t *cipher_text, const uapi_drv_cipher_pke_data_t *plain_text)
头文件清单
功能说明
- 使用SM2私钥解密算法对密文数据进行解密
- 输入私钥和密文，输出明文
- 调用期间会添加睡眠否决标记，防止系统进入深度睡眠，调用结束后移除
前置条件
- PKE模块已通过驱动初始化完成，CONFIG_PKE_SUPPORT_SM2_CRYPTO宏已开启
- 调用方需确保priv_key、cipher_text、plain_text指向的缓冲区已申请成功，plain_text缓冲区长度不小于SM2明文长度要求
入参
名称 参数类型 详细说明 约束取值范围 priv_key const uapi_drv_cipher_pke_data_t * 输入私钥 非NULL，length对应SM2密钥长度 cipher_text const uapi_drv_cipher_pke_data_t * 输入密文 非NULL，data指向有效密文数据 plain_text const uapi_drv_cipher_pke_data_t * 输出明文 非NULL，data指向已申请缓冲区，长度不小于SM2明文长度
出参
名称 数据类型 输出说明 plain_text uapi_drv_cipher_pke_data_t * 输出的SM2明文数据
返回值
返回值 文字含义 触发场景 ERRCODE_SUCC(0x00) 执行成功 SM2解密成功 Other 其他错误码，参考errcode_t 执行失败
Kconfig配置
配置项 宏类型 说明 默认值 CONFIG_PKE_SUPPORT_SM2_CRYPTO 功能宏 支持SM2加解密功能 y
uapi_drv_cipher_pke_rsa_sign
errcode_t uapi_drv_cipher_pke_rsa_sign(const uapi_drv_cipher_pke_rsa_priv_key_t *priv_key, uapi_drv_cipher_pke_rsa_scheme_t scheme, uapi_drv_cipher_pke_hash_type_t hash_type, const uapi_drv_cipher_pke_data_t *input_hash, uapi_drv_cipher_pke_data_t *sign)
头文件清单
功能说明
- 使用RSA私钥对摘要数据进行签名
- 输入私钥、填充方式、摘要算法和摘要数据，输出签名结果
- 调用期间会添加睡眠否决标记，防止系统进入深度睡眠，调用结束后移除
前置条件
- PKE模块已通过驱动初始化完成，CONFIG_PKE_SUPPORT_RSA宏已开启
- 调用方需确保priv_key、input_hash、sign指向的缓冲区已申请成功，且长度满足RSA密钥要求
入参
名称 参数类型 详细说明 约束取值范围 priv_key const uapi_drv_cipher_pke_rsa_priv_key_t * 输入私钥 非NULL，各参数指针非NULL，长度满足RSA密钥规格 scheme uapi_drv_cipher_pke_rsa_scheme_t RSA填充方式 UAPI_DRV_CIPHER_PKE_RSA_SCHEME_PKCS1_V15(0x00)或UAPI_DRV_CIPHER_PKE_RSA_SCHEME_PKCS1_V21(0x01) hash_type uapi_drv_cipher_pke_hash_type_t RSA填充使用的摘要算法 UAPI_DRV_CIPHER_PKE_HASH_TYPE_SHA1(0x00) ~ UAPI_DRV_CIPHER_PKE_HASH_TYPE_SM3(0x05) input_hash const uapi_drv_cipher_pke_data_t * 输入摘要 非NULL，length对应摘要算法输出长度 sign uapi_drv_cipher_pke_data_t * 输出签名 非NULL，data指向已申请缓冲区，length对应RSA密钥长度
出参
名称 数据类型 输出说明 sign uapi_drv_cipher_pke_data_t * 输出的RSA签名结果
返回值
返回值 文字含义 触发场景 ERRCODE_SUCC(0x00) 执行成功 RSA签名成功 Other 其他错误码，参考errcode_t 执行失败
Kconfig配置
配置项 宏类型 说明 默认值 CONFIG_PKE_SUPPORT_RSA 功能宏 支持RSA功能 y
uapi_drv_cipher_pke_rsa_verify
errcode_t uapi_drv_cipher_pke_rsa_verify(const uapi_drv_cipher_pke_rsa_pub_key_t *pub_key, uapi_drv_cipher_pke_rsa_scheme_t scheme, uapi_drv_cipher_pke_hash_type_t hash_type, uapi_drv_cipher_pke_data_t *input_hash, const uapi_drv_cipher_pke_data_t *sig)
头文件清单
功能说明
- 使用RSA公钥对签名数据进行验签
- 输入公钥、填充方式、摘要算法、摘要和签名值，验证签名是否合法
- 调用期间会添加睡眠否决标记，防止系统进入深度睡眠，调用结束后移除
前置条件
- PKE模块已通过驱动初始化完成，CONFIG_PKE_SUPPORT_RSA宏已开启
- 调用方需确保pub_key、input_hash、sig指向的缓冲区已申请成功，且长度满足RSA密钥要求
入参
名称 参数类型 详细说明 约束取值范围 pub_key const uapi_drv_cipher_pke_rsa_pub_key_t * 输入公钥 非NULL，n、e指向有效数据，len对应RSA密钥长度 scheme uapi_drv_cipher_pke_rsa_scheme_t RSA填充方式 UAPI_DRV_CIPHER_PKE_RSA_SCHEME_PKCS1_V15(0x00)或UAPI_DRV_CIPHER_PKE_RSA_SCHEME_PKCS1_V21(0x01) hash_type uapi_drv_cipher_pke_hash_type_t RSA填充使用的摘要算法 UAPI_DRV_CIPHER_PKE_HASH_TYPE_SHA1(0x00) ~ UAPI_DRV_CIPHER_PKE_HASH_TYPE_SM3(0x05) input_hash uapi_drv_cipher_pke_data_t * 输入摘要 非NULL，length对应摘要算法输出长度 sig const uapi_drv_cipher_pke_data_t * 输入签名 非NULL，data指向有效签名数据，length对应RSA密钥长度
返回值
返回值 文字含义 触发场景 ERRCODE_SUCC(0x00) 执行成功 RSA验签通过 Other 其他错误码，参考errcode_t 验签失败或执行失败
Kconfig配置
配置项 宏类型 说明 默认值 CONFIG_PKE_SUPPORT_RSA 功能宏 支持RSA功能 y 出参
无
uapi_drv_cipher_pke_rsa_public_encrypt
errcode_t uapi_drv_cipher_pke_rsa_public_encrypt(uapi_drv_cipher_pke_rsa_scheme_t scheme, uapi_drv_cipher_pke_hash_type_t hash_type, const uapi_drv_cipher_pke_rsa_pub_key_t *pub_key, const uapi_drv_cipher_pke_data_t *input, const uapi_drv_cipher_pke_data_t *label, uapi_drv_cipher_pke_data_t *output)
头文件清单
功能说明
- 使用RSA公钥对明文数据进行加密
- 输入填充方式、摘要算法、公钥、明文和标签，输出密文
- hash_type和label仅OAEP填充模式时使用
- 调用期间会添加睡眠否决标记，防止系统进入深度睡眠，调用结束后移除
前置条件
- PKE模块已通过驱动初始化完成，CONFIG_PKE_SUPPORT_RSA宏已开启
- 调用方需确保pub_key、input、output指向的缓冲区已申请成功，output长度不小于RSA密钥长度
入参
名称 参数类型 详细说明 约束取值范围 scheme uapi_drv_cipher_pke_rsa_scheme_t RSA填充方式 UAPI_DRV_CIPHER_PKE_RSA_SCHEME_PKCS1_V15(0x00)或UAPI_DRV_CIPHER_PKE_RSA_SCHEME_PKCS1_V21(0x01) hash_type uapi_drv_cipher_pke_hash_type_t RSA填充使用的摘要算法，仅OAEP填充模式时使用 UAPI_DRV_CIPHER_PKE_HASH_TYPE_SHA1(0x00) ~ UAPI_DRV_CIPHER_PKE_HASH_TYPE_SM3(0x05) pub_key const uapi_drv_cipher_pke_rsa_pub_key_t * 输入公钥 非NULL，n、e指向有效数据，len对应RSA密钥长度 input const uapi_drv_cipher_pke_data_t * 输入明文 非NULL，data指向有效明文数据 label const uapi_drv_cipher_pke_data_t * RSA标签，仅OAEP填充模式时使用 可为NULL
出参
名称 数据类型 输出说明 output uapi_drv_cipher_pke_data_t * 输出的RSA密文数据
返回值
返回值 文字含义 触发场景 ERRCODE_SUCC(0x00) 执行成功 RSA加密成功 Other 其他错误码，参考errcode_t 执行失败
Kconfig配置
配置项 宏类型 说明 默认值 CONFIG_PKE_SUPPORT_RSA 功能宏 支持RSA功能 y
uapi_drv_cipher_pke_rsa_private_decrypt
errcode_t uapi_drv_cipher_pke_rsa_private_decrypt(uapi_drv_cipher_pke_rsa_scheme_t scheme, uapi_drv_cipher_pke_hash_type_t hash_type, const uapi_drv_cipher_pke_rsa_priv_key_t *priv_key, const uapi_drv_cipher_pke_data_t *input, const uapi_drv_cipher_pke_data_t *label, const uapi_drv_cipher_pke_data_t *output)
头文件清单
功能说明
- 使用RSA私钥对密文数据进行解密
- 输入填充方式、摘要算法、私钥、密文和标签，输出明文
- hash_type和label仅OAEP填充模式时使用
- 调用期间会添加睡眠否决标记，防止系统进入深度睡眠，调用结束后移除
前置条件
- PKE模块已通过驱动初始化完成，CONFIG_PKE_SUPPORT_RSA宏已开启
- 调用方需确保priv_key、input、output指向的缓冲区已申请成功，output长度不小于RSA明文长度
入参
名称 参数类型 详细说明 约束取值范围 scheme uapi_drv_cipher_pke_rsa_scheme_t RSA填充方式 UAPI_DRV_CIPHER_PKE_RSA_SCHEME_PKCS1_V15(0x00)或UAPI_DRV_CIPHER_PKE_RSA_SCHEME_PKCS1_V21(0x01) hash_type uapi_drv_cipher_pke_hash_type_t RSA填充使用的摘要算法，仅OAEP填充模式时使用 UAPI_DRV_CIPHER_PKE_HASH_TYPE_SHA1(0x00) ~ UAPI_DRV_CIPHER_PKE_HASH_TYPE_SM3(0x05) priv_key const uapi_drv_cipher_pke_rsa_priv_key_t * 输入私钥 非NULL，各参数指针非NULL，长度满足RSA密钥规格 input const uapi_drv_cipher_pke_data_t * 输入密文 非NULL，data指向有效密文数据 label const uapi_drv_cipher_pke_data_t * RSA标签，仅OAEP填充模式时使用 可为NULL
出参
名称 数据类型 输出说明 output uapi_drv_cipher_pke_data_t * 输出的RSA明文数据
返回值
返回值 文字含义 触发场景 ERRCODE_SUCC(0x00) 执行成功 RSA解密成功 Other 其他错误码，参考errcode_t 执行失败
Kconfig配置
配置项 宏类型 说明 默认值 CONFIG_PKE_SUPPORT_RSA 功能宏 支持RSA功能 y
uapi_drv_cipher_pke_dh_gen_key
errcode_t uapi_drv_cipher_pke_dh_gen_key(const uapi_drv_cipher_pke_data_t *g_data, const uapi_drv_cipher_pke_data_t *mod_n, const uapi_drv_cipher_pke_data_t *input_priv_key, const uapi_drv_cipher_pke_data_t *output_priv_key, const uapi_drv_cipher_pke_data_t *output_pub_key)
头文件清单
功能说明
- DH公私钥对生成或由私钥生成公钥
- 输入公开底数和模数，生成私钥和公钥；若输入私钥非空则由私钥生成公钥
- 模数的有效字节数与mod_n->length支持的规格之差不能大于2字节
- 调用期间会添加睡眠否决标记，防止系统进入深度睡眠，调用结束后移除
前置条件
- PKE模块已通过驱动初始化完成，CONFIG_PKE_SUPPORT_RSA宏已开启
- 调用方需确保g_data、mod_n、output_priv_key、output_pub_key指向的缓冲区已申请成功，且长度满足要求
入参
名称 参数类型 详细说明 约束取值范围 g_data const uapi_drv_cipher_pke_data_t * 公开的底数，该数为质数 非NULL，g_data->length不能大于mod_n->length mod_n const uapi_drv_cipher_pke_data_t * 公开的模数，该数为质数 非NULL，仅支持192/224/256/384/512/521/1024/2048/3072/4096bits input_priv_key const uapi_drv_cipher_pke_data_t * 输入私钥，可以为空 NULL或有效的data指针，length与mod_n->length相同 output_priv_key const uapi_drv_cipher_pke_data_t * 输出私钥 非NULL，length与mod_n->length相同 output_pub_key const uapi_drv_cipher_pke_data_t * 输出公钥 非NULL，length与mod_n->length相同
出参
名称 数据类型 输出说明 output_priv_key uapi_drv_cipher_pke_data_t * 生成的私钥数据 output_pub_key uapi_drv_cipher_pke_data_t * 生成的公钥数据
返回值
返回值 文字含义 触发场景 ERRCODE_SUCC(0x00) 执行成功 DH密钥生成成功 Other 其他错误码，参考errcode_t 执行失败
Kconfig配置
配置项 宏类型 说明 默认值 CONFIG_PKE_SUPPORT_RSA 功能宏 支持RSA/DH功能 y
uapi_drv_cipher_pke_dh_compute_key
errcode_t uapi_drv_cipher_pke_dh_compute_key(const uapi_drv_cipher_pke_data_t *mod_n, const uapi_drv_cipher_pke_data_t *input_priv_key, const uapi_drv_cipher_pke_data_t *input_pub_key, const uapi_drv_cipher_pke_data_t *output_shared_key)
头文件清单
功能说明
- DH密钥协商算法，根据本地私钥和对端公钥计算共享密钥
- 输入模数、本地私钥和对端公钥，输出共享密钥
- 调用期间会添加睡眠否决标记，防止系统进入深度睡眠，调用结束后移除
前置条件
- PKE模块已通过驱动初始化完成，CONFIG_PKE_SUPPORT_RSA宏已开启
- 调用方需确保mod_n、input_priv_key、input_pub_key、output_shared_key指向的缓冲区已申请成功，且长度满足要求
入参
名称 参数类型 详细说明 约束取值范围 mod_n const uapi_drv_cipher_pke_data_t * 公开的模数，该数为质数 非NULL input_priv_key const uapi_drv_cipher_pke_data_t * 输入私钥 非NULL input_pub_key const uapi_drv_cipher_pke_data_t * 输入公钥 非NULL output_shared_key const uapi_drv_cipher_pke_data_t * 输出共享密钥 非NULL，data指向已申请缓冲区
出参
名称 数据类型 输出说明 output_shared_key uapi_drv_cipher_pke_data_t * 协商生成的共享密钥
返回值
返回值 文字含义 触发场景 ERRCODE_SUCC(0x00) 执行成功 DH密钥协商成功 Other 其他错误码，参考errcode_t 执行失败
Kconfig配置
配置项 宏类型 说明 默认值 CONFIG_PKE_SUPPORT_RSA 功能宏 支持RSA/DH功能 y
uapi_drv_cipher_pke_add_mod
errcode_t uapi_drv_cipher_pke_add_mod(const uapi_drv_cipher_pke_data_t *a, const uapi_drv_cipher_pke_data_t *b, const uapi_drv_cipher_pke_data_t *p, const uapi_drv_cipher_pke_data_t *c)
头文件清单
功能说明
- 模加运算 c = (a + b) mod p
- 输入两个大数和模数，输出模加结果
- 模数的有效字节数与p->length支持的规格之差不能大于2字节
- 调用期间会添加睡眠否决标记，防止系统进入深度睡眠，调用结束后移除
前置条件
- PKE模块已通过驱动初始化完成，CONFIG_PKE_SUPPORT_BIG_NUMBER宏已开启
- 调用方需确保a、b、p、c指向的缓冲区已申请成功，且c->length等于p->length
入参
名称 参数类型 详细说明 约束取值范围 a const uapi_drv_cipher_pke_data_t * 入参a 非NULL，a->length不能大于p->length b const uapi_drv_cipher_pke_data_t * 入参b 非NULL，b->length不能大于p->length p const uapi_drv_cipher_pke_data_t * 模数 非NULL，仅支持192/224/256/384/512/521/1024/1536/2048/3072/4096bits c const uapi_drv_cipher_pke_data_t * 计算结果 非NULL，c->length等于p->length
出参
名称 数据类型 输出说明 c uapi_drv_cipher_pke_data_t * 模加运算结果
返回值
返回值 文字含义 触发场景 ERRCODE_SUCC(0x00) 执行成功 模加运算成功 Other 其他错误码，参考errcode_t 执行失败
Kconfig配置
配置项 宏类型 说明 默认值 CONFIG_PKE_SUPPORT_BIG_NUMBER 功能宏 支持大数运算功能 y
uapi_drv_cipher_pke_sub_mod
errcode_t uapi_drv_cipher_pke_sub_mod(const uapi_drv_cipher_pke_data_t *a, const uapi_drv_cipher_pke_data_t *b, const uapi_drv_cipher_pke_data_t *p, const uapi_drv_cipher_pke_data_t *c)
头文件清单
功能说明
- 模减运算 c = (a - b) mod p
- 输入两个大数和模数，输出模减结果
- 模数的有效字节数与p->length支持的规格之差不能大于2字节
- 调用期间会添加睡眠否决标记，防止系统进入深度睡眠，调用结束后移除
前置条件
- PKE模块已通过驱动初始化完成，CONFIG_PKE_SUPPORT_BIG_NUMBER宏已开启
- 调用方需确保a、b、p、c指向的缓冲区已申请成功，且c->length等于p->length
入参
名称 参数类型 详细说明 约束取值范围 a const uapi_drv_cipher_pke_data_t * 入参a 非NULL，a->length不能大于p->length b const uapi_drv_cipher_pke_data_t * 入参b 非NULL，b->length不能大于p->length p const uapi_drv_cipher_pke_data_t * 模数 非NULL，仅支持192/224/256/384/512/521/1024/1536/2048/3072/4096bits c const uapi_drv_cipher_pke_data_t * 计算结果 非NULL，c->length等于p->length
出参
名称 数据类型 输出说明 c uapi_drv_cipher_pke_data_t * 模减运算结果
返回值
返回值 文字含义 触发场景 ERRCODE_SUCC(0x00) 执行成功 模减运算成功 Other 其他错误码，参考errcode_t 执行失败
Kconfig配置
配置项 宏类型 说明 默认值 CONFIG_PKE_SUPPORT_BIG_NUMBER 功能宏 支持大数运算功能 y
uapi_drv_cipher_pke_mul_mod
errcode_t uapi_drv_cipher_pke_mul_mod(const uapi_drv_cipher_pke_data_t *a, const uapi_drv_cipher_pke_data_t *b, const uapi_drv_cipher_pke_data_t *p, const uapi_drv_cipher_pke_data_t *c)
头文件清单
功能说明
- 模乘运算 c = (a * b) mod p
- 输入两个大数和模数，输出模乘结果
- 模数的有效字节数与p->length支持的规格之差不能大于2字节，且模数不能为偶数
- 调用期间会添加睡眠否决标记，防止系统进入深度睡眠，调用结束后移除
前置条件
- PKE模块已通过驱动初始化完成，CONFIG_PKE_SUPPORT_BIG_NUMBER宏已开启
- 调用方需确保a、b、p、c指向的缓冲区已申请成功，且c->length等于p->length
入参
名称 参数类型 详细说明 约束取值范围 a const uapi_drv_cipher_pke_data_t * 入参a 非NULL，a->length不能大于p->length b const uapi_drv_cipher_pke_data_t * 入参b 非NULL，b->length不能大于p->length p const uapi_drv_cipher_pke_data_t * 模数 非NULL，仅支持192/256/384/512/1024/1536/2048/3072/4096bits，且模数不能为偶数 c const uapi_drv_cipher_pke_data_t * 计算结果 非NULL，c->length等于p->length
出参
名称 数据类型 输出说明 c uapi_drv_cipher_pke_data_t * 模乘运算结果
返回值
返回值 文字含义 触发场景 ERRCODE_SUCC(0x00) 执行成功 模乘运算成功 Other 其他错误码，参考errcode_t 执行失败
Kconfig配置
配置项 宏类型 说明 默认值 CONFIG_PKE_SUPPORT_BIG_NUMBER 功能宏 支持大数运算功能 y
uapi_drv_cipher_pke_inv_mod
errcode_t uapi_drv_cipher_pke_inv_mod(const uapi_drv_cipher_pke_data_t *a, const uapi_drv_cipher_pke_data_t *p, const uapi_drv_cipher_pke_data_t *c)
头文件清单
功能说明
- 模逆运算 c = (a^-1) mod p
- 输入大数和模数，输出模逆结果
- 模数的有效字节数与p->length支持的规格之差不能大于2字节，且模数不能为偶数
- 调用期间会添加睡眠否决标记，防止系统进入深度睡眠，调用结束后移除
前置条件
- PKE模块已通过驱动初始化完成，CONFIG_PKE_SUPPORT_BIG_NUMBER宏已开启
- 调用方需确保a、p、c指向的缓冲区已申请成功，且a->length等于p->length，c->length等于p->length
入参
名称 参数类型 详细说明 约束取值范围 a const uapi_drv_cipher_pke_data_t * 入参 非NULL，a->length等于p->length p const uapi_drv_cipher_pke_data_t * 模数 非NULL，仅支持192/256/384/512/1024/1536/2048/3072/4096bits，且模数不能为偶数 c const uapi_drv_cipher_pke_data_t * 计算结果 非NULL，c->length等于p->length
出参
名称 数据类型 输出说明 c uapi_drv_cipher_pke_data_t * 模逆运算结果
返回值
返回值 文字含义 触发场景 ERRCODE_SUCC(0x00) 执行成功 模逆运算成功 Other 其他错误码，参考errcode_t 执行失败
Kconfig配置
配置项 宏类型 说明 默认值 CONFIG_PKE_SUPPORT_BIG_NUMBER 功能宏 支持大数运算功能 y
uapi_drv_cipher_pke_mod
errcode_t uapi_drv_cipher_pke_mod(const uapi_drv_cipher_pke_data_t *a, const uapi_drv_cipher_pke_data_t *p, const uapi_drv_cipher_pke_data_t *c)
头文件清单
功能说明
- 取模运算 c = a mod p
- 输入大数和模数，输出取模结果
- 模数的有效字节数与p->length支持的规格之差不能大于2字节，且模数不能为偶数
- 调用期间会添加睡眠否决标记，防止系统进入深度睡眠，调用结束后移除
前置条件
- PKE模块已通过驱动初始化完成，CONFIG_PKE_SUPPORT_BIG_NUMBER宏已开启
- 调用方需确保a、p、c指向的缓冲区已申请成功，a有效数据长度不能大于2倍模数有效数据长度，c->length等于p->length
入参
名称 参数类型 详细说明 约束取值范围 a const uapi_drv_cipher_pke_data_t * 入参 非NULL，有效数据长度不能大于2倍模数的有效数据长度 p const uapi_drv_cipher_pke_data_t * 模数 非NULL，仅支持192/256/384/512/1024/1536/2048/3072/4096bits，且模数不能为偶数 c const uapi_drv_cipher_pke_data_t * 计算结果 非NULL，c->length等于p->length
出参
名称 数据类型 输出说明 c uapi_drv_cipher_pke_data_t * 取模运算结果
返回值
返回值 文字含义 触发场景 ERRCODE_SUCC(0x00) 执行成功 取模运算成功 Other 其他错误码，参考errcode_t 执行失败
Kconfig配置
配置项 宏类型 说明 默认值 CONFIG_PKE_SUPPORT_BIG_NUMBER 功能宏 支持大数运算功能 y
uapi_drv_cipher_pke_mul
errcode_t uapi_drv_cipher_pke_mul(const uapi_drv_cipher_pke_data_t *a, const uapi_drv_cipher_pke_data_t *b, const uapi_drv_cipher_pke_data_t *c)
头文件清单
功能说明
- 大数乘法 c = a * b
- 输入两个大数，输出乘法结果
- 调用期间会添加睡眠否决标记，防止系统进入深度睡眠，调用结束后移除
前置条件
- PKE模块已通过驱动初始化完成，CONFIG_PKE_SUPPORT_BIG_NUMBER宏已开启
- 调用方需确保a、b、c指向的缓冲区已申请成功，c->length不能小于a->length + b->length
入参
名称 参数类型 详细说明 约束取值范围 a const uapi_drv_cipher_pke_data_t * 入参a 非NULL，a->length不能大于2048bits b const uapi_drv_cipher_pke_data_t * 入参b 非NULL，b->length不能大于2048bits c const uapi_drv_cipher_pke_data_t * 计算结果 非NULL，c->length不能小于a->length + b->length
出参
名称 数据类型 输出说明 c uapi_drv_cipher_pke_data_t * 大数乘法结果
返回值
返回值 文字含义 触发场景 ERRCODE_SUCC(0x00) 执行成功 大数乘法成功 Other 其他错误码，参考errcode_t 执行失败
Kconfig配置
配置项 宏类型 说明 默认值 CONFIG_PKE_SUPPORT_BIG_NUMBER 功能宏 支持大数运算功能 y
uapi_drv_cipher_pke_exp_mod
errcode_t uapi_drv_cipher_pke_exp_mod(const uapi_drv_cipher_pke_data_t *n, const uapi_drv_cipher_pke_data_t *k, const uapi_drv_cipher_pke_data_t *in, const uapi_drv_cipher_pke_data_t *out)
头文件清单
功能说明
- 模幂运算 out = (in ^ k) mod n
- 输入模数、指数和底数，输出模幂结果
- 模数的有效字节数与n->length支持的规格之差不能大于2字节，且模数不能为偶数
- 调用期间会添加睡眠否决标记，防止系统进入深度睡眠，调用结束后移除
前置条件
- PKE模块已通过驱动初始化完成，CONFIG_PKE_SUPPORT_BIG_NUMBER宏已开启
- 调用方需确保n、k、in、out指向的缓冲区已申请成功，out->length等于n->length
入参
名称 参数类型 详细说明 约束取值范围 n const uapi_drv_cipher_pke_data_t * 模数 非NULL，仅支持192/256/384/512/1024/1536/2048/3072/4096bits，且模数不能为偶数 k const uapi_drv_cipher_pke_data_t * 指数 非NULL，数据长度不能大于4096bits in const uapi_drv_cipher_pke_data_t * 输入数据 非NULL，数据长度不能大于4096bits out const uapi_drv_cipher_pke_data_t * 输出结果 非NULL，out->length等于n->length
出参
名称 数据类型 输出说明 out uapi_drv_cipher_pke_data_t * 模幂运算结果
返回值
返回值 文字含义 触发场景 ERRCODE_SUCC(0x00) 执行成功 模幂运算成功 Other 其他错误码，参考errcode_t 执行失败
Kconfig配置
配置项 宏类型 说明 默认值 CONFIG_PKE_SUPPORT_BIG_NUMBER 功能宏 支持大数运算功能 y
Enumerations
uapi_drv_cipher_pke_ecc_curve_type_t
枚举成员 取值 描述 UAPI_DRV_CIPHER_PKE_ECC_TYPE_RFC5639_P256 0 RFC 5639 Brainpool P256曲线 UAPI_DRV_CIPHER_PKE_ECC_TYPE_RFC5639_P384 1 RFC 5639 Brainpool P384曲线 UAPI_DRV_CIPHER_PKE_ECC_TYPE_RFC5639_P512 2 RFC 5639 Brainpool P512曲线 UAPI_DRV_CIPHER_PKE_ECC_TYPE_FIPS_P256K 3 NIST FIPS 186-4 P256K曲线，不建议使用 UAPI_DRV_CIPHER_PKE_ECC_TYPE_FIPS_P192R 4 NIST FIPS 186-4 P192R曲线，不建议使用 UAPI_DRV_CIPHER_PKE_ECC_TYPE_FIPS_P224R 5 NIST FIPS 186-4 P224R曲线，不建议使用 UAPI_DRV_CIPHER_PKE_ECC_TYPE_FIPS_P256R 6 NIST FIPS 186-4 P256R曲线，不建议使用 UAPI_DRV_CIPHER_PKE_ECC_TYPE_FIPS_P384R 7 NIST FIPS 186-4 P384R曲线，不建议使用 UAPI_DRV_CIPHER_PKE_ECC_TYPE_FIPS_P521R 8 NIST FIPS 186-4 P521R曲线，不建议使用 UAPI_DRV_CIPHER_PKE_ECC_TYPE_RFC7748 9 RFC 7748 Curve25519曲线 UAPI_DRV_CIPHER_PKE_ECC_TYPE_RFC7748_448 10 RFC 7748 Curve448曲线 UAPI_DRV_CIPHER_PKE_ECC_TYPE_RFC8032 11 RFC 8032 ED25519曲线 UAPI_DRV_CIPHER_PKE_ECC_TYPE_SM2 12 GMT 0003.2-2012 SM2曲线 UAPI_DRV_CIPHER_PKE_ECC_TYPE_MAX 13 最大值 UAPI_DRV_CIPHER_PKE_ECC_TYPE_INVALID 0xffffffff 无效值
uapi_drv_cipher_pke_rsa_scheme_t
枚举成员 取值 描述 UAPI_DRV_CIPHER_PKE_RSA_SCHEME_PKCS1_V15 0x00 PKCS1 V15填充方式，不建议使用 UAPI_DRV_CIPHER_PKE_RSA_SCHEME_PKCS1_V21 0x01 PKCS1 V21填充方式 UAPI_DRV_CIPHER_PKE_RSA_SCHEME_MAX 0x02 最大值 UAPI_DRV_CIPHER_PKE_RSA_SCHEME_INVALID 0xffffffff 无效值
uapi_drv_cipher_pke_hash_type_t
枚举成员 取值 描述 UAPI_DRV_CIPHER_PKE_HASH_TYPE_SHA1 0x00 SHA1摘要算法，不建议使用 UAPI_DRV_CIPHER_PKE_HASH_TYPE_SHA224 0x01 SHA224摘要算法，不建议使用 UAPI_DRV_CIPHER_PKE_HASH_TYPE_SHA256 0x02 SHA256摘要算法 UAPI_DRV_CIPHER_PKE_HASH_TYPE_SHA384 0x03 SHA384摘要算法 UAPI_DRV_CIPHER_PKE_HASH_TYPE_SHA512 0x04 SHA512摘要算法 UAPI_DRV_CIPHER_PKE_HASH_TYPE_SM3 0x05 SM3摘要算法 UAPI_DRV_CIPHER_PKE_HASH_TYPE_MAX 0x06 最大值 UAPI_DRV_CIPHER_PKE_HASH_TYPE_INVALID 0xffffffff 无效值
uapi_drv_cipher_pke_buffer_secure_t
枚举成员 取值 描述 UAPI_DRV_CIPHER_PKE_BUF_NONSECURE 0x00 非安全缓冲区 UAPI_DRV_CIPHER_PKE_BUF_SECURE 0x01 安全缓冲区 UAPI_DRV_CIPHER_PKE_BUF_INVALID 0xffffffff 无效值
Enumerations
uapi_drv_cipher_pke_ecc_curve_type_t
typedef enum {
UAPI_DRV_CIPHER_PKE_ECC_TYPE_RFC5639_P256 = 0, /* RFC 5639 - Brainpool P256/384/512 */
UAPI_DRV_CIPHER_PKE_ECC_TYPE_RFC5639_P384, /* RFC 5639 - Brainpool P256/384/512 */
UAPI_DRV_CIPHER_PKE_ECC_TYPE_RFC5639_P512, /* RFC 5639 - Brainpool P256/384/512 */
UAPI_DRV_CIPHER_PKE_ECC_TYPE_FIPS_P256K, /* NIST FIPS 186-4 P192/224/256/384/521, suggest not to use */
UAPI_DRV_CIPHER_PKE_ECC_TYPE_FIPS_P192R, /* NIST FIPS 186-4 P192/224/256/384/521, suggest not to use */
UAPI_DRV_CIPHER_PKE_ECC_TYPE_FIPS_P224R, /* NIST FIPS 186-4 P192/224/256/384/521, suggest not to use */
UAPI_DRV_CIPHER_PKE_ECC_TYPE_FIPS_P256R, /* NIST FIPS 186-4 P192/224/256/384/521, suggest not to use */
UAPI_DRV_CIPHER_PKE_ECC_TYPE_FIPS_P384R, /* NIST FIPS 186-4 P192/224/256/384/521, suggest not to use */
UAPI_DRV_CIPHER_PKE_ECC_TYPE_FIPS_P521R, /* NIST FIPS 186-4 P192/224/256/384/521, suggest not to use */
UAPI_DRV_CIPHER_PKE_ECC_TYPE_RFC7748, /* RFC 7748 - Curve25519 */
UAPI_DRV_CIPHER_PKE_ECC_TYPE_RFC7748_448, /* RFC 7748 - Curve448 */
UAPI_DRV_CIPHER_PKE_ECC_TYPE_RFC8032, /* RFC 8032 - ED25519 */
UAPI_DRV_CIPHER_PKE_ECC_TYPE_SM2, /* GMT 0003.2-2012 */
UAPI_DRV_CIPHER_PKE_ECC_TYPE_MAX,
UAPI_DRV_CIPHER_PKE_ECC_TYPE_INVALID = 0xffffffff,
} uapi_drv_cipher_pke_ecc_curve_type_t;
枚举成员 取值 描述 UAPI_DRV_CIPHER_PKE_ECC_TYPE_RFC5639_P256 0 RFC 5639 Brainpool P256曲线 UAPI_DRV_CIPHER_PKE_ECC_TYPE_RFC5639_P384 1 RFC 5639 Brainpool P384曲线 UAPI_DRV_CIPHER_PKE_ECC_TYPE_RFC5639_P512 2 RFC 5639 Brainpool P512曲线 UAPI_DRV_CIPHER_PKE_ECC_TYPE_FIPS_P256K 3 NIST FIPS 186-4 P256K曲线，不建议使用 UAPI_DRV_CIPHER_PKE_ECC_TYPE_FIPS_P192R 4 NIST FIPS 186-4 P192R曲线，不建议使用 UAPI_DRV_CIPHER_PKE_ECC_TYPE_FIPS_P224R 5 NIST FIPS 186-4 P224R曲线，不建议使用 UAPI_DRV_CIPHER_PKE_ECC_TYPE_FIPS_P256R 6 NIST FIPS 186-4 P256R曲线，不建议使用 UAPI_DRV_CIPHER_PKE_ECC_TYPE_FIPS_P384R 7 NIST FIPS 186-4 P384R曲线，不建议使用 UAPI_DRV_CIPHER_PKE_ECC_TYPE_FIPS_P521R 8 NIST FIPS 186-4 P521R曲线，不建议使用 UAPI_DRV_CIPHER_PKE_ECC_TYPE_RFC7748 9 RFC 7748 Curve25519曲线 UAPI_DRV_CIPHER_PKE_ECC_TYPE_RFC7748_448 10 RFC 7748 Curve448曲线 UAPI_DRV_CIPHER_PKE_ECC_TYPE_RFC8032 11 RFC 8032 ED25519曲线 UAPI_DRV_CIPHER_PKE_ECC_TYPE_SM2 12 GMT 0003.2-2012 SM2曲线 UAPI_DRV_CIPHER_PKE_ECC_TYPE_MAX 13 最大值 UAPI_DRV_CIPHER_PKE_ECC_TYPE_INVALID 0xffffffff 无效值
uapi_drv_cipher_pke_rsa_scheme_t
typedef enum {
UAPI_DRV_CIPHER_PKE_RSA_SCHEME_PKCS1_V15 = 0x00, /* not security, suggest not to use */
UAPI_DRV_CIPHER_PKE_RSA_SCHEME_PKCS1_V21,
UAPI_DRV_CIPHER_PKE_RSA_SCHEME_MAX,
UAPI_DRV_CIPHER_PKE_RSA_SCHEME_INVALID = 0xffffffff,
} uapi_drv_cipher_pke_rsa_scheme_t;
枚举成员 取值 描述 UAPI_DRV_CIPHER_PKE_RSA_SCHEME_PKCS1_V15 0x00 PKCS1 V15填充方式，不建议使用 UAPI_DRV_CIPHER_PKE_RSA_SCHEME_PKCS1_V21 0x01 PKCS1 V21填充方式 UAPI_DRV_CIPHER_PKE_RSA_SCHEME_MAX 0x02 最大值 UAPI_DRV_CIPHER_PKE_RSA_SCHEME_INVALID 0xffffffff 无效值
uapi_drv_cipher_pke_hash_type_t
typedef enum {
UAPI_DRV_CIPHER_PKE_HASH_TYPE_SHA1 = 0x00, /* not security, suggest not to use */
UAPI_DRV_CIPHER_PKE_HASH_TYPE_SHA224,
UAPI_DRV_CIPHER_PKE_HASH_TYPE_SHA256,
UAPI_DRV_CIPHER_PKE_HASH_TYPE_SHA384,
UAPI_DRV_CIPHER_PKE_HASH_TYPE_SHA512,
UAPI_DRV_CIPHER_PKE_HASH_TYPE_SM3,
UAPI_DRV_CIPHER_PKE_HASH_TYPE_MAX,
UAPI_DRV_CIPHER_PKE_HASH_TYPE_INVALID = 0xffffffff,
} uapi_drv_cipher_pke_hash_type_t;
枚举成员 取值 描述 UAPI_DRV_CIPHER_PKE_HASH_TYPE_SHA1 0x00 SHA1摘要算法，不建议使用 UAPI_DRV_CIPHER_PKE_HASH_TYPE_SHA224 0x01 SHA224摘要算法，不建议使用 UAPI_DRV_CIPHER_PKE_HASH_TYPE_SHA256 0x02 SHA256摘要算法 UAPI_DRV_CIPHER_PKE_HASH_TYPE_SHA384 0x03 SHA384摘要算法 UAPI_DRV_CIPHER_PKE_HASH_TYPE_SHA512 0x04 SHA512摘要算法 UAPI_DRV_CIPHER_PKE_HASH_TYPE_SM3 0x05 SM3摘要算法 UAPI_DRV_CIPHER_PKE_HASH_TYPE_MAX 0x06 最大值 UAPI_DRV_CIPHER_PKE_HASH_TYPE_INVALID 0xffffffff 无效值
uapi_drv_cipher_pke_buffer_secure_t
typedef enum {
UAPI_DRV_CIPHER_PKE_BUF_NONSECURE = 0x00,
UAPI_DRV_CIPHER_PKE_BUF_SECURE,
UAPI_DRV_CIPHER_PKE_BUF_INVALID = 0xffffffff,
} uapi_drv_cipher_pke_buffer_secure_t;
枚举成员 取值 描述 UAPI_DRV_CIPHER_PKE_BUF_NONSECURE 0x00 非安全缓冲区 UAPI_DRV_CIPHER_PKE_BUF_SECURE 0x01 安全缓冲区 UAPI_DRV_CIPHER_PKE_BUF_INVALID 0xffffffff 无效值
Structures
uapi_drv_cipher_pke_data_t
typedef struct {
uint32_t length; /*!< PKE通用数据缓冲区长度。 */
uint8_t *data; /*!< PKE通用数据缓冲区。 */
} uapi_drv_cipher_pke_data_t;
成员说明：
成员名称 数据类型 描述 length uint32_t PKE通用数据缓冲区长度 data uint8_t * PKE通用数据缓冲区
uapi_drv_cipher_pke_ecc_point_t
typedef struct {
uint8_t *x; /*!< 公钥的X坐标，调用方确保如果此密钥的有效大小小于ecc密钥大小，则用前导零填充。 */
uint8_t *y; /*!< 公钥的Y坐标，调用方确保如果此密钥的有效大小小于ecc密钥大小，则用前导零填充。 */
uint32_t length; /*!< ECC公钥长度。 */
} uapi_drv_cipher_pke_ecc_point_t;
成员说明：
成员名称 数据类型 描述 x uint8_t * 公钥的X坐标，有效大小小于ecc密钥大小时用前导零填充 y uint8_t * 公钥的Y坐标，有效大小小于ecc密钥大小时用前导零填充 length uint32_t ECC公钥长度
uapi_drv_cipher_pke_ecc_sig_t
typedef struct {
uint8_t *r; /*!< ECC签名值R。 */
uint8_t *s; /*!< ECC签名值S。 */
uint32_t length; /*!< ECC签名数据长度。 */
} uapi_drv_cipher_pke_ecc_sig_t;
成员说明：
成员名称 数据类型 描述 r uint8_t * ECC签名值R s uint8_t * ECC签名值S length uint32_t ECC签名数据长度
uapi_drv_cipher_pke_msg_t
typedef struct {
uint32_t length; /*!< ECC输入消息缓冲区长度。 */
uint8_t *data; /*!< ECC输入消息缓冲区。 */
uapi_drv_cipher_pke_buffer_secure_t buf_sec;
} uapi_drv_cipher_pke_msg_t;
成员说明：
成员名称 数据类型 描述 length uint32_t ECC输入消息缓冲区长度 data uint8_t * ECC输入消息缓冲区 buf_sec uapi_drv_cipher_pke_buffer_secure_t 缓冲区安全属性
uapi_drv_cipher_pke_rsa_priv_key_t
typedef struct {
uint8_t *n; /*!< RSA秘钥参数n。 */
uint8_t *e; /*!< RSA公钥参数e。 */
uint8_t *d; /*!< RSA私钥参数d。 */
uint8_t *p; /*!< RSA第一素数因子。 */
uint8_t *q; /*!< RSA第二素数因子。 */
uint8_t *dp; /*!< D % (P - 1)的结果。 */
uint8_t *dq; /*!< D % (Q - 1)的结果。 */
uint8_t *qp; /*!< 1 / (Q % P)的结果。 */
uint16_t n_len; /*!< RSA秘钥参数n的长度。 */
uint16_t e_len; /*!< RSA公钥参数e的长度。 */
uint16_t d_len; /*!< RSA私钥参数d的长度。 */
uint16_t p_len; /*!< RSA第一素因子的长度，应该是n_len的一半。 */
uint16_t q_len; /*!< RSA第二素因子的长度，应该是n_len的一半。 */
uint16_t dp_len; /*!< D % (P - 1)结果的长度，应该是n_len的一半。 */
uint16_t dq_len; /*!< D % (Q - 1)结果的长度，应该是n_len的一半。 */
uint16_t qp_len; /*!< 1 / (Q % P)结果的长度，应该是n_len的一半。 */
} uapi_drv_cipher_pke_rsa_priv_key_t;
成员说明：
成员名称 数据类型 描述 n uint8_t * RSA秘钥参数n e uint8_t * RSA公钥参数e d uint8_t * RSA私钥参数d p uint8_t * RSA第一素数因子 q uint8_t * RSA第二素数因子 dp uint8_t * D % (P - 1)的结果 dq uint8_t * D % (Q - 1)的结果 qp uint8_t * 1 / (Q % P)的结果 n_len uint16_t RSA秘钥参数n的长度 e_len uint16_t RSA公钥参数e的长度 d_len uint16_t RSA私钥参数d的长度 p_len uint16_t RSA第一素因子的长度，应该是n_len的一半 q_len uint16_t RSA第二素因子的长度，应该是n_len的一半 dp_len uint16_t D % (P - 1)结果的长度，应该是n_len的一半 dq_len uint16_t D % (Q - 1)结果的长度，应该是n_len的一半 qp_len uint16_t 1 / (Q % P)结果的长度，应该是n_len的一半
uapi_drv_cipher_pke_rsa_pub_key_t
typedef struct {
uint8_t *n; /*!< RSA私钥参数d。 */
uint8_t *e; /*!< RSA公钥参数e。 */
uint16_t len; /*!< RSA公钥长度。 */
} uapi_drv_cipher_pke_rsa_pub_key_t;
成员说明：
成员名称 数据类型 描述 n uint8_t * RSA公钥参数n e uint8_t * RSA公钥参数e len uint16_t RSA公钥长度