xref: /linux/Documentation/devicetree/bindings/iio/dac/microchip,mcp47feb02.yaml (revision c17ee635fd3a482b2ad2bf5e269755c2eae5f25e)

# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/iio/dac/microchip,mcp47feb02.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Microchip MCP47F(E/V)B(0/1/2)(1/2/4/8) DAC with I2C Interface Families

maintainers:
  - Ariana Lazar <ariana.lazar@microchip.com>

description: |
  Datasheet for MCP47FEB01, MCP47FEB11, MCP47FEB21, MCP47FEB02, MCP47FEB12,
  MCP47FEB22 can be found here:
    https://ww1.microchip.com/downloads/aemDocuments/documents/OTH/ProductDocuments/DataSheets/20005375A.pdf
  Datasheet for MCP47FVB01, MCP47FVB11, MCP47FVB21, MCP47FVB02, MCP47FVB12,
  MCP47FVB22 can be found here:
    https://ww1.microchip.com/downloads/aemDocuments/documents/OTH/ProductDocuments/DataSheets/20005405A.pdf
  Datasheet for MCP47FEB04, MCP47FEB14, MCP47FEB24, MCP47FEB08, MCP47FEB18,
  MCP47FEB28, MCP47FVB04, MCP47FVB14, MCP47FVB24, MCP47FVB08, MCP47FVB18,
  MCP47FVB28 can be found here:
    https://ww1.microchip.com/downloads/aemDocuments/documents/MSLD/ProductDocuments/DataSheets/MCP47FXBX48-Data-Sheet-DS200006368A.pdf

  +------------+--------------+-------------+-------------+------------+
  | Device     |  Resolution  |   Channels  | Vref number | Memory     |
  |------------|--------------|-------------|-------------|------------|
  | MCP47FEB01 |     8-bit    |      1      |      1      |   EEPROM   |
  | MCP47FEB11 |    10-bit    |      1      |      1      |   EEPROM   |
  | MCP47FEB21 |    12-bit    |      1      |      1      |   EEPROM   |
  |------------|--------------|-------------|-------------|------------|
  | MCP47FEB02 |     8-bit    |      2      |      1      |   EEPROM   |
  | MCP47FEB12 |    10-bit    |      2      |      1      |   EEPROM   |
  | MCP47FEB22 |    12-bit    |      2      |      1      |   EEPROM   |
  |------------|--------------|-------------|-------------|------------|
  | MCP47FVB01 |     8-bit    |      1      |      1      |      RAM   |
  | MCP47FVB11 |    10-bit    |      1      |      1      |      RAM   |
  | MCP47FVB21 |    12-bit    |      1      |      1      |      RAM   |
  |------------|--------------|-------------|-------------|------------|
  | MCP47FVB02 |     8-bit    |      2      |      1      |      RAM   |
  | MCP47FVB12 |    10-bit    |      2      |      1      |      RAM   |
  | MCP47FVB22 |    12-bit    |      2      |      1      |      RAM   |
  |------------|--------------|-------------|-------------|------------|
  | MCP47FVB04 |     8-bit    |      4      |      2      |      RAM   |
  | MCP47FVB14 |    10-bit    |      4      |      2      |      RAM   |
  | MCP47FVB24 |    12-bit    |      4      |      2      |      RAM   |
  |------------|--------------|-------------|-------------|------------|
  | MCP47FVB08 |     8-bit    |      8      |      2      |      RAM   |
  | MCP47FVB18 |    10-bit    |      8      |      2      |      RAM   |
  | MCP47FVB28 |    12-bit    |      8      |      2      |      RAM   |
  |------------|--------------|-------------|-------------|------------|
  | MCP47FEB04 |     8-bit    |      4      |      2      |   EEPROM   |
  | MCP47FEB14 |    10-bit    |      4      |      2      |   EEPROM   |
  | MCP47FEB24 |    12-bit    |      4      |      2      |   EEPROM   |
  |------------|--------------|-------------|-------------|------------|
  | MCP47FEB08 |     8-bit    |      8      |      2      |   EEPROM   |
  | MCP47FEB18 |    10-bit    |      8      |      2      |   EEPROM   |
  | MCP47FEB28 |    12-bit    |      8      |      2      |   EEPROM   |
  +------------+--------------+-------------+-------------+------------+

