xref: /freebsd/sys/contrib/device-tree/Bindings/iio/dac/microchip,mcp4725.yaml (revision d0b2dbfa0ecf2bbc9709efc5e20baf8e4b44bbbf) 
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
7title: Microchip mcp4725 and mcp4726 DAC
8
9maintainers:
10  - Tomas Novotny <tomas@novotny.cz>
11
12properties:
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
40allOf:
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
72required:
73  - compatible
74  - reg
75
76additionalProperties: false
77
78examples:
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...
91