Documentation/devicetree/bindings/opp/ti,omap-opp-supply.yaml

Source file repositories/reference/linux-study-clean/Documentation/devicetree/bindings/opp/ti,omap-opp-supply.yaml

File Facts

System
Linux kernel
Corpus path
Documentation/devicetree/bindings/opp/ti,omap-opp-supply.yaml
Extension
.yaml
Size
3059 bytes
Lines
102
Domain
Support Tooling And Documentation
Bucket
Documentation
Inferred role
Support Tooling And Documentation: configuration, schema, or hardware description
Status
atlas-only

Why This File Exists

Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.

Dependency Surface

Detected Declarations

Annotated Snippet

# 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

Annotation

Implementation Notes