xref: /linux/Documentation/devicetree/bindings/thermal/qoriq-thermal.yaml (revision c532de5a67a70f8533d495f8f2aaa9a0491c3ad0) 
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/thermal/qoriq-thermal.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Thermal Monitoring Unit (TMU) on Freescale QorIQ SoCs
8
9maintainers:
10  - Shawn Guo <shawnguo@kernel.org>
11  - Sascha Hauer <s.hauer@pengutronix.de>
12  - Fabio Estevam <festevam@gmail.com>
13
14$ref: thermal-sensor.yaml#
15
16properties:
17  compatible:
18    description: |
19      The version of the device is determined by the TMU IP Block Revision
20      Register (IPBRR0) at offset 0x0BF8.
21      Table of correspondences between IPBRR0 values and example chips:
22            Value           Device
23            ----------      -----
24            0x01900102      T1040
25    enum:
26      - fsl,qoriq-tmu
27      - fsl,imx8mq-tmu
28
29  reg:
30    maxItems: 1
31
32  interrupts:
33    maxItems: 1
34
35  fsl,tmu-range:
36    $ref: /schemas/types.yaml#/definitions/uint32-array
37    description: |
38      The values to be programmed into TTRnCR, as specified by the SoC
39      reference manual. The first cell is TTR0CR, the second is TTR1CR, etc.
40    minItems: 2
41    maxItems: 7
42
43  fsl,tmu-calibration:
44    $ref: /schemas/types.yaml#/definitions/uint32-matrix
45    description: |
46      A list of cell pairs containing temperature calibration data, as
47      specified by the SoC reference manual. The first cell of each pair
48      is the value to be written to TTCFGR, and the second is the value
49      to be written to TSCFGR.
50    items:
51      items:
52        - description: value for TTCFGR
53        - description: value for TSCFGR
54    minItems: 1
55    maxItems: 64
56
57  little-endian:
58    description: |
59      boolean, if present, the TMU registers are little endian. If absent,
60      the default is big endian.
61    type: boolean
62
63  clocks:
64    maxItems: 1
65
66  "#thermal-sensor-cells":
67    const: 1
68
69required:
70  - compatible
71  - reg
72  - interrupts
73  - fsl,tmu-range
74  - fsl,tmu-calibration
75
76unevaluatedProperties: false
77
78examples:
79  - |
80    tmu@f0000 {
81        compatible = "fsl,qoriq-tmu";
82        reg = <0xf0000 0x1000>;
83        interrupts = <18 2 0 0>;
84        fsl,tmu-range = <0x000a0000 0x00090026 0x0008004a 0x0001006a>;
85        fsl,tmu-calibration = <0x00000000 0x00000025>,
86                              <0x00000001 0x00000028>,
87                              <0x00000002 0x0000002d>,
88                              <0x00000003 0x00000031>,
89                              <0x00000004 0x00000036>,
90                              <0x00000005 0x0000003a>,
91                              <0x00000006 0x00000040>,
92                              <0x00000007 0x00000044>,
93                              <0x00000008 0x0000004a>,
94                              <0x00000009 0x0000004f>,
95                              <0x0000000a 0x00000054>,
96                              <0x00010000 0x0000000d>,
97                              <0x00010001 0x00000013>,
98                              <0x00010002 0x00000019>,
99                              <0x00010003 0x0000001f>,
100                              <0x00010004 0x00000025>,
101                              <0x00010005 0x0000002d>,
102                              <0x00010006 0x00000033>,
103                              <0x00010007 0x00000043>,
104                              <0x00010008 0x0000004b>,
105                              <0x00010009 0x00000053>,
106                              <0x00020000 0x00000010>,
107                              <0x00020001 0x00000017>,
108                              <0x00020002 0x0000001f>,
109                              <0x00020003 0x00000029>,
110                              <0x00020004 0x00000031>,
111                              <0x00020005 0x0000003c>,
112                              <0x00020006 0x00000042>,
113                              <0x00020007 0x0000004d>,
114                              <0x00020008 0x00000056>,
115                              <0x00030000 0x00000012>,
116                              <0x00030001 0x0000001d>;
117        #thermal-sensor-cells = <1>;
118    };
119