AMD SMI Python API reference

Python interface – Consists of Python function declarations, which directly call the C interface. The client can use the Python interface to build applications in Python.

Requirements

• python 3.10+ 64-bit

Overview

Folder structure

File Name	Note
__init__.py	Python package initialization file
amdsmi_interface.py	Amdsmi library python interface
amdsmi_wrapper.py	Python wrapper around amdsmi binary
amdsmi_exception.py	Amdsmi exceptions python file
README.md	Documentation

Build steps

Navigate to project’s root folder and run Makefile command:

• make package

Build process will create a folder build/amdsmi/package/BUILD_MODE/amdsmi, where BUILD_MODE can be Release or Debug. The folder will contain the following files:

• __init__.py

• amdsmi_interface.py

• amdsmi_wrapper.py

• amdsmi_exception.py

• libamdsmi.so

• README.md

Amdsmi usage

Generated amdsmi folder should be copied and placed next to importing script. It should be imported as:

from amdsmi import *

try:
    amdsmi_init()

    # amdsmi calls ...

except AmdSmiException as e:
    print(e)
finally:
    try:
        amdsmi_shut_down()
    except AmdSmiException as e:
        print(e)

To initialize amdsmi lib, amdsmi_init() must be called before all other calls to amdsmi lib.

To close connection to driver, amdsmi_shut_down() must be the last call.

Amdsmi Exceptions

All exceptions are in amdsmi_exception.py file. Exceptions that can be thrown are:

• AmdSmiException: base smi exception class

• AmdSmiLibraryException: derives base AmdSmiException class and represents errors that can occur in smi-lib. When this exception is thrown, err_code and err_info are set. err_code is an integer that corresponds to errors that can occur in smi-lib and err_info is a string that explains the error that occurred. Example:

try:
    amdsmi_init()
    processors = amdsmi_get_processor_handles()
    num_of_GPUs = len(processors)
    if num_of_GPUs == 0:
        print("No GPUs on machine")
except AmdSmiException as e:
    print("Error code: {}".format(e.err_code))
    if e.err_code == AmdSmiRetCode.AMDSMI_STATUS_RETRY:
        print("Error info: {}".format(e.err_info))
finally:
    try:
        amdsmi_shut_down()
    except AmdSmiException as e:
        print(e)

• AmdSmiRetryException : Derives AmdSmiLibraryException class and signals processor is busy and call should be retried.

• AmdSmiTimeoutException : Derives AmdSmiLibraryException class and represents that call had timed out.

• AmdSmiParameterException: Derives base AmdSmiException class and represents errors related to invaild parameters passed to functions. When this exception is thrown, err_msg is set and it explains what is the actual and expected type of the parameters.

• AmdSmiBdfFormatException: Derives base AmdSmiException class and represents invalid bdf format.

Amdsmi API

amdsmi_init

Description: Initialize smi lib and connect to driver

Input parameters: init_flags (Optional parameter, if no value provided, default value is AMDSMI_INIT_ALL_PROCESSORS value)

init_flags is AmdSmiInitFlags enum:

Field	Description
INIT_ALL_PROCESSORS	all processors
INIT_AMD_CPUS	amd cpus
INIT_AMD_GPUS	amd gpus
INIT_NON_AMD_CPUS	non amd cpus
INIT_NON_AMD_GPUS	non amd gpus
INIT_AMD_APUS	amd apus

Output: None

Exceptions that can be thrown by amdsmi_init function:

• AmdSmiLibraryException

Example:

try:
    amdsmi_init()
    # continue with amdsmi
except AmdSmiException as e:
    print("Init failed")
    print(e)

amdsmi_shut_down

Description: Finalize and close connection to driver

Input parameters: None

Output: None

Exceptions that can be thrown by amdsmi_shut_down function:

• AmdSmiLibraryException

Example:

try:
    amdsmi_shut_down()
except AmdSmiException as e:
    print("Fini failed")
    print(e)

amdsmi_get_processor_handles

Description: Returns list of GPU device handle objects on current machine

Note: This function currently supports only AMD GPUs. To enumerate other devices, such as AMD NICs, use amdsmi_get_processor_handles_by_type().

Input parameters: None

Output: List of GPU device handles

Exceptions that can be thrown by amdsmi_get_processor_handles function:

• AmdSmiLibraryException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        for processor in processors:
            print(amdsmi_get_gpu_device_uuid(processor))
except AmdSmiException as e:
    print(e)

amdsmi_get_processor_handles_by_type

Description: Returns a list of processor handles of the specified type in the system.

Input parameters:

• processor_type one of AmdSmiProcessorType enum values:

Field	Description
UNKNOWN	Unknown processor type
AMD_GPU	AMD GPU device
AMD_CPU	AMD CPU device (Not supported yet)
NON_AMD_GPU	Non-AMD GPU device (Not supported yet)
NON_AMD_CPU	Non-AMD CPU device (Not supported yet)
AMD_CPU_CORE	AMD CPU core (Not supported yet)
AMD_APU	AMD Accelerated Processing Unit (APU) (Not supported yet)
AMD_NIC	AMD Network Interface Card (NIC)

Output: List of processor handles of the chosen type

Exceptions that can be thrown by amdsmi_get_processor_handles_by_type function:

• AmdSmiParameterException

• AmdSmiLibraryException

Example:

try:
    processor_handles = amdsmi_get_processor_handles_by_type(AmdSmiProcessorType.AMD_GPU)
    if len(processor_handles) == 0:
        print("No GPUs on machine")
    else:
        for processor in processor_handles:
            print(amdsmi_get_gpu_device_uuid(processor))

    nic_handles = amdsmi_get_processor_handles_by_type(AmdSmiProcessorType.AMD_NIC)
    if len(nic_handles) == 0:
        print("No NICs on machine")
    else:
        for nic in nic_handles:
            print(amdsmi_get_nic_asic_info(nic))
except AmdSmiException as e:
    print(e)

amdsmi_get_processor_handle_from_bdf

Description: Returns processor handle from the given BDF

Input parameters: bdf string in form of either <domain>:<bus>:<device>.<function> or <bus>:<device>.<function> in hexcode format. Where:

• <domain> is 4 hex digits long from 0000-FFFF interval

• <bus> is 2 hex digits long from 00-FF interval

• <device> is 2 hex digits long from 00-1F interval

• <function> is 1 hex digit long from 0-7 interval

Output: processor handle object

Exceptions that can be thrown by amdsmi_get_processor_handle_from_bdf function:

• AmdSmiLibraryException

• AmdSmiBdfFormatException

Example:

try:
    processor = amdsmi_get_processor_handle_from_bdf("0000:23:00.0")
    print(amdsmi_get_gpu_device_uuid(processor))
except AmdSmiException as e:
    print(e)

amdsmi_get_gpu_device_bdf

Description: Returns BDF of the given processor (GPU PF).

Input parameters:

• GPU device for which to query

Output: BDF string in form of <domain>:<bus>:<device>.<function> in hexcode format. Where:

• <domain> is 4 hex digits long from 0000-FFFF interval

• <bus> is 2 hex digits long from 00-FF interval

• <device> is 2 hex digits long from 00-1F interval

• <function> is 1 hex digit long from 0-7 interval

Exceptions that can be thrown by amdsmi_get_gpu_device_bdf function:

• AmdSmiParameterException

• AmdSmiLibraryException

Example:

try:
    processor = amdsmi_get_processor_handle_from_bdf("0000:23:00.0")
    print("GPU bdf:", amdsmi_get_gpu_device_bdf(processor))
except AmdSmiException as e:
    print(e)

amdsmi_get_nic_device_bdf

Description: Returns BDF of the given processor (NIC).

Input parameters:

• NIC device for which to query

Output: BDF string in form of <domain>:<bus>:<device>.<function> in hexcode format. Where:

• <domain> is 4 hex digits long from 0000-FFFF interval

• <bus> is 2 hex digits long from 00-FF interval

• <device> is 2 hex digits long from 00-1F interval

• <function> is 1 hex digit long from 0-7 interval

Exceptions that can be thrown by amdsmi_get_nic_device_bdf function:

• AmdSmiParameterException

• AmdSmiLibraryException

Example:

try:
    processor = amdsmi_get_processor_handle_from_bdf("0000:23:00.0")
    print("NIC bdf:", amdsmi_get_nic_device_bdf(processor))
except AmdSmiException as e:
    print(e)

amdsmi_get_processor_bdf

Description: Returns BDF of the given processor.

Input parameters:

• Processor for which to query

Output: BDF string in form of <domain>:<bus>:<device>.<function> in hexcode format. Where:

• <domain> is 4 hex digits long from 0000-FFFF interval

• <bus> is 2 hex digits long from 00-FF interval

• <device> is 2 hex digits long from 00-1F interval

• <function> is 1 hex digit long from 0-7 interval

Exceptions that can be thrown by amdsmi_get_processor_bdf function:

• AmdSmiParameterException

• AmdSmiLibraryException

Example:

try:
    processor = amdsmi_get_processor_handle_from_bdf("0000:23:00.0")
    print("processor bdf:", amdsmi_get_processor_bdf(processor))
except AmdSmiException as e:
    print(e)

amdsmi_get_index_from_processor_handle

Description: Returns the index of the given processor handle

Input parameters:

• GPU device for which to query

Output: GPU device index

Exceptions that can be thrown by amdsmi_get_index_from_processor_handle function:

• AmdSmiParameterException

• AmdSmiLibraryException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        for processor in processors:
            print("Processor's index:", amdsmi_get_index_from_processor_handle(processor))
except AmdSmiException as e:
    print(e)

amdsmi_get_processor_handle_from_index

Description: Returns the processor handle from the given processor index

Input parameters:

• Function processor index to query

Output: processor handle object

Exceptions that can be thrown by amdsmi_get_processor_handle_from_index function:

• AmdSmiParameterException

• AmdSmiLibraryException

Example:

try:
    processors = amdsmi_get_processor_handles()
    num_of_GPUs = len(processors)
    if num_of_GPUs == 0:
        print("No GPUs on machine")
    else:
        for index in range(num_of_GPUs):
            print("Processor handle:", amdsmi_get_processor_handle_from_index(index))
except AmdSmiException as e:
    print(e)

amdsmi_get_vf_bdf

Description: Returns BDF of the given VF

Input parameters:

• VF for which to query

Output: BDF string in form of <domain>:<bus>:<device>.<function> in hexcode format. Where:

• <domain> is 4 hex digits long from 0000-FFFF interval

• <bus> is 2 hex digits long from 00-FF interval

• <device> is 2 hex digits long from 00-1F interval

• <function> is 1 hex digit long from 0-7 interval

Exceptions that can be thrown by amdsmi_get_vf_bdf function:

• AmdSmiParameterException

• AmdSmiLibraryException

Example:

try:
    vf = amdsmi_get_vf_handle_from_bdf("0000:23:02.0")
    print("VF's bdf:", amdsmi_get_vf_bdf(vf))
except AmdSmiException as e:
    print(e)

amdsmi_get_vf_handle_from_bdf

Description: Returns processor handle (VF) from the given BDF

Input parameters: bdf string in form of either <domain>:<bus>:<device>.<function> or <bus>:<device>.<function> in hexcode format. Where:

• <domain> is 4 hex digits long from 0000-FFFF interval

• <bus> is 2 hex digits long from 00-FF interval

• <device> is 2 hex digits long from 00-1F interval

• <function> is 1 hex digit long from 0-7 interval

Output: processor handle object

Exceptions that can be thrown by amdsmi_get_vf_handle_from_bdf function:

• AmdSmiLibraryException

• AmdSmiBdfFormatException

Example:

try:
    vf = amdsmi_get_vf_handle_from_bdf("0000:23:02.0")
    print(amdsmi_get_vf_uuid(vf))
except AmdSmiException as e:
    print(e)

amdsmi_get_processor_handle_from_uuid

Description: Returns processor handle from the given UUID

Input parameters: uuid string Output: processor handle object

Exceptions that can be thrown by amdsmi_get_processor_handle_from_uuid function:

• AmdSmiLibraryException

Example:

try:
    processor = amdsmi_get_processor_handle_from_uuid("fcff7460-0000-1000-80e9-b388cfe84658")
    print("Processor's UUID: ", amdsmi_get_gpu_device_uuid(processor))
except AmdSmiException as e:
    print(e)

amdsmi_get_vf_handle_from_uuid

Description: Returns the handle of a virtual function (VF) from the given UUID

Input parameters: uuid string Output: vf object

Exceptions that can be thrown by amdsmi_get_vf_handle_from_uuid function:

• AmdSmiLibraryException

Example:

try:
    vf = amdsmi_get_vf_handle_from_uuid("87007460-0000-1000-8059-3ae746ab9206")
    print("VF's UUID: ", amdsmi_get_vf_uuid(vf))
except AmdSmiException as e:
    print(e)

amdsmi_get_gpu_device_uuid

Description: Returns the UUID of the device

Input parameters:

• GPU device for which to query

Output: UUID string unique to the device

Exceptions that can be thrown by amdsmi_get_gpu_device_uuid function:

• AmdSmiParameterException

• AmdSmiLibraryException

Example:

try:
    processor = amdsmi_get_processor_handle_from_bdf("0000:23:00.0")
    print("Device UUID: ", amdsmi_get_gpu_device_uuid(processor))
except AmdSmiException as e:
    print(e)

amdsmi_get_vf_uuid

Description: Returns the UUID of the device

Input parameters:

• VF handle for which to query

Output: UUID string unique to the device

Exceptions that can be thrown by amdsmi_get_vf_uuid function:

• AmdSmiParameterException

• AmdSmiLibraryException

Example:

try:
    vf_id = amdsmi_get_vf_handle_from_vf_index(processor_handle, 0)
    print("VF UUID: ", amdsmi_get_vf_uuid(vf_id))
except AmdSmiException as e:
    print(e)

amdsmi_get_gpu_driver_info

Description: Returns the version string of the driver

Input parameters:

• processor_handle GPU device for which to query

Output:

• driver_name Driver name string that is handling the GPU device

• driver_version Driver version string that is handling the GPU device

• driver_date Driver date string that is handling the GPU device

Exceptions that can be thrown by amdsmi_get_gpu_driver_info function:

• AmdSmiParameterException

• AmdSmiLibraryException

Example:

