adi,admv8818.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/filter/adi,admv8818.yaml#
 5$schema: http://devicetree.org/meta-schemas/core.yaml#
 6
 7title: ADMV8818 Digitally Tunable, High-Pass and Low-Pass Filter
 8
 9maintainers:
10  - Antoniu Miclaus <antoniu.miclaus@analog.com>
11
12description: |
13    Fully monolithic microwave integrated circuit (MMIC) that
14    features a digitally selectable frequency of operation.
15    The device features four independently controlled high-pass
16    filters (HPFs) and four independently controlled low-pass filters
17    (LPFs) that span the 2 GHz to 18 GHz frequency range.
18
19    https://www.analog.com/en/products/admv8818.html
20
21properties:
22  compatible:
23    enum:
24      - adi,admv8818
25
26  reg:
27    maxItems: 1
28
29  spi-max-frequency:
30    maximum: 10000000
31
32  clocks:
33    description:
34      Definition of the external clock.
35    minItems: 1
36
37  clock-names:
38    items:
39      - const: rf_in
40
41  clock-output-names:
42    maxItems: 1
43
44  '#clock-cells':
45    const: 0
46
47  adi,lpf-margin-mhz:
48    description:
49      Sets the minimum distance between the fundamental frequency of `rf_in`
50      and the corner frequency of the low-pass, output filter when operated in
51      'auto' mode. The selected low-pass corner frequency will be greater than,
52      or equal to, `rf_in` + `lpf-margin-hz`. If not setting is found that
53      satisfies this relationship the filter will be put into 'bypass'.
54    default: 0
55
56  adi,hpf-margin-mhz:
57    description:
58      Sets the minimum distance between the fundamental frequency of `rf_in`
59      and the corner frequency of the high-pass, input filter when operated in
60      'auto' mode. The selected high-pass corner frequency will be less than,
61      or equal to, `rf_in` - `hpf-margin-hz`. If not setting is found that
62      satisfies this relationship the filter will be put into 'bypass'.
63    default: 0
64
65required:
66  - compatible
67  - reg
68
69additionalProperties: false
70
71examples:
72  - |
73    spi {
74      #address-cells = <1>;
75      #size-cells = <0>;
76      admv8818@0 {
77        compatible = "adi,admv8818";
78        reg = <0>;
79        spi-max-frequency = <10000000>;
80        clocks = <&admv8818_rfin>;
81        clock-names = "rf_in";
82        adi,lpf-margin-mhz = <300>;
83        adi,hpf-margin-mhz = <300>;
84      };
85    };
86...