PKC驱动API描述

hal_status_t hal_pkc_init(pkc_handle_t *p_pkc)

根据pkc_init_t里的参数初始化PKC外设和初始化关联句柄。

p_pkc：指向pkc_handle_t结构体变量的指针，该结构体变量包含指定的PKC的配置信息。

HAL状态。

hal_status_t hal_pkc_deinit(pkc_handle_t *p_pkc)

反初始化PKC外设。

p_pkc：指向pkc_handle_t结构体变量的指针，该结构体变量包含指定的PKC的配置信息。

HAL状态。

void hal_pkc_msp_init(pkc_handle_t *p_pkc)

初始化PKC外设所使用的NVIC中断等配置。

p_pkc：指向pkc_handle_t结构体变量的指针。

无

该函数为weak类型的空函数，开发者需重写该API完成NVIC中断的初始化。

void hal_pkc_msp_deinit(pkc_handle_t *p_pkc)

反初始化PKC外设所使用的NVIC中断等配置。

p_pkc：指向pkc_handle_t结构体变量的指针。

无

该函数为weak类型的空函数，开发者需重写该API完成NVIC中断的反初始化。

hal_status_t hal_pkc_rsa_modular_exponent(pkc_handle_t *p_pkc, pkc_rsa_modular_exponent_t *p_input, uint32_t timeout)

实现RSA算法中模幂运算：Result = A^B mod P，运算数最大位数2048 bits，结果数最大位数2048 bits，轮询方式。

p_pkc：指向pkc_handle_t结构体变量的指针。

p_input：指向输入参数pkc_rsa_modular_exponent_t结构体变量的指针。

timeout：超时时间。

HAL状态。

hal_status_t hal_pkc_ecc_point_multi(pkc_handle_t *p_pkc, pkc_ecc_point_multi_t *p_input, uint32_t timeout)

实现ECC椭圆算法中点乘运算：Result = K * Point，运算数最大位数2048 bits，结果数最大位数2048 bits，轮询方式。

p_pkc：指向pkc_handle_t结构体变量的指针。

p_input：指向输入参数pkc_ecc_point_multi_t结构体变量的指针。

timeout：超时时间。

HAL状态。

hal_status_t hal_pkc_ecc_point_multi_it(pkc_handle_t *p_pkc, pkc_ecc_point_multi_t *p_input)

实现ECC椭圆算法中点乘运算：Result = K * Point，运算数最大位数2048 bits，结果数最大位数2048 bits，中断方式。

p_pkc：指向pkc_handle_t结构体变量的指针。

p_input：指向输入参数pkc_ecc_point_multi_t结构体变量的指针。

HAL状态。

hal_status_t hal_pkc_modular_add(pkc_handle_t *p_pkc, pkc_modular_add_t *p_input, uint32_t timeout)

实现模加运算：Result = (A + B) mod P，运算数最大位数2048 bits，结果数最大位数2048 bits，轮询方式。

p_pkc：指向pkc_handle_t结构体变量的指针。

p_input：指向输入参数pkc_modular_add_t结构体变量的指针。

timeout：超时时间。

HAL状态。

hal_status_t hal_pkc_modular_add_it(pkc_handle_t *p_pkc, pkc_modular_add_t *p_input)

实现模加运算：Result = (A + B) mod P，运算数最大位数2048 bits，结果数最大位数2048 bits，中断方式。

p_pkc：指向pkc_handle_t结构体变量的指针。

p_input：指向输入参数pkc_modular_add_t结构体变量的指针。

HAL状态。

hal_status_t hal_pkc_modular_sub(pkc_handle_t *p_pkc, pkc_modular_sub_t *p_input, uint32_t timeout)

实现模减运算：Result = (A - B) mod P，运算数最大位数2048 bits，结果数最大位数2048 bits，轮询方式。

p_pkc：指向pkc_handle_t结构体变量的指针。

p_input：指向输入参数pkc_modular_sub_t结构体变量的指针。

timeout：超时时间。

HAL状态。

hal_status_t hal_pkc_modular_sub_it(pkc_handle_t *p_pkc, pkc_modular_sub_t *p_input)

实现模减运算：Result = (A - B) mod P，运算数最大位数2048 bits，结果数最大位数2048 bits，中断方式。

p_pkc：指向pkc_handle_t结构体变量的指针。

p_input：指向输入参数pkc_modular_sub_t结构体变量的指针。

HAL状态。

hal_status_t hal_pkc_modular_left_shift(pkc_handle_t *p_pkc, pkc_modular_shift_t *p_input, uint32_t timeout)

实现模左移运算：Result = (A << ShiftBits) mod P，运算数最大位数2048 bits，结果数最大位数2048 bits，轮询方式。

p_pkc：指向pkc_handle_t结构体变量的指针。

p_input：指向输入参数pkc_modular_shift_t结构体变量的指针。

timeout：超时时间。

HAL状态。

hal_status_t hal_pkc_modular_left_shift_it(pkc_handle_t *p_pkc, pkc_modular_shift_t *p_input)

实现模左移运算：Result = (A << ShiftBits) mod P，运算数最大位数2048 bits，结果数最大位数2048 bits，中断方式。

p_pkc：指向pkc_handle_t结构体变量的指针。

p_input：指向输入参数pkc_modular_shift_t结构体变量的指针。

HAL状态。

hal_status_t hal_pkc_modular_compare(pkc_handle_t *p_pkc, pkc_modular_compare_t *p_input, uint32_t timeout)

实现模比较运算：Result = A mod P，运算数最大位数2048 bits，结果数最大位数2048 bits，轮询方式。

p_pkc：指向pkc_handle_t结构体变量的指针。

p_input：指向输入参数pkc_modular_compare_t结构体变量指针。

