SYS模块调试手册

Version 1.3

1. common¶

1.1. dump_mmap¶

调试信息
```
# ./config/dump_mmap
```
调试信息分析

Common下存放的是配置API，目的如下：
1. 在用户态做iniparser，不进入内核。
2. 便于调试时确认配置文件的内容，避免在parser时打印的内容与实际设置偏差。
如下是导入config的配置文件：

将Systeminfo.c内parse的struct写入config_info。

将Pqloader.c内parse的struct写入pq_info和*_table，此处的table是连续的内存摆放，MISDK是一个间接数组指向一列一维数组。

如下是导入mmap的配置文件：

将Mmapinfo.c内parse的struct写入mmap_info和memory_info。因为这里比较简单，所以从mmap_info和memory_info读出来是格式化的可读信息。

1.2. dump_config¶

调试信息

# ./config/dump_config

panel size:24
DBC Value=
        55,30,10
        254,66,0
        72,80,72
start dump [motion_table](6, 8)
{0xe8,0xcd,0xab,0x89,0x67,0x45,0x23,0x00,}
{0xd8,0xbc,0x9a,0x78,0x56,0x34,0x12,0x00,}
{0xc8,0xab,0x89,0x67,0x45,0x23,0x01,0x00,}
{0xb8,0x9a,0x78,0x56,0x34,0x12,0x00,0x00,}
{0xa8,0x89,0x67,0x45,0x23,0x01,0x00,0x00,}
{0x98,0x78,0x56,0x34,0x12,0x00,0x00,0x00,}
end dump
start dump [motion_hdmi_dtv_table](4, 8)
{0x68,0x45,0x23,0x01,0x00,0x00,0x00,0x00,}
{0xa8,0x89,0x67,0x45,0x23,0x01,0x00,0x00,}
{0xc8,0xab,0x89,0x67,0x45,0x23,0x01,0x00,}
{0xe8,0xcd,0xab,0x89,0x67,0x45,0x23,0x00,}
end dump
start dump [motion_comp_pc_table](4, 8)
{0x68,0x45,0x23,0x01,0x00,0x00,0x00,0x00,}
{0x98,0x78,0x56,0x34,0x12,0x01,0x00,0x00,}
{0xa8,0x89,0x67,0x45,0x23,0x12,0x01,0x00,}
{0xb8,0x9a,0x78,0x56,0x34,0x12,0x01,0x00,}
end dump
start dump [misc_param_table](4, 4)
{0x02,0xff,0x00,0x00,}
{0x02,0xff,0x01,0x66,}
{0x03,0x88,0x01,0x66,}
{0x03,0xaa,0x01,0x66,}
end dump
start dump [misc_luma_table](8, 2)
{0x33,0x08,}
{0x33,0x07,}
{0x22,0x06,}
{0x22,0x05,}
{0x11,0x04,}
{0x11,0x03,}
{0x00,0x02,}
{0x00,0x01,}
end dump
start dump [noise_table](6, 8)
{0x67,0x45,0x34,0x23,0x12,0x01,0x00,0x00,}
{0xab,0x89,0x67,0x45,0x23,0x12,0x01,0x00,}
{0xbc,0x9a,0x78,0x56,0x34,0x23,0x01,0x00,}
{0xde,0xbc,0x9a,0x78,0x56,0x34,0x12,0x00,}
{0xef,0xcd,0xab,0x89,0x67,0x45,0x23,0x00,}
{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,}
end dump
start dump [misc_table](6, 15)
{0x00,0x00,0x00,0x00,0x00,0x02,0x00,0x00,0x02,0x00,0xc0,0x9f,0x00,0x01,0x66,}
{0x10,0x01,0xc1,0xc1,0xc1,0x04,0x09,0x1f,0x03,0x88,0xc0,0x9f,0x00,0x01,0x66,}
{0x21,0x02,0xc2,0xc2,0xc2,0x08,0x09,0x1f,0x03,0x99,0x00,0x00,0x00,0x01,0x88,}
{0x31,0x04,0xc2,0xc2,0xc2,0x0a,0x09,0x1f,0x03,0xaa,0x00,0x00,0x00,0x01,0xaa,}
{0x41,0x06,0xc3,0xc3,0xc3,0x10,0x19,0x1f,0x03,0xbb,0x00,0x00,0x14,0x01,0xbb,}
{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,}
end dump