try:
    processor = amdsmi_get_processor_handle_from_bdf("0000:23:00.0")
    driver_info = amdsmi_get_gpu_driver_info(processor)
    print("Driver name: ", driver_info.driver_name)
    print("Driver version: ", driver_info.driver_version)
    print("Driver date: ", driver_info.driver_date)
except AmdSmiException as e:
    print(e)

amdsmi_get_gpu_driver_model

Description: Returns driver model information

Input parameters:

• processor_handle GPU device for which to query

Output:

• current driver model from AmdSmiDriverModelType enum

AmdSmiDriverModelType enum:

Field	Description
WDDM	Windows Display Driver Model
WDM	Windows Driver Model
MCDM	Compute Driver Model

Exceptions that can be thrown by amdsmi_get_gpu_driver_model function:

• AmdSmiParameterException

• AmdSmiLibraryException

Example:

try:
    processor = amdsmi_get_processor_handle_from_bdf("0000:23:00.0")
    driver_model = amdsmi_get_gpu_driver_model(processor)
    print("Driver model: ", driver_model)
except AmdSmiException as e:
    print(e)

amdsmi_get_vf_handle_from_vf_index

Description: Returns VF id of the VF referenced by its index (in partitioning info)

Input parameters:

• processor handle PF or child VF of a GPU device for which to query

• VF's index Index of VF (0-31) in GPU’s partitioning info

Output:

• VF id

Exceptions that can be thrown by amdsmi_get_vf_handle_from_vf_index function:

• AmdSmiParameterException

• AmdSmiLibraryException

Example:

try:
    vf_id = amdsmi_get_vf_handle_from_vf_index(processor_handle, 0)
    print(amdsmi_get_vf_info(vf_id))
except AmdSmiException as e:
    print(e)

amdsmi_get_gpu_total_ecc_count

Description: Returns the number of ECC errors on the GPU device

Input parameters:

• processor_handle GPU device which to query

Output: Dictionary with fields

Field	Description
correctable_count	Count of ECC correctable errors
uncorrectable_count	Count of ECC uncorrectable errors
deferred_count	Count of ECC deferred errors

Exceptions that can be thrown by amdsmi_get_gpu_total_ecc_count function:

• AmdSmiLibraryException

• AmdSmiRetryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        for processor in processors:
            ecc_errors = amdsmi_get_gpu_total_ecc_count(processor)
            print(ecc_errors['correctable_count'])
            print(ecc_errors['uncorrectable_count'])
            print(ecc_errors['deferred_count'])
except AmdSmiException as e:
    print(e)

amdsmi_get_gpu_ecc_count

Description: Returns the number of ECC errors on the GPU device for the given block

Input parameters:

• processor_handle GPU device which to query

• block The block for which error counts should be retrieved

block is AmdSmiGpuBlock enum:

Field	Description
UMC	UMC block
SDMA	SDMA block
GFX	GFX block
MMHUB	MMHUB block
ATHUB	ATHUB block
PCIE_BIF	PCIE_BIF block
HDP	HDP block
XGMI_WAFL	XGMI_WAFL block
DF	DF block
SMN	SMN block
SEM	SEM block
MP0	MP0 block
MP1	MP1 block
FUSE	FUSE block
MCA	MCA block
VCN	VCN block
JPEG	JPEG block
IH	IH block
MPIO	MPIO block

Output: Dictionary with fields

Field	Description
correctable_count	Count of ECC correctable errors
uncorrectable_count	Count of ECC uncorrectable errors
deferred_count	Count of ECC deferred errors

Exceptions that can be thrown by amdsmi_get_gpu_ecc_count function:

• AmdSmiLibraryException

• AmdSmiRetryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        for processor in processors:
            ecc_errors = amdsmi_get_gpu_ecc_count(processor, AmdSmiGpuBlock.UMC)
            print(ecc_errors['correctable_count'])
            print(ecc_errors['uncorrectable_count'])
            print(ecc_errors['deferred_count'])
except AmdSmiException as e:
    print(e)

amdsmi_get_gpu_ecc_enabled

Description: Returns ECC capabilities (disable/enable) for each GPU block.

Input parameters:

• processor_handle GPU device which to query

Output: Dictionary of each GPU block and its value (False if the block is not enabled, True if the block is enabled)

Each GPU block in the dictionary is from AmdSmiGpuBlock enum:

Field	Description
UMC	UMC block
SDMA	SDMA block
GFX	GFX block
MMHUB	MMHUB block
ATHUB	ATHUB block
PCIE_BIF	PCIE_BIF block
HDP	HDP block
XGMI_WAFL	XGMI_WAFL block
DF	DF block
SMN	SMN block
SEM	SEM block
MP0	MP0 block
MP1	MP1 block
FUSE	FUSE block
MCA	MCA block
VCN	VCN block
JPEG	JPEG block
IH	IH block
MPIO	MPIO block

Exceptions that can be thrown by amdsmi_get_gpu_ecc_enabled function:

• AmdSmiLibraryException

• AmdSmiRetryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        for processor in processors:
            ecc_status = amdsmi_get_gpu_ecc_enabled(processor, AmdSmiGpuBlock.UMC)
            print(ecc_status)
except AmdSmiException as e:
    print(e)

amdsmi_status_code_to_string

Description: Get a description of a provided AMDSMI error status

Input parameters:

• status The error status for which a description is desired

Output: String description of the provided error code

Exceptions that can be thrown by amdsmi_status_code_to_string function:

• AmdSmiParameterException

Example:

try:
    status_str = amdsmi_status_code_to_string(AmdSmiRetCode.SUCCESS)
    print(status_str)
except AmdSmiException as e:
    print(e)

amdsmi_get_gpu_ras_feature_info

Description: Returns RAS feature info

Input parameters:

• processor_handle GPU device which to query

Output: Dictionary with fields

Field	Description
ras_eeprom_version	RAS EEPROM version
ecc_correction_schema	ecc correction schema mask used with AmdSmiEccCorrectionSchemaSupport enum

Exceptions that can be thrown by amdsmi_get_gpu_ras_feature_info function:

• AmdSmiLibraryException

• AmdSmiRetryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        for processor in processors:
            ras_feature = amdsmi_get_gpu_ras_feature_info(processor)
            print(ras_feature['ras_eeprom_version'])
            print(ras_feature['ecc_correction_schema'])
except AmdSmiException as e:
    print(e)

amdsmi_get_bad_page_threshold

Description: Returns bad page threshold

Input parameters:

• processor_handle GPU device which to query

Output: Bad page threshold value

Exceptions that can be thrown by amdsmi_get_bad_page_threshold function:

• AmdSmiLibraryException

• AmdSmiRetryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        for processor in processors:
            bad_page_threshold = amdsmi_get_bad_page_threshold(processor)
            print(bad_page_threshold)
except AmdSmiException as e:
    print(e)

amdsmi_get_gpu_bad_page_info

Description: Returns bad page info.

Input parameters:

• processor handle object PF of a GPU device to query

Output: list of dictionaries with fields for each bad page

Field	Description
retired_page	64K/4K Driver managed location that is blocked from further use
ts	Marks the last time when the RAS event was observed
mem_channel	this value identifies the memory channel the issue has been reported on
mcumc_id	this value identifies the memory controller the issue has been reported on

Exceptions that can be thrown by amdsmi_get_gpu_bad_page_info function:

• AmdSmiLibraryException

• AmdSmiRetryException

• AmdSmiParameterException

Example:

try:
    processor = amdsmi_get_processor_handle_from_bdf("0000:23.00.0")
    bad_page_info = amdsmi_get_gpu_bad_page_info(processor)
    if len(bad_page_info) == 0:
        print("no bad pages")
    else:
        for table_record in bad_page_info:
            print(hex(table_record["retired_page"]))
            print(datetime.fromtimestamp(table_record['ts']).strftime('%Y/%m/%d:%H/%M/%S'))
            print(table_record['mem_channel'])
            print(table_record['mcumc_id'])

except AmdSmiException as e:
    print(e)

amdsmi_get_gpu_asic_info

Description: Returns asic information for the given GPU

Input parameters:

• processor_handle GPU device which to query

Output: Dictionary with fields

Field	Content
market_name	market name
vendor_id	vendor id
vendor_name	vendor name
subvendor_id	subsystem vendor id
device_id	unique id of a GPU
rev_id	revision id
asic_serial	asic serial
oam_id	xgmi physical id
num_of_compute_units	num of compute units (Not supported yet, currently hardcoded to 0)
target_graphics_version	target graphics version (Not supported yet, currently hardcoded to 0)
subsystem_id	subsystem device id

Exceptions that can be thrown by amdsmi_get_gpu_asic_info function:

• AmdSmiLibraryException

• AmdSmiRetryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        for processor in processors:
            asic_info = amdsmi_get_gpu_asic_info(processor)
            print(asic_info['market_name'])
            print(asic_info['vendor_id'])
            print(asic_info['vendor_name'])
            print(asic_info['subvendor_id'])
            print(asic_info['device_id'])
            print(asic_info['subsystem_id'])
            print(asic_info['rev_id'])
            print(asic_info['asic_serial'])
            print(asic_info['oam_id'])
            print(asic_info['num_of_compute_units'])
            print(asic_info['target_graphics_version'])
except AmdSmiException as e:
    print(e)

amdsmi_get_pcie_info

Description: Returns static and metric information about PCIe link for the given GPU

Input parameters:

• processor_handle GPU device which to query

Output: Dictionary with fields

Field	Content
pcie_static	Subfield Description max_pcie_width Maximum number of PCIe lanes max_pcie_speed Maximum PCIe speed pcie_interface_version PCIe interface version slot_type Card form factor from AmdSmiCardFormFactor enum max_pcie_interface_version Maximum PCIe link generation
pcie_metric	Subfield Description pcie_speed Current PCIe speed in MT/s pcie_width Current number of PCIe lanes pcie_bandwidth Current PCIe bandwidth in Mb/s pcie_replay_count Total number of the replays issued on the PCIe link pcie_l0_to_recovery_count Total number of times the PCIe link transitioned from L0 to the recovery state pcie_replay_roll_over_count Total number of replay rollovers issued on the PCIe link pcie_nak_sent_count Total number of NAKs issued on the PCIe link by the device pcie_nak_received_count Total number of NAKs issued on the PCIe link by the receiver pcie_lc_perf_other_end_recovery_count PCIe other end recovery counter

Exceptions that can be thrown by amdsmi_get_pcie_info function:

• AmdSmiLibraryException

• AmdSmiRetryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        for processor in processors:
            pcie_info = amdsmi_get_pcie_info(processor)
            print(pcie_info['pcie_static']['max_pcie_width'])
            print(pcie_info['pcie_static']['max_pcie_speed'])
            print(pcie_info['pcie_static']['slot_type'])
            print(pcie_info['pcie_static']['max_pcie_interface_version'])
            print(pcie_info['pcie_metric']['pcie_speed'])
            print(pcie_info['pcie_metric']['pcie_width'])
            print(pcie_info['pcie_metric']['pcie_bandwidth'])
            print(pcie_info['pcie_metric']['pcie_interface_version'])
            print(pcie_info['pcie_metric']['pcie_replay_count'])
            print(pcie_info['pcie_metric']['pcie_l0_to_recovery_count'])
            print(pcie_info['pcie_metric']['pcie_replay_roll_over_count'])
            print(pcie_info['pcie_metric']['pcie_nak_sent_count'])
            print(pcie_info['pcie_metric']['pcie_nak_received_count'])
            print(pcie_info['pcie_metric']['pcie_lc_perf_other_end_recovery_count'])

except AmdSmiException as e:
    print(e)

amdsmi_get_power_cap_info

Description: Returns dictionary of power capabilities as currently configured on the given GPU

Input parameters:

• processor_handle GPU device which to query

• sensor_ind sensor index. Normally, this will be 0. If a processor has more than one sensor, it could be greater than 0. Parameter sensor_ind is unused on @platform{host}. It is an optional parameter and is set to 0 by default.

Output: Dictionary with fields

Field	Description
power_cap	power capability
default_power_cap	default power capability
dpm_cap	dynamic power management capability
min_power_cap	minimum power capability
max_power_cap	maximum power capability

Exceptions that can be thrown by amdsmi_get_power_cap_info function:

• AmdSmiLibraryException

• AmdSmiRetryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        for processor in processors:
            power_info = amdsmi_get_power_cap_info(processor)
            print(power_info['power_cap'])
            print(power_info['default_power_cap'])
            print(power_info['dpm_cap'])
            print(power_info['min_power_cap'])
            print(power_info['max_power_cap'])
except AmdSmiException as e:
    print(e)

amdsmi_get_fb_layout

Description: Returns framebuffer related information for the given GPU

Input parameters:

• processor handle PF of a GPU device for which to query

Output: Dictionary with field

Field	Description
total_fb_size	total framebuffer size in MB
pf_fb_reserved	framebuffer reserved space in MB
pf_fb_offset	framebuffer offset in MB
fb_alignment	framebuffer alignment in MB
max_vf_fb_usable	maximum usable framebuffer size in MB
min_vf_fb_usable	minimum usable framebuffer size in MB

Exceptions that can be thrown by amdsmi_get_fb_layout function:

• AmdSmiLibraryException

• AmdSmiRetryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        for processor in processors:
            fb_info = amdsmi_get_fb_layout(processor)
            print(fb_info['total_fb_size'])
            print(fb_info['pf_fb_reserved'])
            print(fb_info['pf_fb_offset'])
            print(fb_info['fb_alignment'])
            print(fb_info['max_vf_fb_usable'])
            print(fb_info['min_vf_fb_usable'])
except AmdSmiException as e:
    print(e)

amdsmi_get_gpu_activity

Description: Returns the engine usage for the given GPU.

Input parameters:

• processor_handle GPU device which to query

Output: Dictionary with fields

Field	Description
gfx_activity	graphics engine usage/activity percentage (0 - 100)
umc_activity	memory/UMC engine usage/activity percentage (0 - 100)
mm_activity	average multimedia engine usages/activities in percentage (0 - 100)

Exceptions that can be thrown by amdsmi_get_gpu_activity function:

• AmdSmiLibraryException

• AmdSmiRetryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        for processor in processors:
            engine_activity = amdsmi_get_gpu_activity(processor)
            print(engine_activity['gfx_activity'])
            print(engine_activity['umc_activity'])
            print(engine_activity['mm_activity'])
