AMC

AMC (Add-in Card Management Controller) operations. Supports GPU resets via AMC, reading real-time sensor data, and retrieving files from the GPU.

Note

This command is supported on Linux only. Some operations may require root privileges.

Synopsis

xpu-smi amc --gpureset
xpu-smi amc --gpureset -y
xpu-smi amc --gpureset -d [deviceId]
xpu-smi amc --gpureset --device [deviceId]
xpu-smi amc --gpureset --device [deviceId] -y
xpu-smi amc --sensor --device [deviceId] -s [sensorId]
xpu-smi amc --sensor --device [deviceId] -s [sensorId] -j
xpu-smi amc --file --device [deviceId] --filetype [fileType] --filename [outputFile]

Options

-h, --help

Print this help message and exit.

-j, --json

Print result in JSON format.

-d <deviceId>, --device <deviceId>, --id <deviceId>

Specify the device ID or PCI BDF address. A device ID names the same GPU as in the other commands, such as discovery and updatefw. The amc command does not use Level Zero, so on Linux it works the device IDs out from sysfs. On Windows, a device ID counts AMC devices in the order they are discovered, which can differ from the other commands. The PCI BDF address always names the same device.

Note

Unlike the other commands, the amc command operates on a single device only and does not accept a comma-separated list of devices.

--gpureset

Reset GPU(s) via AMC. If --device is not specified, all GPUs are reset.

--sensor

Read real-time sensor readings from the AMC. Requires -s to specify which sensor to read.

-s <sensorId>, --sensorid <sensorId>

Specify the sensor ID to read. Supported sensor IDs:

ID

Sensor

1

Temperature Sensor 0 from Add-In-Card

2

Temperature Sensor 1 from Add-In-Card

3

VR VCCGT Temperature 0 from Add-In-Card

4

VR VCCGT Input Power 0 from Add-In-Card

5

VR VCCGT Input Voltage 0 from Add-In-Card

6

VR VCCGT Input Current 0 from Add-In-Card

85

Card Average Power

--file

Read a file from the GPU via AMC. Requires --filetype and optionally --filename.

--filetype <id>

Specify the type of file to retrieve. Valid file type IDs:

ID

Description

0

GPU logs

--filename <path>

Output file path for the retrieved file. If not specified, defaults to amc_file_<timestamp>.txt.

-y, --yes

Skip the confirmation prompt.

Examples

Reset all GPUs via AMC (with confirmation):

xpu-smi amc --gpureset

Reset GPU on device 0 via AMC without confirmation:

xpu-smi amc --gpureset --device 0 -y

Read card average power sensor for device 0:

xpu-smi amc --sensor --device 0 -s 85

Read temperature sensor 0 and output as JSON:

xpu-smi amc --sensor --device 0 -s 1 -j

Retrieve GPU logs from device 0:

xpu-smi amc --file --device 0 --filetype 0 --filename gpu_logs.txt