K230 DMA API参考#
版权所有©2023北京嘉楠捷思信息技术有限公司
免责声明#
您购买的产品、服务或特性等应受北京嘉楠捷思信息技术有限公司(“本公司”,下同)及其关联公司的商业合同和条款的约束,本文档中描述的全部或部分产品、服务或特性可能不在您的购买或使用范围之内。除非合同另有约定,本公司不对本文档的任何陈述、信息、内容的正确性、可靠性、完整性、适销性、符合特定目的和不侵权提供任何明示或默示的声明或保证。除非另有约定,本文档仅作为使用指导参考。
由于产品版本升级或其他原因,本文档内容将可能在未经任何通知的情况下,不定期进行更新或修改。
商标声明#
、“嘉楠”和其他嘉楠商标均为北京嘉楠捷思信息技术有限公司及其关联公司的商标。本文档可能提及的其他所有商标或注册商标,由各自的所有人拥有。
版权所有 © 2023北京嘉楠捷思信息技术有限公司。保留一切权利。 非经本公司书面许可,任何单位和个人不得擅自摘抄、复制本文档内容的部分或全部,并不得以任何形式传播。
目录#
[TOC]
前言#
概述#
本文档主要介绍 K230 GSDMA 软件的设计,设计内容主要包括 GSDMA 驱动框架及软件实现。
读者对象#
本文档(本指南)主要适用于以下人员:
技术支持工程师
软件开发工程师
缩略词定义#
简称 |
说明 |
---|---|
GDMA |
Graphic Direct Memory Access |
SDMA |
System Direct Memory Access |
修订记录#
文档版本号 |
修改说明 |
修改者 |
日期 |
---|---|---|---|
V1.0 |
初版 |
刘孙涛 |
2023/3/7 |
V1.1 |
修改了绑定模式的部分描述; 增加了释放帧号的函数接口描述。 |
刘孙涛 |
2023/3/31 |
V1.2 |
更换了图像地址的数据结构; 增加了帧号透传功能。 |
刘孙涛 |
2023/4/26 |
V1.3 |
增加了 buffer 可配置的功能 |
刘孙涛 |
2023/5/31 |
1. 概述#
1.1 概述#
GSDMA:DMA 全称 Direct Memory Access,即直接存储器访问,将数据从一个地址空间复制到另一个地址空间,提供在存储器和存储器之间的高速数据传输。GDMA 全称 Graphic Direct Memory Access,负责将内存中的图像复制到另一块内存中,同时可以完成图像的旋转和镜像等功能。SDMA 全称 System Direct Memory Access,负责将内存中的数据复制到另一块内存中,即传统意义上的 DMA。
软件代码将 GSDMA 硬件的各个功能以 API 的方式提供给使用者使用,帮助用户快速实现图像传输、旋转、镜像、2D 功能及数据传输功能。同时实现了模块状态信息统计等功能。
1.2 功能描述#
将 dma 硬件抽象为一个设备,八个通道,其中,通道 0~3 是 gdma 通道,通道 4~7 是 sdma 通道。
1.2.1 gdma#
用户通过 gdma 来实现图像的旋转镜像工作,主要调用流程如下:
进行 dma 设备属性的配置;
启动 dma 设备。在调用此函数以后驱动会自动申请 VB 空间作为目的地址的数据缓冲区;
进行 gdma 通道属性的配置;
启动 gdma 通道;
用户在用户态申请 VB 空间作为源数据的数据缓冲区,调用 kd_mpi_dma_send_frame 发送数据的源地址给 gdma;
驱动会将源地址中的数据传输到步骤二中申请的目的地址数据缓冲区中;
用户调用 kd_mpi_dma_get_frame 获取目的地址中的数据地址。
1.2.2 sdma#
用户通过 sdma 来实现数据搬移工作,主要调用流程如下:
进行 dma 设备属性的配置;
启动 dma 设备。在调用此函数以后驱动会自动申请 VB 空间作为目的地址的数据缓冲区;
进行 sdma 通道属性的配置;
启动 sdma 通道;
用户在用户态申请 VB 空间作为源数据的数据缓冲区,调用 kd_mpi_dma_send_frame 发送数据的源地址给 sdma;
驱动会将源地址中的数据传输到步骤二中申请的目的地址数据缓冲区中;
用户调用 kd_mpi_dma_get_frame 获取目的地址中的数据地址。
2. API 参考#
2.1 DMA 使用#
该功能模块提供以下API:
2.1.1 kd_mpi_dma_set_dev_attr#
【描述】
配置 dma 设备属性
【语法】
k_s32 kd_mpi_dma_set_dev_attr(k_dma_dev_attr_t *attr);
【参数】
参数名称 |
描述 |
输入/输出 |
---|---|---|
attr |
dma 设备属性结构体指针。 |
输入 |
【返回值】
返回值 |
描述 |
---|---|
0 |
成功 |
非0 |
失败,其值参见错误码 |
【芯片差异】
无。
【需求】
头文件:mpi_dma_api.h
库文件:libdma.a
【注意】
无
【举例】
无
【相关主题】
2.1.2 kd_mpi_dma_get_dev_attr#
【描述】
获取已经配置的 dma 设备属性。
【语法】
k_s32 kd_mpi_dma_get_dev_attr(k_dma_dev_attr_t *attr);
【参数】
参数名称 |
描述 |
输入/输出 |
---|---|---|
attr |
dma 设备属性结构体指针 |
输入 |
【返回值】
返回值 |
描述 |
---|---|
0 |
成功 |
非0 |
失败,其值参见错误码 |
【芯片差异】
无
【需求】
头文件:mpi_dma_api.h
库文件:libdma.a
【注意】
需要在配置 dma 设备属性之后才可以获取 dma 设备属性。
【举例】
无
【相关主题】
2.1.3 kd_mpi_dma_start_dev#
【描述】
启动 dma 设备。
【语法】
k_s32 kd_mpi_dma_start_dev();
【参数】
参数名称 |
描述 |
输入/输出 |
---|---|---|
无 |
无 |
无 |
【返回值】
返回值 |
描述 |
---|---|
0 |
成功 |
非0 |
失败,其值参见错误码 |
【芯片差异】
无
【需求】
头文件:mpi_dma_api.h
库文件:libdma.a
【注意】
需要配置 dma 设备属性之后才可以调用此函数启动 dma
【举例】
无
【相关主题】
无
2.1.4 kd_mpi_dma_stop_dev#
【描述】
停止 dma 设备。
【语法】
kd_mpi_dma_stop_dev();
【参数】
参数名称 |
描述 |
输入/输出 |
---|---|---|
无 |
无 |
无 |
【返回值】
返回值 |
描述 |
---|---|
0 |
成功 |
非0 |
失败,其值参见错误码 |
【芯片差异】
无
【需求】
头文件:mpi_dma_api.h
库文件:libdma.a
【注意】
只有启动 dma 设备之后才可以调用此函数来停止 dma 设备。
【举例】
无
【相关主题】
无
2.1.5 kd_mpi_dma_set_chn_attr#
【描述】
配置 dma 通道属性。
【语法】
k_s32 kd_mpi_dma_set_chn_attr(k_u8 chn_num, k_dma_chn_attr_u *attr);
【参数】
参数名称 |
描述 |
输入/输出 |
---|---|---|
chn_num |
通道号 |
输入 |
attr |
dma 通道属性,该参数是一个联合体,可以选择配置 gdma 通道属性,也可以选择配置 sdma 通道属性。通道 0~3 是 gdma,通道 4~7 是 sdma |
输入 |
【返回值】
返回值 |
描述 |
---|---|
0 |
成功 |
非0 |
失败,其值参见错误码 |
【芯片差异】
无
【需求】
头文件:mpi_dma_api.h
库文件:libdma.a
【注意】
无
【举例】
无
【相关主题】
2.1.6 kd_mpi_dma_get_chn_attr#
【描述】
获取已经配置的 dma 通道属性。
【语法】
k_s32 kd_mpi_dma_get_chn_attr(k_u8 chn_num, k_dma_chn_attr_u *attr);
【参数】
参数名称 |
描述 |
输入/输出 |
---|---|---|
chn_num |
通道号 |
输入 |
attr |
dma 通道属性,该参数是一个联合体,可以选择获取 gdma 通道属性,也可以选择获取 sdma 通道属性。通道 0~3 是 gdma,通道 4~7 是 sdma |
输出 |
【返回值】
返回值 |
描述 |
---|---|
0 |
成功 |
非0 |
失败,其值参见错误码 |
【芯片差异】
无
【需求】
头文件:mpi_dma_api.h
库文件:libdma.a
【注意】
需要在配置 dma 通道属性之后才可以获取 dma 通道属性。
【举例】
无
【相关主题】
2.1.7 kd_mpi_dma_start_chn#
【描述】
启动 dma 通道。
【语法】
k_s32 kd_mpi_dma_start_chn(k_u8 chn_num);
【参数】
参数名称 |
描述 |
输入/输出 |
---|---|---|
chn_num |
通道号。 |
输入 |
【返回值】
返回值 |
描述 |
---|---|
0 |
成功 |
非0 |
失败,其值参见错误码 |
【芯片差异】
无
【需求】
头文件:mpi_dma_api.h
库文件:libdma.a
【注意】
只有在配置启动 dma 设备,配置 dma 通道属性之后才可以启动 dma 通道。
【举例】
无
【相关主题】
无
2.1.8 kd_mpi_dma_stop_chn#
【描述】
暂停 dma 通道
【语法】
k_s32 kd_mpi_dma_stop_chn(k_u8 chn_num);
【参数】
参数名称 |
描述 |
输入/输出 |
---|---|---|
chn_num |
通道号。 |
输入 |
【返回值】
返回值 |
描述 |
---|---|
0 |
成功 |
非0 |
失败,其值参见错误码 |
【芯片差异】
无
【需求】
头文件:mpi_dma_api.h
库文件:libdma.a
【注意】
只有启动 dma 通道之后才可以调用此函数来停止 dma 通道。
【举例】
无
【相关主题】
无
2.1.9 kd_mpi_dma_send_frame#
【描述】
从用户空间发送数据到目的地址。
【语法】
k_s32 kd_mpi_dma_send_frame(k_u8 chn_num, k_video_frame_info *df_info, k_s32 millisec);
【参数】
参数名称 |
描述 |
输入/输出 |
---|---|---|
chn_num |
通道号。 |
输入 |
df_info |
发送数据的地址信息。 |
输入 |
millisec |
等待时间。 当此参数设置为 -1 时,阻塞; 当此参数设置为 0 时,非阻塞; 当此参数设置为大于 0 的值时,会等待相应时间直到成功发送数据,如果超时后仍未成功发送,返回失败。 |
输入 |
【返回值】
返回值 |
描述 |
---|---|
0 |
成功 |
非0 |
失败,其值参见错误码 |
【芯片差异】
无
【需求】
头文件:mpi_dma_api.h
库文件:libdma.a
【注意】
无
【举例】
无
【相关主题】
2.1.10 kd_mpi_dma_get_frame#
【描述】
获取 dma 搬运后的数据。
【语法】
k_s32 kd_mpi_dma_get_frame(k_u8 chn_num, k_video_frame_info *df_info, k_s32 millisec);
【参数】
参数名称 |
描述 |
输入/输出 |
---|---|---|
chn_num |
通道号。 |
输入 |
df_info |
获取数据的地址信息。 |
输出 |
millisec |
等待时间。 当此参数设置为 -1 时,阻塞; 当此参数设置为 0 时,非阻塞; 当此参数设置为大于 0 的值时,会等待相应时间知道成功获取数据,如果超时后仍未成功发送,返回失败。 |
输入 |
【返回值】
返回值 |
描述 |
---|---|
0 |
成功 |
非0 |
失败,其值参见错误码 |
【芯片差异】
无
【需求】
头文件:mpi_dma_api.h
库文件:libdma.a
【注意】
无
【举例】
无
【相关主题】
2.1.11 kd_mpi_dma_release_frame#
【描述】
释放获取的 dma 数据。
【语法】
k_s32 kd_mpi_dma_release_frame(k_u8 chn_num, k_video_frame_info *df_info);
【参数】
参数名称 |
描述 |
输入/输出 |
---|---|---|
chn_num |
通道号。 |
输入 |
df_info |
要释放的数据。 |
输入 |
【返回值】
返回值 |
描述 |
---|---|
0 |
成功 |
非0 |
失败,其值参见错误码 |
【芯片差异】
无
【需求】
头文件:mpi_dma_api.h
库文件:libdma.a
【注意】
当前设计中 dma 输出 buffer 为 3,如果获取 3 帧数据都没有调用此函数进行释放,那么无法继续输入数据。因此,用户应该在获取数据,使用完之后及时释放。
【举例】
无
【相关主题】
3 数据类型#
3.1 公共数据类型#
3.1.1 DMA_MAX_DEV_NUMS#
【说明】
DMA 最大设备数
【定义】
#define DMA_MAX_DEV_NUMS (1)
【注意事项】
无
【相关数据类型及接口】
无
3.1.2 DMA_MAX_CHN_NUMS#
【说明】
DMA 最大通道数
【定义】
#define DMA_MAX_CHN_NUMS (8)
【注意事项】
无
【相关数据类型及接口】
无
3.1.3 k_dma_mode_e#
【说明】
定义 dma 工作模式。
【定义】
typedef enum
{
DMA_BIND,
DMA_UNBIND,
} k_dma_mode_e;
【成员】
成员名称 |
描述 |
---|---|
BIND |
绑定模式。 |
UNBIND |
非绑定模式 |
【注意事项】
无
【相关数据类型及接口】
3.1.4 k_dma_dev_attr_t#
【说明】
定义 dma 设备属性。
【定义】
typedef struct
{
k_u8 burst_len;
k_u8 outstanding;
k_bool ckg_bypass;
} k_dma_dev_attr_t;
【成员】
成员名称 |
描述 |
---|---|
burst_len |
配置 dma 的 burst length |
outstanding |
配置 dma outstanding |
ckg_bypass |
配置 clock gate bypass |
【注意事项】
无
【相关数据类型及接口】
3.1.5 k_dma_chn_attr_u#
【说明】
定义 dma 通道属性。
【定义】
typedef union
{
k_gdma_chn_attr_t gdma_attr;
k_sdma_chn_attr_t sdma_attr;
} k_dma_chn_attr_u;
【成员】
成员名称 |
描述 |
---|---|
gdma_attr |
gdma 通道属性 |
sdma_attr |
sdma 通道属性 |
ckg_bypass |
配置 clock gate bypass |
【注意事项】
无
【相关数据类型及接口】
k_gdma_chn_attr_t k_sdma_chn_attr_t kd_mpi_dma_set_chn_attr kd_mpi_dma_get_chn_attr
3.1.6 k_video_frame_info#
【说明】
定义 dma 数据地址。
【定义】
typedef struct
{
k_video_frame v_frame; /**< Video picture frame */
k_u32 pool_id; /**< VB pool ID */
k_mod_id mod_id; /**< Logical unit for generating video frames */
} k_video_frame_info;
【成员】
成员名称 |
描述 |
---|---|
v_frame |
时间戳,绑定模式下有效。 |
pool_id |
数据 vb 池的 pool id。 |
mod_id |
模块 id |
【注意事项】
无
【相关数据类型及接口】
kd_mpi_dma_send_frame kd_mpi_dma_get_frame kd_mpi_dma_release_frame
3.1.7 k_video_frame#
【说明】
定义 dma 数据地址。使用公用的数据结构 k_video_frame,只使用到了其中的一部分成员。
【定义】
typedef struct
{
k_u64 phys_addr[3];
k_u64 virt_addr[3];
k_u32 time_ref;
k_u64 pts;
} k_video_frame;
【成员】
成员名称 |
描述 |
---|---|
phys_addr |
图像的物理地址,如果是单通道图像,只需配置第一个物理地址;如果是双通道图像,只需配置前两个物理地址;如果是三通道图像,需要配置三个物理地址。 |
virt_addr |
图像的虚拟地址,如果是单通道图像,只需配置第一个虚拟地址;如果是双通道图像,只需配置前两个虚拟地址;如果是三通道图像,需要配置三个虚拟地址。 |
time_ref |
透传的帧号,在绑定模式下,由前级输入 |
pts |
透传的时间戳,在绑定模式下,由前级输入 |
【注意事项】
无
【相关数据类型及接口】
3.2 gdma 通道数据类型#
该模块有如下数据类型
3.2.1 GDMA_MAX_CHN_NUMS#
【说明】
GDMA 最大通道数
【定义】
define GDMA_MAX_CHN_NUMS (4)
【注意事项】
无
【相关数据类型及接口】
无
3.2.2 k_gdma_rotation_e#
【说明】
定义 gdma 通道旋转角度。
【定义】
typedef enum
{
DEGREE_0, /**< Rotate 0 degrees */
DEGREE_90, /**< Rotate 90 degrees */
DEGREE_180, /**< Rotate 180 degrees */
DEGREE_270, /**< Rotate 270 degrees */
} k_gdma_rotation_e;
【注意事项】
无
【相关数据类型及接口】
3.2.3 k_pixel_format_dma_e#
【说明】
定义 gdma 图像格式。
【定义】
typedef enum
{
DMA_PIXEL_FORMAT_RGB_444 = 0,
DMA_PIXEL_FORMAT_RGB_555,
DMA_PIXEL_FORMAT_RGB_565,
DMA_PIXEL_FORMAT_RGB_888,
DMA_PIXEL_FORMAT_BGR_444,
DMA_PIXEL_FORMAT_BGR_555,
DMA_PIXEL_FORMAT_BGR_565,
DMA_PIXEL_FORMAT_BGR_888,
DMA_PIXEL_FORMAT_ARGB_1555,
DMA_PIXEL_FORMAT_ARGB_4444,
DMA_PIXEL_FORMAT_ARGB_8565,
DMA_PIXEL_FORMAT_ARGB_8888,
DMA_PIXEL_FORMAT_ABGR_1555,
DMA_PIXEL_FORMAT_ABGR_4444,
DMA_PIXEL_FORMAT_ABGR_8565,
DMA_PIXEL_FORMAT_ABGR_8888,
DMA_PIXEL_FORMAT_YVU_PLANAR_420_8BIT,
DMA_PIXEL_FORMAT_YVU_PLANAR_420_10BIT,
DMA_PIXEL_FORMAT_YVU_PLANAR_420_16BIT,
DMA_PIXEL_FORMAT_YVU_PLANAR_444_8BIT,
DMA_PIXEL_FORMAT_YVU_PLANAR_444_10BIT,
DMA_PIXEL_FORMAT_YUV_PLANAR_420_8BIT,
DMA_PIXEL_FORMAT_YUV_PLANAR_420_10BIT,
DMA_PIXEL_FORMAT_YUV_PLANAR_420_16BIT,
DMA_PIXEL_FORMAT_YVU_SEMIPLANAR_420_8BIT,
DMA_PIXEL_FORMAT_YVU_SEMIPLANAR_420_10BIT,
DMA_PIXEL_FORMAT_YVU_SEMIPLANAR_420_16BIT,
DMA_PIXEL_FORMAT_YUV_SEMIPLANAR_420_8BIT,
DMA_PIXEL_FORMAT_YUV_SEMIPLANAR_420_10BIT,
DMA_PIXEL_FORMAT_YUV_SEMIPLANAR_420_16BIT,
DMA_PIXEL_FORMAT_YUV_400_8BIT,
DMA_PIXEL_FORMAT_YUV_400_10BIT,
DMA_PIXEL_FORMAT_YUV_400_12BIT,
DMA_PIXEL_FORMAT_YUV_400_16BIT,
DMA_PIXEL_FORMAT_YUV_PACKED_444_8BIT,
DMA_PIXEL_FORMAT_YUV_PACKED_444_10BIT,
/* SVP data format */
DMA_PIXEL_FORMAT_BGR_888_PLANAR,
} k_pixel_format_dma_e;
3.2.4 k_gdma_chn_attr_t#
【说明】
定义 gdma 通道属性。
【定义】
typedef struct
{
k_u8 buffer_num;
k_gdma_rotation_e rotation;
k_bool x_mirror;
k_bool y_mirror;
k_u16 width;
k_u16 height;
k_u16 src_stride[3];
k_u16 dst_stride[3];
k_dma_mode_e work_mode;
k_pixel_format_dma_e pixel_format;
} k_gdma_chn_attr_t;
【成员】
成员名称 |
描述 |
---|---|
buffer_num |
gdma 通道 buffer 数量,至少为 1。 |
rotation |
gdma 通道旋转角度。 |
x_mirror |
gdma 通道是否进行水平镜像 |
y_mirror |
gdma 通道是否进行垂直镜像 |
width |
gdma 通道宽度,以像素为单位。 |
height |
gdma 通道高度,以像素为单位。 |
src_stride |
gdma 源数据 stride。如果图像格式是单通道模式,只需配置 |
dst_stride |
gdma目的数据 stride。如果图像格式是单通道模式,只需配置 |
work_mode |
工作模式,可以选择绑定模式或者非绑定模式。 |
pixel_format |
图像格式。 |
【注意事项】
无。
【相关数据类型及接口】
3.3 sdma 通道数据类型#
本模块有如下数据类型
3.3.1 SDMA_MAX_CHN_NUMS#
【说明】
SDMA 最大通道数
【定义】
#define SDMA_MAX_CHN_NUMS (4)
【注意事项】
无
【相关数据类型及接口】
无
3.3.2 k_sdma_data_mode_e#
【说明】
定义 sdma 通道传输数据的模式
【定义】
typedef enum
{
DIMENSION1,
DIMENSION2,
} k_sdma_data_mode_e;
【成员】
成员名称 |
描述 |
---|---|
DIMENSION1 |
一维 dma 传输模式 |
DIMENSION1 |
二维 dma 传输模式 |
【注意事项】
无
【相关数据类型及接口】
3.3.3 k_sdma_chn_attr_t#
【说明】
定义 sdma 通道属性。
【定义】
typedef struct
{
k_u8 buffer_num;
k_u32 line_size;
k_u16 line_num;
k_u16 line_space;
k_sdma_data_mode_e data_mode;
k_dma_mode_e work_mode;
} k_sdma_chn_attr_t;
【成员】
成员名称 |
描述 |
---|---|
buffer_num |
sdma 通道 buffer 数量,至少为 1。 |
line_size |
对于 1d 模式来说,是传输数据的总长度;对于 2d 模式来说,是单行数据的长度。 |
line_num |
对于 1d 模式来说,此成员无效;对于 2d 模式来说,是传输的行的个数。 |
line_space |
对于 1d 模式来说,此成员无效;对于 2d 模式来说,是行与行之间的间隔。 |
data_mode |
sdma 传输数据的模式,包括 1d 模式和 2d 模式。 |
work_mode |
工作模式,可以选择绑定模式或者非绑定模式。 |
【注意事项】
无
【相关数据类型及接口】
4. 错误码#
4.1 dma 错误码#
表 41
错误代码 |
宏定义 |
描述 |
---|---|---|
0xa0148001 |
K_ERR_DMA_INVALID_DEVID |
无效的设备号 |
0xa0148002 |
K_ERR_DMA_INVALID_CHNID |
无效的通道号 |
0xa0148003 |
K_ERR_DMA_ILLEGAL_PARAM |
参数错误 |
0xa0148004 |
K_ERR_DMA_EXIST |
DMA 设备已经存在 |
0xa0148005 |
K_ERR_DMA_UNEXIST |
DMA 设备不存在 |
0xa0148006 |
K_ERR_DMA_NULL_PTR |
空指针错误 |
0xa0148007 |
K_ERR_DMA_NOT_CONFIG |
尚未配置 DMA |
0xa0148008 |
K_ERR_DMA_NOT_SUPPORT |
不支持的功能 |
0xa0148009 |
K_ERR_DMA_NOT_PERM |
操作不允许 |
0xa014800c |
K_ERR_DMA_NOMEM |
分配内存失败,如系统内存不足 |
0xa014800d |
K_ERR_DMA_NOBUF |
BUFF 不足 |
0xa014800e |
K_ERR_DMA_BUF_EMPTY |
BUFF 为空 |
0xa014800f |
K_ERR_DMA_BUF_FULL |
BUFF 已满 |
0xa0148010 |
K_ERR_DMA_NOTREADY |
设备未就绪 |
0xa0148011 |
K_ERR_DMA_BADADDR |
错误的地址 |
0xa0148012 |
K_ERR_DMA_BUSY |
DMA 处与忙状态 |
5. 调试信息#
5.1 概述#
调试信息采用了 proc 文件系统,可实时反映当前系统的运行状态,所记录的信息可供问题定位及分析时使用
【文件目录】
/proc/
【文件清单】
文件名称 |
描述 |
---|---|
umap/dma |
记录当前 dma 模块的使用情况 |
5.2 系统绑定#
5.2.1 系统绑定调试信息#
【调试信息】
msh /\>cat /proc/umap/dma
-------------------------------dma dev attr info---------------------------------
DevId burst_len outstanding ckg_bypass
0 0 0 0
-------------------------------dma chn 0\~3 attr info-------------------------------
ChnId rotation x_mirror y_mirror width height work_mode
0 0 false false 0 0 BIND
1 0 false false 0 0 BIND
2 0 false false 0 0 BIND
3 0 false false 0 0 BIND
-------------------------------dma chn 4\~7 attr info-------------------------------
ChnId line_size line_num line_space data_mode work_mode
4 0 0 0 1 DIMENSION BIND
5 0 0 0 1 DIMENSION BIND
6 0 0 0 1 DIMENSION BIND
7 0 0 0 1 DIMENSION BIND
【调试信息分析】
记录当前 dma 模块的使用情况
【设备参数说明】
参数 |
描述 |
---|---|
DevId |
设备号 |
burst_len |
dma burst length |
outstanding |
dma outstanding |
【gdma 通道参数说明】
参数 |
描述 |
---|---|
ChnId |
通道号 |
rotation |
旋转度数 |
x_mirror |
是否进行了水平镜像 |
y_mirror |
是否进行了垂直镜像 |
width |
图像宽度,以像素为单位 |
height |
图像高度,以像素为单位 |
work_mode |
工作模式 |
【sdma 通道参数说明】
参数 |
描述 |
---|---|
ChnId |
通道号 |
line_size |
对于 1d 模式来说,是传输数据的总长度;对于 2d 模式来说,是单行数据的长度。 |
ine_num |
对于 1d 模式来说,此成员无效;对于 2d 模式来说,是传输的行的个数。 |
line_space |
对于 1d 模式来说,此成员无效;对于 2d 模式来说,是行与行之间的间隔。 |
data_mode |
sdma 传输数据的模式,包括 1d 模式和 2d 模式 |
work_mode |
工作模式,可以选择绑定模式或者非绑定模式。 |
6. demo 描述#
6.1 非绑定模式 demo#
非绑定模式 demo 位于 /bin/sample_dma.elf,执行 /bin/sample_dma.elf 后开始循环运行,按 e + 回车结束运行。
demo 主要实现了以下功能:
使用通道 0 搬运分辨率为 1920*1080,8bit,YUV400 单通道的图像,gdma 旋转 90 度后输出;
使用通道 1 搬运分辨率为 1280*720,8bit,YUV420 双通道的图像,gdma 旋转 180 度后输出;
使用通道 2 搬运分辨率为 1280*720,10bit,YUV420 三通道的图像,gdma 进行水平和垂直镜像后输出;
使用通道 4 搬运数据,sdma 使用 1d 模式搬运;
使用通道 5 搬运数据,sdma 使用 2d 模式搬运。
6.2 绑定模式 demo#
绑定模式 demo 位于 /bin/sample_dma_bind.elf,执行 /bin/sample_dma_bind.elf 后开始循环运行,按 e + 回车结束运行。
demo 主要实现了以下功能:
以 vvi 模块作为 gsdma 前级绑定的模拟输入,实现绑定功能的测试;
两个通道分别输入分辨率为 640*320,8bit,YUV400 单通道的图像,gdma 分别旋转 90 度和 180 度后输出。