SDK Module Debugging Manual

1. Overview¶

Linux's porc file system can print out the current running status of each module, which is convenient for debugging and analyzing. Each module has a specific path, and some modules have echo commands.

Path: /proc/mi_modules

Table 1-1 File list

2. SYS¶

2.1. Common¶

2.1.1. dump_mmap¶

• Debug info

  # ./config/dump_mmap
  

  

  Fig 2-1

• Debug info analysis

  The configured API is stored under Common, the purpose is as follows:

  1. Do iniparser in user mode without entering the kernel.

  2. It is convenient to confirm the content of the config file during debugging, and avoid the deviation between the content printed in the parser and the actual setting.

  The files imported into config are as follows:

  

  Fig 2-2

  Write the struct parsed in Systeminfo.c into config_info.

  Write the struct parsed in Pqloader.c into pq_info and *_table, where the table is a continuous memory placement, and MISDK is an indirect array pointing to a one-dimensional array.

  The config files imported into mmap are as follows:

  

  Fig 2-3

  Write the parsed struct in Mmapinfo.c into mmap_info and memory_info. Because this is relatively simple, the info read from mmap_info and memory_info are formatted and readable.

2.1.2. dump_config¶

• Debug info

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

• Debug info analysis

  ./config/dump_config gets the information of each file in /proc/mi_modules/common/, including panel size, DBC Value, motion_table, motion_hdmi_dtv_table, motion_comp_pc_table, misc_param_table, misc_luma_table, noise_table, misc_table, etc.

2.2. mi_log_info¶

2.2.1. cat¶

• Debug info

  # 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)
  

• Debug info analysis

  It shows the default log path or store path, and the debug_level value of each module.

• Parameter analysis

  Table 2-1

  Parameter		Description
  mi_log_info	log path	No effect
  	store path	No effect
  	Log module	Modules name
  	Level	Print level

2.2.2. echo¶

Table 2-2

Table 2-3

Table 2-4

2.3. mi_global_info¶

2.3.1. cat¶

• Debug info

  # 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
  

• Debug info analysis

  It provides some global information.

• Parameter analysis

  Table 2-5

  Parameter		Description
  miu_and_lx_info(Take MIU(which have only one) as an example)	ARM_MIU0_BUS_BASE	Miu0 bus base
  	ARM_MIU0_BASE_ADDR	Miu0 base addr
  	lx_mem_addr	The starting address of the memory occupied by the Linux image(Belongs to cpu bus address)
  	lx_mem_size	The memory size occupied by the Linux image
  kernelProtect IP white list	clientId	The ID in the Miu protect IP whitelist (It is a global ID when it is not grouped)
  	name	IP name corresponding to clientId
  MStar SDK version: commit.build_time	commit	Commit corresponding to SDK
  	build_time	SDK build time
  CHIP_VERSION	CHIP_VERSION	Current chip version, version number: U01, U02, U03...

2.4. mi_bufqueue_status¶

2.4.1. cat¶

• Debug info

  # 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
  

• Debug info analysis

  Dump the queue information related to the enabled input/output port of the current modules.

• Parameter analysis

  Table 2‑6

  Parameter		Description
  dump Queues in input port(only dump enabled Input port)	ModId	input port's module id
  	DevId	input port's device id
  	ChnId	input port's channel id
  	PassId	input port's pass id
  	InPortId	input port's id
  	UsrInjectQ_cnt	UsrInjectBufQueue buff's total size of inputPort
  	BindInQ_cnt	UsrPipeInBufQueue buff's total size of inputPort
  	InputPendingQueueSize	WorkingQueue buff's total size of inputPort
  dump Queues in output port(only dump enabled output port)	ModId	output port's module id
  	DevId	output port's device id
  	ChnId	output port's channel id
  	PassId	output port's pass id
  	OutPortId	output port's id
  	DrvBkRefFifoQ_cnt	DrvBkRefFifoQueue buffer's total size of outputPort
  	DrvBkRefFifoQ_size	DrvBkRefFifoQueue buffer's total size of outputPort
  	UsrGetFifoQ_cnt	UsrGetFifoBufQueue buffer's total size of outputPort

2.5. debug_level¶

2.5.1. cat/echo¶

• Debug info

  # cat /proc/mi_modules/mi_sys/debug_level   2
  

• Debug info analysis

  In order to control the printing level, each module (including sys) has its own debug level, which is controlled by /proc/mi_modules/mi_modulename/debug_level, where disp, divp, rgn, etc. are modulenames. Take /proc/mi_modules/mi_sys/debug_level as an example.

  Table 2‑7

  Function	Print warning level
  Command	cat /proc/mi_modules/[ModuleName]/debug_level
  Parameter description	[ModuleName] Module name 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
  Example	cat /proc/mi_modules/mi_sys/debug_level 2 The warning level of mi_sys is 2(Only display waring info)

  Table 2‑8

  Function	Modify warning level
  Command	echo [Level] > /proc/mi_modules/[ModuleName]/debug_level
  Parameter description	[Level] 0 No debug info 1 Only display error info (MI_DBG_ERR) 2 Only display waring info (MI_DBG_WRN) 3 Only display info (MI_DBG_INFO) 4 Display all info
  	[ModuleName] Module name 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
  Example	echo 1 > /proc/mi_modules/mi_vdec/debug_level Modify the warning level of the mi_vdec module to only display error info

2.6. miu_protect¶

2.6.1. cat¶

• Debug info

  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
  

• Debug info analysis

  It shows info related to miu protect.

• Parameter analysis

  Table 2‑9

  Parameter		Description
  kernel protect		Enabled kernel protect or not, enabled by default.
  LX (take only one LX as an example, LX is the memory corresponding to the linux mirror)	cpu_start_addr	Start CPU addr corresponding to LX.
  	size	The size corresponding to LX.
  Information about the range of a kernel protect	miu_index	serial number.
  	miuBlockIndex	Number information of 4 miu ranges.
  	start_cpu_bus_pa	The starting cpu bus addr of the range.
  	length	The length of range.
  KernelProtect IP white list	clientId	The ID in the Miu protect IP whitelist (It is a global ID when it is not grouped)
  	name	IP name corresponding to clientId

2.7. mma_help_name¶

2.7.1. cat¶

• Debug info

  # 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
  

• Debug info analysis

  The cat information corresponds to the basic information and current state of the mma heap.

• Parameter analysis

  Table 2‑10

  Parameter		Description
  heap basic info	mma heap name	mma heap name
  	heap_base_cpu_bus_addr	The starting cpu bus addr of the heap
  	length	length of heap
  	The reminding memory in heap	chunk_mgr_avail
  chunk_mgr info	pst_chunk_mgr	The value of the chunk mgr pointer
  	offset	chunk mgr offset. The entire mma heap is used as a chunk mgr, so the value is always 0.
  	length	chunk mgr length. The entire mma heap is used as a chunk mgr, so the value is always mma heap length
  	avail	The remaining memory in chunk mgr (heap)
  each chunk info (Information and usage of each chunk in chunk mgr)	offset	The offset of the chunk in chunk mgr
  	length	length of chunk
  	used_flag	Whether the chunk is allocated. If yes, the value is 1; otherwise, it is 0
  	task_name	If the used flag is 1, the task stored in task_name uses it; otherwise, the value is invalid

2.7.2. echo¶

Table 2‑11

2.8. imi_mma_heap¶

2.8.1. cat¶

• Debug info

  # 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
  

• Debug info analysis

  The cat information corresponds to the basic information and current state of the mma heap.

