mirror of
https://github.com/torvalds/linux.git
synced 2026-04-27 11:02:31 -04:00
4ba12d3041
This is the device tree schema for iio driver for Microchip MCP47F(E/V)B(0/1/2)1, MCP47F(E/V)B(0/1/2)2, MCP47F(E/V)B(0/1/2)4 and MCP47F(E/V)B(0/1/2)8 series of buffered voltage output Digital-to-Analog Converters with nonvolatile or volatile memory and an I2C Interface. The families support up to 8 output channels. The devices can be 8-bit, 10-bit and 12-bit. Signed-off-by: Ariana Lazar <ariana.lazar@microchip.com> Reviewed-by: Conor Dooley <conor.dooley@microchip.com> Signed-off-by: Jonathan Cameron <Jonathan.Cameron@huawei.com>
303 lines
9.9 KiB
YAML
303 lines
9.9 KiB
YAML
# 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";
|
||
};
|
||
};
|
||
};
|
||
...
|