Back to home page

OSCL-LXR

 
 

    


0001 # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
0002 %YAML 1.2
0003 ---
0004 $id: http://devicetree.org/schemas/iio/frequency/adi,adf4350.yaml#
0005 $schema: http://devicetree.org/meta-schemas/core.yaml#
0006 
0007 title: Analog Devices ADF4350/ADF4351 wideband synthesizer
0008 
0009 maintainers:
0010   - Michael Hennerich <michael.hennerich@analog.com>
0011 
0012 properties:
0013   compatible:
0014     enum:
0015       - adi,adf4350
0016       - adi,adf4351
0017 
0018   reg:
0019     maxItems: 1
0020 
0021   spi-max-frequency:
0022     maximum: 20000000
0023 
0024   clocks:
0025     maxItems: 1
0026     description: Clock to provide CLKIN reference clock signal.
0027 
0028   clock-names:
0029     const: clkin
0030 
0031   gpios:
0032     maxItems: 1
0033     description: Lock detect GPIO.
0034 
0035   adi,channel-spacing:
0036     $ref: /schemas/types.yaml#/definitions/uint32
0037     description:
0038       Channel spacing in Hz (influences MODULUS).
0039 
0040   adi,power-up-frequency:
0041     $ref: /schemas/types.yaml#/definitions/uint32
0042     description:
0043       If set the PLL tunes to this frequency (in Hz) on driver probe.
0044 
0045   adi,reference-div-factor:
0046     $ref: /schemas/types.yaml#/definitions/uint32
0047     description:
0048       If set the driver skips dynamic calculation and uses this default
0049       value instead.
0050 
0051   adi,reference-doubler-enable:
0052     $ref: /schemas/types.yaml#/definitions/flag
0053     description: Enables reference doubler.
0054 
0055   adi,reference-div2-enable:
0056     $ref: /schemas/types.yaml#/definitions/flag
0057     description: Enables reference divider.
0058 
0059   adi,phase-detector-polarity-positive-enable:
0060     $ref: /schemas/types.yaml#/definitions/flag
0061     description: Enables positive phase detector polarity. Default negative.
0062 
0063   adi,lock-detect-precision-6ns-enable:
0064     $ref: /schemas/types.yaml#/definitions/flag
0065     description: Enables 6ns lock detect precision. Default = 10ns.
0066 
0067   adi,lock-detect-function-integer-n-enable:
0068     $ref: /schemas/types.yaml#/definitions/flag
0069     description:
0070       Enables lock detect for integer-N mode. Default = factional-N mode.
0071 
0072   adi,charge-pump-current:
0073     $ref: /schemas/types.yaml#/definitions/uint32
0074     description: Charge pump current in mA. Default = 2500mA.
0075 
0076   adi,muxout-select:
0077     $ref: /schemas/types.yaml#/definitions/uint32
0078     minimum: 0
0079     maximum: 6
0080     description: |
0081       On chip multiplexer output selection.
0082       Valid values for the multiplexer output are:
0083       0: Three-State Output (default)
0084       1: DVDD
0085       2: DGND
0086       3: R-Counter output
0087       4: N-Divider output
0088       5: Analog lock detect
0089       6: Digital lock detect
0090 
0091   adi,low-spur-mode-enable:
0092     $ref: /schemas/types.yaml#/definitions/flag
0093     description: Enables low spur mode. Default = Low noise mode.
0094 
0095   adi,cycle-slip-reduction-enable:
0096     $ref: /schemas/types.yaml#/definitions/flag
0097     description: Enables cycle slip reduction.
0098 
0099   adi,charge-cancellation-enable:
0100     $ref: /schemas/types.yaml#/definitions/flag
0101     description:
0102       Enabled charge pump charge cancellation for integer-N modes.
0103 
0104   adi,anti-backlash-3ns-enable:
0105     $ref: /schemas/types.yaml#/definitions/flag
0106     description:
0107       Enables 3ns antibacklash pulse width for integer-N modes.
0108 
0109   adi,band-select-clock-mode-high-enable:
0110     $ref: /schemas/types.yaml#/definitions/flag
0111     description: Enables faster band selection logic.
0112 
0113   adi,12bit-clk-divider:
0114     $ref: /schemas/types.yaml#/definitions/uint32
0115     description:
0116       Clock divider value used when adi,12bit-clkdiv-mode != 0
0117 
0118   adi,clk-divider-mode:
0119     $ref: /schemas/types.yaml#/definitions/uint32
0120     enum: [0, 1, 2]
0121     description: |
0122       Valid values for the clkdiv mode are:
0123       0: Clock divider off (default)
0124       1: Fast lock enable
0125       2: Phase resync enable
0126 
0127   adi,aux-output-enable:
0128     $ref: /schemas/types.yaml#/definitions/flag
0129     description: Enables auxiliary RF output.
0130 
0131   adi,aux-output-fundamental-enable:
0132     $ref: /schemas/types.yaml#/definitions/flag
0133     description: |
0134       Selects fundamental VCO output on the auxiliary RF output.
0135       Default = Output of RF dividers.
0136 
0137   adi,mute-till-lock-enable:
0138     $ref: /schemas/types.yaml#/definitions/flag
0139     description: Enables Mute-Till-Lock-Detect function.
0140 
0141   adi,output-power:
0142     $ref: /schemas/types.yaml#/definitions/uint32
0143     enum: [0, 1, 2, 3]
0144     description: |
0145       Output power selection.
0146       Valid values for the power mode are:
0147       0: -4dBm (default)
0148       1: -1dBm
0149       2: +2dBm
0150       3: +5dBm
0151 
0152   adi,aux-output-power:
0153     $ref: /schemas/types.yaml#/definitions/uint32
0154     enum: [0, 1, 2, 3]
0155     description: |
0156       Auxiliary output power selection.
0157       Valid values for the power mode are:
0158       0: -4dBm (default)
0159       1: -1dBm
0160       2: +2dBm
0161       3: +5dBm
0162 
0163 additionalProperties: false
0164 
0165 required:
0166   - compatible
0167   - reg
0168   - clocks
0169 
0170 examples:
0171   - |
0172     spi {
0173         #address-cells = <1>;
0174         #size-cells = <0>;
0175 
0176         pll@4 {
0177             compatible = "adi,adf4351";
0178             reg = <4>;
0179             spi-max-frequency = <10000000>;
0180             clocks = <&clk0_ad9523 9>;
0181             clock-names = "clkin";
0182             adi,channel-spacing = <10000>;
0183             adi,power-up-frequency = <2400000000>;
0184             adi,phase-detector-polarity-positive-enable;
0185             adi,charge-pump-current = <2500>;
0186             adi,output-power = <3>;
0187             adi,mute-till-lock-enable;
0188         };
0189     };
0190 ...