except AmdSmiException as e:
    print(e)

amdsmi_get_power_info

Description: Returns the current power, power limit, and voltage for the given GPU

Input parameters:

• processor_handle GPU device which to query

Output: Dictionary with fields

Field	Description
Note: socket_power can rarely spike above the socket power limit in some cases
socket_power	socket power
gfx_voltage	gfx voltage
soc_voltage	socket voltage
mem_voltage	memory voltage

Exceptions that can be thrown by amdsmi_get_power_info function:

• AmdSmiLibraryException

• AmdSmiRetryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        for processor in processors:
            power_info = amdsmi_get_power_info(processor)
            print(power_info['socket_power'])
            print(power_info['gfx_voltage'])
            print(power_info['soc_voltage'])
            print(power_info['mem_voltage'])
except AmdSmiException as e:
    print(e)

amdsmi_set_power_cap

Description: Sets GPU power cap.

Input parameters:

• processor handle processor handle

• sensor_ind sensor index. Normally, this will be 0. If a processor has more than one sensor, it could be greater than 0. Parameter sensor_ind is unused on @platform{host}.

• cap value representing power cap to set. The value must be between the minimum (min_power_cap) and maximum (max_power_cap) power cap values, which can be obtained from ::amdsmi_power_cap_info_t.

Output:

• None

Exceptions that can be thrown by amdsmi_set_power_cap function:

• AmdSmiLibraryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        sensor_ind = 0
        for processor in processors:
            power_info = amdsmi_get_power_cap_info(processor)
            power_limit = random.randint(power_info['min_power_cap'], power_info['max_power_cap'])
            amdsmi_set_power_cap(processor, sensor_ind, power_limit)

except AmdSmiException as e:
    print(e)

amdsmi_is_gpu_power_management_enabled

Description: Returns is power management enabled

Input parameters:

• processor_handle GPU device which to query

Output: Bool true if power management enabled else false

Exceptions that can be thrown by amdsmi_is_gpu_power_management_enabled function:

• AmdSmiLibraryException

• AmdSmiRetryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        for processor in processors:
            is_power_management_enabled = amdsmi_is_gpu_power_management_enabled(processor)
            print(is_power_management_enabled)
except AmdSmiException as e:
    print(e)

amdsmi_get_temp_metric

Description: Returns the current temperature or limit temperature for the given processor

Input parameters:

• processor_handle GPU device which to query

• thermal_domain one of AmdSmiTemperatureType enum values:

Field	Description
EDGE	edge thermal domain
HOTSPOT	hotspot/junction thermal domain
VRAM	memory/vram thermal domain
PLX	plx thermal domain (Not supported yet)
HBM_0	HBM 0 thermal domain (Not supported yet)
HBM_1	HBM 1 thermal domain (Not supported yet)
HBM_2	HBM 2 thermal domain (Not supported yet)
HBM_3	HBM 3 thermal domain (Not supported yet)

• thermal_metric one of AmdSmiTemperatureMetric enum values:

Field	Description
CURRENT	current thermal metric
MAX	max thermal metric (Not supported yet)
MIN	min thermal metric (Not supported yet)
MAX_HYST	max hyst thermal metric (Not supported yet)
MIN_HYST	min hyst thermal metric (Not supported yet)
CRITICAL	limit thermal metric
CRITICAL_HYST	critical hyst metric (Not supported yet)
EMERGENCY	emergency thermal metric (Not supported yet)
EMERGENCY_HYST	emergency hyst thermal metric (Not supported yet)
CRIT_MIN	critical min thermal metric (Not supported yet)
CRIT_MIN_HYST	critical min hyst thermal metric (Not supported yet)
OFFSET	offset thermal metric (Not supported yet)
LOWEST	lowest thermal metric (Not supported yet)
HIGHEST	highest thermal metric (Not supported yet)
SHUTDOWN	shutdown thermal metric

Output: Temperature value

Exceptions that can be thrown by amdsmi_get_temp_metric function:

• AmdSmiLibraryException

• AmdSmiRetryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        for device in processors:
            print("=============== EDGE THERMAL DOMAIN ================")
            thermal_measure = amdsmi_get_temp_metric(device, AmdSmiTemperatureType.EDGE, AmdSmiTemperatureMetric.CURRENT)
            print("Current temperature:")
            print(thermal_measure)
            thermal_measure = amdsmi_get_temp_metric(device, AmdSmiTemperatureType.EDGE, AmdSmiTemperatureMetric.CRITICAL)
            print("Limit temperature:")
            print(thermal_measure)
            print("=============== HOTSPOT THERMAL DOMAIN ================")
            thermal_measure = amdsmi_get_temp_metric(device, AmdSmiTemperatureType.HOTSPOT, AmdSmiTemperatureMetric.CURRENT)
            print("Current temperature:")
            print(thermal_measure)
            thermal_measure = amdsmi_get_temp_metric(device, AmdSmiTemperatureType.HOTSPOT, AmdSmiTemperatureMetric.CRITICAL)
            print("Limit temperature:")
            print(thermal_measure)
except AmdSmiException as e:
    print(e)

amdsmi_get_gpu_cache_info

Description: Returns the cache info for the given processor

Input parameters:

• processor_handle GPU device which to query

Output: Dictionary with fields

Field	Description
cache	Subfield Description cache_properties array of AmdSmiCacheProperty cache_size cache size cache_level cache level max_num_cu_shared number of Compute Units shared num_cache_instance number of instance of this cache type

AmdSmiCacheProperty enum values

Field	Description
ENABLED	Cache enabled
DATA_CACHE	Data cache
INST_CACHE	Inst cache
CPU_CACHE	CPU cache
SIMD_CACHE	SIMD cache

Exceptions that can be thrown by amdsmi_get_gpu_cache_info function:

• AmdSmiLibraryException

• AmdSmiRetryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        for device in processors:
            cache_info = amdsmi_get_gpu_cache_info(device)
            for cache in cache_info["cache"]:
                print(cache["cache_properties"])
                print(cache["cache_size"])
                print(cache["cache_level"])
                print(cache["max_num_cu_shared"])
                print(cache["num_cache_instance"])
except AmdSmiException as e:
    print(e)

amdsmi_get_clock_info

Description: Returns the clock measurements for the given GPU

Input parameters:

• processor_handle GPU device which to query

• clock_domain one of AmdSmiClkType enum values:

Field	Description
SYS	system clock domain
GFX	gfx clock domain
DF	Data Fabric clock (for ASICs running on a separate clock) domain (Not supported yet)
DCEF	Display Controller Engine clock domain (Not supported yet)
SOC	SOC clock domain (Not supported yet)
MEM	memory clock domain
PCIE	PCIe clock domain (Not supported yet)
VCLK0	first multimedia engine (VCLK0) clock domain
VCLK1	second multimedia engine (VCLK1) clock domain
DCLK0	DCLK0 clock domain
DCLK1	DCLK1 clock domain

Output: Dictionary with fields

Field	Description
clk	current clock value for the given domain
min_clk	minimum clock value for the given domain
max_clk	maximum clock value for the given domain
clk_locked	clock locked flag only supported on GFX clock domain
clk_deep_sleep	clock deep sleep mode flag

Exceptions that can be thrown by amdsmi_get_clock_info function:

• AmdSmiLibraryException

• AmdSmiRetryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        for processor in processors:
            print("=============== GFX CLOCK DOMAIN ================")
            clock_measure = amdsmi_get_clock_info(processor, AmdSmiClkType.GFX)
            print(clock_measure['clk'])
            print(clock_measure['min_clk'])
            print(clock_measure['max_clk'])
            print(clock_measure['clk_locked'])
            print(clock_measure['clk_deep_sleep'])
            print("=============== MEM CLOCK DOMAIN ================")
            clock_measure = amdsmi_get_clock_info(processor, AmdSmiClkType.MEM)
            print(clock_measure['clk'])
            print(clock_measure['min_clk'])
            print(clock_measure['max_clk'])
            print(clock_measure['clk_deep_sleep'])
            print("=============== SYS CLOCK DOMAIN ================")
            clock_measure = amdsmi_get_clock_info(processor, AmdSmiClkType.SYS)
            print(clock_measure['clk'])
            print(clock_measure['min_clk'])
            print(clock_measure['max_clk'])
            print(clock_measure['clk_deep_sleep'])
            print("=============== VCLK0 CLOCK DOMAIN ================")
            clock_measure = amdsmi_get_clock_info(processor, AmdSmiClkType.VCLK0)
            print(clock_measure['clk'])
            print(clock_measure['min_clk'])
            print(clock_measure['max_clk'])
            print(clock_measure['clk_deep_sleep'])
            print("=============== VCLK1 CLOCK DOMAIN ================")
            clock_measure = amdsmi_get_clock_info(processor, AmdSmiClkType.VCLK1)
            print(clock_measure['clk'])
            print(clock_measure['min_clk'])
            print(clock_measure['max_clk'])
            print(clock_measure['clk_deep_sleep'])
            print("=============== DCLK0 CLOCK DOMAIN ================")
            clock_measure = amdsmi_get_clock_info(processor, AmdSmiClkType.DCLK0)
            print(clock_measure['clk'])
            print(clock_measure['min_clk'])
            print(clock_measure['max_clk'])
            print(clock_measure['clk_deep_sleep'])
            print("=============== DCLK1 CLOCK DOMAIN ================")
            clock_measure = amdsmi_get_clock_info(processor, AmdSmiClkType.DCLK1)
            print(clock_measure['clk'])
            print(clock_measure['min_clk'])
            print(clock_measure['max_clk'])
            print(clock_measure['clk_deep_sleep'])
except AmdSmiException as e:
    print(e)

amdsmi_get_gpu_vram_info

Description: Returns the static information for the VRAM info

Input parameters:

• processor_handle GPU device which to query

Output: Dictionary with fields

Field	Description
vram_type	VRAM type from AmdSmiVramType enum
vram_vendor	VRAM vendor from AmdSmiVranVendor enum
vram_size	VRAM size in MB
vram_bit_width	VRAM bit width

AmdSmiVramType enum:

Field	Description
UNKNOWN	UNKNOWN VRAM type
HBM	HBM VRAM type
HBM2	HBM2 VRAM type
HBM2E	HBM2E VRAM type
HBM3	HBM3 VRAM type
HBM3E	HBM3E VRAM type
DDR2	DDR2 VRAM type
DDR3	DDR3 VRAM type
DDR4	DDR4 VRAM type
GDDR1	GDDR1 VRAM type
GDDR2	GDDR2 VRAM type
GDDR3	GDDR3 VRAM type
GDDR4	GDDR4 VRAM type
GDDR5	GDDR5 VRAM type
GDDR6	GDDR6 VRAM type
GDDR7	GDDR7 VRAM type

AmdSmiVramVendor enum:

Field	Description
SAMSUNG	SAMSUNG VRAM vendor
INFINEON	INFINEON VRAM vendor
ELPIDA	ELPIDA VRAM vendor
ETRON	ETRON VRAM vendor
NANYA	NANYA VRAM vendor
HYNIX	HYNIX VRAM vendor
MOSEL	MOSEL VRAM vendor
WINBOND	WINBOND VRAM vendor
ESMT	ESMT VRAM vendor
MICRON	MICRON VRAM vendor
UNKNOWN	UNKNOWN VRAM vendor

Exceptions that can be thrown by amdsmi_get_gpu_vram_info function:

• AmdSmiLibraryException

• AmdSmiRetryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        for processor in processors:
            vram_info = amdsmi_get_gpu_vram_info(processor)
            print(vram_info['vram_type'])
            print(vram_info['vram_vendor'])
            print(vram_info['vram_size'])
except AmdSmiException as e:
    print(e)

amdsmi_get_gpu_vbios_info

Description: Returns the static information for the VBIOS on the GPU device.

Input parameters:

• processor_handle GPU device which to query

Output: Dictionary with fields

Field	Description
name	vbios name
build_date	vbios build date
part_number	vbios part number
version	vbios version string
boot_firmware	boot firmware info

Exceptions that can be thrown by amdsmi_get_gpu_vbios_info function:

• AmdSmiLibraryException

• AmdSmiRetryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        for processor in processors:
            vbios_info = amdsmi_get_gpu_vbios_info(processor)
            print(vbios_info['name'])
            print(vbios_info['build_date'])
            print(vbios_info['part_number'])
            print(vbios_info['version'])
            print(vbios_info['boot_firmware'])
except AmdSmiException as e:
    print(e)

amdsmi_get_fw_info

Description: Returns the firmware information for the given GPU.

Input parameters:

• processor_handle GPU device which to query

Output: Dictionary with fields

Field	Description
fw_info_list	List of dictionaries that contain information about a certain firmware block

Exceptions that can be thrown by amdsmi_get_fw_info function:

• AmdSmiLibraryException

• AmdSmiRetryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        for processor in processors:
            firmware_list = amdsmi_get_fw_info(processor)
            for firmware_block in firmware_list:
                print(firmware_block['fw_id'])
                print(firmware_block['fw_version'])
except AmdSmiException as e:
    print(e)

amdsmi_get_gpu_board_info

Description: Returns board related information for the given GPU

Input parameters:

• GPU device handle object

Output: Dictionary with fields

Field	Description
model_number	board model number
product_serial	board product serial number
fru_id	fru (field-replaceable unit) id
product_name	board product name
manufacturer_name	board manufacturer name

Exceptions that can be thrown by amdsmi_get_gpu_board_info function:

• AmdSmiLibraryException

• AmdSmiRetryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        for processor in processors:
            board_info = amdsmi_get_gpu_board_info(processor)
            print(board_info['model_number'])
            print(board_info['product_serial'])
            print(board_info['fru_id'])
            print(board_info['manufacturer_name'])
            print(board_info['product_name'])
except AmdSmiException as e:
    print(e)

amdsmi_get_num_vf

Description: Returns number of enabled VFs and number of supported VFs for the given GPU

Input parameters:

• processor handle PF of a GPU device for which to query

Output: Dictionary with fields

Field	Description
num_vf_enabled	number of enabled VFs
num_vf_supported	number of supported VFs

Exceptions that can be thrown by amdsmi_get_num_vf function:

• AmdSmiLibraryException

• AmdSmiRetryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        for processor in processors:
            num_vf = amdsmi_get_num_vf(processor)
            print(num_vf['num_vf_enabled'])
            print(num_vf['num_vf_supported'])
except AmdSmiException as e:
    print(e)

amdsmi_get_vf_partition_info

Description: Returns array of the current framebuffer partitioning structures on the given GPU

Input parameters:

• processor handle object PF of a GPU device for which to query

Output: Array of dictionary with fields

Field	Description
vf_id	VF handle
fb	Subfield Description fb_size framebuffer size fb_offset framebuffer offset

Exceptions that can be thrown by amdsmi_get_vf_partition_info function:

• AmdSmiLibraryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        for processor in processors:
            partitions = amdsmi_get_vf_partition_info(processor)
            print(partitions[0]['fb']['fb_size'])
            # partitions[0]['fb']['fb_size'] is frame buffer size of the first VF on the given GPU
            # we can access any VF from the array via its index in partitions list
except AmdSmiException as e:
    print(e)

amdsmi_set_num_vf

Description: Set number of enabled VFs for the given GPU

Input parameters:

• processor_handle GPU device which to query

• number of enabled VFs to be set

Output: None

Exceptions that can be thrown by amdsmi_set_num_vf function:

• AmdSmiLibraryException

• AmdSmiRetryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        for processor in processors:
            amdsmi_set_num_vf(processor,2)
except AmdSmiException as e:
    print(e)

amdsmi_clear_vf_fb

Description: Clears framebuffer of the given VF on the given GPU.

If trying to clear the framebuffer of an active function, the call will fail

Input parameters:

• VF device handle

Output: None

Exceptions that can be thrown by amdsmi_clear_vf_fb function:

• AmdSmiLibraryException

• AmdSmiRetryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        for device in devices:
            partitions = amdsmi_get_vf_partition_info(device)
            amdsmi_clear_vf_fb(partitions[0]['vf_id'])
            # partitions[0]['vf_id'] is handle of the first VF on the given GPU

except AmdSmiException as e:
    print(e)

amdsmi_get_vf_data

Description: Returns the scheduler information and guard structure for the given VF.

Input parameters:

• VF handle

Output: Dictionary with fields

Field	Description
flr_count	function level reset counter
boot_up_time	boot up time in microseconds
shutdown_time	shutdown time in microseconds
reset_time	reset time in microseconds
state	vf state
last_boot_start	last boot start time
last_boot_end	last boot end time
last_shutdown_start	last shutdown start time
last_shutdown_end	last shutdown end time
last_reset_start	last reset start time
last_reset_end	last reset end time
current_active_time	current session active time, reset after guest reload
current_running_time	current session running time, reset after guest reload
total_active_time	total active time, reset after host reload
total_running_time	total running time, reset after host reload
enabled	show if guard info is enabled for VF
guard (dictionary of elements)	Subfield Description state vf guard state amount amount of monitor events after enabled interval interval in seconds (sliding window) in which events are counted threshold maximum number of events that will be processed in the given sliding window interval. Additional events during the interval will be ignored. active current number of events in the interval

AmdSmiGuardType enum values are keys in guard dictionary

Field	Description
FLR	function level reset status
EXCLUSIVE_MOD	exclusive access mode status
EXCLUSIVE_TIMEOUT	exclusive access time out status
ALL_INT	generic interrupt status

State is AmdSmiGuardState enum object with values

Field	Description
NORMAL	the event number is within the threshold
FULL	the event number hits the threshold
OVERFLOW	the event number is bigger than the threshold

State is AmdSmiVfState enum object with values

Field	Description
UNAVAILABLE	vf state unavailable
AVAILABLE	vf state available
ACTIVE	vf state active
SUSPENDED	vf state suspended
FULLACCESS	vf state fullaccess
DEFAULT_AVAILABLE	same as available, indicates this is a default VF

Exceptions that can be thrown by amdsmi_get_vf_data function:

• AmdSmiLibraryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        for processor in processors:
            partitions = amdsmi_get_vf_partition_info(processor)
            vf_data = amdsmi_get_vf_data(partitions[0]['vf_id'])
            sched_info = vf_data['sched']
            guard_info = vf_data['guard']
            print(sched_info['boot_up_time'])
            print(sched_info['flr_count'])
            print(sched_info['state'].name)
            print(sched_info['last_boot_start'])
            print(sched_info['last_boot_end'])
            print(sched_info['last_shutdown_start'])
            print(sched_info['last_shutdown_end'])
            print(sched_info['shutdown_time'])
            print(sched_info['last_reset_start'])
            print(sched_info['last_reset_end'])
            print(sched_info['reset_time'])
            print(sched_info['current_active_time'])
            print(sched_info['current_running_time'])
            print(sched_info['total_active_time'])
            print(sched_info['total_running_time'])

            print(guard_info['enabled'])
            for guard_type in guard_info['guard']:
                print("type: {} ".format(guard_type))
                print("state: {}".format(guard_info['guard'][guard_type]['state']))
                print("amount: {}".format(guard_info['guard'][guard_type]['amount']))
                print("interval: {}".format(guard_info['guard'][guard_type]['interval']))
                print("threshold: {}".format(guard_info['guard'][guard_type]['threshold']))
                print("active: {}".format(guard_info['guard'][guard_type]['active']))
                print("==================")
except AmdSmiException as e:
    print(e)

amdsmi_get_vf_info

Description: Returns the configuration structure for a given VF

Input parameters:

• VF handle

Output: Dictionary with fields

Field	Description
fb	Subfield Description fb_offset framebuffer offset fb_size framebuffer size
gfx_timeslice	gfx timeslice in us

Exceptions that can be thrown by amdsmi_get_vf_info function:

• AmdSmiLibraryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        for processor in processors:
            partitions = amdsmi_get_vf_partition_info(processor)
            # partitions[0]['vf_id'] is handle of the first VF on the given GPU
            config = amdsmi_get_vf_info(partitions[0]['vf_id'])
            print("fb_offset: {}".format(config['fb']['fb_offset']))
            print("fb_size: {}".format(config['fb']['fb_size']))

            print("gfx_timeslice : {}".format(config['gfx_timeslice']))
except AmdSmiException as e:
    print(e)

amdsmi_get_guest_data

Description: Gets guest OS information of the queried VF

Input parameters:

• processor handle VF of a GPU device

Output: Dictionary with fields

Field	Description
driver_version	driver version
fb_usage	fb usage in MB

Exceptions that can be thrown by amdsmi_get_guest_data function:

• AmdSmiLibraryException

• AmdSmiRetryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        for processor in processors:
            num_vf_enabled = amdsmi_get_num_vf(processor)['num_vf_enabled']
            partitions = amdsmi_get_vf_partition_info(processor)
            for i in range(0, num_vf_enabled):
                guest_data = amdsmi_get_guest_data(partitions[i]['vf_id'])
                print(guest_data)

except AmdSmiException as e:
    print(e)

amdsmi_get_fw_error_records

Description: Gets firmware error records

Input parameters:

• processor handle PF of a GPU device

Output: Dictionary with field err_records, which is list of elements

Field	Description
timestamp	system time in seconds
vf_idx	vf index
fw_id	firmware id
status	firmware load status

Exceptions that can be thrown by amdsmi_get_fw_error_records function:

• AmdSmiLibraryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        for processor in processors:
            err_records = amdsmi_get_fw_error_records(processor)
            print(err_records)

except AmdSmiException as e:
    print(e)

amdsmi_get_dfc_fw_table

Description: Gets dfc firmware table

Input parameters:

• processor handle PF of a GPU device

Output: Dictionary with field header, and data which is a list of elements

Each header is a dictionary with following fields:

Field	Description
dfc_fw_version	dfc firmware version
dfc_fw_total_entries	number of entries in the dfc table
dfc_gart_wr_guest_min	gart wr guest min
dfc_gart_wr_guest_max	gart wr guest max

Each data entry is a dictionary with following fields:

Field	Description
dfc_fw_type	dfc firmware type
verification_enabled	verification enabled
customer_ordinal	customer ordinal
white_list	white list
black_list	black list

Each white list entry is a dictionary with following fields:

Field	Description
latest	latest
oldest	oldest

Exceptions that can be thrown by amdsmi_get_dfc_fw_table function:

• AmdSmiLibraryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        for processor in processors:
            dfc_table = amdsmi_get_dfc_fw_table(processor)
            print(dfc_table)

except AmdSmiException as e:
    print(e)

amdsmi_get_vf_fw_info

Description: Returns GPU firmware related information.

Input parameters:

• processor handle VF of a GPU device for which to query

Output: Dictionary with field fw_list, which is list of elements

If microcode of certain type is not loaded, version will be 0.

Field	Description
fw_info_list	Subfield Description fw_id AmdSmiFwBlock enum fw_version fw version which is integer

Exceptions that can be thrown by amdsmi_get_vf_fw_info function:

• AmdSmiLibraryException

• AmdSmiRetryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        for processor in processors:
            partitions = amdsmi_get_vf_partition_info(processor)
            fw_info = amdsmi_get_vf_fw_info(partitions[0]['vf_id'])
            fw_num = len(fw_info['fw_list'])
            for j in range(0, fw_num):
                fw = fw_info['fw_list'][j]
                print(fw['fw_name'].name)
                print(fw['fw_version'])
except AmdSmiException as e:
    print(e)

amdsmi_get_partition_profile_info

Description: Gets partition profile info

Input parameters:

• processor handle PF of a GPU device

Output: Dictionary with fields, current_profile and profiles

Field	Description
current_profile_index	current profile index
profiles	list of all profiles

Where, profiles is a list containing

Field	Description
vf_count	number of vfs
profile_caps (dictionary)	Subfield Description total total available available optimal optimal min_value minimum max_value maximum

Keys for profile_caps dictionary are in AmdSmiProfileCapabilityType enum

Field	Description
MEMORY	memory
ENCODE	encode engine
DECODE	decode engine
COMPUTE	compute engine

Exceptions that can be thrown by amdsmi_get_partition_profile_info function:

• AmdSmiLibraryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        for processor in processors:
            profile_info = amdsmi_get_partition_profile_info(processor)
            print(profile_info)

except AmdSmiException as e:
    print(e)

amdsmi_get_link_metrics

Description: Gets link metric information

Input parameters:

• processor handle PF of a GPU device

Output: links list of dictionaries with fields for each link

Field	Description
bdf	BDF of the given processor
bit_rate	current link speed in Gb/s
max_bandwidth	max bandwidth of the link
link_type	type of the link from AmdSmiLinkType enum
read	total data received for each link in KB
write	total data transferred for each link in KB

AmdSmiLinkType enum:

Field	Description
INTERNAL	Unknown
XGMI	XGMI link type
PCIE	PCIe link type
NOT_APPLICABLE	Link not applicable
UNKNOWN	Unknown

Exceptions that can be thrown by amdsmi_get_link_metrics function:

• AmdSmiLibraryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        for processor in processors:
            link_metrics = amdsmi_get_link_metrics(processor)
            print(link_metrics)

except AmdSmiException as e:
    print(e)

amdsmi_get_link_topology

Description: Gets link topology information between two connected processors

Input parameters:

• source processor handle PF of a source GPU device

• destination processor handle PF of a destination GPU device

Output: Dictionary with fields

Field	Description
weight	link weight between two GPUs
link_status	HW status of the link
link_type	type of the link from AmdSmiLinkType enum
num_hops	number of hops between two GPUs
fb_sharing	framebuffer sharing between two GPUs

AmdSmiLinkType enum:

Field	Description
INTERNAL	Unknown
XGMI	XGMI link type
PCIE	PCIe link type
NOT_APPLICABLE	Link not applicable
UNKNOWN	Unknown

Exceptions that can be thrown by amdsmi_get_link_topology function:

• AmdSmiLibraryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        for src_processor in processors:
            for dst_processor in processors:
                link_topology = amdsmi_get_link_topology(src_processor, dst_processor)
                print(link_topology)

except AmdSmiException as e:
    print(e)

amdsmi_get_link_topology_nearest

Description: Retrieve the set of GPUs that are nearest to a given device at a specific interconnectivity level.

Input parameters:

• processor_handle The identifier of the given device.

• link_type The AmdSmiLinkType level to search for nearest devices

AmdSmiLinkType enum:

Field	Description
INTERNAL	Unknown
XGMI	XGMI link type
PCIE	PCIe link type
NOT_APPLICABLE	Link not applicable
UNKNOWN	Unknown

Output: Dictionary holding the following fields.

• processor_list list of all nearest processor handles found

Exceptions that can be thrown by amdsmi_get_link_topology_nearest function:

• AmdSmiLibraryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        for processor in processors:
            nearest_gpus = amdsmi_get_link_topology_nearest(processor, AmdSmiLinkType.PCIE)
            if (len(nearest_gpus['processor_list'])) == 0:
                print("No nearest GPUs found on machine")
            else:
                print("Nearest GPUs")
                for gpu in nearest_gpus['processor_list']:
                    print(amdsmi_get_gpu_device_uuid(gpu))

except AmdSmiException as e:
    print(e)

amdsmi_get_xgmi_fb_sharing_caps

Description: Gets XGMI capabilities

Input parameters:

• processor handle PF of a GPU device

Output: Dictionary with fields

Field	Description
mode_custom_cap	flag that indicates if custom mode is supported (Not supported yet)
mode_1_cap	flag that indicates if mode_1 is supported
mode_2_cap	flag that indicates if mode_2 is supported
mode_4_cap	flag that indicates if mode_4 is supported
mode_8_cap	flag that indicates if mode_8 is supported

Exceptions that can be thrown by amdsmi_get_xgmi_fb_sharing_caps function:

• AmdSmiLibraryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        for processor in processors:
            caps = amdsmi_get_xgmi_fb_sharing_caps(processor)
            print(caps)

except AmdSmiException as e:
    print(e)

amdsmi_get_xgmi_fb_sharing_mode_info

Description: Gets XGMI framebuffer sharing information between two GPUs

Input parameters:

• source processor handle PF of a source GPU device

• destination processor handle PF of a destination GPU device

• mode framebuffer sharing mode from AmdSmiXgmiFbSharingMode enum

AmdSmiXgmiFbSharingMode enum:

Field	Description
CUSTOM	custom framebuffer sharing mode (Not supported yet)
MODE_1	framebuffer sharing mode_1
MODE_2	framebuffer sharing mode_2
MODE_4	framebuffer sharing mode_4
MODE_8	framebuffer sharing mode_8

