MI调试手册

1. 概述¶

使用Linux下的porc文件系统，可以打印出各个模块当前的运行状态，便于调试及分析问题。每个模块都自己特定的路径，部分模块有额外的echo命令。

路径： /proc/mi_modules

表1-1 文件清单

2. SYS¶

2.1. common¶

2.1.1. dump_mmap¶

• 调试信息

  # ./config/dump_mmap
  

  

  图2-1

• 调试信息分析

  Common下的内容存放的是配置API，之所以会有配置API，有两个目的：

  1. 把iniparser放在用户态做，iniparser的任何开销不带入内核。

  2. 方便调试时确认配置文件的实际内容，因为在parser时打印的内容可能会与实际设置的内容有偏差

  为了达到上面两个目的，导出了一些文件。

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

  

  图2-2

  Systeminfo.c里面parse好的struct写入config_info里面。

  Pqloader.c里面parse好的struct写入pq_info和*_table里面，这里的table跟MISDK里面的那一份不一样的一点是这里的table是连续的内存摆放，MISDK是一个间接数组指向一列一维数组。

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

  

  图2-3

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

2.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.2. mi_log_info¶

2.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，同时示意了各module的debug_level的值。

• 参数分析

  表2-1

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

2.2.2. echo¶

表2-2

表2-3

表2-4

2.3. mi_global_info¶

2.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的一些信息。

• 参数分析

  表2-5

  参数		描述
  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的实际的名字
  MStar SDK version: commit.build_time	commit	sdk对应的commit
  	build_time	sdk的build时间
  CHIP_VERSION	CHIP_VERSION	当前chip的版本，版本号是U01,U02,U03…

2.4. mi_bufqueue_status¶

2.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
  
  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的信息。

• 参数分析

  表 2‑6

  参数		描述
  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数目

2.5. debug_level¶

2.5.1. cat/echo¶

• 调试信息

  # cat /proc/mi_modules/mi_sys/debug_level
  
  2
  

• 调试信息分析

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

  表 2‑7

  功能	打印警告级别
  命令	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的信息)

  表 2‑8

  功能	修改警告级别
  命令	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的信息

2.6. miu_protect¶

2.6.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相关的信息。

• 参数分析

  表 2‑9

  参数	描述
  kernel protect		值是enabled或者disabled，表示是否有enable kernel protect，默认是需要enable kernel 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的实际的名字。

2.7. mma_help_name¶

2.7.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的基本信息和当前的一些状态。

• 参数分析

  表 2‑10

  参数		描述
  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是否被alloc出去使用了。是的话该值为1；否则free状态的话该值为0
  	task_name	如果used flag为1，则task_name里存的是哪个task使用的它；否则该值为无效值NA

2.7.2. echo¶

表 2‑11

2.8. imi_mma_heap¶

2.8.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的基本信息和当前的一些状态。

• 参数分析

  表 2‑12

  参数		描述
  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
  	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所属的模块

2.9. vb_pool_qlobal¶

2.9.1. cat¶

• 调试信息

  # cat /proc/mi_modules/mi_sys_mma/vb_pool_global
  

  

  图 2‑4

• 调试信息分析

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

• 调试信息分析

  表 2‑13

  参数		描述
  	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

2.9.2. echo¶

表 2‑14

2.10. vb_pool¶

2.10.1. cat¶

• 调试信息

  # cat /proc/mi_modules/mi_sys_mma/vb_pool_mi_divp0
  

  

  图 2‑5

• 调试信息分析

  如果有config 某个device的vb pool, 那么会有/proc/mi_modules/mi_sys_mma/vb_pool_modnamedevid文件,其中modname形如divp,vpe等，devid形如0,1等。其和vb_pool_global的差别在于其对应的是该device,而vb_pool_global则是全局共享的vb pool。

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

2.10.2. echo¶

表 2‑15

2.11. meta¶

2.11.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了出来，等待被使用。

2.11.2. echo¶

表 2‑16

2.12. mi_modulenamedevid¶

2.12.1. cat¶

• 调试信息

  cat /proc/mi_modules/mi_disp/mi_disp0
  

  

  图 2‑6

• 调试信息分析

  cat操作的结果分为2部分：

  • 第一部分是MI_SYS提供的针对该device的通用的调试信息，从device、channel、input port、output port四个角度提供；

  • 第二部分是该device私有的信息。私有的信息各module的内容别处会阐述，这里SYS角度只阐述通用的信息。

  以cat /proc/mi_modules/mi_vdisp/mi_vdisp0为例，得到上面的结果。

• 参数说明

  表 2‑17

  参数		描述
  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
  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

2.12.2. echo¶

表 2‑18

表 2‑19

2.13. mi_dump_buffer_delay_worker¶

2.13.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相连的一个概念，dump device里的Queue里的buffer采用的是delay worker的方式实现的，可以通过对mi_dump_buffer_delay_worker的cat操作查看还有哪些delay worker正在进行中，echo force_stop_dump delay_worker_id强制结束指定的一个delay worker过程。

• 参数说明

  表 2‑20

  参数	描述
  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方法所对应的值.

2.13.2. echo¶

表 2‑21

2.14. module version¶

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

• 参数说明

  表 2‑22

  参数	描述
  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的时间也会有差别。

2.15. show threads¶

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

• 参数说明

  表 2‑23

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

2.16. debug_frc¶

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

  表 2‑24

  功能	打开对应port的frc debug。
  命令	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。 in/out : input or output port。
  举例	echo debug_frc on 12 0 0 0 0 "out" > /proc/mi_modules/mi_sys/mi_sys0

2.17. mi_deadlock_info¶

2.17.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的位置。

• 参数说明

  表 2‑25

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

3. AI¶

3.1. cat¶

• 调试信息

  

  图3-1

• 调试信息分析

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

• 参数说明

  表 3‑1

  参数		描述
  AI Device Attr(AI 设备属性)	AiDev	AI设备的名字
  	SamR	Sample Rate(采样率):8000, 16000, 32000, 48000
  	BitWidth	采样精度:16bit
  	SoundMod	声音模式 mono: 单声道 stereo: 立体声 queue: 所有声道都在一个buffer中
  	PtNumPerFrm	每帧的采样点个数:
  	TotalReadFrmCnt	从mhal读取数据的次数
  	ChnCnt	当前设备的通道数
  	I2sMode	I2S Rx的工作模式(仅设备为I2S Rx时有效) i2s-mas: I2S master i2s-sla: I2S slave tdm-mas: TDM master tdm-sla: TDM slave
  	I2sMclk	I2S Rx的Mclk的频率(仅设备为I2S Rx时有效) disable: 不使用Mclk 其他值为当前的Mclk频率
  	I2sFmt	I2S Rx的数据格式(仅设备为I2S Rx时有效) I2S-MSB: I2S格式 LEFT-MSB: I2S左对齐格式
  	bI2sSync	I2S RX和TX是否共用clock(仅设备为I2S Rx时有效) 1: 4 wire mode，RX和TX共用clock 0: 6 wire mode，RX和TX都有独立的clock
  	TdmSlots	I2S Rx的TDM slot数目(仅设备为I2S Rx为TDM模式时有效)
  	I2sBitWidth	I2S RX的位宽(仅设备为I2S Rx，且需要支持TDM模式的芯片有效)

  表 3‑2

  参数		描述
  AI Chn Status(AI 通道信息)	AiDev	AI设备的名字
  	AiChn	AI通道号
  	bChnEnable	AI通道是否使能 1: Enable 0: Disable
  	Volume	AI通道的增益设置：(前级增益，后级增益)，仅Amic/Line有两级增益，分别对应模拟增益和数字增益；Dmic仅有数字增益，I2S Rx不支持增益设置。
  	ReadFrmCnt	AI通道获取到的帧数
  	bMute	AI通道是否使用软件静音功能

