Documentation/devicetree/bindings/opp/opp-v2-qcom-adreno.yaml

Source file repositories/reference/linux-study-clean/Documentation/devicetree/bindings/opp/opp-v2-qcom-adreno.yaml

File Facts

System
Linux kernel
Corpus path
Documentation/devicetree/bindings/opp/opp-v2-qcom-adreno.yaml
Extension
.yaml
Size
2822 bytes
Lines
97
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/opp-v2-qcom-adreno.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Qualcomm Adreno compatible OPP supply

description:
  Adreno GPUs present in Qualcomm's Snapdragon chipsets uses an OPP specific
  ACD related information tailored for the specific chipset. This binding
  provides the information needed to describe such a hardware value.

maintainers:
  - Rob Clark <robdclark@gmail.com>

allOf:
  - $ref: opp-v2-base.yaml#

properties:
  compatible:
    contains:
      const: operating-points-v2-adreno

patternProperties:
  '^opp(-[0-9]+){1,2}$':
    type: object
    additionalProperties: false

    properties:
      opp-hz: true

      opp-level: true

      opp-peak-kBps: true

      opp-supported-hw: true

      qcom,opp-acd-level:
        description: |
          A positive value representing the ACD (Adaptive Clock Distribution,
          a fancy name for clk throttling during voltage droop) level associated
          with this OPP node. This value is shared to a co-processor inside GPU
          (called Graphics Management Unit a.k.a GMU) during wake up. It may not
          be present for some OPPs and GMU will disable ACD while transitioning
          to that OPP. This value encodes a voltage threshold, delay cycles &
          calibration margins which are identified by characterization of the
          SoC. So, it doesn't have any unit. This data is passed to GMU firmware
          via 'HFI_H2F_MSG_ACD' packet.
        $ref: /schemas/types.yaml#/definitions/uint32

    required:
      - opp-hz
      - opp-level

required:
  - compatible

additionalProperties: false

examples:
  - |
    #include <dt-bindings/power/qcom-rpmpd.h>

    gpu_opp_table: opp-table {
        compatible = "operating-points-v2-adreno", "operating-points-v2";

        opp-687000000 {
            opp-hz = /bits/ 64 <687000000>;
            opp-level = <RPMH_REGULATOR_LEVEL_SVS_L1>;

Annotation

Implementation Notes