MI SYS API
1. 概述¶
1.1. 模块说明¶
MI_SYS 是整个 MI 系统的基础模块,它给其他MI 模块的运行提供了基础。
图1-1 MI_SYS系统框架图
如图1-1所示,MI_SYS主要功能概述如下:
-
实现MI系统初始化、MMA内存缓冲池管理。
-
提供各模块注册设备节点,proc 系统的建立的通用接口。
-
提供各模块建立绑定关系的接口,管理各模块之间数据流动。
-
提供各模块申请MMA连续物理内存的接口,管理内存分配,映射虚拟地址,内存回收。
-
提供各模块建立工作线程的接口,管理各模块线程的创建,运行,销毁。
MI_SYS模块对应的ko文件为mi_sys.ko,库文件为libmi_sys.so、libmi_sys.a,头文件为mi_sys.h、mi_sys_datatype.h。具体功能请查阅API接口说明。
1.2. 文档格式约束¶
正体:用于文档正文内容的书写,其中代码段的书写需要用等宽字体。
正体 + 加粗:用于文档正文中重要内容的书写。
斜体:用于文档中Tips部分的书写。
斜体 + 加粗:用于文档中Tips部分重要内容的书写。
1.3. 关键字说明¶
ID: Identity document 的缩写,表示唯一编码。
MI: SStar SDK Middle Interface的缩写,本文中,如果出现“MI_SYS”类似的结构表示的是MI的SYS模块,如果是单纯的“MI”,泛指整个SDK。
Hex: 十六进制。
Kernl Mode: 指的是工作在Kernel环境下的代码,代码具有直接操作硬件的控制权限,比如ko中的函数和线程等。
User Mode: 指的是工作在User环境下的,比如客户的应用程序,系统调用等。
APP: Application的缩写,此处主要指调用MI API的应用程序。
API: Application Programming Interface,应用程序接口。
NVR: 全称Network Video Recorder,即网络视频录像机。
IPC: 全称IP Camera,即网络摄像机。
HW: 全称hardware,即硬件。
Dev: 全称Device,本文中表示MI模块设备,1.4.1有详细解释。
Chn: 全称Channel,本文中表示MI模块设备的某个通道,1.4.1有详细解释。
Port: 本文中表示MI模块设备通道中的某个端口,1.4.1有详细解释。
补充说明:
-
如无单独说明,本文中MI_SYS 和SYS,MI_DISP和DISP是相同意思,其余模块名称类似。
-
本文中出现的所有模块名称可以在MI_ModuleId_e中查阅其功能描述。
1.4. 流程框图¶
1.4.1. Dev/Chn/Port的关系¶
一个典型的MI 模块都会有Dev/chn/Port三级结构如图1-2。
Dev
一个MI 模块会有一个或多个Dev,一般来说不同的Dev表示该模块设备需要调用不同的HW资源,或者工作在不同的工作模式。比如说,VENC 在编码H264/H265时和编码Jpeg时,需要调用不同的HW资源,这个时候Dev就要分开了。
Chn
一个Dev 会有一个或多个Chn,Chn是通道的意思,一般来说不同的Chn表示该通道虽然和同Dev下的其他Chn共享HW资源,但是数据来源或者工作模式是不一样的。比如码流来源不同,Chn一般也不一样。
Port
一个Chn 会有一个或多个Port,Port是端口的意思,由InputPort和OutputPort组成。一般来说不同的Port表示该通道虽然和同Dev同Chn下的其他Port共享HW资源和数据来源,但是需要设置的参数是不一样的,比如分辨率不同,Port一般也不一样。
一般来说,Port才是客户操作MI模块的最小独立单位,因为它明确了所有的信息:HW资源、数据来源、参数属性。
每个Port都由InputPort和OutputPort组成,InputPort是数据流入的端口,OutputPort是数据流出的端口。但需要注意的是,一个Port并不是总是必须有InputPort和OutputPort的,这样取决于该模块的行为。比如Disp这样的模块就只需要InputPort,无需OutputPort,它直接把结果显示到了Panel上。Vdec这样的模块,数据来源可以是用户调用Vdec接口直接送入,不经过InputPort,这样他就没有OutputPort了。
图1-2 MI模块的三级结构
Tips:
-
Chn和Port的界限并不是总是能区分清楚,如果某模块API文档的解释和上文的解释有差异,调用该模块请以它的API文档为准。
-
一个Port的InputPort/OutpuPort通常只有一个或零个,但某些特殊的模块例外。比如Vpe模块,它有一个InputPort和多个OutputPort。这表示Vpe共享同一个数据源,但是又必须要有不同规格的输出格式。
1.4.2. 一个典型的NVR数据流¶
图1-3是一个典型的NVR数据流模型。流动过程如下:
-
建立Vdec->Divp->Disp的绑定关系;
-
用户写入一段码流到Vdec的es buf;
-
Vdec解码,写入解码后的数据到Vdec OutpuPort申请的内存,送入下一级;
-
Divp 接收数据,送到Divp HW进行处理,写入Divp OutputPort,送入下一级;
-
Disp 将接收到的数据显示出来。
图1-3 一个典型的NVR数据流模型
1.4.3. 一个典型的IPC数据流¶
图1-4是一个典型的IPC数据流模型,流动过程如下:
-
建立Vif->Vpe->Venc的绑定关系;
-
Sensor 将数据送入vif处理;
-
Vif 将处理后的数据写入Output Port申请的内存,送入下一级;
-
Vpe接收数据,分别送入Pass0(ISP/SCL0)、Pass1(LDC)、Pass2(SCL1)进行处理,将处理的数据写入Output Port申请的内存,送入下一级;
-
Venc接收数据,送入编码器进行编码处理,将编码后的数据写入RingPool内存区;
-
用户调用Venc的接口取流,送入用户业务层App。
图1-4 一个典型的IPC数据流模型
Tips:
Vpe内部的3个Pass之间的数据流动实际比图中要复杂一些。但这都是MI内部的处理逻辑,使用API时无需过度关注。
1.5. insmod参数说明¶
使用insmod mi_sys.ko 后面可以带的参数使用情况如下表所示。
表 1-1:insmod mi_sys.ko可加参数列表
参数 | 含义 | 取值 |
---|---|---|
bEnableMmuPool | 是否使能MMU | 1:enable mmu 0:disable mmu Ex: bEnableMmuPool=1,表示使能mmu bEnableMmuPool=0,表示禁止mmu |
logBufSize | 缓存log的内存长度 | 默认为4Kbyte,单位:Byte Ex: logBufSize=4096,表示设置4096Byte,即4Kbyte |
cmdQBufSize | cmdq 内存大小 | 由产品规格决定,单位:4Kbyte Ex: cmdQBufSize=256,表示设置2564Kbyte |
2. API 参考¶
2.1. API描述格式说明¶
本手册使用 9个参考域描述 API 的相关信息,它们作用如 表所表示。
标签 | 功能 |
---|---|
功能 | 简要描述API的主要功能。 |
语法 | 列出调用API应包括的头文件以及API的原型声明。 |
参数 | 列出API的参数、参数说明及参数属性。 |
返回值 | 列出API所有可能的返回值及其含义。 |
依赖 | 列出API包含的头文件和API编译时要链接的库文件。 |
注意 | 列出使用API时应注意的事项。 |
举例 | 列出使用API的实例。 |
相关主题 | 调用上下文中有关联的接口。 |
2.2. 功能模块API列表¶
如前文所述,我们可以粗略的把MI_SYS的API分为三大类:系统功能类、数据流类、内存管理类。
API名 | 功能 |
---|---|
系统功能类 | |
MI_SYS_Init | 初始化MI_SYS系统 |
MI_SYS_Exit | 析构MI_SYS系统 |
MI_SYS_GetVersion | 获取MI 的系统版本号 |
MI_SYS_GetCurPts | 获取MI系统当前时间戳 |
MI_SYS_InitPtsBase | 初始化MI系统基准时间戳 |
MI_SYS_SyncPts | 同步MI系统时间戳 |
MI_SYS_SetReg | 设置寄存器的值,调试用 |
MI_SYS_GetReg | 获取寄存器的值,调试用 |
MI_SYS_ReadUuid | 获取Chip的Unique ID |
MI_SYS_EnableChnOutputPortLowLatency | 打开或者关闭通道output端口的低延迟输出功能 |
MI_SYS_InitDev | 初始化sys设备 |
MI_SYS_DeInitDev | 反初始化sys设备 |
MI_SYS_SetGlobalFlag | 设置全局标志位的值 |
数据流类 | |
MI_SYS_BindChnPort | 数据源输出端口到接收者输入端口的绑定 |
MI_SYS_BindChnPort2 | 数据源输出端口到接收者输入端口的绑定,需要指定工作模式 |
MI_SYS_UnBind_ChnPort | 数据源输出端口到接收者输入端口的解绑定 |
MI_SYS_GetBindbyDest | 查询数据接收者输入端口的对应的源输出端口 |
MI_SYS_ChnInputPortGetBuf | 获取通道inputPort的buf |
MI_SYS_ChnInputPortPutBuf | 将通道inputPort的buf加到待处理队列 |
MI_SYS_ChnOutputPortGetBuf | 获取通道outputPort的buf |
MI_SYS_ChnOutputPortPutBuf | 释放通道outputPort的buf |
MI_SYS_ChnInputPortGetBufPa | 分配通道input端口对应的buf object,仅提供MIU物理地址 |
MI_SYS_ChnInputPortPutBufPa | 把通道input端口对应的buf object加到待处理队列,与MI_SYS_ChnInputPortGetBufPa成对使用 |
MI_SYS_ChnOutputPortGetBufPa | 分配通道output端口对应的buf object,仅提供MIU物理地址 |
MI_SYS_ChnOutputPortPutBufPa | 释放通道output端口对应的buf object,与MI_SYS_ChnOutputPortGetBufPa成对使用 |
MI_SYS_SetChnOutputPortDepth | 设置通道OutputPort的深度 |
MI_SYS_ChnPortInjectBuf | 向模块通道inputPort注入outputPort Buf数据 |
MI_SYS_GetFd | 获取当前通道等待事件的文件描述符 |
MI_SYS_CloseFd | 关闭当前通道的文件描述符 |
MI_SYS_DupBuf | 复制一个buf object |
内存管理类 | |
MI_SYS_SetChnMMAConf | 设置模块设备通道输出端口默认分配内存的MMA池名称 |
MI_SYS_GetChnMMAConf | 获取模块设备通道输出端口默认分配内存的MMA池名称 |
MI_SYS_ConfDevPubPools | 配置并初始化模块公共缓冲池 |
MI_SYS_ReleaseDevPubPools | 释放模块公共缓冲池 |
MI_SYS_ConfGloPubPools | 配置并初始化MI全系统默认VB缓存池 |
MI_SYS_ReleaseGloPubPools | 释放MI全系统默认VB缓存池 |
MI_SYS_MMA_Alloc | 应用程序从MMA内存管理池申请物理连续内存 |
MI_SYS_MMA_Free | 用户态释放从MMA内存管理池中分配的内存 |
MI_SYS_Mmap | 映射物理内存到CPU虚拟地址 |
MI_SYS_FlushInvCache | Flush cache CPU虚拟地址 |
MI_SYS_Munmap | 取消物理内存到虚拟地址的映射 |
MI_SYS_MemsetPa | 通过DMA硬件模块,填充整块物理内存 |
MI_SYS_MemcpyPa | 通过DMA硬件模块,把源内存数据拷贝到目标内存上 |
MI_SYS_BufFillPa | 通过DMA硬件模块,填充部分物理内存 |
MI_SYS_BufBlitPa | 通过DMA硬件模块,把源内存数据上的部分区域拷贝到目标内存上的部分区域 |
MI_SYS_ConfigPrivateMMAPool | 为模快配置私有MMA Heap |
MI_SYS_PrivateDevChnHeapAlloc | 从模块通道私有MMA Pool 申请内存 |
MI_SYS_PrivateDevChnHeapFree | 从模块通道私有MMA pool 释放内存 |
MI_SYS_Va2Pa | 将MI内存块的CPU虚拟地址转成内存物理地址 |
MI_SYS_GetMmaPoolInfo | 获取指定mma 池的总空闲大小和物理上连续的最大的内存长度 |
2.3. 系统功能类API¶
2.3.1. MI_SYS_Init¶
-
功能
MI_SYS初始化,MI_SYS 模块为系统内其它MI模组提供基础支援,需要早于系统内其它MI模组初始化,否则其它stream类型的模组初始化时会失败。
-
语法
MI_S32 MI_SYS_Init(void);
-
返回值
-
0 成功。
-
非0 失败,参照错误码。
-
-
依赖
-
头文件:mi_sys_datatype.h、mi_sys.h
-
库文件:libmi_sys.a / libmi_sys.so
-
-
注意
-
MI_SYS_Init需要早于其他MI模组的Init函数调用。
-
可以在同一进程或多进程中重复调用MI_SYS_Init,但必须和MI_SYS_Exit成对使用,否则会报错。
-
系统在内核启动参数内,需要配置好MMA 内存堆的配置参数。
-
-
举例
系统Init调用Sample
MI_S32 ST_Sys_Init(void) { MI_SYS_Version_t stVersion; MI_U64 u64Pts = 0; STCHECKRESULT(MI_SYS_Init()); memset(&stVersion, 0x0, sizeof(MI_SYS_Version_t)); STCHECKRESULT(MI_SYS_GetVersion(&stVersion)); ST_INFO("u8Version:%s\n", stVersion.u8Version); STCHECKRESULT(MI_SYS_GetCurPts(&u64Pts)); ST_INFO("u64Pts:0x%llx\n", u64Pts); u64Pts = 0xF1237890F1237890; STCHECKRESULT(MI_SYS_InitPtsBase(u64Pts)); u64Pts = 0xE1237890E1237890; STCHECKRESULT(MI_SYS_SyncPts(u64Pts)); return MI_SUCCESS; } MI_S32 ST_Sys_Exit(void) { STCHECKRESULT(MI_SYS_Exit()); return MI_SUCCESS; }
Tips:
本示例适用于: MI_SYS_Init / MI_SYS_Exit / MI_SYS_GetVersion / MI_SYS_GetCurPts / MI_SYS_InitPtsBase / MI_SYS_SyncPts / MI_SYS_ReadUuid .
-
相关主题
2.3.2. MI_SYS_Exit¶
-
功能
MI_SYS初始化,调用MI_SYS_Exit之前,需要确保系统内所有其他模组都已经完成去初始化,所有VBPOOL都已经销毁,否则MI_SYS_Exit会返回失败。
-
语法
MI_S32 MI_SYS_Exit (void);
-
返回值
-
0 成功。
-
非0 失败,参照错误码。
-
-
依赖
-
头文件:mi_sys_datatype.h、mi_sys.h
-
库文件:libmi_sys.a / libmi_sys.so
-
-
注意
-
MI_SYS_Exit调用前需要确保系统内所有其他模组都已经完成去初始化。
-
MI_SYS_Exit调用前需要确保系统内所有创建的VBPOOL已经成功销毁。
-
-
举例
参见 系统Init调用Sample举例。
-
相关主题
2.3.3. MI_SYS_GetVersion¶
-
功能
获取MI 的系统版本号。
-
语法
MI_S32 MI_SYS_GetVersion (MI_SYS_Version_t *pstVersion);
-
形参
参数名称 描述 输入/输出 pstVersion 系统版本号返回数据结构指针 输出 -
返回值
-
0 成功。
-
非0 失败,参照错误码。
-
-
依赖
-
头文件:mi_sys_datatype.h、mi_sys.h
-
库文件:libmi_sys.a / libmi_sys.so
-
-
举例
参见 系统Init调用Sample举例。
2.3.4. MI_SYS_GetCurPts¶
-
功能
获取MI系统当前时间戳。
-
语法
MI_S32 MI_SYS_GetCurPts (MI_U64 *pu64Pts);
-
形参
参数名称 描述 输入/输出 pu64Pts 系统当前时间戳返回地址 输出 -
返回值
-
0 成功。
-
非0 失败,参照错误码。
-
-
依赖
-
头文件:mi_sys_datatype.h、mi_sys.h
-
库文件:libmi_sys.a / libmi_sys.so
-
-
举例
参见系统Init调用Sample举例。
2.3.5. MI_SYS_InitPtsBase¶
-
功能
初始化MI系统时间戳基准。
-
语法
MI_S32 MI_SYS_InitPtsBase (MI_U64 u64PtsBase);
-
形参
参数名称 描述 输入/输出 u64PtsBase 设置的系统时间戳基准 输入 -
返回值
-
0 成功。
-
非0 失败,参照错误码。
-
-
依赖
-
头文件:mi_sys_datatype.h、mi_sys.h
-
库文件:libmi_sys.a / libmi_sys.so
-
-
举例
参见系统Init调用Sample举例。
2.3.6. MI_SYS_SyncPts¶
-
功能
微调同步MI系统时间戳。
-
语法
MI_S32 MI_SYS_SyncPts (MI_U64 u64Pts);
-
形参
参数名称 描述 输入/输出 u64Pts 微调后的系统时间戳基准 输入 -
返回值
-
0 成功。
-
非0 失败,参照错误码。
-
-
依赖
-
头文件:mi_sys_datatype.h、mi_sys.h
-
库文件:libmi_sys.a / libmi_sys.so
-
-
举例
参见系统Init调用Sample举例。
2.3.7. MI_SYS_SetReg¶
-
功能
设置寄存器的值,调试用。
-
语法
MI_S32 MI_SYS_SetReg (MI_U32 u32RegAddr, MI_U16 u16Value,MI_U16 u16Mask);
-
形参
参数名称 描述 输入/输出 u32RegAddr Register 总线之地址 输入 u16Value 待写入之16bit寄存器值 输入 u16Mask 本次写入寄存器值之Mask遮挡栏位 输入 -
返回值
-
0 成功。
-
非0 失败,参照错误码。
-
-
依赖
-
头文件:mi_sys_datatype.h、mi_sys.h
-
库文件:libmi_sys.a / libmi_sys.so
-
2.3.8. MI_SYS_GetReg¶
-
功能
读取寄存器的值,调试用。
-
语法
MI_S32 MI_SYS_GetReg (MI_U32 u32RegAddr, MI_U16 *pu16Value);
-
形参
参数名称 描述 输入/输出 u32RegAddr Register 总线之地址 输入 pu16Value 待读回16bit寄存器值返回地址 输出 -
返回值
-
0 成功。
-
非0 失败,参照错误码。
-
-
依赖
-
头文件:mi_sys_datatype.h、mi_sys.h
-
库文件:libmi_sys.a / libmi_sys.so
-
2.3.9. MI_SYS_ReadUuid¶
-
功能
获取Chip的Unique ID
-
语法
MI_S32 MI_SYS_ReadUuid (MI_U64 *u64Uuid);
-
形参
参数名称 描述 输入/输出 u64Uuid 获取chip unique ID值的指针 输出 -
返回值
-
0 成功。
-
非0 失败,参照错误码。
-
-
依赖
-
头文件:mi_sys_datatype.h、mi_sys.h
-
库文件:libmi_sys.a / libmi_sys.so
-
-
举例
参见系统Init调用Sample举例。
2.3.10. MI_SYS_EnableChnOutputPortLowLatency¶
-
功能
打开或者关闭通道output端口的低延迟输出功能
-
语法
MI_S32 MI_SYS_EnableChnOutputPortLowLatency(MI_SYS_ChnPort_t *pstChnPort,MI_BOOL bEnable , MI_U32 u32Param);
-
形参
参数名称 描述 输入/输出 pstChnPort 指向模块通道之output端口的指针 输入 bEnable TRUE:打开 ;FALSE:关闭。默认FALSE 输入 u32Param Low Latency参数,其含义由具体模块决定 VPE用于设置Line Count,表示写完多少条Line后就把Output port buf给User或后级 输入 -
返回值
-
0 成功。
-
非0 失败,参照错误码。
-
-
依赖
-
头文件:mi_sys_datatype.h、mi_sys.h
-
库文件:libmi_sys.a / libmi_sys.so
-
-
注意
当bEnable 为true时,u32Param必须大于0,否则设置无效
-
举例
MI_SYS_ChnPort_t stChnPort; stChnPort.eModId = E_MI_MODULE_ID_VPE; stChnPort.u32DevId = 0; stChnPort.u32ChnId = 0; stChnPort.u32PortId = 0; //打开VPE 通道1 output端口0 的低延迟输出功能,设定完成100行即可输出 MI_SYS_EnableChnOutputPortLowLatency(&stChnPort,TRUE , 100); //关闭VPE 通道1 output端口0 的低延迟输出功能, MI_SYS_EnableChnOutputPortLowLatency(&stChnPort,FALSE , 0);
2.3.11. MI_SYS_InitDev¶
-
功能
MI_SYS初始化,MI_SYS 模块为系统内其它MI模组提供基础支援,需要早于系统内其它MI 模组初始化,否则其它stream类型的模组初始化时会失败。
-
语法
MI_S32 MI_SYS_InitDev(MI_SYS_InitParam_t *pstInitParam);
-
形参
参数名称 描述 输入/输出 pstInitParam 设备初始化参数 输入 -
返回值
-
0 成功。
-
非0 失败,参照错误码。
-
-
依赖
-
头文件:mi_sys_datatype.h、mi_sys.h
-
库文件:libmi_sys.a / libmi_sys.so
-
-
注意
-
MI_SYS_InitDev需要早于其他MI模组的Init函数调用。
-
系统在内核启动参数内,需要配置好MMA 内存堆的配置参数。
-
pstInitParam暂未使用,空值传入即可。
-
此接口在Version 2.17以上版本推荐使用,用于替换原有MI_SYS_Init接口。
-
-
相关主题
2.3.12. MI_SYS_DeInitDev¶
-
功能
MI_SYS初始化, 调用MI_SYS_DeInitDev之前,需要确保系统内所有其他模组都已经完成去初始化,所有VBPOOL都已经销毁,否则MI_SYS_DeInitDev 会返回失败。
-
语法
MI_S32 MI_SYS_DeInitDev(void);
-
返回值
-
0 成功。
-
非0 失败,参照错误码。
-
-
依赖
-
头文件:mi_sys_datatype.h、mi_sys.h
-
库文件:libmi_sys.a / libmi_sys.so
-
-
注意
-
此函数必须在初始化设备后调用,否则返回失败。
-
此接口同个进程下不支持多次调用,否则会返回失败。
-
MI_SYS_DeInitDev调用前需要确保系统内所有其他模组都已经完成去初始化。
-
此接口在Version 2.17以上版本推荐使用,用于替换原有MI_SYS_Exit接口。
-
-
相关主题
2.3.13. MI_SYS_SetGlobalFlag¶
-
功能
设置全局标志位的值。通过MI_SYS_SetGlobalFlag设置全局标志位的值来告诉MI_SYS IR灯已打开,目前只支持设置IR标志位的值。
-
语法
MI_S32 MI_SYS_SetGlobalFlag(MI_SYS_GlobalFlagParam_t *pstGlobalFlagParam);
-
形参
参数名称 描述 输入/输出 pstGlobalFlagParam 设置全局Flag参数 输入 -
返回值
-
0 成功。
-
非0 失败,参照错误码。
-
-
依赖
-
头文件:mi_sys_datatype.h、mi_sys.h
-
库文件:libmi_sys.a / libmi_sys.so
-
-
注意
当IR灯打开时,需要通过MI_SYS_SetGlobalFlag接口将MI_SYS_GlobalFlagParam_t中的value成员设置为1,这样在后面通过MI_SYS_ChnOutputPortGetBuf 获取到的stBufInfo里面的u32IrFlag成员同样会记录为1。
若MI_SYS_SetGlobalFlag接口在中断中被调用,则需要将MI_SYS_GlobalFlagParam_t参数中的bIsr参数设置为1。
2.4. 数据流类 API¶
2.4.1. MI_SYS_BindChnPort¶
-
功能
数据源输出端口到数据接收者输入端口的绑定。
-
语法
MI_S32 MI_SYS_BindChnPort( *pstSrcChnPort, *pstDstChnPort, ,MI_U32 u32SrcFrmrate, MI_U32 u32DstFrmrate);
-
形参
参数名称 参数含义 输入/输出 pstSrcChnPort 源端口配置信息数据结构指针 输入 pstDstChnPort 目标端口配置信息数据结构指针 输入 u32SrcFrmrate 源端口配置的帧率 输入 u32DstFrmrate 目标端口配置的帧率 输入 -
返回值
-
0 成功。
-
非0 失败,参照错误码。
-
-
依赖
-
头文件:mi_sys_datatype.h、mi_sys.h
-
库文件:libmi_sys.a / libmi_sys.so
-
-
注意
-
源端口必须是通道输出端口。
-
目标端口必须是通道输入端口。
-
源和目标端口必须之前没有被绑定过。
-
本接口只支持按照E_MI_SYS_BIND_TYPE_FRAME_BASE方式绑定模块,在Version 2.0以上版本不推荐使用,请使用MI_SYS_BindChnPort2替代。
-
-
举例
MI_SYS_ChnPort_t stSrcChnPort; MI_SYS_ChnPort_t stDstChnPort; MI_U32 u32SrcFrmrate; MI_U32 u32DstFrmrate; stSrcChnPort.eModId = E_MI_MODULE_ID_VPE; stSrcChnPort.u32DevId = 0; stSrcChnPort.u32ChnId = 0; stSrcChnPort.u32PortId = 0; stDstChnPort.eModId = E_MI_MODULE_ID_VENC; stDstChnPort.u32DevId = 0; stDstChnPort.u32ChnId = 0; stDstChnPort.u32PortId = 0; u32SrcFrmrate = 30; u32DstFrmrate = 30; MI_SYS_BindChnPort(&stSrcChnPort, &stDstChnPort, u32SrcFrmrate, u32DstFrmrate);
-
相关主题
2.4.2. MI_SYS_BindChnPort2¶
-
功能
数据源输出端口到数据接收者输入端口的绑定,需要额外指定工作模式。
-
语法
MI_S32 MI_SYS_BindChnPort2(MI_SYS_ChnPort_t *pstSrcChnPort, MI_SYS_ChnPort_t *pstDstChnPort,MI_U32 u32SrcFrmrate, MI_U32 u32DstFrmrate, MI_SYS_BindType_e eBindType, MI_U32 u32BindParam);
-
形参
参数名称 参数含义 输入/输出 pstSrcChnPort 源端口配置信息数据结构指针。 输入 pstDstChnPort 目标端口配置信息数据结构指针。 输入 u32SrcFrmrate 源端口配置的帧率 输入 u32DstFrmrate 目标端口配置的帧率 输入 eBindType 源端口与目标端口连接的工作模式,参考 MI_SYS_BindType_e 输入 u32BindParam 不同工作模式需带入的额外参数。 输入 -
返回值
-
0 成功。
-
非0 失败,参照错误码。
-
-
依赖
-
头文件:mi_sys_datatype.h、mi_sys.h
-
库文件:libmi_sys.a / libmi_sys.so
-
-
注意
-
源端口必须是通道输出端口。
-
目标端口必须是通道输入端口。
-
同一个源端口可以绑定多个目标端口。
-
同一个目标端口只能绑定一个源端口,使用之前必须没有被绑定过。
-
MI_SYS_BindChnPort2在pstSrcChnPort、pstDstChnPort和eBindType相同的情况下可以被多次调用,来重新设置需要修改的u32SrcFrmrate和u32DstFrmrate。
-
旧版本MI SYS不提供此接口,如没有找到,不用设置。
-
各种eBindType使用场景如下:
eBindType 适用场景 E_MI_SYS_BIND_TYPE_SW_LOW_LATENCY u32BindParam表示低时延值,单位ms E_MI_SYS_BIND_TYPE_HW_RING u32BindParam表示ring buffer depth,目前是只有vpe和venc(h264/h265)支持这种模式,只支持一路; vif->isp,支持一路;isp->scl,支持多路 E_MI_SYS_BIND_TYPE_REALTIME u32BindParam未使用,jpe imi会走这种模式,只支持一路 E_MI_SYS_BIND_TYPE_FRAME_BASE u32BindParam未使用,默认是走这种frame mode -
-
举例
MI_SYS_ChnPort_t stSrcChnPort; MI_SYS_ChnPort_t stDstChnPort; MI_U32 u32SrcFrmrate; MI_U32 u32DstFrmrate; MI_SYS_BindType_e eBindType; MI_U32 u32BindParam; // a. vpe与venc连接方式为E_MI_SYS_BIND_TYPE_FRAME_BASE,代码如下: stSrcChnPort.eModId = E_MI_MODULE_ID_VPE; stSrcChnPort.u32DevId = 0; stSrcChnPort.u32ChnId = 0; stSrcChnPort.u32PortId = 0; stDstChnPort.eModId = E_MI_MODULE_ID_VENC; stDstChnPort.u32DevId = 0; stDstChnPort.u32ChnId = 0; stDstChnPort.u32PortId = 0; u32SrcFrmrate = 30; u32DstFrmrate = 30; eBindType = E_MI_SYS_BIND_TYPE_FRAME_BASE; u32BindParam = 0; STCHECKRESULT(MI_SYS_BindChnPort2(&stSrcChnPort, &stDstChnPort, u32SrcFrmrate, u32DstFrmrate, eBindType, u32BindParam)); // b. vpe与jpe连接方式为E_MI_SYS_BIND_TYPE_REALTIME,代码如下: stSrcChnPort.eModId = E_MI_MODULE_ID_VPE; stSrcChnPort.u32DevId = 0; stSrcChnPort.u32ChnId = 0; stSrcChnPort.u32PortId = 0; stDstChnPort.eModId = E_MI_MODULE_ID_VENC; stDstChnPort.u32DevId = 1; stDstChnPort.u32ChnId = 0; stDstChnPort.u32PortId = 0; u32SrcFrmrate = 30; u32DstFrmrate = 30; eBindType = E_MI_SYS_BIND_TYPE_REALTIME; u32BindParam = 0; STCHECKRESULT(MI_SYS_BindChnPort2(&stSrcChnPort, &stDstChnPort, u32SrcFrmrate, u32DstFrmrate, eBindType, u32BindParam)); // c. vpe与venc连接方式为E_MI_SYS_BIND_TYPE_HW_RING,代码如下: tSrcChnPort.eModId = E_MI_MODULE_ID_VPE; stSrcChnPort.u32DevId = 0; stSrcChnPort.u32ChnId = 0; stSrcChnPort.u32PortId = 0; stDstChnPort.eModId = E_MI_MODULE_ID_VENC; stDstChnPort.u32DevId = 0; stDstChnPort.u32ChnId = 0; stDstChnPort.u32PortId = 0; u32SrcFrmrate = 30; u32DstFrmrate = 30; eBindType = E_MI_SYS_BIND_TYPE_HW_RING; u32BindParam = 1080;//假设vpe output resolution为1920*1080,设置ring buffer depth为1080 STCHECKRESULT(MI_SYS_BindChnPort2(&stSrcChnPort, &stDstChnPort, u32SrcFrmrate, u32DstFrmrate, eBindType, u32BindParam));
-
相关主题
2.4.3. MI_SYS_UnBind_ChnPort¶
-
功能
数据源输出端口到数据接收者输入端口之间的解绑定。
-
语法
MI_S32 MI_SYS_UnBindChnPort(*pstSrcChnPort, *pstDstChnPort);
-
形参
参数名称 描述 输入/输出 pstSrcChnPort 源端口配置信息数据结构指针 输入 pstDstChnPort 目标端口配置信息数据结构指针 输入 -
返回值
-
0 成功。
-
非0 失败,参照错误码。
-
-
依赖
-
头文件:mi_sys_datatype.h、mi_sys.h
-
库文件:libmi_sys.a / libmi_sys.so
-
-
注意
-
源端口必须是通道输出端口。
-
目标端口必须是通道输入端口。
-
源和目标端口之间之前必须已经被绑定过
-
-
相关主题
2.4.4. MI_SYS_GetBindbyDest¶
-
功能
查询数据接收者输入端口的对应的源输出端口。
-
语法
MI_S32 MI_SYS_GetBindbyDest (MI_SYS_ChnPort_t *pstDstChnPort, MI_SYS_ChnPort_t *pstSrcChnPort);
-
形参
参数名称 描述 输入/输出 pstDstChnPort 目标端口配置信息数据结构指针 输入 pstSrcChnPort 源端口配置信息数据结构指针 输出 -
返回值
-
0 成功。
-
非0 失败,参照错误码。
-
-
依赖
-
头文件:mi_sys_datatype.h、mi_sys.h
-
库文件:libmi_sys.a / libmi_sys.so
-
-
注意
-
目标端口必须是通道输入端口。
-
目标端口之前必须已经被绑定过
-
2.4.5. MI_SYS_ChnInputPortGetBuf¶
-
功能
分配通道input端口对应的buf object。
-
语法
MI_S32 MI_SYS_ChnInputPortGetBuf (MI_SYS_ChnPort_t *pstChnPort, MI_SYS_BufConf_t *pstBufConf, MI_SYS_BufInfo_t *pstBufInfo, MI_SYS_BUF_HANDLE *phHandle, MI_S32 s32TimeOutMs);
-
形参
参数名称 描述 输入/输出 pstChnPort 指向模块通道之input端口的指针 输入 pstBufConf 待分配内存配置信息 输入 pstPortBuf 返回之buf 指针 输出 phHandle 获取的intputPort Buf的handle 输出 s32TimeOutMs 等待超时的毫秒数,>=0时为具体时间,<0时会采用默认值20ms 输入 -
返回值
-
0 成功。
-
非0 失败,参照错误码。
-
-
依赖
-
头文件:mi_sys_datatype.h、mi_sys.h
-
库文件:libmi_sys.a / libmi_sys.so
-
-
举例
MI_SYS_ChnInputPortGetBuf调用Sample
MI_SYS_ChnPort_t stVpeChnInput; MI_SYS_BUF_HANDLE hHandle = 0; MI_SYS_BufConf_t stBufConf; MI_SYS_BufInfo_t stBufInfo; **struct** timeval stTv; MI_U16 u16Width = 1920, u16Height = 1080; FILE *fp = NULL; memset(&stVpeChnInput, 0x0, sizeof(MI_SYS_ChnPort_t)); memset(&stBufConf, 0x0, sizeof(MI_SYS_BufConf_t)); memset(&stBufInfo, 0x0, sizeof(MI_SYS_BufInfo_t)); stVpeChnInput.eModId = E_MI_MODULE_ID_VPE; stVpeChnInput.u32DevId = 0; stVpeChnInput.u32ChnId = 0; stVpeChnInput.u32PortId = 0; fp = fopen("/mnt/vpeport0_1920x1080_pixel0_737.raw","rb"); if(fp == NULL) { printf("file %s open fail\\n", "/mnt/vpeport0_1920x1080_pixel0_737.raw"); return 0; } while(1) { stBufConf.eBufType = E_MI_SYS_BUFDATA_FRAME; gettimeofday(&stTv, NULL); stBufConf.u64TargetPts = stTv.tv_sec*1000000 + stTv.tv_usec; stBufConf.stFrameCfg.eFormat = E_MI_SYS_PIXEL_FRAME_YUV422_YUYV; stBufConf.stFrameCfg.eFrameScanMode = E_MI_SYS_FRAME_SCAN_MODE_PROGRESSIVE; stBufConf.stFrameCfg.u16Width = u16Width; stBufConf.stFrameCfg.u16Height = u16Height; if(MI_SUCCESS == MI_SYS_ChnInputPortGetBuf(&stVpeChnInput,&stBufConf,&stBufInfo,&hHandle,0)) { if(fread(stBufInfo.stFrameData.pVirAddr[0], u16Width*u16Height*2, 1, fp)<= 0) { fseek(fp, 0, SEEK_SET); } MI_SYS_ChnInputPortPutBuf(hHandle,&stBufInfo, FALSE); } }
-
相关主题
2.4.6. MI_SYS_ChnInputPortPutBuf¶
-
功能
把通道input端口对应的buf object加到待处理队列。
-
语法
MI_S32 MI_SYS_ChnInputPortPutBuf (MI_SYS_BUF_HANDLE hHandle ,*pstPortBuf, MI_BOOL bDropBuf);
-
形参
参数名称 描述 输入/输出 hHandle 当前buf的Handle 输入 pstPortBuf 待提交的buf 指针 输入 bDropBuf 是否将buf直接丢弃而不用提交到待处理队列上 输入 -
返回值
-
0 成功。
-
非0 失败,参照错误码。
-
-
依赖
-
头文件:mi_sys_datatype.h、mi_sys.h
-
库文件:libmi_sys.a / libmi_sys.so
-
-
举例
-
相关主题
2.4.7. MI_SYS_ChnOutputPortGetBuf¶
-
功能
获取通道output端口输出buf对应buf object。
-
语法
MI_S32 MI_SYS_ChnOutputPortGetBuf (*pstChnPort, *pstBufInfo ,MI_SYS_BUF_HANDLE *phHandle);
-
形参
参数名称 描述 输入/输出 pstChnPort 指向模块通道之output端口的指针 输入 pstBufInfo 返回之buf 指针 输出 phHandle 获取的outputPort Buf的handle 输出 -
返回值
-
0 成功。
-
非0 失败,参照错误码。
-
-
依赖
-
头文件:mi_sys_datatype.h、mi_sys.h
-
库文件:libmi_sys.a / libmi_sys.so
-
-
举例
MI_SYS_ChnOutputPortGetBuf调用Sample
MI_SYS_ChnPort_t stChnPort; MI_SYS_BufInfo_t stBufInfo; MI_SYS_BUF_HANDLE stBufHandle; MI_S32 s32Ret = MI_SUCCESS; MI_S32 s32Fd = 0; fd_set read_fds; struct timeval TimeoutVal; char szFileName[128]; int fd = 0; MI_U32 u32GetFramesCount = 0; MI_BOOL _bWriteFile = TRUE; stChnPort.eModId = E_MI_MODULE_ID_DIVP; stChnPort.u32DevId = 0; stChnPort.u32ChnId = DIVP_CHN_FOR_VDF; stChnPort.u32PortId = 0; s32Ret = MI_SYS_GetFd(&stChnPort, &s32Fd); if(MI_SUCCESS != s32Ret) { ST_ERR("MI_SYS_GetFd 0, error, %X\n", s32Ret); return NULL; } s32Ret = MI_SYS_SetChnOutputPortDepth(&stChnPort, 2, 3); if (MI_SUCCESS != s32Ret) { ST_ERR("MI_SYS_SetChnOutputPortDepth err:%x, chn:%d,port:%d\n", s32Ret, stChnPort.u32ChnId, stChnPort.u32PortId); return NULL; } sprintf(szFileName, "divp%d.es", stChnPort.u32ChnId); printf("start to record %s\n", szFileName); fd = open(szFileName, O_RDWR | O_CREAT | O_TRUNC, S_IRUSR | S_IWUSR | S_IRGRP | S_IROTH); if (fd < 0) { ST_ERR("create %s fail\n", szFileName); } while (1) { FD_ZERO(&read_fds); FD_SET(s32Fd, &read_fds); TimeoutVal.tv_sec = 1; TimeoutVal.tv_usec = 0; s32Ret = select(s32Fd + 1, &read_fds, NULL, NULL, &TimeoutVal); if(s32Ret < 0) { ST_ERR("select failed!\n"); // usleep(10 * 1000); continue; } else if(s32Ret == 0) { ST_ERR("get divp frame time out\n"); //usleep(10 * 1000); continue; } else { if(FD_ISSET(s32Fd, &read_fds)) { s32Ret = MI_SYS_ChnOutputPortGetBuf(&stChnPort, &stBufInfo, &stBufHandle); if(MI_SUCCESS != s32Ret) { //ST_ERR("MI_SYS_ChnOutputPortGetBuf err, %x\n", s32Ret); continue; } // save one Frame YUV data if (fd > 0) { if(_bWriteFile) { write(fd, stBufInfo.stFrameData.pVirAddr[0], stBufInfo.stFrameData.u16Height * stBufInfo.stFrameData.u32Stride[0] + stBufInfo.stFrameData.u16Height * stBufInfo.stFrameData.u32Stride[1] /2); } } ++u32GetFramesCount; printf("channelId[%u] u32GetFramesCount[%u]\n", stChnPort.u32ChnId, u32GetFramesCount); MI_SYS_ChnOutputPortPutBuf(stBufHandle); } } } if (fd > 0) { close(fd); fd = -1;
}
MI_SYS_SetChnOutputPortDepth(&stChnPort, 0, 3); printf("exit record\n"); return NULL;
-
相关主题
2.4.8. MI_SYS_ChnOutputPortPutBuf¶
-
功能
释放通道output端口输出buf对应的buf object。
-
语法
MI_S32 MI_SYS_ChnOutputPortPutBuf (MI_SYS_BUF_HANDLE hBufHandle);
-
形参
参数名称 描述 输入/输出 hBufHandle 待提交的buf 的handle 输入 -
返回值
-
0 成功。
-
非0 失败,参照错误码。
-
-
依赖
-
头文件:mi_sys_datatype.h、mi_sys.h
-
库文件:libmi_sys.a / libmi_sys.so
-
-
举例
-
相关主题
2.4.9. MI_SYS_ChnInputPortGetBufPa¶
-
功能
分配通道input端口对应的buf object,仅提供MIU物理地址。
-
语法
MI_S32 MI_SYS_ChnInputPortGetBufPa (MI_SYS_ChnPort_t *pstChnPort,MI_SYS_BufConf_t *pstBufConf, MI_SYS_BufInfo_t *pstBufInfo, MI_SYS_BUF_HANDLE *phHandle , MI_S32 s32TimeOutMs);
-
形参
参数名称 描述 输入/输出 pstChnPort 指向模块通道之input端口的指针 输入 pstBufConf 待分配内存配置信息 输入 pstPortBuf 返回之buf 指针 输出 phHandle 获取的intputPort Buf的 handle 输出 s32TimeOutMs 等待超时的毫秒数,>=0时为具体时间;<0时会采用默认值20ms 输入 -
返回值
-
0 成功。
-
非0 失败,参照错误码。
-
-
依赖
-
头文件:mi_sys_datatype.h、mi_sys.h
-
库文件:libmi_sys.a / libmi_sys.so
-
-
注意
与MI_SYS_ChnInputPortGetBuf区别:MI_SYS_ChnInputPortGetBufPa获取的pstBufInfo中只能使用物理地址phyAddr,而MI_SYS_ChnInputPortGetBuf获取的pstBufInfo中物理地址phyAddr和虚拟地址pVirAddr都可以使用。
-
举例
MI_SYS_ChnInputPortGetBufPa调用Sample
MI_SYS_ChnPort_t stVpeChnInput; MI_SYS_BUF_HANDLE hHandle = 0; MI_SYS_BufConf_t stBufConf; MI_SYS_BufInfo_t stBufInfo; struct timeval stTv; MI_U16 u16Width = 1920, u16Height = 1080; FILE *fp = NULL; void *pVirAddr = NULL; memset(&stVpeChnInput, 0x0, sizeof(MI_SYS_ChnPort_t)); memset(&stBufConf, 0x0, sizeof(MI_SYS_BufConf_t)); memset(&stBufInfo, 0x0, sizeof(MI_SYS_BufInfo_t)); stVpeChnInput.eModId = E_MI_MODULE_ID_VPE; stVpeChnInput.u32DevId = 0; stVpeChnInput.u32ChnId = 0; stVpeChnInput.u32PortId = 0; fp = fopen("/mnt/vpeport0_1920x1080_pixel0_737.raw", "rb"); if (fp == NULL) { printf("file %s open fail\n", "/mnt/vpeport0_1920x1080_pixel0_737.raw"); return 0; } while (1) { stBufConf.eBufType = E_MI_SYS_BUFDATA_FRAME; gettimeofday(&stTv, NULL); stBufConf.u64TargetPts = stTv.tv_sec * 1000000 + stTv.tv_usec; stBufConf.stFrameCfg.eFormat = E_MI_SYS_PIXEL_FRAME_YUV422_YUYV; stBufConf.stFrameCfg.eFrameScanMode = E_MI_SYS_FRAME_SCAN_MODE_PROGRESSIVE; stBufConf.stFrameCfg.u16Width = u16Width; stBufConf.stFrameCfg.u16Height = u16Height; if (MI_SUCCESS == MI_SYS_ChnInputPortGetBufPa(&stVpeChnInput, &stBufConf, &stBufInfo, &hHandle, 0)) { pVirAddr = MI_SYS_Mmap(stBufInfo.stFrameData.phyAddr[0], stBufInfo.stFrameData.u32BufSize, &pVirAddr, TRUE); assert(pVirAddr); if (fread(pVirAddr, u16Width * u16Height * 2, 1, fp) <= 0) { fseek(fp, 0, SEEK_SET); } MI_SYS_Munmap(pVirAddr, stBufInfo.stFrameData.u32BufSize); MI_SYS_ChnInputPortPutBufPa(hHandle, &stBufInfo, FALSE); } }
-
相关主题
2.4.10. MI_SYS_ChnInputPortPutBufPa¶
-
功能
把通道input端口对应的buf object加到待处理队列,与MI_SYS_ChnInputPortGetBufPa成对使用。
-
语法
MI_S32 MI_SYS_ChnInputPortPutBufPa (MI_SYS_BUF_HANDLE hHandle ,MI_SYS_BufInfo_t *pstPortBuf, MI_BOOL bDropBuf);
- 形参
|参数名称 |描述|输入/输出| |hHandle |当前buf的 Handle 输入| |pstPortBuf| 待提交的buf 指针| 输入| |bDropBuf |直接放弃对buf的修改不提交 |输入|
-
返回值
-
0 成功。
-
非0 失败,参照错误码。
-
-
依赖
-
头文件:mi_sys_datatype.h、mi_sys.h
-
库文件:libmi_sys.a / libmi_sys.so
-
-
注意
与MI_SYS_ChnInputPortPutBuf区别:MI_SYS_ChnInputPortPutBufPa提交的pstBufInfo中只能使用物理地址phyAddr,而MI_SYS_ChnInputPortPutBuf提交的pstBufInfo中物理地址phyAddr和虚拟地址pVirAddr都可以使用
-
举例
参见 MI_SYS_ChnInputPortGetBufPa调用Sample 举例。
-
相关主题
2.4.11. MI_SYS_ChnOutputPortGetBufPa¶
-
功能
获取通道output端口输出buf对应的buf object,仅提供MIU物理地址。
-
语法
MI_S32 MI_SYS_ChnOutputPortGetBufPa (MI_SYS_ChnPort_t *pstChnPort, MI_SYS_BufInfo_t *pstBufInfo, MI_SYS_BUF_HANDLE *phHandle);
-
形参
|参数名称 | 描述 |输入/输出| |pstChnPort |指向模块通道之output端口的指针 |输入| |pstBufInfo| 返回之buf 指针| 输出| |phHandle| 获取的outputPort Buf的handle| 输出|
-
返回值
-
0 成功。
-
非0 失败,参照错误码。
-
-
依赖
-
头文件:mi_sys_datatype.h、mi_sys.h
-
库文件:libmi_sys.a / libmi_sys.so
-
-
注意
与MI_SYS_ChnOutputPortGetBuf区别:MI_SYS_ChnOutputPortGetBufPa获取的pstBufInfo中只能使用物理地址phyAddr,而MI_SYS_ChnOutputPortGetBuf获取的pstBufInfo中物理地址phyAddr和虚拟地址pVirAddr都可以使用。
-
举例
MI_SYS_ChnPort_t stChnPort; MI_SYS_BufInfo_t stBufInfo; MI_SYS_BUF_HANDLE stBufHandle; MI_S32 s32Ret = MI_SUCCESS; MI_S32 s32Fd = 0; fd_set read_fds; struct timeval TimeoutVal; char szFileName[128]; int fd = 0; MI_U32 u32GetFramesCount = 0; MI_BOOL _bWriteFile = TRUE; void *pVirAddr = NULL; stChnPort.eModId = E_MI_MODULE_ID_DIVP; stChnPort.u32DevId = 0; stChnPort.u32ChnId = DIVP_CHN_FOR_VDF; stChnPort.u32PortId = 0; s32Ret = MI_SYS_GetFd(&stChnPort, &s32Fd); if (MI_SUCCESS != s32Ret) { ST_ERR("MI_SYS_GetFd 0, error, %X\n", s32Ret); return NULL; } s32Ret = MI_SYS_SetChnOutputPortDepth(&stChnPort, 2, 3); if (MI_SUCCESS != s32Ret) { ST_ERR("MI_SYS_SetChnOutputPortDepth err:%x, chn:%d,port:%d\n", s32Ret, stChnPort.u32ChnId, stChnPort.u32PortId); return NULL; } sprintf(szFileName, "divp%d.es", stChnPort.u32ChnId); printf("start to record %s\n", szFileName); fd = open(szFileName, O_RDWR | O_CREAT | O_TRUNC, S_IRUSR | S_IWUSR | S_IRGRP | S_IROTH); if (fd < 0) { ST_ERR("create %s fail\n", szFileName); } while (1) { FD_ZERO(&read_fds); FD_SET(s32Fd, &read_fds); TimeoutVal.tv_sec = 1; TimeoutVal.tv_usec = 0; s32Ret = select(s32Fd + 1, &read_fds, NULL, NULL, &TimeoutVal); if (s32Ret < 0) { ST_ERR("select failed!\n"); // usleep(10 * 1000); continue; } else if (s32Ret == 0) { ST_ERR("get divp frame time out\n"); //usleep(10 * 1000); continue; } else { if (FD_ISSET(s32Fd, &read_fds)) { s32Ret = MI_SYS_ChnOutputPortGetBufPa(&stChnPort, &stBufInfo, &stBufHandle); if (MI_SUCCESS != s32Ret) { //ST_ERR("MI_SYS_ChnOutputPortGetBufPa err, %x\n", s32Ret); continue; } s32Ret = MI_SYS_Mmap(stBufInfo.stFrameData.phyAddr[0], stBufInfo.stFrameData.u32BufSize, &pVirAddr, TRUE); assert(pVirAddr); // save one Frame YUV data if (fd > 0) { if (_bWriteFile) { write(fd, pVirAddr, stBufInfo.stFrameData.u16Height * stBufInfo.stFrameData.u32Stride[0] + stBufInfo.stFrameData.u16Height * stBufInfo.stFrameData.u32Stride[1] / 2); } } ++u32GetFramesCount; printf("channelId[%u] u32GetFramesCount[%u]\n", stChnPort.u32ChnId, u32GetFramesCount); MI_SYS_Munmap(pVirAddr, stBufInfo.stFrameData.u32BufSize); MI_SYS_ChnOutputPortPutBufPa(stBufHandle); } } } if (fd > 0) { close(fd); fd = -1; } MI_SYS_SetChnOutputPortDepth(&stChnPort, 0, 3); printf("exit record\n"); return NULL; MI_SYS_ChnOutputPortGetBufPa调用Sample
-
相关主题
2.4.12. MI_SYS_ChnOutputPortPutBufPa¶
-
功能
释放通道output端口输出buf对应的buf object,与MI_SYS_ChnOutputPortGetBufPa成对使用。
-
语法
MI_S32 MI_SYS_ChnOutputPortPutBufPa (MI_SYS_BUF_HANDLE hBufHandle);
-
形参
参数名称 描述 输入/输出 hBufHandle 待提交的buf 的handle 输入 -
返回值
-
0 成功。
-
非0 失败,参照错误码。
-
-
依赖
-
头文件:mi_sys_datatype.h、mi_sys.h
-
库文件:libmi_sys.a / libmi_sys.so
-
-
注意
与MI_SYS_ChnOutputPortPutBuf区别:MI_SYS_ChnOutputPortPutBufPa提交的handle对应的pstBufInfo中只能使用物理地址phyAddr,而MI_SYS_ChnOutputPortPutBuf提交的handle对应的pstBufInfo中物理地址phyAddr和虚拟地址pVirAddr都可以使用。
-
举例
参见 MI_SYS_ChnOutputPortGetBufPa调用Sample 举例。
-
相关主题
2.4.13. MI_SYS_SetChnOutputPortDepth¶
-
功能
设置通道output端口对应的系统buf 数量和用户可以拿到的buf数量。
-
语法
MI_S32 MI_SYS_SetChnOutputPortDepth(MI_SYS_ChnPort_t *pstChnPort, MI_U32 u32UserFrameDepth, MI_U32 u32BufQueueDepth);
-
形参
参数名称 描述 输入/输出 pstChnPort 指向模块通道之output端口的指针 输入 u32UserFrameDepth 设置该output用户可以拿到的buf最大数量 输入 u32BufQueueDepth 设置该output系统buf最大数量 输入 -
返回值
-
0 成功。
-
非0 失败,参照错误码。
-
-
依赖
-
头文件:mi_sys_datatype.h、mi_sys.h
-
库文件:libmi_sys.a / libmi_sys.so
-
-
注意
-
在使用完OutputPortBuf(MI_SYS_ChnOutputPortGetBuf / MI_SYS_ChnOutputPortPutBuf 不再需要被调用)之后,建议把u32UserFrameDepth设置为0,可以减少output buf的缓存个数,节省内存。
-
u32UserFrameDepth 必须小于或者等于u32BufQueueDepth。
-
当u32UserFrameDepth等于u32BufQueueDepth,并且user fifo queue缓存的个数等于u32BufQueueDepth时,当前output port将会停止工作。
-
如果output port 没有绑定后级,想让当前output port工作,必须设置u32UserFrameDepth 大于0。
-
如果output port 通过realtime mode或者ring mode方式绑定,当前output port的u32UserFrameDepth必须设置为0。
-
其他使用限制可参考vif/isp/scl/venc/jpd API介绍。
-
-
举例
2.4.14. MI_SYS_ChnPortInjectBuf¶
-
功能
把获取的outputPort buf插到指定的inputPort Buf Queue中
-
语法
MI_S32 MI_SYS_ChnPortInjectBuf(MI_SYS_BUF_HANDLE hHandle ,MI_SYS_ChnPort_t *pstChnInputPort);
-
形参
参数名称 描述 输入/输出 pstChnPort 指向模块通道之input端口的指针 输入 hHandle 获取的outputPort Buf的handle 输出 -
返回值
-
0 成功。
-
非0 失败,参照错误码。
-
-
依赖
-
头文件:mi_sys_datatype.h、mi_sys.h
-
库文件:libmi_sys.a / libmi_sys.so
-
-
注意
调用MI_SYS_ChnPortInjectBuf 后,user不能再显示release handle。
-
举例
-
相关主题
2.4.15. MI_SYS_GetFd¶
-
功能
获取当前output Port等待事件的文件描述符
-
语法
MI_S32 MI_SYS_GetFd(MI_SYS_ChnPort_t *pstChnPort , MI_S32 *ps32Fd);
-
形参
参数名称 描述 输入/输出 pstChnPort 端口信息结构体指针 输入 ps32Fd 等待事件的文件描述符 输出 -
返回值
-
0 成功。
-
非0 失败,参照错误码。
-
-
依赖
-
头文件:mi_sys_datatype.h、mi_sys.h
-
库文件:libmi_sys.a / libmi_sys.so
-
-
注意
-
需要与MI_SYS_CloseFd 成对使用。
-
推荐使用使用fd + select 的方式取数据,这样MI_SYS只有在fd对应的port口有数据的时候才会唤醒线程,效率比采用while+sleep循环取数据的效率要高。
-
-
举例
-
相关主题
2.4.16. MI_SYS_CloseFd¶
-
功能
关闭当前通道的文件描述符
-
语法
MI_S32 MI_SYS_CloseFd(MI_S32 s32ChnPortFd);
-
形参
参数名称 描述 输入/输出 s32ChnPortFd 等待事件的文件描述符 输入 -
返回值
-
0 成功。
-
非0 失败,参照错误码。
-
-
依赖
-
头文件:mi_sys_datatype.h、mi_sys.h
-
库文件:libmi_sys.a / libmi_sys.so
-
-
注意
需要与MI_SYS_GetFd 成对使用。
-
举例
-
相关主题
2.4.17. MI_SYS_DupBuf¶
-
功能
复制一个buf object。
-
语法
MI_S32 MI_SYS_DupBuf(MI_SYS_BUF_HANDLE srcBufHandle , MI_SYS_BUF_HANDLE *pDupTargetBufHandle);
-
形参
参数名称 描述 输入/输出 srcBufHandle 源buf object 输入 pDupTargetBufHandle 返回复制的buf object 指针 输出 -
返回值
-
0 成功。
-
非0 失败,参照错误码。
-
-
依赖
-
头文件:mi_sys_datatype.h、mi_sys.h
-
库文件:libmi_sys.a / libmi_sys.so
-
-
举例
MI_SYS_DupBuf调用Sample
int test0() { MI_SYS_ChnPort_t stChnPort; MI_SYS_BufInfo_t stBufInfo; MI_SYS_BUF_HANDLE bufHandle ,DupTargetBufHandle; MI_S32 s32Ret; stChnPort.eModId = E_MI_MODULE_ID_VPE; stChnPort.u32DevId = 0; stChnPort.u32ChnId = 0; stChnPort.u32PortId = 0; s32Ret = MI_SYS_ChnOutputPortGetBuf (&stChnPort,&stBufInfo,&bufHandle); if(s32Ret != MI_SUCCESS) return 0; s32Ret = MI_SYS_DupBuf(bufHandle, &DupTargetBufHandle); if(s32Ret != MI_SUCCESS) { MI_SYS_ChnOutputPortPutBuf(bufHandle); return 0; } stChnPort.eModId = E_MI_MODULE_ID_DIVP; stChnPort.u32DevId = 0; stChnPort.u32ChnId = 0; stChnPort.u32PortId = 0; MI_SYS_ChnPortInjectBuf(DupTargetBufHandle , &stChnPort); *************************** 可以继续操作stBufInfo *************************** MI_SYS_ChnOutputPortPutBuf(bufHandle); return 1; } int test1() { MI_SYS_ChnPort_t stChnPort; MI_SYS_BufInfo_t stBufInfo; MI_SYS_BufConf_t stBufConf; MI_SYS_BUF_HANDLE bufHandle ,DupTargetBufHandle; MI_S32 s32Ret; stChnPort.eModId = E_MI_MODULE_ID_DIVP; stChnPort.u32DevId = 0; stChnPort.u32ChnId = 0; stChnPort.u32PortId = 0; memset(&stBufConf , 0 , sizeof(stBufConf)); stBufConf.eBufType = E_MI_SYS_BUFDATA_FRAME; stBufConf.stFrameCfg.eFormat = E_MI_SYS_PIXEL_FRAME_YUV_SEMIPLANAR_422; stBufConf.stFrameCfg.u16Height = 1080; stBufConf.stFrameCfg.u16Width = 1920; stBufConf.stFrameCfg.eFrameScanMode = E_MI_SYS_FRAME_SCAN_MODE_PROGRESSIVE; s32Ret = MI_SYS_ChnInputPortGetBuf (&stChnPort,&stBufConf,&stBufInfo,&bufHandle ,0); if(s32Ret != MI_SUCCESS) return 0; *************************** 填充stBufInfo *************************** s32Ret = MI_SYS_DupBuf(bufHandle, &DupTargetBufHandle); if(s32Ret != MI_SUCCESS) { MI_SYS_ChnInputPortPutBuf(bufHandle); return 0; } MI_SYS_ChnInputPortPutBuf(DupTargetBufHandle , &stChnPort , FALSE); *************************** 可以继续操作stBufInfo *************************** MI_SYS_ChnInputPortPutBuf(bufHandle, & stChnPort, FALSE); return 1; }
-
相关主题
2.5. 内存管理类 API¶
2.5.1. MI_SYS_SetChnMMAConf¶
-
功能
设置模块设备通道输出默认分配内存的MMA池名称。
-
语法
MI_S32 MI_SYS_SetChnMMAConf (MI_ModuleId_e eModId, MI_U32 u32DevId, MI_U32 u32ChnId, MI_U8 *pu8MMAHeapName);
-
形参
参数名称 描述 输入/输出 eModId 待配置的模块ID 输入 u32DevId 待配置的设备ID 输入 u32ChnId 待配置的通道号 输入 pu8MMAHeapName 设置MMA heap name 输入 -
返回值
-
0 成功。
-
非0 失败,参照错误码。
-
-
依赖
-
头文件:mi_sys_datatype.h、mi_sys.h
-
库文件:libmi_sys.a / libmi_sys.so
-
-
注意
若不调用MI_SYS_SetChnMMAConf接口设置或者设置pu8MMAHeapName值为NULL时,则使用默认的MMA池名称mma_heap_name0。
-
举例
MI_ModuleId_e eVifModeId = E_MI_MODULE_ID_VIF; MI_VIF_DEV vifDev = 0; MI_VIF_CHN vifChn = 0; MI_SYS_SetChnMMAConf(eVifModeId, vifDev, vifChn, "mma_heap_name0");
2.5.2. MI_SYS_GetChnMMAConf¶
-
功能
获取模块设备通道输出端口默认分配内存的MMA池名称。
-
语法
MI_S32 MI_SYS_GetChnMMAConf (MI_ModuleId_e eModId, MI_U32 u32DevId, MI_U32 u32ChnId, void * pu8MMAHeapName, MI_U32 u32Length);
-
形参
参数名称 描述 输入/输出 eModId 待配置的模块ID 输入 u32DevId 待配置的设备ID 输入 u32ChnId 待配置的通道号 输入 pu8MMAHeapName 要获取的MMA heap name 输入 u32Length pu8MMAHeapName 指向内存的长度,最大为64Byte 输入 -
返回值
-
0 成功。
-
非0 失败,参照错误码。
-
-
依赖
-
头文件:mi_sys_datatype.h、mi_sys.h
-
库文件:libmi_sys.a / libmi_sys.so
-
-
相关主题
2.5.3. MI_SYS_ConfDevPubPools¶
-
功能
配置并初始化模块公共缓冲池。
-
语法
MI_S32 MI_SYS_ConfDevPubPools(MI_ModuleId_e eModule, MI_U32 u32DevId, MI_VB_PoolListConf_t stPoolListConf);
-
形参
参数名称 描述 输入/输出 eModule 目标模块ID 输入 u32DevId Dev ID 输入 stPoolListConf 模块公共缓冲池队列配置 输入 -
返回值
-
0 成功。
-
非0 失败,参照错误码。
-
-
依赖
-
头文件:mi_sys_datatype.h、mi_sys.h
-
库文件:libmi_sys.a / libmi_sys.so
-
-
注意
Version 2.0及以上版本默认不开启,推荐使用MI_SYS_ConfigPrivateMMAPool。
2.5.4. MI_SYS_ReleaseDevPubPools¶
-
功能
释放全局的公共缓冲池。
-
语法
MI_S32 MI_SYS_ReleaseDevPubPools(MI_ModuleId_e eModule, MI_U32 u32DevId);
-
形参
参数名称 描述 输入/输出 eModule 目标模块ID 输入 u32DevId Dev ID 输入 -
返回值
-
0 成功。
-
非0 失败,参照错误码。
-
-
依赖
-
头文件:mi_sys_datatype.h、mi_sys.h
-
库文件:libmi_sys.a / libmi_sys.so
-
-
举例
Version 2.0及以上版本默认不开启,推荐使用MI_SYS_ConfigPrivateMMAPool。
2.5.5. MI_SYS_ConfGloPubPools¶
-
功能
配置并初始化系统全局公共缓冲池。
-
语法
MI_S32 MI_SYS_ConfGloPubPools(MI_VB_PoolListConf_t stPoolListConf);
-
形参
参数名称 描述 输入/输出 stPoolListConf 模块公共缓冲池队列配置 输入 -
返回值
-
0 成功。
-
非0 失败,参照错误码。
-
-
依赖
-
头文件:mi_sys_datatype.h、mi_sys.h
-
库文件:libmi_sys.a / libmi_sys.so
-
-
注意
Version2.0及以上版本默认不开启,推荐使用MI_SYS_ConfigPrivateMMAPool。
2.5.6. MI_SYS_ReleaseGloPubPools¶
-
功能
释放全局的公共缓冲池。
-
语法
MI_S32 MI_VB_ ReleaseGloPubPools (void);
-
返回值
-
0 成功。
-
非0 失败,参照错误码。
-
-
依赖
-
头文件:mi_sys_datatype.h、mi_sys.h
-
库文件:libmi_sys.a / libmi_sys.so
-
-
举例
Version 2.0及以上版本默认不开启,推荐使用MI_SYS_ConfigPrivateMMAPool。
2.5.7. MI_SYS_MMA_Alloc¶
-
功能
直接向MMA内存管理器申请分配内存。
-
语法
MI_S32 MI_SYS_MMA_Alloc(MI_U8 *pstMMAHeapName, MI_U32 u32BlkSize ,MI_PHY *phyAddr);
-
形参
参数名称 描述 输入/输出 pstMMAHeapName 目标MMA heapname 输入 u32BlkSize 待分配的块字节大小 输入 phyAddr 返回的内存块物理地址 输出 -
返回值
-
0 成功。
-
非0 失败,参照错误码。
-
-
依赖
-
头文件:mi_sys_datatype.h、mi_sys.h
-
库文件:libmi_sys.a / libmi_sys.so
-
-
注意
返回的内存块物理地址与实际分配的内存长度都是4K对齐。
-
举例
MI_SYS_MMA_Alloc调用Sample
MI_PHY phySrcBufAddr = 0; void *pVirSrcBufAddr = NULL; MI_U32 srcBuffSize = 1920 * 1980 * 3 / 2; srcBuffSize = ALIGN_UP(srcBuffSize, 4096); ret = MI_SYS_MMA_Alloc(NULL, srcBuffSize, &phySrcBufAddr); if(ret != MI_SUCCESS) { printf("alloc src buff failed\n"); return -1; } ret = MI_SYS_Mmap(phySrcBufAddr, srcBuffSize, &pVirSrcBufAddr, TRUE); if(ret != MI_SUCCESS) { MI_SYS_MMA_Free(phySrcBufAddr); printf("mmap src buff failed\n"); return -1; } memset(pVirSrcBufAddr, 0, srcBuffSize); MI_SYS_FlushInvCache(pVirSrcBufAddr,srcBuffSize); MI_SYS_Munmap(pVirSrcBufAddr, srcBuffSize); MI_SYS_MMA_Free(phySrcBufAddr);
-
相关主题
2.5.8. MI_SYS_MMA_Free¶
-
功能
直接向MMA内存管理器释放之前分配的内存。
-
语法
MI_S32 MI_SYS_MMA_Free(MI_U64 phyAddr);
-
形参
参数名称 描述 输入/输出 phyAddr 待释放之内存的物理地址 输入 -
返回值
-
0 成功。
-
非0 失败,参照错误码。
-
-
依赖
-
头文件:mi_sys_datatype.h、mi_sys.h
-
库文件:libmi_sys.a / libmi_sys.so
-
-
举例
-
相关主题
2.5.9. MI_SYS_Mmap¶
-
功能
映射任意物理内存到当前用户态进程的 CPU虚拟地址空间。
-
语法
MI_S32 MI_SYS_Mmap(MI_U64 u64PhyAddr, MI_U32 u32Size , void **ppVirtualAddress ,MI_BOOL bCache);
-
形参
参数名称 描述 输入/输出 u64PhyAddr 待映射的物理地址 输入 u32Size 待映射的物理地址长度 输入 ppVirtualAddress 存储CPU虚拟地址指针的指针 输出 bCache 是否map成cache还是un-cache 输入 -
返回值
-
0 成功。
-
非0 失败,参照错误码。
-
-
依赖
-
头文件:mi_sys_datatype.h、mi_sys.h
-
库文件:libmi_sys.a / libmi_sys.so
-
-
注意
-
物理地址是SStar内存控制器地址。
-
物理地址建议4KByte对齐。
-
物理地址长度建议4KByte对齐。
-
物理内存必须完整的落在MMA管理的内存范围内或者linux kenrel管理的内存之外。
-
-
举例
参见 MI_SYS_MMA_Alloc调用Sample 举例。
-
相关主题
2.5.10. MI_SYS_FlushInvCache¶
-
功能
Flush cache。
-
语法
MI_S32 MI_SYS_FlushCache(MI_VOID *pVirtualAddress, MI_U32 u32Size);
-
形参
参数名称 描述 输入/输出 pVirtualAddress 之前MI_SYS_Mmap 返回的CPU 虚拟地址 输入 u32Size 待flush的cache长度 输入 -
返回值
-
0 成功。
-
非0 失败,参照错误码。
-
-
依赖
-
头文件:mi_sys_datatype.h、mi_sys.h
-
库文件:libmi_sys.a / libmi_sys.so
-
-
注意
-
待flush cache的物理地址建议4KByte对齐。
-
待flush cache的映射长度建议4KByte对齐。
-
待flush cache的映射内存范围必须是之前通过MI_SYS_Mmap API获取到的。
-
待flush cache的映射内存应该是MI_SYS_Mmap时采用cache方式进行的,nocache的方式无需flush cache。
-
-
举例
参见 MI_SYS_MMA_Alloc调用Sample举例。
-
相关主题
2.5.11. MI_SYS_Munmap¶
-
功能
取消物理内存到虚拟地址的映射。
-
语法
MI_S32 MI_SYS_UnMmap(MI_VOID *pVirtualAddress, MI_U32 u32Size);
-
形参
参数名称 描述 输入/输出 pVirtualAddress 之前MI_SYS_Mmap 返回的CPU 虚拟地址 输入 u32Size 待取消映射的映射长度 输入 -
返回值
-
0 成功。
-
非0 失败,参照错误码。
-
-
依赖
-
头文件:mi_sys_datatype.h、mi_sys.h
-
库文件:libmi_sys.a / libmi_sys.so
-
-
注意
-
待取消映射的虚拟地址建议4KByte对齐。
-
待取消映射的映射长度建议4KByte对齐
-
待取消的映射内存范围必须是之前通过MI_SYS_Mmap API获取到的。
-
-
举例
参见MI_SYS_MMA_Alloc调用Sample 举例。
-
相关主题
2.5.12. MI_SYS_MemsetPa¶
-
功能
通过DMA硬件模块,填充整块物理内存.
-
语法
MI_S32 MI_SYS_MemsetPa(MI_PHY phyPa, MI_U32 u32Val, MI_U32 u32Lenth);
-
形参
参数名称 参数含义 输入/输出 phyPa 填充的物理地址 输入 u32Val 填充值 输入 u32Lenth 填充大小,单位为byte 输入 -
返回值
-
0 成功。
-
非0 失败,参照错误码。
-
-
依赖
-
头文件:mi_sys_datatype.h、mi_sys.h
-
库文件:libmi_sys.a / libmi_sys.so
-
-
举例
MI_SYS_MemsetPa调用Sample
MI_PHY phySrcBufAddr = 0; MI_PHY phyDstBufAddr = 0; void *pVirSrcBufAddr = NULL; void *pVirDstBufAddr = NULL; MI_U32 buffSize = 1920 * 1980 * 3 / 2; buffSize = ALIGN_UP(buffSize, 4096); ret = MI_SYS_MMA_Alloc(NULL, buffSize, &phySrcBufAddr); if(ret != MI_SUCCESS) { printf("alloc src buff failed\n"); return -1; } ret = MI_SYS_MMA_Alloc(NULL, buffSize, &phyDstBufAddr); if(ret != MI_SUCCESS) { MI_SYS_MMA_Free(phySrcBufAddr); printf("alloc dts buff failed\n"); return -1; } MI_SYS_MemsetPa(phySrcBufAddr, 0xff, buffSize); MI_SYS_MemsetPa(phyDstBufAddr, 0x00, buffSize); MI_SYS_MemcpyPa(phyDstBufAddr, phySrcBufAddr, buffSize); MI_SYS_MMA_Free(phySrcBufAddr); MI_SYS_MMA_Free(phyDstBufAddr);
-
相关主题
2.5.13. MI_SYS_MemcpyPa¶
-
功能
通过DMA硬件模块,把源内存数据拷贝到目标内存上.
-
语法
MI_S32 MI_SYS_MemcpyPa(MI_PHY phyDst, MI_PHY phySrc, MI_U32 u32Lenth);
-
形参
参数名称 参数含义 输入/输出 phyDst 目的物理地址 输入 phySrc 源物理地址 输入 u32Lenth 拷贝大小,单位为byte 输入 -
返回值
-
0 成功。
-
非0 失败,参照错误码。
-
-
依赖
-
头文件:mi_sys_datatype.h、mi_sys.h
-
库文件:libmi_sys.a / libmi_sys.so
-
-
举例
参见MI_SYS_MemsetPa 举例。
-
相关主题
2.5.14. MI_SYS_BufFillPa¶
-
功能
通过DMA硬件模块,填充部分物理内存。
-
语法
MI_S32 MI_SYS_BufFillPa(MI_SYS_FrameData_t *pstBuf, MI_U32 u32Val,MI_SYS_WindowRect_t *pstRect);
-
形参
参数名称 参数含义 输入/输出 pstBuf 填充的帧数据描述之结构体 输入 u32Val 填充值 输入 pstRect 填充的数据范围 输入 -
返回值
-
0 成功。
-
非0 失败,参照错误码。
-
-
依赖
-
头文件:mi_sys_datatype.h、mi_sys.h
-
库文件:libmi_sys.a / libmi_sys.so
-
-
注意
-
pstRect数据范围是以pstBuf所描述的首地址为(0,0)点开始,宽高都是以pstBuf中的ePixelFormat来计算每一个pixel所移动的内存数据大小来进行部分填充。
-
pstBuf中u16Width、u16Height、phyAddr、u32Stride、ePixelFormat为必填,其余数值无意义。
-
-
举例
MI_S32 ret = 0; MI_SYS_WindowRect_t rect; MI_SYS_FrameData_t stSysFrame; memcpy(&stSysFrame, &buf->stFrameData, sizeof(MI_SYS_FrameData_t)); if(pRect) { rect.u16X = pRect->left; rect.u16Y = pRect->top; rect.u16Height = pRect->bottom-pRect->top; rect.u16Width = pRect->right-pRect->left; } else { rect.u16X = 0; rect.u16Y = 0; rect.u16Height = stSysFrame.u16Height; rect.u16Width = stSysFrame.u16Width; } DBG_INFO("rect %d %d %d %d \n", rect.u16X, rect.u16Y , rect.u16Width, rect.u16Height); ret = MI_SYS_BufBlitPa(&stSysFrame, u32ColorVal, &rect); return ret;
-
相关主题
2.5.15. MI_SYS_BufBlitPa¶
-
功能
通过DMA硬件模块,把源内存数据上的部分区域拷贝到目标内存上的部分区域。
-
语法
MI_S32 MI_SYS_BufBlitPa(MI_SYS_FrameData_t *pstDstBuf, MI_SYS_WindowRect_t *pstDstRect, MI_SYS_FrameData_t *pstSrcBuf, MI_SYS_WindowRect_t *pstSrcRect);
-
形参
参数名称 参数含义 输入/输出 pstDstBuf 目标内存物理首地址 输入 pstDstRect 目标内存拷贝的区域 输入 pstSrcBuf 源内存物理首地址 输入 pstSrcRect 源内存拷贝的区域 输入 -
返回值
-
0 成功。
-
非0 失败,参照错误码。
-
-
依赖
-
头文件:mi_sys_datatype.h、mi_sys.h
-
库文件:libmi_sys.a / libmi_sys.so
-
-
注意
-
pstDstRect/pstSrcRect数据范围是以pstDstBuf/pstSrcBuf所描述的首地址为(0,0)点开始,宽高都是以其中的ePixelFormat来计算每一个pixel所移动的内存数据大小来进行部分填充。
-
pstDstBuf/pstSrcBuf中u16Width、u16Height、phyAddr、u32Stride、ePixelFormat为必填,其余数值无意义。
-
源内存或者目标内存的区域部分超过了其本来的范围,则只会拷贝其未超过部分上的数据。
-
-
举例
MI_S32 ret = MI_SUCCESS; vdisp_copyinfo_plane_t *plane; MI_SYS_FrameData_t stSrcFrame, stDstFrame; MI_SYS_WindowRect_t stSrcRect, stDstRect; plane = ©info->plane[0]; stSrcFrame.ePixelFormat = E_MI_SYS_PIXEL_FRAME_I8; stSrcFrame.phyAddr[0] = plane->src_paddr; stSrcFrame.u16Width = plane->width; stSrcFrame.u16Height = plane->height; stSrcFrame.u32Stride[0] = plane->src_stride; stDstFrame.ePixelFormat = E_MI_SYS_PIXEL_FRAME_I8; stDstFrame.phyAddr[0] = plane->dst_paddr; stDstFrame.u16Width = plane->width; stDstFrame.u16Height = plane->height; stDstFrame.u32Stride[0] = plane->dst_stride; stSrcRect.u16X = 0; stSrcRect.u16Y = 0; stSrcRect.u16Height = stSrcFrame.u16Height; stSrcRect.u16Width = stSrcFrame.u16Width; stDstRect.u16X = 0; stDstRect.u16Y = 0; stDstRect.u16Height = stDstFrame.u16Height; stDstRect.u16Width = stDstFrame.u16Width; ret = MI_SYS_BufBlitPa(&stDstFrame, &stDstRect, &stSrcFrame, &stSrcRect); return ret;
-
相关主题
2.5.16. MI_SYS_ConfigPrivateMMAPool¶
-
功能
为模块配置私有MMA Heap.
-
语法
MI_S32 MI_SYS_ConfigPrivateMMAPool(MI_SYS_GlobalPrivPoolConfig_t *pstGlobalPrivPoolConf);
-
形参
参数名称 参数含义 输入/输出 pstGlobalPrivPoolConf 配置私有Mma Pool结构体指针 输入 -
返回值
-
0 成功。
-
非0 失败,参照错误码。
-
-
依赖
-
头文件:mi_sys_datatype.h、mi_sys.h
-
库文件:libmi_sys.a / libmi_sys.so
-
-
注意
-
设备私有MMA Heap与通道私有MMA Heap不能共存。
-
建议在MI_SYS_Init后就为各模块创建好私有MMA heap。
-
当pstGlobalPrivPoolConf->bCreate 为TRUE时,创建私有POOL,为FALSE时,销毁私有POOL
-
各种eConfigType使用场景如下:
eConfigType 适用场景 E_MI_SYS_VPE_TO_VENC_PRIVATE_RING_POOL 为绑定为E_MI_SYS_BIND_TYPE_HW_RIN模式的vpe与venc端口设置私有ring heap pool E_MI_SYS_PRE_CHN_PRIVATE_POOL 为模块通道设置私有heap pool E_MI_SYS_PRE_DEV_PRIVATE_POOL 为模块设备设置私有heap pool E_MI_SYS_PER_CHN_PORT_OUTPUT_POOL 为模块output port设置heap pool,设置后该port口的ouput buf优先从其中分配 -
-
举例
假设场景为:IPC 下两路流,一路Main Stream H265最大分辨率1920*1080,一路Sub Stream H264最大分辨率720*576。
VENC 创建MMA Heap:
/Main Sream: //为通道1创建大小为38745760的私有MMA heap MI_SYS_GlobalPrivPoolConfig_t stConfig; memset(&stConfig , 0 ,sizeof(stConfig)); stConfig.eConfigType = E_MI_SYS_PER_CHN_PRIVATE_POOL; stConfig.bCreate = TRUE; stConfig.uConfig.stPreChnPrivPoolConfig.eModule = E_MI_MODULE_ID_VENC; stConfig.uConfig.stPreChnPrivPoolConfig.u32Devid = 0; stConfig.uConfig.stPreChnPrivPoolConfig.u32Channel= 1; stConfig.uConfig.stPreChnPrivPoolConfig.u32PrivateHeapSize = 38745760; MI_SYS_ConfigDevChnPrivateMMAHeap(&stConfig); //Sub Stream: //为通道2创建大小为805152的私有MMA Heap stConfig.eConfigType = E_MI_SYS_PER_CHN_PRIVATE_POOL; stConfig.bCreate = TRUE; stConfig.uConfig.stPreChnPrivPoolConfig.eModule = E_MI_MODULE_ID_VENC; stConfig.uConfig.stPreChnPrivPoolConfig.u32Devid = 0; stConfig.uConfig.stPreChnPrivPoolConfig.u32Channel= 2; stConfig.uConfig.stPreChnPrivPoolConfig.u32PrivateHeapSize = 805152; MI_SYS_ConfigDevChnPrivateMMAHeap(&stConfig);
VENC 销毁MMA Heap:
// Main Sream: //销毁通道1的私有MMA heap stConfig.eConfigType = E_MI_SYS_PER_CHN_PRIVATE_POOL; stConfig.bCreate = FALSE; stConfig.uConfig.stPreChnPrivPoolConfig.eModule = E_MI_MODULE_ID_VENC; stConfig.uConfig.stPreChnPrivPoolConfig.u32Devid = 0; stConfig.uConfig.stPreChnPrivPoolConfig.u32Channel= 1; MI_SYS_ConfigDevChnPrivateMMAHeap(&stConfig); //Sub Stream: //销毁通道2的私有MMA Heap stConfig.eConfigType = E_MI_SYS_PER_CHN_PRIVATE_POOL; stConfig.bCreate = FALSE; stConfig.uConfig.stPreChnPrivPoolConfig.eModule = E_MI_MODULE_ID_VENC; stConfig.uConfig.stPreChnPrivPoolConfig.u32Devid = 0; stConfig.uConfig.stPreChnPrivPoolConfig.u32Channel= 2; MI_SYS_ConfigDevChnPrivateMMAHeap(&stConfig);
VPE 创建MMA Heap:
//为设备0创建大小为0x4f9200的私有MMA Heap stConfig.eConfigType = E_MI_SYS_PER_DEV_PRIVATE_POOL; stConfig.bCreate = TRUE; stConfig.uConfig.stPreDevPrivPoolConfig.eModule = E_MI_MODULE_ID_VPE; stConfig.uConfig.stPreDevPrivPoolConfig.u32Devid = 0; MI_SYS_ConfigDevChnPrivateMMAHeap(&stConfig);
VPE 销毁MMA Heap:
//销毁设备0的私有MMA Heap stConfig.eConfigType = E_MI_SYS_PER_DEV_PRIVATE_POOL; stConfig.bCreate = FALSE; stConfig.uConfig.stPreDevPrivPoolConfig.eModule = E_MI_MODULE_ID_VPE; stConfig.uConfig.stPreChnPrivPoolConfig.u32Devid = 0; MI_SYS_ConfigDevChnPrivateMMAHeap(&stConfig);
创建VPE与VENC之间的ring MMA Heap:
stConfig.eConfigType = E_MI_SYS_VPE_TO_VENC_PRIVATE_RING_POOL; stConfig.bCreate = TRUE; stConfig.uConfig. stPreVpe2VencRingPrivPoolConfig.u32VencInputRingPoolStaticSize = 8*1024*1024; MI_SYS_ConfigDevChnPrivateMMAHeap(&stConfig);
销毁VPE与VENC之间的ring MMA Heap:
stConfig.eConfigType = E_MI_SYS_VPE_TO_VENC_PRIVATE_RING_POOL; stConfig.bCreate = FALSE; MI_SYS_ConfigDevChnPrivateMMAHeap(&stConfig);
不同分辨率或开启不同功能size大小都不一样,详细参数请根据使用的场景和规格计算。
2.5.17. MI_SYS_PrivateDevChnHeapAlloc¶
-
功能
从模块设备或通道私有MMA Pool 申请内存.
-
语法
MI_S32 MI_SYS_PrivateDevChnHeapAlloc(MI_ModuleId_e eModule, MI_U32 u32Devid,MI_S32 s32ChnId, MI_U8 *pu8BufName, MI_U32 u32blkSize, MI_PHY *pphyAddr,MI_BOOL bTailAlloc);
-
形参
参数名称 参数含义 输入/输出 eModule 模块ID 输入 u32Devid 模块的设备ID 输入 s32ChnId 模块的通道ID 输入 pu8BufName 申请私有内存的名字,传Null时,使用 "app-privAlloc"作为默认的名字 输入 u32blkSize 申请私有内存的大小 输入 pphyAddr 分配出的私有内存的物理地址 输出 bTailAlloc 是否从通道私有pool的尾部申请 0-否,1-是 输入 -
返回值
-
0 成功。
-
非0 失败,参照错误码。
-
-
依赖
-
头文件:mi_sys_datatype.h、mi_sys.h
-
库文件:libmi_sys.a / libmi_sys.so
-
-
注意
当s32ChnId 等于 -1时,从模块设备私有MMA Pool 申请内存;
当s32ChnId 大于 -1时,从模块通道私有MMA Pool申请内存;
使用该接口时,如果没有配置相应私有池或者私有池中内存不足申请失败,会默认从mma_heap_name0中申请内存。
-
举例
MI_SYS_PrivateDevChnHeapAlloc调用Sample
MI_PHY *pphyAddr = NULL; MI_SYS_GlobalPrivPoolConfig_t stConfig; Memset(&stConfig , 0 ,sizeof(stConfig)); stConfig.eConfigType = E_MI_SYS_PER_CHN_PRIVATE_POOL; stConfig.bCreate = TRUE; stConfig.uConfig.stPreChnPrivPoolConfig. eModule = E_MI_MODULE_ID_VENC; stConfig.uConfig.stPreChnPrivPoolConfig. u32Devid = 0; stConfig.uConfig.stPreChnPrivPoolConfig. u32Channel= 1; stConfig.uConfig.stPreChnPrivPoolConfig. u32PrivateHeapSize = 38745760; MI_SYS_ConfigDevChnPrivateMMAHeap(&stConfig); ret = MI_SYS_PrivateDevChnHeapAlloc(E_MI_MODULE_ID_VENC, 0, 1, NULL, 4096, pphyAddr, FALSE); if(ret != MI_SUCCESS) { stConfig.bCreate = FALSE; MI_SYS_ConfigDevChnPrivateMMAHeap(&stConfig); printf("alloc buff from chn private heap failed\n"); return -1; } //do something... MI_SYS_PrivateDevChnHeapFree(E_MI_MODULE_ID_VENC, 0, 1, *pphyAddr); stConfig.bCreate = FALSE; MI_SYS_ConfigDevChnPrivateMMAHeap(&stConfig);
-
相关主题
2.5.18. MI_SYS_PrivateDevChnHeapFree¶
-
功能
从模块设备或通道私有MMA Pool 释放内存.
-
语法
MI_S32 MI_SYS_PrivateDevChnHeapFree(MI_ModuleId_e eModule, MI_U32 u32Devid,MI_S32 s32ChnId, MI_PHY phyAddr);
-
形参
参数名称 参数含义 输入/输出 eModule 模块ID 输入 u32Devid 模块的设备ID 输入 s32ChnId 模块的通道ID 输入 phyAddr 需要释放的内存对应的物理地址 输入 -
返回值
-
0 成功。
-
非0 失败,参照错误码。
-
-
依赖
-
头文件:mi_sys_datatype.h、mi_sys.h
-
库文件:libmi_sys.a / libmi_sys.so
-
-
注意
当s32ChnId 等于-1时,从模块设备私有MMA Pool释放内存;
当s32ChnId 大于-1时,从模块通道私有MMA Pool释放内存;
如果释放的物理地址不在私有池内存范围内或者没有配置对应的私有池,会去检查该地址是否从mma_heap_name0中分配出去的地址并释放。
-
举例
-
相关主题
2.5.19. MI_SYS_Va2Pa¶
-
功能
将MI内存块的CPU虚拟地址转成内存物理地址.
-
语法
MI_S32 MI_SYS_Va2Pa (void *pVirtualAddress, MI_PHY *pPhyAddr);
-
形参
参数名称 参数含义 输入/输出 pVirtualAddress CPU虚拟地址指针 输入 pPhyAddr 存储内存块物理地址的指针 输出 -
返回值
-
0 成功。
-
非0 失败,参照错误码。
-
-
依赖
-
头文件:mi_sys_datatype.h、mi_sys.h
-
库文件:libmi_sys.a / libmi_sys.so
-
-
注意
使用该接口时,请确定输入的CPU虚拟地址有效且指向MI中分配的地址空间。
-
举例
MI_SYS_Va2Pa调用Sample
MI_PHY phySrcBufAddr = 0; MI_PHY phyAddrVa2Pa = 0; void *pVirSrcBufAddr = NULL; MI_U32 srcBuffSize = 1920 * 1980 * 3 / 2; srcBuffSize = ALIGN_UP(srcBuffSize, 4096); ret = MI_SYS_MMA_Alloc(NULL, srcBuffSize, &phySrcBufAddr); if(ret != MI_SUCCESS) { printf("alloc src buff failed\n"); return -1; } ret = MI_SYS_Mmap(phySrcBufAddr, srcBuffSize, &pVirSrcBufAddr, TRUE); if(ret != MI_SUCCESS) { MI_SYS_MMA_Free(phySrcBufAddr); printf("mmap src buff failed\n"); return -1; } MI_SYS_Va2Pa(pVirSrcBufAddr, &phyAddrVa2Pa); assert(phySrcBufAddr == phyAddrVa2Pa); memset(pVirSrcBufAddr, 0, srcBuffSize); MI_SYS_FlushInvCache(pVirSrcBufAddr,srcBuffSize); MI_SYS_Munmap(pVirSrcBufAddr, srcBuffSize); MI_SYS_MMA_Free(phySrcBufAddr);
-
相关主题
2.5.20. MI_SYS_GetMmaPoolInfo¶
-
功能
获取指定mma 池的总空闲大小和物理上连续的最大的内存长度。
-
语法
MI_S32 MI_SYS_GetMmaPoolInfo (MI_SYS_MmaPoolInfo_t *pstMmaPoolInfo);
-
形参
参数名称 参数含义 输入/输出 bPrivatePool pstMmaPoolInfo成员,是否获取私有池内存信息
TRUE:配置uConfig. stChnPort
FALSE:配置u8MMAHeapName输入 uConfig pstMmaPoolInfo成员
uConfig.stChnPort:配置需要查询的私有池信息
uConfig.u8MMAHeapName:要查询的mma heap name输入 u32TotalFreeSize pstMmaPoolInfo成员,内存池总空闲大小 输出 u32MaxContiFreeSize pstMmaPoolInfo成员,内存池物理连续的最大的内存长度 输出 -
返回值
-
0 成功。
-
非0 失败,参照错误码。
-
-
依赖
-
头文件:mi_sys_datatype.h、mi_sys.h
-
库文件:libmi_sys.a / libmi_sys.so
-
-
注意
-
由于内存状态动态变化,该接口获取的瞬时值只代表这一时刻的内存状态。
-
bPrivatePool = TRUE时,配置stChnPort:
stChnPort.u32ChnId == -1 时,获取模块设备的私有池信息,对应E_MI_SYS_PRE_DEV_PRIVATE_POOL类型的私有池;
stChnPort.u32ChnId !=-1 && stChnPort.u32PortId == -1 时,获取设备通道的私有池信息,对应E_MI_SYS_PRE_CHN_PRIVATE_POOL类型的私有池;
stChnPort.u32ChnId !=-1 && stChnPort. u32PortId != -1 时,获取模块通道output port的私有池信息,对应E_MI_SYS_PRE_CHN_PORT_OUTPUT_POOL类型的私有池。
-
-
举例
MI_SYS_GetMmaPoolInfo调用Sample
//获取模块设备的私有池内存信息 MI_SYS_MmaPoolInfo stMmaPoolInfo; memset(&stMmaPoolInfo, 0, sizeof(stMmaPoolInfo)); stMmaPoolInfo.bPrivatePool = TRUE; stMmaPoolInfo.uConfig.stChnPort.eModId = E_MI_MODULE_ID_VENC; stMmaPoolInfo.uConfig.stChnPort.u32DevId=0; stMmaPoolInfo.uConfig.stChnPort.u32ChnId=-1; stMmaPoolInfo.uConfig.stChnPort.u32PortId=-1; MI_SYS_GetMmaPoolInfo(&stMmaPoolInfo); //获取模块设备通道的私有池内存信息 MI_SYS_MmaPoolInfo stMmaPoolInfo; memset(&stMmaPoolInfo, 0, sizeof(stMmaPoolInfo)); stMmaPoolInfo.bPrivatePool = TRUE; stMmaPoolInfo.uConfig.stChnPort.eModId = E_MI_MODULE_ID_VENC; stMmaPoolInfo.uConfig.stChnPort.u32DevId=0; stMmaPoolInfo.uConfig.stChnPort.u32ChndId=0; stMmaPoolInfo.uConfig.stChnPort.u32PortId=-1; MI_SYS_GetMmaPoolInfo(&stMmaPoolInfo); //获取设备通道output port的私有池内存信息 MI_SYS_MmaPoolInfo stMmaPoolInfo; memset(&stMmaPoolInfo, 0, sizeof(stMmaPoolInfo)); stMmaPoolInfo.bPrivatePool = TRUE; stMmaPoolInfo.uConfig.stChnPort.eModId = E_MI_MODULE_ID_VENC; stMmaPoolInfo.uConfig.stChnPort.u32DevId=0; stMmaPoolInfo.uConfig.stChnPort.u32ChndId=1; stMmaPoolInfo.uConfig.stChnPort.u32PortId=0; MI_SYS_GetMmaPoolInfo(&stMmaPoolInfo); //获取mma heap内存池信息 MI_SYS_MmaPoolInfo stMmaPoolInfo; memset(&stMmaPoolInfo, 0, sizeof(stMmaPoolInfo)); stMmaPoolInfo.bPrivatePool = FALSE; memcpy(stMmaPoolInfo.uConfig. u8MMAHeapName , “mma_heap_name0” ,sizeof(“mma_heap_name”)); MI_SYS_GetMmaPoolInfo(&stMmaPoolInfo);
-
相关主题
3. 数据类型¶
3.1. 数据结构描述格式说明¶
本手册使用 5个参考域描述数据类型的相关信息,它们作用如 个参考域描述数据类型的相关信息,它们作用如 表 3-1所示。
表3-1 数据结构描述格式说明
标签 | 功能 |
---|---|
说明 | 简要描述数据类型的主要功能 |
定义 | 列出数据类型的定义语句 |
成员 | 列出数据结构的成员及含义 |
注意事项 | 列出使用数据类型时应注意的事项 |
相关数据类型及接口 | 列出与本数据类型相关联的其他数据类型和接口 |
3.2. 数据结构列表¶
相关数据类型、数据结构定义如下:
3.2.1. MI_ModuleId_e¶
-
说明
定义模块ID枚举类型。
-
定义
typedef enum { E_MI_MODULE_ID_IVE = 0, E_MI_MODULE_ID_VDF = 1, E_MI_MODULE_ID_VENC = 2, E_MI_MODULE_ID_RGN = 3, E_MI_MODULE_ID_AI = 4, E_MI_MODULE_ID_AO = 5, E_MI_MODULE_ID_VIF = 6, E_MI_MODULE_ID_VPE = 7, E_MI_MODULE_ID_VDEC = 8, E_MI_MODULE_ID_SYS = 9, E_MI_MODULE_ID_FB = 10, E_MI_MODULE_ID_HDMI = 11, E_MI_MODULE_ID_DIVP = 12, E_MI_MODULE_ID_GFX = 13, E_MI_MODULE_ID_VDISP = 14, E_MI_MODULE_ID_DISP = 15, E_MI_MODULE_ID_OS = 16, E_MI_MODULE_ID_IAE = 17, E_MI_MODULE_ID_MD = 18, E_MI_MODULE_ID_OD = 19, E_MI_MODULE_ID_SHADOW = 20, E_MI_MODULE_ID_WARP = 21, E_MI_MODULE_ID_UAC = 22, E_MI_MODULE_ID_LDC = 23, E_MI_MODULE_ID_SD = 24, E_MI_MODULE_ID_PANEL = 25, E_MI_MODULE_ID_CIPHER = 26, E_MI_MODULE_ID_SNR = 27, E_MI_MODULE_ID_WLAN =28, E_MI_MODULE_ID_IPU = 29, E_MI_MODULE_ID_MIPITX = 30, E_MI_MODULE_ID_GYRO = 31, E_MI_MODULE_ID_JPD = 32, E_MI_MODULE_ID_PSPI = 33, E_MI_MODULE_ID_MAX, } MI_ModuleId_e;
-
成员
模块ID 模块ID HEX值 成员名称 模块 0 0x00 E_MI_MODULE_ID_IVE 图像智能算子IVE的模块ID 1 0x01 E_MI_MODULE_ID_VDF 视频智能算法框架模块VDF的模块ID 2 0x02 E_MI_MODULE_ID_VENC 视频编码模块VPE的模块ID 3 0x03 E_MI_MODULE_ID_RGN OSD叠加和遮挡模块REG的模块ID 4 0x04 E_MI_MODULE_ID_AI 音频输入模块AI的模块ID 5 0x05 E_MI_MODULE_ID_AO 音频输出模块AO的模块ID 6 0x06 E_MI_MODULE_ID_VIF 视频输入VIF的模块ID 7 0x07 E_MI_MODULE_ID_VPE 视频图像处理模块VPE的模块ID 8 0x08 E_MI_MODULE_ID_VDEC 视频处理VPE的模块ID 9 0x09 E_MI_MODULE_ID_SYS 系统模块SYS的模块ID 10 0x0A E_MI_MODULE_ID_FB SStar UI显示FrameBuffer Device 模块的模块ID 11 0x0B E_MI_MODULE_ID_HDMI HMDI模块ID 12 0x0C E_MI_MODULE_ID_DIVP 视频DI及后处理模块DIVP的模块ID 13 0x0D E_MI_MODULE_ID_GFX 2D图形处理加速模块GFX的模块ID 14 0x0E E_MI_MODULE_ID_VDISP 图像拼图模块VDISP的模块ID 15 0x0F E_MI_MODULE_ID_DISP 视频显示模块DISP的模块ID 16 0x10 E_MI_MODULE_ID_OS RTOS系统模块ID 17 0x11 E_MI_MODULE_ID_IAE 音频智能算子IAE的模块ID 18 0x12 E_MI_MODULE_ID_MD 移动侦测模块MD的模块ID 19 0x13 E_MI_MODULE_ID_OD 遮挡侦测模块OD的模块ID 20 0x14 E_MI_MODULE_ID_SHADOW 虚拟MI框架SHADOW的模块ID 21 0x15 E_MI_MODULE_ID_WARP 图像畸形校正算法WARP的模块ID 22 0x16 E_MI_MODULE_ID_UAC USB Aduio Class专用ALSA设备的模块ID 23 0x17 E_MI_MODULE_ID_LDC 图像畸形校正算法LDC的模块ID 24 0x18 E_MI_MODULE_ID_SD 图像缩放功能的模块ID 25 0x19 E_MI_MODULE_ID_PANEL 屏显示PANEL的模块ID 26 0x1A E_MI_MODULE_ID_CIPHER 芯片加密CIPHER的模块ID 27 0x1B E_MI_MODULE_ID_SNR Sensor传感器模块ID 28 0x1C E_MI_MODULE_ID_WLAN 无线通信网络WLAN的模块ID 29 0x1D E_MI_MODULE_ID_IPU 图像识别处理IPU的模块ID 30 0x1E E_MI_MODULE_ID_MIPITX 使用MIPI协议发送数据模块ID 31 0x1F E_MI_MODULE_ID_GYRO 陀螺仪的模块ID 32 0x20 E_MI_MODULE_ID_JPD JPD处理的模块ID 33 0x21 E_MI_MODULE_ID_PSPI 使用spi协议发送/接收数据的模块ID
3.2.2. MI_SYS_PixelFormat_e¶
-
说明
定义像素枚举类型。
-
定义
typedef enum { E_MI_SYS_PIXEL_FRAME_YUV422_YUYV = 0, E_MI_SYS_PIXEL_FRAME_ARGB8888, E_MI_SYS_PIXEL_FRAME_ABGR8888, E_MI_SYS_PIXEL_FRAME_BGRA8888, E_MI_SYS_PIXEL_FRAME_RGB565, E_MI_SYS_PIXEL_FRAME_ARGB1555, E_MI_SYS_PIXEL_FRAME_ARGB4444, E_MI_SYS_PIXEL_FRAME_I2, E_MI_SYS_PIXEL_FRAME_I4, E_MI_SYS_PIXEL_FRAME_I8, E_MI_SYS_PIXEL_FRAME_YUV_SEMIPLANAR_422, E_MI_SYS_PIXEL_FRAME_YUV_SEMIPLANAR_420, E_MI_SYS_PIXEL_FRAME_YUV_SEMIPLANAR_420_NV21, E_MI_SYS_PIXEL_FRAME_YUV_TILE_420, E_MI_SYS_PIXEL_FRAME_YUV422_UYVY, E_MI_SYS_PIXEL_FRAME_YUV422_YVYU, E_MI_SYS_PIXEL_FRAME_YUV422_VYUY, E_MI_SYS_PIXEL_FRAME_YUV422_PLANAR, E_MI_SYS_PIXEL_FRAME_YUV420_PLANAR, E_MI_SYS_PIXEL_FRAME_FBC_420, E_MI_SYS_PIXEL_FRAME_RGB_BAYER_BASE, E_MI_SYS_PIXEL_FRAME_RGB_BAYER_NUM = E_MI_SYS_PIXEL_FRAME_RGB_BAYER_BASE + E_MI_SYS_DATA_PRECISION_MAX*E_MI_SYS_PIXEL_BAYERID_MAX-1, E_MI_SYS_PIXEL_FRAME_RGB888, E_MI_SYS_PIXEL_FRAME_BGR888, E_MI_SYS_PIXEL_FRAME_GRAY8, E_MI_SYS_PIXEL_FRAME_FORMAT_MAX, } MI_SYS_PixelFormat_e;
-
成员
成员名称 描述 E_MI_SYS_PIXEL_FRAME_YUV422_YUYV YUV422_YUYV格式 E_MI_SYS_PIXEL_FRAME_ARGB8888 ARGB8888格式 E_MI_SYS_PIXEL_FRAME_ABGR8888 ABGR8888格式 E_MI_SYS_PIXEL_FRAME_BGRA8888 BGRA8888格式 E_MI_SYS_PIXEL_FRAME_RGB565 RGB565格式 E_MI_SYS_PIXEL_FRAME_ARGB1555 ARGB1555格式 E_MI_SYS_PIXEL_FRAME_ARGB4444 ARGB4444格式 E_MI_SYS_PIXEL_FRAME_I2 2 bpp格式 E_MI_SYS_PIXEL_FRAME_I4 4 bpp格式 E_MI_SYS_PIXEL_FRAME_I8 8 bpp格式 E_MI_SYS_PIXEL_FRAME_YUV_SEMIPLANAR_422 YUV422 semi-planar格式 E_MI_SYS_PIXEL_FRAME_YUV_SEMIPLANAR_420 YUV420sp nv12格式 E_MI_SYS_PIXEL_FRAME_YUV_SEMIPLANAR_420_NV21 YUV420sp nv21格式 E_MI_SYS_PIXEL_FRAME_YUV_TILE_420 内部自定义TILE格式 E_MI_SYS_PIXEL_FRAME_YUV422_UYVY YUV422_UYVY格式 E_MI_SYS_PIXEL_FRAME_YUV422_YVYU YUV422_YVYU格式 E_MI_SYS_PIXEL_FRAME_YUV422_VYUY YUV422_VYUY格式 E_MI_SYS_PIXEL_FRAME_YUV422_PLANAR YUV422_PLANAR格式 E_MI_SYS_PIXEL_FRAME_YUV420_PLANAR YUV420_PLANAR格式 E_MI_SYS_PIXEL_FRAME_FBC_420 内部自定义格式 E_MI_SYS_PIXEL_FRAME_RGB_BAYER_BASE RGB raw data 组合格式的起始值 E_MI_SYS_PIXEL_FRAME_RGB_BAYER_NUM RGB raw data 组合格式的最大值 E_MI_SYS_PIXEL_FRAME_RGB888 RGB888格式 E_MI_SYS_PIXEL_FRAME_BGR888 BGR888格式 E_MI_SYS_PIXEL_FRAME_GRAY8 8bit 灰度格式 E_MI_SYS_PIXEL_FRAME_FORMAT_MAX 枚举的最大值 -
注意事项
E_MI_SYS_PIXEL_FRAME_RGB_BAYER_BASE, E_MI_SYS_PIXEL_FRAME_RGB_BAYER_NUM 是提供给RGB raw data 组合格式使用的。此格式下,sensor提供的bit位ePixPrecision和排列顺序eBayerId,通过RGB_BAYER_PIXEL宏对其组合生成RGB raw data 组合格式的enum值;
RGB_BAYER_PIXEL宏定义:#define RGB_BAYER_PIXEL(BitMode, PixelID) (E_MI_SYS_PIXEL_FRAME_RGB_BAYER_BASE+ BitMode*E_MI_SYS_PIXEL_BAYERID_MAX+ PixelID),其取值范围为: (E_MI_SYS_PIXEL_FRAME_RGB_BAYER_BASE, E_MI_SYS_PIXEL_FRAME_RGB_BAYER_NUM)
下面提供了一个使用的小例子,更详细的信息请参考对应模块的API文档。
static MI_SYS_PixelFormat_e getVpeRawType(STUB_SensorType_e sensorType) { MI_SYS_PixelFormat_e eVpeRawType = E_MI_SYS_PIXEL_FRAME_RGB_BAYER_NUM; MI_SNR_PlaneInfo_t stSnrPlane0Info; memset(&stSnrPlane0Info, 0x0, sizeof(MI_SNR_PlaneInfo_t)); MI_SNR_GetPlaneInfo(E_MI_SNR_PAD_ID_0, 0, &stSnrPlane0Info); eVpeRawType = (MI_SYS_PixelFormat_e)RGB_BAYER_PIXEL(stSnrPlane0Info.ePixPrecision, stSnrPlane0Info.eBayerId); return eVpeRawType; }
3.2.3. MI_SYS_CompressMode_e¶
-
说明
定义压缩方式枚举类型。
-
定义
typedef enum { E_MI_SYS_COMPRESS_MODE_NONE, //no compress E_MI_SYS_COMPRESS_MODE_SEG, //compress unit is 256 bytes as a segment E_MI_SYS_COMPRESS_MODE_LINE, //compress unit is the whole line E_MI_SYS_COMPRESS_MODE_FRAME, //compress unit is the whole frame E_MI_SYS_COMPRESS_MODE_TO_8BIT, E_MI_SYS_COMPRESS_MODE_BUTT, //number }MI_SYS_CompressMode_e;
-
成员
成员名称 描述 E_MI_SYS_COMPRESS_MODE_NONE 非压缩的视频格式 E_MI_SYS_COMPRESS_MODE_SEG 段压缩的视频格式 E_MI_SYS_COMPRESS_MODE_LINE 行压缩的视频格式,按照一行为一段进行压缩 E_MI_SYS_COMPRESS_MODE_FRAME 帧压缩的视频格式,将一帧数据进行压缩 E_MI_SYS_COMPRESS_MODE_TO_8BIT Pixel 压缩到8bit E_MI_SYS_COMPRESS_MODE_BUTT 视频压缩方式的数量
3.2.4. MI_SYS_FrameTileMode_e¶
-
说明
定义Tile格式枚举类型。
-
定义
typedef enum { E_MI_SYS_FRAME_TILE_MODE_NONE = 0, E_MI_SYS_FRAME_TILE_MODE_16x16, // tile mode 16x16 E_MI_SYS_FRAME_TILE_MODE_16x32, // tile mode 16x32 E_MI_SYS_FRAME_TILE_MODE_32x16, // tile mode 32x16 E_MI_SYS_FRAME_TILE_MODE_32x32, // tile mode 32x32 E_MI_SYS_FRAME_TILE_MODE_MAX } MI_SYS_FrameTileMode_e;
-
成员
成员名称 描述 E_MI_SYS_FRAME_TILE_MODE_NONE None E_MI_SYS_FRAME_TILE_MODE_16x16 16x16 mode E_MI_SYS_FRAME_TILE_MODE_16x32 16x32 mode E_MI_SYS_FRAME_TILE_MODE_32x16 32x16 mode E_MI_SYS_FRAME_TILE_MODE_32x32 32x32 mode
3.2.5. MI_SYS_FieldType_e¶
-
说明
定义枚举类型。
-
定义
typedef enum { E_MI_SYS_FIELDTYPE_NONE, //< no field. E_MI_SYS_FIELDTYPE_TOP, //< Top field only. E_MI_SYS_FIELDTYPE_BOTTOM, //< Bottom field only. E_MI_SYS_FIELDTYPE_BOTH, //< Both fields. E_MI_SYS_FIELDTYPE_NUM } MI_SYS_FieldType_e;
-
成员
成员名称 描述 E_MI_SYS_FIELDTYPE_NONE None E_MI_SYS_FIELDTYPE_TOP Top field only E_MI_SYS_FIELDTYPE_BOTTOM Bottom field only E_MI_SYS_FIELDTYPE_BOTH Both fields
3.2.6. MI_SYS_BufDataType_e¶
-
说明
定义模块ID枚举类型。
-
定义
typedef enum { E_MI_SYS_BUFDATA_RAW = 0, E_MI_SYS_BUFDATA_FRAME, E_MI_SYS_BUFDATA_META, E_MI_SYS_BUFDATA_MULTIPLANE, } MI_SYS_BufDataType_e;
-
成员
成员名称 描述 E_MI_SYS_BUFDATA_RAW Raw数据类型 E_MI_SYS_BUFDATA_FRAME Frame数据类型 E_MI_SYS_BUFDATA_META Meta数据类型 E_MI_SYS_BUFDATA_MULTIPLANE MultiPlane数据类型
3.2.7. MI_SYS_FrameIspInfoType_e¶
-
说明
定义frame data携带的ISP info枚举类型。
-
定义
typedef enum { E_MI_SYS_FRAME_ISP_INFO_TYPE_NONE, E_MI_SYS_FRAME_ISP_INFO_TYPE_GLOBAL_GRADIENT }MI_SYS_FrameIspInfoType_e;
-
成员
成员名称 描述 E_MI_SYS_FRAME_ISP_INFO_TYPE_NONE NONE E_MI_SYS_FRAME_ISP_INFO_TYPE_GLOBAL_GRADIENT ISP的全局梯度数据类型
3.2.8. MI_SYS_ChnPort_t¶
-
说明
定义模块设备通道结构体。
-
定义
typedef struct MI_SYS_ChnPort_s { MI_ModuleId_e eModId; MI_U32 u32DevId; MI_U32 u32ChnId; MI_U32 u32PortId; } MI_SYS_ChnPort_t;
-
成员
成员名称 描述 eModId 模块号 u32DevId 设备号 u32ChnId 通道号 u32PortId 端口号
3.2.9. MI_SYS_MetaData_t¶
-
说明
定义码流MetaData的结构体。
-
定义
typedef struct MI_SYS_MetaData_s { void* pVirAddr; MI_PHY phyAddr;//notice that this is miu bus addr,not cpu bus addr. MI_U32 u32Size; MI_U32 u32ExtraData; /*driver special flag*/ MI_ModuleId_e eDataFromModule; } MI_SYS_MetaData_t;
-
成员
成员名称 描述 pVirAddr 数据存放虚拟地址。 phyAddr 数据存放物理地址 u32Size 数据大小 u32ExtraData driver special flag eDataFromModule 来自哪个模块的数据
3.2.10. MI_SYS_RawData_t¶
-
说明
定义码流RawData的结构体。
-
定义
typedef struct MI_SYS_RawData_s { void* pVirAddr; MI_PHY phyAddr;//notice that this is miu bus addr,not cpu bus addr. MI_U32 u32BufSize; MI_U32 u32ContentSize; MI_BOOL bEndOfFrame; MI_U64 u64SeqNum; } MI_SYS_RawData_t;
-
成员
成员名称 描述 pVirAddr 码流包的地址。 phyAddr 码流包的物理地址 u32BufSize Buf大小 u32ContentSize 数据实际占用buf大小 bEndOfFrame 当前帧是否结束。(预留参数)当前只支持帧模式下按帧传送。 u64SeqNum 当前帧的帧序号 -
注意事项
-
当前只支持按帧传送数据,每次需完整传送一帧数据。
-
码流帧数据附带PTS时,解码后输出数据输出相同PTS。当PTS=-1时,不参考系统时钟输出数据帧。
-
3.2.11. MI_SYS_WindowRect_t¶
-
说明
定义window坐标的结构体。
-
定义
typedef struct MI_SYS_WindowRect_s { MI_U16 u16X; MI_U16 u16Y; MI_U16 u16Width; MI_U16 u16Height; }MI_SYS_WindowRect_t;
-
成员
成员名称 描述 u16X window起始位置的水平方向的值。 u16Y window起始位置的垂直方向的值。 u16Width window宽度。 u16Height window高度。
3.2.12. MI_SYS_FrameData_t¶
-
说明
定义码流FrameData的结构体。
-
定义
//N.B. in MI_SYS_FrameData_t should never support u32Size, //for other values are enough,and not support u32Size is general standard method. typedef struct MI_SYS_FrameData_s { MI_SYS_FrameTileMode_e eTileMode; MI_SYS_PixelFormat_e ePixelFormat; MI_SYS_CompressMode_e eCompressMode; MI_SYS_FrameScanMode_e eFrameScanMode; MI_SYS_FieldType_e eFieldType; MI_SYS_FrameData_PhySignalType ePhylayoutType; MI_U16 u16Width; MI_U16 u16Height; //in case ePhylayoutType equal to REALTIME_FRAME_DATA, pVirAddr would be MI_SYS_REALTIME_MAGIC_PADDR and phyAddr would be MI_SYS_REALTIME_MAGIC_VADDR void* pVirAddr[3]; MI_PHY phyAddr[3];//notice that this is miu bus addr,not cpu bus addr. MI_U32 u32Stride[3]; MI_U32 u32BufSize;//total size that allocated for this buffer,include consider alignment. MI_U16 u16RingBufStartLine;//Valid in case RINGBUF_FRAME_DATA, u16RingBufStartLine must be LGE than 0 and less than u16Height MI_U16 u16RingBufRealTotalHeight;///Valid in case RINGBUF_FRAME_DATA, u16RingBufStartLine must be LGE than u16Height MI_SYS_FrameIspInfo_t stFrameIspInfo;//isp info of each frame MI_SYS_WindowRect_t stContentCropWindow; } MI_SYS_FrameData_t;
-
成员
成员名称 描述 eTileMode Tile模式 ePixelFormat 像素格式 eCompressMode 压缩格式 eFrameScanMode Frame scan模块 eFieldType File类型 ePhylayoutType frame data隶属的buffer的类型 u16Width Frame宽度 u16Height Frame高度 pVirAddr 虚拟地址 phyAddr 物理地址 u32Stride 图片每行所占字节数 u32BufSize Sys分配给当前frame的实际buf大小 u16RingBufStartLine ring mode时,frame data开始于ring buffer的行数 u16RingBufRealTotalHeight ring mode时,frame data的真实高度 stFrameIspInfo ISP info struct stContentCropWindow Crop info struct
3.2.13. MI_SYS_BufInfo_t¶
-
说明
定义码流信息的结构体。
-
定义
typedef struct MI_SYS_BufInfo_s { MI_U64 u64Pts; MI_U64 u64SidebandMsg; MI_SYS_BufDataType_e eBufType; MI_U32 bEndOfStream : 1; MI_U32 bUsrBuf : 1; MI_U32 bDrop : 1; MI_U32 u32IrFlag : 2; // For Window Hello Usage: 0x00/off, 0x01/on, 0x02/invalid MI_U32 u32Reserved : 27; MI_U32 u32SequenceNumber; union { MI_SYS_FrameData_t stFrameData; MI_SYS_RawData_t stRawData; MI_SYS_MetaData_t stMetaData; MI_SYS_FrameDataMultiPlane_t stFrameDataMultiPlane; }; } MI_SYS_BufInfo_t;
-
成员
成员名称 描述 eBufType Buf类型 u64Pts 时间戳 bEndOfStream 是否已发完所有信息 u32IrFlag Ir标志位
3.2.14. MI_SYS_FrameBufExtraConfig_t¶
-
说明
定义码流Frame buffer额外配置的结构体。
-
定义
typedef struct MI_SYS_FrameBufExtraConfig_s { //Buf alignment requirement in horizontal MI_U16 u16BufHAlignment; //Buf alignment requirement in vertical MI_U16 u16BufVAlignment; //Buf alignment requirement in chroma MI_U16 u16BufChromaAlignment; //Clear padding flag MI_BOOL bClearPadding; }MI_SYS_FrameBufExtraConfig_t;
-
成员
成员名称 描述 u16BufHAlignment 水平方向对齐值 u16BufVAlignment 垂直方向对齐值 u16BufChromaAlignment 色度buffer size对齐值 bClearPadding 是否对buffer的边缘进行涂黑
3.2.15. MI_SYS_BufFrameConfig_t¶
-
说明
定义码流Frame buffer配置的结构体。
-
定义
typedef struct MI_SYS_BufFrameConfig_s { MI_U16 u16Width; MI_U16 u16Height; MI_SYS_FrameScanMode_e eFrameScanMode;// MI_SYS_PixelFormat_e eFormat; MI_SYS_CompressMode_e eCompressMode; }MI_SYS_BufFrameConfig_t;
-
成员
成员名称 描述 u16Width Frame宽度 u16Height Frame高度 eFrameScanMode Frame Scan Mode eFormat Frame像素格式 eCompressMode Frame 压缩模式
3.2.16. MI_SYS_BufRawConfig_t¶
-
说明
定义码流raw buffer配置的结构体。
-
定义
typedef struct MI_SYS_BufRawConfig_s { MI_U32 u32Size; }MI_SYS_BufRawConfig_t;
-
成员
成员名称 描述 u32Size Buf大小
3.2.17. MI_SYS_MetaDataConfig_t¶
-
说明
定义码流meta buffer配置的结构体。
-
定义
typedef struct MI_SYS_MetaDataConfig_s { MI_U32 u32Size; }MI_SYS_MetaDataConfig_t;
-
成员
成员名称 | 描述 |
---|---|
u32Size | Buf大小 |
3.2.18. MI_SYS_BufConf_t¶
-
说明
定义码流Port Buf配置的结构体。
-
定义
typedef struct MI_SYS_BufConf_s { MI_SYS_BufDataType_e eBufType; MI_U32 u32Flags; //0 or MI_SYS_MAP_VA MI_U64 u64TargetPts; union { MI_SYS_BufFrameConfig_t stFrameCfg; MI_SYS_BufRawConfig_t stRawCfg; MI_SYS_MetaDataConfig_t stMetaCfg; MI_SYS_BufFrameMultiPlaneConfig_t stMultiPlaneCfg; }; }MI_SYS_BufConf_t;
-
成员
成员名称 描述 eBufType Buf type u32Flags Buf是否map kernel space va
3.2.19. MI_SYS_Version_t¶
-
说明
定义Sys版本信息结构体。
-
定义
typedef struct MI_SYS_Version_s { MI_U8 u8Version[128]; }MI_SYS_Version_t;
-
成员
成员名称 描述 u8Version[128] 描述sys版本信息的字符串buf
3.2.20. MI_VB_PoolListConf_t¶
-
说明
定义描述VB Pool链表信息的结构体。
-
定义
typedef struct MI_VB_PoolListConf_s { MI_U32 u32PoolListCnt; MI_VB_PoolConf_t stPoolConf[MI_VB_POOL_LIST_MAX_CNT]; } MI_VB_PoolListConf_t;
-
成员
成员名称 描述 u32PoolListCnt VB pool 链表成员数量 stPoolConf VB pool 链表成员配置信息
3.2.21. MI_SYS_BindType_e¶
-
说明
定义前后级工作模式。
-
定义
typedef enum { E_MI_SYS_BIND_TYPE_FRAME_BASE = 0x00000001, E_MI_SYS_BIND_TYPE_SW_LOW_LATENCY = 0x00000002, E_MI_SYS_BIND_TYPE_REALTIME = 0x00000004, E_MI_SYS_BIND_TYPE_HW_AUTOSYNC = 0x00000008, E_MI_SYS_BIND_TYPE_HW_RING = 0x00000010 }MI_SYS_BindType_e;
-
成员
成员名称 描述 E_MI_SYS_BIND_TYPE_FRAME_BASE frame mode,默认工作方式 E_MI_SYS_BIND_TYPE_SW_LOW_LATENCY 低时延工作方式 E_MI_SYS_BIND_TYPE_REALTIME 硬件直连工作方式 E_MI_SYS_BIND_TYPE_HW_AUTOSYNC 前后级handshake,buffer size与图像分辨率一致 E_MI_SYS_BIND_TYPE_HW_RING 前后级handshake,ring buffer depth可以调小于图像分辨率高 -
注意事项
-
旧版本MI SYS不提供此功能,如没有找到,不用设置。
-
FRAME_BASE和HW_RING类型使用的内存为DRAM,REALTIME类型使用的内存为SRAM。
-
由于底层限制,被HW_RING或REALTIME类型bind的input port不能使用MI_SYS_ChnInputPortGetBuf/ MI_SYS_ChnInputPortPutBuf接口,output port不能使用 MI_SYS_ChnOutputPortGetBuf/ MI_SYS_ChnOutputPortPutBuf接口。
-
不同bindtype使用内存大小比较:FRAME_BASE类型 > HW_RING类型 > REALTIME类型。
-
3.2.22. MI_SYS_FrameData_PhySignalType¶
-
说明
描述frame data隶属的buffer类型的枚举类型。
-
定义
typedef enum { REALTIME_FRAME_DATA, RINGBUF_FRAME_DATA, NORMAL_FRAME_DATA, }MI_SYS_FrameData_PhySignalType;
-
成员
成员名称 描述 REALTIME_FRAME_DATA 以E_MI_SYS_BIND_TYPE_REALTIME模式 产生的frame data RINGBUF_FRAME_DATA 以E_MI_SYS_BIND_TYPE_HW_RING模式 产生的frame data NORMAL_FRAME_DATA 以E_MI_SYS_BIND_TYPE_FRAME_BASE模式产生的frame data -
注意事项
旧版本MI SYS不提供此功能,如没有找到,不用设置。
3.2.23. MI_SYS_InsidePrivatePoolType_e¶
-
说明
描述创建的私有MMA POOL类型的枚举类型。
-
定义
typedef enum { E_MI_SYS_VPE_TO_VENC_PRIVATE_RING_POOL = 0, E_MI_SYS_PER_CHN_PRIVATE_POOL=1, E_MI_SYS_PER_DEV_PRIVATE_POOL=2, E_MI_SYS_PER_CHN_PORT_OUTPUT_POOL=3, }MI_SYS_InsidePrivatePoolType_e;
-
成员
成员名称 描述 E_MI_SYS_VPE_TO_VENC_PRIVATE_RING_POOL VPE与VENC 的私有Ring Pool 类型 E_MI_SYS_PER_CHN_PRIVATE_POOL 通道私有Pool 类型 E_MI_SYS_PER_DEV_PRIVATE_POOL 设备私有Pool 类型 E_MI_SYS_PER_CHN_PORT_OUTPUT_POOL 输出端口私有Pool类型 -
注意事项
旧版本MI SYS不提供此功能,如没有找到,不用设置。
3.2.24. MI_SYS_PerChnPrivHeapConf_t¶
-
说明
定义描述通道私有MMA Pool的结构体。
-
定义
typedef struct MI_PerChnPrivHeapConf_s { MI_ModuleId_e eModule; MI_U32 u32Devid; MI_U32 u32Channel; MI_U8 u8MMAHeapName[MI_MAX_MMA_HEAP_LENGTH]; MI_U32 u32PrivateHeapSize; }MI_SYS_PerChnPrivHeapConf_t;
-
成员
成员名称 描述 eModule 模块ID u32Devid 设备ID u32Channel 通道ID u8MMAHeapName Mma heap name u32PrivateHeapSize 私有pool 大小
3.2.25. MI_SYS_PerDevPrivHeapConf_t¶
-
说明
定义描述设备私有MMA Pool的结构体。
-
定义
typedef struct MI_PerDevPrivHeapConf_s { MI_ModuleId_e eModule; MI_U32 u32Devid; MI_U32 u32Reserve; MI_U8 u8MMAHeapName[MI_MAX_MMA_HEAP_LENGTH]; MI_U32 u32PrivateHeapSize; }MI_SYS_PerDevPrivHeapConf_t;
-
成员
成员名称 描述 eModule 模块ID u32Devid 设备ID u32Reserve 预留 u8MMAHeapName Mma heap name u32PrivateHeapSize 私有pool 大小
3.2.26. MI_SYS_PerVpe2VencRingPoolConf_t¶
-
说明
定义描述VPE与VENC之间的私有Ring MMA Pool的结构体。
-
定义
typedef struct MI_SYS_PerVpe2VencRingPoolConf_s { MI_U32 u32VencInputRingPoolStaticSize; MI_U8 u8MMAHeapName[MI_MAX_MMA_HEAP_LENGTH]; }MI_SYS_PerVpe2VencRingPoolConf_t;
-
成员
成员名称 描述 u32VencInputRingPoolStaticSize 私有pool大小 u8MMAHeapName Mma heap name
3.2.27. MI_SYS_PerChnPortOutputPool_t¶
-
说明
定义描述ouput port的私有MMA Pool的结构体。
-
定义
typedef struct MI_SYS_PerChnPortOutputPool_s { MI_ModuleId_e eModule; MI_U32 u32Devid; MI_U32 u32Channel; MI_U32 u32Port; MI_U8 u8MMAHeapName[MI_MAX_MMA_HEAP_LENGTH]; MI_U32 u32PrivateHeapSize; }MI_SYS_PerChnPortOutputPool_t;
-
成员
成员名称 描述 eModule 模块ID u32Devid 设备ID u32Channel 通道ID u32Port 端口ID u8MMAHeapName Mma heap name u32PrivateHeapSize 私有pool 大小
3.2.28. MI_SYS_GlobalPrivPoolConfig_t¶
-
说明
定义描述配置私有 MMA Pool的结构体。
-
定义
typedef struct MI_SYS_GlobalPrivPoolConfig_s { MI_SYS_InsidePrivatePoolType_e eConfigType; MI_BOOL bCreate; union { MI_SYS_PerChnPrivHeapConf_t stPreChnPrivPoolConfig; MI_SYS_PerDevPrivHeapConf_t stPreDevPrivPoolConfig; MI_SYS_PerVpe2VencRingPoolConf_t stPreVpe2VencRingPrivPoolConfig; MI_SYS_PerChnPortOutputPool_t stPreChnPortOutputPrivPool; }uConfig; }MI_SYS_GlobalPrivPoolConfig_t;
-
成员
成员名称 描述 eConfigType 私有pool类型 bCreate 是否创建私有pool。true:创建 false:销毁 uConfig 不同类型私有pool的结构体
3.2.29. MI_SYS_FrameIspInfo_t¶
-
说明
定义frame data中ISP info的结构体。
-
定义
typedef struct MI_SYS_FrameIspInfo_s { MI_SYS_FrameIspInfoType_e eType; union { MI_U32 u32GlobalGradient; }uIspInfo; }MI_SYS_FrameIspInfo_t;
-
成员
成员名称 描述 eType ISP info type uIspInfo ISP info union
3.2.30. MI_SYS_InitParam_t¶
-
说明
SYS设备初始化参数。
-
定义
typedef struct MI_SYS_InitParam_s { MI_U32 u32DevId; MI_U8 *u8Data; } MI_SYS_InitParam_t;
-
成员
成员名称 描述 u32DevId 设备ID u8Data 数据指针buffer -
相关数据类型及接口
3.2.31. MI_SYS_BufFrameMultiPlaneConfig_t¶
-
说明
定义码流multiplane buffer配置的结构体。
-
定义
typedef struct MI_SYS_BufFrameMultiPlaneConfig_s { MI_U8 u8SubPlaneNum; MI_SYS_BufFrameConfig_t stFrameCfg; }MI_SYS_BufFrameMultiPlaneConfig_t;
- 成员
|成员名称|描述| |------|-----| |u8SubPlaneNum|Buf 个数| |stFrameCfg|定义码流Frame buffer配置的结构体|
3.2.32. MI_SYS_FrameDataSubPlane_t¶
-
说明
定义码流SubPlane FrameData的结构体。
-
定义
typedef struct MI_SYS_FrameDataSubPlane_s { MI_SYS_PixelFormat_e ePixelFormat; MI_SYS_CompressMode_e eCompressMode; MI_U64 u64FrameId; MI_U16 u16Width; MI_U16 u16Height; void* pVirAddr[2]; MI_PHY phyAddr[2]; MI_U16 u16Stride[2]; MI_U32 u32BufSize; } MI_SYS_FrameDataSubPlane_t;
-
成员
成员名称 描述 ePixelFormat 像素格式 eCompressMode 压缩格式 u64FrameId Frame id u16Width Frame宽度 u16Height Frame高度 pVirAddr 虚拟地址 phyAddr 物理地址 U16Stride 图片每行所占字节数 u32BufSize Sys分配给当前frame的实际buf大小
3.2.33. MI_SYS_FrameDataMultiPlane_t¶
-
说明
定义码流MultiPlane FrameData的结构体。
-
定义
typedef struct MI_SYS_FrameDataMultiPlane_s { MI_U8 u8SubPlaneNum; MI_SYS_FrameDataSubPlane_t stSubPlanes[MI_SYS_MAX_SUB_PLANE_CNT]; } MI_SYS_FrameDataMultiPlane_t;
-
成员
成员名称 描述 u8SubPlaneNum Buf个数 stSubPlanes 定义码流MultiPlane FrameData的结构体
3.2.34. MI_SYS_GlobalFlagType_e¶
-
说明 定义全局Flag类型。
-
定义
typedef enum { E_MI_SYS_GLOBALFLAG_IR, E_MI_SYS_GLOBALFLAG_NUM, } MI_SYS_GlobalFlagType_e;
-
成员
成员名称 描述 E_MI_SYS_GLOBALFLAG_IR IR全局Flag
3.2.35. MI_SYS_GlobalFlagParam_t¶
-
说明
定义设置全局Flag参数。
-
定义
typedef struct MI_SYS_GlobalFlagParam_s { MI_SYS_GlobalFlagType_e eFlagType; MI_BOOL bIsr; MI_U32 u32Value; } MI_SYS_GlobalFlagParam_t;
-
成员
成员名称 描述 eFlagType 设置Flag的类型,目前只支持设置为MI_SYS_GLOBALFLAG_IR bIsr 该Flag设置是否会在中断中执行,若在中断中调用,需设置为1 u32Value 设置的全局标志位值,目前只支持设置IR标志位,0x01表示IR灯打开,0x00表示IR灯关闭 -
注意事项
设置IR全局Flag时,u32Value为0时则表示OFF,为1时则表示ON。
3.2.36. MI_SYS_MmaPoolInfo_t¶
-
说明
定义描述内存池的结构体。
-
定义
typedef struct MI_SYS_MmaPoolInfo_s { MI_BOOL bPrivatePool; Union{ MI_SYS_ChnPort_t stChnPort; MI_U8 u8MMAHeapName[MI_MAX_MMA_HEAP_LENGTH]; }uConfig; MI_U32 u32TotalFreeSize; MI_U32 u32MaxContiFreeSize; } MI_SYS_MmaPoolInfo_t;
-
成员
成员名称 描述 bPrivatePool 是否获取私有pool信息
TRUE:配置uConfig. stChnPort
FALSE:配置u8MMAHeapNameuConfig stChnPort:配置需要查询的私有Pool
u8MMAHeapName:要查询的mma heap nameu32TotalFreeSize 内存池总空闲大小 u32MaxContiFreeSize 内存池物理连续的最大内存长度
4. 错误码¶
4.1. 错误码的组成¶
MI 返回的错误码为4字节,共32bits,由表4-1所示五部分组成:
表4-1 错误码的组成
位置 | 所占位数 | 描述 |
---|---|---|
BIT [0-11] | 12bits | 错误类型,表示该错误码的具体错误含义。 |
BIT [12-15] | 4bits | 错误等级,固定返回2。 |
BIT [16-23] | 8bits | 模块ID,表示该错误码是属于哪个模块。 |
BIT [24-31] | 8bits | 固定为0xA0。 |
Tips:
我们可以简单的把错误码看成两个双字节(16bits)做快速解读,以错误码 0xA0092001为例:
“A009”:表示该错误发生在模块ID为9的模块,通过查看“MI_ModuleId_e”的定义可知为MI_SYS模块。
“2001”:表示该错误的错误类型是1,即“设备 ID 超出合法范围”。
4.2. MI_SYS API错误码表¶
MI_SYS模块所有API返回的值都为4字节,0表示执行成功,其它值表示执行失败,需要注意的是,所有非0的返回值都应该是表4-2中列出的,否则为非法值。
表4-2 MI_SYS模块API错误码
错误码 | 宏定义 | 描述 |
---|---|---|
0xA0092001 | MI_ERR_SYS_INVALID_DEVID | 设备 ID 超出合法范围 |
0xA0092002 | MI_ERR_SYS_INVALID_CHNID | 通道组号错误或无效区域句柄 |
0xA0092003 | MI_ERR_SYS_ILLEGAL_PARAM | 参数超出合法范围 |
0xA0092004 | MI_ERR_SYS_EXIST | 重复创建已存在的设备、通道或资源 |
0xA0092005 | MI_ERR_SYS_UNEXIST | 试图使用或者销毁不存在的设备、通道或者资源 |
0xA0092006 | MI_ERR_SYS_NULL_PTR | 函数参数中有空指针 |
0xA0092007 | MI_ERR_SYS_NOT_CONFIG | 模块没有配置 |
0xA0092008 | MI_ERR_SYS_NOT_SUPPORT | 不支持的参数或者功能 |
0xA0092009 | MI_ERR_SYS_NOT_PERM | 该操作不允许,如试图修改静态配置参数 |
0xA009200C | MI_ERR_SYS_NOMEM | 分配内存失败,如系统内存不足 |
0xA009200D | MI_ERR_SYS_NOBUF | 分配缓存失败,如申请的数据缓冲区太大 |
0xA009200E | MI_ERR_SYS_BUF_EMPTY | 缓冲区中无数据 |
0xA009200F | MI_ERR_SYS_BUF_FULL | 缓冲区中数据满 |
0xA0092010 | MI_ERR_SYS_NOTREADY | 系统没有初始化或没有加载相应模块 |
0xA0092011 | MI_ERR_SYS_BADADDR | 地址非法 |
0xA0092012 | MI_ERR_SYS_BUSY | 系统忙 |
0xA0092013 | MI_ERR_SYS_CHN_NOT_STARTED | 通道没有开始 |
0xA0092014 | MI_ERR_SYS_CHN_NOT_STOPED | 通道没有停止 |
0xA0092015 | MI_ERR_SYS_NOT_INIT | 模块没有初始化 |
0xA0092016 | MI_ERR_SYS_INITED | 模块已经初始化 |
0xA0092017 | MI_ERR_SYS_NOT_ENABLE | 通道或端口没有ENABLE |
0xA0092018 | MI_ERR_SYS_NOT_DISABLE | 通道或端口没有DISABLE |
0xA0092019 | MI_ERR_SYS_TIMEOUT | 超时 |
0xA009201A | MI_ERR_SYS_DEV_NOT_STARTED | 设备没有开始 |
0xA009201B | MI_ERR_SYS_DEV_NOT_STOPED | 设备没有停止 |
0xA009201C | MI_ERR_SYS_CHN_NO_CONTENT | 通道没有资料 |
0xA009201D | MI_ERR_SYS_NOVASAPCE | 映射虚拟地址失败 |
0xA009201E | MI_ERR_SYS_NOITEM | RingPool中没有记录 |
0xA009201F | MI_ERR_SYS_FAILED | 未明确定义的错误 |
5. PROCFS介绍¶
5.1. common¶
5.1.1. dump_mmap¶
-
调试信息
# /config/dump_mmap
-
调试信息分析
/config/dump_mmap根据文件/config/mmap.ini显示内存相关信息。
-
参数分析
参数 描述 u32TotalSize Dram总大小 u32Miu0Size MIU0的寻址大小 u32Miu1Size MIU1的寻址大小 u32MiuBoundary MIU0 end address u32MmapItemsNum 将Dram mmap的个数,这里是2个,分别是E_LX_MEM和E_MMAP_ID_EMI bIs4kAlign 读写Dram是否需要4K对齐 bMiu1Enable MIU1是否enable E_LX_MEM GID Mmap id Addr Memory address Size Memory size Layer Memory layer Align Memory align MemoryType Memory type MiuNo MIU NO. CMAID CMA id E_MMAP_ID_EMI GID Mmap id Addr Memory address Size Memory size Layer Memory layer Align Memory align MemoryType Memory type MiuNo MIU NO. CMAID CMA id
5.1.2. dump_config¶
-
调试信息
# /config/dump_config panel cnt:59 PanelName:RM68200_720x1280 Intftype:11 timing:55 PanelName:SAT070AT50H18BH_1024x600 Intftype:0 timing:55 PanelName:BT1120OUTPUT_720p_60HZ Intftype:14 timing:55 PanelName:BT656OUTPUT_576p_50HZ Intftype:12 timing:55 PanelName:ST7789V Intftype:16 timing:55 PanelName:ILI9881C_800x1280 Intftype:11 timing:55 PanelName:ILI9163C_128x128 Intftype:15 timing:55 PanelName:DACOUT_576I Intftype:7 timing:4 PanelName:DACOUT_480I Intftype:7 timing:2 PanelName:DACOUT_1080P_24 Intftype:8 timing:10 PanelName:DACOUT_1080P_25 Intftype:8 timing:11 PanelName:DACOUT_1080P_30 Intftype:8 timing:12 PanelName:DACOUT_1080P_50 Intftype:8 timing:15 PanelName:DACOUT_720P_2997 Intftype:8 timing:6 PanelName:DACOUT_720P_50 Intftype:8 timing:7 PanelName:DACOUT_720P_5994 Intftype:8 timing:8 PanelName:DACOUT_720P_60 Intftype:8 timing:9 PanelName:DACOUT_1080P_2997 Intftype:8 timing:13 PanelName:DACOUT_1080I_50 Intftype:7 timing:14 PanelName:DACOUT_1080P_5994 Intftype:8 timing:16 PanelName:DACOUT_1080I_60 Intftype:7 timing:17 PanelName:DACOUT_1080P_60 Intftype:8 timing:18 PanelName:DACOUT_576P Intftype:8 timing:5 PanelName:DACOUT_480P Intftype:8 timing:3 PanelName:DACOUT_2K2KP_30 Intftype:8 timing:27 PanelName:DACOUT_2K2KP_60 Intftype:8 timing:28 PanelName:DACOUT_4K2KP_24 Intftype:8 timing:33 PanelName:DACOUT_4K2KP_25 Intftype:8 timing:34 PanelName:DACOUT_4K2KP_30 Intftype:8 timing:35 PanelName:DACOUT_4K2KP_50 Intftype:8 timing:36 PanelName:DACOUT_4K2KP_60 Intftype:8 timing:37 PanelName:DACOUT_1440P_50 Intftype:8 timing:19 PanelName:DACOUT_1440P_60 Intftype:8 timing:20 PanelName:VGAOUT_1024x768P_60 Intftype:8 timing:45 PanelName:VGAOUT_1280x1024P_60 Intftype:8 timing:48 PanelName:VGAOUT_1366x768P_60 Intftype:8 timing:46 PanelName:VGAOUT_1440x900P_60 Intftype:8 timing:49 PanelName:VGAOUT_1280x800P_60 Intftype:8 timing:47 PanelName:VGAOUT_1680x1050P_60 Intftype:8 timing:51 PanelName:VGAOUT_1600x1200P_60 Intftype:8 timing:50 PanelName:BT1120OUT_576P_50 Intftype:14 timing:5 PanelName:BT1120OUT_480P_60 Intftype:14 timing:3 PanelName:BT1120OUT_1080P_25 Intftype:14 timing:11 PanelName:BT1120OUT_1080P_30 Intftype:14 timing:12 PanelName:BT1120OUT_1080P_50 Intftype:14 timing:15 PanelName:BT1120OUT_1080P_2997 Intftype:14 timing:13 PanelName:BT1120OUT_1080P_5994 Intftype:14 timing:16 PanelName:BT1120OUT_1080P_60 Intftype:14 timing:18 PanelName:BT1120OUT_720P_50 Intftype:14 timing:7 PanelName:BT1120OUT_720P_5994 Intftype:14 timing:8 PanelName:BT1120OUT_720P_60 Intftype:14 timing:9 PanelName:BT656OUT_576P_50 Intftype:12 timing:5 PanelName:BT656OUT_480P_60 Intftype:12 timing:3 PanelName:BT656OUT_1080P_25 Intftype:12 timing:11 PanelName:BT656OUT_1080P_2997 Intftype:12 timing:13 PanelName:BT656OUT_1080P_30 Intftype:12 timing:12 PanelName:BT656OUT_720P_50 Intftype:12 timing:7 PanelName:BT656OUT_720P_60 Intftype:12 timing:9 PanelName:BT656OUT_720P_5994 Intftype:12 timing:8 pq table size:25892 DBC Value= 0,0,0 0,0,0 0,0,0 start dump [motion_table](0, 0) end dump start dump [motion_hdmi_dtv_table](0, 0) end dump start dump [motion_comp_pc_table](0, 0) end dump start dump [misc_param_table](0, 0) end dump start dump [misc_luma_table](0, 0) end dump start dump [noise_table](0, 0) end dump start dump [misc_table](0, 0) end dump
-
调试信息分析
./config/dump_config
得到的是/proc/mi_modules/common/
里各文件的信息,含panel count、DBC Value、motion_table、motion_hdmi_dtv_table、motion_comp_pc_table、misc_param_table、misc_luma_table、noise_table、misc_table等。 -
参数分析
参数 描述 panel Panel cnt panel数目 PanelName LCD屏名称 Intftype LCD屏接口类型: E_MAPI_PNL_INTF_TTL = 0, ///< TTL type
E_MAPI_PNL_INTF_LVDS, ///< LVDS type
E_MAPI_PNL_INTF_RSDS, ///< RSDS type
E_MAPI_PNL_INTF_MINILVDS, ///< TCON
///< Analog TCON
E_MAPI_PNL_INTF_ANALOG_MINILVDS,
///< Digital TCON
E_MAPI_PNL_INTF_DIGITAL_MINILVDS,
E_MAPI_PNL_INTF_MFC, ///< Ursa (TTL output to Ursa)
E_MAPI_PNL_INTF_DAC_I, ///< DAC output
E_MAPI_PNL_INTF_DAC_P, ///< DAC output
///< For PDP(Vsync use Manually MODE)
E_MAPI_PNL_INTF_PDPLVDS,
E_MAPI_PNL_INTF_EXT, ///< EXT LPLL type
E_MAPI_PNL_INTF_MIPI_DSI,
E_MAPI_PNL_INTF_BT656,
E_MAPI_PNL_INTF_BT601,
E_MAPI_PNL_INTF_BT1120, ///< BT1120
E_MAPI_PNL_INTF_MCU_TYPE, ///< MCU type
E_MAPI_PNL_INTF_SRGB, ///< sRGB
E_MAPI_PNL_INTF_TTL_SPI_IF,timing LCD屏显示输出时序:
DISPLAYTIMING_MIN = 0,
DISPLAYTIMING_DACOUT_DEFAULT = 0,
DISPLAYTIMING_DACOUT_FULL_HD,
DISPLAYTIMING_DACOUT_480I,
DISPLAYTIMING_DACOUT_480P,
DISPLAYTIMING_DACOUT_576I,
DISPLAYTIMING_DACOUT_576P, // 5
DISPLAYTIMING_DACOUT_720P_2997,
DISPLAYTIMING_DACOUT_720P_50,
DISPLAYTIMING_DACOUT_720P_5994,
DISPLAYTIMING_DACOUT_720P_60,
DISPLAYTIMING_DACOUT_1080P_24,
DISPLAYTIMING_DACOUT_1080P_25,
DISPLAYTIMING_DACOUT_1080P_30, // 12
DISPLAYTIMING_DACOUT_1080P_2997,
DISPLAYTIMING_DACOUT_1080I_50,
DISPLAYTIMING_DACOUT_1080P_50,
DISPLAYTIMING_DACOUT_1080P_5994,
DISPLAYTIMING_DACOUT_1080I_60,
DISPLAYTIMING_DACOUT_1080P_60,
DISPLAYTIMING_DACOUT_1440P_50,
DISPLAYTIMING_DACOUT_1440P_60,
DISPLAYTIMING_DACOUT_1470P_24,
DISPLAYTIMING_DACOUT_1470P_30,
DISPLAYTIMING_DACOUT_1470P_60,
DISPLAYTIMING_DACOUT_2205P_24,
// For 2k2k
DISPLAYTIMING_DACOUT_2K2KP_24, // 23
DISPLAYTIMING_DACOUT_2K2KP_25,
DISPLAYTIMING_DACOUT_2K2KP_30,
DISPLAYTIMING_DACOUT_2K2KP_60,
// For 4k0.5k
DISPLAYTIMING_DACOUT_4K540P_240,
// For 4k1k
DISPLAYTIMING_DACOUT_4K1KP_30,
DISPLAYTIMING_DACOUT_4K1KP_60,
DISPLAYTIMING_DACOUT_4K1KP_120,
// For 4k2k
DISPLAYTIMING_DACOUT_4K2KP_24,
DISPLAYTIMING_DACOUT_4K2KP_25,
DISPLAYTIMING_DACOUT_4K2KP_30, // 33
DISPLAYTIMING_DACOUT_4K2KP_50,
DISPLAYTIMING_DACOUT_4K2KP_60,
DISPLAYTIMING_DACOUT_4096P_24,
DISPLAYTIMING_DACOUT_4096P_25,
DISPLAYTIMING_DACOUT_4096P_30,
DISPLAYTIMING_DACOUT_4096P_50,
DISPLAYTIMING_DACOUT_4096P_60,
// For VGA OUTPUT
DISPLAYTIMING_VGAOUT_640x480P_60,
DISPLAYTIMING_VGAOUT_1280x720P_60,
DISPLAYTIMING_VGAOUT_1024x768P_60,
DISPLAYTIMING_VGAOUT_1366x768P_60,
DISPLAYTIMING_VGAOUT_1280x800P_60,
DISPLAYTIMING_VGAOUT_1280x1024P_60,
DISPLAYTIMING_VGAOUT_1440x900P_60,
DISPLAYTIMING_VGAOUT_1600x1200P_60,
DISPLAYTIMING_VGAOUT_1680x1050P_60,
DISPLAYTIMING_VGAOUT_1920x1080P_60, // 43
// For TTL output
DISPLAYTIMING_TTLOUT_480X272_60,
DISPLAYTIMING_DACOUT_4K2KP_120,
DISPLAYTIMING_USER,
DISPLAYTIMING_MAX_NUM,Pq table size Pq table size DBC Value 暂时无效果 motion_table 暂时无效果 motion_hdmi_dtv_table 暂时无效果 motion_comp_pc_table 暂时无效果 misc_param_table 暂时无效果 misc_luma_table 暂时无效果 noise_table 暂时无效果 misc_table 暂时无效果
5.2. mi_log_info¶
5.2.1. cat¶
-
调试信息
# cat /proc/mi_modules/mi_log_info ---------------- Log Path ------------------------ log path: ---------------- Store Path ---------------------- store path: /mnt ---------------- Module Log Level ---------------- Log module Level -------------------------- mi_ive 2(WRN) mi_vdf 2(WRN) mi_venc 2(WRN) mi_rgn 2(WRN) mi_ai 2(WRN) mi_ao 2(WRN) mi_vif 2(WRN) mi_vpe 2(WRN) mi_vdec 2(WRN) mi_sys 2(WRN) mi_fb 2(WRN) mi_hdmi 2(WRN) mi_divp 2(WRN) mi_gfx 2(WRN) mi_vdisp 2(WRN) mi_disp 2(WRN) mi_os 2(WRN) mi_iae 2(WRN) mi_md 2(WRN) mi_od 2(WRN) mi_shadow 2(WRN) mi_warp 2(WRN) mi_uac 2(WRN) mi_ldc 2(WRN) mi_sd 2(WRN) mi_panel 2(WRN) mi_cipher 2(WRN) mi_sensor 2(WRN) mi_wlan 2(WRN) mi_ipu 2(WRN) mi_mipitx 2(WRN) mi_gyro 2(WRN) mi_jpd 2(WRN) mi_pspi 2(WRN) help example: echo mi_sys=2 > /proc/mi_modules/mi_log_info echo mi_vdisp=1 > /proc/mi_modules/mi_log_info echo log=/mnt > /proc/mi_modules/mi_log_info echo storepath=/mnt > /proc/mi_modules/mi_log_info
-
调试信息分析
说明了默认的log path 或store path,同时示意了各module的debug_level的值。
-
参数分析
参数 描述 mi_log_info log path 暂时无效果 store path 暂时无效果 Log module 各个模块的名称 Level 打印等级
5.2.2. echo¶
功能 | 修改模块debug_level |
---|---|
命令 | echo [ModID]=[Level] > /proc/mi_modules/mi_log_info |
参数说明 | [ModID] 模块的名字 mi_ive / mi_vdf / mi_venc / mi_rgn mi_ai / mi_ao / mi_vif / mi_vpe mi_vdec / mi_sys / mi_fb / mi_hdmi mi_divp / mi_gfx / mi_vdisp / mi_disp mi_os / mi_iae / mi_md / mi_od / mi_shadow [Level] 0 无Debug信息 (MI_DBG_NONE) 1 只显示error的信息 (MI_DBG_ERR) 2 显示level<=2的信息 (MI_DBG_WRN) 3 显示level<=3的信息 (MI_DBG_API) 4 显示level<=4的信息 (MI_DBG_KMSG) 5 显示level<=5的信息 (MI_DBG_INFO) 6 显示level<=6的信息 (MI_DBG_DEBUG) 7 显示 level<=7的信息 (MI_DBG_TRACE) 8 显示所有信息 (MI_DBG_ALL) |
举例 | echo mi_sys=2 > /proc/mi_modules/mi_log_info mi_sys 的debug_level修改为2 |
功能 | 修改log的路径 |
---|---|
命令 | echo log=[Path] > /proc/mi_modules/mi_log_info |
参数说明 | [Path] 路径 |
举例 | echo log=/mnt > /proc/mi_modules/mi_log_info |
功能 | 修改存储log的路径 |
---|---|
命令 | echo storepath=[Path] > /proc/mi_modules/mi_log_info |
参数说明 | [Path] 路径 |
举例 | echo storepath=/mnt > /proc/mi_modules/mi_log_info |
5.3. mi_global_info¶
5.3.1. cat¶
-
调试信息
# cat /proc/mi_modules/mi_global_info miu_and_lx_info: ARM_MIU0_BUS_BASE 0x20000000 ARM_MIU0_BASE_ADDR 0x0 ARM_MIU1_BUS_BASE 0xa0000000 ARM_MIU1_BASE_ADDR 0x80000000 ARM_MIU2_BUS_BASE 0xffffffff ARM_MIU2_BASE_ADDR 0xffffffff lx_mem_addr 0x20000000 lx_mem_size 0x7fe0000 lx_mem2_addr 0xffffffff lx_mem2_size 0xffffffff lx_mem3_addr 0xffffffff lx_mem3_size 0xffffffff KernelProtect IP white list: clientId name 112 CPU 10 MCU51 38 USB20_H 8 USB20 3 USB30 39 MIIC2 40 MIIC1 46 MIIC0 9 EMAC 30 SD30 31 SDIO30 7 AESDMA 11 URDMA 12 BDMA 13 MOVDMA 0 OVERALL PAGE_OFFSET - the virtual address of the start of the kernel image TASK_SIZE - the maximum size of a user space task PAGE_OFFSET TASK_SIZE VMALLOC_START VMALLOC_END c0000000 bf000000 c8000000 ff800000 Sigmastar Module mi_sys version: project_commit.141b015 sdk_commit.0864fc2 build_time.20211026144648
-
调试信息分析
该调试信息提供了全局global的一些信息。
-
参数分析
参数 描述 miu_and_lx_info(以只有一个MIU为例) ARM_MIU0_BUS_BASE Miu0 bus base ARM_MIU0_BASE_ADDR Miu0 base addr lx_mem_addr Linux镜像占的memory的起始地址(属于cpu bus address) lx_mem_size Linux镜像占的memory的size kernelProtect IP white list clientId Miu protect的IP白名单里的IP的id(从未分group的角度看的全局的id) name 与clientId对应的该IP的实际的名字 PAGE_OFFSET The virtual address of the start of the kernel image TASK_SIZE The maximum size of a user space task VMALLOC_START The start address of vmalloc memory VMALLOC_END The end address of vmalloc memory Sigmastar Module mi_sys version project_commit project对应的commit sdk_commit sdk对应的commit build_time sdk的build时间
5.4. mi_bufqueue_status¶
5.4.1. cat¶
-
调试信息
# cat /proc/mi_modules/mi_bufqueue_status dump Queues in input port only for enabled port: ModId DevId ChnId PassId InPortId UsrInjectQ_cnt BindInQ_cnt InputPendingQueueSize 7 0 0 0 0 0 2 0 7 0 0 1 0 0 0 0 7 0 0 2 0 0 0 0 2 1 0 0 0 0 0 0 dump Queues in output port only for enabled port: ModId DevId ChnId PassId OutPortId DrvBkRefFifoQ_cnt DrvBkRefFifoQ_size UsrGetFifoQ_cnt UsrGetFifoQ_size 6 0 0 0 0 0 0 0 0 7 0 0 0 0 0 0 0 0 7 0 0 1 0 0 0 0 0 7 0 0 2 0 0 0 0 0
-
调试信息分析
Dump当前各modules的enable input/output port 相关Queue的信息。
-
参数分析
参数 描述 dump Queues in input port only for enabled port ModId 该 input port 所在的 module id。 DevId 该 input port 所在的 device id。 ChnId 该 input port 所在的 channel id。 PassId 该 input port 所在的 pass id。 InPortId 该 input port 的 id。 UsrInjectQ_cnt 该 InputPort中UsrInjectBufQueue (usr inject进来还没处理完成的buf队列) 里的buffer 数目。 BindInQ_cnt 该 InputPort中UsrPipeInBufQueue (由绑定前级enq进来还没处理完成的buf队列) 里的buffer 数目。 InputPendingQueueSize 该 InputPort 中cur_working_input_queue (还没开始处理,即将处理) 里的 buffer 总size。 dump Queues in output port only for enabled port ModId 该output port所在的module id。 DevId 该 output port 所在的 device id。 ChnId 该 output port 所在的 channel id。 PassId 该 output port 所在的 pass id。 OutPortId 该 output port 的 id。 DrvBkRefFifoQ_cnt 该 OutputPort 的 DrvBkRefFifoQueue(驱动预处理队列,目前没用到)里的 buffer 数目。 DrvBkRefFifoQ_size 该 OutputPort 的 DrvBkRefFifoQueue(驱动预处理队列,目前没用到)里的 buffer 的总 size。 UsrGetFifoQ_cnt 该 OutputPort 的UsrGetFifoBufQueue(用户获取output port buf的队列) 里的 buffer 数目。 UsrGetFifoQ_size 该 OutputPort 的UsrGetFifoBufQueue(用户获取output port buf的队列) 里的 buffer的总 size。
5.5. mi_dump_buffer_delay_worker¶
5.5.1. cat¶
-
调试信息
# cat /proc/mi_modules/mi_dump_buffer_delay_worker delay_worker_id module_name force_stop dev_id chn_id port_type port_id Queue_name 0 mi_disp 0 0 0 inport 0 BindInput stored_dir dump_method dump_method_value /mnt bunfnum 2
-
调试信息分析
/proc/mi_modules/mi_dump_buffer_delay_worker 文件是和 mi_modulenamedevid相连的一个概念,dump device 里的 Queue 里的 buffer 采用的是 delay worker 的方式实现的,可以通过对mi_dump_buffer_delay_worker 的 cat 操作查看还有哪些 delay worker 正在进行中,echo force_stop_dump delay_worker_id 强制结束指定的一个 delay worker 过程。
-
参数说明
参数 描述 delay_worker_id 该 delay worker 的 id。如果 delay worker 完成的话,该 id 会回收,给后续其他的 delay worker 作为 id 使用。 module_name 该 delay worker 所对应的 module 的 id。 force_stop 该 delay worker 当前是否处于强制结束阶段,1 表示已经被设置了强制结束,0 表示未被设置。 dev_id 该 delay worker 所对应的 device id。 chn_id 该 delay worker 所对应的 channel id。 port_type 该 delay worker 所对应的 port 的 type,是 input port或outputport。 port_id 该 delay worker 所对应的 port 的 id。 Queue_name 该 delay worker 所对应的 Queue 的 name。 stored_dir 该 delay worker 所对应的要 dump 的 data 所要存放的绝对路径(不含最终存放的文件名)。 dump_method 该 delay worker 所对应的 dump 方法: bufnum 或 time 或 start。 dump_method_value Dump 方法所对应的值。
5.5.2. echo¶
功能 | 强制结束 delay worker |
---|---|
命令 | echo force_stop_dump [WorkID] >/proc/mi_modules/mi_dump_buffer_delay_worker |
参数说明 | [WorkID]:delay_work 的 ID |
举例 | echo force_stop_dump 0 > /proc/mi_modules/mi_dump_buffer_delay_worker 强制停止 delay_work 0 |
5.6. debug_level¶
5.6.1. cat/echo¶
-
调试信息
# cat /proc/mi_modules/mi_sys/debug_level 2
-
调试信息分析
为了控制打印级别,每个module(包括sys)都有各自的debug level,分别由/proc/mi_modules/mi_modulename/debug_level控制,其中disp, rgn等为modulename。上面以/proc/mi_modules/mi_sys/debug_level为例。
功能 打印debug警告级别命令 cat /proc/mi_modules/[ModuleName]/debug_level 参数说明 [ModuleName] 模块的名字
mi_disp / mi_gfx / mi_rgn / mi_vdec / mi_vpe / mi_ai / mi_divp
mi_shadow / mi_vdisp / mi_ao / mi_hdmi / mi_sys / mi_venc / mi_bar / mi_vif举例 cat /proc/mi_modules/mi_sys/debug_level
2
mi_sys 的debug警告级别为2(显示warning和error的信息)功能 修改警告级别命令 echo [Level] > /proc/mi_modules/[ModuleName]/debug_level 参数说明 [Level]
0 无Debug信息 (MI_DBG_NONE)
1 只显示error的信息 (MI_DBG_ERR)
2 显示level<=2的信息 (MI_DBG_WRN)
3 显示level<=3的信息 (MI_DBG_API)
4 显示level<=4的信息 (MI_DBG_KMSG)
5 显示level<=5的信息 (MI_DBG_INFO)
6 显示level<=6的信息 (MI_DBG_DEBUG)
7 显示 level<=7的信息 (MI_DBG_TRACE)
8 显示所有信息 (MI_DBG_ALL)
[ModuleName] 模块的名字
mi_disp / mi_gfx / mi_rgn / mi_vdec / mi_vpe / mi_ai / mi_divp
mi_shadow / mi_vdisp / mi_ao / mi_hdmi / mi_sys / mi_venc / mi_bar / mi_vif举例 echo 1 > /proc/mi_modules/mi_vdec/debug_level
将mi_vdec 模块的警告级别修改为只显示error的信息
5.7. debug_file¶
5.7.1. echo¶
-
调试信息
# echo mi_sys_impl.c > /proc/mi_modules/mi_sys/debug_file
-
调试信息分析
用于debug时使能文件mi_sys_impl.c里的所有level等级的DBG log信息都可以在串口打印。
-
参数说明
参数 描述 命令 echo [fileName] … > /proc/mi_modules/mi_xxx/debug_file
表示运行时使能打印函数fileName里的所有level等级的DBG log信息,可以同时使能多个函数,函数之间用空格隔开。
echo > /proc/mi_modules/mi_xxx/debug_file
表示关闭之前已打开的函数fileName的所有level等级的打印功能,此时函数fileName里的DBG log打印只能按/proc/mi_modules/mi_xxx/debug_level设置的等级打印。
注:fileName必须属于对应的mi_xxx模块。参数说明 [mi_xxx] 表示MI模块名称,可取:
mi_disp / mi_gfx / mi_rgn / mi_vdec / mi_vpe / mi_ai / mi_divp
mi_shadow / mi_vdisp / mi_ao / mi_hdmi / mi_sys / mi_venc / mi_bar / mi_vif
5.8. debug_func¶
5.8.1. echo¶
-
调试信息
# echo MI_SYS_IMPL_Init > /proc/mi_modules/mi_sys/debug_func
-
调试信息分析
用于debug时使能函数MI_SYS_IMPL_Init()里的所有level等级的DBG log信息都可以在串口打印。
-
参数说明
参数 描述 命令 echo [funcName] … > /proc/mi_modules/mi_xxx/debug_func
表示运行时使能打印函数funcName里的所有level等级的DBG log信息,可以同时使能多个函数,函数之间用空格隔开。
echo > /proc/mi_modules/mi_xxx/debug_func
表示关闭之前已打开的函数funcName的所有level等级的打印功能,此时函数funcName里的DBG log打印只能按/proc/mi_modules/mi_xxx/debug_level设置的等级打印。
注:funcName必须属于对应的mi_xxx模块。参数说明 [mi_xxx] 表示MI模块名称,可取:
mi_disp / mi_gfx / mi_rgn / mi_vdec / mi_vpe / mi_ai / mi_divp
mi_shadow / mi_vdisp / mi_ao / mi_hdmi / mi_sys / mi_venc / mi_bar / mi_vif
5.9. module_version_file¶
5.9.1. cat¶
-
调试信息
# cat /proc/mi_modules/mi_ai/module_version_file Sigmastar Module mi_ai version: project_commit.141b015 sdk_commit.0864fc2 build_time.20211026144648 # cat /proc/mi_modules/mi_global_info ….. Sigmastar Module mi_sys version: project_commit.141b015 sdk_commit.0864fc2 build_time.20211028104230 …..
-
调试信息分析
module_version_file提供了一份version信息, /proc/mi_modules/mi_global_info里我们也提供了一份version信息,不过其本质上指的是mi_sys模块的version信息, 上面只是以mi_ai 和 mi_global_info 为例子,每个模块都有自己对应的version file。
-
参数说明
参数 描述 Version Info project_commit 模块编译ko时的整包project commit,如果单独替换ko,模块基于的commit有变化,ko version里得到的commit也会变更。 sdk_commit 模块编译ko时的整包sdk commit,如果单独替换ko,模块基于的commit有变化,ko version里得到的commit也会变更。 build_time 实际的build时间,精确到秒,即使make clean;make image整体来build的话,各个ko的时间也会有差别。
5.10. show threads¶
5.10.1. echo¶
-
调试信息
# echo show_threads > /proc/mi_modules/mi_sys/mi_sys0 [<c02472f5>] (__schedule) from [<c02473f3>] (schedule+0x57/0x64) [<c02473f3>] (schedule) from [<c001d8a1>] (do_wait+0xf1/0x128) [<c001d8a1>] (do_wait) from [<c001dc73>] (kernel_wait4+0x4b/0xcc) [<c001dc73>] (kernel_wait4) from [<c001dd01>] (sys_wait4+0xd/0x68) [<c001dd01>] (sys_wait4) from [<c0009001>] (ret_fast_syscall+0x1/0x64) Exception stack(0xc2a51fa8 to 0xc2a51ff0) 1fa0: 00000000 000b1c65 ffffffff 00000000 00000000 00000000 1fc0: 00000000 000b1c65 b6f300c0 00000072 0000008f 000003b2 00000000 00000000 1fe0: 00000072 bee0dc98 b6e21e57 b6dc5886 [<c02472f5>] (__schedule) from [<c02473f3>] (schedule+0x57/0x64) [<c02473f3>] (schedule) from [<c002c7d5>] (kthreadd+0x65/0xfc) [<c002c7d5>] (kthreadd) from [<c0009101>] (ret_from_fork+0x11/0x30) Exception stack(0xc2a59fb0 to 0xc2a59ff8) 9fa0: 00000000 00000000 00000000 00000000 9fc0: 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 9fe0: 00000000 00000000 00000000 00000000 00000013 00000000
-
调试信息分析
查看当前所有线程的 call stack 状态。
-
该命令可以帮组查询&定位死锁问题。
-
该命令打印较多,最好放在kmsg中打印,以免被其他信息污染。
-
-
参数说明
参数 描述 show_threads Exception stack 线程对应的部分stack信息。
5.11. debug_frc¶
5.11.1. echo¶
-
调试信息
# echo debug_frc on 12 0 0 0 0 "out" > /proc/mi_modules/mi_sys/mi_sys0
-
调试信息分析
printk in _MI_SYS_IMPL_Common_WriteProc,
Switch enable debug FRC, Modid:12, Dev:0, Chn:0, Pass:0, Port:0, BufType:1,使能帧率控制debug开关
-
参数说明
参数 描述 命令 Switch enable debug FRC:
echo debug_frc on [Modid] [Devid] [Chnid] [Passid] [Portid] [in/out] > /proc/mi_modules/mi_sys/mi_sys0
打开帧率控制debug开关
Switch disable debug FRC:
echo debug_frc off > /proc/mi_modules/mi_sys/mi_sys0
关闭帧率控制debug开关参数说明 [Modid] : module id
[Devid] : device id
[Chnid] : channel id
[Passid] : pass id
[Portid] : port id
[in/out] : input/output方向
5.12. set_outputport_depth¶
5.12.1. echo¶
-
调试信息
# echo set_ouputport_depth 6 0 0 0 0 0 2 4 > /proc/mi_modules/mi_sys/mi_sys0
-
参数说明
参数 描述 命令 Set output port depth:
echo set_ouputport_depth [Modid] [Devid] [Chnid] [Passid] [Portid] [u32userFrameDepth] [u32BufQueueDepth] > /proc/mi_modules/mi_sys/mi_sys0参数说明 [Modid] : module id
[Devid] : device id
[Chnid] : channel id
[Passid] : pass id
[Portid] : port id
[u32userFrameDepth]: 设置该output用户可以拿到的buf最大数量
[u32BufQueueDepth]: 设置该output系统buf最大数量
5.13. set_thread_priority¶
5.13.1. echo¶
-
调试信息
# echo set_thread_priority 12 0 99 > /proc/mi_modules/mi_sys/mi_sys0
-
参数说明
参数 描述 命令 Set work_thread_priority by module id:
echo set_thread_priority [Modid] [Devid] [u32Priority] > /proc/mi_modules/mi_sys/mi_sys0参数说明 [Modid]: module id
[Devid]: device id
[u32Priority]: 需要设定的线程等级
5.14. miu_protect¶
5.14.1. cat¶
-
调试信息
# cat /proc/mi_modules/mi_sys_mma/miu_protect =================== start miu_protect_info ========================= LX : cpu_start_addr:0x20000000 size:0x7fe0000 miu_index miuBlockIndex start_cpu_bus_pa length 0x0 0x00 0x20000000 0x2fe0000 KernelProtect IP white list: clientId name 112 CPU 10 MCU51 38 USB20_H 8 USB20 3 USB30 39 MIIC2 40 MIIC1 46 MIIC0 9 EMAC 30 SD30 31 SDIO30 7 AESDMA 11 URDMA 12 BDMA 13 MOVDMA 0x0 0x01 0x23144000 0x1c000 KernelProtect IP white list: clientId name 112 CPU 10 MCU51 38 USB20_H 8 USB20 3 USB30 39 MIIC2 40 MIIC1 46 MIIC0 9 EMAC 30 SD30 31 SDIO30 7 AESDMA 11 URDMA 12 BDMA 13 MOVDMA
-
调试信息分析
该命令显示了miu protect相关的信息。
-
参数分析
参数 描述 LX
(以只有一个LX为例,LX表示linux 镜像对应的memory)cpu_start_addr 该LX对应的起始CPU addr。 size 该LX对应的size。 某个kernel protect 的range的相关信息 miu_index 编号。 miuBlockIndex 总共4个miu范围的编号信息。 start_cpu_bus_pa 该range的起始cpu bus addr。 length 该range的length。 KernelProtect IP white list clientId Miu protect的IP白名单里的IP的id(从未分group的角度看的全局id)。 name 与clientId对应的该IP的实际的名字。
5.15. imi_mma_heap¶
5.15.1. cat¶
-
调试信息
# cat /proc/mi_modules/mi_sys_mma/imi_mma_heap mma heap name heap_base_cpu_bus_addr length chunk_mgr_avail mmuEnable addsize_before addsize_after bMmuDelayUnmap imi_mma_heap 20000000 43800 43800 0 0 0 0 chunk_mgr info: offset length avail 0 43800 43800 each chunk info: offset length used_flag task_name pid Module 0 43800 0 NA -1 mi_sys
-
调试信息分析
该cat信息对应的是该mma heap的基本信息和当前的一些状态。
-
参数分析
参数 描述 heap basic info mma heap name mma heap 的 name heap_base_cpu_bus_addr heap的起始cpu bus addr length heap 的 length chunk_mgr_avail heap 里的剩余的未用的 memory 的总量 mmuEnable Mma heap 是否支持 HW_MMU。该值为 1 表示支持,为 0 表示不支持 chunk_mgr info offset chunk mgr 的 offset,由于整个 mma heap 做为一个 chunk mgr,因此该值永远为 0。allocator里的逻辑offset。 length chunk mgr 的 length,由于整个 mma heap 做为一个 chunk mgr,因此该值永远为 mma heap length。 avail chunk mgr (即heap)里空闲的memory的总量 each chunk info (chunk mgr 里各 chunk 的信息和使 用情况) offset 该 chunk 在 chunk mgr 里的 offset length 该 chunk 的 length used_flag 该 chunk 是否被 alloc 出去使用了。是的话该值为 1;否则 free 状态的话该值为 0。 task_name 如果 used flag 为 1,则 task_name里存的是哪个 task 使用的它;否则该值为无效值 NA。 pid 该 chunk 所属的current->tgid Module 该 chunk 所属的模块
5.16. mem_stat¶
5.16.1. cat¶
-
调试信息
# cat /proc/mi_modules/mi_sys_mma/mem_stat mi_sys CMDMEM c0000 sys-logBuffer 40000 sys-logConfig 1000 TotalSize 101000 AllTotalSize 101000
-
调试信息分析
打印出mi sys 内存状态。
-
参数说明
参数 描述 Mem_stat mi_sys 所属mi_sys模块 CMDMEM Cmd的内存大小 sys-logBuffer Sys log最大可申请的buf大小 sys-logConfig 分配(申请)给sys log的buf大小 TotalSize ModuleUsdTotalSize 模块使用的size AllTotalSize 总的size