xref: /linux/Documentation/devicetree/bindings/clock/renesas,9series.yaml (revision 58f6259b7a08f8d47d4629609703d358b042f0fd)
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/clock/renesas,9series.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Renesas 9-series I2C PCIe clock generators
8
9description: |
10  The Renesas 9-series are I2C PCIe clock generators providing
11  from 1 to 20 output clocks.
12
13  When referencing the provided clock in the DT using phandle
14  and clock specifier, the following mapping applies:
15
16  - 9FGV0241:
17    0 -- DIF0
18    1 -- DIF1
19  - 9FGV0441:
20    0 -- DIF0
21    1 -- DIF1
22    2 -- DIF2
23    3 -- DIF3
24
25maintainers:
26  - Marek Vasut <marex@denx.de>
27
28properties:
29  compatible:
30    enum:
31      - renesas,9fgv0241
32      - renesas,9fgv0441
33
34  reg:
35    description: I2C device address
36    enum: [ 0x68, 0x6a ]
37
38  '#clock-cells':
39    const: 1
40
41  clocks:
42    items:
43      - description: XTal input clock
44
45  renesas,out-amplitude-microvolt:
46    enum: [ 600000, 700000, 800000, 900000 ]
47    description: Output clock signal amplitude
48
49  renesas,out-spread-spectrum:
50    $ref: /schemas/types.yaml#/definitions/uint32
51    enum: [ 100000, 99750, 99500 ]
52    description: Output clock down spread in pcm (1/1000 of percent)
53
54patternProperties:
55  "^DIF[0-19]$":
56    type: object
57    description:
58      Description of one of the outputs (DIF0..DIF19).
59
60    properties:
61      renesas,slew-rate:
62        $ref: /schemas/types.yaml#/definitions/uint32
63        enum: [ 2000000, 3000000 ]
64        description: Output clock slew rate select in V/ns
65
66    additionalProperties: false
67
68required:
69  - compatible
70  - reg
71  - clocks
72  - '#clock-cells'
73
74additionalProperties: false
75
76examples:
77  - |
78    /* 25MHz reference crystal */
79    ref25: ref25m {
80        compatible = "fixed-clock";
81        #clock-cells = <0>;
82        clock-frequency = <25000000>;
83    };
84
85    i2c@0 {
86        reg = <0x0 0x100>;
87        #address-cells = <1>;
88        #size-cells = <0>;
89
90        rs9: clock-generator@6a {
91            compatible = "renesas,9fgv0241";
92            reg = <0x6a>;
93            #clock-cells = <1>;
94
95            clocks = <&ref25m>;
96
97            DIF0 {
98                renesas,slew-rate = <3000000>;
99            };
100        };
101    };
102
103...
104