3.1.1. echo¶

表3-3

表3-4

表3-5

4. AO¶

4.1. cat¶

• 调试信息

  # cat proc/mi_modules/mi_ao/mi_ao0
  

  

  图4-1

• 调试信息分析

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

• 参数说明

  表 4‑1

  参数		描述
  AO Device Attr(AO设备属性)	AoDev	AO设备名字
  	SamR	Sample Rate(采样率):8000, 11025, 16000, 22050, 24000, 32000, 44100, 48000
  	BitWidth	采样精度:16bit
  	SondMod	声音模式 mono：单声道 stereo：立体声
  	PtNumPerFrm	每帧的采样点个数
  	VolumeDb	AO设备的增益(左声道，右声道)
  	bStartPcmOut	是否起播
  	ChnCnt	AO设备通道数
  	TotalFrmCnt	APP送给AO设备的帧数
  	TotalSize	APP送给AO设备的数据量
  	I2sMode	I2S Tx的工作模式(仅设备为I2S Tx时有效) i2s-mas: I2S master i2s-sla: I2S slave tdm-mas: TDM master tdm-sla: TDM slave
  	I2sMclk	I2S Tx的Mclk的频率(仅设备为I2S Tx时有效) disable: 不使用Mclk 其他值为当前的Mclk频率
  	I2sFmt	I2S Tx的数据格式(仅设备为I2S Tx时有效) I2S-MSB: I2S格式 LEFT-MSB: I2S左对齐格式
  	bI2sSync	I2S RX和TX是否共用clock(仅设备为I2S Tx时有效) 1: 4 wire mode，RX和TX共用clock 0: 6 wire mode，RX和TX都有独立的clock
  	TdmSlots	I2S Tx的TDM slot数目(仅设备为I2S Tx为TDM模式时有效)
  	I2sBitWidth	I2S TX的位宽(仅设备为I2S Tx，且需要支持TDM模式的芯片有效)

  表4-2

  参数		描述
  AO Chn Status (AO 通道信息)	AoDev	AO设备的名字
  	AoChn	AO通道号
  	bMuteEnable	AO通道是否使能软件静音 1: Enable 0: Disable
  	RunTime	AO通道的使能时间(秒)

  表4-3

  参数		描述
  AO Chn Usr Queue Status(AO 通道Queue信息)	AoDev	AO设备的名字
  	AoChn	AO通道号
  	MaxSize	AO通道Queue的大小(byte)
  	RemainSize	AO通道Queue中当前的数据量(byte)
  	TotalSize	APP往AO通道送的数据量(byte)
  	RunTime	AO通道Queue的已创建的时间(秒)

4.2. echo¶

表 4‑4

表4-5

表4-6

表4-7

5. VIF 2.0¶

5.1. cat¶

• 调试信息

  #cat /proc/mi_modules/mi_vif/mi_vif0
  

  

  图5-1

• 调试信息分析

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

• 参数说明

  表 5‑1

  参数		描述
  Dev Attr	u32VifDevIdx	Dev号
  	Intf	输入数据的协议
  	Work	工作模式，Runmode
  	Clk	时钟边沿触发模式，与Intf有关系
  	Hdr	Hdr类型
  	IsrCnt	Frame start callback count
  	AsyncCnt/EnqCnt/ BarCnt/CheckCnt/ DequCnt	Callback接口执行次数

  
  表 5‑2

  参数		描述
  OutPort Attr	Chn	Channel id
  	Pipe	Pipe id
  	Port	Port id
  	Cap_size	输入size
  	Dest_size	输出size
  	Sel	帧场选择
  	Scan	扫描模式，P or I
  	Fmt	Out put pixel format
  	Rate	Frame rate type
  	LineCnt	Frame mode line count
  	Atom	底层拿住buffer 数量
  	MetaInfo	Frame id
  	Outcount	输出frame count
  	Failcount	获取outputbuffer失败次数
  	Fps	Frame per second
  	Recv_size	Vif 硬件收到size
  	Out_size	Write dma size
  	SubOut_size	Write sub dma size
  	ReadIdx/WriteIdx/ DequeIdx	Read,write,deque的index
  	FrameStartCnt	处理到第几frame
  	FrameDoneCnt	处理完多少frame
  	VbFail	VbFail计数
  	DropFrameCnt	Drop frame的数量
  	RingBufStatus	Ring buf 状态

5.1.1. echo¶

表 5‑3

表 5‑4

表 5‑5

6. VIF 3.0¶

6.1. cat¶

• 调试信息

  #cat /proc/mi_modules/mi_vif/mi_vif0
  

  

  图6-1

• 调试信息分析

  记录当前VIF的使用状况以及Group/ Dev/ pipe/ outport属性，可以动态地获取到这些信息，方便调试和测试。

• 参数说明

  表6-1

  参数		描述
  Group Attr	GroupId	Dev号
  	Intf	输入数据的协议
  	Work	工作模式
  	Clkedge	时钟边沿触发模式，与Intf有关系
  	Hdr	Hdr类型

  表6-2

  参数		描述
  Dev Attr	Dev	Dev号
  	IsrCnt	收到的中断总数
  	incrop	Input Corp Size
  	infmt	输入数据格式
  	AsyncCnt/EnqCnt/ BarCnt/CheckCnt/ DequCnt	Callback接口执行次数

  表6-3

  参数		描述
  Pipe Attr	PipeId	Pipe号
  	PortId	Port号
  	DevId	Dev号
  	Hdn	Hdn使能
  	crop	Input Corp Size
  	Dest	Output Size
  	Pixel	Output Pixel
  	wkmode	Pipe工作模式
  	Fbc	Fbc使能

  表6-4

  参数		描述
  OutPort Attr	Dev	Channel id
  	Port	Pipe id
  	Cap_size	输入size
  	Dest_size	输出size
  	Fmt	Out put pixel format
  	Rate	Frame rate type
  	Atom	底层拿住buffer 数量
  	MetaInfo	Frame id
  	OutCount	输出frame count
  	Addr0Cnt	Frame地址0的次数
  	FailCount	获取outputbuffer失败次数
  	Fps	Frame per second
  	Recv_size	Vif 硬件收到size
  	Out_size	Write dma size
  	SubOut_size	Write sub dma size
  	ReadIdx/WriteIdx/ DequeIdx	Read,write,deque的index
  	FrameStartCnt	处理到第几frame
  	FrameDoneCnt	处理完多少frame
  	VbFail	VbFail计数
  	DropFrameCnt	Drop frame的数量
  	RingBufStatus	Ring buf 状态

