xref: /freebsd/sys/contrib/device-tree/Bindings/iio/dac/microchip,mcp4821.yaml (revision 96190b4fef3b4a0cc3ca0606b0c4e3e69a5e6717) 
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,mcp4821.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Microchip MCP4821 and similar DACs
8
9description: |
10  Supports MCP48x1 (single channel) and MCP48x2 (dual channel) series of DACs.
11  Device supports simplex communication over SPI in Mode 0 and Mode 3.
12
13  +---------+--------------+-------------+
14  | Device  |  Resolution  |   Channels  |
15  |---------|--------------|-------------|
16  | MCP4801 |     8-bit    |      1      |
17  | MCP4802 |     8-bit    |      2      |
18  | MCP4811 |    10-bit    |      1      |
19  | MCP4812 |    10-bit    |      2      |
20  | MCP4821 |    12-bit    |      1      |
21  | MCP4822 |    12-bit    |      2      |
22  +---------+--------------+-------------+
23
24  Datasheet:
25    MCP48x1: https://ww1.microchip.com/downloads/en/DeviceDoc/22244B.pdf
26    MCP48x2: https://ww1.microchip.com/downloads/en/DeviceDoc/20002249B.pdf
27
28maintainers:
29  - Anshul Dalal <anshulusr@gmail.com>
30
31allOf:
32  - $ref: /schemas/spi/spi-peripheral-props.yaml#
33
34properties:
35  compatible:
36    enum:
37      - microchip,mcp4801
38      - microchip,mcp4802
39      - microchip,mcp4811
40      - microchip,mcp4812
41      - microchip,mcp4821
42      - microchip,mcp4822
43
44  reg:
45    maxItems: 1
46
47  vdd-supply: true
48
49  ldac-gpios:
50    description: |
51      Active Low LDAC (Latch DAC Input) pin used to update the DAC output.
52    maxItems: 1
53
54  powerdown-gpios:
55    description: |
56      Active Low SHDN pin used to enter the shutdown mode.
57    maxItems: 1
58
59  spi-cpha: true
60  spi-cpol: true
61
62required:
63  - compatible
64  - reg
65  - vdd-supply
66
67additionalProperties: false
68
69examples:
70  - |
71    #include <dt-bindings/gpio/gpio.h>
72
73    spi {
74        #address-cells = <1>;
75        #size-cells = <0>;
76
77        dac@0 {
78            compatible = "microchip,mcp4821";
79            reg = <0>;
80            vdd-supply = <&vdd_regulator>;
81            ldac-gpios = <&gpio0 1 GPIO_ACTIVE_HIGH>;
82            powerdown-gpios = <&gpio0 2 GPIO_ACTIVE_HIGH>;
83            spi-cpha;
84            spi-cpol;
85        };
86    };
87