260 lines
		
	
	
		
			7.7 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
			
		
		
	
	
			260 lines
		
	
	
		
			7.7 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
What:		/sys/class/thermal/thermal_zoneX/type
 | 
						|
Description:
 | 
						|
		Strings which represent the thermal zone type.
 | 
						|
		This is given by thermal zone driver as part of registration.
 | 
						|
		E.g: "acpitz" indicates it's an ACPI thermal device.
 | 
						|
		In order to keep it consistent with hwmon sys attribute; this
 | 
						|
		shouldbe a short, lowercase string, not containing spaces nor
 | 
						|
		dashes.
 | 
						|
 | 
						|
		RO, Required
 | 
						|
 | 
						|
What:		/sys/class/thermal/thermal_zoneX/temp
 | 
						|
Description:
 | 
						|
		Current temperature as reported by thermal zone (sensor).
 | 
						|
 | 
						|
		Unit: millidegree Celsius
 | 
						|
 | 
						|
		RO, Required
 | 
						|
 | 
						|
What:		/sys/class/thermal/thermal_zoneX/mode
 | 
						|
Description:
 | 
						|
		One of the predefined values in [enabled, disabled].
 | 
						|
		This file gives information about the algorithm that is
 | 
						|
		currently managing the thermal zone. It can be either default
 | 
						|
		kernel based algorithm or user space application.
 | 
						|
 | 
						|
		enabled
 | 
						|
				enable Kernel Thermal management.
 | 
						|
		disabled
 | 
						|
				Preventing kernel thermal zone driver actions upon
 | 
						|
				trip points so that user application can take full
 | 
						|
				charge of the thermal management.
 | 
						|
 | 
						|
		RW, Optional
 | 
						|
 | 
						|
What:		/sys/class/thermal/thermal_zoneX/policy
 | 
						|
Description:
 | 
						|
		One of the various thermal governors used for a particular zone.
 | 
						|
 | 
						|
		RW, Required
 | 
						|
 | 
						|
What:		/sys/class/thermal/thermal_zoneX/available_policies
 | 
						|
Description:
 | 
						|
		Available thermal governors which can be used for a
 | 
						|
		particular zone.
 | 
						|
 | 
						|
		RO, Required
 | 
						|
 | 
						|
What:		/sys/class/thermal/thermal_zoneX/trip_point_Y_temp
 | 
						|
Description:
 | 
						|
		The temperature above which trip point will be fired.
 | 
						|
 | 
						|
		Unit: millidegree Celsius
 | 
						|
 | 
						|
		RO, Optional
 | 
						|
 | 
						|
What:		/sys/class/thermal/thermal_zoneX/trip_point_Y_type
 | 
						|
Description:
 | 
						|
		Strings which indicate the type of the trip point.
 | 
						|
 | 
						|
		E.g. it can be one of critical, hot, passive, `active[0-*]`
 | 
						|
		for ACPI thermal zone.
 | 
						|
 | 
						|
		RO, Optional
 | 
						|
 | 
						|
What:		/sys/class/thermal/thermal_zoneX/trip_point_Y_hyst
 | 
						|
Description:
 | 
						|
		The hysteresis value for a trip point, represented as an
 | 
						|
		integer.
 | 
						|
 | 
						|
		Unit: Celsius
 | 
						|
 | 
						|
		RW, Optional
 | 
						|
 | 
						|
What:		/sys/class/thermal/thermal_zoneX/cdevY
 | 
						|
Description:
 | 
						|
	Sysfs link to the thermal cooling device node where the sys I/F
 | 
						|
	for cooling device throttling control represents.
 | 
						|
 | 
						|
	RO, Optional
 | 
						|
 | 
						|
What:		/sys/class/thermal/thermal_zoneX/cdevY_trip_point
 | 
						|
Description:
 | 
						|
		The trip point in this thermal zone which `cdev[0-*]` is
 | 
						|
		associated with; -1 means the cooling device is not
 | 
						|
		associated with any trip point.
 | 
						|
 | 
						|
		RO, Optional
 | 
						|
 | 
						|
