Intel® System Debugger User Guide
| ID | Date | Version | Classification |
|---|---|---|---|
| 648476 | 10/17/2024 | Confidential |
Ice Lake - Integrated Sensor Hub
This section describes how to configure the target for live trace streaming using the System Trace.
Prerequisites
Trace Message Catalog
The Integrated Sensor Hub uses a message catalog for kernel messages. You have to install the decode catalog to be able to receive usable traces from the Integrated Sensor Hub. Please contact Intel support to receive the message catalog file.
Windows OS: Integrated Sensor Hub Driver*
Windows* OS communicates with Integrated Sensor Hub firmware using the kernel driver. Integrated Sensor Hub drivers are part of Intel(R) Best Known Configuration Package Manager (Intel(R) BKC Package Manager) and are available for download as part of the Integrated Firmware Image (IFWI) package.
The driver comes with the Integrated Sensor Hub Firmware Development Kit tools available at C:Intel_ISS_FDKTools.
One of the tools included in the package is the SensorViewer: a basic tool to analyze the current sensor state. In case SensorViewer fails to identify sensors, run the Troubleshooter tool to get more information.
Setup
Apply the OEM debug token.
To debug the Integrated Sensor Hub (ISH) firmware, you have to stitch your OEM debug token with the Integrated Firmware Image (IFWI). Contact Intel support to learn how to generate the debug token.
Enable Integrated Sensor Hub firmware in the FitC tool.
The image below shows the correct settings with the
issC.bin file used as input:(Optional) Enable the Intel(R) Trace Hub messages at compile time using the PDT Editor. Select the PDT Editor settings as shown below:
Connect to the target using an Intel(R) Direct Connect Interface cable.
Setup BIOS.
To enable tracing, enter the BIOS and change the settings as follows:
Go to Intel Advanced Menu > PCH-IO Configuration > Trace Hub Configuration Menu. Set Trace Hub Enable Mode to <Host Debugger>.
Go to Intel Advanced Menu > PCH-IO Configuration. Set Intel(R) Direct Connect Interface (Intel(R) DCI) Enable (HDCIEN) to <Enabled>.
Go to Intel Advanced Menu > CPU Configuration. Set Debug Interface and Intel(R) Direct Connect Interface to <Enabled>.
Save and exit the BIOS.
Select proper trace sources
Create a trace configuration file and select proper trace sources. For instructions, see Select Trace Sources.