This folder (Debug_Scripts) contains different sets of script file which enable and capture Windows* Pre-processor (WPP) log file for Intel(r) USB 3.0 eXtensible Host Controller Driver. The script file should be run under the System Under Test (SUT). There are two types of script file provided:

	**Batch file (.bat) - These batch files enable and capture WPP log using logman.exe tool. It's recommended to use the batch script files to capture WPP log when the system is in S0/S3 power state.

	**Windows* Registry file (.reg) - These script files will enable WPP log section using Autologger tool through Windows* Registry. It's recommended to use the .reg script  files to capture WPP log when system is in S4/S5 power state.


Contents:

providers.txt :
	File used by the batch file.
	The file contains Intel USB driver GUIDs. It also sets WPP trace logging flag and level.


******************************

start_WPP_logman.bat : 
	This batch file will configure and start a WPP trace log section called “IUSB3P”. 
	Usage:	
	- C:\..\start_WPP_logman.bat  “File_Name”
	- WPP log file will be saved on the same folder location as the script file with .etl extension 

stop_WPP_logman.bat :
	This batch file will stop the current WPP trace log section called “IUSB3P”


start_WPP_Circular_buffer.bat: 
	This batch file is similar to the start_WPP_logman.bat. It will enable a circular buffer file with a maximum file size of 250MB
	Usage:	
	- same as start_WPP_logman.bat
	- Recommended to use this script file when capturing WPP log for issue that takes long time to replicate. 


NOTE: To capture WPP log using the script bacth files, the batch file needs to be run on a Windows* command prompt with administrator level

******************************


Autologger_configure.reg :
	This script file will configure the Autologger tool in the Windows* registry
	The Captured WPP log file will be saved as C:\IUSB3P.etl

Autologger_configure_Circular_buffer.reg
	This script file is similar to the Autologger_configure.reg. It will enable a circular buffer with a maximum file size of 250MB
	Recommended to use this script file when capturing WPP log for issue that takes long time to replicate.

Autologger_configure_extended_buffer_to_memory.reg
	This script file will configure Autologger setting  with an extender buffer and the log data will be saved into the system memory. 
	Recommended to use this script file when capturing WPP log for BSOD issue. The WPP log data will be saved as part of the MEMORY dump when full memory dump capture is enabled in the platform.


Autologger_start.reg
	This script file starts the WPP log capture section
	It sets "Start" field value to '1'
	Note: require system reboot for setting to take effect


Autologger_stop.reg
	This script file stops the WPP log capture section
	It sets "Start" field value to '0'
	Note: require system reboot for setting to take effect. 