6.2. echo¶

# echo help >/proc/mi_modules/mi_vif/mi_vif0

图6-2 Echo help 查看可用命令

表6-5

表6-6

表6-7

表6-8

表6-9

7. VPE¶

7.1. cat¶

• 调试信息

  # cat /proc/mi_modules/mi_vpe/mi_vpe0
  

  

  图 7‑1

  

  图 7‑2

• 调试信息分析

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

• 参数说明

  表 7‑1

  参数	描述
  Device Info	DevID	0, 只有一个Device, ID为0
  	InitCnt	发生connected module次数
  	CreChnNum	创建Channel 数量
  	Point	运行节点停住行号
  	scllevel	Scl½ level
  	chip	Chip number
  	cmdq(0,1,2)	Cmdq 指针，确认是否和其它pass有共用Cmdq
  	IrqName	IRQ类别
  	En	IRQ 使能状况
  	Mode	IRQ 模式
  	num	IRQ ID
  	VsyncCnt	ISR vsync Cnt
  	FrameDoneCnt	ISR Frame Done Cnt
  	DropCnt	IRQ Frame Drop or Double Vsync
  	LowLatencyIsrCnt	Low Lantency Mode Match Line IRQ Cnt

  表 7‑2

  参数	描述
  Channel Info	ChnId	Channel ID
  	status	E_MI_VPE_CHANNEL_STATUS_INITED = 0, E_MI_VPE_CHANNEL_STATUS_START, E_MI_VPE_CHANNEL_STATUS_STOP, E_MI_VPE_CHANNEL_STATUS_DESTROYED, E_MI_VPE_CHANNEL_STATUS_NUM,
  	MaxWH	Max width/height
  	bEnLdc	Ldc 使能
  	ChnPortMode	Port mode,通过该参数选择SCL source是来自ISP Realtime还是RDMA
  	SensorId	Bind sensorId
  	RunMode	VPE Running mode :VIF-VPE
  	Crop	Channel Crop位置
  	Rot	Rotation 角度
  	Mirror/Flip	Chn 水平/竖直 翻转
  	Gardient	Isp画面复杂度
  	ActEn	ISP->SCL 连接状态 等于0代表有realtime连接
  	3DNRLevel	3dnr level
  	HdrMode	Hdr 类型
  	passid	passid
  	bUsed	Pass 是否使用
  	InSize	input width/height
  	Inpixel	Input Pixel format
  	InStride	Input buffer stride
  	SclOutMode	Scl output mode设置
  	SclInSize	Scl input size
  	Atom	底层拿住buffer 数量
  	Atom0Cnt	释放buffer后底层没有buffer数量
  	PreCnt/EnqCnt/BarCnt/checkin/ checkout/DeqCnt/DropCnt	Callback 接口执行次数
  	EnqOTNull	Enq时OutBuffer 为Null次数统计

  表 7‑3

  参数	描述
  Outputport Info	ChnId	Channel ID
  	PortId	Port ID
  	passid	Pass ID
  	bindtype	0: Real Time mode 1: Ring mode 2: frame mode
  	Enable	使能状态
  	Pixel	Output pixel format
  	bMirr/flip	Port 水平/竖直 翻转
  	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

7.2. echo¶

# echo help > /proc/mi_modules/mi_vpe/mi_vpe0

图 7‑3

Echo help 查看可用命令

表 7‑4

表 7‑5

表 7‑6

表 7‑7

表 7‑8

表 7‑9

表 7‑10

表 7‑11

表 7‑12

表 7‑13

表 7‑14

表 7‑15

表 7‑16

表 7‑17

表 7‑18

8. VENC¶

8.1. cat¶

• 调试信息

  #cat /proc/mi_modules/mi_venc/mi_vencN   //Venc 3.0之前，N取0/1，0表示编码h264和h265的device0,1表示编码jpeg的device1；Venc 3.0，N取0/8，0表示编码h264/h265的device0，8表示编码jpeg的device8。
  

  

  图7-1

• 调试信息分析

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

• 参数说明

  表 8-1

  参数		描述
  Dev info	DevId	设备号，作为Dev ID使用 (对映内核MI_VENC_Dev_e)
  	IrqNum	中断号
  	IsrTotalCnt	各种类型的irq总数
  	IsrFrmDoneCnt	frame done类型的irq总数
  	IsrBufFullCnt	buffer full类型的irq总数
  	IsrSliceDoneCnt	slice done的isr 总数
  	IsrRingFullCnt	ring buffer full类型的irq总数
  	IsrTimeoutCnt	超时的isr总数
  	IsrOtherCnt	other类型的irq总数
  	MaxTaskCnt	支持同时处理的最多task个数
  	WorkingTaskCnt	正在处理的task个数
  	SupportRing	是否支持HW RING
  	SupportImi	是否支持HW REALTIME
  	NeedPadding	是否需要MI SYS clear padding
  	CmdqHandle	cmdq handle value
  	CmdqBufSize	CmdqBufSize
  	ResetTime	设备重启时间
  	MaxW	设备使用最大分辨率的宽度
  	MaxH	设备使用最大分辨率的高度
  	AlignMaxw	对齐的最大宽度
  	AlignMaxH	对齐的最大高度

  表7-2

  参数		描述
  CHN info	ChnId	Channel ID 通道号
  	bStart	是否已开始接收数据
  	RefMemPA	底层driver要求的硬件物理位址
  	RefMemSize	底层driver要求的硬件内存大小
  	AlMemPA	底层driver要求的CPU物理位址
  	AlMemVA	底层driver要求的CPU虚拟位址
  	AlMemSize	底层driver要求的CPU内存大小
  	State	底层处理状态: typedef enum { E_MI_VENC_BUFSTATE_IDLE = 0, E_MI_VENC_BUFSTATE_ENCODE, E_MI_VENC_BUFSTATE_WAIT_CMDQ, E_MI_VENC_BUFSTATE_CHECK, E_MI_VENC_BUFSTATE_DROP, E_MI_VENC_BUFSTATE_DROP_FORCE, E_MI_VENC_BUFSTATE_RECOVER, E_MI_VENC_BUFSTATE_BUF_FULL, E_MI_VENC_BUFSTATE_MAX } MI_VENC_BufferState_e;
  	EnPred	代表base层的帧是否被base层其它帧用作参考
  	base	base层的周期，取值范围：（0, +∞）
  	enhance	enhance层的周期，取值范围：[0, 255]
  	MaxStreamCnt	最大输出缓存张数
  	FrameIdx	当前frame的序号： before venc3.0, 取值为：1，2，3，4 after venc3.0,取值为：1，2，4
  	Gardient	前端isp传递过来的梯度值
  	Fps_1s	统计1s内的输出帧率
  	kbps	统计1s内的输出码率
  	Fps10s	统计10s内的输出帧率
  	kbps	统计10s内的输出码率
  	RingBufStartLine	ring start line in ring mode
  	RingBufHeight	ring buffer height in ring mode
  	QueryCnt	APP调用MI_VENC_Query的次数
  	GetStreamCnt	APP调用MI_VENC_GetStream的次数
  	RlsStreamCnt	APP调用MI_VENC_ReleaseStream的次数
  	PollReadyCnt	APP调用select/poll成功的次数
  	PollFailCnt	APP调用select/poll失败的次数

  表 8-3

  参数		描述
  Inputport info	ChnId	Channel ID 通道号
  	Width	画面宽度 (pixels)
  	Height	画面高度 (pixels)
  	SrcFrmRate	来源每秒帧数，通常以此作为rate control的参数
  	MaxW	最大画面宽度 (pixels)
  	MaxH	最大画面高度 (pixels)
  	FrameCnt	已处理的帧数
  	DropFrameCnt	已丢弃的帧数
  	BlockCnt	已接收到的不过由于当前还在处理上一张input picture从而rewind的input picture总数

  表 8-4

  参数		描述
  Outputport info	ChnId	Channel ID 通道号
  	CODEC	使用何种CODEC: H264,H265,MJPG Profile Profile值
  	BufSize	由user设定的每帧最大缓存 (bytes)
  	MinAllocSize	允许的最小的Size
  	RefNum	最大参考帧数
  	bByFrame	后级是否一次取走一帧？ 0：否，通常代表按包取数据 1：是
  	FrameCnt	已处理的帧数
  	DropCnt	已经编码完但丢掉的帧总数
  	ReEncCnt	重编码的帧总数
  	RingUnreadCnt	output pool里还未被取走的帧总数
  	RingTotalCnt	output pool里的帧总数
  	UsrLockedCnt	user已拿住的帧总数
  	RateCtl	Rate Control的算法：CBR, VBR, FixQp等
  	GOP	Group of Picture大小
  	MaxBitrate	CBR, VBR时，最大的目标码率。(bits per second)
  	IPQPDelta	平均QP值与当前I帧QP的差值
  	MaxQp	VBR时，允许的最大QP
  	MinQp	VBR时，允许的最小QP
  	MaxIQP	VBR时，允许的最大的I帧QP
  	MinIQP	VBR时，允许的最小的I帧QP
  	QpMap	QPMAP模式下允许用户自由决定码率控制的策略
  	AbsQp	使用绝对Qp的值
  	ModeMap	0 decided byhw；1 force skip；2 force intra

