xref: /linux/Documentation/devicetree/bindings/thermal/qcom,pm8775-mbg-tm.yaml (revision b81e34131907d2c243c51117a4aff8dbe22ccc9c) 
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/thermal/qcom,pm8775-mbg-tm.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Qualcomm's SPMI PMIC MBG Thermal Monitoring
8
9maintainers:
10  - Jishnu Prakash <jishnu.prakash@oss.qualcomm.com>
11  - Kamal Wadhwa <kamal.wadhwa@oss.qualcomm.com>
12
13description:
14  Qualcomm's MBG(Master Bandgap) temperature alarm monitors the die
15  temperature and generates an interrupt if the PMIC die temperature is
16  over a set of programmable temperature thresholds. It allows monitoring
17  for both hot and cold, LVL1 and LVL2 thresholds, which makes it different
18  from the existing temp alarm peripheral. The interrupt comes over SPMI
19  and the MBG's fault status register gives details to understand whether
20  it is a hot/cold and LVL1/LVL2 violation.
21
22properties:
23  compatible:
24    const: qcom,pm8775-mbg-tm
25
26  reg:
27    maxItems: 1
28
29  interrupts:
30    maxItems: 1
31
32  io-channels:
33    items:
34      - description: ADC channel, which reports chip die temperature.
35
36  io-channel-names:
37    items:
38      - const: thermal
39
40  '#thermal-sensor-cells':
41    const: 0
42
43required:
44  - compatible
45  - reg
46  - interrupts
47  - io-channels
48  - io-channel-names
49
50allOf:
51  - $ref: thermal-sensor.yaml#
52
53unevaluatedProperties: false
54
55examples:
56  - |
57    #include <dt-bindings/interrupt-controller/irq.h>
58
59    pmic {
60        #address-cells = <1>;
61        #size-cells = <0>;
62
63        temperature-sensor@d700 {
64            compatible = "qcom,pm8775-mbg-tm";
65            reg = <0xd700>;
66            interrupts = <0x1 0xd7 0x0 IRQ_TYPE_EDGE_RISING>;
67            io-channels = <&pm8775_adc 0x3>;
68            io-channel-names = "thermal";
69            #thermal-sensor-cells = <0>;
70        };
71    };
72...
73