101 lines
3 KiB
YAML
101 lines
3 KiB
YAML
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
|
|
%YAML 1.2
|
|
---
|
|
$id: http://devicetree.org/schemas/opp/ti,omap-opp-supply.yaml#
|
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
|
|
|
title: Texas Instruments OMAP compatible OPP supply
|
|
|
|
description:
|
|
OMAP5, DRA7, and AM57 families of SoCs have Class 0 AVS eFuse
|
|
registers, which contain OPP-specific voltage information tailored
|
|
for the specific device. This binding provides the information
|
|
needed to describe such a hardware values and relate them to program
|
|
the primary regulator during an OPP transition.
|
|
|
|
Also, some supplies may have an associated vbb-supply, an Adaptive
|
|
Body Bias regulator, which must transition in a specific sequence
|
|
w.r.t the vdd-supply and clk when making an OPP transition. By
|
|
supplying two regulators to the device that will undergo OPP
|
|
transitions, we can use the multi-regulator support implemented by
|
|
the OPP core to describe both regulators the platform needs. The
|
|
OPP core binding Documentation/devicetree/bindings/opp/opp-v2.yaml
|
|
provides further information (refer to Example 4 Handling multiple
|
|
regulators).
|
|
|
|
maintainers:
|
|
- Nishanth Menon <nm@ti.com>
|
|
|
|
properties:
|
|
$nodename:
|
|
pattern: '^opp-supply(@[0-9a-f]+)?$'
|
|
|
|
compatible:
|
|
oneOf:
|
|
- description: Basic OPP supply controlling VDD and VBB
|
|
const: ti,omap-opp-supply
|
|
- description: OMAP5+ optimized voltages in efuse(Class 0) VDD along with
|
|
VBB.
|
|
const: ti,omap5-opp-supply
|
|
- description: OMAP5+ optimized voltages in efuse(class0) VDD but no VBB
|
|
const: ti,omap5-core-opp-supply
|
|
|
|
reg:
|
|
maxItems: 1
|
|
|
|
ti,absolute-max-voltage-uv:
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
description: Absolute maximum voltage for the OPP supply in micro-volts.
|
|
minimum: 750000
|
|
maximum: 1500000
|
|
|
|
ti,efuse-settings:
|
|
description: An array of u32 tuple items providing information about
|
|
optimized efuse configuration.
|
|
minItems: 1
|
|
$ref: /schemas/types.yaml#/definitions/uint32-matrix
|
|
items:
|
|
items:
|
|
- description: Reference voltage in micro-volts (OPP Voltage)
|
|
minimum: 750000
|
|
maximum: 1500000
|
|
multipleOf: 10000
|
|
- description: efuse offset where the optimized voltage is located
|
|
multipleOf: 4
|
|
maximum: 256
|
|
|
|
required:
|
|
- compatible
|
|
- ti,absolute-max-voltage-uv
|
|
|
|
allOf:
|
|
- if:
|
|
not:
|
|
properties:
|
|
compatible:
|
|
contains:
|
|
const: ti,omap-opp-supply
|
|
then:
|
|
required:
|
|
- reg
|
|
- ti,efuse-settings
|
|
|
|
additionalProperties: false
|
|
|
|
examples:
|
|
- |
|
|
opp-supply {
|
|
compatible = "ti,omap-opp-supply";
|
|
ti,absolute-max-voltage-uv = <1375000>;
|
|
};
|
|
- |
|
|
opp-supply@4a003b20 {
|
|
compatible = "ti,omap5-opp-supply";
|
|
reg = <0x4a003b20 0x8>;
|
|
ti,efuse-settings =
|
|
/* uV offset */
|
|
<1060000 0x0>,
|
|
<1160000 0x4>,
|
|
<1210000 0x8>;
|
|
ti,absolute-max-voltage-uv = <1500000>;
|
|
};
|