Documentation/devicetree/bindings/iio/dac/microchip,mcp4725.yaml

   1 # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/iio/dac/microchip,mcp4725.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: Microchip mcp4725 and mcp4726 DAC
   8
   9 maintainers:
  10   - Tomas Novotny <tomas@novotny.cz>
  11
  12 properties:
  13   compatible:
  14     enum:
  15       - microchip,mcp4725
  16       - microchip,mcp4726
  17
  18   reg:
  19     maxItems: 1
  20
  21   vdd-supply:
  22     description: |
  23       Provides both power and acts as the reference supply on the mcp4725.
  24       For the mcp4726 it will be used as the reference voltage if vref-supply
  25       is not provided.
  26
  27   vref-supply:
  28     description:
  29       Vref pin is used as a voltage reference when this supply is specified.
  30
  31   microchip,vref-buffered:
  32     type: boolean
  33     description: |
  34       Enable buffering of the external Vref pin. This boolean is not valid
  35       without the vref-supply. Quoting the datasheet: This is offered in
  36       cases where the reference voltage does not have the current
  37       capability not to drop its voltage when connected to the internal
  38       resistor ladder circuit.
  39
  40 allOf:
  41   - if:
  42       properties:
  43         compatible:
  44           contains:
  45             const: microchip,mcp4725
  46     then:
  47       properties:
  48         vref-supply: false
  49       required:
  50         - vdd-supply
  51
  52   - if:
  53       properties:
  54         compatible:
  55           contains:
  56             const: microchip,mcp4726
  57     then:
  58       anyOf:
  59         - required:
  60             - vdd-supply
  61         - required:
  62             - vref-supply
  63
  64   - if:
  65       not:
  66         required:
  67           - vref-supply
  68     then:
  69       properties:
  70         microchip,vref-buffered: false
  71
  72 required:
  73   - compatible
  74   - reg
  75
  76 additionalProperties: false
  77
  78 examples:
  79   - |
  80     i2c {
  81         #address-cells = <1>;
  82         #size-cells = <0>;
  83
  84         mcp4725@60 {
  85             compatible = "microchip,mcp4725";
  86             reg = <0x60>;
  87             vdd-supply = <&vdac_vdd>;
  88         };
  89     };
  90 ...