[PATCH 04/11] Doc: thermal: new irq-mode for trip point

From: Lukasz Luba
Date: Tue Oct 16 2018 - 10:57:41 EST

Thermal trip point gets new flag in DT: irq-mode.
Trip point may have a new explicit flag which indicate
irq support when the temperature is met (so the thermal framework
deos not need set polling for it).
It is useful for 'passive' cooling trip point,
which now will not be register for polling the temperature.

Update documentation about irq-mode for trip points.
The new sysfs file shows 1 if the trip point supports irq.

Cc: Jonathan Corbet <corbet@xxxxxxx>
Cc: Zhang Rui <rui.zhang@xxxxxxxxx>
Cc: linux-doc@xxxxxxxxxxxxxxx
Signed-off-by: Lukasz Luba <l.luba@xxxxxxxxxxxxxxxxxxx>
Documentation/thermal/sysfs-api.txt | 9 +++++++++
1 file changed, 9 insertions(+)

diff --git a/Documentation/thermal/sysfs-api.txt b/Documentation/thermal/sysfs-api.txt
index 9113997..e405724 100644
--- a/Documentation/thermal/sysfs-api.txt
+++ b/Documentation/thermal/sysfs-api.txt
@@ -272,6 +272,7 @@ Thermal zone device sys I/F, created once it's registered:
|---trip_point_[0-*]_temp: Trip point temperature
|---trip_point_[0-*]_type: Trip point type
|---trip_point_[0-*]_hyst: Hysteresis value for this trip point
+ |---trip_point_[0-*]_irq: Trip point supports triggering irq
|---emul_temp: Emulated temperature set node
|---sustainable_power: Sustainable dissipatable power
|---k_po: Proportional term during temperature overshoot
@@ -365,6 +366,10 @@ trip_point_[0-*]_type
thermal zone.
RO, Optional

+ Boolean which indicate that the trip point triggers irq.
+ RO, Optional
The hysteresis value for a trip point, represented as an integer
Unit: Celsius
@@ -544,12 +549,16 @@ method, the sys I/F structure will be built like this:
|---available_policies: step_wise fair_share
|---trip_point_0_temp: 100000
|---trip_point_0_type: critical
+ |---trip_point_0_irq: 1
|---trip_point_1_temp: 80000
|---trip_point_1_type: passive
+ |---trip_point_1_irq: 1
|---trip_point_2_temp: 70000
|---trip_point_2_type: active0
+ |---trip_point_2_irq: 0
|---trip_point_3_temp: 60000
|---trip_point_3_type: active1
+ |---trip_point_3_irq: 1
|---cdev0: --->/sys/class/thermal/cooling_device0
|---cdev0_trip_point: 1 /* cdev0 can be used for passive */
|---cdev0_weight: 1024