Get the list of possible PCIe bandwidths that are available.

Given a device index dv_ind and a pointer to a to an rsmi_pcie_bandwidth_t structure bandwidth, this function will fill in bandwidth with the possible T/s values and associated number of lanes, and indication of the current selection.

Parameters

[in]	dv_ind	a device index
[in,out]	bandwidth	a pointer to a caller provided rsmi_pcie_bandwidth_t structure to which the frequency information will be written

Return values

RSMI_STATUS_SUCCESS	is returned upon successful call.
RSMI_STATUS_UNEXPECTED_DATA	Data read or provided was not as expected

Get the unique PCI device identifier associated for a device.

Give a device index dv_ind and a pointer to a uint64_t bdfid, this function will write the Bus/Device/Function PCI identifier (BDFID) associated with device dv_ind to the value pointed to by bdfid.

The format of bdfid will be as follows:

BDFID = ((DOMAIN & 0xFFFFFFFF) << 32) | ((Partition & 0xF) << 28)
        | ((BUS & 0xFF) << 8) | ((DEVICE & 0x1F) <<3 )
        | (FUNCTION & 0x7)

Note: In some devices, the partition ID may be stored in the function bits BDFID[2:0] instead of BDFID[31:28].

Note: For MI series devices, the function bits are only used to store the partition ID, but this modified BDF is internal to the ROCm stack. To the OS, partitions share the same BDF as the unpartitioned device and have function bits = 0, which can be verified through lspci.

Parameters

[in]	dv_ind	a device index
[in,out]	bdfid	a pointer to uint64_t to which the device bdfid value will be written If this parameter is nullptr, this function will return RSMI_STATUS_INVALID_ARGS if the function is supported with the provided, arguments and RSMI_STATUS_NOT_SUPPORTED if it is not supported with the provided arguments.

Return values

RSMI_STATUS_SUCCESS	call was successful
RSMI_STATUS_NOT_SUPPORTED	installed software or hardware does not support this function with the given arguments
RSMI_STATUS_INVALID_ARGS	the provided arguments are not valid

Get the NUMA node associated with a device.

Given a device index dv_ind and a pointer to a uint32_t numa_node, this function will retrieve the NUMA node value associated with device dv_ind and store the value at location pointed to by numa_node.

Parameters

[in]	dv_ind	a device index
[in,out]	numa_node	pointer to location where NUMA node value will be written. If this parameter is nullptr, this function will return RSMI_STATUS_INVALID_ARGS if the function is supported with the provided, arguments and RSMI_STATUS_NOT_SUPPORTED if it is not supported with the provided arguments.

Return values

RSMI_STATUS_SUCCESS	call was successful
RSMI_STATUS_NOT_SUPPORTED	installed software or hardware does not support this function with the given arguments
RSMI_STATUS_INVALID_ARGS	the provided arguments are not valid

Get PCIe traffic information.

Give a device index dv_ind and pointers to a uint64_t's, sent, received and max_pkt_sz, this function will write the number of bytes sent and received in 1 second to sent and received, respectively. The maximum possible packet size will be written to max_pkt_sz.

Parameters

[in]	dv_ind	a device index
[in,out]	sent	a pointer to uint64_t to which the number of bytes sent will be written in 1 second. If pointer is NULL, it will be ignored.
[in,out]	received	a pointer to uint64_t to which the number of bytes received will be written. If pointer is NULL, it will be ignored.
[in,out]	max_pkt_sz	a pointer to uint64_t to which the maximum packet size will be written. If pointer is NULL, it will be ignored.

Return values

RSMI_STATUS_SUCCESS	is returned upon successful call.
RSMI_STATUS_NOT_SUPPORTED	installed software or hardware does not support this function with the given arguments

Get PCIe replay counter.

Given a device index dv_ind and a pointer to a uint64_t counter, this function will write the sum of the number of NAK's received by the GPU and the NAK's generated by the GPU to memory pointed to by counter.

Parameters

[in]	dv_ind	a device index
[in,out]	counter	a pointer to uint64_t to which the sum of the NAK's received and generated by the GPU is written If this parameter is nullptr, this function will return RSMI_STATUS_INVALID_ARGS if the function is supported with the provided, arguments and RSMI_STATUS_NOT_SUPPORTED if it is not supported with the provided arguments.

Return values

RSMI_STATUS_SUCCESS	call was successful
RSMI_STATUS_NOT_SUPPORTED	installed software or hardware does not support this function with the given arguments
RSMI_STATUS_INVALID_ARGS	the provided arguments are not valid