Documentation/devicetree/bindings/clock/fsl,qoriq-clock-legacy.yaml

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

title: Legacy Clock Block on Freescale QorIQ Platforms

maintainers:
  - Frank Li <Frank.Li@nxp.com>

description: |
  These nodes are deprecated.  Kernels should continue to support
  device trees with these nodes, but new device trees should not use them.

  Most of the bindings are from the common clock binding[1].
  [1] Documentation/devicetree/bindings/clock/clock-bindings.txt

properties:
  compatible:
    enum:
      - fsl,qoriq-core-pll-1.0
      - fsl,qoriq-core-pll-2.0
      - fsl,qoriq-core-mux-1.0
      - fsl,qoriq-core-mux-2.0
      - fsl,qoriq-sysclk-1.0
      - fsl,qoriq-sysclk-2.0
      - fsl,qoriq-platform-pll-1.0
      - fsl,qoriq-platform-pll-2.0

  reg:
    maxItems: 1

  clocks:
    minItems: 1
    maxItems: 4

  clock-names:
    minItems: 1
    maxItems: 4

  clock-output-names:
    minItems: 1
    maxItems: 8

  '#clock-cells':
    minimum: 0
    maximum: 1

required:
  - compatible
  - '#clock-cells'

additionalProperties: false

allOf:
  - if:
      properties:
        compatible:
          contains:
            enum:
              - fsl,qoriq-sysclk-1.0
              - fsl,qoriq-sysclk-2.0
    then:
      properties:
        '#clock-cells':
          const: 0

  - if:
      properties:
        compatible:
          contains:
            enum:
              - fsl,qoriq-core-pll-1.0
              - fsl,qoriq-core-pll-2.0
    then:
      properties:
        '#clock-cells':
          const: 1
          description: |
            * 0 - equal to the PLL frequency
            * 1 - equal to the PLL frequency divided by 2
            * 2 - equal to the PLL frequency divided by 4