Merge tag 'iommu-updates-v4.18' of git://git.kernel.org/pub/scm/linux/kernel/git...
[platform/kernel/linux-starfive.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,r8a7795-thermal" (R-Car H3)
11                             - "renesas,r8a7796-thermal" (R-Car M3-W)
12 - reg                   : Address ranges of the thermal registers. Each sensor
13                           needs one address range. Sorting must be done in
14                           increasing order according to datasheet, i.e.
15                           TSC1, TSC2, ...
16 - clocks                : Must contain a reference to the functional clock.
17 - #thermal-sensor-cells : must be <1>.
18
19 Optional properties:
20
21 - interrupts           : interrupts routed to the TSC (3 for H3 and M3-W)
22 - power-domain          : Must contain a reference to the power domain. This
23                           property is mandatory if the thermal sensor instance
24                           is part of a controllable power domain.
25
26 Example:
27
28         tsc: thermal@e6198000 {
29                 compatible = "renesas,r8a7795-thermal";
30                 reg = <0 0xe6198000 0 0x100>,
31                       <0 0xe61a0000 0 0x100>,
32                       <0 0xe61a8000 0 0x100>;
33                 interrupts = <GIC_SPI 67 IRQ_TYPE_LEVEL_HIGH>,
34                              <GIC_SPI 68 IRQ_TYPE_LEVEL_HIGH>,
35                              <GIC_SPI 69 IRQ_TYPE_LEVEL_HIGH>;
36                 clocks = <&cpg CPG_MOD 522>;
37                 power-domains = <&sysc R8A7795_PD_ALWAYS_ON>;
38                 #thermal-sensor-cells = <1>;
39         };
40
41         thermal-zones {
42                 sensor_thermal1: sensor-thermal1 {
43                         polling-delay-passive = <250>;
44                         polling-delay = <1000>;
45                         thermal-sensors = <&tsc 0>;
46
47                         trips {
48                                 sensor1_crit: sensor1-crit {
49                                         temperature = <90000>;
50                                         hysteresis = <2000>;
51                                         type = "critical";
52                                 };
53                         };
54                 };
55         };