dts/upstream/Bindings/soc/tegra/nvidia,tegra20-pmc.yaml

# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/soc/tegra/nvidia,tegra20-pmc.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Tegra Power Management Controller (PMC)

maintainers:
  - Thierry Reding <thierry.reding@gmail.com>
  - Jonathan Hunter <jonathanh@nvidia.com>

properties:
  compatible:
    enum:
      - nvidia,tegra20-pmc
      - nvidia,tegra30-pmc
      - nvidia,tegra114-pmc
      - nvidia,tegra124-pmc
      - nvidia,tegra210-pmc

  reg:
    maxItems: 1

  clock-names:
    items:
      # Tegra clock of the same name
      - const: pclk
      # 32 KHz clock input
      - const: clk32k_in

  clocks:
    maxItems: 2

  '#clock-cells':
    const: 1
    description: |
      Tegra PMC has clk_out_1, clk_out_2, and clk_out_3. PMC also has blink
      control which allows 32Khz clock output to Tegra blink pad.

      Consumer of PMC clock should specify the desired clock by having the
      clock ID in its "clocks" phandle cell with PMC clock provider. See
      include/dt-bindings/soc/tegra-pmc.h for the list of Tegra PMC clock IDs.

  '#interrupt-cells':
    const: 2
    description: Specifies number of cells needed to encode an interrupt
      source.

  interrupt-controller: true

  nvidia,invert-interrupt:
    $ref: /schemas/types.yaml#/definitions/flag
    description: Inverts the PMU interrupt signal. The PMU is an external Power
      Management Unit, whose interrupt output signal is fed into the PMC. This
      signal is optionally inverted, and then fed into the ARM GIC. The PMC is
      not involved in the detection or handling of this interrupt signal,
      merely its inversion.

  nvidia,core-power-req-active-high:
    $ref: /schemas/types.yaml#/definitions/flag
    description: core power request active-high

  nvidia,sys-clock-req-active-high:
    $ref: /schemas/types.yaml#/definitions/flag
    description: system clock request active-high

  nvidia,combined-power-req:
    $ref: /schemas/types.yaml#/definitions/flag
    description: combined power request for CPU and core

  nvidia,cpu-pwr-good-en:
    $ref: /schemas/types.yaml#/definitions/flag
    description: CPU power good signal from external PMIC to PMC is enabled

  nvidia,suspend-mode:
    $ref: /schemas/types.yaml#/definitions/uint32
    description: the suspend mode that the platform should use
    oneOf:
      - description: LP0, CPU + Core voltage off and DRAM in self-refresh
        const: 0
      - description: LP1, CPU voltage off and DRAM in self-refresh
        const: 1
      - description: LP2, CPU voltage off
        const: 2

  nvidia,cpu-pwr-good-time:
    $ref: /schemas/types.yaml#/definitions/uint32
    description: CPU power good time in microseconds

  nvidia,cpu-pwr-off-time:
    $ref: /schemas/types.yaml#/definitions/uint32
    description: CPU power off time in microseconds

  nvidia,core-pwr-good-time:
    $ref: /schemas/types.yaml#/definitions/uint32-array
    description: core power good time in microseconds
    items:
      - description: oscillator stable time
      - description: power stable time

  nvidia,core-pwr-off-time:
    $ref: /schemas/types.yaml#/definitions/uint32
    description: core power off time in microseconds

  nvidia,lp0-vec:
    $ref: /schemas/types.yaml#/definitions/uint32-array
    description: |
      Starting address and length of LP0 vector. The LP0 vector contains the
      warm boot code that is executed by AVP when resuming from the LP0 state.
      The AVP (Audio-Video Processor) is an ARM7 processor and always being
      the first boot processor when chip is power on or resume from deep sleep
      mode. When the system is resumed from the deep sleep mode, the warm boot
      code will restore some PLLs, clocks and then brings up CPU0 for resuming
      the system.
    items:
      - description: starting address of LP0 vector
      - description: length of LP0 vector

  core-supply:
    description: phandle to voltage regulator connected to the SoC core power
      rail

  core-domain:
    type: object
    description: The vast majority of hardware blocks of Tegra SoC belong to a
      core power domain, which has a dedicated voltage rail that powers the
      blocks.
    additionalProperties: false
    properties:
      operating-points-v2:
        description: Should contain level, voltages and opp-supported-hw
          property. The supported-hw is a bitfield indicating SoC speedo or
          process ID mask.

      "#power-domain-cells":
        const: 0

    required:
      - operating-points-v2
      - "#power-domain-cells"

  i2c-thermtrip:
    type: object
    description: On Tegra30, Tegra114 and Tegra124 if i2c-thermtrip subnode
      exists, hardware-triggered thermal reset will be enabled.
    additionalProperties: false
    properties:
      nvidia,i2c-controller-id:
        $ref: /schemas/types.yaml#/definitions/uint32
        description: ID of I2C controller to send poweroff command to PMU.
          Valid values are described in section 9.2.148 "APBDEV_PMC_SCRATCH53_0"
          of the Tegra K1 Technical Reference Manual.

      nvidia,bus-addr:
        $ref: /schemas/types.yaml#/definitions/uint32
        description: bus address of the PMU on the I2C bus

      nvidia,reg-addr:
        $ref: /schemas/types.yaml#/definitions/uint32
        description: PMU I2C register address to issue poweroff command

      nvidia,reg-data:
        $ref: /schemas/types.yaml#/definitions/uint32
        description: power-off command to write to PMU

      nvidia,pinmux-id:
        $ref: /schemas/types.yaml#/definitions/uint32
        description: Pinmux used by the hardware when issuing power-off command.
          Defaults to 0. Valid values are described in section 12.5.2 "Pinmux
          Support" of the Tegra4 Technical Reference Manual.

    required:
      - nvidia,i2c-controller-id
      - nvidia,bus-addr
      - nvidia,reg-addr
      - nvidia,reg-data

  powergates:
    type: object
    additionalProperties: false
    description: |
      This node contains a hierarchy of power domain nodes, which should match
      the powergates on the Tegra SoC. Each powergate node represents a power-
      domain on the Tegra SoC that can be power-gated by the Tegra PMC.

      Hardware blocks belonging to a power domain should contain "power-domains"
      property that is a phandle pointing to corresponding powergate node.

      The name of the powergate node should be one of the below. Note that not
      every powergate is applicable to all Tegra devices and the following list
      shows which powergates are applicable to which devices.

      Please refer to Tegra TRM for mode details on the powergate nodes to use
      for each power-gate block inside Tegra.

        Name     Description                   Devices Applicable
        --------------------------------------------------------------
        3d       3D Graphics                   Tegra20/114/124/210
        3d0      3D Graphics 0                 Tegra30
        3d1      3D Graphics 1                 Tegra30
        aud      Audio                         Tegra210
        dfd      Debug                         Tegra210
        dis      Display A                     Tegra114/124/210
        disb     Display B                     Tegra114/124/210
        heg      2D Graphics                   Tegra30/114/124/210
        iram     Internal RAM                  Tegra124/210
        mpe      MPEG Encode                   All
        nvdec    NVIDIA Video Decode Engine    Tegra210
        nvjpg    NVIDIA JPEG Engine            Tegra210
        pcie     PCIE                          Tegra20/30/124/210
        sata     SATA                          Tegra30/124/210
        sor      Display interfaces            Tegra124/210
        ve2      Video Encode Engine 2         Tegra210
        venc     Video Encode Engine           All
        vdec     Video Decode Engine           Tegra20/30/114/124
        vic      Video Imaging Compositor      Tegra124/210
        xusba    USB Partition A               Tegra114/124/210
        xusbb    USB Partition B               Tegra114/124/210
        xusbc    USB Partition C               Tegra114/124/210

    patternProperties:
      "^[a-z0-9]+$":
        type: object
        additionalProperties: false
        properties:
          clocks:
            minItems: 1
            maxItems: 10

          resets:
            minItems: 1
            maxItems: 8

          power-domains:
            maxItems: 1

          '#power-domain-cells':
            const: 0
            description: Must be 0.

        required:
          - clocks
          - resets
          - '#power-domain-cells'

  pinmux:
    type: object
    additionalProperties:
      type: object
      description: |
        This is a pad configuration node. On Tegra SoCs a pad is a set of pins
        which are configured as a group. The pin grouping is a fixed attribute
        of the hardware. The PMC can be used to set pad power state and
        signaling voltage. A pad can be either in active or power down mode.
        The support for power state and signaling voltage configuration varies
        depending on the pad in question. 3.3V and 1.8V signaling voltages are
        supported on pins where software controllable signaling voltage
        switching is available.

        The pad configuration state nodes are placed under the pmc node and
        they are referred to by the pinctrl client properties. For more
        information see:

          Documentation/devicetree/bindings/pinctrl/pinctrl-bindings.txt

        The pad name should be used as the value of the pins property in pin
        configuration nodes.

        The following pads are present on Tegra124 and Tegra132:

          audio, bb, cam, comp, csia, csb, cse, dsi, dsib, dsic, dsid, hdmi,
          hsic, hv, lvds, mipi-bias, nand, pex-bias, pex-clk1, pex-clk2,
          pex-cntrl, sdmmc1, sdmmc3, sdmmc4, sys_ddc, uart, usb0, usb1, usb2,
          usb_bias

        The following pads are present on Tegra210:

          audio, audio-hv, cam, csia, csib, csic, csid, csie, csif, dbg,
          debug-nonao, dmic, dp, dsi, dsib, dsic, dsid, emmc, emmc2, gpio,
          hdmi, hsic, lvds, mipi-bias, pex-bias, pex-clk1, pex-clk2, pex-cntrl,
          sdmmc1, sdmmc3, spi, spi-hv, uart, usb0, usb1, usb2, usb3, usb-bias
      additionalProperties: false
      properties:
        pins:
          $ref: /schemas/types.yaml#/definitions/string-array
          description: Must contain name of the pad(s) to be configured.

        low-power-enable:
          $ref: /schemas/types.yaml#/definitions/flag
          description: Configure the pad into power down mode.

        low-power-disable:
          $ref: /schemas/types.yaml#/definitions/flag
          description: Configure the pad into active mode.

        power-source:
          $ref: /schemas/types.yaml#/definitions/uint32
          description: |
            Must contain either TEGRA_IO_PAD_VOLTAGE_1V8 or
            TEGRA_IO_PAD_VOLTAGE_3V3 to select between signaling voltages. The
            values are defined in:

              include/dt-bindings/pinctrl/pinctrl-tegra-io-pad.h

            Power state can be configured on all Tegra124 and Tegra132 pads.
            None of the Tegra124 or Tegra132 pads support signaling voltage
            switching. All of the listed Tegra210 pads except pex-cntrl support
            power state configuration. Signaling voltage switching is supported
            on the following Tegra210 pads:

              audio, audio-hv, cam, dbg, dmic, gpio, pex-cntrl, sdmmc1, sdmmc3,
              spi, spi-hv, uart

      required:
        - pins