• Parameter analysis

  Table 2‑12

  Parameter		Description
  heap basic info	mma heap name	mma heap的name
  	heap_base_cpu_bus_addr	The starting cpu bus addr of the heap
  	length	length of heap
  	chunk_mgr_avail	The remaining memory in heap
  	mmuEnable	Mma heap support HW_MMU or not. 1 is support, 0 is not.
  chunk_mgr info	offset	chunk mgr offset, the entire mma heap is used as a chunk mgr, so the value is always 0
  	length	chunk mgr length, the entire mma heap is used as a chunk mgr, so the value is always mma heap length
  	avail	The remaining memory in chunk mgr (heap)
  each chunk info (Information and usage of each chunk in chunk mgr)	offset	The offset of the chunk in chunk mgr
  	length	length of chunk
  	used_flag	Whether the chunk is allocated. If yes, the value is 1; otherwise, it is 0
  	task_name	If the used flag is 1, the task stored in task_name uses it; otherwise, the value is invalid
  	pid	Current->tgid to which the chunk belongs
  	Module	The module to which the chunk belongs

2.9. vb_pool_qlobal¶

2.9.1. cat¶

• Debug info

  # cat /proc/mi_modules/mi_sys_mma/vb_pool_global
  

  

  Fig 2‑4

• Debug info analysis

  If global public pools are configured through MI_SYS_IMPL_ConfGloPubPools API or MI_SYS_ConfGloPubPools API, there is a /proc/mi_modules/mi_sys_mma/vb_pool_global file; otherwise, there is no such file.

• Debug info analysis

  Table 2‑13

  Parameter		Description
  	collection_size	The number of allocators in the pool
  One of the info of vbpool_allocators	each_allocation_size	The allocation size in the allocator (different allocation sizes of the same vbpool allocator are the same, and different allocation sizes of different allocators in the same pool may be different)
  	total_allocation_count	The number of allocations in the allocator
  	total_not_used_allocation_count	The unused number of allocations in the allocator
  	kern_map_ptr	The kernel space va of the allocator offset0; if not, the value is NULL
  A vbpool_allocation info of the specified vbpool_allocator	offset_in_vb_pool	The logical offset allocation in the corresponding allocator
  	real_used_flag	Whether it is being used, if not, the subsequent parameters are invalid
  	u64Pts	If it is valid, the value is pts.
  	u64SidebandMsg	If it is valid, the value is SidebandMsg
  	bEndOfStream	If it is valid, the value indicates whether it is the flag of end stream
  	bUsrBuf	If it is valid, the value indicates whether it is UsrBuf
  	eBufType	If it is valid, the value is buf type

2.9.2. echo¶

Table 2‑14

2.10. vb_pool¶

2.10.1. cat¶

• Debug info

  # cat /proc/mi_modules/mi_sys_mma/vb_pool_mi_divp0
  

  

  Fig 2‑5

• Debug info analysis

  Configure a device's vb pool to generate /proc/mi_modules/mi_sys_mma/vb_pool_modnamedevid file, (modname, such as dipp, vpe, etc., devid, such as 0,1, etc.) It corresponds to the device, and vb_pool_global corresponds to the global shared vb pool.

  Taking vb_pool_mi_divp0 as an example, the cat command displays various information, and only "echo path offset length >" is used to dump data. Both of these are similar to vb_pool_global.

2.10.2. echo¶

Table 2‑15

2.11. meta¶

2.11.1. cat¶

• Debug info

  # 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 ================================
  

• Debug info analysis

  After using the meta allocator (only one), /proc/mi_modules/mi_sys_mma/meta will be generated, and the corresponding memory will be completely allocated and waiting to be used.

2.11.2. echo¶

Table 2‑16

2.12. mi_modulenamedevid¶

2.12.1. cat¶

• Debug info

  cat /proc/mi_modules/mi_disp/mi_disp0
  

  

  Fig 2‑6

• Debug info analysis

  The result of the cat operation:

  1. Provide general debugging information for the device from the device, channel, input port, and output port of MI_SYS,

  2. The private information of the device, which is provided by each module.

  Take cat /proc/mi_modules/mi_vdisp/mi_vdisp0 as an example. The result is as above.

• Parameter

  Table 2‑17

  Parameter		Description
  Common info for device	ChnNum	The device channel number
  	EnChnNum	The device enabled channel number
  	InPortNum	The device input ports number
  	OutPortNum	The device output ports number
  	CollectSize	The allocators number in allocatorCollection corresponding to dev
  Common info for channel(only dump enabled channel)	ChnId	Channel id
  	EnInPNum	channel enabled input ports number
  	EnOutPNum	channel enabled output ports number
  	MMAHeapName	If SetChnMMAConf is set, the value is the corresponding mma heap name; if not, the value is NULL
  Input port common info(only dump enabled Input port)	ChnId	channel id of the input port
  	PortId	id of the input port
  	SrcFrmrate	Src frame rate
  	DstFrmrate	Dst frame rate
  	user_buf_quota	Quota of the inputPort buffs number
  	UsrInjectQ_cnt	The buffs number of UsrInjectBufQueue in InputPort
  	UsrInjectQ_size	The buffs size of UsrInjectBufQueue in InputPort
  	BindInQ_cnt	The buffs number of BindInputBufQueue in InputPort
  	BindInQ_size	The buffs size of BindInputBufQueue in InputPort
  	WorkingQ_cnt	The buffs number of WorkingQueue in InputPort
  	WorkingQ_size	The buffs size of the WorkingQueue in the InputPort
  	usrLockedInjectCnt	The buf currently owned by the user
  Input port bind info(only dump enabled Input port)	ChnId	Channel id of the input port
  	PortId	id of the input port
  	bind_module_id	The module id of the output port bound to the input port
  	bind_module_name	The module name of the output port bound to the input port
  	bind_ChnId	The channel id of the output port bound to the input port
  	bind_PortId	The output port id bound to the input port
  Output port common info (only dump enabled Output port)	ChnId	The channel id of output port
  	PortId	The output port id
  	BufCntQuota	Quota of the OutputPort buff number
  	usrLockedCnt	The buffer taken by the user from UsrGetFifoBufQueue
  	totalOutPortInUsed	totalOutputPortInUsedBuf number
  	DrvBkRefFifoQ_cnt	The buffer number in the OutputPort DrvBkRefFifoQueue
  	DrvBkRefFifoQ_size	The buffer size in the OutputPort DrvBkRefFifoQueue
  	UsrGetFifoQ_cnt	The buffer number in the OutputPort UsrGetFifoBufQueue
  	UsrGetFifoQ_size	The buffer size in the OutputPort UsrGetFifoBufQueue
  	WorkingQ_cnt	The buffer number in the OutputPort WorkingQueue
  	WorkingQ_size	The buffer size in the OutputPort WorkingQueue
  Output port BindPeerInputPortList info(only dump enabled Output port)	ChnId	channel's output port id
  	PortId	output port id
  	bind_module_id	The module id of the input port bound to the output port
  	bind_module_name	The module name of the bound input port
  	bind_ChnId	The channel id of the bound input port
  	bind_PortId	Bound input port id

2.12.2. echo¶

Table 2‑18

Table 2‑19

2.13. mi_dump_buffer_delay_worker¶

2.13.1. cat¶

• Debug info

  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
  

• Debug info analysis

  /proc/mi_modules/mi_dump_buffer_delay_worker is a concept connected to mi_modulenamedevid. The buffer in the device Queue is dumped through delay worker, and cat mi_dump_buffer_delay_worker to view the delay worker in progress. The echo force_stop_dump delay_worker_id is forcibly ending a specified delay worker.

