MI SCL API

REVISION HISTORY¶

Revision No.	Description	Date
3.0	Initial release	12/04/2020
3.1	Added Muffin flow chart	07/25/2021
	Added PROCFS introduction	08/25/2021
3.2	Added Mochi info	02/17/2022
3.3	Added MI_SCL_StretchBufOsd Info Added PROCFS debug cmd	03/21/2022
3.4	Added Maruko information	03/22/2022
3.5	In Section 5.2 add debug CMD:ptsth/resethw/cmdqtimeout/outputfilter	08/03/2022
3.6	In Section 2.15 add MI_SCL_StretchBuf demo	09/09/2022
3.7	Added Opera info In Section 1.2 modified the expression of Device Id to make it easier to understand	10/28/2022
3.8	In Section 5.2 add debug CMD:cmdqdelay/doublevsyncdrop	12/01/2022

1. 概述¶

1.1. 模块说明¶

SCL将原始画面缩放到各个output port 指定分辨率。每个scl按照输入数据源的类型划分成不同的Device，每一个output port 端口有crop/scaling/mirror/flip/pixel 转换功能。

1.2. 流程框图¶

1.2.1. Tiramisu¶

图1‑1：Tiramisu框图

Tiramisu MI_SCL 总共有6个scl 硬件，按照输入源的类型，划分成不同的Device。

Device Id	Input port输入源类型
MI_SCL_DEV_ISP_REALTIME0	只支持和MI_ISP output port0 realtime 连接
MI_SCL_DEV_RDMA0	支持Frame mode从Dram读取数据支持MI_JPD realtime 绑定
MI_SCL_DEV_VIF_REALTIME0	只支持和MI_VIF YUV Realtime 连接
MI_SCL_DEV_DIPR0	只支持Frame mode从Dram读取数据只可以使用E_MI_SCL_HWSCL5 支持Rotation, 做rotation的时候功能限制见MI_SCL_SetChnParam

1.2.2. Muffin¶

图1‑2：Muffin框图

Muffin MI_SCL 总共有9个scl 硬件，按照输入源的类型，划分成不同的Device。

Device Id	Input port输入源类型
MI_SCL_DEV_ISP_REALTIME0	只支持和MI_ISP device0 output port0 realtime 连接
MI_SCL_DEV_RDMA0	支持Frame mode从Dram读取数据，支持MI_JPD realtime 绑定
MI_SCL_DEV_VIF_REALTIME0	只支持和MI_VIF device8 YUV Realtime 连接
MI_SCL_DEV_DIPR0	只支持Frame mode从Dram读取数据，只可以使用E_MI_SCL_HWSCL8, 支持Rotation, 做rotation的时候功能限制见MI_SCL_SetChnParam
MI_SCL_DEV_ISP_REALTIME1	只支持和MI_ISP device1 output port0 realtime 连接
MI_SCL_DEV_RDMA2	支持Frame mode从Dram读取数据，支持MI_JPD realtime 绑定
MI_SCL_DEV_VIF_REALTIME1	只支持和MI_VIF device24 YUV Realtime 连接

1.2.3. Mochi¶

图1‑3：Mochi框图

Mochi MI_SCL 总共有7个scl 硬件，按照输入源的类型，划分成不同的Device。

Device Id	Input port输入源类型
MI_SCL_DEV_ISP_REALTIME0	只支持和MI_ISP output port0 realtime 连接
MI_SCL_DEV_RDMA0	支持Frame mode从Dram读取数据，支持MI_JPD realtime 绑定

1.2.4. Maruko¶

图1‑4：Maruko框图

Maruko MI_SCL 总共有4个scl 硬件，按照输入源的类型，划分成不同的Device。

Device Id	Input port输入源类型
MI_SCL_DEV_ISP_REALTIME0	只支持和MI_ISP output port0 realtime 连接
MI_SCL_DEV_RDMA0	支持Frame mode从Dram读取数据
MI_SCL_DEV_VIF_REALTIME0	只支持和MI_VIF output port0 yuv 格式realtime 连接

1.2.5. Opera¶

图1‑5：Opera框图

Opera MI_SCL 总共有4个scl 硬件，按照输入源的类型，划分成不同的Device。

Device Id	Input port输入源类型
MI_SCL_DEV_ISP_REALTIME0	只支持和MI_ISP output port0 realtime 连接
MI_SCL_DEV_RDMA0	支持Frame mode从Dram读取数据，支持MI_JPD realtime 绑定
MI_SCL_DEV_VIF_REALTIME0	只支持和MI_VIF output port0 yuv 格式realtime 连接
MI_SCL_DEV_DIPR0	只支持Frame mode从Dram读取数据，只可以使用E_MI_SCL_HWSCL3
MI_SCL_DEV_DIPR1	只支持Frame mode从Dram读取数据，只可以使用E_MI_SCL_HWSCL1, 支持Rotation, 做rotation的时候功能限制见MI_SCL_SetChnParam
MI_SCL_DEV_HVP_REALTIME0	只支持和MI_HVP realtime 连接，只可以使用E_MI_SCL_HWSCL3, 不支持放大

1.3. 关键字说明¶

Device

Device 由固定的input 类型，和用户分配的HWSclId 组成。
Channel

一个Device可以分时复用为多个通道，每个通道为一个channel。
Input Port

Channel上的输入端口，每个Device支持的输入类型请参考流程框图。
Output Port

Device上的输出端口，输出端口和Device 的HWSclId 一一对应。
Crop

裁剪，对图像进行裁剪。
Scaling

缩放，对图像进行缩小或放大处理。
Compress

压缩模式，对数据进行压缩传输，节省带宽。

1.4. 规格说明¶

‘\’ 与 ‘N’ 均为不支持该功能。

模块功能规格

Function	Tiramisu	Mochi	Muffin	Maruko	Opera
Dev Number	4	2	7	3	5
Chn Number	32	32	32	32	16
Port Number	6	7	9	4	4
InputCrop	Y	Y	Y	Y	Y
Rotation	Y	N	Y	N	Y
mirror	Y	Y	Y	Y	Y
flip	Y	Y	Y	Y	Y
OutPutCrop	Y	Y	Y	Y	Y
Scaling	Y	Y	Y	Y	Y
Compress	N	Y	N	Y	Y
Max Pixel Rate	4k30	4K60	4K60	4k30	6M30

输入规格

Input		Tiramisu	Mochi	Muffin	Maruko	Opera
pixel	ARGB8888	Y	Y	Y	Y	Y
	ABGR8888	Y	Y	Y	Y	Y
	BGRA8888	Y	Y	Y	Y	Y
	yuv420SP NV12	Y	Y	Y	Y	Y
	yuv420SP NV21	Y	Y	Y	Y	Y
	yuv420 Planer	Y	Y	Y	Y	Y
	yuv422 YUYV	Y	Y	Y	Y	Y
	yuv422 YVYU	Y	Y	Y	Y	Y
	YUV422 VYUY	Y	Y	Y	Y	Y
	yuv422 UYVY	Y	Y	Y	Y	Y
	yuv422 SP	Y	Y	Y	Y	Y
	yuv422 Planer	Y	Y	Y	Y	Y
Crop		Y	Y	Y	Y	Y
CompressMode	NONE	Y	Y	Y	Y	Y
CompressMode	10TO6	N	Y	N	Y	Y
resolution	MAX Width	4096	4096	8192	3840	2688
resolution	MIN WxH	16x16	16x16	16x16	16x16	16x16
Pixel Alignment (rot source不区分pixel)	YUV Pack	8x2	2x2	2x2	2x2	2x2
	YUV SP	16x2	2x2	2x2	2x2	2x2
	YUV Planer	32x2	2x2	2x2	2x2	2x2
	ARGB	4x2	2x2	2x2	2x2	2x2
	Rot source	2x2	NA	2x2	NA	2x2

输出规格

Output		Tiramisu	Mochi	Muffin	Maruko	Opera
pixel	ARGB8888	Y	Y	Y	Y	Y
	ABGR8888	Y	Y	Y	Y	Y
	BGRA8888	Y	Y	Y	Y	Y
	yuv420SP NV12	Y	Y	Y	Y	Y
	yuv420SP NV21	Y	Y	Y	Y	Y
	yuv420 Planer	Y	Y	Y	Y	Y
	yuv422 YUYV	Y	Y	Y	Y	Y
	yuv422 YVYU	Y	Y	Y	Y	Y
	YUV422 VYUY	Y	Y	Y	Y	Y
	yuv422 UYVY	Y	Y	Y	Y	Y
	yuv422 SP	Y	Y	Y	Y	Y
	yuv422 Planer	Y	Y	Y	Y	Y
