Merge tag 'for-linus-20190125' of git://git.kernel.dk/linux-block
[sfrench/cifs-2.6.git] / Documentation / devicetree / bindings / thermal / rcar-gen3-thermal.txt
1 * DT bindings for Renesas R-Car Gen3 Thermal Sensor driver
2
3 On R-Car Gen3 SoCs, the thermal sensor controllers (TSC) control the thermal
4 sensors (THS) which are the analog circuits for measuring temperature (Tj)
5 inside the LSI.
6
7 Required properties:
8 - compatible            : "renesas,<soctype>-thermal",
9                           Examples with soctypes are:
10                             - "renesas,r8a774a1-thermal" (RZ/G2M)
11                             - "renesas,r8a7795-thermal" (R-Car H3)
12                             - "renesas,r8a7796-thermal" (R-Car M3-W)
13                             - "renesas,r8a77965-thermal" (R-Car M3-N)
14                             - "renesas,r8a77980-thermal" (R-Car V3H)
15 - reg                   : Address ranges of the thermal registers. Each sensor
16                           needs one address range. Sorting must be done in
17                           increasing order according to datasheet, i.e.
18                           TSC1, TSC2, ...
19 - clocks                : Must contain a reference to the functional clock.
20 - #thermal-sensor-cells : must be <1>.
21
22 Optional properties:
23
24 - interrupts            : interrupts routed to the TSC (must be 3).
25 - power-domain          : Must contain a reference to the power domain. This
26                           property is mandatory if the thermal sensor instance
27                           is part of a controllable power domain.
28
29 Example:
30
31         tsc: thermal@e6198000 {
32                 compatible = "renesas,r8a7795-thermal";
33                 reg = <0 0xe6198000 0 0x100>,
34                       <0 0xe61a0000 0 0x100>,
35                       <0 0xe61a8000 0 0x100>;
36                 interrupts = <GIC_SPI 67 IRQ_TYPE_LEVEL_HIGH>,
37                              <GIC_SPI 68 IRQ_TYPE_LEVEL_HIGH>,
38                              <GIC_SPI 69 IRQ_TYPE_LEVEL_HIGH>;
39                 clocks = <&cpg CPG_MOD 522>;
40                 power-domains = <&sysc R8A7795_PD_ALWAYS_ON>;
41                 #thermal-sensor-cells = <1>;
42         };
43
44         thermal-zones {
45                 sensor_thermal1: sensor-thermal1 {
46                         polling-delay-passive = <250>;
47                         polling-delay = <1000>;
48                         thermal-sensors = <&tsc 0>;
49
50                         trips {
51                                 sensor1_crit: sensor1-crit {
52                                         temperature = <90000>;
53                                         hysteresis = <2000>;
54                                         type = "critical";
55                                 };
56                         };
57                 };
58         };