• Parameter

  Table 2‑20

  Parameter	Description
  delay_worker_id	delay worker id. After the delay worker is completed, the id will be recycled and used by other delay workers.
  module_name	The module id corresponding to the delay worker.
  force_stop	Whether the delay worker is in the forced end phase. 1: Yes, 0: No.
  dev_id	The device id corresponding to the delay worker.
  chn_id	The channel id corresponding to the delay worker.
  port_type	The port type corresponding to the delay worker. input port or output port
  port_id	The port id corresponding to the delay worker.
  Queue_name	The Queue name corresponding to the delay worker.
  stored_dir	The absolute storage path of the data to be dumped by the delay worker (excluding the file name of the final storage)
  dump_method	dump delay worker: bufnum, or time, or start
  dump_method_value	The value of the Dump method.

2.13.2. echo¶

Table 2‑21

2.14. module version¶

2.14.1. cat¶

• Debug info

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

• Debug info analysis

  xxxx_version_file provides version information, so does the /proc/mi_modules/mi_global_info.

  The version info is about mi_sys module, the above is taking mi_vi and mi_global_info as examples, each module has their version file.

• Parameter

  Table 2‑22

  Parameter		Description
  Version Info	project_commit	The whole package project commit when the module compiles ko. Replace ko, the commit changes, the commit obtained in the ko version will also change.
  	sdk_commit	The whole sdk commit when the module compiles ko. Replace ko, the commit changes, the commit obtained in the ko version will also change.
  	build_time	build time. Accurate to the second, make clean; make image build as a whole, and the time of each ko is also different.

2.15. show threads¶

2.15.1. echo¶

• Debug info

  # 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)
  

• Debug info analysis

  Print the call stack of all current threads.

• Parameter

  Table 2‑23

  Parameter		Description
  show_threads	task	Thread name: p->comm
  	state	Thread running status
  	pid	Thread pid
  	father	The father id of thread
  	flags	low level flags

2.16. debug_frc¶

2.16.1. echo¶

• Debug info

  # 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
  

  Table 2‑24

  Function	Open the port frc debug.
  Command	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
  Parameter description	[Modid] : module id. [Devid] : device id. [Chnid] : channel id. [Passid] : pass id. [Portid] : port id. in/out : input or output port.
  Example	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¶

• Debug info

  # 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
  

• Debug info analysis

  Print out the location that may cause deadlock.

• Parameter

  Table 2‑25

  Parameter		Description
  deadlock Info	thread_name	Thread name that caused the deadlock
  pid	Thread task pid
  owned_lock_name	lock name
  caller_func_name	function name
  caller_func_line	function line

3. AI¶

3.1. cat¶

• Debug info

  

  Fig 3-1

• Debug info analysis

  Record the current AI usage status and device/channel attributes, and can dynamically obtain information, which is convenient for debugging and testing.

• Parameter

  Table 3‑1

  Parameter		Description
  AI Device Attr	AiDev	AI device name
  	SamR	Sample Rate:8000, 16000, 32000, 48000
  	BitWidth	Bit Width:16bit
  	SoundMod	Sond mode: mono stereo queue: all channels are in one buffer
  	PtNumPerFrm	Sampling points per frame
  	TotalReadFrmCnt	Count of data read from mhal
  	ChnCnt	current device hannels
  	I2sMode	I2S Rx working mode(Only valid when the device is I2S Rx) i2s-mas: I2S master i2s-sla: I2S slave tdm-mas: TDM master tdm-sla: TDM slave
  	I2sMclk	Mclk frequency of I2S Rx(Only valid when the device is I2S Rx) disable: no Mclk Other values are the current Mclk frequency
  	I2sFmt	I2S Rx data Format(Only valid when the device is I2S Rx) I2S-MSB: I2S LEFT-MSB: I2S align left
  	bI2sSync	Whether I2S RX and TX share clock(Only valid when the device is I2S Rx) 1: 4 wire mode,RX and TX share clock 0: 6 wire mode, RX and TX have independent clocks
  	TdmSlots	I2S Rx TDM slot number(Only valid when the device is I2S Rx and in TDM mode)
  	I2sBitWidth	I2S RX Bit Width(Only valid when the device is I2S Rx and the chip supports TDM mode)

  Table 3‑2

  Parameter		Description
  AI Chn Status	AiDev	AI device name
  	AiChn	AI channel number
  	bChnEnable	Whether the AI channel is enabled 1: Enable 0: Disable
  	Volume	AI channel gain setting(front gain, rear gain), only Amic/Line has two levels of gain, corresponding to analog gain and digital gain; Dmic only has digital gain, I2S Rx does not support gain.
  	ReadFrmCnt	Frames acquired by AI channel
  	bMute	Whether the AI channel uses the mute function

3.1.1. echo¶

Table 3-3

Table 3-4

Table 3-5

4. AO¶

4.1. cat¶

• Debug info

  # cat proc/mi_modules/mi_ao/mi_ao0
  

  

  Fig 4-1

• Debug info analysis

  Record the current AO usage status and device/channel attributes, and can dynamically obtain information, which is convenient for debugging and testing.

• Parameter

  Table 4‑1

  Parameter		Description
  AO Device Attr	AoDev	AO device name
  	SamR	Sample Rate:8000, 11025, 16000, 22050, 24000, 32000, 44100, 48000
  	BitWidth	Bit Width:16bit
  	SondMod	Sond mode: mono stereo
  	PtNumPerFrm	Sampling points per frame
  	VolumeDb	AO device gain (left channel, right channel)
  	bStartPcmOut	Whether to broadcast
  	ChnCnt	AO device channel number
  	TotalFrmCnt	Frames sent by APP to AO device
  	TotalSize	Data sent by APP to AO device
  	I2sMode	I2S Tx working mode(Only valid when the device is I2S Tx) i2s-mas: I2S master i2s-sla: I2S slave tdm-mas: TDM master tdm-sla: TDM slave
  	I2sMclk	Mclk frequency of I2S Tx(Only valid when the device is I2S Tx) disable: no Mclk Other values are the current Mclk frequency
  	I2sFmt	I2S Tx data Format(Only valid when the device is I2S Tx) I2S-MSB: I2S LEFT-MSB: I2S align left
  	bI2sSync	Whether I2S RX and TX share clock(Only valid when the device is I2S Tx) 1: 4 wire mode, RX and TX share clock 0: 6 wire mode, RX and TX have independent clocks
  	TdmSlots	I2S Tx TDM slot number(Only valid when the device is I2S Tx and in TDM mode)
  	I2sBitWidth	I2S TX Bit Width(Only valid when the device is I2S Tx and the chip supports TDM mode)

  Table 4-2

  Parameter		Description
  AO Chn Status	AoDev	AO device name
  	AoChn	AO channel number
  	bMuteEnable	Whether mute is enabled on the AO channel 1: Enable 0: Disable
  	RunTime	Enable time of AO channel (unit: s)

  Table 4-3

  Parameter		Description
  AO Chn Usr Queue Status	AoDev	AO device name
  	AoChn	AO channel number
  	MaxSize	AO channel queue size (unit: byte)
  	RemainSize	The current data in the AO channel Queue (unit: byte)
  	TotalSize	Data sent by APP to AO channel (unit: byte)
  	RunTime	AO channel queue created time (unit: s)

4.2. echo¶

Table 4‑4

Table 4-5

Table 4-6

Table 4-7

5. VIF 2.0¶

5.1. cat¶

• Debug info

  #cat /proc/mi_modules/mi_vif/mi_vif0
  

  

  Fig 5-1

• Debug info analysis

  Record the current VIF usage status and device/output attributes, and can dynamically obtain information, which is convenient for debugging and testing.