调试信息分析

./config/dump_config得到的是/proc/mi_modules/common/里各文件的信息，含panel size、DBC Value、motion_table、motion_hdmi_dtv_table、motion_comp_pc_table、misc_param_table、misc_luma_table、noise_table、misc_table等。

2. mi_log_info¶

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)

调试信息分析

说明了默认的log path 或store path，同时说明了各模块的debug_level的值。
参数分析

参数描述

mi_log_info log path 暂时无效果

store path 暂时无效果

Log module 各个模块的名称

Level 打印等级

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信息 1：只显示error的信息 (MI_DBG_ERR) 2：只显示waring的信息 (MI_DBG_WRN) 3：只显示 info 的信息 (MI_DBG_INFO) 4 ：显示所有信息
举例	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

3. mi_global_info¶

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 0x60000000        ARM_MIU1_BASE_ADDR 0x80000000
ARM_MIU2_BUS_BASE 0xffffffff            ARM_MIU2_BASE_ADDR 0xffffffff
lx_mem_addr  0x20c00000         lx_mem_size  0xe300000
lx_mem2_addr 0xffffffff             lx_mem2_size 0xffffffff
lx_mem3_addr 0xffffffff             lx_mem3_size 0xffffffff

KernelProtect IP white list:
clientId    name
            43                   MIU_CLIENT_MIPS_RW
            50                   MIU_CLIENT_NAND_RW
            82              MIU_CLIENT_USB_UHC0_RW
            83              MIU_CLIENT_USB_UHC1_RW
            84              MIU_CLIENT_USB_UHC2_RW
            18                    MIU_CLIENT_G3D_RW
        140                   MIU_CLIENT_USB3_RW
        129                   MIU_CLIENT_SDIO_RW
        165                   MIU_CLIENT_SATA_RW
        133              MIU_CLIENT_USB_UHC3_RW
        225               MIU_CLIENT_USB30_1_RW
        226               MIU_CLIENT_USB30_2_RW
            5                   MIU_CLIENT_BDMA_RW
            14                   MIU_CLIENT_EMAC_RW

PAGE_OFFSET - the virtual address of the start of the kernel image
PAGE_OFFSET=0xc0000000
TASK_SIZE - the maximum size of a user space task
TASK_SIZE=0xbf000000
MStar SDK version: commit.build_time 0be783c.2017121315
CHIP_VERSION  U02

调试信息分析

该调试信息提供了一些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）
kernelProtect IP white list	name	与clientId对应的该IP的实际的名字
MStar SDK version: commit.build_time	commit	sdk对应的commit
MStar SDK version: commit.build_time	build_time	sdk的build时间
CHIP_VERSION	CHIP_VERSION	当前chip的版本，版本号是U01,U02,U03…

3.2. mi_bufqueue_status¶

3.3. cat/echo¶

调试信息

# 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

12 0 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

12 0 0 0 0 0 0 0 0

调试信息分析

Dump当前各modules的enable input/output port 相关Queue的信息。

参数分析

