K Standalone SDK 编程指南 KENDRYTE 勘智嘉楠科技版权 2019 KENDRYTE.COM

Size: px

Start display at page:

Download "K Standalone SDK 编程指南 KENDRYTE 勘智嘉楠科技版权 2019 KENDRYTE.COM"

背樊
5 years ago
Views:

1 K Standalone SDK 编程指南 KENDRYTE 勘智嘉楠科技版权 2019 KENDRYTE.COM

2 i 关于本手册本文档为用户提供基于 Kendryte K210 Standalone SDK 开发时的编程指南. 对应 SDK 版本 Kendryte Standalone SDK v0.5.6 (9410af7ca bce9523dd2dab56ad2b8c243) 发布说明日期版本发布说明 V0.1.0 初始版本 V0.2.0 发布对应 Standalone SDK v0.4.0 的文档 V0.3.0 发布对应 Standalone SDK v0.5.1 的文档 V0.4.0 发布对应 Standalone SDK v0.5.3 的文档 V0.5.0 发布对应 Standalone SDK v0.5.6 的文档免责声明本文中的信息, 包括参考的 URL 地址, 如有变更, 恕不另行通知文档按现状提供, 不负任何担保责任, 包括对适销性适用于特定用途或非侵权性的任何担保, 和任何提案规格或样品在他处提到的任何担保本文档不负任何责任, 包括使用本文档内信息产生的侵犯任何专利权行为的责任本文档在此未以禁止反言或其他方式授予任何知识产权使用许可, 不管是明示许可还是暗示许可文中提到的所有商标名称商标和注册商标均属其各自所有者的财产, 特此声明版权公告版权归 2019 嘉楠科技所有保留所有权利

3 ii 目录关于本手册对应 SDK 版本发布说明免责声明版权公告 i i i i i 第 1 章神经网络处理器 (KPU) 概述功能描述 API 参考数据类型第 2 章麦克风阵列处理器 (APU) 概述功能描述 API 参考数据类型第 3 章高级加密加速器 (AES) 功能描述 API 参考数据类型第 4 章中断 PLIC 概述功能描述

4 目录 iii 4.3 API 参考数据类型第 5 章通用输入 / 输出 (GPIO) 概述功能描述 API 参考数据类型第 6 章通用高速输入 / 输出 (GPIOHS) 概述功能描述 API 参考数据类型第 7 章现场可编程 IO 阵列 (FPIOA) 概述功能描述 API 参考数据类型第 8 章数字摄像头接口 (DVP) 概述功能描述 API 参考数据类型第 9 章快速傅里叶变换加速器 (FFT) 概述功能描述 API 参考数据类型第 10 章安全散列算法加速器 (SHA256) 功能描述 API 参考例程第 11 章通用异步收发传输器 (UART) 124

5 目录 iv 11.1 概述功能描述 API 参考数据类型第 12 章高速通用异步收发传输器 (UARTHS) 概述功能描述 API 参考数据类型第 13 章看门狗定时器 (WDT) 概述功能描述 API 参考数据类型第 14 章直接内存存取控制器 (DMAC) 概述功能描述 API 参考数据类型第 15 章集成电路内置总线 (I²C) 概述功能描述 API 参考数据类型第 16 章串行外设接口 (SPI) 概述功能描述 API 参考数据类型第 17 章集成电路内置音频总线 (I2S) 概述功能描述 API 参考

6 目录 v 17.4 数据类型第 18 章定时器 (TIMER) 概述功能描述 API 参考数据类型第 19 章实时时钟 (RTC) 概述功能描述 API 参考第 20 章脉冲宽度调制器 (PWM) 概述功能描述 API 参考数据类型第 21 章系统控制概述功能描述 API 参考数据类型第 22 章平台相关 (BSP) 概述功能描述 API 参考数据类型

7 1 第 1 章神经网络处理器 (KPU) 1.1 概述 KPU 是通用的神经网络处理器, 它可以在低功耗的情况下实现卷积神经网络计算, 实时获取被检测目标的大小坐标和种类, 对人脸或者物体进行检测和分类使用 kpu 时, 必须结合 model compiler 1.2 功能描述 KPU 具备以下几个特点 : 支持主流训练框架按照特定限制规则训练出来的定点化模型对网络层数无直接限制, 支持每层卷积神经网络参数单独配置, 包括输入输出通道数目输入输出行宽列高支持两种卷积内核 1x1 和 3x3 支持任意形式的激活函数实时工作时最大支持神经网络参数大小为 5.5MiB 到 5.9MiB 非实时工作时最大支持网络参数大小为 (Flash 容量 - 软件体积 ) 1.3 API 参考对应的头文件 kpu.h 为用户提供以下接口 kpu_task_init (0.6.0 以后不再支持, 请使用 kpu_single_task_init) kpu_run (0.6.0 以后不再支持, 请使用 kpu_start) kpu_get_output_buf (0.6.0 以后不再支持 )

8 第 1 章神经网络处理器 (KPU) 2 kpu_release_output_buf (0.6.0 以后不再支持 ) kpu_start kpu_single_task_init kpu_single_task_deinit kpu_model_load_from_buffer kpu_load_kmodel kpu_model_free kpu_get_output kpu_run_kmodel kpu_task_init 描述初始化 kpu 任务句柄, 该函数具体实现在 model compiler 生成的 gencode_output.c 中函数定义 kpu_task_t kpu_task_init ( kpu_task_t task ) 参数参数名称描述输入输出 task KPU 任务句柄输入返回值 KPU 任务句柄 kpu_run 描述启动 KPU, 进行 AI 运算函数原型 int kpu_run ( kpu_task_t v_task, dmac_channel_number_t dma_ch, const void src, void dest, plic_irq_callback_t callback )

9 第 1 章神经网络处理器 (KPU) 参数参数名称描述输入输出 task KPU 任务句柄输入 dma_ch DMA 通道输入 src 输入图像数据输入 dest 运算输出结果输出 callback 运算完成回调函数输入返回值返回值描述 0 成功非 0 KPU 忙, 失败 kpu_get_output_buf 描述获取 KPU 输出结果的缓存函数原型 uint8_t kpu_get_output_buf ( kpu_task_t task ) 参数参数名称描述输入输出 task KPU 任务句柄输入返回值 KPU 输出结果的缓存的指针

10 第 1 章神经网络处理器 (KPU) kpu_release_output_buf 描述释放 KPU 输出结果缓存函数原型 void kpu_release_output_buf ( uint8_t output_buf ) 参数参数名称描述输入输出 output_buf KPU 输出结果缓存输入返回值无 kpu_start 描述启动 KPU, 进行 AI 运算函数原型 int kpu_start ( kpu_task_t task ) 参数参数名称描述输入输出 task KPU 任务句柄输入返回值返回值描述 0 成功

11 第 1 章神经网络处理器 (KPU) 5 返回值非 0 描述 KPU 忙, 失败 kpu_single_task_init 描述初始化 kpu 任务句柄函数原型 int kpu_single_task_init ( kpu_task_t task ) 参数参数名称描述输入输出 task KPU 任务句柄输入返回值返回值描述 0 成功非 0 失败 kpu_single_task_deinit 描述注销 kpu 任务函数原型 int kpu_single_task_deinit ( kpu_task_t task ) 参数

12 第 1 章神经网络处理器 (KPU) 6 参数名称描述输入输出 task KPU 任务句柄输入返回值返回值描述 0 成功非 0 失败 kpu_model_load_from_buffer 描述解析 kmodel 并初始化 kpu 句柄函数原型 int kpu_model_load_from_buffer ( kpu_task_t task, uint8_t buffer, kpu_model_layer_metadata_t meta ); 参数参数名称描述输入输出 task KPU 任务句柄输入 buffer kmodel 数据输入 meta 内部测试数据, 用户设置为 NULL 输出返回值返回值描述 0 成功非 0 失败

13 第 1 章神经网络处理器 (KPU) kpu_load_kmodel 描述加载 kmodel, 需要与 nncase 配合使用函数原型 int kpu_load_kmodel ( kpu_model_context_t ctx, const uint8_t buffer ) 参数参数名称描述输入输出 ctx KPU 任务句柄输入 buffer kmodel 数据输入返回值返回值描述 0 成功非 0 失败 kpu_model_free 描述释放 kpu 资源函数原型 void kpu_model_free ( kpu_model_context_t ctx ) 参数参数名称描述输入输出 ctx KPU 任务句柄输入

14 第 1 章神经网络处理器 (KPU) 返回值 kpu_get_output 描述获取 KPU 最终处理的结果函数原型 int kpu_get_output ( kpu_model_context_t ctx, uint32_t index, uint8_t data, size_t size ) 参数参数名称描述输入输出 ctx KPU 任务句柄输入 index 结果的索引值, 如 kmodel 有关输入 data 结果输入 size 大小 ( 字节 ) 输入返回值返回值描述 0 成功非 0 失败 kpu_run_kmodel 描述运行 kmodel 函数原型 int kpu_run_kmodel ( kpu_model_context_t ctx, const uint8_t src, dmac_channel_number_t dma_ch, kpu_done_callback_t done_callback, void userdata )

15 第 1 章神经网络处理器 (KPU) 参数参数名称描述输入输出 ctx KPU 任务句柄输入 src 源数据输入 dma_ch DMA 通道输入 done_callback 完成后回调函数输入 userdata 回调的参数输入返回值返回值描述 0 成功非 0 失败举例 / 通过 MC 生成 kpu_task_gencode_output_init, 设置源数据为 g _ a i _ b u f, 使用 D M A 5,kpu 完成后调用 ai_done 函数 / kpu_task_t task ; volatile uint8_t g_ai_done_flag ; static int ai_done ( void ctx) { g_ai_done_flag = 1; return 0; } / 初始化 kpu / kpu_task_gencode_output_init (& task ); / MC 生成的函数 / task. src = g_ai_buf ; task. dma_ch = 5; task. callback = ai_done ; kpu_single_task_init (& task ); / 启动 kpu / kpu_start (& task ); 1.4 数据类型相关数据类型数据结构定义如下 :

