Intel® System Debugger User Guide

ID 648476
Date 06/13/2024
Confidential
Document Table of Contents

PCI Devices View

Toolbar

pci_view PCI Devices

To show a list of PCI devices available during a debug session, halt the target and open the PCI Devices view, which displays all devices found.

Note:

When the target is running, the view is empty. The list of PCI devices gets updated every time you halt the target.

To find a particular PCI device, start typing the device name in the search bar. The suggested items are displayed and the best match is highlighted blue. Alternatively, you can use the drop-down menu.

When a particular PCI device is selected, the view displays all registers belonging to the device. For certain registers, you can find meaningful descriptions in the Registers view.

The PCI device content is available in two formats: structured and raw. Both offer write access by editing the displayed numerical values. Refreshing will reflect the changes in the view after editing.

PCI Bar Linking

In the PCI device browser, the Base Address Register (BAR) addresses are linked to the memory view widget to easily display these address spaces. Right-click on the desired BAR address, and then select View Memory as shown below:

pci_bar

Note:

The 4 lower bits of the BAR addresses have a special meaning/encoding and should be ignored.

View Toolbar Options

You can interact with the PCI Devices view using the following default buttons:

refresh_view Refresh

Forces a new scan for PCI devices available. Click a chevron next to the button to specify the type of scan:

  • Quick scan (default) - searches through buses as a tree structure to extract information about PCI devices. Not recommended for complex systems with multiple CPUs and start buses (use the full scan instead).

  • Full scan - iteratively searches for all buses. Takes more time than the quick scan but enables successful scanning through complex systems.

page_tables_view Extended PCI Configuration space

If the extended PCI configuration space is available, it will be exposed in the Raw view. Otherwise, the view will switch to the legacy configuration space.