• Parameter

  Table 5‑1

  Parameter		Description
  Dev Attr	u32VifDevIdx	Dev ID
  	Intf	Protocol for inputting data
  	Work	Runmode
  	Clk	Clock edge trigger mode, related to Intf
  	Hdr	Hdr type
  	IsrCnt	Frame start callback count
  	AsyncCnt/EnqCnt/ BarCnt/CheckCnt/ DequCnt	Callback execution times

  Table 5‑2

  Parameter		Description
  OutPort Attr	Chn	Channel id
  	Pipe	Pipe id
  	Port	Port id
  	Cap_size	Input size
  	Dest_size	output size
  	Sel	Frame selection
  	Scan	Scan mode, P or I
  	Fmt	Out put pixel format
  	Rate	Frame rate type
  	LineCnt	Frame mode line count
  	Atom	Bottom buffers
  	MetaInfo	Frame id
  	Outcount	Output frame count
  	Failcount	Get outputbuffer failure times
  	Fps	Frame per second
  	Recv_size	Vif HW received size
  	Out_size	Write dma size
  	SubOut_size	Write sub dma size
  	ReadIdx/WriteIdx/ DequeIdx	Index of read,write,deque
  	FrameStartCnt	Frame start count
  	FrameDoneCnt	Processed frames count
  	VbFail	VbFail count
  	DropFrameCnt	Dropped frame count
  	RingBufStatus	Ring buf status

5.1.1. echo¶

Table 5‑3

Table 5‑4

Table 5‑5

6. VIF 3.0¶

6.1. cat¶

• Debug info

  #cat /proc/mi_modules/mi_vif/mi_vif0
  

  

  Fig 6-1

• Debug info analysis

  Record the current VIF usage status and Group/Dev/pipe/outport attributes, and can dynamically obtain information, which is convenient for debugging and testing.

• Parameter

  Table 6-1

  Parameter		Description
  Group Attr	GroupId	Device number
  	Intf	Protocol for inputting data
  	Work	working mode
  	Clkedge	Clock edge trigger mode, related to Intf
  	Hdr	Hdr type

  Table 6-2

  Parameter		Description
  Dev Attr	Dev	Dev number
  	IsrCnt	Interrupt times that received
  	incrop	Input Corp Size
  	infmt	Input data format
  	AsyncCnt/EnqCnt/ BarCnt/CheckCnt/ DequCnt	Callback execution times

  Table 6-3

  Parameter		Description
  Pipe Attr	PipeId	Pipe number
  	PortId	Port number
  	DevId	Dev number
  	Hdn	Enable Hdn
  	crop	Input Corp Size
  	Dest	Output Size
  	Pixel	Output Pixel
  	wkmode	Pipe working mode
  	Fbc	Enabling Fbc

  Table 6-4

  Parameter		Description
  OutPort Attr	Dev	Channel id
  	Port	Pipe id
  	Cap_size	Input size
  	Dest_size	Output size
  	Fmt	Out put pixel format
  	Rate	Frame rate type
  	Atom	Bottom buffers
  	MetaInfo	Frame id
  	OutCount	Output frame count
  	Addr0Cnt	Frame address 0 count
  	FailCount	Get outputbuffer failure times
  	Fps	Frame per second
  	Recv_size	Vif HW received size
  	Out_size	Write dma size
  	SubOut_size	Write sub dma size
  	ReadIdx/WriteIdx/ DequeIdx	Index of read,write,deque
  	FrameStartCnt	Frame start count
  	FrameDoneCnt	Processed frames count
  	VbFail	VbFail count
  	DropFrameCnt	Dropped frame count
  	RingBufStatus	Ring buf status

6.2. echo¶

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

Fig 6-2 Commands

Table 6-5

Table 6-6

Table 6-7

Table 6-8

Table 6-9

7. VPE¶

7.1. cat¶

• Debug info

  # cat /proc/mi_modules/mi_vpe/mi_vpe0
  

  

  Fig 7‑1

  

  Fig 7‑2

• Debug info analysis

  Record the current VPE usage status and device/output attributes, and can dynamically obtain information, which is convenient for debugging and testing.

• Parameter

  Table 7‑1

  Parameter	Description
  Device Info	DevID	0, only have one device, the ID is 0
  	InitCnt	connected module times
  	CreChnNum	Create Channels
  	Point	The running node stops point
  	scllevel	Scl½ level
  	chip	Chip number
  	cmdq(0,1,2)	Cmdq pointer, confirm whether it is shared with other pass
  	IrqName	IRQ name
  	En	Enable IRQ
  	Mode	IRQ mode
  	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

  Table 7‑2

  Parameter	Description
  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	Enable Ldc
  	ChnPortMode	Port mode, used to choose SCL source, ISP Realtime or RDMA
  	SensorId	Bind sensorId
  	RunMode	VPE Running mode : VIF-VPE
  	Crop	Channel Crop position
  	Rot	Rotation angle
  	Mirror/Flip	Chn mirror/flip
  	Gardient	Isp Gardient
  	ActEn	Enable ISP->SCL connection, when the value is 0 means there is a realtime connection
  	3DNRLevel	3dnr level
  	HdrMode	Hdr mode
  	passid	passid
  	bUsed	Use Pass or not
  	InSize	input width/height
  	Inpixel	Input Pixel format
  	InStride	Input buffer stride
  	SclOutMode	Set Scl output mode
  	SclInSize	Scl input size
  	Atom	Bottom buffers
  	Atom0Cnt	There is no buffer at the bottom after released
  	PreCnt/EnqCnt/BarCnt/checkin/ checkout/DeqCnt/DropCnt	Callback execution times
  	EnqOTNull	When Enq, OutBuffer is statistics of Null

  Table 7‑3

  Parameter	Description
  Outputport Info	ChnId	Channel ID
  	PortId	Port ID
  	passid	Pass ID
  	bindtype	0: Real Time mode 1: Ring mode 2: frame mode
  	Enable	Enable status
  	Pixel	Output pixel format
  	bMirr/flip	Port mirror/flip
  	PortCrop	Port crop range
  	OutputW /OutputH	Output width/height
  	Histogram	Scl Histogram
  	MatchLine	Low Lantency Mode Match Line Cnt
  	Stride	Output buffer stride, a row of pixel bytes
  	GetCnt	Get outputbuffers
  	FailCnt	Get the times of outputbuffer faliure
  	FinishCnt	Processed output buffers
  	fps	Output port frame rate

7.2. echo¶

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

Fig 7‑3 Commands

Table 7‑4

Table 7‑5

Table 7‑6

Table 7‑7

Table 7‑8

Table 7‑9

Table 7‑10

Table 7‑11

Table 7‑12

Table 7‑13

Table 7‑14

Table 7‑15

Table 7‑16

Table 7‑17

Table 7‑18

8. VENC¶

8.1. cat¶

• Debug info

  #cat /proc/mi_modules/mi_venc/mi_vencN   //Before Venc 3.0, N is 0/1, 0 is device0 that encodes h264 and h265, and 1 is device1 that encodes jpeg; Venc 3.0, N is 0/8, 0is device0 that encodes h264 and h265, 8 is device8 that encodes jpeg.
  

  

  Fig 8-1

• Debug info analysis

  Record the current VENC device usage status and device/layer/inputport attributes, and can dynamically obtain information, which is convenient for debugging and testing.

