Book a Demo!
CoCalc Logo Icon
StoreFeaturesDocsShareSupportNewsAboutPoliciesSign UpSign In
torvalds
GitHub Repository: torvalds/linux
 Path: blob/master/Documentation/devicetree/bindings/iio/dac/adi,ad5758.yaml
26309 views
1
# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)

2
%YAML 1.2

3
---

4
$id: http://devicetree.org/schemas/iio/dac/adi,ad5758.yaml#

5
$schema: http://devicetree.org/meta-schemas/core.yaml#

6


7
title: Analog Devices AD5758 DAC

8


9
maintainers:

10
  - Michael Hennerich <Michael.Hennerich@analog.com>

11


12
properties:

13
  compatible:

14
    const: adi,ad5758

15


16
  reg:

17
    maxItems: 1

18


19
  spi-cpha: true

20


21
  adi,dc-dc-mode:

22
    $ref: /schemas/types.yaml#/definitions/uint32

23
    enum: [1, 2, 3]

24
    description: |

25
      Mode of operation of the dc-to-dc converter

26
      Dynamic Power Control (DPC)

27
      In this mode, the AD5758 circuitry senses the output voltage and

28
      dynamically regulates the supply voltage, VDPC+, to meet compliance

29
      requirements plus an optimized headroom voltage for the output buffer.

30


31
      Programmable Power Control (PPC)

32
      In this mode, the VDPC+ voltage is user-programmable to a fixed level

33
      that needs to accommodate the maximum output load required.

34


35
      The output of the DAC core is either converted to a current or

36
      voltage output at the VIOUT pin. Only one mode can be enabled at

37
      any one time.

38


39
      The following values are currently supported:

40
      * 1: DPC current mode

41
      * 2: DPC voltage mode

42
      * 3: PPC current mode

43


44
      Depending on the selected output mode (voltage or current) one of the

45
      two properties must be present:

46


47
  adi,range-microvolt:

48
    description: |

49
      Voltage output range specified as <minimum, maximum>

50
    oneOf:

51
      - items:

52
          - const: 0

53
          - enum: [5000000, 10000000]

54
      - items:

55
          - const: -5000000

56
          - const: 5000000

57
      - items:

58
          - const: -10000000

59
          - const: 10000000

60


61
  adi,range-microamp:

62
    description: |

63
      Current output range specified as <minimum, maximum>

64
    oneOf:

65
      - items:

66
          - const: 0

67
          - enum: [20000, 24000]

68
      - items:

69
          - const: 4

70
          - const: 24000

71
      - items:

72
          - const: -20000

73
          - const: 20000

74
      - items:

75
          - const: -24000

76
          - const: 24000

77
      - items:

78
          - const: -1000

79
          - const: 22000

80


81
  reset-gpios:

82
    maxItems: 1

83


84
  adi,dc-dc-ilim-microamp:

85
    enum: [150000, 200000, 250000, 300000, 350000, 400000]

86
    description: |

87
      The dc-to-dc converter current limit.

88


89
  adi,slew-time-us:

90
    description: |

91
      The time it takes for the output to reach the full scale [uS]

92
    minimum: 133

93
    maximum: 1023984375

94


95
required:

96
  - compatible

97
  - reg

98
  - spi-cpha

99
  - adi,dc-dc-mode

100


101
allOf:

102
  - $ref: /schemas/spi/spi-peripheral-props.yaml#

103
  - if:

104
      properties:

105
        adi,dc-dc-mode:

106
          enum: [1, 3]

107
    then:

108
      properties:

109
        adi,range-microvolt: false

110
      required:

111
        - adi,range-microamp

112
    else:

113
      properties:

114
        adi,range-microamp: false

115
      required:

116
        - adi,range-microvolt

117


118
unevaluatedProperties: false

119


120
examples:

121
  - |

122
    spi {

123
        #address-cells = <1>;

124
        #size-cells = <0>;

125


126
        dac@0 {

127
            compatible = "adi,ad5758";

128
            reg = <0>;

129
            spi-max-frequency = <1000000>;

130
            spi-cpha;

131


132
            reset-gpios = <&gpio 22 0>;

133


134
            adi,dc-dc-mode = <2>;

135
            adi,range-microvolt = <0 10000000>;

136
            adi,dc-dc-ilim-microamp = <200000>;

137
            adi,slew-time-us = <125000>;

138
        };

139
    };

140
...

141


142