| # 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. | |
| minimum: 0 | |
| maximum: 7 | |
| 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@60 { | |
| compatible = "microchip,mcp47feb02"; | |
| reg = <0x60>; | |
| 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"; | |
| }; | |
| }; | |
| }; | |
| ... |