Output: Value indicating whether framebuffer sharing is enabled between two GPUs

Exceptions that can be thrown by amdsmi_get_xgmi_fb_sharing_mode_info function:

• AmdSmiLibraryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        for src_processor in processors:
            for dst_processor in processors:
                fb_sharing = amdsmi_get_xgmi_fb_sharing_mode_info(src_processor, dst_processor, AmdSmiXgmiFbSharingMode.MODE_4)
                print(fb_sharing)

except AmdSmiException as e:
    print(e)

amdsmi_set_xgmi_fb_sharing_mode

Description: Sets framebuffer sharing mode

Note: This API will only work if there’s no guest VM running.

Input parameters:

• processor handle PF of a GPU device

• mode framebuffer sharing mode from AmdSmiXgmiFbSharingMode enum

AmdSmiXgmiFbSharingMode enum:

Field	Description
CUSTOM	custom framebuffer sharing mode (Not supported yet)
MODE_1	framebuffer sharing mode_1
MODE_2	framebuffer sharing mode_2
MODE_4	framebuffer sharing mode_4
MODE_8	framebuffer sharing mode_8

Output:

• None

Exceptions that can be thrown by amdsmi_set_xgmi_fb_sharing_mode function:

• AmdSmiLibraryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        for processor in processors:
            amdsmi_set_xgmi_fb_sharing_mode(processor, AmdSmiXgmiFbSharingMode.MODE_4)

except AmdSmiException as e:
    print(e)

amdsmi_set_xgmi_fb_sharing_mode_v2

Description: Sets framebuffer sharing mode

Note: This API will only work if there’s no guest VM running. This api can be used for custom and auto setting of xgmi frame buffer sharing. In case of custom mode: - All processors in the list must be on the same NUMA node. Otherwise, api will return error. - If any processor from the list already belongs to an existing group, the existing group will be released automatically. In case of auto mode(MODE_X): - The input parameter processor_list[0] should be valid. Only the first element of processor_list is taken into account and it can be any gpu0,gpu1,…

Input parameters:

• processor_list list of PFs of a GPU devices

• mode framebuffer sharing mode from AmdSmiXgmiFbSharingMode enum

AmdSmiXgmiFbSharingMode enum:

Field	Description
CUSTOM	custom framebuffer sharing mode
MODE_1	framebuffer sharing mode_1
MODE_2	framebuffer sharing mode_2
MODE_4	framebuffer sharing mode_4
MODE_8	framebuffer sharing mode_8

Output:

• None

Exceptions that can be thrown by amdsmi_set_xgmi_fb_sharing_mode_v2 function:

• AmdSmiLibraryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    processors_custom_mode = []
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        if len(processors) > 3:
            processors_custom_mode.append(processors[0])
            processors_custom_mode.append(processors[2])
        else:
            processors_custom_mode = processors
        amdsmi_set_xgmi_fb_sharing_mode_v2(processors_custom_mode, AmdSmiXgmiFbSharingMode.CUSTOM)

except AmdSmiException as e:
    print(e)

amdsmi_get_gpu_metrics

Description: Gets GPU metric information

Input parameters:

• processor handle PF of a GPU device

Output: list of dictionaries with fields for each metric

Field	Description
val	value of the metric
unit	unit of the metric from AmdSmiMetricUnit enum
name	name of the metric from AmdSmiMetricName enum
category	category of the metric from AmdSmiMetricCategory enum
flags	list of types of the metric from AmdSmiMetricType enum
vf_mask	mask of all active VFs + PF that this metric applies to
res_group	resource group from AmdSmiResGroup enum
res_subgroup	resource group from AmdSmiResSubGroup enum
res_instance	resource instance number

AmdSmiMetricUnit enum:

Field	Description
COUNTER	counter
UINT	unsigned integer
BOOL	boolean
MHZ	megahertz
PERCENT	percentage
MILLIVOLT	millivolt
CELSIUS	celsius
WATT	watt
JOULE	joule
GBPS	gigabyte per second
MBITPS	megabit per second
PCIE_GEN	PCIe generation
PCIE_LANES	PCIe lanes
15_625_MILLIJOULE	millijoule
UNKNOWN	unknown unit

AmdSmiMetricName enum:

Field	Description
ACC_COUNTER	accumulated counter
FW_TIMESTAMP	firmware timestamp
CLK_GFX	gfx clock
CLK_SOC	socket clock
CLK_MEM	memory clock
CLK_VCLK	vclk clock
CLK_DCLK	dclk clock
USAGE_GFX	gfx usage
USAGE_MEM	memory usage
USAGE_MM	mm usage
USAGE_VCN	vcn usage
USAGE_JPEG	jpeg usage
VOLT_GFX	gfx voltage
VOLT_SOC	socket voltage
VOLT_MEM	memory voltage
TEMP_HOTSPOT_CURR	current hotspot temperature
TEMP_HOTSPOT_LIMIT	hotspot temperature limit
TEMP_MEM_CURR	current memory temperature
TEMP_MEM_LIMIT	memory temperature limit
TEMP_VR_CURR	current vr temperature
TEMP_SHUTDOWN	shutdown temperature
POWER_CURR	current power
POWER_LIMIT	power limit
ENERGY_SOCKET	socket energy
ENERGY_CCD	ccd energy
ENERGY_XCD	xcd energy
ENERGY_AID	aid energy
ENERGY_MEM	memory energy
THROTTLE_SOCKET_ACTIVE	active socket throttle
THROTTLE_VR_ACTIVE	active vr throttle
THROTTLE_MEM_ACTIVE	active memory throttle
PCIE_BANDWIDTH	pcie bandwidth
PCIE_L0_TO_RECOVERY_COUNT	pcie l0 recovery count
PCIE_REPLAY_COUNT	pcie replay count
PCIE_REPLAY_ROLLOVER_COUNT	pcie replay rollover count
PCIE_NAK_SENT_COUNT	pcie nak sent count
PCIE_NAK_RECEIVED_COUNT	pcie nak received count
CLK_GFX_MAX_LIMIT	maximum gfx clock limit
CLK_SOC_MAX_LIMIT	maximum socket clock limit
CLK_MEM_MAX_LIMIT	maximum memory clock limit
CLK_VCLK_MAX_LIMIT	maximum vclk clock limit
CLK_DCLK_MAX_LIMIT	maximum dclk clock limit
CLK_GFX_MIN_LIMIT	minimum gfx clock limit
CLK_SOC_MIN_LIMIT	minimum socket clock limit
CLK_MEM_MIN_LIMIT	minimum memory clock limit
CLK_VCLK_MIN_LIMIT	minimum vclk clock limit
CLK_DCLK_MIN_LIMIT	minimum dclk clock limit
CLK_GFX_LOCKED	gfx clock locked
CLK_GFX_DS_DISABLED	gfx deep sleep
CLK_MEM_DS_DISABLED	memory deep sleep
CLK_SOC_DS_DISABLED	socket deep sleep
CLK_VCLK_DS_DISABLED	vclk deep sleep
CLK_DCLK_DS_DISABLED	dclk deep sleep
PCIE_LINK_SPEED	pcie link speed
PCIE_LINK_WIDTH	pcie link width
DRAM_BANDWIDTH	dram bandwidth
MAX_DRAM_BANDWIDTH	maximum dram bandwidth
GFX_CLK_BELOW_HOST_LIMIT_PPT	gfx clock below host limit ppt
GFX_CLK_BELOW_HOST_LIMIT_THM	gfx clock below host limit thermal
GFX_CLK_BELOW_HOST_LIMIT_TOTAL	gfx clock below host limit total
GFX_CLK_LOW_UTILIZATION	gfx clock low utilization
INPUT_TELEMETRY_VOLTAGE	input telemetry voltage
PLDM_VERSION	pldm version
TEMP_XCD	xcd temperature
TEMP_AID	aid temperature
TEMP_HBM	hbm temperature
SYS_METRIC_ACC_COUNTER	system metric accumulated counter
SYSTEM_TEMP_UBB_FPGA	system temperature ubb fpga
SYSTEM_TEMP_UBB_FRONT	system temperature ubb front
SYSTEM_TEMP_UBB_BACK	system temperature ubb back
SYSTEM_TEMP_UBB_OAM7	system temperature ubb oam7
SYSTEM_TEMP_UBB_IBC	system temperature ubb ibc
SYSTEM_TEMP_UBB_UFPGA	system temperature ubb ufpga
SYSTEM_TEMP_UBB_OAM1	system temperature ubb oam1
SYSTEM_TEMP_OAM_0_1_HSC	system temperature oam 0 1 hsc
SYSTEM_TEMP_OAM_2_3_HSC	system temperature oam 2 3 hsc
SYSTEM_TEMP_OAM_4_5_HSC	system temperature oam 4 5 hsc
SYSTEM_TEMP_OAM_6_7_HSC	system temperature oam 6 7 hsc
SYSTEM_TEMP_UBB_FPGA_0V72_VR	system temperature ubb fpga 0v72 vr
SYSTEM_TEMP_UBB_FPGA_3V3_VR	system temperature ubb fpga 3v3 vr
SYSTEM_TEMP_RETIMER_0_1_2_3_1V2_VR	system temperature retimer 0 1 2 3 1v2 vr
SYSTEM_TEMP_RETIMER_4_5_6_7_1V2_VR	system temperature retimer 4 5 6 7 1v2 vr
SYSTEM_TEMP_RETIMER_0_1_0V9_VR	system temperature retimer 0 1 0v9 vr
SYSTEM_TEMP_RETIMER_4_5_0V9_VR	system temperature retimer 4 5 0v9 vr
SYSTEM_TEMP_RETIMER_2_3_0V9_VR	system temperature retimer 2 3 0v9 vr
SYSTEM_TEMP_RETIMER_6_7_0V9_VR	system temperature retimer 6 7 0v9 vr
SYSTEM_TEMP_OAM_0_1_2_3_3V3_VR	system temperature oam 0 1 2 3 3v3 vr
SYSTEM_TEMP_OAM_4_5_6_7_3V3_VR	system temperature oam 4 5 6 7 3v3 vr
SYSTEM_TEMP_IBC_HSC	system temperature ibc hsc
SYSTEM_TEMP_IBC	system temperature ibc
NODE_TEMP_RETIMER	node temperature retimer
NODE_TEMP_IBC_TEMP	node temperature ibc temp
NODE_TEMP_IBC_2_TEMP	node temperature ibc 2 temp
NODE_TEMP_VDD18_VR_TEMP	node temperature vdd18 vr temp
NODE_TEMP_04_HBM_B_VR_TEMP	node temperature 04 hbm b vr temp
NODE_TEMP_04_HBM_D_VR_TEMP	node temperature 04 hbm d vr temp
VR_TEMP_VDDCR_VDD0	vr temperature vddcr vdd0
VR_TEMP_VDDCR_VDD1	vr temperature vddcr vdd1
VR_TEMP_VDDCR_VDD2	vr temperature vddcr vdd2
VR_TEMP_VDDCR_VDD3	vr temperature vddcr vdd3
VR_TEMP_VDDCR_SOC_A	vr temperature vddcr soc a
VR_TEMP_VDDCR_SOC_C	vr temperature vddcr soc c
VR_TEMP_VDDCR_SOCIO_A	vr temperature vddcr socio a
VR_TEMP_VDDCR_SOCIO_C	vr temperature vddcr socio c
VR_TEMP_VDD_085_HBM	vr temperature vdd 085 hbm
VR_TEMP_VDDCR_11_HBM_B	vr temperature vddcr 11 hbm b
VR_TEMP_VDDCR_11_HBM_D	vr temperature vddcr 11 hbm d
VR_TEMP_VDD_USR	vr temperature vdd usr
VR_TEMP_VDDIO_11_E32	vr temperature vddio 11 e32
UNKNOWN	unknown name

AmdSmiMetricCategory enum:

Field	Description
ACC_COUNTER	counter
FREQUENCY	frequency
ACTIVITY	activity
TEMPERATURE	temperature
POWER	power
ENERGY	energy
THROTTLE	throttle
PCIE	pcie
STATIC	static
SYS_ACC_COUNTER	system accumulated counter
SYS_BASEBOARD_TEMP	system baseboard temperature
SYS_GPUBOARD_TEMP	system gpu board temperature
UNKNOWN	unknown category

AmdSmiMetricType enum:

Field	Description
COUNTER	counter
CHIPLET	chiplet
INST	instantaneous data
ACC	accumulated data

AmdSmiMetricResGroup enum:

Field	Description
NA	resource group is not applicable
GPU	gpu resource group
XCP	xcp resource group
AID	aid resource group
MID	mid resource group
SYSTEM	system resource group
UNKNOWN	unknown resource group

AmdSmiMetricResSubgroup enum:

Field	Description
NA	resource subgroup is not applicable
XCC	xcc resource subgroup
ENGINE	engine resource subgroup
HBM	hbm resource subgroup
BASEBOARD	baseboard resource subgroup
GPUBOARD	gpuboard resource subgroup
UNKNOWN	unknown resource subgroup

Exceptions that can be thrown by amdsmi_get_gpu_metrics function:

• AmdSmiLibraryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        for processor in processors:
            metrics = amdsmi_get_gpu_metrics(processor)
            print(metrics)

except AmdSmiException as e:
    print(e)

amdsmi_get_soc_pstate

Description: Gets the soc pstate policy for the processor

Input parameters:

• processor handle PF of a GPU device

Output: Dictionary with fields

Field	Description
cur	current policy index
policies	List of policies

Each policies list entry is a dictionary with following fields:

Field	Description
policy_id	policy id
policy_description	policy description

Exceptions that can be thrown by amdsmi_get_soc_pstate function:

• AmdSmiLibraryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        for processor in processors:
            dpm_policy = amdsmi_get_soc_pstate(processor)
            print(dpm_policy)

except AmdSmiException as e:
    print(e)

amdsmi_set_soc_pstate

Description: Sets the soc pstate policy for the processor

Input parameters:

• processor handle PF of a GPU device

• policy_id policy id represents one of the values we get from the policies list from amdsmi_get_soc_pstate.

Output:

• None

Exceptions that can be thrown by amdsmi_set_soc_pstate function:

• AmdSmiLibraryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        for processor in processors:
            amdsmi_set_soc_pstate(processor, 0)

