linux-yocto/Documentation/ABI/testing/sysfs-driver-intel-i915-hwmon
Raag Jadav 727eb1e3f0 drm/i915/hwmon: expose fan speed
Add hwmon support for fan1_input attribute, which will expose fan speed
in RPM. With this in place we can monitor fan speed using lm-sensors tool.

$ sensors
i915-pci-0300
Adapter: PCI adapter
in0:         653.00 mV
fan1:        3833 RPM
power1:           N/A  (max =  43.00 W)
energy1:      32.02 kJ

v2: Handle overflow, add mutex protection and ABI documentation
    Aesthetic adjustments (Riana)
v3: Change rotations data type, ABI date and version
v4: Fix wakeref leak
    Drop switch case and simplify hwm_fan_xx() (Andi)
v5: Rework time calculation, aesthetic adjustments (Andy)
v6: Drop redundant overflow logic (Andy)
    Split fan_input_read() into dedicated helper (Badal)
v7: Fix undefined reference to __udivdi3 for i386 (Andy)

Signed-off-by: Raag Jadav <raag.jadav@intel.com>
Reviewed-by: Riana Tauro <riana.tauro@intel.com>
Reviewed-by: Andi Shyti <andi.shyti@linux.intel.com>
Reviewed-by: Badal Nilawar <badal.nilawar@intel.com>
Signed-off-by: Anshuman Gupta <anshuman.gupta@intel.com>
Link: https://patchwork.freedesktop.org/patch/msgid/20240823034548.2670032-1-raag.jadav@intel.com
2024-08-28 12:06:07 +05:30

3.1 KiB

What: /sys/bus/pci/drivers/i915/.../hwmon/hwmon/in0_input Date: February 2023 KernelVersion: 6.2 Contact: intel-gfx@lists.freedesktop.org Description: RO. Current Voltage in millivolt.

	Only supported for particular Intel i915 graphics platforms.

What: /sys/bus/pci/drivers/i915/.../hwmon/hwmon/power1_max Date: February 2023 KernelVersion: 6.2 Contact: intel-gfx@lists.freedesktop.org Description: RW. Card reactive sustained (PL1/Tau) power limit in microwatts.

	The power controller will throttle the operating frequency
	if the power averaged over a window (typically seconds)
	exceeds this limit. A read value of 0 means that the PL1
	power limit is disabled, writing 0 disables the
	limit. Writing values > 0 will enable the power limit.

	Only supported for particular Intel i915 graphics platforms.

What: /sys/bus/pci/drivers/i915/.../hwmon/hwmon/power1_rated_max Date: February 2023 KernelVersion: 6.2 Contact: intel-gfx@lists.freedesktop.org Description: RO. Card default power limit (default TDP setting).

	Only supported for particular Intel i915 graphics platforms.

What: /sys/bus/pci/drivers/i915/.../hwmon/hwmon/power1_max_interval Date: February 2023 KernelVersion: 6.2 Contact: intel-gfx@lists.freedesktop.org Description: RW. Sustained power limit interval (Tau in PL1/Tau) in milliseconds over which sustained power is averaged.

	Only supported for particular Intel i915 graphics platforms.

What: /sys/bus/pci/drivers/i915/.../hwmon/hwmon/power1_crit Date: February 2023 KernelVersion: 6.2 Contact: intel-gfx@lists.freedesktop.org Description: RW. Card reactive critical (I1) power limit in microwatts.

	Card reactive critical (I1) power limit in microwatts is exposed
	for client products. The power controller will throttle the
	operating frequency if the power averaged over a window exceeds
	this limit.

	Only supported for particular Intel i915 graphics platforms.

What: /sys/bus/pci/drivers/i915/.../hwmon/hwmon/curr1_crit Date: February 2023 KernelVersion: 6.2 Contact: intel-gfx@lists.freedesktop.org Description: RW. Card reactive critical (I1) power limit in milliamperes.

	Card reactive critical (I1) power limit in milliamperes is
	exposed for server products. The power controller will throttle
	the operating frequency if the power averaged over a window
	exceeds this limit.

	Only supported for particular Intel i915 graphics platforms.

What: /sys/bus/pci/drivers/i915/.../hwmon/hwmon/energy1_input Date: February 2023 KernelVersion: 6.2 Contact: intel-gfx@lists.freedesktop.org Description: RO. Energy input of device or gt in microjoules.

	For i915 device level hwmon devices (name "i915") this
	reflects energy input for the entire device. For gt level
	hwmon devices (name "i915_gtN") this reflects energy input
	for the gt.

	Only supported for particular Intel i915 graphics platforms.

What: /sys/bus/pci/drivers/i915/.../hwmon/hwmon/fan1_input Date: November 2024 KernelVersion: 6.12 Contact: intel-gfx@lists.freedesktop.org Description: RO. Fan speed of device in RPM.

	Only supported for particular Intel i915 graphics platforms.