Lines Matching refs:thermal
13 The generic thermal sysfs provides a set of interfaces for thermal zone
14 devices (sensors) and thermal cooling devices (fan, processor...) to register
15 with the thermal management solution and to be a part of it.
17 This how-to focuses on enabling new thermal zone and cooling devices to
18 participate in thermal management.
19 This solution is platform independent and any type of thermal zone devices
22 The main task of the thermal sysfs driver is to expose thermal zone attributes
24 An intelligent thermal management application can make decisions based on
25 inputs from thermal zone attributes (the current temperature and trip point
31 1. thermal sysfs driver interface functions
33 1.1 thermal zone device interface
40 This interface function adds a new thermal zone device (sensor) to
41 /sys/class/thermal folder as thermal_zone[0-*]. It tries to bind all the
42 thermal cooling devices registered at the same time.
44 type: the thermal zone type.
45 trips: the total number of trip points this thermal zone supports.
48 ops: thermal zone device call-backs.
49 .bind: bind the thermal zone device with a thermal cooling device.
50 .unbind: unbind the thermal zone device with a thermal cooling device.
51 .get_temp: get the current temperature of the thermal zone.
52 .get_mode: get the current mode (enabled/disabled) of the thermal zone.
53 - "enabled" means the kernel thermal management is enabled.
54 - "disabled" will prevent kernel thermal driver action upon trip points
55 so that user applications can take charge of thermal management.
56 .set_mode: set the mode (enabled/disabled) of the thermal zone.
62 tzp: thermal zone platform parameters.
71 This interface function removes the thermal zone device.
72 It deletes the corresponding entry form /sys/class/thermal folder and
73 unbind all the thermal cooling devices it uses.
75 1.2 thermal cooling device interface
79 This interface function adds a new thermal cooling device (fan/processor/...)
80 to /sys/class/thermal/ folder as cooling_device[0-*]. It tries to bind itself
81 to all the thermal zone devices register at the same time.
84 ops: thermal cooling devices call-backs.
91 This interface function remove the thermal cooling device.
92 It deletes the corresponding entry form /sys/class/thermal folder and
93 unbind itself from all the thermal zone devices using it.
95 1.3 interface for binding a thermal zone device with a thermal cooling device
100 This interface function bind a thermal cooling device to the certain trip
101 point of a thermal zone device.
102 This function is usually called in the thermal zone device .bind callback.
103 tz: the thermal zone device
104 cdev: thermal cooling device
106 in this thermal zone.
113 weight: the influence of this cooling device in this thermal
119 This interface function unbind a thermal cooling device from the certain
120 trip point of a thermal zone device. This function is usually called in
121 the thermal zone device .unbind callback.
122 tz: the thermal zone device
123 cdev: thermal cooling device
125 in this thermal zone.
142 this thermal zone and cdev, for a particular trip point.
143 If nth bit is set, then the cdev and thermal zone are bound
155 This structure defines the platform level parameters for a thermal zone.
156 This data, for each thermal zone should come from the platform layer.
159 .governor_name: Name of the thermal governor used for this zone
160 .no_hwmon: a boolean to indicate if the thermal to hwmon sysfs interface
173 Thermal sysfs attributes will be represented under /sys/class/thermal.
178 /sys/class/thermal/thermal_zone[0-*]:
179 |---type: Type of the thermal zone
181 |---mode: Working mode of the thermal zone
183 |---available_policies: Available thermal governors for this zone
198 /sys/class/thermal/cooling_device[0-*]:
205 the relationship between a thermal zone and its associated cooling device.
209 /sys/class/thermal/thermal_zone[0-*]:
210 |---cdev[0-*]: [0-*]th cooling device in current thermal zone
213 this thermal zone
215 Besides the thermal zone device sysfs I/F and cooling device sysfs I/F,
216 the generic thermal driver also creates a hwmon sysfs I/F for each _type_
217 of thermal zone device. E.g. the generic thermal driver registers one hwmon
219 ACPI thermal zones.
222 |---name: The type of the thermal zone devices
223 |---temp[1-*]_input: The current temperature of thermal zone [1-*]
224 |---temp[1-*]_critical: The critical trip point of thermal zone [1-*]
233 Strings which represent the thermal zone type.
234 This is given by thermal zone driver as part of registration.
235 E.g: "acpitz" indicates it's an ACPI thermal device.
241 Current temperature as reported by thermal zone (sensor).
248 managing the thermal zone. It can be either default kernel based
251 disabled = Preventing kernel thermal zone driver actions upon
253 charge of the thermal management.
257 One of the various thermal governors used for a particular zone.
261 Available thermal governors which can be used for a particular zone.
272 thermal zone.
281 Sysfs link to the thermal cooling device node where the sys I/F
286 The trip point with which cdev[0-*] is associated in this thermal
292 The influence of cdev[0-*] in this thermal zone. This value
293 is relative to the rest of cooling devices in the thermal
296 thermal zone.
301 policy is not supported by native thermal driver. Default is zero
310 Interface to set the emulated temperature method in thermal zone
311 (sensor). After setting this temperature, the thermal zone may pass
320 because userland can easily disable the thermal policy by simply
325 the thermal zone. Used by the power allocator governor. For
326 more information see Documentation/thermal/power_allocator.txt
335 Documentation/thermal/power_allocator.txt
343 Documentation/thermal/power_allocator.txt
350 Documentation/thermal/power_allocator.txt
356 Documentation/thermal/power_allocator.txt
366 Documentation/thermal/power_allocator.txt
407 ACPI thermal zone may support multiple trip points like critical, hot,
408 passive, active. If an ACPI thermal zone supports critical, passive,
413 effectiveness in cooling the thermal zone.
418 /sys/class/thermal:
434 |---cdev0: --->/sys/class/thermal/cooling_device0
437 |---cdev1: --->/sys/class/thermal/cooling_device3
466 thermal zone device will be used in the message to identify the zone. The
474 This function returns the trend of a thermal zone, i.e the rate of change
475 of temperature of the thermal zone. Ideally, the thermal sensor drivers
476 are supposed to implement the callback. If they don't, the thermal