xref: /freebsd/sys/contrib/device-tree/Bindings/iio/frequency/adi,admv1013.yaml (revision db33c6f3ae9d1231087710068ee4ea5398aacca7) 
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,admv1013.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: ADMV1013 Microwave Upconverter
8
9maintainers:
10  - Antoniu Miclaus <antoniu.miclaus@analog.com>
11
12description: |
13   Wideband, microwave upconverter optimized for point to point microwave
14   radio designs operating in the 24 GHz to 44 GHz frequency range.
15
16   https://www.analog.com/en/products/admv1013.html
17
18properties:
19  compatible:
20    enum:
21      - adi,admv1013
22
23  reg:
24    maxItems: 1
25
26  spi-max-frequency:
27    maximum: 1000000
28
29  clocks:
30    description:
31      Definition of the external clock.
32    minItems: 1
33
34  clock-names:
35    items:
36      - const: lo_in
37
38  vcm-supply:
39    description:
40      Analog voltage regulator.
41
42  vcc-drv-supply:
43    description:
44      RF Driver voltage regulator.
45
46  vcc2-drv-supply:
47    description:
48      RF predriver voltage regulator.
49
50  vcc-vva-supply:
51    description:
52      VVA Control Circuit voltage regulator.
53
54  vcc-amp1-supply:
55    description:
56      RF Amplifier 1 voltage regulator.
57
58  vcc-amp2-supply:
59    description:
60      RF Amplifier 2 voltage regulator.
61
62  vcc-env-supply:
63    description:
64      Envelope Detector voltage regulator.
65
66  vcc-bg-supply:
67    description:
68      Mixer Chip Band Gap Circuit voltage regulator.
69
70  vcc-bg2-supply:
71    description:
72      VGA Chip Band Gap Circuit voltage regulator.
73
74  vcc-mixer-supply:
75    description:
76      Mixer voltage regulator.
77
78  vcc-quad-supply:
79    description:
80      Quadruppler voltage regulator.
81
82  adi,detector-enable:
83    description:
84      Enable the Envelope Detector available at output pins VENV_P and
85      VENV_N. Disable to reduce power consumption.
86    type: boolean
87
88  adi,input-mode:
89    description:
90      Select the input mode.
91      iq - in-phase quadrature (I/Q) input
92      if - complex intermediate frequency (IF) input
93    enum: [iq, if]
94
95  adi,quad-se-mode:
96    description:
97      Switch the LO path from differential to single-ended operation.
98      se-neg - Single-Ended Mode, Negative Side Disabled.
99      se-pos - Single-Ended Mode, Positive Side Disabled.
100      diff - Differential Mode.
101    enum: [se-neg, se-pos, diff]
102
103  '#clock-cells':
104    const: 0
105
106required:
107  - compatible
108  - reg
109  - clocks
110  - clock-names
111  - vcm-supply
112  - vcc-drv-supply
113  - vcc2-drv-supply
114  - vcc-vva-supply
115  - vcc-amp1-supply
116  - vcc-amp2-supply
117  - vcc-env-supply
118  - vcc-bg-supply
119  - vcc-bg2-supply
120  - vcc-mixer-supply
121  - vcc-quad-supply
122
123allOf:
124  - $ref: /schemas/spi/spi-peripheral-props.yaml#
125
126unevaluatedProperties: false
127
128examples:
129  - |
130    spi {
131      #address-cells = <1>;
132      #size-cells = <0>;
133      admv1013@0{
134        compatible = "adi,admv1013";
135        reg = <0>;
136        spi-max-frequency = <1000000>;
137        clocks = <&admv1013_lo>;
138        clock-names = "lo_in";
139        vcm-supply = <&vcm>;
140        vcc-drv-supply = <&vcc_drv>;
141        vcc2-drv-supply = <&vcc2_drv>;
142        vcc-vva-supply = <&vcc_vva>;
143        vcc-amp1-supply = <&vcc_amp1>;
144        vcc-amp2-supply = <&vcc_amp2>;
145        vcc-env-supply = <&vcc_env>;
146        vcc-bg-supply = <&vcc_bg>;
147        vcc-bg2-supply = <&vcc_bg2>;
148        vcc-mixer-supply = <&vcc_mixer>;
149        vcc-quad-supply = <&vcc_quad>;
150        adi,quad-se-mode = "diff";
151        adi,detector-enable;
152      };
153    };
154...
155