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

Install media release-internal or debug driver. Please note, release-internal or debug are needed; release version 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 3cd7bff13eb1e702762610a3b5b1ea90de1099be.

$vim /etc/igfx_user_feature_next.txt (Add below Key path if it's not exist.[Config] section is the registry key media driver to read. [report] section is the key media driver reported. Each item in the format "registry keys name"="keyValue" represents a registry key.)

[config]

[report]

To dump VP input/output surface

$mkdir -p /data/vp_dump (Surfaces will be dumped in this file folder, please make sure this file folder is writable.)

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

To dump VP HLT log

$mkdir -p /data/vp_dump (HLT log will be dumped in this file folder, please make sure this file folder is writable.) 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/

To dump VP DDI Trace log

This tool 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