CompressMode	NONE	Y	Y	Y	Y	Y
	10TO6	N	Y	N	Y	Y
	IFC	N	N	N	Y	Y
Crop		Y	Y	Y	Y	Y
Scaling		Y	Y	Y	Y	Y
Mirror		Y	Y	Y	Y	Y
Flip		Y	Y	Y	Y	Y
Rotation		Y	N	Y	N	Y
Frame mode		Y	Y	Y	Y	Y
Realtime_JPEG		Y	Y	N	Y	Y
Ring_H26x		Y	Y	Y	N	N
HalfRing_H26x		Y	Y	Y	N	N
MulitRing_H26x		N	N	N	Y(只有HWSCL0支持)	Y(只有HWSCL0支持)
YUV420 MAX Width	SCL0	4608	4096	7680	3840	2688
	SCL1	4608	4096	7680	3840	2688
	SCL2	4096	3840	3840	1920	1920
	SCL3	4096	1920	1920	1920	2688
	SCL4	4096	1280	7680	\	\
	SCL5	4096	1280	7680	\	\
	SCL6	\	4096	3840	\	\
	SCL7	\	\	1920	\	\
	SCL8	\	\	8192	\	\
	SCL9	\	\	\	\	\
Pixel Alignment (不区分pixel)	Width	2	2	2	2	2
Pixel Alignment (不区分pixel)	Height	2	2	2	2	2

2. API 参考¶

该功能模块提供以下API:

API名	功能
MI_SCL_CreateDevice	创建SCL设备
MI_SCL_DestroyDevice	销毁SCL设备
MI_SCL_CreateChannel	创建SCL 通道
MI_SCL_DestroyChannel	销毁SCL 通道
MI_SCL_SetChnParam	设置通道属性
MI_SCL_GetChnParam	获取通道属性
MI_SCL_SetInputPortCrop	设置通道input 端口crop
MI_SCL_GetInputPortCrop	获取通道input端口crop 信息
MI_SCL_StartChannel	启动通道
MI_SCL_StopChannel	禁用通道
MI_SCL_SetOutputPortParam	设置output 端口参数
MI_SCL_GetOutputPortParam	获取output 端口参数
MI_SCL_EnableOutputPort	使能output 端口
MI_SCL_DisableOutputPort	禁用output 端口
MI_SCL_StretchBuf	缩放、拉伸、裁剪指定内存中的图像数据
MI_SCL_StretchBufOsd	在缩放、拉伸、裁剪指定内存中的图像数据基础上叠加OSD图像数据

2.1. MI_SCL_CreateDevice¶

功能

创建一个SCL设备。

语法

MI_S32 MI_SCL_CreateDevice(MI_SCL_DEV DevId, MI_SCL_DevAttr_t *pstSclDevAttr)

形参

参数名称描述输入/输出

DevId SCL 设备号。输入

pstSclDevAttr Scl 设备属性。输入
返回值
- MI_SUCCESS(0)：成功。
- 非0：失败，详情参照错误码。
依赖
- 头文件：mi_scl_datatype.h、mi_scl.h
- 库文件：
注意
- 每个Device的特性参考1.2章节中注意说明。

举例

MI_SCL 初始化流程：

MI_S32 ST_SclModuleInit(MI_SCL_DEV SclDevId)
{
    #define ST_MAX_ISP_OUTPORT_NUM (6) //Muffin (9), Tiramisu (6)
    MI_SCL_CHANNEL SclChnId = 0;
    MI_SCL_PORT  SclOutPortId =0;

    MI_SCL_DevAttr_t stCreateDevAttr;
    memset(&stCreateDevAttr, 0x0, sizeof(MI_SCL_DevAttr_t));
    stCreateDevAttr.u32NeedUseHWOutPortMask=E_MI_SCL_HWSCL2|E_MI_SCL_HWSCL3| E_MI_SCL_HWSCL4;
    MI_SCL_CreateDevice(SclDevId, &stCreateDevAttr);

    MI_SCL_ChannelAttr_t  stSclChnAttr;
    memset(&stSclChnAttr, 0x0, sizeof(MI_SCL_ChannelAttr_t));

    MI_SCL_CreateChannel(SclDevId, SclChnId, &stSclChnAttr);

    MI_SYS_WindowRect_t  stCropInfo;
    stCropInfo.u16x=0;
    stCropInfo.u16y=0;
    stCropInfo.u16Width=0;
    stCropInfo.u16Height=0;//width/height use 0, not use crop
    MI_SCL_SetInputPortCrop(SclDevId, SclChnId, & stCropInfo);

    MI_SCL_ChnParam_t  stSclChnParam;
    memset(&stSclChnParam, 0x0, sizeof(MI_SCL_ChnParam_t));
    stSclChnParam.eRot = E_MI_SYS_ROTATE_NONE;
    MI_SCL_SetChnParam(SclDevId, SclChnId, &stSclChnParam);

    MI_SCL_StartChannel(SclDevId, SclChnId);

    for(SclOutPortId=0; SclOutPortId<ST_MAX_SCL_OUTPORT_NUM; SclOutPortId++)
    {
        MI_SCL_OutPortParam_t  stSclOutputParam;
        memset(&stSclOutputParam, 0x0, sizeof(MI_SCL_OutPortParam_t));
        stSclOutputParam. stSCLOutCropRect.u16x=0;
        stSclOutputParam. stSCLOutCropRect.u16x=0;
        stSclOutputParam. stSCLOutCropRect.u16Width =0;
        stSclOutputParam. stSCLOutCropRect.u16Height =0;
        //width/height use 0, not use crop
        stSclOutputParam. stSCLOutputSize.u16Width=1920;
        stSclOutputParam. stSCLOutputSize.u16Height=1080;
        stSclOutputParam.ePixelFormat = E_MI_SYS_PIXEL_FRAME_YUV_SEMIPLANR_420;
        stSclOutputParam.bMirror =FALSE;
        stSclOutputParam.bFlip =FALSE;
        MI_SCL_SetOutputPortParam(SclDevId, SclChnId, SclOutPortId, &stSclOutputParam);
        MI_SCL_EnableOutputPort(SclDevId, SclChnId, SclOutPortId);
    }

    return MI_SUCCESS;
}

MI_SCL 去初始化流程：

MI_S32 ST_SclModuleUnInit(MI_SCL_DEV SclDevId)
{
    #define ST_MAX_SCL_OUTPORT_NUM (6) //Muffin (9), Tiramisu (6)
    MI_SCL_CHANNEL SclChnId = 0;
    MI_SCL_PORT  SclOutPortId =0;

    for(SclOutPortId=0; SclOutPortId<ST_MAX_SCL_OUTPORT_NUM; SclOutPortId++)
    {
        MI_SCL_DisableOutputPort(SclDevId, SclChnId, SclOutPortId);
    }

    MI_SCL_StopChannel(SclDevId, SclChnId);
    MI_SCL_DestroyChannel(SclDevId, SclChnId);

    MI_SCL_DestroyDevice(SclDevId);

    return MI_SUCCESS;
}

2.2. MI_SCL_DestroyDevice¶

功能

销毁一个SCL 设备。

语法

MI_S32 MI_SCL_DestroyDevice(MI_SCL_DEV DevId)

形参

参数名称描述输入/输出

DevId SCL 设备号输入
返回值
- MI_SUCCESS(0)：成功。
- 非0：失败，详情参照错误码。
依赖
- 头文件：mi_scl_datatype.h、mi_scl.h
- 库文件：
注意

需要先禁用掉设备上所有的输出端口和通道，否则会返回失败。
举例

参考 MI_SCL_CreateDevice举例。
相关主题

MI_SCL_CreateDevice

2.3. MI_SCL_CreateChannel¶

功能

设备上创建一个通道。

语法

MI_S32 MI_SCL_CreateChannel(MI_SCL_DEV DevId, MI_SCL_CHANNEL ChnId, MI_SCL_ChannelAttr_t *pstChnAttr)

形参

参数名称描述输入/输出

DevId SCL 设备号输入

ChnId SCL 通道号，取值范围(0~31)。输入

pstChnAttr SCL 通道属性输入
返回值
- MI_SUCCESS(0)：成功。
- 非0：失败，详情参照错误码。
依赖
- 头文件：mi_scl_datatype.h、mi_scl.h
- 库文件：
注意

需要先创建设备才能创建通道。
举例