except AmdSmiException as e:
    print(e)

amdsmi_get_xgmi_plpd

Description: Gets the xgmi per-link power down policy parameter for the processor

Input parameters:

• processor handle PF of a GPU device

Output: Dictionary with fields

Field	Description
cur	current policy index
policies	List of policies

Each policies list entry is a dictionary with following fields:

Field	Description
policy_id	policy id
policy_description	policy description

Exceptions that can be thrown by amdsmi_get_xgmi_plpd function:

• AmdSmiLibraryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        for processor in processors:
            dpm_policy = amdsmi_get_xgmi_plpd(processor)
            print(dpm_policy)

except AmdSmiException as e:
    print(e)

amdsmi_set_xgmi_plpd

Description: Sets the xgmi per-link power down policy parameter for the processor

Input parameters:

• processor handle PF of a GPU device

• policy_id policy id represents one of the values we get from the policies list from amdsmi_get_soc_pstate.

Output:

• None

Exceptions that can be thrown by amdsmi_set_xgmi_plpd function:

• AmdSmiLibraryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        for processor in processors:
            amdsmi_set_xgmi_plpd(processor, 0)

except AmdSmiException as e:
    print(e)

AmdSmiEventReader class

Description: Providing methods for event monitoring

Methods:

constructor

Description: Allocates a new event reader notifier to monitor different types of issues with the GPU

Input parameters:

• processor handle list list of GPU device handle objects(PFs od Vfs) for which to create event reader

• event category list list of the different event categories that the event reader will monitor in GPU

Event category is AmdSmiEventCategory enum object with values

Category	Description
NOT_USED	not used category
DRIVER	driver events(allocation, failures of APIs, debug errors)
RESET	events/notifications regarding RESET executed by the GPU
SCHED	scheduling events(world switch fail …)
VBIOS	VBIOS events(security failures, vbios corruption…)
ECC	ecc events
PP	pp events(slave not present, dpm fail …)
IOV	events regarding the configuration of VF resources
VF	vf events(no vbios, gpu reset fail…)
FW	events related with FW loading or FW operations
GPU	gpu fatal conditions
GUARD	guard events
GPUMON	gpumon events(fb issues …)
MMSCH	mmsch events
XGMI	xgmi events
ALL	monitor all categories

• severity of events that can be monitored

Severity is AmdSmiEventSeverity enum object with values

Severity	Description
HIGH	critical error
MED	significant error
LOW	trivial error
WARN	warning
INFO	info
ALL	monitor all severity levels

severity parameter is optional. If nothing is set, events with LOW severity will be monitored by default.

Output:

• created object of AmdSmiEventReader class

Exceptions that can be thrown by AmdSmiEventReader constructor function:

• AmdSmiParameterException

• AmdSmiLibraryException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        event_reader = AmdSmiEventReader(processors,{AmdSmiEventCategory.RESET})
except SmiException as e:
    print(e)

read

Description: Reads and return one event from event reader

Input parameters:

• timestamp number of microseconds to wait for an event to occur. If event does not happen monitoring is finished

Output: Dictionary with fields

Field	Description
fcn_id	VF handle
dev_id	GPU device id
timestamp	UTC time (in microseconds) when the error happened
data	data value associated with the specific event
category	event category
subcode	event subcategory
level	event severity
date	UTC date and time when the error happend
message	message describing the event
processor_handle	processor handle object where the event happened

event category is AmdSmiEventCategory enum object with values

Category	Description
NOT_USED	not used category
DRIVER	driver events(allocation, failures of APIs, debug errors)
RESET	events/notifications regarding RESET executed by the GPU
SCHED	scheduling events(world switch fail …)
VBIOS	VBIOS events(security failures, vbios corruption…)
ECC	ecc events
PP	pp events(slave not present, dpm fail …)
IOV	events regarding the configuration of VF resources
VF	vf events(no vbios, gpu reset fail…)
FW	events related with FW loading or FW operations
GPU	gpu fatal conditions
GUARD	guard events
GPUMON	gpumon events(fb issues …)
MMSCH	mmsch events
XGMI	xgmi events
ALL	monitor all categories

every AmdSmiEventCategory has its corresponding enum subcategory,
subcategories are:

Subcategory	Field
AmdSmiEventCategoryGpu	GPU_DEVICE_LOST GPU_NOT_SUPPORTED GPU_RMA GPU_NOT_INITIALIZED GPU_MMSCH_ABNORMAL_STATE GPU_RLCV_ABNORMAL_STATE GPU_SDMA_ENGINE_BUSY GPU_RLC_ENGINE_BUSY GPU_GC_ENGINE_BUSY
AmdSmiEventCategoryDriver	DRIVER_SPIN_LOCK_BUSY DRIVER_ALLOC_SYSTEM_MEM_FAIL DRIVER_CREATE_GFX_WORKQUEUE_FAIL DRIVER_CREATE_MM_WORKQUEUE_FAIL DRIVER_BUFFER_OVERFLOW DRIVER_DEV_INIT_FAIL DRIVER_CREATE_THREAD_FAIL DRIVER_NO_ACCESS_PCI_REGION DRIVER_MMIO_FAIL DRIVER_INTERRUPT_INIT_FAIL DRIVER_INVALID_VALUE DRIVER_CREATE_MUTEX_FAIL DRIVER_CREATE_TIMER_FAIL DRIVER_CREATE_EVENT_FAIL DRIVER_CREATE_SPIN_LOCK_FAIL DRIVER_ALLOC_FB_MEM_FAIL DRIVER_ALLOC_DMA_MEM_FAIL DRIVER_NO_FB_MANAGER DRIVER_HW_INIT_FAIL DRIVER_SW_INIT_FAIL DRIVER_INIT_CONFIG_ERROR DRIVER_ERROR_LOGGING_FAILED DRIVER_CREATE_RWLOCK_FAIL DRIVER_CREATE_RWSEMA_FAIL DRIVER_GET_READ_LOCK_FAIL DRIVER_GET_WRITE_LOCK_FAIL DRIVER_GET_READ_SEMA_FAIL DRIVER_GET_WRITE_SEMA_FAIL DRIVER_DIAG_DATA_INIT_FAIL DRIVER_DIAG_DATA_MEM_REQ_FAIL DRIVER_DIAG_DATA_VADDR_REQ_FAIL DRIVER_DIAG_DATA_BUS_ADDR_REQ_FAIL DRIVER_HRTIMER_START_FAIL DRIVER_CREATE_DRIVER_FILE_FAIL DRIVER_CREATE_DEVICE_FILE_FAIL DRIVER_CREATE_DEBUGFS_FILE_FAIL DRIVER_CREATE_DEBUGFS_DIR_FAIL DRIVER_PCI_ENABLE_DEVICE_FAIL DRIVER_FB_MAP_FAIL DRIVER_DOORBELL_MAP_FAIL DRIVER_CREATE_DEBUGFS_FILE_FAIL DRIVER_PCI_REGISTER_DRIVER_FAIL DRIVER_ALLOC_IOVA_ALIGN_FAIL DRIVER_ROM_MAP_FAIL DRIVER_FULL_ACCESS_TIMEOUT
AmdSmiEventCategoryFw	FW_CMD_ALLOC_BUF_FAIL FW_CMD_BUF_PREP_FAIL FW_RING_INIT_FAIL FW_FW_APPLY_SECURITY_POLICY_FAIL FW_START_RING_FAIL FW_FW_LOAD_FAIL FW_EXIT_FAIL FW_INIT_FAIL FW_CMD_SUBMIT_FAIL FW_CMD_FENCE_WAIT_FAIL FW_TMR_LOAD_FAIL FW_TOC_LOAD_FAIL FW_RAS_LOAD_FAIL FW_RAS_UNLOAD_FAIL FW_RAS_TA_INVOKE_FAIL FW_RAS_TA_ERR_INJECT_FAIL FW_ASD_LOAD_FAIL FW_ASD_UNLOAD_FAIL FW_AUTOLOAD_FAIL FW_VFGATE_FAIL FW_XGMI_LOAD_FAIL FW_XGMI_UNLOAD_FAIL FW_XGMI_TA_INVOKE_FAIL FW_TMR_INIT_FAIL FW_NOT_SUPPORTED_FEATURE FW_GET_PSP_TRACELOG_FAIL FW_SET_SNAPSHOT_ADDR_FAIL FW_SNAPSHOT_TRIGGER_FAIL FW_MIGRATION_GET_PSP_INFO_FAIL FW_MIGRATION_EXPORT_FAIL FW_MIGRATION_IMPORT_FAIL FW_BL_FAIL FW_RAS_BOOT_FAIL FW_MAILBOX_ERROR
AmdSmiEventCategoryReset	RESET_GPU RESET_GPU_FAILED RESET_FLR RESET_FLR_FAILED
AmdSmiEventCategoryIOV	IOV_NO_GPU_IOV_CAP IOV_ASIC_NO_SRIOV_SUPPORT IOV_ENABLE_SRIOV_FAIL IOV_CMD_TIMEOUT IOV_CMD_ERROR IOV_INIT_IV_RING_FAIL IOV_SRIOV_STRIDE_ERROR IOV_WS_SAVE_TIMEOUT IOV_WS_IDLE_TIMEOUT IOV_WS_RUN_TIMEOUT IOV_WS_LOAD_TIMEOUT IOV_WS_SHUTDOWN_TIMEOUT IOV_WS_ALREADY_SHUTDOWN IOV_WS_INFINITE_LOOP IOV_WS_REENTRANT_ERROR
AmdSmiEventCategoryECC	SMI_EVENT_ECC_UCE SMI_EVENT_ECC_CE ECC_IN_PF_FB ECC_IN_CRI_REG ECC_IN_VF_CRI ECC_REACH_THD ECC_VF_CE ECC_VF_UE ECC_IN_SAME_ROW ECC_UMC_UE ECC_GFX_CE ECC_GFX_UE ECC_SDMA_CE ECC_SDMA_UE ECC_GFX_CE_TOTAL ECC_GFX_UE_TOTAL ECC_SDMA_CE_TOTAL ECC_SDMA_UE_TOTAL ECC_UMC_CE_TOTAL ECC_UMC_UE_TOTAL ECC_MMHUB_CE ECC_MMHUB_UE ECC_MMHUB_CE_TOTAL ECC_MMHUB_UE_TOTAL ECC_XGMI_WAFL_CE ECC_XGMI_WAFL_UE ECC_XGMI_WAFL_CE_TOTAL ECC_XGMI_WAFL_UE_TOTAL ECC_FATAL_ERROR ECC_POISON_CONSUMPTION ECC_ACA_DUMP ECC_WRONG_SOCKET_ID ECC_ACA_UNKNOWN_BLOCK_INSTANCE ECC_UNKNOWN_CHIPLET_CE ECC_UNKNOWN_CHIPLET_UE ECC_UMC_CHIPLET_CE ECC_UMC_CHIPLET_UE ECC_GFX_CHIPLET_CE ECC_GFX_CHIPLET_UE ECC_SDMA_CHIPLET_CE ECC_SDMA_CHIPLET_UE ECC_MMHUB_CHIPLET_CE ECC_MMHUB_CHIPLET_UE ECC_XGMI_WAFL_CHIPLET_CE ECC_XGMI_WAFL_CHIPLET_UE ECC_EEPROM_ENTRIES_FOUND ECC_UMC_DE ECC_UMC_DE_TOTAL ECC_UNKNOWN ECC_EEPROM_REACH_THD ECC_UMC_CHIPLET_DE ECC_UNKNOWN_CHIPLET_DE ECC_EEPROM_CHK_MISMATCH ECC_EEPROM_RESET ECC_EEPROM_RESET_FAILED ECC_EEPROM_APPEND ECC_THD_CHANGED ECC_DUP_ENTRIES ECC_EEPROM_WRONG_HDR ECC_EEPROM_WRONG_VER
AmdSmiEventCategoryPP	PP_SET_DPM_POLICY_FAIL PP_ACTIVATE_DPM_POLICY_FAIL PP_I2C_SLAVE_NOT_PRESENT PP_THROTTLER_EVENT
AmdSmiEventCategorySched	SCHED_WORLD_SWITCH_FAIL SCHED_DISABLE_AUTO_HW_SWITCH_FAIL SCHED_ENABLE_AUTO_HW_SWITCH_FAIL SCHED_GFX_SAVE_REG_FAIL SCHED_GFX_IDLE_REG_FAIL SCHED_GFX_RUN_REG_FAIL SCHED_GFX_LOAD_REG_FAIL SCHED_GFX_INIT_REG_FAIL SCHED_MM_SAVE_REG_FAIL SCHED_MM_IDLE_REG_FAIL SCHED_MM_RUN_REG_FAIL SCHED_MM_LOAD_REG_FAIL SCHED_MM_INIT_REG_FAIL SCHED_INIT_GPU_FAIL SCHED_RUN_GPU_FAIL SCHED_SAVE_GPU_STATE_FAIL SCHED_LOAD_GPU_STATE_FAIL SCHED_IDLE_GPU_FAIL SCHED_FINI_GPU_FAIL SCHED_DEAD_VF SCHED_EVENT_QUEUE_FULL SCHED_SHUTDOWN_VF_FAIL SCHED_RESET_VF_NUM_FAIL SCHED_IGNORE_EVENT SCHED_PF_SWITCH_FAIL
AmdSmiEventCategoryVf	VF_ATOMBIOS_INIT_FAIL VF_NO_VBIOS VF_GPU_POST_ERROR VF_ATOMBIOS_GET_CLOCK_FAIL VF_FENCE_INIT_FAIL VF_AMDGPU_INIT_FAIL VF_IB_INIT_FAIL VF_AMDGPU_LATE_INIT_FAIL VF_ASIC_RESUME_FAIL VF_GPU_RESET_FAIL
AmdSmiEventCategoryVbios	VBIOS_INVALID VBIOS_IMAGE_MISSING VBIOS_CHECKSUM_ERR VBIOS_POST_FAIL VBIOS_READ_FAIL VBIOS_READ_IMG_HEADER_FAIL VBIOS_READ_IMG_SIZE_FAIL VBIOS_GET_FW_INFO_FAIL VBIOS_GET_TBL_REVISION_FAIL VBIOS_PARSER_TBL_FAIL VBIOS_IP_DISCOVERY_FAIL VBIOS_TIMEOUT VBIOS_HASH_INVALID VBIOS_HASH_UPDATED VBIOS_IP_DISCOVERY_BINARY_CHECKSUM_FAIL VBIOS_IP_DISCOVERY_TABLE_CHECKSUM_FAIL
AmdSmiEventCategoryGuard	GUARD_RESET_FAIL GUARD_EVENT_OVERFLOW
AmdSmiEventCategoryGpumon	GPUMON_INVALID_OPTION GPUMON_INVALID_VF_INDEX GPUMON_INVALID_FB_SIZE GPUMON_NO_SUITABLE_SPACE GPUMON_NO_AVAILABLE_SLOT GPUMON_OVERSIZE_ALLOCATION GPUMON_OVERLAPPING_FB GPUMON_INVALID_GFX_TIMESLICE GPUMON_INVALID_MM_TIMESLICE GPUMON_INVALID_GFX_PART GPUMON_VF_BUSY GPUMON_INVALID_VF_NUM GPUMON_NOT_SUPPORTED
AmdSmiEventCategoryMmsch	MMSCH_IGNORED_JOB MMSCH_UNSUPPORTED_VCN_FW
AmdSmiEventCategoryXgmi	XGMI_TOPOLOGY_UPDATE_FAILED XGMI_TOPOLOGY_HW_INIT_UPDATE XGMI_TOPOLOGY_UPDATE_DONE XGMI_FB_SHARING_SETTING_ERROR XGMI_FB_SHARING_SETTING_RESET