16 第 1 章神经网络处理器 (KPU) 10 kpu_task_t:kpu 任务结构体 kpu_task_t 描述 kpu 任务结构体定义 typedef struct { kpu_layer_argument_t layers ; kpu_layer_argument_t remain_layers ; plic_irq_callback_t callback ; void ctx; uint64_t src; uint64_t dst; uint32_t src_length ; uint32_t dst_length ; uint32_t layers_length ; uint32_t remain_layers_length ; dmac_channel_number_t dma_ch ; uint32_t eight_bit_mode ; float output_scale ; float output_bias ; float input_scale ; float input_bias ; } kpu_task_t ; 成员成员名称描述 layers KPU 参数指针 (MC 初始化, 用户不必关心 ) remain_layers KPU 参数指针 ( 运算过程中使用, 用户不必关心 ) callback 运算完成回调函数 ( 需要用户设置 ) ctx 回调函数的参数 ( 非空需要用户设置 ) src 运算源数据 ( 需要用户设置 ) dst 运算结果输出指针 (KPU 初始化赋值, 用户不必关心 ) src_length 源数据长度 (MC 初始化, 用户不必关心 ) dst_length 运算结果长度 (MC 初始化, 用户不必关心 ) layers_length 层数 (MC 初始化, 用户不必关心 ) remain_layers_length 剩余层数 ( 运算过程中使用, 用户不必关心 )

17 第 1 章神经网络处理器 (KPU) 11 成员名称描述 dma_ch 使用的 DMA 通道号 ( 需要用户设置 ) eight_bit_mode 是否是 8 比特模式 (MC 初始化, 用户不必关心 ) output_scale 输出 scale 值 (MC 初始化, 用户不必关心 ) output_bias 输出 bias 值 (MC 初始化, 用户不必关心 ) input_scale 输入 scale 值 (MC 初始化, 用户不必关心 ) input_bias 输入 bias 值 (MC 初始化, 用户不必关心 )

18 12 第 2 章麦克风阵列处理器 (APU) 2.1 概述 APU 麦克风阵列语音数据加速计算处理器, 能够实时计算不同方向的语音延时累加值, 通过这个值来判断语音方向, 以及选取某一方向的增强语音数据 2.2 功能描述 APU 具备以下几个特点 : 支持最多八个麦克风的数据可以实时计算 16 个方向的语音延时累加值支持选定方向的增强语音输出 2.3 API 参考对应的头文件 apu.h 为用户提供以下接口 audio_bf_dir_set_prev_fir audio_bf_dir_set_post_fir audio_bf_voc_set_prev_fir audio_bf_voc_set_post_fir audio_bf_set_delay audio_bf_voc_set_direction audio_bf_set_channel_enabled

19 第 2 章麦克风阵列处理器 (APU) 13 audio_bf_dir_enable audio_bf_voc_enable audio_bf_dir_set_prev_fir 描述在计算各个方向的延时累加值之前的 fir 滤波系数函数定义 void audio_bf_dir_set_prev_fir ( uint16_t fir_coef ) 参数参数名称描述输入输出 fir_coef 17 位滤波系数指针输入返回值 audio_bf_dir_set_post_fir 描述在计算各个方向的延时累加值之后的 fir 滤波系数函数原型 void audio_bf_dir_set_post_fir ( uint16_t fir_coef ) 参数参数名称描述输入输出 fir_coef 17 位滤波系数指针输入

20 第 2 章麦克风阵列处理器 (APU) 返回值 audio_bf_voc_set_prev_fir 描述在计算选定方向的延时累加值之前的 fir 滤波系数函数原型 void audio_bf_voc_set_prev_fir ( uint16_t fir_coef ) 参数参数名称描述输入输出 fir_coef 17 位滤波系数指针输入返回值 audio_bf_voc_set_post_fir 描述在计算选定方向的延时累加值之后的 fir 滤波系数函数原型 void audio_bf_voc_set_post_fir ( uint16_t fir_coef ) 参数参数名称描述输入输出 fir_coef 17 位滤波系数指针输入返回值

21 第 2 章麦克风阵列处理器 (APU) audio_bf_set_delay 描述初始化圆形麦克风阵列板子上麦克风之间的声波延时参数函数原型 void audio_bf_set_delay ( float R, uint8_t mic_num_a_circle, uint8_t center, float I2s_fs ) 参数参数名称描述输入输出 R 麦克风围成的圆半径输入 micnuma_circle 在圆周上的麦克风个数输入 center 圆心点上是否有麦克风输入 I2s_fs 麦克风采样率输入返回值 audio_bf_voc_set_direction 描述选择语音增强的方向函数原型 void audio_bf_voc_set_direction ( enum en_bf_dir direction ) 参数参数名称描述输入输出 direction 选择语音增强的方向, 取 0~15 输入

22 第 2 章麦克风阵列处理器 (APU) 返回值 audio_bf_set_channel_enabled 描述选择使用的麦克风通道,I2S 可用 4 路, 每路有左右声道, 共 8 个通道, 相应位为 1, 则选择使用这个通道函数原型 void audio_bf_set_channel_enabled ( uint8_t channel_bit ) 参数参数名称描述输入输出 channel_bit 相应位为 1, 则选择使用这个通道输入返回值 audio_bf_dir_enable 描述使能各个方向的延时累加计算函数原型 void audio_bf_dir_enable ( void ) 参数返回值

23 第 2 章麦克风阵列处理器 (APU) audio_bf_voc_enable 描述使能选定方向的延时累加计算函数原型 void audio_bf_voc_enable ( uint8_t enable_flag ) 参数返回值举例 uint16_t fir_prev_t [17] = { 0x8000, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, }; audio_bf_dir_set_prev_fir ( fir_prev_t ); audio_bf_dir_set_post_fir ( fir_post_t ); audio_bf_voc_set_prev_fir ( fir_prev_t ); audio_bf_voc_set_post_fir ( fir_post_t ); audio_bf_set_delay (3, 7, 1, 44100); audio_bf_voc_set_direction (0); audio_bf_set_channel_enabled (0 xff ); audio_bf_dir_enable (); audio_bf_voc_enable (1); 2.4 数据类型相关数据类型数据结构定义如下 : apu_reg_t:apu 任务结构体