参考 MI_SCL_CreateDevice举例。
相关主题

MI_SCL_DestroyChannel

2.4. MI_SCL_DestroyChannel¶

功能

销毁设备上的一个通道。

语法

MI_S32 MI_SCL_DestroyChannel(MI_SCL_DEV DevId, MI_SCL_CHANNEL ChnId)

形参

参数名称描述输入/输出

DevId SCL 设备号输入

ChnId SCL 通道号输入
返回值
- MI_SUCCESS(0)：成功。
- 非0：失败，详情参照错误码。
依赖
- 头文件：mi_scl_datatype.h、mi_scl.h
- 库文件：
注意

需要关掉通道上的所有输出端口，才能销毁通道。
举例

参考 MI_SCL_CreateDevice举例。
相关主题

MI_SCL_CreateChannel

2.5. MI_SCL_SetChnParam¶

功能

动态设置通道参数。

语法

MI_S32 MI_SCL_SetChnParam(MI_SCL_DEV DevId, MI_SCL_CHANNEL ChnId, MI_SCL_ChnParam_t *pstChnParam)

形参

参数名称描述输入/输出

DevId SCL 设备号输入

ChnId SCL 通道号输入

pstChnParam 通道参数输入
返回值
- MI_SUCCESS(0)：成功。
- 非0：失败，详情参照错误码。
依赖
- 头文件：mi_scl_datatype.h、mi_scl.h
- 库文件：
注意
- 通道已经在运行的情况下，需要改变通道参数，需要先使用MI_SCL_StopChannel将通道停下，清除缓存数据。
举例

参考 MI_SCL_CreateDevice举例。
相关主题

MI_SCL_GetChnParam

2.6. MI_SCL_GetChnParam¶

功能

获取通道参数。

语法

MI_S32 MI_SCL_GetChnParam(MI_SCL_DEV DevId, MI_SCL_CHANNEL ChnId, MI_SCL_ChnParam_t *pstChnParam)

形参

参数名称描述输入/输出

DevId SCL 设备号输入

ChnId SCL 通道号输入

pstChnParam SCL 通道参数输出
返回值
- MI_SUCCESS(0)：成功。
- 非0：失败，详情参照错误码。
依赖
- 头文件：mi_scl_datatype.h、mi_scl.h
- 库文件：
注意

在没有设置的情况下，获取到的参数都为0。
相关主题

MI_SCL_SetChnParam

2.7. MI_SCL_SetInputPortCrop¶

功能

在输入端口设置裁剪区域。

语法

MI_S32 MI_SCL_SetInputPortCrop(MI_SCL_DEV DevId, MI_SCL_CHANNEL ChnId, MI_SYS_WindowRect_t *pstCropInfo)

形参

参数名称描述输入/输出

DevId SCL 设备号输入

ChnId SCL 通道号输入

pstCropInfo 裁剪区域输入
返回值
- MI_SUCCESS(0)：成功。
- 非0：失败，详情参照错误码。
依赖
- 头文件：mi_scl_datatype.h、mi_scl.h
- 库文件：
注意
- 只有输入端口是从DRAM 读取数据时，该设置才能生效。
- 当输入数据压缩模式不为E_MI_SYS_COMPRESS_MODE_NONE 时，输入数据不支持裁剪。
举例

参考 MI_SCL_CreateDevice举例。
相关主题

MI_SCL_GetInputPortCrop

2.8. MI_SCL_GetInputPortCrop¶

功能

获取通道输入端口裁剪区域。

语法

MI_S32 MI_SCL_GetInputPortCrop(MI_SCL_DEV DevId, MI_SCL_CHANNEL ChnId, MI_SYS_WindowRect_t *pstCropInfo)

形参

参数名称描述输入/输出

DevId SCL 设备号输入

ChnId SCL 通道号输入

pstCropInfo 裁剪区域输出
返回值
- MI_SUCCESS(0)：成功。
- 非0：失败，详情参照错误码。
依赖
- 头文件：mi_scl_datatype.h、mi_scl.h
- 库文件：
注意

当不需要裁剪时，获取到的是输入端口分辨率
相关主题

MI_SCL_SetInputPortCrop

2.9. MI_SCL_StartChannel¶

功能

启用设备上的一个通道。

语法

MI_S32 MI_SCL_StartChannel(MI_SCL_DEV DevId, MI_SCL_CHANNEL ChnId)

形参

参数名称描述输入/输出

DevId SCL 设备号输入

ChnId SCL 通道号输入
返回值
- MI_SUCCESS(0)：成功。
- 非0：失败，详情参照错误码。
依赖
- 头文件：mi_scl_datatype.h、mi_scl.h
- 库文件：
注意

和MI_SCL_StopChannel成对调用。
举例

参考MI_SCL_CreateDevice举例。
相关主题

MI_SCL_StopChannel

2.10. MI_SCL_StopChannel¶

功能

停用设备上的一个通道。

语法

MI_S32 MI_SCL_StopChannel(MI_SCL_DEV DevId, MI_SCL_CHANNEL ChnId)

形参

参数名称描述输入/输出

DevId SCL 设备号输入

ChnId SCL 通道号输入
返回值
- MI_SUCCESS(0)：成功。
- 非0：失败，详情参照错误码。
依赖
- 头文件：mi_scl_datatype.h、mi_scl.h
- 库文件：
注意

在通道创建的情况下，都可以停下通道，通道停下所有的输出端口都不会有数据输出。
举例

参考 MI_SCL_CreateDevice举例。
相关主题

MI_SCL_StartChannel

2.11. MI_SCL_SetOutputPortParam¶

描述

设置通道输出端口参数。

语法

MI_S32 MI_SCL_SetOutputPortParam(MI_SCL_DEV DevId, MI_SCL_CHANNEL ChnId, MI_SCL_PORT PortId, MI_SCL_OutPortParam_t *pstOutPortParam)

参数

参数名称描述输入/输出

DevId SCL 设备号输入

ChnId SCL 通道号输入

PortId 输出端口号输入

pstOutPortParam 输出端口参数输入
返回值
- MI_SUCCESS(0)：成功。
- 非0：失败，详情参照错误码。
依赖
- 头文件：mi_scl_datatype.h、mi_scl.h
- 库文件：
注意
- 在输出端口已经启用的情况下，需要改变输出参数，需要先调用MI_SCL_DisableOutputPort禁用端口，再来设置参数，然后再启用输出端口。
- 当VIF->ISP->SCL 均为Realtime绑定时，SCL Output设置Scaling up 存在FIFO FULL 风险，不建议设置Scaling up。
举例

参考 MI_SCL_CreateDevice举例。
相关主题

MI_SCL_GetOutputPortParam

2.12. MI_SCL_GetOutputPortParam¶

描述

获取输出端口参数。

语法

MI_S32 MI_SCL_GetOutputPortParam(MI_SCL_DEV DevId, MI_SCL_CHANNEL ChnId, MI_SCL_PORT PortId, MI_SCL_OutPortParam_t *pstOutPortParam)

参数

参数名称描述输入/输出

DevId SCL 设备号输入

ChnId SCL 通道号输入

PortId SCL 输出端口号输入

pstOutPortParam SCL 输出端口参数输出
返回值
- MI_SUCCESS(0)：成功。
- 非0：失败，详情参照错误码。
依赖
- 头文件：mi_scl_datatype.h、mi_scl.h
- 库文件：
相关主题

MI_SCL_SetOutputPortParam

2.13. MI_SCL_EnableOutputPort¶

描述

使能输出端口。

语法

MI_S32 MI_SCL_EnableOutputPort(MI_SCL_DEV DevId, MI_SCL_CHANNEL ChnId, MI_SCL_PORT PortId)

参数

参数名称描述输入/输出

DevId SCL 设备号输入

ChnId SCL 通道号输入

PortId SCL 输出端口号输入
返回值
- MI_SUCCESS(0)：成功。
- 非0：失败，详情参照错误码。
依赖
- 头文件：mi_scl_datatype.h、mi_scl.h
- 库文件：
注意

和MI_SCL_DisableOutputPort 成对调用。
举例

参考 MI_SCL_CreateDevice举例。
相关主题

MI_SCL_DisableOutputPort

2.14. MI_SCL_DisableOutputPort¶

描述

禁用输出端口。

语法

MI_S32 MI_SCL_DisableOutputPort(MI_SCL_DEV DevId, MI_SCL_CHANNEL ChnId, MI_SCL_PORT PortId)

参数

参数名称描述输入/输出

