Physical State Control

Physical State Control#

AMD SMI: 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.

This function returns control of the fan to the system

Parameters

[in]	processor_handle	a processor handle
[in]	sensor_ind	a 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.

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