8.2. echo¶

表 8-5

表 8‑6

表 8‑7

表 8-8

表 8-9

表 8-10

表 8-11

表 8-12

表 8-13

表 8-14

表7-15

表 8-16

表 8-17

表 8-18

表 8-19

表 8-20

9. DIVP¶

9.1. cat¶

• 调试信息

  # cat /proc/mi_modules/mi_divp/mi_divp0
  

  

  图 9‑1

  

  图 9‑2

  

  图 9‑3

• 调试信息分析

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

• 参数说明

  表 9‑1

  参数	描述
  channelinfo	ChnId	0~16 16 Capture Channel 不对上层开放
  	Status	0 INITED 1 CREATED 2 STARTED 3 STOPED 4 DISTROYED
  	AttrChg	0：not change 1：changed
  	FieldType0, FieldType1 (last two fields's type)	0 NONE, //\< no field. 1 TOP, //\< Top field only. 2 BOTTOM, //\< Bottom field only. 3 BOTH, //\< Both fields. 4 NUM
  	ChnAttrPre	channel的上一次设置属性
  	ChnAttrOrg	channel的原始设置属性
  	CropX，CropY，CropW，CropH	上层设置的crop位置
  	bHMirror bVMirror	水平翻转使能 垂直翻转使能 0:disable 1:enable
  	eDiType	0 OFF,//off 1 2D,///2.5D DI 2 3D,///3D DI 3 NUM,
  	eRotateType	0 NONE, //Rotate 0 degrees 1 90, //Rotate 90 degrees 2 180, //Rotate 180 degrees 3 270, //Rotate 270 degrees 4 NUM,
  	eTnrLevel	0 OFF, 1 LOW, 2 MIDDLE, 3 HIGH, 4 NUM,

  表 9-2

  参数	描述
  inputport info	ChnId	Channel ID 0~16
  	InputChg	input port 属性是否发生变化
  	bIPChg	0 隔行和逐行之间没有发生变化 1 隔行切换到逐行，or 逐行到隔行
  	PreWidth	input port width
  	PreHeight	input port height
  	Pixel	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_RGB565, E_MI_SYS_PIXEL_FRAME_ARGB1555, 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_MST_420, //vdec mstar private video format E_MI_SYS_PIXEL_FRAME_YC420_MSTTILE1_H264, E_MI_SYS_PIXEL_FRAME_YC420_MSTTILE2_H265, E_MI_SYS_PIXEL_FRAME_YC420_MSTTILE3_H265, E_MI_SYS_PIXEL_FRAME_FORMAT_MAX
  	Stride	Input的stride
  	2Pmode	b2P_Enable值，1表示enable，0表示disable
  	EnqueueTask	Enqueue的task数目
  	GetInTaskCnt	OnPreProcessInputTask的task数目

  表8-3

  参数	描述
  Outputport Info	ChnId	Channel ID 0~16
  	OutputChg	Output 属性是否发生变化 0: not change 1: changed
  	Pixel	同input pixel
  	CompMode	0 //no compress 1 //compress unit is 256 bytes as a segment 2 //compress unit is the whole line 3 //compress unit is the whole frame 4 //number
  	PreWidth PreHeight	上一次设置的output port 宽和高
  	Stride	Output 的stride
  	phyaddr	Ouput buffer 的物理地址
  	FinishTaskCnt	Finish task的数目
  	fps	Output port的帧率

  表 9-4

  参数	描述
  Common Info	ChnNum	Channel的总数
  	Pixel	同input pixel
  	PassNum	Pass的总数
  	InPortNum	Input port的个数
  	OutPortNum	Output port的个数
  	CollectSize	Attach的pstAllocator数目
  	current_buf_size	当前申请的内存大小
  	Peak_buf_size	使用内存的峰值
  	user_pid	进程id
  	user_buf_quota	User可以拿的buffer最大个数
  	UsrInjectQ_cnt	User inject buffer个数
  	BindInQ_cnt	前端给input port enqueue的buffer个数
  	TotalPendingBuf_size	当前input working队列中各个task总共所占的buffer size
  	usrLockedInjectCnt	用户拿到buffer的个数
  	newPulseQ_cnt	new_pulse_fifo_inputqueque的buffer个数
  	nextTodoPulseQ_cnt	next_todo_pulse_inputqueue的buffer个数
  	curWorkingQ_cnt	cur_working_input_queue的buffer个数
  	workingTask_cnt	input_working_tasklist的task个数
  	lazzyRewindTask_cnt	需要retry的task个数
  	bind_module_id	绑定的模块id
  	bind_module_name	绑定的模块名字
  	bind_ChnId	绑定模块的channel id
  	bind_PortId	绑定模块的port id
  	bind_Type	绑定方式： 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
  	bind_Param	绑定的参数
  	SrcFrmrate	source 帧率
  	DstFrmrate	destination帧率
  	GetFrame/Ms	实际帧数/所用时间
  	FPS	实际帧率
  	RewindCnt	需要retry的task个数
  	usrDepth	User可以拿到output port buffer的最大个数
  	BufCntQuota	Output 可以申请buffer的最大个数
  	usrLockedCnt	User实际拿到的buffer个数
  	totalOutPortInUsed	Outport实际申请到的buffer个数
  	DrvBkRefFifoQ_cnt	for special driver which need to refer back pre-processed buffer
  	DrvBkRefFifoQ_size	stDrvBkRefFifoQueue 所占用的buffer size总数
  	UsrGetFifoQ_cnt	Duplicate 到output port的buffer个数
  	UsrGetFifoQ_size	Duplicate 到output port的buffer所占的总大小
  	UsrGetFifoQ_seqnum	output拿到buffer的总数
  	UsrGetFifoQ_discardnum	Output由于申请新的buffer需求而遗弃原来buffer的个数
  	finishedTask_cnt	Output finish task的个数
  	GetTotalCnt	Output拿到buffer总个数
  	GetOkCnt	统计index为E_MI_SYS_FRC_OBTAIN的帧数
  	ISRNum	收到的中断总数

9.2. Echo¶

表 9-5

表 9-6

表 9-7

表 9-8

表 9-9

10. VDISP¶

10.1. cat¶

• 调试信息

  # cat proc/mi_modules/mi_vdisp/mi_vdisp0
  
  ============================Private Vdisp0 Info ===============================
  
  DevStatus
  
  Start
  
  ------------------------------------------------------- Input Port Info
  ---------------------------------------------
  
  PortID PortStatus ChnX ChnY ChnW ChnH IsFreeRun TryOk RecvOk
  
  0 Enabled 0 0 960 540 1 245356299 313332
  
  1 Enabled 960 0 960 540 1 355670297 313332
  
  2 Enabled 0 540 960 540 1 578760014 313331
  
  3 Enabled 960 540 960 540 1 757579130 313330
  
  ------------------------------------------------------ Output Port Info
  -------------------------------------------------
  
  Inited FrmInterval BgColor PixelFmt FrmRate Width Height SendOk
  
  1 33333 8388736 0 30 1920 1080 471418
  

• 调试信息分析

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

• 参数说明

  表 10‑1

  参数	描述
  device info	DevStatus	Vdisp设备的工作状态 Uninit：未初始化 Init：初始化 Start：运行状态 Stop：停止状态

  表 10‑2

  参数	描述
  layer info	PortID	Inport ID 取值范围：[0~16]，16为overlay通道，即PIP通道。
  	PortStatus	Port口状态 Uninit：inport未初始化 Init：inport已初始化 Enabled：inport已经使能 Disabled：inport已经禁用
  	ChnX	输入inport的起始坐标X地址 取值范围：[0~4094]，需要根据chip的align对齐
  	ChnY	输入inport的起始坐标Y地址 取值范围：[0~2159]
  	ChnW	输入inport的图像宽度，需要根据chip的align对齐 取值范围：[0~4096]
  	ChnH	输入inport的图像高度 取值范围：[0~4096]
  	IsFreeRun	是否不做帧率控制 0：按pts控制播放 1：自由播放
  	TryOk	尝试取前级绑定端口的数据次数
  	RecvOk	从前级绑定端口成功拿到数据的次数

  表 10‑3

  参数	描述
  Output port info	Inited	是否有初始化Output Port 0：未初始化 1：已初始化
  	FrmInterval	出帧时间间隔，单位US
  	BgColor	背景色，此处打印的是10进制
  	PixelFmt	色彩空间 取值范围[0~E_MI_SYS_PIXEL_FRAME_FORMAT_MAX-1] 0-YUYV422，9-YUVSP420
  	FrmRate	输出帧率
  	Width	图像输出宽度 取值范围[0~4096]，需要根据chip的align对齐
  	Height	图像输出高度 取值范围：[0~2160]，需要根据chip的align对齐
  	SendOk	成功推往后级的帧数统计

11. DISP¶

11.1. cat¶

• 调试信息

  # cat /proc/mi_modules/mi_disp/mi_disp0
  
  ============================== disp dev info ============================
  DevStatus         IrqNum         IrqCnt        BgColor
  1             31              0         800080
  ================================ disp layer info ===========================
  LayerId          BindedDevID           LayerWidth           LayerHeight
      0                    0                    0                     0
  LayerId          LayDispWidth        LayDispHeight         Toleration           rotatemode
      0              1024                  600                 0                 NONE
  --------------------------------- disp layer[0] port Info ---------------------------------
  PortId    enable    CurStatus     src_w     src_h    crop_x    crop_y    crop_w    crop_h    show_x 
  0         1          0         1024      600       0         0        1024      600        0
  show_y    show_w    show_h
  0        1024       600
  PortId     RecvBufCnt      RecvBuf_W      RecvBuf_H      Content_W      Content_H  RecvBufStride
  0           1661           1024            600           1024            600           1024
  PixFmt              syncmode
  semiplanar_420           Invalid
  PortId     OnScreenTask      FiredTask    LastDropTask    DropTaskCnt    StepTaskCnt   bClearAllTask
  0           (null)          c2639db8       (null)              0              0              0
  fps
  0
  

• 调试信息分析

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

• 参数说明

  表 11‑1

  参数	描述
  device info	DevStatus	使能或者禁用 0：禁用 1：使能
  	IrqNum	中断号
  	IrqCnt	中断发生次数
  	BgColor	背景色（RGB format）

  表 11-2

  参数	描述
  layer info	LayerId	layer ID 取值范围：[0~1]
  	BindedDevID	绑定的device ID 取值范围：[0~1]
  	LayerWidth	Layer的宽
  	LayerHeight	Layer的高
  	LayDispWidth	Layer显示的宽
  	LayDispHeight	Layer显示的高
  	Toleration	PTS误差允许阈值，单位毫秒
  	rotatemode	旋转模式 取值范围： [E_MI_DISP_ROTATE_NONE~E_MI_DISP_ROTATE_270]
  表10-3

  参数	描述
  port info port info	PortId	port ID 取值范围：[0-15]
  	enable	使能或者禁用 0：禁用 1：使能
  	CurStatus	port状态 取值范围：[E_MI_LAYER_INPUTPORT_STATUS_INVALID~ E_MI_LAYER_INPUTPORT_STATUS_HIDE]
  	src_w	原始图像宽度
  	src_h	原始图像高度
  	crop_x	局部放大区域起始横坐标
  	crop_y	局部放大区域起始纵坐标
  	crop_w	局部放大区域宽度
  	crop_h	局部放大区域高度
  	show_x	该port在layer上的起始横坐标
  	show_y	该port在layer上的起始纵坐标
  	show_w	该port显示的宽度
  	show_h	该port显示的高度
  	RecvBufCnt	当前接收到buff的总量
  	RecvBuf_W	输入的图像宽
  	RecvBuf_H	输入的图像高
  	Content_W	输入图像有效宽
  	Content_H	输入图像有效高
  	RecvBufStride	输入图像的lineoffset
  	PixFmt	输入图像像素格式
  	syncmode	Check PTS/Free Run 0：无效 1：Check PTS 2：Free Run
  	OnScreenTask	当前正在显示的Task
  	FiredTask	即将要显示的Task
  	LastDropTask	刚释放掉的Task
  	DropTaskCnt	丢弃掉的Task数量
  	StepTaskCnt	步进处理的Task数量
  	bClearAllTask	是否丢弃所有Task 0：不丢弃 1：丢弃所有Task
  	fps	帧率

12. HDMI¶

12.1. cat¶

• 调试信息

  # cat /proc/mi_modules/mi_hdmi/mi_hdmi0
  
  --------------------------------------- HDMI0 Dev Info
  -------------------------------------
  
  InitFlag AvMute PowerOn
  
  Y N Y
  
  EnableVideo TimingType OutputMode ColorType DeepColorMode
  
  1 9 0 2 4
  
  EnableAudio IsMultiChannel BitDepth CodeType SampleRate
  
  1 0 16 0 3
  

• 调试信息分析

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

• 参数说明

  表 12‑1

  参数	描述
  device info	InitFlag	HDMI模块是否初始化 Y：已初始化 N：未初始化
  	AvMute	音视频是否处于MUTE状态 Y：被MUTE N：未被MUTE
  	PowerOn	HDMI是否使能电源管理 Y：是 N：否
  	EnableVideo	是否使能视频 0：未使能 1：使能
  	TimingType	当前HDMI的输出分辨率 取值范围[0~ E_MI_HDMI_TIMING_MAX]
  	OutputMode	HDMI输出模式 0：HDMI模式 2：DVI模式 ⅓为HDCP模式，当前暂不支持
  	ColorType	颜色空间 0：RGB44 1：YUV422 2：YUV444 3：YUV420
  	DeepColorMode	色彩位深 0：8Bit 1：10Bit 2：12Bit 3：16Bit
  	EnableAudio	是否使能音频 0：未使能 1：使能
  	IsMultiChannel	是否多通道 0：否 1：是
  	BitDepth	音频采样位深 8：8Bit 16：16Bit 32：32Bit
  	CodeType	音频输出的压缩格式 0：PCM 1：非PCM
  	SampleRate	音频输出采样率 0：未知 1：32K 2：44K 3：48K 4：88K 5：96K 6：176K 7：192K

13. FB¶

13.1. cat¶

• 调试信息

  # cat /proc/mi_modules/mi_fb0
  
  ############################ 13.1.1. OnDumpOSDAttr####################################
  Framebuffer id = MStar FB0
  xres=1280, yres=720
  xres_virtual=1280, yres_virtual=1440
  xoffset=0,yoffset=0
  fix.line_length=0xa00 Bytes
  fix.smem_start=0xf800000
  Memory Size=0x400000 Bytes
  Gop ID=0
  Gwin ID=0
  Open Count=1
  Visible State=0
  MIU Sel=0
  ColorSpace=YUV
  ColorFomrmat=ARGB1555
  StretchWindow Pos[0,0]
  StretchWindow Src[1280,720],StretchWindow Dst[1920,1080]
  Gwin Pos[0,0]
  Gwin Size[1280,720]
  Gwin PhyAddr=0x0
  ColorKey Enable=0
  ColorKey Val=[0,0,0]
  Enable Alpha Blend=1
  Enalbe Multi Alpha=0
  Global Alpha Val=0x0
  Alpha0=0x0,Alpha1=0x0,(Only for ARGB1555)
  GOP Hstart=192
  Current TimingWidth=1920,TimingWidth=1080,hstar=192
  ################################## 13.1.1.1. end##########################################
  
  #########################OnDumpHwcursorAttr####################################
  Cursor Gop ID=4
  Cursor Gwin ID=6
  Cursor MIU Sel=0
  Cursor PhyAddr=0x166000
  Cursor ColorFmt=ARGB8888
  Cursor Icon Width=44,Height=56
  Cursor HotSpot[18,9]
  Cursor request pos[712,207]
  Cursor Visible=1
  Cursor Gwin Pos[694,198]
  Cursor Gwin Size[44,56]
  Cursor Gwin Pitch=0x200 Bytes
  Curosr StretchWindow pos[0,0]
  Cursor StretchWin Src[1280,720],Dst[1920,1080]
  Cursor ColorKey Enable=0
  Cursor ColorKey Value=[0xff,0xff,0xff]
  ############################OnDumpHwcursorAttr#################################
  

• 调试信息分析

  记录当前Fbdev && Hwcursor的使用状况以及OSD图层属性、OSD device属性、Hwcursor属性，可以动态地获取到这些信息，方便调试和测试。

• 参数说明

  表 13‑1

  参数	描述
  OSD info	Framebuffer id	Framebuffer设备ID
  	xres	可见分辨率宽度
  	yres	可见分辨率宽高度
  	xres_virtual	虚拟分辨率的宽度
  	yres_virtual	虚拟分辨率的高度
  	xoffset	可见分辨率到虚拟分辨率的x偏移量
  	yoffset	可见分辨率到虚拟分辨率的y偏移量
  	fix.line_length	虚拟分辨率每行的字节数
  	fix.smem_start	帧缓冲内起始地址
  	Memory Size	帧缓冲内存长度，单位字节数

  表 13‑2

  参数	描述
  OSD device info	Gop ID	图层硬件ID
  	Gwin ID	图层硬件显示窗口ID
  	Open Count	该图形层打开次数。在用户调用open()时增1；调用close()时减1
  	Visible State	该图层显示状态。 取值:{1表示可见，0表示不可见} 用户显示调用FBIOSET_SHOW去设置图层可见状态。
  	MIU Sel	保存帧缓冲数据的物理内存编号。 对于MSR620设备该值为0
  	ColorSpace	该图形层输出的颜色空间。 取值:{YUV表示输出YUV color space;RGB表示输出RGB color space }。默认为YUV
  	ColorFomrmat	图形层格式 取值:{ARGB1555,ARGB4444,ARGB8888,RGB565}。 用户设置可变屏幕信息中的格式项后更新
  	StretchWindow Pos	图形层在显示设备上的起始位置。 单位:像素 默认为0,用户可调用FBIOSET_SCREEN_LOCATION去设置
  	StretchWindow Src	图形层原始分辨率的宽度和高度。 单位:像素 通过硬件放大功能放大到当前timing。用户设置可变屏幕信息中的可见分辨率后更新
  	StretchWindow Dst	图形层在显示设备上的宽度和高度。 默认设置为输出timing大小。可以通过FBIOSET_SCREEN_LOCATION去设置
  	Gwin Pos	图形层显示窗口的起始位置 单位:像素 对于OSD图层来说,该值总是为(0,0)
  	Gwin Size	图形层显示窗口的宽度、高度。 单位:像素 对于OSD图层来说，该值总是被设置为可见分辨率的宽度、高度。用户设置可变屏幕信息中的可见分辨率后更新。
  	Gwin PhyAddr	图形层当前显示数据的物理地址
  	ColorKey Enable	图形层ColorKey是否使能 取值:{0表示Disable ColorKey; 1表示Enable ColorKey}用户设置可通过FBIOSET_COLORKEY去设置
  	ColorKey Val	图形层ColorKey的RED,GREEN,BLUE通道数值 取值:每个通道的取值范围从0-255。ColorKey val的数值用RGB888格式表示 用户可通过FBIOSET_COLORKEY去设置后更新
  	Enable Alpha Blend	图形层alpha是否使能。 取值:{0表示否，1表示是},默认为1。 用户可通过FBIOSET_GLOBAL_ALPHA去设置后更新。 该项关闭，则像素alpha配置不生效。该项开启且Enable Multi Alpha关闭,仅像素alpha生效(对于ARGB1555格式,Alpha bit为1的像素使用Global Alpha作为像素alpha,Alpha bit为0的像素使用0xff作为像素alpha)。当该项目开启且Enable Multi Alpha生效时,则像素alpha和Global Alpha都生效
  	Enable Multi Alpha	全局alpha是否生效开关 取值{0时，1否}默认值为0 Enable Multi Alpha使能，Global Alpha便生效
  	Global Alpha Val	全局Alpha
  	Alpha0	ARGB1555格式时，当最高位为0时,选择Alpha0作为Alpha混合的的Alpha数值 取值: 0~255默认为0
  	Alpha1	ARGB1555格式时，当最高位为1时，选择Alpha1作为Alpha混合的Alpha数值 取值: 0~255默认为0
  	GOP Hstart	图层硬件向对于显示窗口的偏移。 取值:该值和当前输出timing相关，当输出timing发生变化时，通过FBIOSET_DISPLAYLAYER_ATTRIBUTES并将输入参数MI_FB_DisplayLayerAttr_s的u32SetAttrMask数值包含E_MI_FB_DISPLAYLAYER_ATTR_MASK_SCREEN_SIZE mask位来通知图层驱动输出timing发生变化。图层驱动会根据当前timing设置相应的hstart数值
  	Current TimingWidth,	当前输出timing的宽度、高度以及当前timing下应该给图形层硬件设置的像对于显示窗口的偏移。 该项与GOP Hstart配合使用，用于检查设置给硬件图层的hstart数值是否和当前timing一致。
  	Current TimingHeight,
  	hstar

  表 13‑3

  参数	描述
  Hwcursor info	Cursor Gop ID	鼠标图层硬件ID
  	Cursor Gwin ID	鼠标图层硬件显示窗口ID
  	Cursor MIU Sel	用于保存鼠标图标数据的物理内存编号。 对于MSR620设备该值为0
  	Cursor PhyAddr	鼠标层当前显示数据的物理地址
  	Cursor ColorFmt	鼠标图层格式 值:{ARGB1555,ARGB4444,ARGB8888,RGB565}。 用户可通过FBIOSET_CURSOR_ATTRIBUTE 设置
  	Cursor Icon Width	鼠标图标的宽度、高度。 单位：像素 用户可通过FBIOSET_CURSOR_ATTRIBUTE设置
  	Cursor HotSpot	鼠标图标的热点信息 单位:像素 热点信息通常和鼠标图标相关，用户可通过FBIOSET_CURSOR_ATTRIBUTE设置
  	Cursor request pos	鼠标图标的位置信息 单位: 像素 用户通过FBIOSET_CURSOR_ATTRIBUTE设置
  	Cursor Visible	鼠标图层是否可见 取值:{0,表示不可见，1表示可见} 用户通过FBIOSET_CURSOR_ATTRIBUTE设置
  	Cursor Gwin Pos	鼠标图层显示窗口的起始位置 单位:像素
  	Cursor Gwin Pitch	鼠标图层每行的字节数。 对于鼠标图层来说，该值固定为0x200
  	Curosr StretchWindow pos	鼠标图层在显示设备上的起始位置。 单位:像素
  	Cursor StretchWin Src	鼠标图层原始大小 单位:像素。该值通常和OSD的显示分辨率一致。
  	Cursor StretchWin Dst	鼠标图层在显示设备上的宽度、高度 该值和输出timing一致。
  	Cursor ColorKey Enable	鼠标图层ColorKey是否使能 取值:{0表示Disable ColorKey; 1表示Enable ColorKey}。 用户通过FBIOSET_CURSOR_ATTRIBUTE设置
  	Cursor ColorKey Value	鼠标图层ColorKey的RED,GREEN,BLUE通道数值 取值:每个通道的取值范围从0-255。ColorKey val的数值用RGB888格式表示 用户可通过FBIOSET_CURSOR_ATTRIBUTE去设置后更新

13.2. echo¶

表 13‑4

表 13‑5

表 13‑6

表 13‑7

表 13‑8

14. GFX¶

14.1. cat¶

• 调试信息

  # cat /proc/mi_modules/mi_gfx/mi_gfx0
  

  

  图 14‑1

• 调试信息分析

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

• 参数说明

  表 14‑1

  参数		描述
  device info	InitCnt	设备被Open的次数，由于GFX会有多个模块进行调用，并且不能确定是哪一个module会先调用GFX的初始化，所以设备允许多次Open，会记录Open次数来在Close的时候做对应的计数判断是否需要真的Close Device。
  	ARGB1555AlphaThreshold	ARGB8888转ARGB1555时，GFX内部的alpha判定阈值，如大于N则alpha为1，反之alpha为0.
  	ARGB1555AlphaValue	ARGB1555转ARGB8888时，GFX将ARGB1555 alpha bit 为1的像素的alpha转为ARGB1555AlphaValue
  	ScalingCoefficient	图像几何中心偏移= ScalingCoefficient/1000
  	QuickFillColorFormt	最后一次做QuickFill的颜色格式 取值参考：GFX_Buffer_Format
  	BitblitSrcColorFormt	最后一次做BitBlit的Src Surface的颜色格式
  	BitblitDstColorFormt	最后一次做BitBlit的Dst Surface的颜色格式

15. REGION¶

15.1. cat¶

• 调试信息

  # cat /proc/mi_modules/mi_rgn0
  

  

  图 15‑1

  

  图 15‑2

  

  图 15‑3

• 调试信息分析

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

• 参数说明

  表 15‑1

  参数		描述
  Region capability	Region handle	创建region的最大数量为1024个，句柄取值为[0~1023]
  	channel	最大通道数量为64个，通道取值为[0~63]
  	Osd attach	每个输出端口每个通道能绑定的Osd数量上限为128个
  	Cover attach	每个输出端口每个通道能绑定的Cover数量上限为4个
  	Overlay Supported Format	Osd支持的颜色格式： 0: ARGB1555，宽度按2个像素对齐 1: ARGB4444，宽度按2个像素对齐 2: I2，宽度按4个像素对齐 3: I4，宽度按2个像素对齐 4：I8 5：RGB565 6：ARGB8888
  	Osd support	Width ： Osd宽取值范围为1 ~ 4096 Height ：Osd高取值范围为1~ 4096 Color key value：系统默认的colorkey的值，除了index的格式，不管osd的format是多少，只要内存中的值是此就表示colorkey X pos overlap： 支持多个osd在x方向上重叠。 Overlap：osd是否支持重叠 HW mode：Osd的frontbuff数量，目前设置为8
  	Cover support	Width ：Osd宽取值范围为1 ~ 8192 Height ：Osd高取值范围为1~ 8192 Overlap：Cover是否支持重叠

  表 15‑2

  参数		描述
  Region attr	Handle	句柄
  Type	类型，Osd或是Cover
  Width	宽
  Height	高
  Stride	宽补齐
  Format	颜色格式[0-6]，ARGB1555，ARGB4444，I2，I4，I8，RGB565，ARGB8888
  VirAddr	Canvas的虚拟地址
  PhyAddr	Canvas的物理地址

  表 15‑3

  参数			描述
  Channel port Info	Frontbuffer info	Index	Frontbuffer索引
  		bShow	是否显示
  		OffsetX	X偏移
  		OffsetY	Y偏移
  		Width	宽
  		Height	高
  		Stride	宽补齐
  		Format	颜色格式
  		VirAddr	虚拟地址
  		PhyAddr	物理地址
  		AlphaMode	Alpha模式，指Pixel alpha还是constant alpha
  		AlphaVal	如果是constant alpha，alpha的值
  		BgAlpha	如果是pixle alpha，argb1555的背景alpha
  		FgAlpha	如果是pixle alpha，argb1555的前景alpha
  		BufCnt	通道上front buffer的个数
  		OsdCnt	通道上一个front buffer由多少个back buffer拼接而成
  	Attach info	Handle	绑定Region句柄
  		Type	绑定Region类型
  		bShow	是否显示
  		Layer	绑定Cover的层级
  		Color	绑定Cover的颜色值
  		Width	宽
  		Height	高
  		Stride	宽补齐
  		PositionX	X偏移
  		PositionY	Y偏移
  		Format	绑定Osd的颜色格式
  		VirAddr	虚拟地址
  		PhyAddr	物理地址
  		AlphaVal	如果是constant alpha，alpha的值
  		BgAlpha	如果是pixle alpha，argb1555的背景alpha
  		FgAlpha	如果是pixle alpha，argb1555的前景alpha

  表 15‑4

  参数	描述
  Buffer info	kmalloc	Region模块内部申请内存字节数。
  	mma alloc	Region模块通过Sys模块申请内存字节数。

15.2. echo¶

表 15‑5

表 15‑6

表 15‑7

表 15‑8

表 15‑9

表 15‑10

表 15‑11

表 15‑12

表 15‑13

16. VDEC¶

16.1. cat¶

• 调试信息

  # cat /proc/mi_modules/mi_vdec/mi_vdec0
  

  

  图 16‑1

• 调试信息分析

  打印分为两部分，使用Private Vdec0 Info分隔开。上半部分为common信息，下半部分为vdec模块信息。

  主要记录了解码通道的使用情况及配置属性，可用于检查属性配置和当前通道的工作状态，便于debug。

• 参数说明

  表 16-1

  参数	描述
  DEV Info	DevID	解码设备ID.
  	UUID	芯片识别码。
  	MaxChnNum	最大解码通道数目。
  	bDisableLowLatency	关闭低延时开关，用于B帧解码。默认打开，即仅支持IP帧解码。 Y: 关闭低延时； N: 打开低延时。
  CHN ATTR Info	ChnID	通道号。
  	CodecType	解码协议类型 0：H264; 1：H265; 2：JPEG。
  	Width	解码图像最大宽度。
  	Height	解码图像最大高度。
  	BufSize	VDEC码流buffer大小，单位：byte。
  	VideoMode	发送码流方式。 STREAM：按流发送； FRAME：按帧发送。
  	DpbBufMode	DPB buffer 模式 INPLACE1：一个解码图像buffer； INPLACE2：两个解码图像buffer； NORMAL：普通模式，不能省frame buffer。
  	RefFrmNum	最大参考帧个数，JPEG通道无效。
  CHN PARAM Info	ChnID	通道号。
  	bCusPolicy	对于错误宏块，用户策略开关。 Y: 打开用户设置； N: 关闭用户设置，即默认值。
  	ErrMBDropThrd	错误宏块丢帧阈值。
  	DisplayMode	显示模式。 0：预览模式，不参考PTS输出。 1：回放模式，参考PTS数值输出。
  Scale & Crop Info	ChnID	通道号。
  	bScale	缩放开关。 Y：开启； N：关闭。
  	ScaleW	缩放宽。
  	ScaleH	缩放高。
  	bCrop	裁剪开关。 Y：开启； N：关闭。
  	CropX	裁剪起始坐标X。
  	CropY	裁剪起始坐标Y。
  	CropW	裁剪图象宽。
  	CropH	裁剪图象高。
  Decode Frame Info	ChnID	通道号。
  	DecW	解码图像宽。
  	DecH	解码图像高。
  	DispW	显示图像宽。
  	DispH	显示图像高。
  	LinearFrmCnt	线性帧buffer数目
  Output Frame Info	ChnID	通道号。
  	bTileMode	Tilemode开关。 Y：开启； N：关闭。
  	TileFormat	Tile格式。 仅支持128x64
  	Width	输出图像宽。
  	Height	输出图像高。
  	Stride	输出图像stride。
  	PixelFmt	输出图像像素格式。
  CHN STATE	ChnID	通道号。
  	bStart	解码器是否启动接收码流。
  	DecState	解码器状态。 1：打开解码器； 2：初始化解码器； 3：等待初始化完成； 4：注册frame buffer 5：正在解码； 6：关闭解码器。
  	SendCnt	Api发送码流成功的次数。
  	SendStrmSize	Api发送成功的码流总数据量。
  	LeftStrmBytes	码流buffer中待解码的byte数。
  	DecFrmCnt	码流buffer中已解码帧数。
  	fps	解码帧率。
  CHN STATE	ChnID	通道号。
  	Start	开始解码的次数。
  	Get	获取解码输出信息的次数。
  	Drop	丢帧次数。
  	Run	返回running状态的次数。
  	SeqChange	序列切换的次数。
  	InitSeq	初始化序列的中断数。
  	VlcInsuff	Vlc buffer不足中断数。
  	FrmDone	解码成功中断数。
  ISR STATE	IsrCnt	中断总数目。
  	InitSeq	初始化序列的中断总数目。
  	VlcInsuff	Vlc buffer不足中断总数目。
  	FrmDone	解码成功中断总数目。
  	UnderRun	正在解码中断总数目。
  	HwTimeout	硬件超时中断总数目。
  	Other	其他类型中断中数目。

16.2. echo¶

表 16-2

表 16-3

表 16-4

表 16-5

表 16-5

表 16-6