Documentation/devicetree/bindings/iio/adc/microchip,mcp3911.yaml

   1 # SPDX-License-Identifier: GPL-2.0 OR BSD-2-Clause
   2 # Copyright 2019 Marcus Folkesson <marcus.folkesson@gmail.com>
   3 %YAML 1.2
   4 ---
   5 $id: "http://devicetree.org/schemas/iio/adc/microchip,mcp3911.yaml#"
   6 $schema: "http://devicetree.org/meta-schemas/core.yaml#"
   7
   8 title: Microchip MCP3911 Dual channel analog front end (ADC)
   9
  10 maintainers:
  11   - Marcus Folkesson <marcus.folkesson@gmail.com>
  12   - Kent Gustavsson <nedo80@gmail.com>
  13
  14 description: |
  15   Bindings for the Microchip MCP3911 Dual channel ADC device. Datasheet can be
  16   found here: https://ww1.microchip.com/downloads/en/DeviceDoc/20002286C.pdf
  17
  18 properties:
  19   compatible:
  20     enum:
  21       - microchip,mcp3911
  22
  23   reg:
  24     maxItems: 1
  25
  26   spi-max-frequency:
  27     maximum: 20000000
  28
  29   clocks:
  30     description: |
  31       Phandle and clock identifier for external sampling clock.
  32       If not specified, the internal crystal oscillator will be used.
  33     maxItems: 1
  34
  35   interrupts:
  36     description: IRQ line of the ADC
  37     maxItems: 1
  38
  39   microchip,device-addr:
  40     description: Device address when multiple MCP3911 chips are present on the same SPI bus.
  41     allOf:
  42       - $ref: /schemas/types.yaml#/definitions/uint32
  43       - enum: [0, 1, 2, 3]
  44       - default: 0
  45
  46   vref-supply:
  47     description: |
  48       Phandle to the external reference voltage supply.
  49       If not specified, the internal voltage reference (1.2V) will be used.
  50
  51 required:
  52   - compatible
  53   - reg
  54
  55 examples:
  56   - |
  57     spi {
  58       #address-cells = <1>;
  59       #size-cells = <0>;
  60
  61       adc@0 {
  62         compatible = "microchip,mcp3911";
  63         reg = <0>;
  64         interrupt-parent = <&gpio5>;
  65         interrupts = <15 2>;
  66         spi-max-frequency = <20000000>;
  67         microchip,device-addr = <0>;
  68         vref-supply = <&vref_reg>;
  69         clocks = <&xtal>;
  70       };
  71     };