• Parameter

  Table 8-1

  Parameter		Description
  Dev info	DevId	Device number, used as Dev ID (Mapping the kernel MI_VENC_Dev_e)
  	IrqNum	Interrupt number
  	IsrTotalCnt	Various types of irqs
  	IsrFrmDoneCnt	frame done irq
  	IsrBufFullCnt	irq count for buffer full type
  	IsrSliceDoneCnt	isr count for slice done
  	IsrRingFullCnt	irq count for ring buffer full type
  	IsrTimeoutCnt	Count for timeout isr
  	IsrOtherCnt	irq count for other type
  	MaxTaskCnt	Max task supported for processing at the same time
  	WorkingTaskCnt	The number of working task
  	SupportRing	Support HW RING or not
  	SupportImi	Support HW REALTIME or not
  	NeedPadding	Need MI SYS clear padding or not
  	CmdqHandle	cmdq handle value
  	CmdqBufSize	CmdqBufSize
  	ResetTime	Device reset time
  	MaxW	The width of the max resolution used by device
  	MaxH	The height of the max resolution used by device
  	AlignMaxw	The aligned max width
  	AlignMaxH	The aligned max height

  Table 8-2

  Parameter		Description
  CHN info	ChnId	Channel ID
  	bStart	Started receiving data or not
  	RefMemPA	The HW physical address required by bottom driver
  	RefMemSize	The HW memory size required by bottom driver
  	AlMemPA	The CPU physical address required by bottom driver
  	AlMemVA	The CPU virtual address required by bottom driver
  	AlMemSize	The CPU memory size required by bottom driver
  	State	Bottom processing status: 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	Whether the base-level frame is used as a reference by other frames in this level
  	base	Period of base-level, value range: (0, +∞)
  	enhance	Period of enhance-level, value range: [0, 255]
  	MaxStreamCnt	The max outputed buffers
  	FrameIdx	Cuurent frame ID: before venc3.0, the value is 1, 2, 3 or 4; after venc3.0, the value is 1, 2 or 4
  	Gardient	The gradient value passed by the front-end isp
  	Fps_1s	Count the output frame rate within 1s
  	kbps	Count the output bit rate within 1s
  	Fps10s	Count the output frame rate within 10s
  	kbps	Count the output code rate within 10s
  	RingBufStartLine	ring start line in ring mode
  	RingBufHeight	ring buffer height in ring mode
  	QueryCnt	The times for APP calling MI_VENC_Query
  	GetStreamCnt	The times for APP calling MI_VENC_GetStream
  	RlsStreamCnt	The times for APP calling MI_VENC_ReleaseStream
  	PollReadyCnt	The successful times for APP calling select/poll
  	PollFailCnt	The failed times for APP calling select/poll

  Table 8-3

  Parameter		Description
  Inputport info	ChnId	Channel ID
  	Width	Pixel width
  	Height	Pixel height
  	SrcFrmRate	Source frames per second, usually used as a parameter of rate control
  	MaxW	Max pixel width
  	MaxH	Max pixel height
  	FrameCnt	Processed frames
  	DropFrameCnt	Dropped frame count
  	BlockCnt	The input pictures have been received, but the previous input picture is still being processed and needs to be rewinded

  Table 8-4

  Parameter		Description
  Outputport info	ChnId	Channel ID
  	CODEC	CODEC: H264,H265,MJPG Profile
  	BufSize	Max buffer per frame set by user (bytes)
  	MinAllocSize	Min allocte size
  	RefNum	Max reference frames
  	bByFrame	Whether the rear level takes one frame at a time 0: N, get data by package 1: Y
  	FrameCnt	Processed frames
  	DropCnt	Frames that have been encoded but dropped
  	ReEncCnt	Recoded frames
  	RingUnreadCnt	Frames in the output pool that have not yet been taken
  	RingTotalCnt	Frames in the output pool
  	UsrLockedCnt	Frames locked by user
  	RateCtl	Rate Control algorithm: CBR, VBR, FixQp, etc.
  	GOP	Group of Picture
  	MaxBitrate	When it is CBR or VBR, the maximum target bit rate. (bits per second)
  	IPQPDelta	The difference between the average QP value and the QP of the current I frame
  	MaxQp	When it is VBR, the max allowed QP
  	MinQp	When it is VBR, the min allowed QP
  	MaxIQP	When it is VBR, the max allowed I frame QP
  	MinIQP	When it is VBR, the min allowed I frame QP
  	QpMap	Allow users to decide rate control in QPMAP mode
  	AbsQp	Use absolute Qp
  	ModeMap	0 decided byhw；1 force skip；2 force intra

8.2. echo¶

Table 8-5

Table 8‑6

Table 8‑7

Table 8-8

Table 8-9

Table 8-10

Table 8-11

Table 8-12

Table 8-13

Table 8-14

Table 8-15

Table 8-16

Table 8-17

Table 8-18

Table 8-19

Table 8-20

9. DIVP¶

9.1. cat¶

• Debug info

  # cat /proc/mi_modules/mi_divp/mi_divp0
  

  

  Fig 9‑1

  

  Fig 9‑2

  

  Fig 9‑3

• Debug info analysis

  Record the current DIVP device usage status and device/layer/inputport attributes, and can dynamically obtain information, which is convenient for debugging and testing.

• Parameter

  Table 9‑1

  Parameter	Description
  channelinfo	ChnId	0~16; 16 Capture Channel is not open to the upper layer
  	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	Previous setting attribute of the channel
  	ChnAttrOrg	Original setting attributes of the channel
  	CropX, CropY, CropW, CropH	The crop position set in the upper layer
  	bHMirror, bVMirror	Horizontal flip enable; Vertical flip enable 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,

  Table 9-2

  Parameter	Description
  inputport info	ChnId	Channel ID 0~16
  	InputChg	Whether the input port attribute has changed
  	bIPChg	0: No change between interlaced and progressive; 1: Switch between interlaced and progressive.
  	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 value. 1: enable; 0: disable
  	EnqueueTask	Enqueue task
  	GetInTaskCnt	OnPreProcessInputTask number

  Table 9-3

  Parameter	Description
  Outputport Info	ChnId	Channel ID 0~16
  	OutputChg	the Output attribute has changed or not; 0: N; 1: Y
  	Pixel	The same as 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	The width and height of the output port previously set
  	Stride	Output stride
  	phyaddr	Output buffer physical address
  	FinishTaskCnt	Finished tasks
  	fps	Output port frame rate

  Table 9-4

  Parameter	Description
  Common Info	ChnNum	Channel number
  	Pixel	The same as input pixel
  	PassNum	Pass number
  	InPortNum	Input ports
  	OutPortNum	Output ports
  	CollectSize	Attached pstAllocators
  	current_buf_size	Current buffer size
  	Peak_buf_size	Peak buffer size
  	user_pid	User pid
  	user_buf_quota	User buffer quota
  	UsrInjectQ_cnt	User inject buffers
  	BindInQ_cnt	Input port enqueue buffers provided by the front-end
  	TotalPendingBuf_size	The buffer size of each task in the current input working queue
  	usrLockedInjectCnt	The buf currently owned by the user
  	newPulseQ_cnt	Buffers of new_pulse_fifo_inputqueque
  	nextTodoPulseQ_cnt	Buffers of next_todo_pulse_inputqueue
  	curWorkingQ_cnt	Buffers of cur_working_input_queue
  	workingTask_cnt	Tasks of input_working_tasklist
  	lazzyRewindTask_cnt	Tasks that need retry
  	bind_module_id	Bound module id
  	bind_module_name	Bound module name
  	bind_ChnId	Binding module channel id
  	bind_PortId	Binding module port id
  	bind_Type	Binding 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	Bound parameter
  	SrcFrmrate	source frame rate
  	DstFrmrate	destination frame rate
  	GetFrame/Ms	Frames/time
  	FPS	Frame rate
  	RewindCnt	Tasks that need retry
  	usrDepth	The max output port buffers taken by user
  	BufCntQuota	The max buffers applied by output port
  	usrLockedCnt	The actual buffers received by user
  	totalOutPortInUsed	The actual buffers applied by outport
  	DrvBkRefFifoQ_cnt	for special driver which need to refer back pre-processed buffer
  	DrvBkRefFifoQ_size	The buffer size taken by stDrvBkRefFifoQueue
  	UsrGetFifoQ_cnt	Buffers that duplicate to output port
  	UsrGetFifoQ_size	The total of buffer size that duplicate to output port
  	UsrGetFifoQ_seqnum	The buffers recived by output port
  	UsrGetFifoQ_discardnum	Output port applied for a new buffer and abandoned the original
  	finishedTask_cnt	Tasks finished by output port
  	GetTotalCnt	Buffers got by output port
  	GetOkCnt	Count the frames whose index is E_MI_SYS_FRC_OBTAIN
  	ISRNum	Interruptions received

