Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
dt-bindings:iio:dac:microchip,mcp4725 yaml conversion
I'm not sure vdd-supply absolutely has to be provided if vref-supply
is, but as the previous binding docs stated it was required it seems
reasonable to leave it as such.
Signed-off-by: Jonathan Cameron <Jonathan.Cameron@huawei.com>
Reviewed-by: Rob Herring <robh@kernel.org>
Cc: Tomas Novotny <tomas@novotny.cz>
Link: https://lore.kernel.org/r/20201031134110.724233-21-jic23@kernel.org
+71
-35
-35
Documentation/devicetree/bindings/iio/dac/mcp4725.txt
-35
Documentation/devicetree/bindings/iio/dac/mcp4725.txt
···
1
-
Microchip mcp4725 and mcp4726 DAC device driver
2
-
3
-
Required properties:
4
-
- compatible: Must be "microchip,mcp4725" or "microchip,mcp4726"
5
-
- reg: Should contain the DAC I2C address
6
-
- vdd-supply: Phandle to the Vdd power supply. This supply is used as a
7
-
voltage reference on mcp4725. It is used as a voltage reference on
8
-
mcp4726 if there is no vref-supply specified.
9
-
10
-
Optional properties (valid only for mcp4726):
11
-
- vref-supply: Optional phandle to the Vref power supply. Vref pin is
12
-
used as a voltage reference when this supply is specified.
13
-
- microchip,vref-buffered: Boolean to enable buffering of the external
14
-
Vref pin. This boolean is not valid without the vref-supply. Quoting
15
-
the datasheet: This is offered in cases where the reference voltage
16
-
does not have the current capability not to drop its voltage when
17
-
connected to the internal resistor ladder circuit.
18
-
19
-
Examples:
20
-
21
-
/* simple mcp4725 */
22
-
mcp4725@60 {
23
-
compatible = "microchip,mcp4725";
24
-
reg = <0x60>;
25
-
vdd-supply = <&vdac_vdd>;
26
-
};
27
-
28
-
/* mcp4726 with the buffered external reference voltage */
29
-
mcp4726@60 {
30
-
compatible = "microchip,mcp4726";
31
-
reg = <0x60>;
32
-
vdd-supply = <&vdac_vdd>;
33
-
vref-supply = <&vdac_vref>;
34
-
microchip,vref-buffered;
35
-
};
+71
Documentation/devicetree/bindings/iio/dac/microchip,mcp4725.yaml
+71
Documentation/devicetree/bindings/iio/dac/microchip,mcp4725.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,mcp4725.yaml#
5
+
$schema: http://devicetree.org/meta-schemas/core.yaml#
6
+
7
+
title: Microchip mcp4725 and mcp4726 DAC
8
+
9
+
maintainers:
10
+
- Tomas Novotny <tomas@novotny.cz>
11
+
12
+
properties:
13
+
compatible:
14
+
enum:
15
+
- microchip,mcp4725
16
+
- microchip,mcp4726
17
+
18
+
reg:
19
+
maxItems: 1
20
+
21
+
vdd-supply:
22
+
description: |
23
+
Provides both power and acts as the reference supply on the mcp4725.
24
+
For the mcp4726 it will be used as the reference voltage if vref-supply
25
+
is not provided.
26
+
27
+
vref-supply:
28
+
description:
29
+
Vref pin is used as a voltage reference when this supply is specified.
30
+
31
+
microchip,vref-buffered:
32
+
type: boolean
33
+
description: |
34
+
Enable buffering of the external Vref pin. This boolean is not valid
35
+
without the vref-supply. Quoting the datasheet: This is offered in
36
+
cases where the reference voltage does not have the current
37
+
capability not to drop its voltage when connected to the internal
38
+
resistor ladder circuit.
39
+
40
+
allOf:
41
+
- if:
42
+
not:
43
+
properties:
44
+
compatible:
45
+
contains:
46
+
const: microchip,mcp4726
47
+
then:
48
+
properties:
49
+
vref-supply: false
50
+
microchip,vref-buffered: false
51
+
52
+
required:
53
+
- compatible
54
+
- reg
55
+
- vdd-supply
56
+
57
+
additionalProperties: false
58
+
59
+
examples:
60
+
- |
61
+
i2c {
62
+
#address-cells = <1>;
63
+
#size-cells = <0>;
64
+
65
+
mcp4725@60 {
66
+
compatible = "microchip,mcp4725";
67
+
reg = <0x60>;
68
+
vdd-supply = <&vdac_vdd>;
69
+
};
70
+
};
71
+
...