24 第 2 章麦克风阵列处理器 (APU) apu_reg_t 描述 kpu 任务结构体定义 typedef struct _apu_reg { //0 x200 apu_ch_cfg_t bf_ch_cfg_reg ; //0 x204 apu_ctl_t bf_ctl_reg ; //0 x208 apu_dir_bidx_t bf_dir_bidx [16][2]; //0 x288 apu_fir_coef_t bf_pre_fir0_coef [9]; //0 x2ac apu_fir_coef_t bf_post_fir0_coef [9]; //0 x2d0 apu_fir_coef_t bf_pre_fir1_coef [9]; //0 x2f4 apu_fir_coef_t bf_post_fir1_coef [9]; //0 x318 apu_dwsz_cfg_t bf_dwsz_cfg_reg ; //0 x31c apu_fft_cfg_t bf_fft_cfg_reg ; // 0 x320 volatile uint32_t sobuf_dma_rdata ; // 0 x324 volatile uint32_t vobuf_dma_rdata ; / 0 x328 / apu_int_stat_t bf_int_stat_reg ; / 0 x32c / apu_int_mask_t bf_int_mask_reg ; / 0 x330 / uint32_t saturation_counter ; / 0 x334 / uint32_t saturation_limits ; } attribute (( packed, aligned (4))) apu_reg_t ; 成员成员名称 bf_ch_cfg_reg bf_ctl_reg 描述通道配置控制寄存器

25 第 2 章麦克风阵列处理器 (APU) 19 成员名称 bf_dir_bidx[16][2] bf_pre_fir0_coef[9] bf_post_fir0_coef[9] bf_pre_fir1_coef[9] bf_post_fir1_coef[9] bf_dwsz_cfg_reg bf_fft_cfg_reg sobuf_dma_rdata vobuf_dma_rdata bf_int_stat_reg bf_int_mask_reg saturation_counter saturation_limits 描述各个方向延时累加计算前滤波系数各个方向延时累加计算后滤波系数计算选定方向延时累加值之前滤波系数计算选定方向延时累加值之后滤波系数下采样系数 fft 控制寄存器方向数据源地址选定方向数据源地址中断状态寄存器中断选定寄存器

26 20 第 3 章高级加密加速器 (AES) 3.1 功能描述 K210 内置 AES( 高级加密加速器 ), 相对于软件可以极大的提高 AES 运算速度 AES 加速器支持多种加密 / 解密模式 (ECB,CBC,GCM), 多种长度的 KEY(128,192,256) 的运算 3.2 API 参考对应的头文件 aes.h 为用户提供以下接口 aes_ecb128_hard_encrypt aes_ecb128_hard_decrypt aes_ecb192_hard_encrypt aes_ecb192_hard_decrypt aes_ecb256_hard_encrypt aes_ecb256_hard_decrypt aes_cbc128_hard_encrypt aes_cbc128_hard_decrypt aes_cbc192_hard_encrypt aes_cbc192_hard_decrypt aes_cbc256_hard_encrypt aes_cbc256_hard_decrypt aes_gcm128_hard_encrypt aes_gcm128_hard_decrypt aes_gcm192_hard_encrypt

27 第 3 章高级加密加速器 (AES) 21 aes_gcm192_hard_decrypt aes_gcm256_hard_encrypt aes_gcm256_hard_decrypt aes_ecb128_hard_encrypt_dma aes_ecb128_hard_decrypt_dma aes_ecb192_hard_encrypt_dma aes_ecb192_hard_decrypt_dma aes_ecb256_hard_encrypt_dma aes_ecb256_hard_decrypt_dma aes_cbc128_hard_encrypt_dma aes_cbc128_hard_decrypt_dma aes_cbc192_hard_encrypt_dma aes_cbc192_hard_decrypt_dma aes_cbc256_hard_encrypt_dma aes_cbc256_hard_decrypt_dma aes_gcm128_hard_encrypt_dma aes_gcm128_hard_decrypt_dma aes_gcm192_hard_encrypt_dma aes_gcm192_hard_decrypt_dma aes_gcm256_hard_encrypt_dma aes_gcm256_hard_decrypt_dma aes_init aes_process gcm_get_tag aes_ecb128_hard_encrypt 描述 AES-ECB-128 加密运算输入输出数据都使用 cpu 传输 ECB 加密将明文按照固定大小 16bytes 的块进行加密的, 块大小不足则进行填充 ECB 模式没有用到向量函数原型 void aes_ecb128_hard_encrypt ( uint8_t input_key, uint8_t input_data, size_t input_len, uint8_t output_data )

28 第 3 章高级加密加速器 (AES) 参数参数名称描述输入输出 input_key AES-ECB-128 加密的密钥输入 input_data AES-ECB-128 待加密的明文输入数据 input_len AES-ECB-128 待加密明文数输入据的长度 output_data AES-ECB-128 加密运算后的结果存放在这个 buffer 这个 buffer 的大小需要保证 16bytes 对齐输出返回值 aes_ecb128_hard_decrypt 描述 AES-ECB-128 解密运算输入输出数据都使用 cpu 传输 ECB 加密将明文按照固定大小 16bytes 的块进行加密的, 块大小不足则进行填充 ECB 模式没有用到向量函数原型 void aes_ecb128_hard_decrypt ( uint8_t input_key, uint8_t input_data, size_t input_len, uint8_t output_data ) 参数参数名称描述输入输出 input_key AES-ECB-128 解密的密钥输入 input_data AES-ECB-128 待解密的密文输入数据 input_len AES-ECB-128 待解密密文数据的长度输入

29 第 3 章高级加密加速器 (AES) 23 参数名称描述输入输出 output_data AES-ECB-128 解密运算后的结果存放在这个 buffer 这个 buffer 的大小需要保证 16bytes 对齐输出返回值 aes_ecb192_hard_encrypt 描述 AES-ECB-192 加密运算输入输出数据都使用 cpu 传输 ECB 加密将明文按照固定大小 16bytes 的块进行加密的, 块大小不足则进行填充 ECB 模式没有用到向量函数原型 void aes_ecb192_hard_encrypt ( uint8_t input_key, uint8_t input_data, size_t input_len, uint8_t output_data ) 参数参数名称描述输入输出 input_key AES-ECB-192 加密的密钥输入 input_data AES-ECB-192 待加密的明文输入数据 input_len AES-ECB-192 待加密明文数输入据的长度 output_data AES-ECB-192 加密运算后的结果存放在这个 buffer 这个 buffer 的大小需要保证 16bytes 对齐输出返回值

30 第 3 章高级加密加速器 (AES) aes_ecb192_hard_decrypt 描述 AES-ECB-192 解密运算输入输出数据都使用 cpu 传输 ECB 加密将明文按照固定大小 16bytes 的块进行加密的, 块大小不足则进行填充 ECB 模式没有用到向量函数原型 void aes_ecb192_hard_decrypt ( uint8_t input_key, uint8_t input_data, size_t input_len, uint8_t output_data ) 参数参数名称描述输入输出 input_key AES-ECB-192 解密的密钥输入 input_data AES-ECB-192 待解密的密文输入数据 input_len AES-ECB-192 待解密密文数输入据的长度 output_data AES-ECB-192 解密运算后的结果存放在这个 buffer 这个 buffer 的大小需要保证 16bytes 对齐输出返回值 aes_ecb256_hard_encrypt 描述 AES-ECB-256 加密运算输入输出数据都使用 cpu 传输 ECB 加密将明文按照固定大小 16bytes 的块进行加密的, 块大小不足则进行填充 ECB 模式没有用到向量函数原型

31 第 3 章高级加密加速器 (AES) 25 void aes_ecb256_hard_encrypt ( uint8_t input_key, uint8_t input_data, size_t input_len, uint8_t output_data ) 参数参数名称描述输入输出 input_key AES-ECB-256 加密的密钥输入 input_data AES-ECB-256 待加密的明文输入数据 input_len AES-ECB-256 待加密明文数输入据的长度 output_data AES-ECB-256 加密运算后的结果存放在这个 buffer 这个 buffer 的大小需要保证 16bytes 对齐输出返回值 aes_ecb256_hard_decrypt 描述 AES-ECB-256 解密运算输入输出数据都使用 cpu 传输 ECB 加密将明文按照固定大小 16bytes 的块进行加密的, 块大小不足则进行填充 ECB 模式没有用到向量函数原型 void aes_ecb256_hard_decrypt ( uint8_t input_key, uint8_t input_data, size_t input_len, uint8_t output_data ) 参数参数名称描述输入输出 input_key AES-ECB-256 解密的密钥输入 input_data AES-ECB-256 待解密的密文数据输入

32 第 3 章高级加密加速器 (AES) 26 参数名称描述输入输出 input_len output_data AES-ECB-256 待解密密文数据的长度 AES-ECB-256 解密运算后的结果存放在这个 buffer 这个 buffer 的大小需要保证 16bytes 对齐输入输出返回值 aes_cbc128_hard_encrypt 描述 AES-CBC-128 加密运算输入输出数据都使用 cpu 传输 CBC 加密将明文按照固定大小 16bytes 的块进行加密的, 块大小不足则进行填充函数原型 void aes_cbc128_hard_encrypt ( cbc_context_t context, uint8_t input_data, size_t input_len, uint8_t output_data ) 参数参数名称描述输入输出 context input_data input_len output_data AES-CBC-128 加密计算的结构体, 包含加密密钥与偏移向量 AES-CBC-128 待加密的明文数据 AES-CBC-128 待加密明文数据的长度 AES-CBC-128 加密运算后的结果存放在这个 buffer 这个 buffer 的大小需要保证 16bytes 对齐输入输入输入输出

33 第 3 章高级加密加速器 (AES) 返回值 aes_cbc128_hard_decrypt 描述 AES-CBC-128 解密运算输入输出数据都使用 cpu 传输 CBC 加密将明文按照固定大小 16bytes 的块进行加密的, 块大小不足则进行填充函数原型 void aes_cbc128_hard_decrypt ( cbc_context_t context, uint8_t input_data, size_t input_len, uint8_t output_data ) 参数参数名称描述输入输出 context input_data input_len output_data AES-CBC-128 解密计算的结构体, 包含解密密钥与偏移向量 AES-CBC-128 待解密的密文数据 AES-CBC-128 待解密密文数据的长度 AES-CBC-128 解密运算后的结果存放在这个 buffer 这个 buffer 的大小需要保证 16bytes 对齐输入输入输入输出返回值 aes_cbc192_hard_encrypt 描述 AES-CBC-192 加密运算输入输出数据都使用 cpu 传输 CBC 加密将明文按照固定大小 16bytes 的块进行加密的, 块大小不足则进行填充

34 第 3 章高级加密加速器 (AES) 函数原型 void aes_cbc192_hard_encrypt ( cbc_context_t context, uint8_t input_data, size_t input_len, uint8_t output_data ) 参数参数名称描述输入输出 context input_data input_len output_data AES-CBC-192 加密计算的结构体, 包含加密密钥与偏移向量 AES-CBC-192 待加密的明文数据 AES-CBC-192 待加密明文数据的长度 AES-CBC-192 加密运算后的结果存放在这个 buffer 这个 buffer 的大小需要保证 16bytes 对齐输入输入输入输出返回值 aes_cbc192_hard_decrypt 描述 AES-CBC-192 解密运算输入输出数据都使用 cpu 传输 CBC 加密将明文按照固定大小 16bytes 的块进行加密的, 块大小不足则进行填充函数原型 void aes_cbc192_hard_decrypt ( cbc_context_t context, uint8_t input_data, size_t input_len, uint8_t output_data ) 参数

35 第 3 章高级加密加速器 (AES) 29 参数名称描述输入输出 context input_data input_len output_data AES-CBC-192 解密计算的结构体, 包含解密密钥与偏移向量 AES-CBC-192 待解密的密文数据 AES-CBC-192 待解密密文数据的长度 AES-CBC-192 解密运算后的结果存放在这个 buffer 这个 buffer 的大小需要保证 16bytes 对齐输入输入输入输出返回值 aes_cbc256_hard_encrypt 描述 AES-CBC-256 加密运算输入输出数据都使用 cpu 传输 CBC 加密将明文按照固定大小 16bytes 的块进行加密的, 块大小不足则进行填充函数原型 void aes_cbc256_hard_encrypt ( cbc_context_t context, uint8_t input_data, size_t input_len, uint8_t output_data ) 参数参数名称描述输入输出 context input_data input_len AES-CBC-256 加密计算的结构体, 包含加密密钥与偏移向量 AES-CBC-256 待加密的明文数据 AES-CBC-256 待加密明文数据的长度输入输入输入

36 第 3 章高级加密加速器 (AES) 30 参数名称描述输入输出 output_data AES-CBC-256 加密运算后的结果存放在这个 buffer 这个 buffer 的大小需要保证 16bytes 对齐输出返回值 aes_cbc256_hard_decrypt 描述 AES-CBC-256 解密运算输入输出数据都使用 cpu 传输 CBC 加密将明文按照固定大小 16bytes 的块进行加密的, 块大小不足则进行填充函数原型 void aes_cbc256_hard_decrypt ( uint8_t input_key, uint8_t input_data, size_t input_len, uint8_t output_data ) 参数参数名称描述输入输出 context input_data input_len output_data AES-CBC-256 解密计算的结构体, 包含解密密钥与偏移向量 AES-CBC-256 待解密的密文数据 AES-CBC-256 待解密密文数据的长度 AES-CBC-256 解密运算后的结果存放在这个 buffer 这个 buffer 的大小需要保证 16bytes 对齐输入输入输入输出

37 第 3 章高级加密加速器 (AES) 返回值 aes_gcm128_hard_encrypt 描述 AES-GCM-128 加密运算输入输出数据都使用 cpu 传输函数原型 void aes_gcm128_hard_encrypt ( gcm_context_t context, uint8_t input_data, size_t input_len, uint8_t output_data, uint8_t gcm_tag ) 参数参数名称描述输入输出 context AES-GCM-128 加密计算的结构体, 包含加密密钥 / 偏移向量 /aad/aad 长度输入 input_data AES-GCM-128 待加密的明文数据输入 input_len AES-GCM-128 待加密明文数据的长度输入 output_data AES-GCM-128 加密运算后的结果存放在这个 buffer 输出 gcm_tag AES-GCM-128 加密运算后的 tag 存放在这个 buffer 这个 buffer 大小需要保证为 16bytes 输出返回值 aes_gcm128_hard_decrypt 描述 AES-GCM-128 解密运算输入输出数据都使用 cpu 传输函数原型 void aes_gcm128_hard_decrypt ( gcm_context_t context, uint8_t input_data, size_t input_len, uint8_t output_data, uint8_t gcm_tag ) 参数

38 第 3 章高级加密加速器 (AES) 32 参数名称描述输入输出 context AES-GCM-128 解密计算的结构体, 包含解密密钥 / 偏移向量 /aad/aad 长度输入 input_data AES-GCM-128 待解密的密文数据输入 input_len AES-GCM-128 待解密密文数据的长度输入 output_data AES-GCM-128 解密运算后的结果存放在这个 buffer 输出 gcm_tag AES-GCM-128 解密运算后的 tag 存放在这个 buffer 这个 buffer 大小需要保证为 16bytes 输出返回值 aes_gcm192_hard_encrypt 描述 AES-GCM-192 加密运算输入输出数据都使用 cpu 传输函数原型 void aes_gcm192_hard_encrypt ( gcm_context_t context, uint8_t input_data, size_t input_len, uint8_t output_data, uint8_t gcm_tag ) 参数参数名称描述输入输出 context AES-GCM-192 加密计算的结构体, 包含加密密钥 / 偏移向量 /aad/aad 长度输入 input_data AES-GCM-192 待加密的明文数据输入 input_len AES-GCM-192 待加密明文数据的长度输入 output_data AES-GCM-192 加密运算后的结果存放在这个 buffer 输出 gcm_tag AES-GCM-192 加密运算后的 tag 存放在这个 buffer 这个 buffer 大小需要保证为 16bytes 输出返回值 aes_gcm192_hard_decrypt 描述 AES-GCM-192 解密运算输入输出数据都使用 cpu 传输

39 第 3 章高级加密加速器 (AES) 函数原型 void aes_gcm192_hard_decrypt ( gcm_context_t context, uint8_t input_data, size_t input_len, uint8_t output_data, uint8_t gcm_tag ) 参数参数名称描述输入输出 context AES-GCM-192 解密计算的结构体, 包含解密密钥 / 偏移向量 /aad/aad 长度输入 input_data AES-GCM-192 待解密的密文数据输入 input_len AES-GCM-192 待解密密文数据的长度输入 output_data AES-GCM-192 解密运算后的结果存放在这个 buffer 输出 gcm_tag AES-GCM-192 解密运算后的 tag 存放在这个 buffer 这个 buffer 大小需要保证为 16bytes 输出返回值 aes_gcm256_hard_encrypt 描述 AES-GCM-256 加密运算输入输出数据都使用 cpu 传输函数原型 void aes_gcm256_hard_encrypt ( gcm_context_t context, uint8_t input_data, size_t input_len, uint8_t output_data, uint8_t gcm_tag ) 参数参数名称描述输入输出 context AES-GCM-256 加密计算的结构体, 包含加密密钥 / 偏移向量 /aad/aad 长度输入 input_data AES-GCM-256 待加密的明文数据输入 input_len AES-GCM-256 待加密明文数据的长度输入 output_data AES-GCM-256 加密运算后的结果存放在这个 buffer 输出 gcm_tag AES-GCM-256 加密运算后的 tag 存放在这个 buffer 这个 buffer 大小需要保证为 16bytes 输出

40 第 3 章高级加密加速器 (AES) 返回值 aes_gcm256_hard_decrypt 描述 AES-GCM-256 解密运算输入输出数据都使用 cpu 传输函数原型 void aes_gcm256_hard_decrypt ( gcm_context_t context, uint8_t input_data, size_t input_len, uint8_t output_data, uint8_t gcm_tag ) 参数参数名称描述输入输出 context AES-GCM-256 解密计算的结构体, 包含解密密钥 / 偏移向量 /aad/aad 长度输入 input_data AES-GCM-256 待解密的密文数据输入 input_len AES-GCM-256 待解密密文数据的长度输入 output_data AES-GCM-256 解密运算后的结果存放在这个 buffer 输出 gcm_tag AES-GCM-256 解密运算后的 tag 存放在这个 buffer 这个 buffer 大小需要保证为 16bytes 输出返回值 aes_ecb128_hard_encrypt_dma 描述 AES-ECB-128 加密运算输入数据使用 cpu 传输, 输出数据都使用 dma 传输 ECB 加密将明文按照固定大小 16bytes 的块进行加密的, 块大小不足则进行填充 ECB 模式没有用到向量函数原型 void aes_ecb128_hard_encrypt_dma ( dmac_channel_number_t dma_receive_channel_num, uint8_t input_key, uint8_t input_data, size_t input_len, uint8_t output_data ) 参数

41 第 3 章高级加密加速器 (AES) 35 参数名称描述输入输出 dma_receive_channel_num AES 输出数据的 DMA 通道号输入 input_key AES-ECB-128 加密的密钥输入 input_data AES-ECB-128 待加密的明文输入数据 input_len AES-ECB-128 待加密明文数输入据的长度 output_data AES-ECB-128 加密运算后的结果存放在这个 buffer 这个 buffer 的大小需要保证 16bytes 对齐输出返回值 aes_ecb128_hard_decrypt_dma 描述 AES-ECB-128 解密运算输入数据使用 cpu 传输, 输出数据都使用 dma 传输 ECB 加密将明文按照固定大小 16bytes 的块进行加密的, 块大小不足则进行填充 ECB 模式没有用到向量函数原型 void aes_ecb128_hard_decrypt_dma ( dmac_channel_number_t dma_receive_channel_num, uint8_t input_key, uint8_t input_data, size_t input_len, uint8_t output_data ) 参数参数名称描述输入输出 dma_receive_channel_num AES 输出数据的 DMA 通道号输入 input_key AES-ECB-128 解密的密钥输入 input_data AES-ECB-128 待解密的密文输入数据 input_len AES-ECB-128 待解密密文数据的长度输入

42 第 3 章高级加密加速器 (AES) 36 参数名称描述输入输出 output_data AES-ECB-128 解密运算后的结果存放在这个 buffer 这个 buffer 的大小需要保证 16bytes 对齐输出返回值 aes_ecb192_hard_encrypt_dma 描述 AES-ECB-192 加密运算输入数据使用 cpu 传输, 输出数据都使用 dma 传输 ECB 加密将明文按照固定大小 16bytes 的块进行加密的, 块大小不足则进行填充 ECB 模式没有用到向量函数原型 void aes_ecb192_hard_encrypt_dma ( dmac_channel_number_t dma_receive_channel_num, uint8_t input_key, uint8_t input_data, size_t input_len, uint8_t output_data ) 参数参数名称描述输入输出 dma_receive_channel_num AES 输出数据的 DMA 通道号输入 input_key AES-ECB-192 加密的密钥输入 input_data AES-ECB-192 待加密的明文输入数据 input_len AES-ECB-192 待加密明文数输入据的长度 output_data AES-ECB-192 加密运算后的结果存放在这个 buffer 这个 buffer 的大小需要保证 16bytes 对齐输出返回值

43 第 3 章高级加密加速器 (AES) aes_ecb192_hard_decrypt_dma 描述 AES-ECB-192 解密运算输入数据使用 cpu 传输, 输出数据都使用 dma 传输 ECB 加密将明文按照固定大小 16bytes 的块进行加密的, 块大小不足则进行填充 ECB 模式没有用到向量函数原型 void aes_ecb192_hard_decrypt_dma ( dmac_channel_number_t dma_receive_channel_num, uint8_t input_key, uint8_t input_data, size_t input_len, uint8_t output_data ) 参数参数名称描述输入输出 dma_receive_channel_num AES 输出数据的 DMA 通道号输入 input_key AES-ECB-192 解密的密钥输入 input_data AES-ECB-192 待解密的密文输入数据 input_len AES-ECB-192 待解密密文数输入据的长度 output_data AES-ECB-192 解密运算后的结果存放在这个 buffer 这个 buffer 的大小需要保证 16bytes 对齐输出返回值 aes_ecb256_hard_encrypt_dma 描述 AES-ECB-256 加密运算输入数据使用 cpu 传输, 输出数据都使用 dma 传输 ECB 加密将明文按照固定大小 16bytes 的块进行加密的, 块大小不足则进行填充 ECB 模式没有用到向量函数原型

44 第 3 章高级加密加速器 (AES) 38 void aes_ecb256_hard_encrypt_dma ( dmac_channel_number_t dma_receive_channel_num, uint8_t input_key, uint8_t input_data, size_t input_len, uint8_t output_data ) 参数参数名称描述输入输出 dma_receive_channel_num AES 输出数据的 DMA 通道号输入 input_key AES-ECB-256 加密的密钥输入 input_data AES-ECB-256 待加密的明文输入数据 input_len AES-ECB-256 待加密明文数输入据的长度 output_data AES-ECB-256 加密运算后的结果存放在这个 buffer 这个 buffer 的大小需要保证 16bytes 对齐输出返回值 aes_ecb256_hard_decrypt_dma 描述 AES-ECB-256 解密运算输入数据使用 cpu 传输, 输出数据都使用 dma 传输 ECB 加密将明文按照固定大小 16bytes 的块进行加密的, 块大小不足则进行填充 ECB 模式没有用到向量函数原型 void aes_ecb256_hard_decrypt_dma ( dmac_channel_number_t dma_receive_channel_num, uint8_t input_key, uint8_t input_data, size_t input_len, uint8_t output_data ) 参数参数名称描述输入输出 dma_receive_channel_num AES 输出数据的 DMA 通道号输入 input_key AES-ECB-256 解密的密钥输入

45 第 3 章高级加密加速器 (AES) 39 参数名称描述输入输出 input_data input_len output_data AES-ECB-256 待解密的密文数据 AES-ECB-256 待解密密文数据的长度 AES-ECB-256 解密运算后的结果存放在这个 buffer 这个 buffer 的大小需要保证 16bytes 对齐输入输入输出返回值 aes_cbc128_hard_encrypt_dma 描述 AES-CBC-128 加密运算输入数据使用 cpu 传输, 输出数据都使用 dma 传输 CBC 加密将明文按照固定大小 16bytes 的块进行加密的, 块大小不足则进行填充函数原型 void aes_cbc128_hard_encrypt_dma ( dmac_channel_number_t dma_receive_channel_num, cbc_context_t context, uint8_t input_data, size_t input_len, uint8_t output_data ) 参数参数名称描述输入输出 dma_receive_channel_num AES 输出数据的 DMA 通道号输入 context AES-CBC-128 加密计算的结输入构体, 包含加密密钥与偏移向量 input_data AES-CBC-128 待加密的明文输入数据 input_len AES-CBC-128 待加密明文数据的长度输入

46 第 3 章高级加密加速器 (AES) 40 参数名称描述输入输出 output_data AES-CBC-128 加密运算后的结果存放在这个 buffer 这个 buffer 的大小需要保证 16bytes 对齐输出返回值 aes_cbc128_hard_decrypt_dma 描述 AES-CBC-128 解密运算输入数据使用 cpu 传输, 输出数据都使用 dma 传输 CBC 加密将明文按照固定大小 16bytes 的块进行加密的, 块大小不足则进行填充函数原型 void aes_cbc128_hard_decrypt_dma ( dmac_channel_number_t dma_receive_channel_num, cbc_context_t context, uint8_t input_data, size_t input_len, uint8_t output_data ) 参数参数名称描述输入输出 dma_receive_channel_num AES 输出数据的 DMA 通道号输入 context AES-CBC-128 解密计算的结输入构体, 包含解密密钥与偏移向量 input_data AES-CBC-128 待解密的密文输入数据 input_len AES-CBC-128 待解密密文数输入据的长度 output_data AES-CBC-128 解密运算后的结果存放在这个 buffer 这个 buffer 的大小需要保证 16bytes 对齐输出

47 第 3 章高级加密加速器 (AES) 返回值 aes_cbc192_hard_encrypt_dma 描述 AES-CBC-192 加密运算输入数据使用 cpu 传输, 输出数据都使用 dma 传输 CBC 加密将明文按照固定大小 16bytes 的块进行加密的, 块大小不足则进行填充函数原型 void aes_cbc192_hard_encrypt_dma ( dmac_channel_number_t dma_receive_channel_num, cbc_context_t context, uint8_t input_data, size_t input_len, uint8_t output_data ) 参数参数名称描述输入输出 dma_receive_channel_num AES 输出数据的 DMA 通道号输入 context AES-CBC-192 加密计算的结输入构体, 包含加密密钥与偏移向量 input_data AES-CBC-192 待加密的明文输入数据 input_len AES-CBC-192 待加密明文数输入据的长度 output_data AES-CBC-192 加密运算后的结果存放在这个 buffer 这个 buffer 的大小需要保证 16bytes 对齐输出返回值

48 第 3 章高级加密加速器 (AES) aes_cbc192_hard_decrypt_dma 描述 AES-CBC-192 解密运算输入数据使用 cpu 传输, 输出数据都使用 dma 传输 CBC 加密将明文按照固定大小 16bytes 的块进行加密的, 块大小不足则进行填充函数原型 void aes_cbc192_hard_decrypt_dma ( dmac_channel_number_t dma_receive_channel_num, cbc_context_t context, uint8_t input_data, size_t input_len, uint8_t output_data ) 参数参数名称描述输入输出 dma_receive_channel_num AES 输出数据的 DMA 通道号输入 context AES-CBC-192 解密计算的结输入构体, 包含解密密钥与偏移向量 input_data AES-CBC-192 待解密的密文输入数据 input_len AES-CBC-192 待解密密文数输入据的长度 output_data AES-CBC-192 解密运算后的结果存放在这个 buffer 这个 buffer 的大小需要保证 16bytes 对齐输出返回值 aes_cbc256_hard_encrypt_dma 描述 AES-CBC-256 加密运算输入数据使用 cpu 传输, 输出数据都使用 dma 传输 CBC 加密将明文按照固定大小 16bytes 的块进行加密的, 块大小不足则进行填充

49 第 3 章高级加密加速器 (AES) 函数原型 void aes_cbc256_hard_encrypt_dma ( dmac_channel_number_t dma_receive_channel_num, cbc_context_t context, uint8_t input_data, size_t input_len, uint8_t output_data ) 参数参数名称描述输入输出 dma_receive_channel_num AES 输出数据的 DMA 通道号输入 context AES-CBC-256 加密计算的结输入构体, 包含加密密钥与偏移向量 input_data AES-CBC-256 待加密的明文输入数据 input_len AES-CBC-256 待加密明文数输入据的长度 output_data AES-CBC-256 加密运算后的结果存放在这个 buffer 这个 buffer 的大小需要保证 16bytes 对齐输出返回值 aes_cbc256_hard_decrypt_dma 描述 AES-CBC-256 解密运算输入数据使用 cpu 传输, 输出数据都使用 dma 传输 CBC 加密将明文按照固定大小 16bytes 的块进行加密的, 块大小不足则进行填充函数原型 void aes_cbc256_hard_decrypt_dma ( dmac_channel_number_t dma_receive_channel_num, uint8_t input_key, uint8_t input_data, size_t input_len, uint8_t output_data )

50 第 3 章高级加密加速器 (AES) 参数参数名称描述输入输出 dma_receive_channel_num AES 输出数据的 DMA 通道号输入 context AES-CBC-256 解密计算的结输入构体, 包含解密密钥与偏移向量 input_data AES-CBC-256 待解密的密文输入数据 input_len AES-CBC-256 待解密密文数输入据的长度 output_data AES-CBC-256 解密运算后的结果存放在这个 buffer 这个 buffer 的大小需要保证 16bytes 对齐输出返回值 aes_gcm128_hard_encrypt_dma 描述 AES-GCM-128 加密运算输入数据使用 cpu 传输, 输出数据都使用 dma 传输函数原型 void aes_gcm128_hard_encrypt_dma ( dmac_channel_number_t dma_receive_channel_num, gcm_context_t context, uint8_t input_data, size_t input_len, uint8_t output_data, uint8_t gcm_tag ) 参数参数名称描述输入输出 dma_receive_channel_num AES 输出数据的 DMA 通道号输入

51 第 3 章高级加密加速器 (AES) 45 参数名称描述输入输出 context input_data input_len output_data gcm_tag AES-GCM-128 加密计算的结构体, 包含加密密钥 / 偏移向量 /aad/aad 长度 AES-GCM-128 待加密的明文数据 AES-GCM-128 待加密明文数据的长度 AES-GCM-128 加密运算后的结果存放在这个 buffer 由于 DMA 搬运数据的最小粒度为 4bytes, 所以需要保证这个 buffer 大小至少为 4bytes 的整数倍 AES-GCM-128 加密运算后的 tag 存放在这个 buffer 这个 buffer 大小需要保证为 16bytes 输入输入输入输出输出返回值 aes_gcm128_hard_decrypt_dma 描述 AES-GCM-128 解密运算输入数据使用 cpu 传输, 输出数据都使用 dma 传输函数原型 void aes_gcm128_hard_decrypt_dma ( dmac_channel_number_t dma_receive_channel_num, gcm_context_t context, uint8_t input_data, size_t input_len, uint8_t output_data, uint8_t gcm_tag ) 参数

52 第 3 章高级加密加速器 (AES) 46 参数名称描述输入输出 dma_receive_channel_num AES 输出数据的 DMA 通道号输入 context AES-GCM-128 解密计算的结输入构体, 包含解密密钥 / 偏移向量 /aad/aad 长度 input_data AES-GCM-128 待解密的密文输入数据 input_len AES-GCM-128 待解密密文数输入据的长度 output_data AES-GCM-128 解密运算后的输出结果存放在这个 buffer 由于 DMA 搬运数据的最小粒度为 4bytes, 所以需要保证这个 buffer 大小至少为 4bytes 的整数倍 gcm_tag AES-GCM-128 解密运算后的 tag 存放在这个 buffer 这个 buffer 大小需要保证为 16bytes 输出返回值 aes_gcm192_hard_encrypt_dma 描述 AES-GCM-192 加密运算输入数据使用 cpu 传输, 输出数据都使用 dma 传输函数原型 void aes_gcm192_hard_encrypt_dma ( dmac_channel_number_t dma_receive_channel_num, gcm_context_t context, uint8_t input_data, size_t input_len, uint8_t output_data, uint8_t gcm_tag ) 参数

53 第 3 章高级加密加速器 (AES) 47 参数名称描述输入输出 dma_receive_channel_num AES 输出数据的 DMA 通道号输入 context AES-GCM-192 加密计算的结输入构体, 包含加密密钥 / 偏移向量 /aad/aad 长度 input_data AES-GCM-192 待加密的明文输入数据 input_len AES-GCM-192 待加密明文数输入据的长度 output_data AES-GCM-192 加密运算后的输出结果存放在这个 buffer 由于 DMA 搬运数据的最小粒度为 4bytes, 所以需要保证这个 buffer 大小至少为 4bytes 的整数倍 gcm_tag AES-GCM-192 加密运算后的 tag 存放在这个 buffer 这个 buffer 大小需要保证为 16bytes 输出返回值 aes_gcm192_hard_decrypt_dma 描述 AES-GCM-192 解密运算输入数据使用 cpu 传输, 输出数据都使用 dma 传输函数原型 void aes_gcm192_hard_decrypt_dma ( dmac_channel_number_t dma_receive_channel_num, gcm_context_t context, uint8_t input_data, size_t input_len, uint8_t output_data, uint8_t gcm_tag ) 参数

54 第 3 章高级加密加速器 (AES) 48 参数名称描述输入输出 dma_receive_channel_num AES 输出数据的 DMA 通道号输入 context AES-GCM-192 解密计算的结输入构体, 包含解密密钥 / 偏移向量 /aad/aad 长度 input_data AES-GCM-192 待解密的密文输入数据 input_len AES-GCM-192 待解密密文数输入据的长度 output_data AES-GCM-192 解密运算后的输出结果存放在这个 buffer 由于 DMA 搬运数据的最小粒度为 4bytes, 所以需要保证这个 buffer 大小至少为 4bytes 的整数倍 gcm_tag AES-GCM-192 解密运算后的 tag 存放在这个 buffer 这个 buffer 大小需要保证为 16bytes 输出返回值 aes_gcm256_hard_encrypt_dma 描述 AES-GCM-256 加密运算输入数据使用 cpu 传输, 输出数据都使用 dma 传输函数原型 void aes_gcm256_hard_encrypt_dma ( dmac_channel_number_t dma_receive_channel_num, gcm_context_t context, uint8_t input_data, size_t input_len, uint8_t output_data, uint8_t gcm_tag ) 参数

55 第 3 章高级加密加速器 (AES) 49 参数名称描述输入输出 dma_receive_channel_num AES 输出数据的 DMA 通道号输入 context AES-GCM-256 加密计算的结输入构体, 包含加密密钥 / 偏移向量 /aad/aad 长度 input_data AES-GCM-256 待加密的明文输入数据 input_len AES-GCM-256 待加密明文数输入据的长度 output_data AES-GCM-256 加密运算后的输出结果存放在这个 buffer 由于 DMA 搬运数据的最小粒度为 4bytes, 所以需要保证这个 buffer 大小至少为 4bytes 的整数倍 gcm_tag AES-GCM-256 加密运算后的 tag 存放在这个 buffer 这个 buffer 大小需要保证为 16bytes 输出返回值 aes_gcm256_hard_decrypt_dma 描述 AES-GCM-256 解密运算输入数据使用 cpu 传输, 输出数据都使用 dma 传输函数原型 void aes_gcm256_hard_decrypt_dma ( dmac_channel_number_t dma_receive_channel_num, gcm_context_t context, uint8_t input_data, size_t input_len, uint8_t output_data, uint8_t gcm_tag ) 参数

56 第 3 章高级加密加速器 (AES) 50 参数名称描述输入输出 dma_receive_channel_num AES 输出数据的 DMA 通道号输入 context AES-GCM-256 解密计算的结输入构体, 包含解密密钥 / 偏移向量 /aad/aad 长度 input_data AES-GCM-256 待解密的密文输入数据 input_len AES-GCM-256 待解密密文数输入据的长度 output_data AES-GCM-256 解密运算后的输出结果存放在这个 buffer 由于 DMA 搬运数据的最小粒度为 4bytes, 所以需要保证这个 buffer 大小至少为 4bytes 的整数倍 gcm_tag AES-GCM-256 解密运算后的 tag 存放在这个 buffer 这个 buffer 大小需要保证为 16bytes 输出返回值 aes_init 描述 AES 硬件模块的初始化函数原型 void aes_init ( uint8_t input_key, size_t input_key_len, uint8_t iv, size_t iv_len, uint8_t gcm_aad, aes_cipher_mode_t cipher_mode, aes_encrypt_sel_t encrypt_sel, size_t gcm_aad_len, size_t input_data_len ) 参数

57 第 3 章高级加密加速器 (AES) 51 参数名称描述输入输出 input_key 待加密 / 解密的密钥输入 input_key_len 待加密 / 解密密钥的长度输入 iv AES 加密解密用到的 iv 数据输入 iv_len AES 加密解密用到的 iv 数据的长度,CBC 固定为 16bytes,GCM 固定为 12bytes 输出 gcm_aad AES-GCM 加密解密用到的 aad 数据输出 cipher_mode AES 硬件模块执行的加密解密类型, 支持 AES_CBC/AES_ECB/AES_GCM 输入 encrypt_sel AES 硬件模块执行的模式 : 加密或解密输入 gcm_aad_len AES-GCM 加密解密用到的 aad 数据的长度输入 input_data_len 待加密 / 解密的数据长度输入返回值 aes_process 描述 AES 硬件模块执行加密解密操作函数原型 void aes_process ( uint8_t input_data, uint8_t output_data, size_t input_data_len, aes_cipher_mode_t cipher_mode ) 参数参数名称描述输入输出 input_data 这个 buffer 存放待加密 / 解密的数据输入 output_data 这个 buffer 存放加密 / 解密的输出结果输出 input_data_len 待加密 / 解密的数据的长度输入 cipher_mode AES 硬件模块执行的加密解密类型, 支持 AES_CBC/AES_ECB/AES_GCM 输入返回值

58 第 3 章高级加密加速器 (AES) gcm_get_tag 描述获取 AES-GCM 计算结束后的 tag 函数原型 void gcm_get_tag ( uint8_t gcm_tag ) 参数参数名称描述输入输出 gcm_tag 这个 buffer 存放 AES-GCM 加密 / 解密后的 tag, 固定为 16bytes 的大小输出返回值举例 cbc_context_t cbc_context ; cbc_context. input_key = cbc_key ; cbc_context. iv = cbc_iv ; aes_cbc128_hard_encrypt (& cbc_context, aes_input_data, 16L, aes_output_data ); memcpy ( aes_input_data, aes_output_data, 16L); aes_cbc128_hard_decrypt (& cbc_context, aes_input_data, 16L, aes_output_data ); 3.3 数据类型相关数据类型数据结构定义如下 : aes_cipher_mode_t:aes 加密 / 解密的方式 aes_cipher_mode_t 描述 AES 加密 / 解密的方式

59 第 3 章高级加密加速器 (AES) 定义 typedef enum _aes_cipher_mode { AES_ECB = 0, AES_CBC = 1, AES_GCM = 2, AES_CIPHER_MAX } aes_cipher_mode_t ; gcm_context_t:aes-gcm 加密 / 解密时参数用到的结构体 gcm_context_t 描述 AES-GCM 参数用到的结构体, 包括密钥偏移向量 aad 数据 aad 数据长度定义 typedef struct _gcm_context { uint8_t input_key ; uint8_t iv; uint8_t gcm_aad ; size_t gcm_aad_len ; } gcm_context_t ; cbc_context_t:aes-cbc 加密 / 解密时参数用到的结构体 cbc_context_t 描述 AES-CBC 参数用到的结构体, 包括密钥偏移向量定义 typedef struct _cbc_context { uint8_t input_key ; uint8_t iv;

60 第 3 章高级加密加速器 (AES) 54 } cbc_context_t ; 成员成员名称 AES_ECB AES_CBC AES_GCM 描述 ECB 加密 / 解密 CBC 加密 / 解密 GCM 加密 / 解密

61 55 第 4 章中断 PLIC 4.1 概述可以将任一外部中断源单独分配到每个 CPU 的外部中断上这提供了强大的灵活性, 能适应不同的应用需求 4.2 功能描述 PLIC 模块具有以下功能 : 启用或禁用中断设置中断处理程序配置中断优先级 4.3 API 参考对应头文件 plic.h 为用户提供以下接口 plic_init plic_irq_enable plic_irq_disable plic_set_priority plic_get_priority plic_irq_register plic_irq_deregister

62 第 4 章中断 PLIC plic_init 描述 PLIC 初始化外部中断函数原型 void plic_init ( void ) 参数返回值 plic_irq_enable 描述使能外部中断函数原型 int plic_irq_enable ( plic_irq_t irq_number ) 参数参数名称描述输入输出 irq_number 中断号输入返回值返回值描述 0 成功非 0 失败

63 第 4 章中断 PLIC plic_irq_disable 描述禁用外部中断函数原型 int plic_irq_disable ( plic_irq_t irq_number ) 参数参数名称描述输入输出 irq_number 中断号输入返回值返回值描述 0 成功非 0 失败 plic_set_priority 描述设置中断优先级函数原型 int plic_set_priority ( plic_irq_t irq_number, uint32_t priority ) 参数参数名称描述输入输出 irq_number 中断号输入 priority 中断优先级输入

64 第 4 章中断 PLIC 返回值返回值描述 0 成功非 0 失败 plic_get_priority 描述获取中断优先级函数原型 uint32_t plic_get_priority ( plic_irq_t irq_number ) 参数参数名称描述输入输出 irq_number 中断号输入返回值 irq_number 中断的优先级 plic_irq_register 描述注册外部中断函数函数原型 int plic_irq_register ( plic_irq_t irq, plic_irq_callback_t callback, void ctx ) 参数参数名称描述输入输出 irq 中断号输入

65 第 4 章中断 PLIC 59 参数名称描述输入输出 callback 中断回调函数输入 ctx 回调函数的参数输入返回值返回值描述 0 成功非 0 失败 plic_irq_deregister 描述注销外部中断函数函数原型 int plic_irq_deregister ( plic_irq_t irq ) 参数参数名称描述输入输出 irq 中断号输入返回值返回值描述 0 成功非 0 失败举例 / 设置 GPIOHS0 的触发中断 / int count = 0; int gpiohs_pin_onchange_isr ( void ctx )

66 第 4 章中断 PLIC 60 { int userdata = ( int ) ctx; userdata ++; } plic_init (); plic_set_priority ( IRQN_GPIOHS0_INTERRUPT, 1); plic_irq_register ( IRQN_GPIOHS0_INTERRUPT, gpiohs_pin_onchange_isr, & count ); plic_irq_enable ( IRQN_GPIOHS0_INTERRUPT ); sysctl_enable_irq (); 4.4 数据类型相关数据类型数据结构定义如下 : plic_irq_t: 外部中断号 plic_irq_callback_t: 外部中断回调函数 plic_irq_t 描述外部中断号定义 typedef enum _plic_irq { IRQN_NO_INTERRUPT = 0, /!< The non - existent interrupt / IRQN_SPI0_INTERRUPT = 1, /!< SPI0 interrupt / IRQN_SPI1_INTERRUPT = 2, /!< SPI1 interrupt / IRQN_SPI_SLAVE_INTERRUPT = 3, /!< SPI_SLAVE interrupt / IRQN_SPI3_INTERRUPT = 4, /!< SPI3 interrupt / IRQN_I2S0_INTERRUPT = 5, /!< I2S0 interrupt / IRQN_I2S1_INTERRUPT = 6, /!< I2S1 interrupt / IRQN_I2S2_INTERRUPT = 7, /!< I2S2 interrupt / IRQN_I2C0_INTERRUPT = 8, /!< I2C0 interrupt / IRQN_I2C1_INTERRUPT = 9, /!< I2C1 interrupt / IRQN_I2C2_INTERRUPT = 10, /!< I2C2 interrupt / IRQN_UART1_INTERRUPT = 11, /!< UART1 interrupt / IRQN_UART2_INTERRUPT = 12, /!< UART2 interrupt / IRQN_UART3_INTERRUPT = 13, /!< UART3 interrupt / IRQN_TIMER0A_INTERRUPT = 14, /!< TIMER0 channel 0 or 1 interrupt / IRQN_TIMER0B_INTERRUPT = 15, /!< TIMER0 channel 2 or 3 interrupt / IRQN_TIMER1A_INTERRUPT = 16, /!< TIMER1 channel 0 or 1 interrupt / IRQN_TIMER1B_INTERRUPT = 17, /!< TIMER1 channel 2 or 3 interrupt / IRQN_TIMER2A_INTERRUPT = 18, /!< TIMER2 channel 0 or 1 interrupt / IRQN_TIMER2B_INTERRUPT = 19, /!< TIMER2 channel 2 or 3 interrupt /

67 第 4 章中断 PLIC 61 IRQN_RTC_INTERRUPT = 20, /!< RTC tick and alarm interrupt / IRQN_WDT0_INTERRUPT = 21, /!< Watching dog timer0 interrupt / IRQN_WDT1_INTERRUPT = 22, /!< Watching dog timer1 interrupt / IRQN_APB_GPIO_INTERRUPT = 23, /!< APB GPIO interrupt / IRQN_DVP_INTERRUPT = 24, /!< Digital video port interrupt / IRQN_AI_INTERRUPT = 25, /!< AI accelerator interrupt / IRQN_FFT_INTERRUPT = 26, /!< FFT accelerator interrupt / IRQN_DMA0_INTERRUPT = 27, /!< DMA channel0 interrupt / IRQN_DMA1_INTERRUPT = 28, /!< DMA channel1 interrupt / IRQN_DMA2_INTERRUPT = 29, /!< DMA channel2 interrupt / IRQN_DMA3_INTERRUPT = 30, /!< DMA channel3 interrupt / IRQN_DMA4_INTERRUPT = 31, /!< DMA channel4 interrupt / IRQN_DMA5_INTERRUPT = 32, /!< DMA channel5 interrupt / IRQN_UARTHS_INTERRUPT = 33, /!< Hi - speed UART0 interrupt / IRQN_GPIOHS0_INTERRUPT = 34, /!< Hi - speed GPIO0 interrupt / IRQN_GPIOHS1_INTERRUPT = 35, /!< Hi - speed GPIO1 interrupt / IRQN_GPIOHS2_INTERRUPT = 36, /!< Hi - speed GPIO2 interrupt / IRQN_GPIOHS3_INTERRUPT = 37, /!< Hi - speed GPIO3 interrupt / IRQN_GPIOHS4_INTERRUPT = 38, /!< Hi - speed GPIO4 interrupt / IRQN_GPIOHS5_INTERRUPT = 39, /!< Hi - speed GPIO5 interrupt / IRQN_GPIOHS6_INTERRUPT = 40, /!< Hi - speed GPIO6 interrupt / IRQN_GPIOHS7_INTERRUPT = 41, /!< Hi - speed GPIO7 interrupt / IRQN_GPIOHS8_INTERRUPT = 42, /!< Hi - speed GPIO8 interrupt / IRQN_GPIOHS9_INTERRUPT = 43, /!< Hi - speed GPIO9 interrupt / IRQN_GPIOHS10_INTERRUPT = 44, /!< Hi - speed GPIO10 interrupt / IRQN_GPIOHS11_INTERRUPT = 45, /!< Hi - speed GPIO11 interrupt / IRQN_GPIOHS12_INTERRUPT = 46, /!< Hi - speed GPIO12 interrupt / IRQN_GPIOHS13_INTERRUPT = 47, /!< Hi - speed GPIO13 interrupt / IRQN_GPIOHS14_INTERRUPT = 48, /!< Hi - speed GPIO14 interrupt / IRQN_GPIOHS15_INTERRUPT = 49, /!< Hi - speed GPIO15 interrupt / IRQN_GPIOHS16_INTERRUPT = 50, /!< Hi - speed GPIO16 interrupt / IRQN_GPIOHS17_INTERRUPT = 51, /!< Hi - speed GPIO17 interrupt / IRQN_GPIOHS18_INTERRUPT = 52, /!< Hi - speed GPIO18 interrupt / IRQN_GPIOHS19_INTERRUPT = 53, /!< Hi - speed GPIO19 interrupt / IRQN_GPIOHS20_INTERRUPT = 54, /!< Hi - speed GPIO20 interrupt / IRQN_GPIOHS21_INTERRUPT = 55, /!< Hi - speed GPIO21 interrupt / IRQN_GPIOHS22_INTERRUPT = 56, /!< Hi - speed GPIO22 interrupt / IRQN_GPIOHS23_INTERRUPT = 57, /!< Hi - speed GPIO23 interrupt / IRQN_GPIOHS24_INTERRUPT = 58, /!< Hi - speed GPIO24 interrupt / IRQN_GPIOHS25_INTERRUPT = 59, /!< Hi - speed GPIO25 interrupt / IRQN_GPIOHS26_INTERRUPT = 60, /!< Hi - speed GPIO26 interrupt / IRQN_GPIOHS27_INTERRUPT = 61, /!< Hi - speed GPIO27 interrupt / IRQN_GPIOHS28_INTERRUPT = 62, /!< Hi - speed GPIO28 interrupt / IRQN_GPIOHS29_INTERRUPT = 63, /!< Hi - speed GPIO29 interrupt / IRQN_GPIOHS30_INTERRUPT = 64, /!< Hi - speed GPIO30 interrupt / IRQN_GPIOHS31_INTERRUPT = 65, /!< Hi - speed GPIO31 interrupt / IRQN_MAX } plic_irq_t ; 成员

68 第 4 章中断 PLIC 62 成员名称 IRQN_NO_INTERRUPT IRQN_SPI0_INTERRUPT IRQN_SPI1_INTERRUPT IRQN_SPI_SLAVE_INTERRUPT IRQN_SPI3_INTERRUPT IRQN_I2S0_INTERRUPT IRQN_I2S1_INTERRUPT IRQN_I2S2_INTERRUPT IRQN_I2C0_INTERRUPT IRQN_I2C1_INTERRUPT IRQN_I2C2_INTERRUPT IRQN_UART1_INTERRUPT IRQN_UART2_INTERRUPT IRQN_UART3_INTERRUPT IRQN_TIMER0A_INTERRUPT IRQN_TIMER0B_INTERRUPT IRQN_TIMER1A_INTERRUPT IRQN_TIMER1B_INTERRUPT IRQN_TIMER2A_INTERRUPT IRQN_TIMER2B_INTERRUPT IRQN_RTC_INTERRUPT IRQN_WDT0_INTERRUPT IRQN_WDT1_INTERRUPT IRQN_APB_GPIO_INTERRUPT IRQN_DVP_INTERRUPT IRQN_AI_INTERRUPT IRQN_FFT_INTERRUPTFFT IRQN_DMA0_INTERRUPT IRQN_DMA1_INTERRUPT IRQN_DMA2_INTERRUPT IRQN_DMA3_INTERRUPT IRQN_DMA4_INTERRUPT IRQN_DMA5_INTERRUPT IRQN_UARTHS_INTERRUPT IRQN_GPIOHS0_INTERRUPT 描述不存在 SPI0 中断 SPI1 中断从 SPI 中断 SPI3 中断 I2S0 中断 I2S1 中断 I2S2 中断 I2C0 中断 I2C1 中断 I2C2 中断 UART1 中断 UART2 中断 UART3 中断 TIMER0 通道 0 和 1 中断 TIMER0 通道 2 和 3 中断 TIMER1 通道 0 和 1 中断 TIMER1 通道 2 和 3 中断 TIMER2 通道 0 和 1 中断 TIMER2 通道 2 和 3 中断 RTC 滴答中断和报警中断看门狗 0 中断看门狗 1 中断普通 GPIO 中断数字摄像头 (DVP) 中断 AI 加速器中断傅里叶加速器中断 DMA 通道 0 中断 DMA 通道 1 中断 DMA 通道 2 中断 DMA 通道 3 中断 DMA 通道 4 中断 DMA 通道 5 中断高速 UART 中断高速 GPIO0 中断

69 第 4 章中断 PLIC 63 成员名称 IRQN_GPIOHS1_INTERRUPT IRQN_GPIOHS2_INTERRUPT IRQN_GPIOHS3_INTERRUPT IRQN_GPIOHS4_INTERRUPT IRQN_GPIOHS5_INTERRUPT IRQN_GPIOHS6_INTERRUPT IRQN_GPIOHS7_INTERRUPT IRQN_GPIOHS8_INTERRUPT IRQN_GPIOHS9_INTERRUPT IRQN_GPIOHS10_INTERRUPT IRQN_GPIOHS11_INTERRUPT IRQN_GPIOHS12_INTERRUPT IRQN_GPIOHS13_INTERRUPT IRQN_GPIOHS14_INTERRUPT IRQN_GPIOHS15_INTERRUPT IRQN_GPIOHS16_INTERRUPT IRQN_GPIOHS17_INTERRUPT IRQN_GPIOHS18_INTERRUPT IRQN_GPIOHS19_INTERRUPT IRQN_GPIOHS20_INTERRUPT IRQN_GPIOHS21_INTERRUPT IRQN_GPIOHS22_INTERRUPT IRQN_GPIOHS23_INTERRUPT IRQN_GPIOHS24_INTERRUPT IRQN_GPIOHS25_INTERRUPT IRQN_GPIOHS26_INTERRUPT IRQN_GPIOHS27_INTERRUPT IRQN_GPIOHS28_INTERRUPT IRQN_GPIOHS29_INTERRUPT IRQN_GPIOHS30_INTERRUPT IRQN_GPIOHS31_INTERRUPT 描述高速 GPIO1 中断高速 GPIO2 中断高速 GPIO3 中断高速 GPIO4 中断高速 GPIO5 中断高速 GPIO6 中断高速 GPIO7 中断高速 GPIO8 中断高速 GPIO9 中断高速 GPIO10 中断高速 GPIO11 中断高速 GPIO12 中断高速 GPIO13 中断高速 GPIO14 中断高速 GPIO15 中断高速 GPIO16 中断高速 GPIO17 中断高速 GPIO18 中断高速 GPIO19 中断高速 GPIO20 中断高速 GPIO21 中断高速 GPIO22 中断高速 GPIO23 中断高速 GPIO24 中断高速 GPIO25 中断高速 GPIO26 中断高速 GPIO27 中断高速 GPIO28 中断高速 GPIO29 中断高速 GPIO30 中断高速 GPIO31 中断 plic_irq_callback_t 描述外部中断回调函数

70 第 4 章中断 PLIC 定义 typedef int ( plic_irq_callback_t )( void ctx );

71 65 第 5 章通用输入 / 输出 (GPIO) 5.1 概述芯片有 8 个通用 GPIO 5.2 功能描述 GPIO 模块具有以下功能 : 可配置上下拉驱动模式 5.3 API 参考对应的头文件 gpio.h 为用户提供以下接口 gpio_init gpio_set_drive_mode gpio_set_pin gpio_get_pin gpio_init 描述初始化 GPIO

72 第 5 章通用输入 / 输出 (GPIO) 函数原型 int gpio_init ( void ) 返回值返回值描述 0 成功非 0 失败 gpio_set_drive_mode 描述设置 GPIO 驱动模式函数原型 void gpio_set_drive_mode ( uint8_t pin, gpio_drive_mode_t mode ) 参数参数名称描述输入输出 pin GPIO 管脚输入 mode GPIO 驱动模式输入返回值 gpio_set_pin 描述设置 GPIO 管脚值函数原型

73 第 5 章通用输入 / 输出 (GPIO) 67 void gpio_set_pin ( uint8_t pin, gpio_pin_value_t value ) 参数参数名称描述输入输出 pin GPIO 管脚输入 value GPIO 值输入返回值 gpio_get_pin 描述获取 GPIO 管脚值函数原型 gpio_pin_value_t gpio_get_pin ( uint8_t pin ) 参数参数名称描述输入输出 pin GPIO 管脚输入返回值获取的 GPIO 管脚值举例 / 设置 IO13 为输出并置为高 / gpio_init (); fpioa_set_function (13, FUNC_GPIO3 ); gpio_set_drive_mode (3, GPIO_DM_OUTPUT ); gpio_set_pin (3, GPIO_PV_High );

74 第 5 章通用输入 / 输出 (GPIO) 数据类型相关数据类型数据结构定义如下 : gpio_drive_mode_t:gpio 驱动模式 gpio_pin_value_t:gpio 值 gpio_drive_mode_t 描述 GPIO 驱动模式定义 typedef enum _gpio_drive_mode { GPIO_DM_INPUT, GPIO_DM_INPUT_PULL_DOWN, GPIO_DM_INPUT_PULL_UP, GPIO_DM_OUTPUT, } gpio_drive_mode_t ; 成员成员名称 GPIO_DM_INPUT GPIO_DM_INPUT_PULL_DOWN GPIO_DM_INPUT_PULL_UP GPIO_DM_OUTPUT 描述输入输入下拉输入上拉输出 gpio_pin_value_t 描述 GPIO 值定义 typedef enum _gpio_pin_value

75 第 5 章通用输入 / 输出 (GPIO) 69 { GPIO_PV_LOW, GPIO_PV_HIGH } gpio_pin_value_t ; 成员成员名称 GPIO_PV_LOW GPIO_PV_HIGH 描述低高

76 70 第 6 章通用高速输入 / 输出 (GPIOHS) 6.1 概述芯片有 32 个高速 GPIO 与普通 GPIO 相似, 管脚反转能力更强 6.2 功能描述 GPIOHS 模块具有以下功能 : 可配置上下拉驱动模式支持上升沿下降沿和双沿触发 6.3 API 参考对应的头文件 gpiohs.h 为用户提供以下接口 gpiohs_set_drive_mode gpiohs_set_pin gpiohs_get_pin gpiohs_set_pin_edge gpiohs_set_irq (0.6.0 后不再支持, 请使用 gpiohs_irq_register) gpiohs_irq_register gpiohs_irq_unregister

77 第 6 章通用高速输入 / 输出 (GPIOHS) gpiohs_set_drive_mode 描述设置 GPIO 驱动模式函数原型 void gpiohs_set_drive_mode ( uint8_t pin, gpio_drive_mode_t mode ) 参数参数名称描述输入输出 pin GPIO 管脚输入 mode GPIO 驱动模式输入返回值 gpio_set_pin 描述设置 GPIO 管脚值函数原型 void gpiohs_set_pin ( uint8_t pin, gpio_pin_value_t value ) 参数参数名称描述输入输出 pin GPIO 管脚输入 value GPIO 值输入返回值

78 第 6 章通用高速输入 / 输出 (GPIOHS) gpio_get_pin 描述获取 GPIO 管脚值函数原型 gpio_pin_value_t gpiohs_get_pin ( uint8_t pin ) 参数参数名称描述输入输出 pin GPIO 管脚输入返回值获取的 GPIO 管脚值 gpiohs_set_pin_edge 描述设置高速 GPIO 中断触发模式函数原型 void gpiohs_set_pin_edge ( uint8_t pin, gpio_pin_edge_t edge ) 参数参数名称描述输入输出 pin GPIO 管脚输入 edge 中断触发方式输入返回值

79 第 6 章通用高速输入 / 输出 (GPIOHS) gpiohs_set_irq 描述设置高速 GPIO 的中断回调函数函数原型 void gpiohs_set_irq ( uint8_t pin, uint32_t priority, void ( func )()); 参数参数名称描述输入输出 pin GPIO 管脚输入 priority 中断优先级输入 func 中断回调函数输入返回值 gpiohs_irq_register 描述设置高速 GPIO 的中断回调函数函数原型 void gpiohs_irq_register ( uint8_t pin, uint32_t priority, plic_irq_callback_t callback, void ctx) 参数参数名称描述输入输出 pin GPIO 管脚输入 priority 中断优先级输入 plic_irq_callback_t 中断回调函数输入

展开

<453A5CCEC4B5B55C C41CBAAB2F5D4C6BDD3BFDACAB9D3C3CBB5C3F756312E305F E646F63>

<453A5CCEC4B5B55C C41CBAAB2F5D4C6BDD3BFDACAB9D3C3CBB5C3F756312E305F E646F63> 霜蝉云接口使用说明版本 :V1.00 上海霜蝉信息科技有限公司 Shanghai Scicala Information Technology Co.,Ltd http:www.scicala.com E-mail:support@scicala.com 1 目录目录... 2 一产品概述...3 二接口功能...3 三调用规范...3 四接口方法...4 1. 用户订阅 Subscribe

K Standalone SDK 编程指南 KENDRYTE 勘智 嘉楠科技版权 2019 KENDRYTE.COM

K Standalone SDK 编程指南 KENDRYTE 勘智嘉楠科技版权 2019 KENDRYTE.COM