xref: /linux/Documentation/devicetree/bindings/iio/frequency/adi,adf4377.yaml (revision c532de5a67a70f8533d495f8f2aaa9a0491c3ad0) 
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/iio/frequency/adi,adf4377.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: ADF4377 Microwave Wideband Synthesizer with Integrated VCO
8
9maintainers:
10  - Antoniu Miclaus <antoniu.miclaus@analog.com>
11  - Dragos Bogdan <dragos.bogdan@analog.com>
12
13description: |
14   The ADF4377 is a high performance, ultralow jitter, dual output integer-N
15   phased locked loop (PLL) with integrated voltage controlled oscillator (VCO)
16   ideally suited for data converter and mixed signal front end (MxFE) clock
17   applications.
18
19   https://www.analog.com/en/products/adf4377.html
20   https://www.analog.com/en/products/adf4378.html
21
22properties:
23  compatible:
24    enum:
25      - adi,adf4377
26      - adi,adf4378
27
28  reg:
29    maxItems: 1
30
31  spi-max-frequency:
32    maximum: 10000000
33
34  clocks:
35    maxItems: 1
36
37  clock-names:
38    description:
39      External clock that provides reference input frequency.
40    items:
41      - const: ref_in
42
43  chip-enable-gpios:
44    description:
45      GPIO that controls the Chip Enable Pin.
46    maxItems: 1
47
48  clk1-enable-gpios:
49    description:
50      GPIO that controls the Enable Clock 1 Output Buffer Pin.
51    maxItems: 1
52
53  clk2-enable-gpios:
54    description:
55      GPIO that controls the Enable Clock 2 Output Buffer Pin.
56    maxItems: 1
57
58  adi,muxout-select:
59    description:
60      On chip multiplexer output selection.
61      high_z - MUXOUT Pin set to high-Z.
62      lock_detect - MUXOUT Pin set to lock detector output.
63      muxout_low - MUXOUT Pin set to low.
64      f_div_rclk_2 - MUXOUT Pin set to fDIV_RCLK/2.
65      f_div_nclk_2 - MUXOUT Pin set to fDIV_NCLK/2.
66      muxout_high - MUXOUT Pin set to high.
67    enum: [high_z, lock_detect, muxout_low, f_div_rclk_2, f_div_nclk_2, muxout_high]
68
69required:
70  - compatible
71  - reg
72  - clocks
73  - clock-names
74
75allOf:
76  - $ref: /schemas/spi/spi-peripheral-props.yaml#
77  - if:
78      properties:
79        compatible:
80          contains:
81            enum:
82              - adi,adf4378
83    then:
84      properties:
85        clk2-enable-gpios: false
86
87unevaluatedProperties: false
88
89examples:
90  - |
91    spi {
92        #address-cells = <1>;
93        #size-cells = <0>;
94        frequency@0 {
95            compatible = "adi,adf4377";
96            reg = <0>;
97            spi-max-frequency = <10000000>;
98            clocks = <&adf4377_ref_in>;
99            clock-names = "ref_in";
100        };
101    };
102...
103