DevId SCL 设备号输入

ChnId SCL 通道号输入

PortId 输出端口号输入
返回值
- MI_SUCCESS(0)：成功。
- 非0：失败，详情参照错误码。
依赖
- 头文件：mi_scl_datatype.h、mi_scl.h
- 库文件：
注意

和MI_SCL_EnableOutputPort 成对调用。
举例

参考MI_SCL_CreateDevice举例。
相关主题

MI_SCL_EnableOutputPort

2.15. MI_SCL_StretchBuf¶

描述

缩放、拉伸、裁剪指定内存中的图像数据。

语法

MI_S32 MI_SCL_StretchBuf(MI_SCL_DirectBuf_t *pstSrcBuf, MI_SYS_WindowRect_t *pstSrcCrop,MI_SCL_DirectBuf_t *pstDstBuf, MI_SCL_FilterType_e eFilterType)

参数

参数名称	描述	输入/输出
pstSrcBuf	源数据buffer参数指针	输入
pstSrcCrop	源数据裁剪区域	输入
pstDstBuf	输出buffer参数指针	输出
eFilterType	Scl 使用滤波器类型	输入

返回值
- MI_SUCCESS(0)：成功。
- 非0：失败，详情参照错误码。
依赖
- 头文件：mi_scl_datatype.h、mi_scl.h
- 库文件：
注意
- 该接口是阻塞形式，这帧数据做完才会结束。
- 使用该接口前需要设置对应的DEVID，不同系列芯片对应使用的DEVID如下：
  
  芯片 StretchBuf使用的DEVID
  
  Tiramisu Device3
  
  Muffin Device3
  
  Mochi Device1
  
  Maruko Device1
- 输入宽、高的对齐要求：
  
  pixel format width height
  
  YUV420SPNV12, YUV420SPNV21 2 2
  
  YUV422YUYV, YUV422UYVY, YUV422YVYU, YUV422VYUY 2 2
  
  ARGB8888, ABGR8888, BGRA8888 2 2
- 输出宽、高的对齐要求：
  
  pixel format width height
  
  YUV420SPNV12, YUV420SPNV21 2 2
  
  YUV422YUYV, YUV422UYVY, YUV422YVYU, YUV422VYUY 2 2
  
  ARGB8888, ABGR8888, BGRA8888 2 2
- 不同系列芯片对应使用的HWSCL ID
  
  芯片 StretchBuf使用的HWSCL ID
  
  Tiramisu HWSCL5
  
  Muffin HWSCL8
  
  Mochi HWSCL6
  
  Maruko HWSCL3

举例

MI_SCL_StretchBuf使用方法:

int stretchBuffDemo() { MI_S32 s32Ret = 0; char *pInFilePath = "in.yuv"; char *pOutFilePath = "out.yuv";

  MI_SCL_DirectBuf_t  stSrcBuff;
  memset(&stSrcBuff, 0x0, sizeof(MI_SCL_DirectBuf_t));
  stSrcBuff.u32Width = 1920;
  stSrcBuff.u32Height = 1080;
  stSrcBuff.ePixelFormat = E_MI_SYS_PIXEL_FRAME_YUV422_YUYV;
  stSrcBuff.u32Stride[0] = stSrcBuff.u32Width*2;
  stSrcBuff.u32BuffSize = stSrcBuff.u32Stride[0]*stSrcBuff.u32Height;

  MI_SYS_WindowRect_t stoutputCrop;
  memset(&stoutputCrop, 0x0, sizeof(MI_SYS_WindowRect_t));
  stoutputCrop.u16X = 100;
  stoutputCrop.u16Y = 122;
  stoutputCrop.u16Width = 124;
  stoutputCrop.u16Height = 126;

  MI_SCL_DirectBuf_t  stDestBuff;
  memset(&stDestBuff, 0x0, sizeof(MI_SCL_DirectBuf_t));
  stDestBuff.u32Width = 100;
  stDestBuff.u32Height = 110;
  stDestBuff.ePixelFormat = E_MI_SYS_PIXEL_FRAME_YUV422_YUYV;
  stDestBuff.u32Stride[0] = stDestBuff.u32Width*2;
  stDestBuff.u32BuffSize = stDestBuff.u32Stride[0]*stDestBuff.u32Height;

  void *pviraddr = NULL, *pviroutaddr = NULL;
  MI_PHY  phyInAllockAddr = 0, phyOutAllocAddr = 0;

  ExecFuncResult(MI_SYS_Init(0), s32Ret);
  ExecFuncResult(MI_SYS_MMA_Alloc(0, (MI_U8*)"mma_heap_name0", stSrcBuff.u32BuffSize, &phyInAllockAddr), s32Ret);
  ExecFuncResult(MI_SYS_Mmap(phyInAllockAddr, stSrcBuff.u32BuffSize, &pviraddr, FALSE), s32Ret);
  ExecFuncResult(MI_SYS_MMA_Alloc(0, (MI_U8*)"mma_heap_name0", stDestBuff.u32BuffSize, &phyOutAllocAddr), s32Ret);
  ExecFuncResult(MI_SYS_Mmap(phyOutAllocAddr, stDestBuff.u32BuffSize, &pviroutaddr, FALSE), s32Ret);

  stSrcBuff.phyAddr[0] = phyInAllockAddr;
  stDestBuff.phyAddr[0] = phyOutAllocAddr;

  FILE *src_fd = NULL;
  src_fd  = fopen(pInFilePath,"rb");
  fread(pviraddr, stSrcBuff.u32BuffSize, 1, src_fd);
  fclose(src_fd);

  MI_SCL_DEV DevId = 1;
  MI_SCL_DevAttr_t stDevAttr;
  stDevAttr.u32NeedUseHWOutPortMask = E_MI_SCL_HWSCL3;
  ExecFuncResult(MI_SCL_CreateDevice(DevId, &stDevAttr), s32Ret);
  ExecFuncResult(MI_SCL_StretchBuf(&stSrcBuff, &stoutputCrop, &stDestBuff, E_MI_SCL_FILTER_TYPE_AUTO), s32Ret);

  FILE *dst_fd = NULL;
  dst_fd  = fopen(pOutFilePath,"wb+");
  fwrite(pviroutaddr, stDestBuff.u32BuffSize, 1, dst_fd);
  fclose(dst_fd);

  ExecFuncResult(MI_SCL_DestroyDevice(DevId), s32Ret);

  MI_SYS_Munmap(pviraddr, stSrcBuff.u32BuffSize);
  MI_SYS_Munmap(pviroutaddr, stDestBuff.u32BuffSize);
  MI_SYS_MMA_Free(0,phyInAllockAddr);
  MI_SYS_MMA_Free(0,phyOutAllocAddr);

EXIT:

  return MI_SUCCESS;

}

相关主题

MI_SCL_CreateDevice

2.16. MI_SCL_StretchBufOsd¶

描述

在缩放、拉伸、裁剪指定内存中的图像数据基础上叠加OSD图像数据。

语法

MI_S32 MI_SCL_StretchBufOsd(MI_SCL_DirectBuf_t *pstSrcBuf,
MI_SYS_WindowRect_t*pstSrcCrop,MI_SCL_DirectBuf_t *pstDstBuf,
MI_SCL_DirectOsdBuf_t*pstDstOsdBuf,MI_SCL_FilterType_e eFilterType);

参数

参数名称	描述	输入/输出
pstSrcBuf	源数据buffer参数指针	输入
pstSrcCrop	源数据裁剪区域	输入
pstDstBuf	输出buffer参数指针	输出
pstDstOsdBuf	叠加在pstDstBuf的Osdbuffer参数指针	输入
eFilterType	Scl 使用滤波器类型	输入

返回值
- MI_SUCCESS(0)：成功。
- 非0：失败，详情参照错误码。
依赖
- 头文件：mi_scl_datatype.h、mi_scl.h
- 库文件：
注意
- 使用该接口前需要创建对应的DEV。
- 该接口是阻塞形式，这帧数据做完才会结束。
- 不同系列芯片对应使用的DEVID如下：
  
  芯片 StretchBuf使用的DEVID
  
  Tiramisu Device3
  
  Muffin Device3
  
  Mochi Device1
  
  Maruko Device1
- 输入宽、高的对齐要求：
  
  pixel format width height
  
  YUV420SPNV12, YUV420SPNV21 2 2
  
  YUV422YUYV, YUV422UYVY, YUV422YVYU, YUV422VYUY 2 2
  
  ARGB8888, ABGR8888, BGRA8888 2 2