properties:
  compatible:
    enum:
      - microchip,mcp47feb01
      - microchip,mcp47feb11
      - microchip,mcp47feb21
      - microchip,mcp47feb02
      - microchip,mcp47feb12
      - microchip,mcp47feb22
      - microchip,mcp47fvb01
      - microchip,mcp47fvb11
      - microchip,mcp47fvb21
      - microchip,mcp47fvb02
      - microchip,mcp47fvb12
      - microchip,mcp47fvb22
      - microchip,mcp47fvb04
      - microchip,mcp47fvb14
      - microchip,mcp47fvb24
      - microchip,mcp47fvb08
      - microchip,mcp47fvb18
      - microchip,mcp47fvb28
      - microchip,mcp47feb04
      - microchip,mcp47feb14
      - microchip,mcp47feb24
      - microchip,mcp47feb08
      - microchip,mcp47feb18
      - microchip,mcp47feb28

  reg:
    maxItems: 1

  "#address-cells":
    const: 1

  "#size-cells":
    const: 0

  vdd-supply:
    description:
      Provides power to the chip and it could be used as reference voltage. The
      voltage is used to calculate scale. For parts without EEPROM at powerup
      this will be the selected as voltage reference.

  vref-supply:
    description: |
      Vref pin (it could be found as Vref0 into the datasheet) may be used as a
      voltage reference when this supply is specified. The internal reference
      will be taken into account for voltage reference besides VDD if this supply
      does not exist.

      This supply will be voltage reference for the following outputs:
        - for single-channel device: Vout0;
        - for dual-channel device: Vout0, Vout1;
        - for quad-channel device: Vout0, Vout2;
        - for octal-channel device: Vout0, Vout2, Vout6, Vout8;

  vref1-supply:
    description: |
      Vref1 pin may be used as a voltage reference when this supply is specified.
      The internal reference will be taken into account for voltage reference
      beside VDD if this supply does not exist.

      This supply will be voltage reference for the following outputs:
        - for quad-channel device: Vout1, Vout3;
        - for octal-channel device: Vout1, Vout3, Vout5, Vout7;

  lat-gpios:
    description:
      LAT pin to be used as a hardware trigger to synchronously update the DAC
      channels. The pin is active Low. It could be also found as LAT0 in
      datasheet.
    maxItems: 1

  lat1-gpios:
    description:
      LAT1 pin to be used as a hardware trigger to synchronously update the odd
      DAC channels on devices with 4 and 8 channels. The pin is active Low.
    maxItems: 1

  microchip,vref-buffered:
    type: boolean
    description:
      Enable buffering of the external Vref/Vref0 pin in cases where the
      external reference voltage does not have sufficient current capability in
      order not to drop it’s voltage when connected to the internal resistor
      ladder circuit.

  microchip,vref1-buffered:
    type: boolean
    description:
      Enable buffering of the external Vref1 pin in cases where the external
      reference voltage does not have sufficient current capability in order not
      to drop it’s voltage when connected to the internal resistor ladder
      circuit.

patternProperties:
  "^channel@[0-7]$":
    $ref: dac.yaml
    type: object
    description: Voltage output channel.

    properties:
      reg:
        description: The channel number.
        minItems: 1
        maxItems: 8

      label:
        description: Unique name to identify which channel this is.

    required:
      - reg

    unevaluatedProperties: false

required:
  - compatible
  - reg
  - vdd-supply

allOf:
  - if:
      properties:
        compatible:
          contains:
            enum:
              - microchip,mcp47feb01
              - microchip,mcp47feb11
              - microchip,mcp47feb21
              - microchip,mcp47fvb01
              - microchip,mcp47fvb11
              - microchip,mcp47fvb21
    then:
      properties:
        lat1-gpios: false
        vref1-supply: false
        microchip,vref1-buffered: false
        channel@0:
          properties:
            reg:
              const: 0
      patternProperties:
        "^channel@[1-7]$": false
  - if:
      properties:
        compatible:
          contains:
            enum:
              - microchip,mcp47feb02
              - microchip,mcp47feb12
              - microchip,mcp47feb22
              - microchip,mcp47fvb02
              - microchip,mcp47fvb12
              - microchip,mcp47fvb22
    then:
      properties:
        lat1-gpios: false
        vref1-supply: false
        microchip,vref1-buffered: false
      patternProperties:
        "^channel@[0-1]$":
          properties:
            reg:
              enum: [0, 1]
        "^channel@[2-7]$": false
  - if:
      properties:
        compatible:
          contains:
            enum:
              - microchip,mcp47fvb04
              - microchip,mcp47fvb14
              - microchip,mcp47fvb24
              - microchip,mcp47feb04
              - microchip,mcp47feb14
              - microchip,mcp47feb24
    then:
      patternProperties:
        "^channel@[0-3]$":
          properties:
            reg:
              enum: [0, 1, 2, 3]
        "^channel@[4-7]$": false
  - if:
      properties:
        compatible:
          contains:
            enum:
              - microchip,mcp47fvb08
              - microchip,mcp47fvb18
              - microchip,mcp47fvb28
              - microchip,mcp47feb08
              - microchip,mcp47feb18
              - microchip,mcp47feb28
    then:
      patternProperties:
        "^channel@[0-7]$":
          properties:
            reg:
              enum: [0, 1, 2, 3, 4, 5, 6, 7]
  - if:
      not:
        required:
          - vref-supply
    then:
      properties:
        microchip,vref-buffered: false
  - if:
      not:
        required:
          - vref1-supply
    then:
      properties:
        microchip,vref1-buffered: false

additionalProperties: false

examples:
  - |
    i2c {

        #address-cells = <1>;
        #size-cells = <0>;
        dac@0 {
          compatible = "microchip,mcp47feb02";
          reg = <0>;
          vdd-supply = <&vdac_vdd>;
          vref-supply = <&vref_reg>;

          #address-cells = <1>;
          #size-cells = <0>;
          channel@0 {
            reg = <0>;
            label = "Adjustable_voltage_ch0";
          };

          channel@1 {
            reg = <0x1>;
            label = "Adjustable_voltage_ch1";
          };
      };
    };
...