9.2. Echo¶

Table 9-5

Table 9-6

Table 9-7

Table 9-8

Table 9-9

10. VDISP¶

10.1. cat¶

• Debug info

  # 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
  

• Debug info analysis

  Record the current VDISP usage status and device/Inputport/Outputport attributes, and can dynamically obtain information, which is convenient for debugging and testing.

• Parameter

  Table 10‑1

  Parameter	Description
  device info	DevStatus	Working status of Vdisp; Uninit/ Init/ Start/ Stop

  Table 10‑2

  Parameter	Description
  layer info	PortID	Inport ID; value range: [0~16], 16 is the overlay channel (PIP channel).
  	PortStatus	Port status; Uninit/ Init/ Enabled/ Disabled
  	ChnX	Input the X starting coordinate address of the inport; value range: [0~4094], need to be aligned according to the chip
  	ChnY	Input the Y starting coordinate address of the inport; value range: [0~2159]
  	ChnW	Input the image width of the inport, which needs to be aligned according to the chip value range:[0~4096]
  	ChnH	Input the image height of the inport; value range:[0~4096]
  	IsFreeRun	Frame rate control or not; 0: pts control play; 1: free play
  	TryOk	Try to get the times that the front-level bound port
  	RecvOk	The times that get data from the front-level bound port successfully

  Table 10‑3

  Parameter	Description
  Output port info	Inited	Output Port has been initialized or not; 0: Uninit; 1: Init
  	FrmInterval	Output frame time interval, unit: US
  	BgColor	Background color, printed here is decimal
  	PixelFmt	Color space; value range: [0~E_MI_SYS_PIXEL_FRAME_FORMAT_MAX-1] 0-YUYV422, 9-YUVSP420
  	FrmRate	Output frame rate
  	Width	Image output width; value range: [0~4096], need to be aligned according to the chip
  	Height	Image output height; value range:[0~2160], need to be aligned according to the chip
  	SendOk	Frame statistics that successful pushed to the rear-level

11. DISP¶

11.1. cat¶

• Debug info

  # 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
  

• Debug info analysis

  Record the current DISP usage status and device/layer/inputport attributes, and can dynamically obtain information, which is convenient for debugging and testing.

• Parameter

  Table 11‑1

  Parameter	Description
  device info	DevStatus	0: disable; 1: enable
  	IrqNum	Interrupt number
  	IrqCnt	Interruption times
  	BgColor	Background color(RGB format)

  Table 11-2

  Parameter	Description
  layer info	LayerId	layer ID ; value range:[0~1]
  	BindedDevID	Bound device ID; value range:[0~1]
  	LayerWidth	Layer Width
  	LayerHeight	Layer Height
  	LayDispWidth	Layer displayed width
  	LayDispHeight	Layer displayed height
  	Toleration	PTS error tolerance threshold, unit: ms
  	rotatemode	Rotation mode; value range: [E_MI_DISP_ROTATE_NONE~E_MI_DISP_ROTATE_270]

  Table 10-3

  Parameter	Description
  port info port info	PortId	port ID ; value range:[0-15]
  	enable	0: disable; 1: enable
  	CurStatus	port status; value range:[E_MI_LAYER_INPUTPORT_STATUS_INVALID~ E_MI_LAYER_INPUTPORT_STATUS_HIDE]
  	src_w	Original image width
  	src_h	Original image height
  	crop_x	The starting X coordinate of the partial enlarged area
  	crop_y	The starting Y coordinate of the partial enlarged area
  	crop_w	Partially enlarged area width
  	crop_h	Partially enlarged area height
  	show_x	The port starting X coordinate on the layer
  	show_y	The port starting Y coordinate on the layer
  	show_w	The port displayed width
  	show_h	The port displayed height
  	RecvBufCnt	Total of buffs currently received
  	RecvBuf_W	Received image width
  	RecvBuf_H	Received image height
  	Content_W	Received image effective width
  	Content_H	Received image effective height
  	RecvBufStride	Received image lineoffset
  	PixFmt	Received image pixel format
  	syncmode	Check PTS/Free Run; 0: invalid; 1: Check PTS; 2: Free Run
  	OnScreenTask	Task being displayed
  	FiredTask	Task to be displayed
  	LastDropTask	Task released
  	DropTaskCnt	Dropped Task amount
  	StepTaskCnt	Stepping processed Task amount
  	bClearAllTask	Drop all the tasks or not; 0: N; 1: Y
  	fps	Frame rate

12. HDMI¶

12.1. cat¶

• Debug info

  # 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
  

• Debug info analysis

  Record the current HDMI usage status and device attributes, and can dynamically obtain information, which is convenient for debugging and testing.

• Parameter

  Table 12‑1

  Parameter	Description
  device info	InitFlag	HDMI module init or not; Y: init; N: uninit
  	AvMute	Enabled audio and video mute mode; Y: Enabled; N: Disabled
  	PowerOn	HDMI enabled power management ornot; Y: Enabled; N: Disabled
  	EnableVideo	Enable video or not; 0: N; 1: Y
  	TimingType	Current HDMI output resolution; Value range: [0~ E_MI_HDMI_TIMING_MAX]
  	OutputMode	HDMI output mode; 0: HDMI mode; 2: DVI mode; ⅓: HDCP mode, not supported
  	ColorType	Color type; 0: RGB44; 1: YUV422; 2: YUV444; 3: YUV420
  	DeepColorMode	Color depth; 0: 8Bit; 1: 10Bit; 2: 12Bit; 3: 16Bit
  	EnableAudio	Enable audio or not; 0: N; 1: Y
  	IsMultiChannel	Multi-channel or not; 0: N; 1: Y
  	BitDepth	Audio sample bit depth; 8: 8Bit; 16: 16Bit; 32: 32Bit
  	CodeType	Audio output compression format; 0: PCM; 1: Non-PCM
  	SampleRate	Audio output sampling rate; 0: unknown; 1: 32K; 2: 44K; 3: 48K; 4: 88K; 5: 96K; 6: 176K; 7: 192K

13. FB¶

13.1. cat¶

• Debug info

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

• Debug info analysis

  Record the current Fbdev and Hwcursor usage status and OSD layer/OSD device/Hwcursor attributes, and can dynamically obtain information, which is convenient for debugging and testing.