What:		/sys/class/thermal/thermal_zoneX/cdevY_weight
 | 
						|
Description:
 | 
						|
		The influence of `cdev[0-*]` in this thermal zone. This value
 | 
						|
		is relative to the rest of cooling devices in the thermal
 | 
						|
		zone. For example, if a cooling device has a weight double
 | 
						|
		than that of other, it's twice as effective in cooling the
 | 
						|
		thermal zone.
 | 
						|
 | 
						|
		RW, Optional
 | 
						|
 | 
						|
What:		/sys/class/thermal/thermal_zoneX/emul_temp
 | 
						|
Description:
 | 
						|
		Interface to set the emulated temperature method in thermal zone
 | 
						|
		(sensor). After setting this temperature, the thermal zone may
 | 
						|
		pass this temperature to platform emulation function if
 | 
						|
		registered or cache it locally. This is useful in debugging
 | 
						|
		different temperature threshold and its associated cooling
 | 
						|
		action. This is write only node and writing 0 on this node
 | 
						|
		should disable emulation.
 | 
						|
 | 
						|
		Unit: millidegree Celsius
 | 
						|
 | 
						|
		WO, Optional
 | 
						|
 | 
						|
		WARNING:
 | 
						|
		    Be careful while enabling this option on production systems,
 | 
						|
		    because userland can easily disable the thermal policy by simply
 | 
						|
		    flooding this sysfs node with low temperature values.
 | 
						|
 | 
						|
 | 
						|
What:		/sys/class/thermal/thermal_zoneX/k_d
 | 
						|
Description:
 | 
						|
		The derivative term of the power allocator governor's PID
 | 
						|
		controller. For more information see
 | 
						|
		Documentation/driver-api/thermal/power_allocator.rst
 | 
						|
 | 
						|
		RW, Optional
 | 
						|
 | 
						|
What:		/sys/class/thermal/thermal_zoneX/k_i
 | 
						|
Description:
 | 
						|
		The integral term of the power allocator governor's PID
 | 
						|
		controller. This term allows the PID controller to compensate
 | 
						|
		for long term drift. For more information see
 | 
						|
		Documentation/driver-api/thermal/power_allocator.rst
 | 
						|
 | 
						|
		RW, Optional
 | 
						|
 | 
						|
What:		/sys/class/thermal/thermal_zoneX/k_po
 | 
						|
Description:
 | 
						|
		The proportional term of the power allocator governor's PID
 | 
						|
		controller during temperature overshoot. Temperature overshoot
 | 
						|
		is when the current temperature is above the "desired
 | 
						|
		temperature" trip point. For more information see
 | 
						|
		Documentation/driver-api/thermal/power_allocator.rst
 | 
						|
 | 
						|
		RW, Optional
 | 
						|
 | 
						|
What:		/sys/class/thermal/thermal_zoneX/k_pu
 | 
						|
Description:
 | 
						|
		The proportional term of the power allocator governor's PID
 | 
						|
		controller during temperature undershoot. Temperature undershoot
 | 
						|
		is when the current temperature is below the "desired
 | 
						|
		temperature" trip point. For more information see
 | 
						|
		Documentation/driver-api/thermal/power_allocator.rst
 | 
						|
 | 
						|
		RW, Optional
 | 
						|
 | 
						|
What:		/sys/class/thermal/thermal_zoneX/integral_cutoff
 | 
						|
Description:
 | 
						|
		Temperature offset from the desired temperature trip point
 | 
						|
		above which the integral term of the power allocator
 | 
						|
		governor's PID controller starts accumulating errors. For
 | 
						|
		example, if integral_cutoff is 0, then the integral term only
 | 
						|
		accumulates error when temperature is above the desired
 | 
						|
		temperature trip point. For more information see
 | 
						|
		Documentation/driver-api/thermal/power_allocator.rst
 | 
						|
 | 
						|
		Unit: millidegree Celsius
 | 
						|
 | 
						|
		RW, Optional
 | 
						|
 | 
						|
What:		/sys/class/thermal/thermal_zoneX/slope
 | 
						|
