adi,hmc425a.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/amplifiers/adi,hmc425a.yaml#
  5$schema: http://devicetree.org/meta-schemas/core.yaml#
  6
  7title: Analog Devices HMC425A and similar Digital Step Attenuators
  8
  9maintainers:
 10  - Michael Hennerich <michael.hennerich@analog.com>
 11
 12description: |
 13  Digital Step Attenuator IIO devices with gpio interface.
 14  Offer various frequency and attenuation ranges.
 15  ADRF5750 2 dB LSB, 4-Bit, Silicon Digital Attenuator, 10 MHz to 60 GHz
 16    https://www.analog.com/media/en/technical-documentation/data-sheets/adrf5740.pdf
 17
 18  HMC425A 0.5 dB LSB GaAs MMIC 6-BIT DIGITAL POSITIVE CONTROL ATTENUATOR, 2.2 - 8.0 GHz
 19    https://www.analog.com/media/en/technical-documentation/data-sheets/hmc425A.pdf
 20
 21  HMC540S 1 dB LSB Silicon MMIC 4-Bit Digital Positive Control Attenuator, 0.1 - 8 GHz
 22    https://www.analog.com/media/en/technical-documentation/data-sheets/hmc540s.pdf
 23
 24  LTC6373 is a 3-Bit precision instrumentation amplifier with fully differential outputs
 25    https://www.analog.com/media/en/technical-documentation/data-sheets/ltc6373.pdf
 26
 27properties:
 28  compatible:
 29    enum:
 30      - adi,adrf5740
 31      - adi,hmc425a
 32      - adi,hmc540s
 33      - adi,ltc6373
 34
 35  vcc-supply: true
 36
 37  ctrl-gpios:
 38    description:
 39      Must contain an array of GPIO specifiers, referring to the GPIO pins
 40      connected to the control pins.
 41        ADRF5740  - 4 GPIO connected to D2-D5
 42        HMC540S   - 4 GPIO connected to V1-V4
 43        HMC425A   - 6 GPIO connected to V1-V6
 44        LTC6373   - 3 GPIO connected to A0-A2
 45    minItems: 1
 46    maxItems: 6
 47
 48allOf:
 49  - if:
 50      properties:
 51        compatible:
 52          contains:
 53            const: adi,hmc425a
 54    then:
 55      properties:
 56        ctrl-gpios:
 57          minItems: 6
 58          maxItems: 6
 59  - if:
 60      properties:
 61        compatible:
 62          contains:
 63            anyOf:
 64              - const: adi,adrf5740
 65              - const: adi,hmc540s
 66    then:
 67      properties:
 68        ctrl-gpios:
 69          minItems: 4
 70          maxItems: 4
 71  - if:
 72      properties:
 73        compatible:
 74          contains:
 75            const: adi,ltc6373
 76    then:
 77      properties:
 78        ctrl-gpios:
 79          minItems: 3
 80          maxItems: 3
 81
 82required:
 83  - compatible
 84  - ctrl-gpios
 85
 86additionalProperties: false
 87
 88examples:
 89  - |
 90    #include <dt-bindings/gpio/gpio.h>
 91    gpio_hmc425a: hmc425a {
 92      compatible = "adi,hmc425a";
 93      ctrl-gpios = <&gpio 40 GPIO_ACTIVE_HIGH>,
 94        <&gpio 39 GPIO_ACTIVE_HIGH>,
 95        <&gpio 38 GPIO_ACTIVE_HIGH>,
 96        <&gpio 37 GPIO_ACTIVE_HIGH>,
 97        <&gpio 36 GPIO_ACTIVE_HIGH>,
 98        <&gpio 35 GPIO_ACTIVE_HIGH>;
 99      vcc-supply = <&foo>;
100    };
101...