1 # SPDX-License-Identifier: (GPL-2.0-only OR BS 1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2 %YAML 1.2 2 %YAML 1.2
3 --- 3 ---
4 $id: http://devicetree.org/schemas/opp/ti,omap 4 $id: http://devicetree.org/schemas/opp/ti,omap-opp-supply.yaml#
5 $schema: http://devicetree.org/meta-schemas/co 5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6 6
7 title: Texas Instruments OMAP compatible OPP s 7 title: Texas Instruments OMAP compatible OPP supply
8 8
9 description: 9 description:
10 OMAP5, DRA7, and AM57 families of SoCs have 10 OMAP5, DRA7, and AM57 families of SoCs have Class 0 AVS eFuse
11 registers, which contain OPP-specific voltag 11 registers, which contain OPP-specific voltage information tailored
12 for the specific device. This binding provid 12 for the specific device. This binding provides the information
13 needed to describe such a hardware values an 13 needed to describe such a hardware values and relate them to program
14 the primary regulator during an OPP transiti 14 the primary regulator during an OPP transition.
15 15
16 Also, some supplies may have an associated v 16 Also, some supplies may have an associated vbb-supply, an Adaptive
17 Body Bias regulator, which must transition i 17 Body Bias regulator, which must transition in a specific sequence
18 w.r.t the vdd-supply and clk when making an 18 w.r.t the vdd-supply and clk when making an OPP transition. By
19 supplying two regulators to the device that 19 supplying two regulators to the device that will undergo OPP
20 transitions, we can use the multi-regulator 20 transitions, we can use the multi-regulator support implemented by
21 the OPP core to describe both regulators the 21 the OPP core to describe both regulators the platform needs. The
22 OPP core binding Documentation/devicetree/bi 22 OPP core binding Documentation/devicetree/bindings/opp/opp-v2.yaml
23 provides further information (refer to Examp 23 provides further information (refer to Example 4 Handling multiple
24 regulators). 24 regulators).
25 25
26 maintainers: 26 maintainers:
27 - Nishanth Menon <nm@ti.com> 27 - Nishanth Menon <nm@ti.com>
28 28
29 properties: 29 properties:
30 $nodename: 30 $nodename:
31 pattern: '^opp-supply(@[0-9a-f]+)?$' 31 pattern: '^opp-supply(@[0-9a-f]+)?$'
32 32
33 compatible: 33 compatible:
34 oneOf: 34 oneOf:
35 - description: Basic OPP supply controll 35 - description: Basic OPP supply controlling VDD and VBB
36 const: ti,omap-opp-supply 36 const: ti,omap-opp-supply
37 - description: OMAP5+ optimized voltages 37 - description: OMAP5+ optimized voltages in efuse(Class 0) VDD along with
38 VBB. 38 VBB.
39 const: ti,omap5-opp-supply 39 const: ti,omap5-opp-supply
40 - description: OMAP5+ optimized voltages 40 - description: OMAP5+ optimized voltages in efuse(class0) VDD but no VBB
41 const: ti,omap5-core-opp-supply 41 const: ti,omap5-core-opp-supply
42 42
43 reg: 43 reg:
44 maxItems: 1 44 maxItems: 1
45 45
46 ti,absolute-max-voltage-uv: 46 ti,absolute-max-voltage-uv:
47 $ref: /schemas/types.yaml#/definitions/uin 47 $ref: /schemas/types.yaml#/definitions/uint32
48 description: Absolute maximum voltage for 48 description: Absolute maximum voltage for the OPP supply in micro-volts.
49 minimum: 750000 49 minimum: 750000
50 maximum: 1500000 50 maximum: 1500000
51 51
52 ti,efuse-settings: 52 ti,efuse-settings:
53 description: An array of u32 tuple items p 53 description: An array of u32 tuple items providing information about
54 optimized efuse configuration. 54 optimized efuse configuration.
55 minItems: 1 55 minItems: 1
56 $ref: /schemas/types.yaml#/definitions/uin 56 $ref: /schemas/types.yaml#/definitions/uint32-matrix
57 items: 57 items:
58 items: 58 items:
59 - description: Reference voltage in mi 59 - description: Reference voltage in micro-volts (OPP Voltage)
60 minimum: 750000 60 minimum: 750000
61 maximum: 1500000 61 maximum: 1500000
62 multipleOf: 10000 62 multipleOf: 10000
63 - description: efuse offset where the 63 - description: efuse offset where the optimized voltage is located
64 multipleOf: 4 64 multipleOf: 4
65 maximum: 256 65 maximum: 256
66 66
67 required: 67 required:
68 - compatible 68 - compatible
69 - ti,absolute-max-voltage-uv 69 - ti,absolute-max-voltage-uv
70 70
71 allOf: 71 allOf:
72 - if: 72 - if:
73 not: 73 not:
74 properties: 74 properties:
75 compatible: 75 compatible:
76 contains: 76 contains:
77 const: ti,omap-opp-supply 77 const: ti,omap-opp-supply
78 then: 78 then:
79 required: 79 required:
80 - reg 80 - reg
81 - ti,efuse-settings 81 - ti,efuse-settings
82 82
83 additionalProperties: false 83 additionalProperties: false
84 84
85 examples: 85 examples:
86 - | 86 - |
87 opp-supply { 87 opp-supply {
88 compatible = "ti,omap-opp-supply"; 88 compatible = "ti,omap-opp-supply";
89 ti,absolute-max-voltage-uv = <1375000> 89 ti,absolute-max-voltage-uv = <1375000>;
90 }; 90 };
91 - | 91 - |
92 opp-supply@4a003b20 { 92 opp-supply@4a003b20 {
93 compatible = "ti,omap5-opp-supply"; 93 compatible = "ti,omap5-opp-supply";
94 reg = <0x4a003b20 0x8>; 94 reg = <0x4a003b20 0x8>;
95 ti,efuse-settings = 95 ti,efuse-settings =
96 /* uV offset */ 96 /* uV offset */
97 <1060000 0x0>, 97 <1060000 0x0>,
98 <1160000 0x4>, 98 <1160000 0x4>,
99 <1210000 0x8>; 99 <1210000 0x8>;
100 ti,absolute-max-voltage-uv = <1500000> 100 ti,absolute-max-voltage-uv = <1500000>;
101 }; 101 };
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.