Severity is AmdSmiEventSeverity enum object with values

Severity	Description
HIGH	critical error
MED	significant error
LOW	trivial error
WARN	warning
INFO	info
ALL	monitor all severity levels

Exceptions that can be thrown by read function:

• AmdSmiParameterException

• AmdSmiTimeoutException

• AmdSmiLibraryException

stop

Description: Any resources used by event notification for the the given device will be freed with this function. This can be used explicitly or automatically using with statement, like in the examples below. This should be called either manually or automatically for every created AmdSmiEventReader object.

Input parameters: None

Example with manual cleanup of AmdSmiEventReader:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        event_reader = AmdSmiEventReader(processors,{AmdSmiEventCategory.RESET}, AmdSmiEventSeverity.ALL)
        while True:
            event = event_reader.read(10*1000*1000)
            gpu_bdf = amdsmi_get_gpu_device_bdf(event['dev_id'])
            vf_bdf = amdsmi_get_gpu_device_bdf(event['fcn_id'])
            print("=============== Event ================")
            print("    Time            {}".format(event['timestamp']))
            print("    Category        {}".format(event['category'].name))
            print("    Subcategory     {}".format(event['subcode'].name))
            print("    Level           {}".format(event['level'].name))
            print("    Data            {}".format(event['data']))
            print("    VF BDF          {}".format(vf_bdf))
            print("    GPU BDF         {}".format(gpu_bdf))
            print("    Date            {}".format(event['date']))
            print("    Message         {}".format(event['message']))
            print("======================================")
except AmdSmiTimeoutException:
    print("No more events")
finally:
    event_reader.stop()

Example with automatic cleanup using with statement:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        with AmdSmiEventReader(processors,{AmdSmiEventCategory.RESET}, AmdSmiEventSeverity.ALL) as event_reader:
            while True:
                event = event_reader.read(10*1000*1000)
                gpu_bdf = amdsmi_get_gpu_device_bdf(event['dev_id'])
                vf_bdf = amdsmi_get_gpu_device_bdf(event['fcn_id'])
                print("=============== Event ================")
                print("    Time            {}".format(event['timestamp']))
                print("    Category        {}".format(event['category'].name))
                print("    Subcategory     {}".format(event['subcode'].name))
                print("    Level           {}".format(event['level'].name))
                print("    Data            {}".format(event['data']))
                print("    VF BDF          {}".format(vf_bdf))
                print("    GPU BDF         {}".format(gpu_bdf))
                print("    Date            {}".format(event['date']))
                print("    Message         {}".format(event['message']))
                print("======================================")
except AmdSmiTimeoutException:
    print("No more events")

amdsmi_get_lib_version

Description: Get the build version information for the currently running build of AMDSMI.

Output: amdsmi build version

Exceptions that can be thrown by amdsmi_get_lib_version function:

• AmdSmiLibraryException

• AmdSmiRetryException

• AmdSmiParameterException

Example:

try:
    devices = amdsmi_get_processor_handles()
    if len(devices) == 0:
        print("No GPUs on machine")
    else:
        for device in devices:
            version = amdsmi_get_lib_version()
            print(version)
except AmdSmiException as e:
    print(e)

amdsmi_get_gpu_virtualization_mode

Description: Retrieve the current GPU virtualization mode.

Input parameters:

• processor handle The handle to the GPU device for which the virtualization mode is being queried.

Output: Enum object representing the current virtualization mode.

AmdSmiVirtualizationMode enum:

Field	Description
UNKNOWN	unknown virtualization mode
NONE	none virtualization mode
HOST	host virtualization mode
GUEST	guest virtualization mode
PASSTHROUGH	passthrough virtualization mode

Exceptions that can be thrown by amdsmi_get_gpu_virtualization_mode function:

• AmdSmiLibraryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        for processor in processors:
            virtualization_mode = amdsmi_get_gpu_virtualization_mode(processor)
            print("Virtualization mode: {}".format(virtualization_mode))

except AmdSmiException as e:
    print(e)

amdsmi_get_gpu_accelerator_partition_profile_config

Description: Returns gpu accelerator partition caps as currently configured in the system

Input parameters:

• processor handle PF of a GPU device

Output: Dictionary with fields

Field	Description
resource_profiles (dictionary)	Subfield Description profile_index index of a profile resource_type type of a resource from AmdSmiAcceleratorPartitionResource enum partition_resource the resources a partition can use, which may be shared num_partitions_share_resource number of partitions that share resource of that type
default_profiles_index	index of the default profile
profiles (dictionary)	Subfield Description profile_type profile type from AmdSmiAcceleratorPartitionSetting enum num_partitions number of partitions in the profile memory_caps memory capabilities of the profile profile_index index of the profile resources resources in the profile

AmdSmiAcceleratorPartitionResource enum:

Field	Description
XCC	xcc resource capabilities
ENCODER	encoder resource capabilities
DECODER	decoder resource capabilities
DMA	dma resource capabilities
JPEG	jpeg resource capabilities

AmdSmiAcceleratorPartitionSetting enum:

Field	Description
INVALID	invalid compute partition
SPX	compute partition with all xccs in group (8/1)
DPX	compute partition with four xccs in group (8/2)
TPX	compute partition with two xccs in group (6/3)
QPX	compute partition with two xccs in group (8/4)
CPX	compute partition with one xcc in group (8/8)

Exceptions that can be thrown by amdsmi_get_gpu_accelerator_partition_profile_config function:

• AmdSmiLibraryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        for processor in processors:
            accelerator_partition_config = amdsmi_get_gpu_accelerator_partition_profile_config(processor)
            print(accelerator_partition_config)
except AmdSmiException as e:
    print(e)

amdsmi_get_gpu_accelerator_partition_profile_config_global

Description: Returns all GPU accelerator partition capabilities which can be configured on the system

Input parameters:

• processor_handle PF of a GPU device

Output: Dictionary with fields

Field	Description
profiles	List of dictionaries, each describing a supported accelerator partition profile. Each dictionary contains: Subfield Description profile_type Profile type from AmdSmiAcceleratorPartitionSetting enum num_partitions Number of partitions in the profile memory_caps Memory capabilities of the profile profile_index Index of the profile vf_mode List of supported VF counts for this profile (e.g., [1, 2, 4, 8]) resources List of resource types (from AmdSmiAcceleratorPartitionResource enum) available in this profile
default_profile_index	Index of the default profile used if no custom configuration is set

AmdSmiAcceleratorPartitionSetting enum:

Field	Description
INVALID	Invalid compute partition
SPX	Compute partition with all xccs in group (8/1)
DPX	Compute partition with four xccs in group (8/2)
TPX	Compute partition with two xccs in group (6/3)
QPX	Compute partition with two xccs in group (8/4)
CPX	Compute partition with one xcc in group (8/8)

AmdSmiAcceleratorPartitionResource enum:

Field	Description
XCC	xcc resource capabilities
ENCODER	encoder resource capabilities
DECODER	decoder resource capabilities
DMA	dma resource capabilities
JPEG	jpeg resource capabilities

Exceptions that can be thrown by amdsmi_get_gpu_accelerator_partition_profile_config_global function:

• AmdSmiLibraryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        for processor in processors:
            config = amdsmi_get_gpu_accelerator_partition_profile_config_global(processor)
            print(config)
except AmdSmiException as e:
    print(e)

amdsmi_get_gpu_accelerator_partition_profile

Description: Returns current gpu accelerator partition cap

Input parameters:

• processor handle PF of a GPU device

Output: Dictionary with fields

Field	Description
profile (dictionary)	Subfield Description profile_type current profile type from AmdSmiAcceleratorPartitionSetting enum num_partitions number of partitions in the profile memory_caps memory capabilities of the profile profile_index index of the profile resources resources in the profile
partition_id	array of ids for current accelerator profile

AmdSmiComputePartitionResource enum:

Field	Description
XCC	xcc resource capabilities
ENCODER	encoder resource capabilities
DECODER	decoder resource capabilities
DMA	dma resource capabilities
JPEG	jpeg resource capabilities

Exceptions that can be thrown by amdsmi_get_gpu_accelerator_partition_profile function:

• AmdSmiLibraryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        for processor in processors:
            accelerator_partition_profile = amdsmi_get_gpu_accelerator_partition_profile(processor)
            print(accelerator_partition_profile)
except AmdSmiException as e:
    print(e)

amdsmi_get_gpu_memory_partition_config

Description: Returns current gpu memory partition config and mode capabilities

Input parameters:

• processor handle PF of a GPU device

Output: Dictionary with fields

Field	Description
partition_caps	memory partition capabilities
mp_mode	memory partition mode from AmdSmiMemoryPartitionSetting enum
numa_range (dictionary)	Subfield Description memory_type memory type from AmdSmiVramType enum start start of numa range end end of numa range

‘AmdSmiMemoryPartitionSetting’ enum:

Field	Description
UNKNOWN	unknown memory partition
NPS1	memory partition with 1 number per socket
NPS2	memory partition with 2 numbers per socket
NPS4	memory partition with 4 numbers per socket
NPS8	memory partition with 8 numbers per socket

Exceptions that can be thrown by amdsmi_get_gpu_memory_partition_config function:

• AmdSmiLibraryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        for processor in processors:
            memory_partition_config = amdsmi_get_gpu_memory_partition_config(processor)
            print(memory_partition_config)
except AmdSmiException as e:
    print(e)

amdsmi_set_gpu_accelerator_partition_profile

Description: Sets accelerator partition setting based on profile_index from amdsmi_get_gpu_accelerator_partition_profile_config

Input parameters:

• processor handle PF of a GPU device

• profile_index Represents index of a partition user wants to set

Output:

• None

Exceptions that can be thrown by amdsmi_set_gpu_accelerator_partition_profile function:

• AmdSmiLibraryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        for processor in processors:
            amdsmi_set_gpu_accelerator_partition_profile(processor, 1)

except AmdSmiException as e:
    print(e)

amdsmi_set_gpu_memory_partition_mode

Description: Sets memory partition mode

Input parameters:

• processor handle PF of a GPU device

• setting Enum from AmdSmiMemoryPartitionSetting representing memory partitioning mode to set

AmdSmiMemoryPartitionSetting enum:

Field	Description
UNKNOWN	unknown memory partition
NPS1	memory partition with 1 number per socket
NPS2	memory partition with 2 numbers per socket
NPS4	memory partition with 4 numbers per socket
NPS8	memory partition with 8 numbers per socket

Output:

• None

Exceptions that can be thrown by amdsmi_set_gpu_memory_partition_mode function:

• AmdSmiLibraryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        for processor in processors:
            amdsmi_set_gpu_memory_partition_mode(processor, AmdSmiMemoryPartitionSetting.NPS1)
except AmdSmiException as e:
    print(e)

amdsmi_get_gpu_cper_entries

Description: Dump CPER entries for a given GPU in a file using from CPER header file from RAS tool.

Input parameters:

• processor_handle device which to query

• severity_mask Represents different severity masks from ‘AmdSmiCperErrorSeverity’ enum on which filtering of cpers is based.

• buffer_size pointer to a variable that specifies the size of the cper_data

• cursor pointer to a variable that will contain the cursor for the next call

AmdSmiCperErrorSeverity

Field	Description
NON_FATAL_UNCORRECTED	filters non-fatal-uncorrected cpers
FATAL	filters fatal cpers
NON_FATAL_CORRECTED	filters non_fatal_corrected cpers
NUM	shows all cper types

Output: Dictionary with fields

Field	Description
error_severity	The severity of the CPER error ex: non_fatal_uncorrected, fatal, non_fatal_corrected.
notify_type	The notification type associated with the CPER entry.
timestamp	The time when the CPER entry was recorded, formatted as YYYY/MM/DD HH:MM:SS.
signature	A 4-byte signature identifying the entry, typically CPER.
revision	The revision number of the CPER record format.
signature_end	A marker value (typically 0xFFFFFFFF) confirming the integrity of the signature.
sec_cnt	The count of sections included in the CPER entry.
record_length	The total length in bytes of the CPER entry.
platform_id	A character array identifying the GPU or platform.
creator_id	A character array indicating the creator of the CPER entry.
record_id	A unique identifier for the CPER entry.
flags	Reserved flags related to the CPER entry.
persistence_info	Reserved information related to persistence.

Exceptions that can be thrown by amdsmi_get_gpu_cper_entries function:

• AmdSmiLibraryException

• AmdSmiParameterException

Example:

for device in devices:
        entries, new_cursor, cper_data = amdsmi_get_gpu_cper_entries(device, severity_mask, buffer_size, initial_cursor)
        print("CPER entries for device", device)
        for key, entry in entries.items():
            print("Entry", key)
            print("  Error Severity:", entry.get("error_severity", "Unknown"))
            print("  Notify Type:", entry.get("notify_type", "Unknown"))
            print("  Timestamp:", entry.get("timestamp", ""))
            print()
        print("New Cursor Position:", new_cursor)
