Video Processing Debug Tool

Overview

Video processing is an essential component in media driver, we have some tools for debugging purpose, including surface dump, driver log, ddi log etc.

Driver version

Media driver release-internal or debug version installtion is required for log informaiton dump. Release version driver can not support this debug tool for performance and efficiency.

Registry key

Media starts to switch to device-based and modularized user setting from media driver commit 3cd7bff.

You could use below command to add the registry key file for debug as below. The media drive reads [Config] section and reports debug information in [report] section. All items in registry key file following the format "registry keys name"="keyValue".

$vim /etc/igfx_user_feature_next.txt 

[config]
    key1 = value1
[report]
    key2 = value2

How to dump VP input/output surface?

1. Firstly create a surface dump file, like vp_dump as below. Please make sure this folder is writable. The surfaces will be dumped in this file folder.

   $mkdir -p /data/vp_dump
   

2. Add below keys to /etc/igfx_user_feature_next.txt under "[config]".

   1. "preAll" means the input surface of video processing, "postAll" means the output surface of video processing.
   2. If the input surface "preAll" is correct, but the output surface "postAll" is corrupted, probably the issue is in video processing driver.
   3. If the input surface "preAll" is corrupted, please check the component of the pipeline before video processing.
   4. If the output surface "postAll" is correct, please check the component of the pipeline after video processing.

   [config]
   outfileLocation=/data/vp_dump/
   dumpLocations=preAll,postAll
   

How to dump VP HLT log?

1. Firstly create a HLT log dump folder as below. please make sure this file folder is writable.

   $mkdir -p /data/vp_dump
   

2. Add below keys to /etc/igfx_user_feature_next.txt under "[config]". It will saved HLG log to /data/vp_dump/igd_xxxx.log, which will give you some hints about driver behavior.

   [config]
   Message Print Enabled=1
   Message HLT Enabled=1
   Codec Message Tags=7
   VP Message Tags=7
   DDI Message Tags=7
   Mhw Message Tags=7
   Message HLT Output Directory=/data/vp_dump/
   

How to dump VP DDI Trace log?

Below commands could be used to dump the parameters in video processing driver device interface(DDI). It will help you to check if the parameters is expected which app or media framework passed to driver.

$mkdir /data
$export  VPDDI_TRACE=/data/vpddi.log