Documentation/devicetree/bindings/iio/dac/microchip,mcp4821.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,mcp4821.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: Microchip MCP4821 and similar DACs
   8
   9 description: |
  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
  28 maintainers:
  29   - Anshul Dalal <anshulusr@gmail.com>
  30
  31 allOf:
  32   - $ref: /schemas/spi/spi-peripheral-props.yaml#
  33
  34 properties:
  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
  62 required:
  63   - compatible
  64   - reg
  65   - vdd-supply
  66
  67 additionalProperties: false
  68
  69 examples:
  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     };