Description:
 | 
						|
		The slope constant used in a linear extrapolation model
 | 
						|
		to determine a hotspot temperature based off the sensor's
 | 
						|
		raw readings. It is up to the device driver to determine
 | 
						|
		the usage of these values.
 | 
						|
 | 
						|
		RW, Optional
 | 
						|
 | 
						|
What:		/sys/class/thermal/thermal_zoneX/offset
 | 
						|
Description:
 | 
						|
		The offset constant used in a linear extrapolation model
 | 
						|
		to determine a hotspot temperature based off the sensor's
 | 
						|
		raw readings. It is up to the device driver to determine
 | 
						|
		the usage of these values.
 | 
						|
 | 
						|
		RW, Optional
 | 
						|
 | 
						|
What:		/sys/class/thermal/thermal_zoneX/sustainable_power
 | 
						|
Description:
 | 
						|
		An estimate of the sustained power that can be dissipated by
 | 
						|
		the thermal zone. Used by the power allocator governor. For
 | 
						|
		more information see
 | 
						|
		Documentation/driver-api/thermal/power_allocator.rst
 | 
						|
 | 
						|
		Unit: milliwatts
 | 
						|
 | 
						|
		RW, Optional
 | 
						|
 | 
						|
What:		/sys/class/thermal/cooling_deviceX/type
 | 
						|
Description:
 | 
						|
		String which represents the type of device, e.g:
 | 
						|
 | 
						|
		- for generic ACPI: should be "Fan", "Processor" or "LCD"
 | 
						|
		- for memory controller device on intel_menlow platform:
 | 
						|
		  should be "Memory controller".
 | 
						|
 | 
						|
		RO, Required
 | 
						|
 | 
						|
What:		/sys/class/thermal/cooling_deviceX/max_state
 | 
						|
Description:
 | 
						|
		The maximum permissible cooling state of this cooling device.
 | 
						|
 | 
						|
		RO, Required
 | 
						|
 | 
						|
What:		/sys/class/thermal/cooling_deviceX/cur_state
 | 
						|
Description:
 | 
						|
		The current cooling state of this cooling device.
 | 
						|
		The value can any integer numbers between 0 and max_state:
 | 
						|
 | 
						|
		- cur_state == 0 means no cooling
 | 
						|
		- cur_state == max_state means the maximum cooling.
 | 
						|
 | 
						|
		RW, Required
 | 
						|
 | 
						|
What:		/sys/class/thermal/cooling_deviceX/stats/reset
 | 
						|
Description:
 | 
						|
		Writing any value resets the cooling device's statistics.
 | 
						|
 | 
						|
		WO, Required
 | 
						|
 | 
						|
What:		/sys/class/thermal/cooling_deviceX/stats/time_in_state_ms:
 | 
						|
Description:
 | 
						|
		The amount of time spent by the cooling device in various
 | 
						|
		cooling states. The output will have "<state> <time>" pair
 | 
						|
		in each line, which will mean this cooling device spent <time>
 | 
						|
		msec of time at <state>.
 | 
						|
 | 
						|
		Output will have one line for each of the supported states.
 | 
						|
 | 
						|
		RO, Required
 | 
						|
 | 
						|
What:		/sys/class/thermal/cooling_deviceX/stats/total_trans
 | 
						|
Description:
 | 
						|
		A single positive value showing the total number of times
 | 
						|
		the state of a cooling device is changed.
 | 
						|
 | 
						|
		RO, Required
 | 
						|
 | 
						|
What:		/sys/class/thermal/cooling_deviceX/stats/trans_table
 | 
						|
Description:
 | 
						|
		This gives fine grained information about all the cooling state
 | 
						|
		transitions. The cat output here is a two dimensional matrix,
 | 
						|
		where an entry <i,j> (row i, column j) represents the number
 | 
						|
		of transitions from State_i to State_j. If the transition
 | 
						|
		table is bigger than PAGE_SIZE, reading this will return
 | 
						|
		an -EFBIG error.
 | 
						|
 | 
						|
		RO, Required
 |