xref: /linux/Documentation/devicetree/bindings/clock/airoha,en7523-scu.yaml (revision ee057c8c194b9283f4137b253b70e292693a39f0) 
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/clock/airoha,en7523-scu.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: EN7523 Clock
8
9maintainers:
10  - Felix Fietkau <nbd@nbd.name>
11  - John Crispin <nbd@nbd.name>
12
13description: |
14  This node defines the System Control Unit of the EN7523 SoC,
15  a collection of registers configuring many different aspects of the SoC.
16
17  The clock driver uses it to read and configure settings of the
18  PLL controller, which provides clocks for the CPU, the bus and
19  other SoC internal peripherals.
20
21  Each clock is assigned an identifier and client nodes use this identifier
22  to specify which clock they consume.
23
24  All these identifiers can be found in:
25  [1]: <include/dt-bindings/clock/en7523-clk.h>.
26
27  The clocks are provided inside a system controller node.
28
29properties:
30  compatible:
31    items:
32      - enum:
33          - airoha,en7523-scu
34          - airoha,en7581-scu
35
36  reg:
37    minItems: 2
38    maxItems: 4
39
40  "#clock-cells":
41    description:
42      The first cell indicates the clock number, see [1] for available
43      clocks.
44    const: 1
45
46  '#reset-cells':
47    description: ID of the controller reset line
48    const: 1
49
50required:
51  - compatible
52  - reg
53  - '#clock-cells'
54
55allOf:
56  - if:
57      properties:
58        compatible:
59          const: airoha,en7523-scu
60    then:
61      properties:
62        reg:
63          items:
64            - description: scu base address
65            - description: misc scu base address
66
67        '#reset-cells': false
68
69  - if:
70      properties:
71        compatible:
72          const: airoha,en7581-scu
73    then:
74      properties:
75        reg:
76          items:
77            - description: scu base address
78            - description: misc scu base address
79            - description: reset base address
80            - description: pb scu base address
81
82additionalProperties: false
83
84examples:
85  - |
86    #include <dt-bindings/clock/en7523-clk.h>
87    scu: system-controller@1fa20000 {
88      compatible = "airoha,en7523-scu";
89      reg = <0x1fa20000 0x400>,
90            <0x1fb00000 0x1000>;
91      #clock-cells = <1>;
92    };
93
94  - |
95    soc {
96      #address-cells = <2>;
97      #size-cells = <2>;
98
99      scuclk: clock-controller@1fa20000 {
100        compatible = "airoha,en7581-scu";
101        reg = <0x0 0x1fa20000 0x0 0x400>,
102              <0x0 0x1fb00000 0x0 0x90>,
103              <0x0 0x1fb00830 0x0 0x8>,
104              <0x0 0x1fbe3400 0x0 0xfc>;
105              #clock-cells = <1>;
106              #reset-cells = <1>;
107      };
108    };
109