Documentation/devicetree/bindings/powerpc/fsl/pmc.yaml

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

title: Power Management Controller

maintainers:
  - J. Neuschäfer <j.ne@posteo.net>

description: |
  The Power Management Controller in several MPC8xxx SoCs helps save power by
  controlling chip-wide low-power states as well as peripheral clock gating.

  Sleep of peripheral devices is configured by the `sleep` property, for
  example `sleep = <&pmc 0x00000030>`. Any cells after the &pmc phandle are
  called a sleep specifier.

  For "fsl,mpc8349-pmc", sleep specifiers consist of one cell.  For each bit that
  is set in the cell, the corresponding bit in SCCR will be saved and cleared
  on suspend, and restored on resume.  This sleep controller supports disabling
  and resuming devices at any time.

  For "fsl,mpc8536-pmc", sleep specifiers consist of three cells, the third of
  which will be ORed into PMCDR upon suspend, and cleared from PMCDR upon
  resume.  The first two cells are as described for fsl,mpc8548-pmc.  This
  sleep controller only supports disabling devices during system sleep, or
  permanently.

  For "fsl,mpc8548-pmc" or "fsl,mpc8641d-pmc", Sleep specifiers consist of one
  or two cells, the first of which will be ORed into DEVDISR (and the second
  into DEVDISR2, if present -- this cell should be zero or absent if the
  hardware does not have DEVDISR2) upon a request for permanent device
  disabling.  This sleep controller does not support configuring devices to
  disable during system sleep (unless supported by another compatible match),
  or dynamically.

properties:
  compatible:
    oneOf:
      - items:
          - const: fsl,mpc8315-pmc
          - const: fsl,mpc8313-pmc
          - const: fsl,mpc8349-pmc

      - items:
          - enum:
              - fsl,mpc8313-pmc
              - fsl,mpc8323-pmc
              - fsl,mpc8360-pmc
              - fsl,mpc8377-pmc
              - fsl,mpc8378-pmc
              - fsl,mpc8379-pmc
          - const: fsl,mpc8349-pmc

      - items:
          - const: fsl,p1022-pmc
          - const: fsl,mpc8536-pmc
          - const: fsl,mpc8548-pmc

      - items:
          - enum:
              - fsl,mpc8536-pmc
              - fsl,mpc8568-pmc
              - fsl,mpc8569-pmc
          - const: fsl,mpc8548-pmc

      - enum:
          - fsl,mpc8548-pmc
          - fsl,mpc8641d-pmc

    description: |
      "fsl,mpc8349-pmc" should be listed for any chip whose PMC is
      compatible.  "fsl,mpc8313-pmc" should also be listed for any chip
      whose PMC is compatible, and implies deep-sleep capability.

      "fsl,mpc8548-pmc" should be listed for any chip whose PMC is
      compatible.  "fsl,mpc8536-pmc" should also be listed for any chip
      whose PMC is compatible, and implies deep-sleep capability.

      "fsl,mpc8641d-pmc" should be listed for any chip whose PMC is
      compatible; all statements below that apply to "fsl,mpc8548-pmc" also
      apply to "fsl,mpc8641d-pmc".

      Compatibility does not include bit assignments in SCCR/PMCDR/DEVDISR; these
      bit assignments are indicated via the sleep specifier in each device's
      sleep property.

  reg:
    minItems: 1
    maxItems: 2

  interrupts:
    maxItems: 1

  fsl,mpc8313-wakeup-timer:
    $ref: /schemas/types.yaml#/definitions/phandle
    description:
      For "fsl,mpc8313-pmc"-compatible devices, this is a phandle to an
      "fsl,gtm" node on which timer 4 can be used as a wakeup source from deep
      sleep.

allOf:
  - if:
      properties:
        compatible:
          contains:
            const: fsl,mpc8349-pmc
    then:
      properties:
        reg:
          items:
            - description: PMC block
            - description: Clock Configuration block

  - if:
      properties:
        compatible:
          contains:
            enum:
              - fsl,mpc8548-pmc
              - fsl,mpc8641d-pmc
    then:
      properties:
        reg:
          items:
            - description: 32-byte block beginning with DEVDISR

required:
  - compatible
  - reg

additionalProperties: false

examples:
  - |
    #include <dt-bindings/interrupt-controller/irq.h>

    pmc: power@b00 {
        compatible = "fsl,mpc8377-pmc", "fsl,mpc8349-pmc";
        reg = <0xb00 0x100>, <0xa00 0x100>;
        interrupts = <80 IRQ_TYPE_LEVEL_LOW>;
    };

  - |
    power@e0070 {
        compatible = "fsl,mpc8548-pmc";
        reg = <0xe0070 0x20>;
    };

...