参数		描述
dump Queues in input port(only dump enabled Input 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里的buff的总的size
	BindInQ_cnt	该InputPort 里的UsrPipeInBufQueue里的buff的总的size
	InputPendingQueueSize	该InputPort 里的WorkingQueue里的buff的总的size
dump Queues in output port(only dump enabled output 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里的buffer数目

4. debug_level¶

4.1. cat/echo¶

调试信息

# cat /proc/mi_modules/mi_sys/debug_level 2

调试信息分析

为了控制打印级别, 每个module（包括sys）都有各自的debug level,分别由/proc/mi_modules/mi_modulename/debug_level控制，其中disp,divp,rgn等为modulename。上面以/proc/mi_modules/mi_sys/debug_level为例。

功能	打印警告级别
命令	`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 的警告级别为2(只显示waring的信息)

功能	修改警告级别
命令	`echo [Level] > /proc/mi_modules/[ModuleName]/debug_level`
参数说明	[Level] 0: 无Debug信息 1: 只显示error的信息 (MI_DBG_ERR) 2 :只显示waring的信息 (MI_DBG_WRN) 3: 只显示 info 的信息 (MI_DBG_INFO) 4: 显示所有信息
	[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. miu_protect¶

5.1. cat¶

调试信息

cat /proc/mi_modules/mi_sys_mma/miu_protect

=================== start miu_protect_info ================================

kernel protect enabled

LX :

cpu_start_addr:0x20c00000 size:0xe300000

miu_index miuBlockIndex start_cpu_bus_pa length

0x0 0x00 0x20c00000 0x460000

KernelProtect IP white list:

clientId name

43 MIU_CLIENT_MIPS_RW

50 MIU_CLIENT_NAND_RW

82 MIU_CLIENT_USB_UHC0_RW

83 MIU_CLIENT_USB_UHC1_RW

84 MIU_CLIENT_USB_UHC2_RW

18 MIU_CLIENT_G3D_RW

140 MIU_CLIENT_USB3_RW

129 MIU_CLIENT_SDIO_RW

165 MIU_CLIENT_SATA_RW

133 MIU_CLIENT_USB_UHC3_RW

225 MIU_CLIENT_USB30_1_RW

226 MIU_CLIENT_USB30_2_RW

5 MIU_CLIENT_BDMA_RW

14 MIU_CLIENT_EMAC_RW

调试信息分析

该命令显示了miu protect相关的信息。

参数分析

参数		描述
kernel protect		值是enabled或者disabled，表示是否有enable kernel protect，默认是需要enable kernel protect的。
LX(以只有一个LX为例,LX表示linux 镜像对应的memory)	cpu_start_addr	该LX对应的起始CPU addr。
LX(以只有一个LX为例,LX表示linux 镜像对应的memory)	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）。
KernelProtect IP white list	name	与clientId对应的该IP的实际的名字。

6. mma_help_name¶

6.1. cat¶

调试信息

# cat /proc/mi_modules/mi_sys_mma/mma_heap_name0

mma heap name heap_base_cpu_bus_addr length chunk_mgr_avail

mma_heap_name0 25200000 9d00000 79c6000

chunk_mgr info:

pst_chunk_mgr offset length avail

c3545618 0 9d00000 79c6000

each chunk info:

offset length used_flag task_name

0 1000 1 insmod

1000 100000 1 insmod

101000 200000 1 proc_rtsp

301000 3f5000 1 vdisp-dev0

6f6000 3f5000 1 vdisp-dev0

aeb000 3f5000 1 vdisp-dev0

ee0000 1f5000 0 NA

10d5000 1000 1 proc_rtsp

10d6000 64000 1 proc_rtsp

113a000 200000 1 proc_rtsp

133a000 700000 1 proc_rtsp

1a3a000 3f5000 0 NA

1e2f000 3f5000 1 vdisp-dev0

2224000 700000 1 proc_rtsp

2924000 73dc000 NA

调试信息分析

该cat信息对应的是该mma heap的基本信息和当前的一些状态。

参数分析

参数		描述
heap basic info	mma heap name	mma heap的name
	heap_base_cpu_bus_addr	heap的起始cpu bus addr
	length	heap的length
	heap里的剩余的未用的memory的总量	chunk_mgr_avail
chunk_mgr info	pst_chunk_mgr	chunk mgr的指针的值
	offset	chunk mgr的offset,由于整个mma heap做为一个chunk mgr,因此该值永远为0
	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是否allocated。是，该值为1；否, 该值为0
	task_name	如果used flag为1，则task_name存的task使用它；否则该值为无效值NA

6.2. echo¶

功能	即dump 指定offset和length的data到指定的路径
命令	`echo [Path] [Offset] [Length] > /proc/mi_modules/mi_sys_mma/mma_heap_name[Num]`
参数说明	[Path] 文件要保存的路径,只需提供路径，系统会根据参数自动生成对应的文件名。 [Offset] 从该mma heap的offset开始dump data,必须4KB对齐。 [Length] 在该mma heap里dump的总数据量, 必须4KB对齐 [Num] mma head 对应的数字，目前 mma_heap_name0 可通过 cat /proc/cmdline 查看
举例	`echo /mnt/ 0 4096 > /proc/mi_modules/mi_sys_mma/mma_heap_name0` 在 /mnt下产生 mma__mma_heap_name0__0__4096.bin 文件

7. imi_mma_heap¶

7.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

mma_heap_name0 22000000 1f80000 1c8a000 1

chunk_mgr info:

offset length avail

0 10000000 fd0a000

each chunk info:

offset length used_flag task_name pid Module

0 20000 0 NA -1 mi_sys

调试信息分析

该cat信息对应的是该mma heap的基本信息和当前的一些状态。

参数分析

参数		描述
heap basic info	mma heap name	mma heap的name
	heap_base_cpu_bus_addr	该allocator里的allocations中未被使用的数目。
	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 的 length,由于整个 mma heap 做为一个chunk mgr,因此该值永远为 mma heap length。
each chunk info (chunk mgr里各chunk的信息和使用情况)	offset	该chunk在chunk mgr里的offset
	length	该chunk的length
	used_flag	该chunk是否allocated。是，该值为1；否, 该值为0
	task_name	如果used flag为1，则task_name存的task使用它；否则该值为无效值NA
	pid	该chunk所属的current->tgid
	Module	该chunk所属的模块

8. vb_pool_qlobal¶

8.1. cat¶

调试信息

# cat /proc/mi_modules/mi_sys_mma/vb_pool_global

调试信息分析

如果通过MI_SYS_IMPL_ConfGloPubPools API或者MI_SYS_ConfGloPubPools API配置了global public pools, 则有/proc/mi_modules/mi_sys_mma/vb_pool_global文件；如果没有配置的话，那么没有该文件。

调试信息分析

参数		描述
	collection_size	该pools的allocator个数
其中某个vbpool_allocator 的info	each_allocation_size	该allocator里的allocation的size（同一个vbpool allocator的不同allocation的size是相同的，同一个pools里的不同的allocator的不同的allocations的size可能不同）
	total_allocation_count	该allocator里的allocations的数目
	total_not_used_allocation_count	该allocator里的allocations中未被使用的数目
	kern_map_ptr	该allocator的offset0位置的kernel space va；如果没有的话，该值为NULL
指定的vbpool_allocator的某个vbpool_allocation的 info	offset_in_vb_pool	该allocation在对应的allocator里的逻辑offset
	real_used_flag	是否被使用中，否的话则后续参数为无效值NA
	u64Pts	如果有效，该值为pts
	u64SidebandMsg	如果有效，该值为SidebandMsg
	bEndOfStream	如果有效，该值为是否是end stream的flag
	bUsrBuf	如果有效，该值为表示是否是UsrBuf
	eBufType	如果有效，该值表示buf的type

8.2. echo¶

功能	即dump 指定offset和length的data到指定的路径
命令	`echo [Path] [Offset] [Length] > /proc/mi_modules/mi_sys_mma/ vb_pool_global`
参数说明	[Path] 文件要保存的路径,只需提供路径，系统会根据参数自动生成对应的文件名。 [Offset] 从该pools的哪个offset开始dump data,是pools的逻辑offset。 [Length] 在该pools里dump的总的数据量的大小。
举例	`/# echo /mnt/ 0 1024 > /proc/mi_modules/mi_sys_mma/vb_pool_global` 在 /mnt 下产生 vb_pool__global__0__1024.bin

9. vb_pool¶

9.1. cat¶

调试信息

# cat /proc/mi_modules/mi_sys_mma/vb_pool_mi_divp0

调试信息分析

如果配置了某个device的vb pool, 则会生成/proc/mi_modules/mi_sys_mma/vb_pool_modnamedevid文件, （modname，如divp,vpe等，devid，如0,1等。）它对应的是该device, vb_pool_global对应全局共享的vb pool。

上面以vb_pool_mi_divp0为例，cat命令显示各种信息，有且只有”echo path offset length >”来dump数据，这都和vb_pool_global类似。

9.2. echo¶

功能	即dump 指定offset和length的data到指定的路径
命令	echo [Path] [Offset] [Length] > /proc/mi_modules/mi_sys_mma/[ModID]
参数说明	[Path] 文件要保存的路径,只需提供路径，系统会根据参数自动生成对应的文件名。 [Offset] 从该pools的哪个offset开始dump data,是pools的逻辑offset。 [Length] 在该pools里dump的总的数据量的大小。 [ModID] vb_pool的文件名，如 vb_pool_mi_divp0
举例	`echo /mnt/ 0 4096 > /proc/mi_modules/mi_sys_mma/vb_pool_mi_divp0` 在/mnt/下产生vb_pool__mi_divp0__0__4096.bin

10. meta¶

10.1. cat¶

调试信息

# cat /proc/mi_modules/mi_sys_mma/meta

=================== start meta_info ================================

basic info:

total page count:16 each meta data size:256 total_count_with_metadatasize 256
total_free_count_with_metadatasize:254

meta info :

ref_cnt=3

each allocation info:

offset_in_pool length phy_addr va_in_kern real_used_flag

0x0 0x100 0x2336000 c1736000 0

0x100 0x100 0x2336100 c1736100 0

0x200 0x100 0x2336200 c1736200 0

0x300 0x100 0x2336300 c1736300 0

0x400 0x100 0x2336400 c1736400 0

0x500 0x100 0x2336500 c1736500 0

0x600 0x100 0x2336600 c1736600 0

0x700 0x100 0x2336700 c1736700 0

0x800 0x100 0x2336800 c1736800 0

0x900 0x100 0x2336900 c1736900 0

0xa00 0x100 0x2336a00 c1736a00 0

……

=================== end meta_info ================================

调试信息分析

只要用过meta allocator(只有一个meta allocator),就会生成/proc/mi_modules/mi_sys_mma/meta，且其对应的memory就会完全alloc，等待被使用。

10.2. echo¶

功能	即dump 指定offset和length的data到指定的路径
命令	`echo [Path] [Offset] [Length] > /proc/mi_modules/mi_sys_mma/ vb_pool_global`
参数说明	[Path] 文件要保存的路径,只需提供路径，系统会根据参数自动生成对应的文件名。 [Offset] 从该allocator的哪个offset开始dump data,是allocator的逻辑offset。 [Length]在该allocator里dump的总的数据量的大小。
举例	`echo /mt 0 1024 > /proc/mi_modules/mi_sys_mma/meta` 在 /mnt 下产生 meta__0__1024.bin

11. mi_modulenamedevid¶

11.1. cat¶

调试信息
```
cat /proc/mi_modules/mi_disp/mi_disp0
```
调试信息分析

cat操作的结果：
1. MI_SYS提供的针对该device的通用的调试信息，从device、channel、input port、output port四个角度提供；
2. 该device私有的信息。私有的信息各module的内容别处会阐述，这里SYS角度只阐述通用的信息。
以cat /proc/mi_modules/mi_vdisp/mi_vdisp0为例，得到上面的结果。

参数说明

参数		描述
Common info for device	ChnNum	该device的总的channel 的数目
	EnChnNum	该device的enabled了的channel的数目
	InPortNum	该device的input port的数目
	OutPortNum	该device的output port的数目
	CollectSize	该dev对应的AllocatorCollection含有的allocator的数目总和
Common info for channel(only dump enabled channel)	ChnId	Channel 的id值
	EnInPNum	该channel的enabled input port数量
	EnOutPNum	该channel的enabled output port数量
	MMAHeapName	如果设置了SetChnMMAConf，该值为对应的mma heap name;如果没有，该值为NULL
chn pass pipeline delay in us	Flow	流程点： OnPreProcessInputTask：MI PASS判断是否需要处理当前task，如果可以给output buffer配置； EnqueueInputTask：将input task 交由MI PASS开始处理； BarrierInputTask：插入CMDQ同步指令（比如waitevent， polling engine done）； CheckInputTaskStatus：检查input task是否完成，及完成状态（成功，失败，etc）； DequeueInputTask：通知MI PASS释放input task相关联的资源； OnPollingAsyncOutputTaskConfig：对于输入输出不同步的MI Pass，或者只有输出没有输入的MI Pass，MI SYS查询是否有独立output buf request需求； EnqueueAsyncOutputTask：将非同步输出的output task交由MI PASS做处理； BarrierAsyncOutputTask：对非同步output task插入cmdq同步指令； CheckOutputTaskStatus：检查output task是否完成，及完成状态（成功，失败，etc）； DequeueOutputTask：通知MI PASS释放output task相关联的资源； FinDMADispatch：MI SYS将MI PASS的output task中的buffer传递到绑定的下级MI PASS的input queue。
	Min	Buffer产生到该MI PASS对应Flow所经过的最小延时。
	Max	Buffer产生到该MI PASS对应Flow所经过的最大延时。
	Avg	Buffer产生到该MI PASS对应Flow所经过的平均延时。
	Diff	Buffer产生到该MI PASS对应Flow所经过的当前延时。
Input port common info(only dump enabled Input port)	ChnId	该input port所在的channel id
	PortId	该input port的id
	SrcFrmrate	Src帧率
	DstFrmrate	Dst帧率
	user_buf_quota	该InputPort的buff数目的Quota
	UsrInjectQ_cnt	该InputPort 里的UsrInjectBufQueue里的buff数目
	UsrInjectQ_size	该InputPort 里的UsrInjectBufQueue里的buff的总的size
	BindInQ_cnt	该InputPort 里的BindInputBufQueue里的buff数目
	BindInQ_size	该InputPort 里的BindInputBufQueue里的buff的总的size
	WorkingQ_cnt	该InputPort 里的WorkingQueue里的buff数目
	WorkingQ_size	该InputPort 里的WorkingQueue里的buff的总的size
	usrLockedInjectCnt	用户当前拿到了多少个buf
Input port bind info(only dump enabled Input port)	ChnId	该input port所在的channel id
	PortId	该input port的id
	bind_module_id	与该input port 进行了binded的output port所在的module的id
	bind_module_name	与该input port 进行了binded的output port所在的module的name
	bind_ChnId	与该input port 进行了binded的output port所在的channel的id
	bind_PortId	与该input port 进行了binded的output port的id
Output port common info (only dump enabled Output port)	ChnId	该output port所在的channel的id
	PortId	该output port的id
	BufCntQuota	该OutputPort的 buff数目的Quota
	usrLockedCnt	从UsrGetFifoBufQueue里用户实际拿走了多少个buffer
	totalOutPortInUsed	totalOutputPortInUsedBuf数目
	DrvBkRefFifoQ_cnt	该OutputPort的DrvBkRefFifoQueue里的buffer数目
	DrvBkRefFifoQ_size	该OutputPort的DrvBkRefFifoQueue里的buffer的总size
	UsrGetFifoQ_cnt	该OutputPort的UsrGetFifoBufQueue里的buffer数目
	UsrGetFifoQ_size	该OutputPort的UsrGetFifoBufQueue里的buffer的总size
	WorkingQ_cnt	该OutputPort的WorkingQueue里的buffer数目
	WorkingQ_size	该OutputPort的WorkingQueue里的buffer的总size
Output port BindPeerInputPortList info(only dump enabled Output port)	ChnId	该output port所在的channel的id
	PortId	该output port的id
	bind_module_id	与该output port 进行了binded的input port list中的其中一个input port（以下简称该binded input port）所在的module的id
	bind_module_name	该binded input port所在的module的name
	bind_ChnId	该binded input port所在的channel id
	bind_PortId	该binded input port的id

11.2. echo¶

功能	获得模块的help信息
命令	echo help > /proc/mi_modules/[ModName]/[ModID]
参数说明	[ModName] 模块的名字 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 [ModID] 模块中对应的文件，一般为Module name +数字如mi_disp0 / mi_gfx0 / mi_rgn0
举例	echo help > /proc/mi_modules/mi_disp/mi_disp0 ; 得到mi_disp0 节点文件的帮助信息

功能	Dump Port 的信息
命令	`echo dump_buffer [ChnID] [PortType] [PortID] [QueueName][Path] [EndMethod] > /proc/mi_modules/[ModName]/[ModID]`
参数说明	[ChnID] 通道的ID [PortType] iport 或 oport 分别代表input port output port [PortID] 该port的id [QueueName] 如果是input port，值只能是"UsrInject" 或者"BindInput" , 如果是output port，值只能是"UsrGetFifo" [Path] 数据保存的文件路径。注意是绝对路径，系统会根据参数自动生成文件名，不同的buffer保存在不同的文件 [EndMethod] dump buffer的结束方法。仅支持三类： (1). "bufnum=xxx":dump指定数目的buffer (2) "time=xxx"(unit： ms):dump过程持续time对应的时间 (3). "start/end" pair:用start开始dump,用end结束dump,使用时其他5个参数需完全一致。 [ModName] 模块的名字 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 [ModID] 模块中对应的文件，一般为Module name +数字
举例	`echo dump_buffer 0 iport 0 BindInput /mnt bufnum=1 > /proc/mi_modules/mi_disp/mi_disp0` dump disp模块 iport 的数据

12. mi_dump_buffer_delay_worker¶

12.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

0 mi_disp 0 0 0 inport 0

Queue_name stored_dir dump_method dump_method_value

BindInput /mnt bunfnum 2

调试信息分析

/proc/mi_modules/mi_dump_buffer_delay_worker是和mi_modulenamedevid相连的概念，采用delay worker的方式dump device Queue里的buffer，可以通过对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,还是 output port
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方法对应的值.

12.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

13. module version¶

13.1. cat¶

调试信息

# cat /proc/mi_modules/mi_ai/module_version_file

MStar Module version: project_commit.sdk_commit.build_time
c1799df.fd2d52b.20171225180033

# cat /proc/mi_modules/mi_global_info

…..

MStar Module version: project_commit.sdk_commit.build_time
cb68bfd.44aca45.20171226100257

…..

调试信息分析

xxxx_version_file提供了version信息，/proc/mi_modules/mi_global_info里我们也提供了version信息，不过其本质上指的是mi_sys模块的version信息, 上面只是以mi_vi 和 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的时间也会有差别。

14. show threads¶

14.1. echo¶

调试信息

# echo show_threads > /proc/mi_modules/mi_sys/mi_sys0

<3>printk in _MI_SYS_IMPL_Common_WriteProc

<6>  task                PC stack   pid father

<6>busybox         S    1      0 0x00000000

<3>[<c01d3a6f>] (__schedule) from [<c01d3bb7>] (schedule+0x57/0x64)

<3>[<c01d3bb7>] (schedule) from [<c001bfbd>] (do_wait+0xed/0x134)

<3>[<c001bfbd>] (do_wait) from [<c001c367>] (SyS_wait4+0x69/0x7e)

<3>[<c001c367>] (SyS_wait4) from [<c000d2a1>] (ret_fast_syscall+0x1/0x54)

<6>kthreadd        S    2      0 0x00000000

<3>[<c01d3a6f>] (__schedule) from [<c01d3bb7>] (schedule+0x57/0x64)

<3>[<c01d3bb7>] (schedule) from [<c002b077>] (kthreadd+0x6d/0xf6)

<3>[<c002b077>] (kthreadd) from [<c000d381>] (ret_from_fork+0x11/0x30)

<6>ksoftirqd/0     S    3      2 0x00000000

<3>[<c01d3a6f>] (__schedule) from [<c01d3bb7>] (schedule+0x57/0x64)

<3>[<c01d3bb7>] (schedule) from [<c002c9af>] (smpboot_thread_fn+0xff/0x12c)

<3>[<c002c9af>] (smpboot_thread_fn) from [<c002a911>] (kthread+0xa1/0xb4)

<3>[<c002a911>] (kthread) from [<c000d381>] (ret_from_fork+0x11/0x30)

……

……

<6>du              R  running task     3641   3640 0x00000000

<3>[<c01d3a6f>] (__schedule) from [<c01d3c5b>] (preempt_schedule_common+0x1b/0x28)

<3>[<c01d3c5b>] (preempt_schedule_common) from [<c00a0c7f>] (__find_get_block+0x159/0x176)

<3>[<c00a0c7f>] (__find_get_block) from [<c00a1013>] (__getblk_gfp+0x11/0x1e2)

<3>[<c00a1013>] (__getblk_gfp) from [<c00a1a4d>] (__bread_gfp+0x7/0x86)

调试信息分析

打印当前所有线程的call stack。
参数说明

参数描述

show_threads task 线程名p->comm

state 线程运行状态

pid 线程的pid

father 线程的父进程id

flags low level flags

15. debug_frc¶

15.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

参数	描述
命令	Switch enable debug FRC:echo debug_frc on [Modid] [Devid] [Chnid] [Passid] [Portid] \"in/out\" > /proc/mi_modules/mi_sys/mi_sys0 Switch disable debug FRC:echo debug_frc \"off\" > /proc/mi_modules/mi_sys/mi_sys0
参数说明	[Modid] : module id。 [Devid] : device id。 [Chnid] : channel id。 [Passid] : pass id。 [Portid] : port id。

16. mi_deadlock_info¶

16.1. cat¶

调试信息

# cat /proc/mi_modules/mi_deadlock_info

thread_name:divp0_P0_MAIN pid:601 
owned_lock_name:mi_sys_global_devLastCmdqLock 
caller_func_name:mi_sys_internal_main_worker_thread 
caller_func_line:10157

调试信息分析

打印出可能造成deadlock的位置。

参数说明

参数		描述
deadlock Info	thread_name	造成deadlock的线程名字
	pid	线程的task pid
	owned_lock_name	锁的名字
	caller_func_name	拿锁的function name
	caller_func_line	拿锁的具体位置

17. mem_stat¶

17.1. cat¶

调试信息

# cat /proc/mi_modules/mi_sys_mma # cat 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的内存大小 pid
	sys-logBuffer	Sys log最大可申请的buf大小
	sys-logConfig	分配（申请）给sys log的buf大小
	TotalSize	ModuleUsdTotalSize 模块使用的size
	AllTotalSize	总的size

18. mi_infer_graph.py¶

18.1. cat¶

调试信息

# cat /proc/mi_modules/mi_infer_graph.py

调试信息分析

将其拷贝到文本里，然后在Linux server上使用pyhton2运行，会输出两张图片，默认的图片格式是简化版，一张是“infer_DAG”，一张是“perf_static”，其中一张输出的图片如下：

矩形框中表示的是 channel pass name；线上的label表示的是从哪个input port到哪个output port，以及bind type，和source frame rate、dest frame rate。

19. mi_graph_contrl¶

19.1. cat¶

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

命令的dump bind字段表示mi_infer_graph.py脚本输出的样式，off表示输出简化绑定关系图，on 表示输出详细绑定关系图。

19.2. echo¶

功能	控制python脚本输出的图片样式
命令	`echo [command] >/proc/mi_modules/mi_graph_contrl`
参数说明	[command] 命令: dump bind on:控制输出详细绑定关系图 dump bind off:控制输出简化绑定关系图
举例	输出详细绑定关系图： `# echo dump bind on > /proc/mi_modules/mi_graph_contrl` `# cat /proc/mi_modules/mi_infer_graph.py`

参数		描述
mi_log_info	log path	暂时无效果
	store path	暂时无效果
	Log module	各个模块的名称
	Level	打印等级

参数		描述
show_threads	task	线程名p->comm
	state	线程运行状态
	pid	线程的pid
	father	线程的父进程id
	flags	low level flags