driver-api/thermal/sysfs-api.rst

15 The generic thermal sysfs provides a set of interfaces for thermal zone
19 This how-to focuses on enabling new thermal zone and cooling devices to
21 This solution is platform independent and any type of thermal zone devices
24 The main task of the thermal sysfs driver is to expose thermal zone attributes
27 inputs from thermal zone attributes (the current temperature and trip point
36 1.1 thermal zone device interface
48     This interface function adds a new thermal zone device (sensor) to
53 	the thermal zone type.
55 	the total number of trip points this thermal zone supports.
61 	thermal zone device call-backs.
64 		bind the thermal zone device with a thermal cooling device.
66 		unbind the thermal zone device with a thermal cooling device.
68 		get the current temperature of the thermal zone.
74 		   get the current mode (enabled/disabled) of the thermal zone.
82 		set the mode (enabled/disabled) of the thermal zone.
92 	thermal zone platform parameters.
104     This interface function removes the thermal zone device.
115 	This interface adds a new sensor to a DT thermal zone.
117 	device tree and look for the zone that refer to the sensor device
118 	pointed by dev->of_node as temperature providers. For the zone
120 	thermal zone device.
150 	The thermal zone temperature is provided by the get_temp() function
154 	It returns error pointer if fails otherwise valid thermal zone device
163 	This interface unregisters a sensor from a DT thermal zone which was
166 	thermal zone device registered with thermal_zone_of_sensor_register()
167 	interface. It will also silent the zone by remove the .get_temp() and
168 	get_trend() thermal zone device callbacks.
206 	for the thermal zone device, which might be useful for platform
214 	for the thermal zone device, which might be useful for platform
229     to all the thermal zone devices registered at the same time.
252     unbinds itself from all the thermal zone devices using it.
254 1.3 interface for binding a thermal zone device with a thermal cooling device
264     point of a thermal zone device.
266     This function is usually called in the thermal zone device .bind callback.
269 	  the thermal zone device
273 	  indicates which trip point in this thermal zone the cooling device
285 	  zone.  See 1.4.1 below for more information.
293     trip point of a thermal zone device. This function is usually called in
294     the thermal zone device .unbind callback.
297 	the thermal zone device
301 	indicates which trip point in this thermal zone the cooling device
304 1.4 Thermal Zone Parameters
311     This structure defines the platform level parameters for a thermal zone.
312     This data, for each thermal zone should come from the platform layer.
317 	       Name of the thermal governor used for this zone
338 Thermal zone device sys I/F, created once it's registered::
341     |---type:			Type of the thermal zone
343     |---mode:			Working mode of the thermal zone
344     |---policy:			Thermal governor used for this zone
345     |---available_policies:	Available thermal governors for this zone
373 the relationship between a thermal zone and its associated cooling device.
380     |---cdev[0-*]:		[0-*]th cooling device in current thermal zone
383 				this thermal zone
385 Besides the thermal zone device sysfs I/F and cooling device sysfs I/F,
387 of thermal zone device. E.g. the generic thermal driver registers one hwmon
392 zone and cooling device attribute details.
397     |---name:			The type of the thermal zone devices
398     |---temp[1-*]_input:	The current temperature of thermal zone [1-*]
399     |---temp[1-*]_critical:	The critical trip point of thermal zone [1-*]
406 ACPI thermal zone may support multiple trip points like critical, hot,
407 passive, active. If an ACPI thermal zone supports critical, passive,
412 effectiveness in cooling the thermal zone.
461 This function returns the trend of a thermal zone, i.e the rate of change
462 of temperature of the thermal zone. Ideally, the thermal sensor drivers