required:
  - compatible
  - reg
  - clock-names
  - clocks
  - '#clock-cells'

allOf:
  - if:
      properties:
        compatible:
          contains:
            const: nvidia,tegra124-pmc
    then:
      properties:
        pinmux:
          additionalProperties:
            type: object
            properties:
              pins:
                items:
                  enum: [ audio, bb, cam, comp, csia, csb, cse, dsi, dsib,
                          dsic, dsid, hdmi, hsic, hv, lvds, mipi-bias, nand,
                          pex-bias, pex-clk1, pex-clk2, pex-cntrl, sdmmc1,
                          sdmmc3, sdmmc4, sys_ddc, uart, usb0, usb1, usb2,
                          usb_bias ]

  - if:
      properties:
        compatible:
          contains:
            const: nvidia,tegra210-pmc
    then:
      properties:
        pinmux:
          additionalProperties:
            type: object
            properties:
              pins:
                items:
                  enum: [ audio, audio-hv, cam, csia, csib, csic, csid, csie,
                          csif, dbg, debug-nonao, dmic, dp, dsi, dsib, dsic,
                          dsid, emmc, emmc2, gpio, hdmi, hsic, lvds, mipi-bias,
                          pex-bias, pex-clk1, pex-clk2, pex-cntrl, sdmmc1,
                          sdmmc3, spi, spi-hv, uart, usb0, usb1, usb2, usb3,
                          usb-bias ]