timeout：超时时间。

HAL状态。

hal_status_t hal_pkc_modular_compare_it(pkc_handle_t *p_pkc, pkc_modular_compare_t *p_input)

实现模比较运算：Result = A mod P，运算数最大位数2048 bits，结果数最大位数2048 bits，中断方式。

p_pkc：指向pkc_handle_t结构体变量的指针。

p_input：指向输入参数pkc_modular_compare_t结构体变量指针。

HAL状态。

hal_status_t hal_pkc_montgomery_multi(pkc_handle_t *p_pkc, pkc_montgomery_multi_t *p_input, uint32_t timeout)

实现模乘运算：Result = A * B mod P，运算数最大位数2048 bits，结果数最大位数2048 bits，轮询方式。

p_pkc：指向pkc_handle_t结构体变量的指针。

p_input：指向输入参数pkc_montgomery_multi_t结构体变量的指针。

timeout：超时时间。

HAL状态。

hal_status_t hal_pkc_montgomery_multi_it(pkc_handle_t *p_pkc, pkc_montgomery_multi_t *p_input)

实现模乘运算：Result = A * B mod P，运算数最大位数2048 bits，结果数最大位数2048 bits，中断方式。

p_pkc：指向pkc_handle_t结构体变量的指针。

p_input：指向输入参数pkc_montgomery_multi_t结构体变量的指针。

HAL状态。

hal_status_t hal_pkc_montgomery_inversion(pkc_handle_t *p_pkc, pkc_montgomery_inversion_t *p_input, uint32_t *p_K, uint32_t timeout)

实现模逆运算：Result = A^(-1) mod P，运算数最大位数2048 bits，结果数最大位数2048 bits，轮询方式。

p_pkc：指向pkc_handle_t结构体变量的指针。

p_input：指向输入参数pkc_montgomery_inversion_t结构体变量的指针。

p_K：指向输出参数K的指针。

timeout：超时时间。

HAL状态。

hal_status_t hal_pkc_montgomery_inversion_it(pkc_handle_t *p_pkc, pkc_montgomery_inversion_t *p_input, uint32_t *p_K)

实现模逆运算：Result = A^(-1) mod P，运算数最大位数2048 bits，结果数最大位数2048 bits，中断方式。

p_pkc：指向pkc_handle_t结构体变量的指针。

p_input：指向输入参数pkc_montgomery_inversion_t结构体变量的指针。

p_K：指向输出参数K的指针。

HAL状态。

hal_status_t hal_pkc_big_number_multi(pkc_handle_t *p_pkc, pkc_big_number_multi_t *p_input, uint32_t timeout)

实现大数乘运算：Result = A * B，运算数最大位数1024 bits，结果数最大位数2048 bits，轮询方式。

p_pkc：指向pkc_handle_t结构体变量的指针。

p_input：指向输入参数pkc_big_number_multi_t结构体变量的指针。

timeout：超时时间。

HAL状态。

hal_status_t hal_pkc_big_number_multi_it(pkc_handle_t *p_pkc, pkc_big_number_multi_t *p_input)

实现大数乘运算：Result = A * B，运算数最大位数1024 bits，结果数最大位数2048 bits，中断方式。

p_pkc：指向pkc_handle_t结构体变量的指针。

p_input：指向输入参数pkc_big_number_multi_t结构体变量的指针。

HAL状态。

hal_status_t hal_pkc_big_number_add(pkc_handle_t *p_pkc, pkc_big_number_add_t *p_input, uint32_t timeout)

实现大数加运算：Result = A + B，运算数最大位数2048 bits，结果数最大位数2048 bits，轮询方式。

p_pkc：指向pkc_handle_t结构体变量的指针。

p_input：指向输入参数pkc_big_number_add_t结构体变量的指针。

timeout：超时时间。

HAL状态。

hal_status_t hal_pkc_big_number_add_it(pkc_handle_t *p_pkc, pkc_big_number_add_t *p_input)

实现大数加运算：Result = A + B，运算数最大位数2048 bits，结果数最大位数2048 bits，中断方式。

p_pkc：指向pkc_handle_t结构体变量的指针。

p_input：指向输入参数pkc_big_number_add_t结构体变量的指针。

HAL状态。

void hal_pkc_irq_handler(pkc_handle_t *p_pkc)

处理PKC中断请求。

p_pkc：指向pkc_handle_t结构体变量的指针。

无

void hal_pkc_done_callback(pkc_handle_t *p_pkc)

PKC运算完成回调。

p_pkc：指向pkc_handle_t结构体变量的指针。

无

该函数为weak类型的空函数，当开发者需要使用该回调函数时，可重写该API。

void hal_pkc_error_callback(pkc_handle_t *p_pkc)

PKC运算错误回调。

p_pkc：指向pkc_handle_t结构体变量的指针。

无

该函数为weak类型的空函数，当开发者需要使用该回调函数时，可重写该API。

void hal_pkc_overflow_callback(pkc_handle_t *p_pkc)

PKC大数乘/加运算溢出回调。

p_pkc：指向pkc_handle_t结构体变量的指针。

无

该函数为weak类型的空函数，当开发者需要使用该回调函数时，可重写该API。

hal_pkc_state_t hal_pkc_get_state(pkc_handle_t *p_pkc)

获取PKC运行状态。

p_pkc：指向pkc_handle_t结构体变量的指针。

uint32_t hal_pkc_get_error(pkc_handle_t *p_pkc)

获取PKC错误码。

p_pkc：指向pkc_handle_t结构体变量的指针。

void hal_pkc_set_timeout(pkc_handle_t *p_pkc , uint32_t timeout)

设置PKC运算超时时间。

p_pkc：指向pkc_handle_t结构体变量的指针。

timeout：运算超时时间。

无