except AmdSmiException as e:
    print(e)

amdsmi_get_p2p_status

Description: Retrieve the connection type and P2P capabilities between 2 GPUs

Input parameters:

• processor_handle_src the source device handle

• processor_handle_dest the destination device handle

Output: Dictionary with fields:

Fields	Description
type	AmdSmiLinkType
cap	Subfield Description is_iolink_coherent 1 == True; 0 == False; Uint_max = Undefined is_iolink_atomics_32bit Supports 32bit atomics is_iolink_atomics_64bit Supports 64bit atomics is_iolink_dma Supports DMA is_iolink_bi_directional Is the IOLink Bidirectional

Exceptions that can be thrown by amdsmi_get_p2p_status function:

• AmdSmiLibraryException

• AmdSmiRetryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        processor_handle_src = processors[0]
        processor_handle_dest = processors[1]
        link_type = amdsmi_get_p2p_status(processor_handle_src, processor_handle_dest)
        print(link_type['type'])
        print(link_type['caps'])
except AmdSmiException as e:
    print(e)

amdsmi_get_afids_from_cper

Description: Get AFID for cper error

Input parameters: buffer which contains one cper

• cper_buffer

Output:

• List of AFID

Exceptions that can be thrown by amdsmi_get_afids_from_cper function:

• AmdSmiLibraryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        for processor in processors:
        entries, new_cursor, cper_data = amdsmi_get_gpu_cper_entries(processor, severity_mask, buffer_size, initial_cursor)
            afid = amdsmi_get_afids_from_cper(cper_data[0]['bytes'])
            print(afid)

except AmdSmiException as e:
    print(e)

amdsmi_reset_gpu

Description: Reset the GPU associated with the device with provided processor handle.

Input parameters: GPU device handle

• processor_handle

Output:

• None

Exceptions that can be thrown by amdsmi_reset_gpu function:

• AmdSmiLibraryException

• AmdSmiParameterException

Example:

try:
    processors = amdsmi_get_processor_handles()
    if len(processors) == 0:
        print("No GPUs on machine")
    else:
        for processor in processors:
            amdsmi_reset_gpu(processor)

except AmdSmiException as e:
    print(e)

amdsmi_get_cpu_affinity_with_scope

Description: Returns list of bitmask information for the given GPU.

Input parameters:

• processor_handle device which to query

• scope enum value for numa or socket affinity

Output: bitmask of CPU cores that this processor affinities with

Exceptions that can be thrown by amdsmi_get_cpu_affinity_with_scope function:

• AmdSmiLibraryException

• AmdSmiRetryException

• AmdSmiParameterException

Example:

try:
    devices = amdsmi_get_processor_handles()
    if len(devices) == 0:
        print("No GPUs on machine")
    else:
        for device in devices:
            bitmask = amdsmi_get_cpu_affinity_with_scope(device, AmdSmiAffinityScope.NUMA_SCOPE)
            print(bitmask)
except AmdSmiException as e:
    print(e)

amdsmi_topo_get_numa_node_number

Description: Get the NUMA node associated with a device

Input parameters:

• processor_handle device which to query

Output: NUMA node value

Exceptions that can be thrown by amdsmi_topo_get_numa_node_number function:

• AmdSmiLibraryException

• AmdSmiRetryException

• AmdSmiParameterException

Example:

try:
    devices = amdsmi_get_processor_handles()
    if len(devices) == 0:
        print("No GPUs on machine")
    else:
        for device in devices:
            numa_node = amdsmi_topo_get_numa_node_number(device)
            print(numa_node)
except AmdSmiException as e:
    print(e)

amdsmi_get_nic_driver_info

Description: Retrieves information about the NIC driver

Input parameters:

• processor_handle NIC for which to query

Output: Dictionary with fields

Field	Description
name	driver name
version	driver version

Exceptions that can be thrown by amdsmi_get_nic_driver_info function:

• AmdSmiParameterException

• AmdSmiLibraryException

Example:

try:
    nic_handles = amdsmi_get_processor_handles_by_type(AmdSmiProcessorType.AMD_NIC)
    if len(nic_handles) == 0:
        print("No NICs on machine")
    else:
        for nic in nic_handles:
            print(amdsmi_get_nic_driver_info(nic))
except AmdSmiException as e:
    print(e)

amdsmi_get_nic_asic_info

Description: Retrieves ASIC information for the NIC

Input parameters:

• processor_handle NIC for which to query

Output: Dictionary with fields

Field	Description
vendor_id	vendor id
subvendor_id	subsystem vendor id
device_id	device id
subsystem_id	subsystem device id
revision	revision id
permanent_address	permanent mac address
product_name	product name
part_number	part number
serial_number	serial number
vendor_name	vendor name

Exceptions that can be thrown by amdsmi_get_nic_asic_info function:

• AmdSmiParameterException

• AmdSmiLibraryException

Example:

try:
    nic_handles = amdsmi_get_processor_handles_by_type(AmdSmiProcessorType.AMD_NIC)
    if len(nic_handles) == 0:
        print("No NICs on machine")
    else:
        for nic in nic_handles:
            print(amdsmi_get_nic_asic_info(nic))
except AmdSmiException as e:
    print(e)

amdsmi_get_nic_bus_info

Description: Retrieves BUS information for the NIC

Input parameters:

• processor_handle NIC for which to query

Output: Dictionary with fields

Field	Description
bdf	bus
max_pcie_width	maximum supported PCIe link width
max_pcie_speed	maximum supported PCIe link speed
pcie_interface_version	PCIe interface version (Not supported yet, currently hardcoded to 0)
slot_type	physical slot type (Not supported yet, currently hardcoded to 0)

Exceptions that can be thrown by amdsmi_get_nic_bus_info function:

• AmdSmiParameterException

• AmdSmiLibraryException

Example:

try:
    nic_handles = amdsmi_get_processor_handles_by_type(AmdSmiProcessorType.AMD_NIC)
    if len(nic_handles) == 0:
        print("No NICs on machine")
    else:
        for nic in nic_handles:
            print(amdsmi_get_nic_bus_info(nic))
except AmdSmiException as e:
    print(e)

amdsmi_get_nic_numa_info

Description: Retrieves NUMA information for the NIC

Input parameters:

• processor_handle NIC for which to query

Output: Dictionary with fields

Field	Content
node	NUMA (Non-Uniform Memory Access) node identifier associated with the device.
affinity	CPU affinity mask for the device

Exceptions that can be thrown by amdsmi_get_nic_numa_info function:

• AmdSmiParameterException

• AmdSmiLibraryException

Example:

try:
    nic_handles = amdsmi_get_processor_handles_by_type(AmdSmiProcessorType.AMD_NIC)
    if len(nic_handles) == 0:
        print("No NICs on machine")
    else:
        for nic in nic_handles:
            print(amdsmi_get_nic_numa_info(nic))
except AmdSmiException as e:
    print(e)

amdsmi_get_nic_port_info

Description: Retrieves PORT information for the NIC

Input parameters:

• processor_handle NIC for which to query

Output: Dictionary with fields

Field	Description
ports	List of port information dictionaries

Each port dictionary contains:

Field	Content
bdf	BDF of the port
port_num	Port number
type	Type of the port
flavour	Port flavour
netdev	Associated network device name
ifindex	Interface index of the port
mac_address	MAC address assigned to the port
carrier	Carrier state
mtu	Maximum Transmission Unit size
link_state	Current link state
link_speed	Link speed in Mbps
active_fec	Currently active Forward Error Correction mode
autoneg	Auto-negotiation status
pause_autoneg	Pause frame auto-negotiation status
pause_rx	Receive pause frame status
pause_tx	Transmit pause frame status

Exceptions that can be thrown by amdsmi_get_nic_port_info function:

• AmdSmiParameterException

• AmdSmiLibraryException

Example:

try:
    nic_handles = amdsmi_get_processor_handles_by_type(AmdSmiProcessorType.AMD_NIC)
    if len(nic_handles) == 0:
        print("No NICs on machine")
    else:
        for nic in nic_handles:
            port_info = amdsmi_get_nic_port_info(nic)
            print(f"Number of ports: {len(port_info['ports'])}")
            for i, port in enumerate(port_info['ports']):
                print(f"Port {i}:")
                print(f"  BDF: {port['bdf']}")
                print(f"  Port Number: {port['port_num']}")
                print(f"  Type: {port['type']}")
                print(f"  Flavour: {port['flavour']}")
                print(f"  Network Device: {port['netdev']}")
                print(f"  Interface Index: {port['ifindex']}")
                print(f"  MAC Address: {port['mac_address']}")
                print(f"  Carrier: {port['carrier']}")
                print(f"  MTU: {port['mtu']}")
                print(f"  Link State: {port['link_state']}")
                print(f"  Link Speed: {port['link_speed']}")
                print(f"  Active FEC: {port['active_fec']}")
                print(f"  Auto-negotiation: {port['autoneg']}")
                print(f"  Pause Auto-negotiation: {port['pause_autoneg']}")
                print(f"  Pause RX: {port['pause_rx']}")
                print(f"  Pause TX: {port['pause_tx']}")
except AmdSmiException as e:
    print(e)

amdsmi_get_nic_rdma_dev_info

Description: Retrieves RDMA devices information for the NIC

Input parameters:

• processor_handle NIC for which to query

Output: Dictionary with fields

Field	Description
rdma_dev_info	List of RDMA device information dictionaries

Each RDMA device info dictionary contains:

Field	Description
rdma_dev	RDMA device name
node_guid	Node GUID
node_type	Node type
sys_image_guid	System image GUID
fw_ver	Firmware version
rdma_port_info	List of RDMA port information dictionaries

Each RDMA port info dictionary contains:

Field	Description
netdev	Associated network device name
state	Port state (DOWN, INIT, ARMED, ACTIVE, ACTIVE_DEFER)
rdma_port	RDMA port number
max_mtu	Maximum MTU size
active_mtu	Currently active MTU size

Exceptions that can be thrown by amdsmi_get_nic_rdma_dev_info function:

• AmdSmiParameterException

• AmdSmiLibraryException

Example:

try:
    nic_handles = amdsmi_get_processor_handles_by_type(AmdSmiProcessorType.AMD_NIC)
    if len(nic_handles) == 0:
        print("No NICs on machine")
    else:
        for nic in nic_handles:
            rdma_info = amdsmi_get_nic_rdma_dev_info(nic)
            print(f"Number of RDMA devices: {len(rdma_info['rdma_dev_info'])}")
            for i, rdma_dev in enumerate(rdma_info['rdma_dev_info']):
                print(f"RDMA Device {i}:")
                print(f"  Device: {rdma_dev['rdma_dev']}")
                print(f"  Node GUID: {rdma_dev['node_guid']}")
                print(f"  Node Type: {rdma_dev['node_type']}")
                print(f"  System Image GUID: {rdma_dev['sys_image_guid']}")
                print(f"  Firmware Version: {rdma_dev['fw_ver']}")
                print(f"  Number of RDMA ports: {len(rdma_dev['rdma_port_info'])}")
                for j, port in enumerate(rdma_dev['rdma_port_info']):
                    print(f"    Port {j}:")
                    print(f"      Network Device: {port['netdev']}")
                    print(f"      State: {port['state']}")
                    print(f"      RDMA Port: {port['rdma_port']}")
                    print(f"      Max MTU: {port['max_mtu']}")
                    print(f"      Active MTU: {port['active_mtu']}")
except AmdSmiException as e:
    print(e)

amdsmi_get_nic_port_statistics

Description: Retrieve all available PORT statistics for the specified NIC port

Input parameters:

• processor_handle NIC for which to query

• port_index index of the NIC port to query

Output: Returns a list of dictionaries, each containing:

• name

• value

Exceptions that can be thrown by amdsmi_get_nic_port_statistics function:

• AmdSmiParameterException

• AmdSmiLibraryException

Example:

try:
    nic_handles = amdsmi_get_processor_handles_by_type(AmdSmiProcessorType.AMD_NIC)
    if len(nic_handles) == 0:
        print("No NICs on machine")
    else:
        for nic in nic_handles:
            port_stats = amdsmi_get_nic_port_statistics(nic, 0)
            for stat in port_stats:
                print(f"{stat['name']}: {stat['value']}")
except AmdSmiException as e:
    print(e)

amdsmi_get_nic_vendor_statistics

Description: Retrieve vendor specific statistics for the NIC port

Input parameters:

• processor_handle NIC for which to query

• port_index index of the NIC port to query

Output: Returns a list of dictionaries, each containing:

• name

• value

This API provides access to vendor/driver specific statistics that may vary between different NIC vendors and driver/firmware versions. The statistic names are preserved as provided by the underlying driver implementation.

Note: The exact statistics available depend on the NIC vendor, hardware and driver version.

Exceptions that can be thrown by amdsmi_get_nic_vendor_statistics function:

• AmdSmiParameterException

• AmdSmiLibraryException

Example:

try:
    nic_handles = amdsmi_get_processor_handles_by_type(AmdSmiProcessorType.AMD_NIC)
    if len(nic_handles) == 0:
        print("No NICs on machine")
    else:
        for nic in nic_handles:
            vendor_stats = amdsmi_get_nic_vendor_statistics(nic, 0)
            for stat in vendor_stats:
                print(f"{stat['name']}: {stat['value']}")
except AmdSmiException as e:
    print(e)

amdsmi_get_nic_rdma_port_statistics

Description: Retrieve RDMA port statistics for the NIC

Input parameters:

• processor_handle NIC for which to query

• rdma_port_index index of the NIC RDMA port to query

Output: Returns a list of dictionaries, each containing:

• name

• value

Exceptions that can be thrown by amdsmi_get_nic_rdma_port_statistics function:

• AmdSmiParameterException

• AmdSmiLibraryException

Example:

try:
    nic_handles = amdsmi_get_processor_handles_by_type(AmdSmiProcessorType.AMD_NIC)
    if len(nic_handles) == 0:
        print("No NICs on machine")
    else:
        rdma_port_index = 0
        for nic in nic_handles:
            rdma_stats = amdsmi_get_nic_rdma_port_statistics(nic, rdma_port_index)
            for stat in rdma_stats:
                print(f"{stat['name']}: {stat['value']}")
except AmdSmiException as e:
    print(e)