adi,adf4377.yaml

  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...