- 输出宽、高的对齐要求：
  
  pixel format width height
  
  YUV420SPNV12, YUV420SPNV21 2 2
  
  YUV422YUYV, YUV422UYVY, YUV422YVYU, YUV422VYUY 2 2
  
  ARGB8888, ABGR8888, BGRA8888 2 2
- 不同系列芯片对应使用的HWSCL ID
  
  芯片 StretchBuf使用的HWSCL ID
  
  Tiramisu HWSCL5
  
  Muffin HWSCL8
  
  Mochi HWSCL6
  
  Maruko HWSCL3
相关主题

MI_SCL_CreateDevice

3. SCL 数据类型¶

视频输入相关数据类型定义如下：

数据类型	描述
MI_SCL_DEV	SCL设备ID
MI_SCL_CHANNEL	SCL 通道ID
MI_SCL_PORT	SCL 输出端口ID
MI_SCL_HWSclId_e	SCL 输出端口对应硬件scaling ID
MI_SCL_DevAttr_t	SCL 设备属性
MI_SCL_ChannelAttr_t	SCL 通道静态属性
MI_SCL_ChnParam_t	SCL 通道动态属性
MI_SCL_OutPortParam_t	SCL 输出端口参数
MI_SCL_FilterType_e	SCL 滤波类型
MI_SCL_DirectBuf_t	SCL操作指定buffer 参数类型
MI_SCL_DirectOsdArgb1555Alpha_t	Argb1555格式的前景、背景Alpha设定
MI_SCL_DirectOsdAlphaModePara_u	定义Osd Alpha Mode参数联合体
MI_SCL_DirectOsdAlphaMode_e	设定Osd Alpha显示模式
MI_SCL_DirectOsdAlphaAttr_t	定义Osd Alpha属性的结构体
MI_SCL_DirectOsdInfo_t	SCL 直接操作Osdbuffer 参数信息
MI_SCL_DirectOsdBuf_t	SCL 直接操作Osdbuffer 参数类型
MI_SCL_DEV_ISP_REALTIME0	SCL Device 0
MI_SCL_DEV_RDMA0	SCL Device 1
MI_SCL_DEV_VIF_REALTIME0	SCL Device 2
MI_SCL_DEV_DIPR0	SCL Device 3
MI_SCL_DEV_ISP_REALTIME1	SCL Device 4
MI_SCL_DEV_RDMA2	SCL Device 5
MI_SCL_DEV_VIF_REALTIME1	SCL Device 6
MI_SCL_DEV_DIPR1	SCL Device 7
MI_SCL_DEV_HVP_REALTIME0	SCL Device 8

3.1. MI_SCL_DEV¶

说明

定义SCL 设备ID类型。
定义
```
typedef MI_U32 MI_SCL_DEV;
```

3.2. MI_SCL_CHANNEL¶

说明

定义SCL 通道ID类型。
定义
```
typedef MI_U32 MI_SCL_CHANNEL;
```

3.3. MI_SCL_PORT¶

说明

定义SCL 输出端口ID类型。
定义
```
typedef MI_U32 MI_SCL_PORT;
```

3.4. MI_SCL_HWSclId_e¶

说明

SCL设备使用的硬件scaler Id 枚举。

定义

typedef enum
{
    E_MI_SCL_HWSCLID_INVALID= 0,
    E_MI_SCL_HWSCL0         = 0x0001,
    E_MI_SCL_HWSCL1         = 0x0002,
    E_MI_SCL_HWSCL2         = 0x0004,
    E_MI_SCL_HWSCL3         = 0x0008,
    E_MI_SCL_HWSCL4         = 0x0010,
    E_MI_SCL_HWSCL5         = 0x0020,
    E_MI_SCL_HWSCL6         = 0x0040,
    E_MI_SCL_HWSCL7         = 0x0080,
    E_MI_SCL_HWSCL8         = 0x0100,
    E_MI_SCL_HWSCL_MAX     = 0xffff,
}MI_SCL_HWSclId_e;

注意事项
- 每个HW scl id 特点请参考1.4章节输出规格中的HW sclid，按照场景需求选择。
相关数据类型及接口

MI_SCL_DevAttr_t

3.5. MI_SCL_DevAttr_t¶

说明

SCL 设备属性。

定义

typedef struct MI_SCL_DevAttr_s

{

    MI_U32 u32NeedUseHWOutPortMask;

}MI_SCL_DevAttr_t;

成员

成员名称描述

u32NeedUseHWOutPortMask Device需要使用的Scaler id。
注意事项
- u32NeedUseHWOutPortMask 由 MI_SCL_HWSclId_e成员bit mask组成。
  - 从低位到高位依次和HWSCLID 映射。
  - 每个Device上Portid与HWSCL ID之间对应关系为：
    
    stCreateDevAttr.u32NeedUseHWOutPortMask = E_MI_SCL_HWSCL2 | E_MI_SCL_HWSCL3 | E_MI_SCL_HWSCL4;
    
    Port0 → HWSCL2
    
    Port1 → HWSCL3
    
    Port2 → HWSCL4
    
    Portid 与HWSCL bitmask 从低到高对应。
- 相同的HWSclId不可以跨Device使用。
  
  例如:
  
  Dev0的pstSclDevAttr->u32NeedUseHWOutPortMask= E_MI_SCL_HWSCL2 | E_MI_SCL_HWSCL3;
  
  Dev1的pstSclDevAttr->u32NeedUseHWOutPortMask= E_MI_SCL_HWSCL0 | E_MI_SCL_HWSCL2;
  
  这样HWSCL2就被Dev0/Dev1同时使用，创建Device时会返回err 状态。
- Tiramisu中，有MI_VDEC使用场景，Device3 会被内部创建使用，其它Device不能再使用HWSCL5；用户创建Device3对应的channel 使用。
- Muffin中，有MI_VDEC使用场景，Device3 会被内部创建使用，其它Device不能再使用HWSCL8；用户创建Device3对应的channel 使用。
- Mochi中，有MI_VDEC使用场景，Device1 会被内部创建使用，其它Device不能再使用HWSCL6；用户创建Device1对应的channel 使用。
相关数据类型及接口

MI_SCL_CreateDevice

3.6. MI_SCL_ChannelAttr_t¶

说明

Scl 通道属性。

定义

typedef struct MI_SCL_ChannelAttr_s

{

    MI_U32 u32Reserved;

}MI_SCL_ChannelAttr_t;

成员

成员名称描述

u32Reserved 预留参数。
注意事项

可直接设置0。
相关数据类型及接口

MI_SCL_CreateChannel

3.7. MI_SCL_ChnParam_t¶

说明

SCL通道动态参数类型

定义

typedef struct MI_SCL_ChnParam_s

{

    MI_SYS_Rotate_e eRot;

}MI_SCL_ChnParam_t;

成员

成员名称描述

eRot Rotation 参数
注意事项
- 当旋转 90、180、270 时，output端口仅支持rotation功能，不支持crop/scaling/pixel format转换/Mirror/Flip。
- 当旋转 90、180、270 时，不支持MI_RGN attach 叠加osd/cover。
- 芯片支持Rotation的情况：
  
  芯片支持旋转的设备号
  
  Tiramisu Device3
  
  Muffin Device3
  
  Mochi 不支持旋转
  
  Mochi 不支持rotation，只能设置E_MI_SYS_ROTATE_NONE。
相关数据类型及接口

MI_SCL_SetChnParam

3.8. MI_SCL_OutPortParam_t¶

说明

SCL 输出端口参数。

定义

typedef struct MI_SCL_OutPortParam_s

{

    MI_SYS_WindowRect_t stSCLOutCropRect;

    MI_SYS_WindowSize_t stSCLOutputSize;

    MI_BOOL bMirror;

    MI_BOOL bFlip;

    MI_SYS_PixelFormat_e ePixelFormat;

    MI_SYS_CompressMode_e eCompressMode;

}MI_SCL_OutPortParam_t;

成员

成员名称	描述
stSCLOutCropRect	输出裁剪区域
stSCLOutputSize	输出size
bMirror	使能水平翻转
bFlip	使能垂直翻转
ePixelFormat	输出像素格式
eCompressMode	输出压缩格式

注意事项

eCompressMode 支持范围：

芯片	支持的输出像素压缩模式
Tiramisu	E_MI_SYS_COMPRESS_MODE_NONE
Muffin	E_MI_SYS_COMPRESS_MODE_NONE
Mochi	E_MI_SYS_COMPRESS_MODE_NONE E_MI_SYS_COMPRESS_MODE_TO_6BIT
Maruko	E_MI_SYS_COMPRESS_MODE_NONE E_MI_SYS_COMPRESS_MODE_TO_6BIT E_MI_SYS_COMPRESS_MODE_IFC

