Documentation/devicetree/bindings/thermal/rcar-gen3-thermal.yaml

   1 # SPDX-License-Identifier: GPL-2.0-only
   2 # Copyright (C) 2020 Renesas Electronics Corp.
   3 %YAML 1.2
   4 ---
   5 $id: http://devicetree.org/schemas/thermal/rcar-gen3-thermal.yaml#
   6 $schema: http://devicetree.org/meta-schemas/core.yaml#
   7
   8 title: Renesas R-Car Gen3 Thermal Sensor
   9
  10 description:
  11   On R-Car Gen3 SoCs, the thermal sensor controllers (TSC) control the thermal
  12   sensors (THS) which are the analog circuits for measuring temperature (Tj)
  13   inside the LSI.
  14
  15 maintainers:
  16   - Niklas Söderlund <niklas.soderlund@ragnatech.se>
  17
  18 properties:
  19   compatible:
  20     enum:
  21       - renesas,r8a774a1-thermal # RZ/G2M
  22       - renesas,r8a774b1-thermal # RZ/G2N
  23       - renesas,r8a774e1-thermal # RZ/G2H
  24       - renesas,r8a7795-thermal  # R-Car H3
  25       - renesas,r8a7796-thermal  # R-Car M3-W
  26       - renesas,r8a77961-thermal # R-Car M3-W+
  27       - renesas,r8a77965-thermal # R-Car M3-N
  28       - renesas,r8a77980-thermal # R-Car V3H
  29       - renesas,r8a779a0-thermal # R-Car V3U
  30
  31   reg:
  32     minItems: 2
  33     maxItems: 4
  34     items:
  35       - description: TSC1 registers
  36       - description: TSC2 registers
  37       - description: TSC3 registers
  38       - description: TSC4 registers
  39
  40   interrupts:
  41     items:
  42       - description: TEMP1 interrupt
  43       - description: TEMP2 interrupt
  44       - description: TEMP3 interrupt
  45
  46   clocks:
  47     maxItems: 1
  48
  49   power-domains:
  50     maxItems: 1
  51
  52   resets:
  53     maxItems: 1
  54
  55   "#thermal-sensor-cells":
  56     const: 1
  57
  58 required:
  59   - compatible
  60   - reg
  61   - clocks
  62   - power-domains
  63   - resets
  64   - "#thermal-sensor-cells"
  65
  66 if:
  67   not:
  68     properties:
  69       compatible:
  70         contains:
  71           enum:
  72             - renesas,r8a779a0-thermal
  73 then:
  74   required:
  75     - interrupts
  76
  77 additionalProperties: false
  78
  79 examples:
  80   - |
  81     #include <dt-bindings/clock/r8a7795-cpg-mssr.h>
  82     #include <dt-bindings/interrupt-controller/arm-gic.h>
  83     #include <dt-bindings/power/r8a7795-sysc.h>
  84
  85     tsc: thermal@e6198000 {
  86             compatible = "renesas,r8a7795-thermal";
  87             reg = <0xe6198000 0x100>,
  88                   <0xe61a0000 0x100>,
  89                   <0xe61a8000 0x100>;
  90             interrupts = <GIC_SPI 67 IRQ_TYPE_LEVEL_HIGH>,
  91                          <GIC_SPI 68 IRQ_TYPE_LEVEL_HIGH>,
  92                          <GIC_SPI 69 IRQ_TYPE_LEVEL_HIGH>;
  93             clocks = <&cpg CPG_MOD 522>;
  94             power-domains = <&sysc R8A7795_PD_ALWAYS_ON>;
  95             resets = <&cpg 522>;
  96             #thermal-sensor-cells = <1>;
  97     };
  98
  99     thermal-zones {
 100             sensor_thermal: sensor-thermal {
 101                     polling-delay-passive = <250>;
 102                     polling-delay = <1000>;
 103                     thermal-sensors = <&tsc 0>;
 104
 105                     trips {
 106                             sensor1_crit: sensor1-crit {
 107                                     temperature = <90000>;
 108                                     hysteresis = <2000>;
 109                                     type = "critical";
 110                             };
 111                     };
 112             };
 113     };