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/bindings/iio/adc/microchip,mcp3911.yaml#"
6$schema: "http://devicetree.org/meta-schemas/core.yaml#"
7
8title: Microchip MCP3911 Dual channel analog front end (ADC)
9
10maintainers:
11  - Marcus Folkesson <marcus.folkesson@gmail.com>
12  - Kent Gustavsson <nedo80@gmail.com>
13
14description: |
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
18properties:
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
51required:
52  - compatible
53  - reg
54
55examples:
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    };
72