eCompressMode限制

Output_Compress		10TO6	IFC
Pixel	yuv420SP NV12	Y	Y
Pixel	yuv422 YUYV	Y	N
Pixel Alignment (WxH)	yuv420SP NV12	2x2	2x2
Pixel Alignment (WxH)	yuv422 YUYV	2x2	2x2
bMirror		N	N
bFlip		Y	N

E_MI_SYS_COMPRESS_MODE_IFC 同时只支持一个HW SclId 使用。

Mochi/Maruko 不支持ePixelFormat 为 YUV422_UYVY / YUV422_VYUY 时使能Mirror。

相关数据类型及接口

MI_SCL_SetOutputPortParam

3.9. MI_SCL_FilterType_e¶

说明

Scl 滤波器类型。

定义

typedef enum

{

    E_MI_SCL_FILTER_TYPE_AUTO,

    E_MI_SCL_FILTER_TYPE_BYPASS,

    E_MI_SCL_FILTER_TYPE_BILINEAR,

    E_MI_SCL_FILTER_TYPE_BICUBIC,

    E_MI_SCL_FILTER_TYPE_MAX,

} MI_SCL_FilterType_e;

成员

成员名称	描述
E_MI_SCL_FILTER_TYPE_AUTO	自动选择滤波器
E_MI_SCL_FILTER_TYPE_BYPASS	不经过算法滤波器
E_MI_SCL_FILTER_TYPE_BILINEAR	双线性滤波器
E_MI_SCL_FILTER_TYPE_BICUBIC	双立方插值滤波器
E_MI_SCL_FILTER_TYPE_MAX	滤波器类型最大值

注意事项

当选择和算法相同的滤波器类型，可以得到更加精准的算法结果。
相关数据类型及接口

MI_SCL_StretchBuf

3.10. MI_SCL_DirectBuf_t¶

说明

SCL 直接操作buffer 参数类型。

定义

typedef struct MI_SCL_DirectBuf_s

{

    MI_SYS_PixelFormat_e ePixelFormat;

    MI_U32 u32Width;

    MI_U32 u32Height;

    MI_PHY phyAddr[2];

    MI_U32 u32Stride[2];

    MI_U32 u32BuffSize;

}MI_SCL_DirectBuf_t;

成员

成员名称	描述
ePixelFormat	Buffer 像素格式
u32Width	有效像素宽度
u32Height	有效像素高度
phyAddr	Buffer 物理地址
u32Stride	Buffer 一行占字节数
u32BuffSize	Buffer 占用空间

相关数据类型及接口

MI_SCL_StretchBuf

MI_SCL_StretchBufOsd

3.11. MI_SCL_DirectOsdArgb1555Alpha_t¶

说明

Argb1555格式的前景、背景Alpha设定。

定义

typedef struct MI_SCL_DirectBufOsdArgb1555Alpha_s
{
    MI_U8 u8BgAlpha;
    MI_U8 u8FgAlpha;
} MI_SCL_DirectOsdArgb1555Alpha_t;

成员

成员名称描述

u8BgAlpha 背景Alpha，Alpha bit为0时对应的Alpha值，取值范围0~0xFF。

u8FgAlpha 前景Alpha，Alpha bit为1时对应的Alpha值，取值范围0~0xFF。
相关数据类型及接口

MI_SCL_StretchBufOsd

3.12. MI_SCL_DirectOsdAlphaModePara_u¶

说明

定义Osd Alpha Mode参数联合体。

定义

typedef union
{
    MI_SCL_DirectOsdArgb1555Alpha_t stArgb1555Alpha;
    MI_U8                           u8ConstantAlpha;
} MI_SCL_DirectOsdAlphaModePara_u;

成员

成员名称描述

stArgb1555Alpha Pixelalpha时Argb1555格式的前景Alpha及背景Alpha设定

u8ConstantAlpha Constant Alpha时Alpha值设定，取值范围0~0xFF
相关数据类型及接口

MI_SCL_StretchBufOsd

3.13. MI_SCL_DirectOsdAlphaMode_e¶

说明

设定Osd Alpha显示模式。

定义

typedef enum
{
    E_MI_SCL_DIRECT_BUF_OSD_PIXEL_ALPHA = 0,
    E_MI_SCL_DIRECT_BUF_OSD_CONSTANT_ALPHT
} MI_SCL_DirectOsdAlphaMode_e;

成员

成员名称	描述
E_MI_SCL_DIRECT_BUF_OSD_PIXEL_ALPHA	Osd显示每个pixel对应的alpha效果，例如argb1555/argb4444/arbg8888/i2/i4/i8这些格式都能支持pixel alpha，rgb565则不会生效。
E_MI_SCL_DIRECT_BUF_OSD_CONSTANT_ALPHT	Osd硬件会忽略图像格式中的alpha位，使用统一的值设定alpha值。例如rgb565能设定其透明度。

相关数据类型及接口

MI_SCL_StretchBufOsd

3.14. MI_SCL_DirectOsdAlphaAttr_t¶

说明

定义Osd Alpha属性的结构体。

定义

typedef struct MI_SCL_DirectOsdAlphaAttr_s
{
    MI_SCL_DirectOsdAlphaMode_e     eAlphaMode;
    MI_SCL_DirectOsdAlphaModePara_u stAlphaPara;
} MI_SCL_DirectOsdAlphaAttr_t;

成员

成员名称描述

eAlphaMode Osd Alpha的使用模式。

stAlphaPara 模式对应的参数。
相关数据类型及接口

MI_SCL_StretchBufOsd

3.15. MI_SCL_DirectOsdInfo_t¶

说明

SCL 直接操作Osdbuffer 参数信息。

定义

typedef struct MI_SCL_DirectOsdInfo_s
{
    MI_U32                      u32X;
    MI_U32                      u32Y;
    MI_U32                      u32Width;
    MI_U32                      u32Height;
    MI_PHY                      phyAddr;
    MI_U32                      u32Stride;
    MI_SCL_DirectOsdAlphaAttr_t stOsdAlphaAttr;
} MI_SCL_DirectOsdInfo_t;

成员

成员名称	描述
u32X	横坐标
u32Y	纵坐标
u32Width	有效像素宽度
u32Height	有效像素高度
phyAddr	Buffer 物理地址
u32Stride	Buffer 一行占字节数
stOsdAlphaAttr	Osd Alpha 属性

相关数据类型及接口

MI_SCL_StretchBufOsd

3.16. MI_SCL_DirectOsdBuf_t¶

说明

SCL 直接操作Osdbuffer 参数类型。

定义

typedef struct MI_SCL_DirectOsdBuf_s
{
    MI_U8                  u8OsdBufCnt;
    MI_SYS_PixelFormat_e   ePixelFormat;
    MI_SCL_DirectOsdInfo_t astOsdBuf[MI_SCL_DIRECT_OSD_CNT_MAX];
} MI_SCL_DirectOsdBuf_t;

成员

成员名称描述

u8OsdBufCnt OSD 图像数据的数量

ePixelFormat OSD Buffer 像素格式

astOsdBuf OSD 图像数据
注意事项
- u8OsdBufCnt 有效区间 [0, MI_SCL_DIRECT_OSD_CNT_MAX]
```
#define MI_SCL_DIRECT_OSD_CNT_MAX (8)
```
- ePixelFormat 支持范围请参考MI RGN API 中 “2.7. MI_RGN_AttachToChn” 章节。
相关数据类型及接口

MI_SCL_StretchBufOsd

3.17. MI_SCL_DEV_ISP_REALTIME0¶

说明

SCL Device 0
定义
```
#define MI_SCL_DEV_ISP_REALTIME0 (0x0)
```

3.18. MI_SCL_DEV_RDMA0¶

说明

SCL Device 1
定义
```
#define MI_SCL_DEV_RDMA0 (0x1)
```

3.19. MI_SCL_DEV_VIF_REALTIME0¶

说明

SCL Device 2
定义
```
#define MI_SCL_DEV_VIF_REALTIME0 (0x2)
```

3.20. MI_SCL_DEV_DIPR0¶

说明

SCL Device 3
定义
```
#define MI_SCL_DEV_DIPR0 (0x3)
```

3.21. MI_SCL_DEV_ISP_REALTIME1¶

说明

