102 lines · yaml
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)2%YAML 1.23---4$id: http://devicetree.org/schemas/opp/ti,omap-opp-supply.yaml#5$schema: http://devicetree.org/meta-schemas/core.yaml#6 7title: Texas Instruments OMAP compatible OPP supply8 9description:10 OMAP5, DRA7, and AM57 families of SoCs have Class 0 AVS eFuse11 registers, which contain OPP-specific voltage information tailored12 for the specific device. This binding provides the information13 needed to describe such a hardware values and relate them to program14 the primary regulator during an OPP transition.15 16 Also, some supplies may have an associated vbb-supply, an Adaptive17 Body Bias regulator, which must transition in a specific sequence18 w.r.t the vdd-supply and clk when making an OPP transition. By19 supplying two regulators to the device that will undergo OPP20 transitions, we can use the multi-regulator support implemented by21 the OPP core to describe both regulators the platform needs. The22 OPP core binding Documentation/devicetree/bindings/opp/opp-v2.yaml23 provides further information (refer to Example 4 Handling multiple24 regulators).25 26maintainers:27 - Nishanth Menon <nm@ti.com>28 29properties:30 $nodename:31 pattern: '^opp-supply(@[0-9a-f]+)?$'32 33 compatible:34 oneOf:35 - description: Basic OPP supply controlling VDD and VBB36 const: ti,omap-opp-supply37 - description: OMAP5+ optimized voltages in efuse(Class 0) VDD along with38 VBB.39 const: ti,omap5-opp-supply40 - description: OMAP5+ optimized voltages in efuse(class0) VDD but no VBB41 const: ti,omap5-core-opp-supply42 43 reg:44 maxItems: 145 46 ti,absolute-max-voltage-uv:47 $ref: /schemas/types.yaml#/definitions/uint3248 description: Absolute maximum voltage for the OPP supply in micro-volts.49 minimum: 75000050 maximum: 150000051 52 ti,efuse-settings:53 description: An array of u32 tuple items providing information about54 optimized efuse configuration.55 minItems: 156 $ref: /schemas/types.yaml#/definitions/uint32-matrix57 items:58 items:59 - description: Reference voltage in micro-volts (OPP Voltage)60 minimum: 75000061 maximum: 150000062 multipleOf: 1000063 - description: efuse offset where the optimized voltage is located64 multipleOf: 465 maximum: 25666 67required:68 - compatible69 - ti,absolute-max-voltage-uv70 71allOf:72 - if:73 not:74 properties:75 compatible:76 contains:77 const: ti,omap-opp-supply78 then:79 required:80 - reg81 - ti,efuse-settings82 83additionalProperties: false84 85examples:86 - |87 opp-supply {88 compatible = "ti,omap-opp-supply";89 ti,absolute-max-voltage-uv = <1375000>;90 };91 - |92 opp-supply@4a003b20 {93 compatible = "ti,omap5-opp-supply";94 reg = <0x4a003b20 0x8>;95 ti,efuse-settings =96 /* uV offset */97 <1060000 0x0>,98 <1160000 0x4>,99 <1210000 0x8>;100 ti,absolute-max-voltage-uv = <1500000>;101 };102