• Parameter

  Table 13‑1

  Parameter	Description
  OSD info	Framebuffer id	Framebuffer device ID
  	xres	Visible resolution width
  	yres	Visible resolution height
  	xres_virtual	Virtual resolution width
  	yres_virtual	Virtual resolution height
  	xoffset	X offset from visible resolution to virtual resolution
  	yoffset	Y offset from visible resolution to virtual resolution
  	fix.line_length	Bytes per line of virtual resolution
  	fix.smem_start	Start address in frame buffer
  	Memory Size	Frame buffer memory size, unit: byte

  Table 13‑2

  Parameter	Description
  OSD device info	Gop ID	Hardware ID of the layer
  	Gwin ID	ID of the hardware display window
  	Open Count	Open count of this layer. Add 1 when the user calls open(); minus 1 when calling close()
  	Visible State	Display status of this layer. Value: 1: visible; 0: invisible. The user calls FBIOSET_SHOW to set the layer state.
  	MIU Sel	The physical memory number for storing frame buffer data. For MSR620 devices, the value is 0.
  	ColorSpace	The color space of the layer output. Value: YUV: Output YUV color space, default value; RGB: Output RGB color space.
  	ColorFomrmat	Layer color format; Value: ARGB1555, ARGB4444, ARGB8888, RGB565. Update after the user sets the format item in the variable screen.
  	StretchWindow Pos	The starting position of the layer on display device. Unit: pixel, default is 0, user can call FBIOSET_SCREEN_LOCATION to set it
  	StretchWindow Src	The width and height of the original resolution of the layer. Unit: pixel. Use the hardware zoom function to zoom in to the current timing. Update after the user sets the visible resolution in the variable screen.
  	StretchWindow Dst	The width and height of the layer on the display device. By default it is set to output timing size. Set by FBIOSET_SCREEN_LOCATION.
  	Gwin Pos	The starting position of the layer display window. Unit: pixel, for OSD, the value is always (0,0)
  	Gwin Size	The width and height of the layer display window. Unit: pixel. For OSD, this value is always set to the width and height of the visible resolution. Update after the user sets the visible resolution in the variable screen.
  	Gwin PhyAddr	The physical address of the layer currently displayed data
  	ColorKey Enable	Enable colorKey or not. Value: 0: N; 1: Y; User can set it by FBIOSET_COLORKEY
  	ColorKey Val	RED/GREEN/BLUE channels of ColorKey. Value range of each channel: 0-255. ColorKey val value is in RGB888 format. Users can update it after setting FBIOSET_COLORKEY.
  	Enable Alpha Blend	Enable Alpha Blend or not. Value: 0: N; 1: Y, default. Users can update it after setting FBIOSET_GLOBAL_ALPHA. Pixel alpha config is invalid when disabled it. Only pixel alpha is valid when it is enabled and Multi Alpha is disabled.(For ARGB1555 format, Alpha bit is 1, using Global Alpha as pixel alpha; Alpha bit is 0, using 0xff as pixel alpha.) When this item and Multi Alpha are enabled, the pixel alpha and Global Alpha are both valid.
  	Enable Multi Alpha	Enable Multi Alpha or not. Value: 0: Y; 1: N, default value. Enable Multi Alpha, then Global Alpha are valid.
  	Global Alpha Val	Global Alpha
  	Alpha0	In ARGB1555 format, when the highest bit is 0, select Alpha0 as the Alpha blending value. Value: 0~255, the default is 0.
  	Alpha1	In ARGB1555 format, when the highest bit is 1, select Alpha1 as the Alpha blending value. Value: 0~255, the default is 0.
  	GOP Hstart	The offset of the layer hardware to the display window. This value is related to the current output timing. When the output timing changes, the layer driver is notified by FBIOSET_DISPLAYLAYER_ATTRIBUTES and the u32SetAttrMask value of MI_FB_DisplayLayerAttr_s contains the E_MI_FB_DISPLAYLAYER_ATTR_MASK_SCREEN_SIZE mask bit. The layer driver will set the corresponding hstart value according to the current timing
  	Current TimingWidth	The width and height of the current output timing and the offset relative to the display window that should be set for the layer hardware under the current timing. Used in conjunction with GOP Hstart to check whether the hstart value set to the hardware layer is consistent with the current timing.
  	Current TimingHeight
  	hstar

  Table 13‑3

  Parameter		Description
  Hwcursor info	Cursor Gop ID	Cursor Gop ID
  	Cursor Gwin ID	Cursor Gwin ID
  	Cursor MIU Sel	The physical memory number for storing cursor icon data. For MSR620 devices, the value is 0.
  	Cursor PhyAddr	The physical address of the cursor layer currently displayed data
  	Cursor ColorFmt	The cursor layer format. Value: ARGB1555,ARGB4444,ARGB8888,RGB565. User can set it by FBIOSET_CURSOR_ATTRIBUTE
  	Cursor Icon Width	The width and height of the cursor icon. Unit: pixel, user can set it by FBIOSET_CURSOR_ATTRIBUTE.
  	Cursor HotSpot	Cursor icon hotspot information. Unit: pixel. Hotspot information is usually related to the cursor icon, and user can set it by FBIOSET_CURSOR_ATTRIBUTE
  	Cursor request pos	Cursor request position. Unit: pixel. User can set it by FBIOSET_CURSOR_ATTRIBUTE.
  	Cursor Visible	Cursor visible or not. Value: 0: N; 1: Y. User can set it by FBIOSET_CURSOR_ATTRIBUTE.
  	Cursor Gwin Pos	Cursor Gwin starting position. Unit: pixel.
  	Cursor Gwin Pitch	Bytes per line of the cursor layer. The value is fixed at 0x200.
  	Curosr StretchWindow pos	Cursor layer starting position on the display device. Unit: pixel.
  	Cursor StretchWin Src	Original size of cursor layer. Unit: pixel.
  	Cursor StretchWin Dst	The width and height of the cursor layer on the display device. The value is the same as the output timing.
  	Cursor ColorKey Enable	Cursor ColorKey enable or not. Value: 0: N; 1: Y. User can set it by FBIOSET_CURSOR_ATTRIBUTE.
  	Cursor ColorKey Value	RED/GREEN/BLUE channels of cursor colorKey. Value range of each channel: 0-255. ColorKey val value is in RGB888 format. Users can update after setting FBIOSET_CURSOR_ATTRIBUTE.

13.2. echo¶

Table 13‑4

Table 13‑5

Table 13‑6

Table 13‑7

Table 13‑8

14. GFX¶

14.1. cat¶

• Debug info

  # cat /proc/mi_modules/mi_gfx/mi_gfx0
  

  

  Fig 14‑1

• Debug info analysis

  Record the current GFX usage status and device attributes, and can dynamically obtain information, which is convenient for debugging and testing.

• Parameter

  Table 14‑1

  Parameter		Description
  device info	InitCnt	Device opened times. GFX can be called by modules, but not sure which module would call GFX init first, the device allows multiple open and record the open times to determine whether the device is required to be closed.
  	ARGB1555AlphaThreshold	Convert ARGB8888 to ARGB1555. If the alpha threshold in GFX is greater than N, then alpha is 1, otherwise, alpha is 0.
  	ARGB1555AlphaValue	Convert ARGB1555 to ARGB8888, GFX converts the pixel alpha whose alpha bit of ARGB1555 is 1 to ARGB1555AlphaValue
  	ScalingCoefficient	Image geometric center offset= ScalingCoefficient/1000
  	QuickFillColorFormt	The color format of the last QuickFill Value: GFX_Buffer_Format
  	BitblitSrcColorFormt	The color format of the last BitBlit Src Surface
  	BitblitDstColorFormt	The color format of the last BitBlit Dst Surface

15. REGION¶

15.1. cat¶

• Debug info

  # cat /proc/mi_modules/mi_rgn0
  

  

  Fig 15‑1

  

  Fig 15‑2

  

  Fig 15‑3