SCL Device 4
定义
```
#define MI_SCL_DEV_ISP_REALTIME1 (0x4)
```

3.22. MI_SCL_DEV_RDMA2¶

说明

SCL Device 5
定义
```
#define MI_SCL_DEV_RDMA2 (0x5)
```

3.23. MI_SCL_DEV_VIF_REALTIME1¶

说明

SCL Device 6
定义
```
#define MI_SCL_DEV_VIF_REALTIME1 (0x6)
```

3.24. MI_SCL_DEV_DIPR1¶

说明

SCL Device 7
定义
```
#define MI_SCL_DEV_DIPR1 (0x7)
```

3.25. MI_SCL_DEV_HVP_REALTIME0¶

说明

SCL Device 8
定义
```
#define MI_SCL_DEV_HVP_REALTIME0 (0x8)
```

4. SCL 错误码¶

视频输入 API 错误码如下表所示。

错误代码	宏定义	描述
0XA0222000	MI_ERR_SCL_INVALID_DEVID	设备号无效
0XA0222001	MI_ERR_SCL_INVALID_CHNID	通道号无效
0XA0222002	MI_ERR_SCL_INVALID_PORTID	端口号无效
0XA0222003	MI_ERR_SCL_ILLEGAL_PARAM	参数设置无效
0XA0222004	MI_ERR_SCL_EXIST	设备已经存在
0XA0222005	MI_ERR_SCL_UNEXIST	设备已经不存在
0XA0222006	MI_ERR_SCL_NULL_PTR	输入参数空指针错误
0XA0222007	MI_ERR_SCL_NOT_SUPPORT	操作不支持
0XA0222008	MI_ERR_SCL_NOT_PERM	操作不允许
0XA0222009	MI_ERR_SCL_NOMEM	分配内存失败
0XA022200a	MI_ERR_SCL_NOBUF	缓存为满
0XA022200b	MI_ERR_SCL_BUF_EMPTY	缓存为空
0XA022200c	MI_ERR_SCL_NOTREADY	系统未初始化
0XA022200d	MI_ERR_SCL_BUSY	系统忙

5. PROCFS介绍¶

5.1. cat¶

调试信息
```
# cat /proc/mi_modules/mi_scl/mi_scl0
```
调试信息分析

记录当前scaler的使用状况以及相关属性、可以动态地获取到这些信息，方便调试和测试。

参数说明

参数		描述
module info	InitCnt	发生connected module次数
	chip	Chip index
	version	Chip version
	UseSclMask	模块scaler使用情况
Device Info	DevID	设备ID
	refcnt	重复创建dev次数
	src	输入源
	sclmask	设备使用Scaler id
	cmdq	Cmdq 指针
	IrqEn	IRQ 使能状况
	IrqMode	IRQ 模式
	Irqnum	IRQ ID
	VsyncCnt	ISR vsync Cnt
	crcFailCnt	input crc 校验失败次数
	FDCnt	ISR Frame Done Cnt
	DropCnt	IRQ Frame Drop or Double Vsync
	LdCnt	Low Lantency Mode Match Line IRQ Cnt
	DVCnt	double vsync cnt
	rstcnt	reset hw cnt
Channel Info	DevId	Device id
	ChnId	Channel ID
	start	Channel 是否start
	Crop	Channel Crop位置
	Rot	Rotation 角度
	Size	Input width/height
	pixel	Input Pixel format
	compress	input 压缩类型
	Stride	Input buffer stride
	Atom	底层拿住buffer 数量
	Atom0Cnt	释放buffer后底层拿不到buffer的次数
	PTMax/Cur	硬件处理所花最长时间/当前帧硬件处理所花时间
	PreCnt/EnqCnt/BarCnt/checkin/ checkout/DeqCnt	Callback 接口执行次数
	MaxIv/MinIv	callback 执行的间隔时间
	DropCnt	drop task cnt
	EnqOTNull	Enq时OutBuffer 为Null次数统计
Outputport Info	DevId	Device id
	ChnId	Channel ID
	PortId	Port ID
	sclid	scaler ID
	bindtype	0: Real Time mode 1: Ring mode 2: frame mode
	Enable	使能状态
	Pixel	Output pixel format
	bMirr/flip	Port 水平/竖直翻转
	compress	output 压缩类型
	PortCrop	Port 裁剪范围
	OutputW /OutputH	输出宽/输出高
	Histogram	Scl 画面复杂度
	MatchLine	Low Lantency Mode Match Line Cnt
	Stride	Output buffer stride，一行像素字节
	GetCnt	尝试获取outputbuffer的数量
	FailCnt	获取outputbuffer失败数量
	FinishCnt	处理完output buffer 数量
	fps	Output port frame rate

5.2. echo¶

Echo help 查看可用命令：

# echo help > /proc/mi_modules/mi_scl/mi_scl0

功能	设置每一个scl port 的crop 参数，直接设置给driver，不经过MI 流程
命令	echo setprecrop [chnid portid X Y Width Height] > /proc/mi_modules/mi_scl/mi_scl0
参数说明	Chnid: channel id Portid: port id X,Y,width,height: crop范围
举例	echo setprecrop 0 0 0 0 800 200 > /proc/mi_modules/mi_scl/mi_scl0

功能	等待底层buffer 处理完之后，关掉channel，不再trigger底层。
命令	echo stopchnl [chnid, ON/OFF] > /proc/mi_modules/mi_scl/mi_scl0
参数说明	Chnid: channel id ON/OFF: ON 打开stopchannel 功能，也就是stop掉， OFF 关闭stopchannel功能，打开channel
举例	echo stopchnl 0 ON > /proc/mi_modules/mi_scl/mi_scl0 echo stopchnl 0 OFF > /proc/mi_modules/mi_scl/mi_scl0

功能	Dump选定的channel的output数据，并保存在/path路径下
命令	echo dumptaskfile [chnid, Cnt, /path/, bOnlyDumpResChange, bdumpport] > /proc/mi_modules/mi_scl/mi_scl0
参数说明	Chnid: channel id Cnt: dump 数量 Path: 存放dump出来文件的路径 bOnlyDumpResChange: 切换分辨率时可能产生花图，dump命令和切分辨率操作不好配合，可以先设置该参数，然后切换分辨率，当程序识别后会dump分辨率变化后的buffer。 (非必选参数) Bdumpport: 只dump 某一个portid, 默认是dump 所有在输出的port。 (非必选参数)
举例	echo dumptaskfile 0 2 /tmp > /proc/mi_modules/mi_scl/mi_scl0

功能	设置pass的atomvalue
命令	echo setatom [AtomValue] > /proc/mi_modules/mi_scl/mi_scl0
参数说明	AtomValue: Driver 最大持有buffer 数量
举例	echo setatom 3 > /proc/mi_modules/mi_scl/mi_scl0 注意：有时候底层卡住，可以尝试增大该atom，加塞一张buffer 给driver，重新trigger，看是否可以恢复，或者掉帧的时候，加大是否可以满帧。

功能	清除指定channel port的input/output/done buffer
命令	echo clearbuf [chnid, portid bClearInput, bClearoutput] > /proc/mi_modules/mi_scl/mi_scl0
参数说明	Chnid: channel id Portid: port id bClearInput: 清除input的buffer bClearoutput: 清除output的buffer
举例	echo clearbuf 0 0 1 0 > /proc/mi_modules/mi_scl/mi_scl0

功能	设置debug level
命令	echo debuglv [level] > /proc/mi_modules/mi_scl/mi_scl0 echo debuglv [chnid][level] > /proc/mi_modules/mi_scl/mi_scl0
参数说明	Chnid: channel id Level: (1) 单个level参数时: 2:flow, 4:check irq done (2) 两个参数时: 1: check buffer, 2: check loop, 4: check frame pts, 8: check fence done, 16: check func time, 32: check sidebandmsg
举例	echo debuglv 4 > /proc/mi_modules/mi_scl/mi_scl0 //打开check irq done 相关的MI打印 echo debuglv 0 3 > /proc/mi_modules/mi_scl/mi_scl0 //打开channel0 level3的打印，打印buffer info和loop info

功能	设置port是否enable
命令	echo enableport [chnid, portid, bEn] > /proc/mi_modules/mi_scl/mi_scl0
参数说明	Chnid: channel id Portid: port id bEn: 0:禁用, 1: 使用
举例	echo enableport 0 0 1 > /proc/mi_modules/mi_scl/mi_scl0

