Physical State Control

Physical State Control#

AMD SMI: Physical State Control
Physical State Control

Functions

amdsmi_status_t amdsmi_reset_gpu_fan (amdsmi_processor_handle processor_handle, uint32_t sensor_ind)
 Reset the fan to automatic driver control. It is not supported on virtual machine guest. More...
 
amdsmi_status_t amdsmi_set_gpu_fan_speed (amdsmi_processor_handle processor_handle, uint32_t sensor_ind, uint64_t speed)
 Set the fan speed for the specified device with the provided speed, in RPMs. It is not supported on virtual machine guest. More...
 

Detailed Description

These functions provide control over the physical state of a device.

Function Documentation

◆ amdsmi_reset_gpu_fan()

amdsmi_status_t amdsmi_reset_gpu_fan ( amdsmi_processor_handle  processor_handle,
uint32_t  sensor_ind 
)

Reset the fan to automatic driver control. It is not supported on virtual machine guest.

Platform:
gpu_bm_linux

This function returns control of the fan to the system

Parameters
[in]processor_handlea processor handle
[in]sensor_inda 0-based sensor index. Normally, this will be 0. If a device has more than one sensor, it could be greater than 0.
Returns
amdsmi_status_t | AMDSMI_STATUS_SUCCESS on success, non-zero on fail

◆ amdsmi_set_gpu_fan_speed()

amdsmi_status_t amdsmi_set_gpu_fan_speed ( amdsmi_processor_handle  processor_handle,
uint32_t  sensor_ind,
uint64_t  speed 
)

Set the fan speed for the specified device with the provided speed, in RPMs. It is not supported on virtual machine guest.

Platform:
gpu_bm_linux

Given a processor handle processor_handle and a integer value indicating speed speed, this function will attempt to set the fan speed to speed. An error will be returned if the specified speed is outside the allowable range for the device. The maximum value is 255 and the minimum is 0.

Note
This function requires root access
Parameters
[in]processor_handlea processor handle
[in]sensor_inda 0-based sensor index. Normally, this will be 0. If a device has more than one sensor, it could be greater than 0.
[in]speedthe speed to which the function will attempt to set the fan
Returns
amdsmi_status_t | AMDSMI_STATUS_SUCCESS on success, non-zero on fail