• Debug info analysis

  Record the current RGN usage status and device attributes, and can dynamically obtain information, which is convenient for debugging and testing.

• Parameter

  Table 15‑1

  Parameter		Description
  Region capability	Region handle	The max regions to create are 1024, value: [0~1023]
  	channel	The max channels are 64, the channel value: [0~63]
  	Osd attach	The max Osds that can be bound to each channel of the output port are 128
  	Cover attach	The max Covers that can be bound to each channel of the output port are 4
  	Overlay Supported Format	Osd supported color format: 0: ARGB1555, align width by 2 pixels 1: ARGB4444, align width by 2 pixels 2: I2, align width by 4 pixels 3: I4, align width by 2 pixels 4: I8 5: RGB565 6: ARGB8888
  	Osd support	Osd width value range: 1 ~ 4096 Osd height value range: 1~ 4096 Color key value: Default colorkey value of the system, except for the index format X pos overlap: Support multiple OSDs overlapping in the x direction. Overlap: osd supports overlap or not HW mode: The frontbuffs of Osd, currently set to 8
  	Cover support	Osd width value range: 1 ~ 8192 Osd height value range: 1~ 8192 Overlap: Cover supports overlap or not

  Table 15‑2

  Parameter		Description
  Region attr	Handle	Handle
  Type	Osd or Cover
  Width	Width
  Height	Height
  Stride	Stride
  Format	Color format: [0-6], ARGB1555, ARGB4444, I2, I4, I8, RGB565, ARGB8888
  VirAddr	Canvas virtual address
  PhyAddr	Canvas physical address

  Table 15‑3

  Parameter			Description
  Channel port Info	Frontbuffer info	Index	Frontbuffer index
  		bShow	Show it or not
  		OffsetX	X offset
  		OffsetY	Y offset
  		Width	Width
  		Height	Height
  		Stride	Stride
  		Format	Color format
  		VirAddr	Virtual address
  		PhyAddr	Physical address
  		AlphaMode	Alpha mode, Pixel alpha or constant alpha
  		AlphaVal	Constant alpha value
  		BgAlpha	In pixle alpha, argb1555 background alpha
  		FgAlpha	In pixle alpha, argb1555 foreground alpha
  		BufCnt	Front buffers on the channel
  		OsdCnt	Number of back buffers for splicing a front buffer on the channel
  	Attach info	Handle	Bind the region handle
  		Type	Bind the region type
  		bShow	Show it or not
  		Layer	Bind the layer of Cover
  		Color	Bind the color value of Cover
  		Width	Width
  		Height	Height
  		Stride	Stride
  		PositionX	X offset
  		PositionY	Y offset
  		Format	Bind the color format of Osd
  		VirAddr	Virtual address
  		PhyAddr	Physical address
  		AlphaVal	Constant alpha value
  		BgAlpha	In pixle alpha, argb1555 background alpha
  		FgAlpha	In pixle alpha, argb1555 foreground alpha

  Table 15‑4

  Parameter	Description
  Buffer info	kmalloc	Memory bytes applied for in the Region module.
  	mma alloc	Region module applies for the memory bytes through Sys module

15.2. echo¶

Table 15‑5

Table 15‑6

Table 15‑7

Table 15‑8

Table 15‑9

Table 15‑10

Table 15‑11

Table 15‑12

Table 15‑13

16. VDEC¶

16.1. cat¶

• Debug info

  # cat /proc/mi_modules/mi_vdec/mi_vdec0
  

  

  Fig 16‑1

• Debug info analysis

  Use Private Vdec0 Info to divide the print info into two parts. One part is common info, and the other part is vdec module info.

  It mainly records the usage and config attributes of the decoding channel, which can be used to check the attribute config and the working status of the current channel, it is convenient for debugging.

• Parameter

  Table 16-1

  parameter		Description
  DEV Info	DevID	Decoding device ID.
  	UUID	Chip identification code.
  	MaxChnNum	Max decoding channels.
  	bDisableLowLatency	Disable the low-latency switch for B-frame decoding. It is enabled by default, that is, only IP frame decoding is supported. Y: Disable the low-latency; N: enable the low-latency.
  CHN ATTR Info	ChnID	Channel ID.
  	CodecType	Decoding protocol type; 0: H264; 1: H265; 2: JPEG.
  	Width	Max width of decoded image.
  	Height	Max height of decoded image.
  	BufSize	VDEC code stream buffer size, unit: byte.
  	VideoMode	Code stream sending mode. STREAM: Send by stream； FRAME: Send by frame.
  	DpbBufMode	DPB buffer mode; INPLACE1: A decoded image buffer; INPLACE2: Two decoded image buffers; NORMAL: Normal mode, it cannot save frame buffer.
  	RefFrmNum	Max reference frames, JPEG channel is invalid.
  CHN PARAM Info	ChnID	Channel ID.
  	bCusPolicy	For the wrong macro block, the user decides on or off. Y: Turn on user settings; N: Turn off user settings, which is the default value.
  	ErrMBDropThrd	Error mcro block drop frame threshold.
  	DisplayMode	Display mode. 0: Preview mode, output without referring to PTS. 1: Playback mode, output referring to PTS.
  Scale & Crop Info	ChnID	Channel ID.
  	bScale	Scale or not. Y: Enable； N: Disable.
  	ScaleW	Scale width.
  	ScaleH	Scale height.
  	bCrop	Crop or not. Y: Enable； N: Disable.
  	CropX	Crop X.
  	CropY	Crop Y.
  	CropW	Crop width.
  	CropH	Crop height.
  Decode Frame Info	ChnID	Channel ID.
  	DecW	Decode width.
  	DecH	Decode height.
  	DispW	Display width.
  	DispH	Display height.
  	LinearFrmCnt	Linear frame buffers count.
  Output Frame Info	ChnID	Channel ID.
  	bTileMode	Tile mode. Y: Enable； N: Disable.
  	TileFormat	Tile format. Only support 128x64.
  	Width	Output image width.
  	Height	Output image height.
  	Stride	Output image stride.
  	PixelFmt	Output image pixel format.
  CHN STATE	ChnID	Channel ID.
  	bStart	Whether the decoder starts to receive the code stream.
  	DecState	Decoder status. 1: Enable the decoder; 2: Initialize the decoder; 3: Wait for the init to complete; 4: Register frame buffer 5: Decoding; 6: Disable the decoder.
  	SendCnt	Count the times that Api sent the code stream successfully.
  	SendStrmSize	The total data of the code stream successfully sent by Api.
  	LeftStrmBytes	The bytes to be decoded in the stream buffer.
  	DecFrmCnt	The decoded frames in the stream buffer.
  	fps	Decode frame rate.
  CHN STATE	ChnID	Channel ID.
  	Start	Times of starting decoding.
  	Get	Get the times decoded output information.
  	Drop	Times of dropping frames.
  	Run	Times of returning running status.
  	SeqChange	Times of sequence switching.
  	InitSeq	Interruptions of the initialization sequence.
  	VlcInsuff	Insufficient Vlc buffer interrupts.
  	FrmDone	Interruptions of Successfully decoding.
  ISR STATE	IsrCnt	Count the interruptions times.
  	InitSeq	Interruptions of the initialization sequence.
  	VlcInsuff	Insufficient Vlc buffer interrupts.
  	FrmDone	Interruptions of Successfully decoding.
  	UnderRun	Interruptions being decoding.
  	HwTimeout	HW timeout interruptions.
  	Other	Other interruptions.

16.2. echo¶

Table 16-2

Table 16-3

Table 16-4

Table 16-5

Table 16-5

Table 16-6