功能	将Bind Q中缓存的buffer 消耗掉
命令	echo clearbindq [chnid bclear] > /proc/mi_modules/mi_scl/mi_scl0
参数说明	Chnid: channel id bclear: 是否clear
举例	echo clearbindq 0 1 > /proc/mi_modules/mi_scl/mi_scl0 //clear channel0 bindQ 将Bind Q中缓存的buffer 消耗掉。有时候前端拿不到buffer，发现是scl BindQ塞满，判断scl是否拿的不够快，将bindQ 清空，看BindQ中是否还会累加上来，如果还累加说明scl 拿不够快，如果不再增加，说明是之前一次异常塞在里面一直没有消耗掉。

功能	设置打印帧率，低于该值打印出来
命令	echo fpsth [chnid portid fpsint fpsfloat] > /proc/mi_modules/mi_scl/mi_scl0
参数说明	Chnid: channel id Portid: port id fpsint: 帧率整数位 fpsfloat: 帧率小数位
举例	echo fpsth 0 0 30 30 > /proc/mi_modules/mi_scl/mi_scl0 //channel0 port0中小于30.30的fps打印出来

功能	设置打印pts，pts间隔超过某个区间打印出来
命令	echo ptsth [chnid portid ptsmininterval ptsmaxinterval] > /proc/mi_modules/mi_scl/mi_scl0
参数说明	Chnid: channel id Portid: port id ptsmininterval: pts间隔时间最小值 ptsmaxinterval: pts间隔时间最大值
举例	echo ptsth 0 0 30000 40000 > /proc/mi_modules/mi_scl/mi_scl0 //channel0 port0中pts小于30ms，大于40ms的值打印出来

功能	设置reset 整个scl 硬件
命令	echo resethw [chnid ] > /proc/mi_modules/mi_scl/mi_scl0
参数说明	Chnid: channel id
举例	echo resethw 0 > /proc/mi_modules/mi_scl/mi_scl0 //mi_scl0代表Dev0, mi_scl1 代表Dev1

功能	设置 output port 参数
命令	echo outputparam pixel [chnid, portid pixelmode] > /proc/mi_modules/mi_scl/mi_scl1 echo outputparam compress [chnid, portid compressmode] > /proc/mi_modules/mi_scl/mi_scl1 echo outputparam mirrorflip [chnid, portid bmirror bflip] > /proc/mi_modules/mi_scl/mi_scl1 echo outputparam crop [chnid, portid cropX cropY cropW cropH] > /proc/mi_modules/mi_scl/mi_scl1 echo outputparam size [chnid, portid sizeW sizeH] > /proc/mi_modules/mi_scl/mi_scl1 echo outputparam all [chnid, portid pixelmode compressmode bmirror bflip cropX cropY cropW cropH sizeW sizeH] > /proc/mi_modules/mi_scl/mi_scl1
参数说明	Chnid: channel id Portid: port id Pixelmode: 输出的pixel类型，填入MI_SYS_PixelFormat_e 中对应的数值 Compressmode：输出的压缩模式，填入MI_SYS_CompressMode_e中对应的数值 Bmirror：输出的使能水平翻转 Bflip：输出的使能垂直翻转 cropX：输出的端口裁剪X坐标 cropY：输出的端口裁剪Y坐标 cropW：输出的端口裁剪宽度 cropH：输出的端口裁剪高度 sizeW：输出的端口宽度 sizeH：输出的端口高度
举例	echo outputparam pixel 0 0 11 > /proc/mi_modules/mi_scl/mi_scl1 echo outputparam compress 0 0 5 > /proc/mi_modules/mi_scl/mi_scl1 echo outputparam mirrorflip 0 0 1 1 > /proc/mi_modules/mi_scl/mi_scl1 echo outputparam crop 0 0 0 0 1920 1080 > /proc/mi_modules/mi_scl/mi_scl1 echo outputparam size 0 0 1920 1080 > /proc/mi_modules/mi_scl/mi_scl1 echo outputparam all 0 0 11 5 1 1 0 0 1920 1080 1920 1080 > /proc/mi_modules/mi_scl/mi_scl1

功能	设置输出端口的CRC 模式
命令	echo crcmode [chnid portid crcmode] > /proc/mi_modules/mi_scl/mi_scl0
参数说明	chnid: channel id Portid: port id crcmode: 0:禁用, 1: 使用
举例	echo crcmode 0 1 1 > /proc/mi_modules/mi_scl/mi_scl0

功能	设置输出端口的字节偏移
命令	echo bytewrite [chnid portid bEn offsetbyte] > /proc/mi_modules/mi_scl/mi_scl0
参数说明	chnid: channel id Portid: port id bEn: 0:禁用, 1: 使用 offsetbyte: 字节偏移量
举例	echo bytewrite 0 0 1 1 > /proc/mi_modules/mi_scl/mi_scl0

功能	设置输入源的测试图形
命令	echo patengen [chnid bEn patengenmode] > /proc/mi_modules/mi_scl/mi_scl0
参数说明	chnid: channel id bEn: 0:禁用, 1: 使用 patengenmode: 0:静态测试图形, 1: 动态测试图形
举例	echo patengen 0 1 0 > /proc/mi_modules/mi_scl/mi_scl0

功能	设置发生cmdq timeout之后执行的命令抓取信息
命令	echo cmdqtimeout [bEn, keyword, cmdline, path] > /proc/mi_modules/mi_scl/mi_scl0
参数说明	bEn: 0:禁用, 1: 使用 keyword: 执行的命令 cmdline: 执行的字符串 path: 信息保存路径
举例	echo 1 cat /proc/mi_modules/mi_scl/mi_scl0 /mnt/cmdqerr.txt > /proc/mi_modules/mi_scl/mi_scl0

功能	设置scl filter type
命令	echo outputfilter [chnid, portid, filtertype] > /proc/mi_modules/mi_scl/mi_scl0
参数说明	chnid: channel id Portid: port id filtertype: 0:auto, 1:bilinear, 2:bicubic
举例	echo outputfilter 0 0 1> /proc/mi_modules/mi_scl/mi_scl0

功能	设置cmdq delay时间
命令	echo cmdqdelay [time(ns)] > /proc/mi_modules/mi_scl/mi_scl1
参数说明	time: cmdq delay时间（ns）
举例	echo cmdqdelay 100000 > /proc/mi_modules/mi_scl/mi_scl1

功能	设置double vsync drop 是否enable
命令	echo doublevsyncdrop [bEn] > /proc/mi_modules/mi_scl/mi_scl1
参数说明	bEn: 0:禁用, 1: 使用
举例	echo doublevsyncdrop 1 > /proc/mi_modules/mi_scl/mi_scl1

参数名称	描述	输入/输出
DevId	SCL 设备号。	输入
pstSclDevAttr	Scl 设备属性。	输入

参数名称	描述	输入/输出
DevId	SCL 设备号	输入
ChnId	SCL 通道号，取值范围(0~31)。	输入
pstChnAttr	SCL 通道属性	输入

pixel format	width	height
YUV420SPNV12, YUV420SPNV21	2	2
YUV422YUYV, YUV422UYVY, YUV422YVYU, YUV422VYUY	2	2
ARGB8888, ABGR8888, BGRA8888	2	2

成员名称	描述
u8BgAlpha	背景Alpha，Alpha bit为0时对应的Alpha值，取值范围0~0xFF。
u8FgAlpha	前景Alpha，Alpha bit为1时对应的Alpha值，取值范围0~0xFF。

成员名称	描述
stArgb1555Alpha	Pixelalpha时Argb1555格式的前景Alpha及背景Alpha设定
u8ConstantAlpha	Constant Alpha时Alpha值设定，取值范围0~0xFF

成员名称	描述
eAlphaMode	Osd Alpha的使用模式。
stAlphaPara	模式对应的参数。

成员名称	描述
u8OsdBufCnt	OSD 图像数据的数量
ePixelFormat	OSD Buffer 像素格式
astOsdBuf	OSD 图像数据

芯片	StretchBuf使用的DEVID
Tiramisu	Device3
Muffin	Device3
Mochi	Device1
Maruko	Device1

芯片	StretchBuf使用的HWSCL ID
Tiramisu	HWSCL5
Muffin	HWSCL8
Mochi	HWSCL6
Maruko	HWSCL3

芯片	StretchBuf使用的DEVID
Tiramisu	Device3
Muffin	Device3
Mochi	Device1
Maruko	Device1

芯片	StretchBuf使用的HWSCL ID
Tiramisu	HWSCL5
Muffin	HWSCL8
Mochi	HWSCL6
Maruko	HWSCL3