additionalProperties: false

dependencies:
  nvidia,suspend-mode: ["nvidia,core-pwr-off-time", "nvidia,cpu-pwr-off-time"]
  nvidia,core-pwr-off-time: ["nvidia,core-pwr-good-time"]
  nvidia,cpu-pwr-off-time: ["nvidia,cpu-pwr-good-time"]

examples:
  - |
    #include <dt-bindings/clock/tegra210-car.h>
    #include <dt-bindings/pinctrl/pinctrl-tegra-io-pad.h>
    #include <dt-bindings/soc/tegra-pmc.h>

    pmc@7000e400 {
        compatible = "nvidia,tegra210-pmc";
        reg = <0x7000e400 0x400>;
        core-supply = <&regulator>;
        clocks = <&tegra_car TEGRA210_CLK_PCLK>, <&clk32k_in>;
        clock-names = "pclk", "clk32k_in";
        #clock-cells = <1>;

        nvidia,invert-interrupt;
        nvidia,suspend-mode = <0>;
        nvidia,cpu-pwr-good-time = <0>;
        nvidia,cpu-pwr-off-time = <0>;
        nvidia,core-pwr-good-time = <4587 3876>;
        nvidia,core-pwr-off-time = <39065>;
        nvidia,core-power-req-active-high;
        nvidia,sys-clock-req-active-high;

        pd_core: core-domain {
            operating-points-v2 = <&core_opp_table>;
            #power-domain-cells = <0>;
        };

        powergates {
            pd_audio: aud {
                clocks = <&tegra_car TEGRA210_CLK_APE>,
                         <&tegra_car TEGRA210_CLK_APB2APE>;
                resets = <&tegra_car 198>;
                power-domains = <&pd_core>;
                #power-domain-cells = <0>;
            };

            pd_xusbss: xusba {
                clocks = <&tegra_car TEGRA210_CLK_XUSB_SS>;
                resets = <&tegra_car TEGRA210_CLK_XUSB_SS>;
                power-domains = <&pd_core>;
                #power-domain-cells = <0>;
            };
        };
    };