xref: /linux/Documentation/devicetree/bindings/iio/amplifiers/adi,adl8113.yaml (revision f4b369c6fe0ceaba2da2daff8c9eb415f85926dd) 
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/iio/amplifiers/adi,adl8113.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Analog Devices ADL8113 Low Noise Amplifier with integrated bypass switches
8
9maintainers:
10  - Antoniu Miclaus <antoniu.miclaus@analog.com>
11
12description: |
13  The ADL8113 is a 10MHz to 12GHz Low Noise Amplifier with integrated bypass
14  switches controlled by two GPIO pins (VA and VB). The device supports four
15  operation modes:
16    - Internal Amplifier: VA=0, VB=0 - Signal passes through the internal LNA
17    - Internal Bypass: VA=1, VB=1 - Signal bypasses through internal path
18    - External Bypass A: VA=0, VB=1 - Signal routes from RFIN to OUT_A and from IN_A to RFOUT
19    - External Bypass B: VA=1, VB=0 - Signal routes from RFIN to OUT_B and from IN_B to RFOUT
20
21    https://www.analog.com/en/products/adl8113.html
22
23properties:
24  compatible:
25    const: adi,adl8113
26
27  vdd1-supply: true
28
29  vdd2-supply: true
30
31  vss2-supply: true
32
33  ctrl-gpios:
34    items:
35      - description: VA control pin
36      - description: VB control pin
37
38  adi,external-bypass-a-gain-db:
39    description:
40      Gain in dB of external amplifier connected to bypass path A (OUT_A/IN_A).
41      When specified, this gain value becomes selectable via the hardwaregain
42      attribute and automatically routes through the external A path.
43
44  adi,external-bypass-b-gain-db:
45    description:
46      Gain in dB of external amplifier connected to bypass path B (OUT_B/IN_B).
47      When specified, this gain value becomes selectable via the hardwaregain
48      attribute and automatically routes through the external B path.
49
50required:
51  - compatible
52  - ctrl-gpios
53  - vdd1-supply
54  - vdd2-supply
55  - vss2-supply
56
57additionalProperties: false
58
59examples:
60  - |
61    #include <dt-bindings/gpio/gpio.h>
62
63    /* Basic configuration with only internal paths */
64    amplifier {
65        compatible = "adi,adl8113";
66        ctrl-gpios = <&gpio 22 GPIO_ACTIVE_HIGH>,
67                     <&gpio 23 GPIO_ACTIVE_HIGH>;
68        vdd1-supply = <&vdd1_5v>;
69        vdd2-supply = <&vdd2_3v3>;
70        vss2-supply = <&vss2_neg>;
71    };
72
73  - |
74    #include <dt-bindings/gpio/gpio.h>
75
76    /* Configuration with external bypass amplifiers */
77    amplifier {
78        compatible = "adi,adl8113";
79        ctrl-gpios = <&gpio 24 GPIO_ACTIVE_HIGH>,
80                     <&gpio 25 GPIO_ACTIVE_HIGH>;
81        vdd1-supply = <&vdd1_5v>;
82        vdd2-supply = <&vdd2_3v3>;
83        vss2-supply = <&vss2_neg>;
84        adi,external-bypass-a-gain-db = <20>;  /* 20dB external amp on path A */
85        adi,external-bypass-b-gain-db = <6>;   /* 6dB external amp on path B */
86    };
87...
88