8.3.5. 设计说明

8.3.5.1. 源码说明

  • bsp/zx/drv/ce/drv_ce.c,CE Driver 层实现

  • bsp/zx/hal/ce/hal_ce.c,CE HAL 层实现

  • bsp/zx/include/hal/hal_ce.h,CE HAL 层接口头文件

8.3.5.2. 模块架构

CE 驱动 Driver 层采用 RT-Thread 的 HWCRYPTO 设备驱动框架,如果只使用HAL层也可以支持 baremetal 方式的应用场景。

../../../_images/sw_system.png

图 8.6 CE 驱动的软件架构图

8.3.5.3. Driver 层接口设计

8.3.5.3.1. drv_aes_init

函数原型

rt_err_t drv_aes_init(struct rt_hwcrypto_ctx *ctx)

功能说明

AES 算法初始化

参数定义

struct rt_hwcrypto_ctx *ctx - 上下文实例指针

返回值

0,初始化成功;其它,初始化失败

注意事项

8.3.5.3.2. aes_ecb_crypto

函数原型

s32 aes_ecb_crypto(u8 *key, u8 keylen, u8 dir, u8 *in, u8 *out, u32 len)

功能说明

AES ECB 加解密实现

参数定义

u8 *key - 密钥的指针
u8 keylen - 密钥的长度
u8 dir - 运算方向;0,加密;1,解密
u8 *in - 输入数据
u8 *out - 输出数据
u32 len - 数据长度

返回值

0,加解密成功;其它,加解密失败。

注意事项

8.3.5.3.3. aes_cbc_crypto

函数原型

s32 aes_cbc_crypto(u8 *key, u8 keylen, u8 dir, u8 *iv, u8 *in, u8 *out, u32 len)

功能说明

AES CBC 加解密实现

参数定义

u8 *key - 密钥的指针
u8 keylen - 密钥的长度
u8 dir - 运算方向;0,加密;1,解密
u8 *iv - 输入 iv
u8 *in - 输入数据
u8 *out - 输出数据
u32 len - 数据长度

返回值

0,加解密成功;其它,加解密失败。

注意事项

8.3.5.3.4. drv_sha_init

函数原型

rt_err_t drv_sha_init(struct rt_hwcrypto_ctx *ctx)

功能说明

SHA 算法初始化

参数定义

struct rt_hwcrypto_ctx *ctx - 上下文实例指针

返回值

0,初始化成功;其它,初始化失败

注意事项

8.3.5.3.5. drv_sha_start

函数原型

rt_err_t drv_sha_start(struct rt_hwcrypto_ctx *ctx)

功能说明

SHA 算法启动

参数定义

struct rt_hwcrypto_ctx *ctx - 上下文实例指针

返回值

0,初始化成功;其它,初始化失败

注意事项

8.3.5.3.6. drv_sha_update

函数原型

rt_err_t drv_sha_update(aic_sha_context_t *context, const void *input, uint32_t size)

功能说明

更新一笔 SHA 算法数据

参数定义

struct rt_hwcrypto_ctx *ctx - 上下文实例指针
void *input - 输入数据
uint32_t size - 输入数据长度

返回值

0,运算成功;其它,运算失败

注意事项

8.3.5.3.7. drv_sha_finish

函数原型

rt_err_t drv_sha_finish(struct hwcrypto_hash *ctx, void *output, rt_size_t *out_size)

功能说明

SHA 算法运算结束,获取结果

参数定义

struct hwcrypto_hash *ctx - 上下文 HASH 实例指针
void *output - 输出数据
rt_size_t *out_size - 输出数据长度

返回值

0,获取结果成功;其它,获取结果失败

注意事项

8.3.5.4. HAL 层接口设计

HAL 层的函数接口声明存放在 hal_ce.h 中,主要接口有:

s32 hal_crypto_init(void);
s32 hal_crypto_deinit(void);
void hal_crypto_irq_handler();
s32 hal_crypto_start_symm(struct crypto_task *task);
s32 hal_crypto_start_asym(struct crypto_task *task);
s32 hal_crypto_start_hash(struct crypto_task *task);
u32 hal_crypto_poll_finish(u32 alg_unit);
void hal_crypto_pending_clear(u32 alg_unit);
u32 hal_crypto_get_err(u32 alg_unit);
s32 hal_crypto_bignum_byteswap(u8 *bn, u32 len);
s32 hal_crypto_bignum_le2be(u8 *src, u32 slen, u8 *dst, u32 dlen);
s32 hal_crypto_bignum_be2le(u8 *src, u32 slen, u8 *dst, u32 dlen);