adi,ad5755.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/adi,ad5755.yaml#
  5$schema: http://devicetree.org/meta-schemas/core.yaml#
  6
  7title: Analog Devices AD5755 Multi-Channel DAC
  8
  9maintainers:
 10  - Sean Nyekjaer <sean.nyekjaer@prevas.dk>
 11
 12properties:
 13  compatible:
 14    enum:
 15      - adi,ad5755
 16      - adi,ad5755-1
 17      - adi,ad5757
 18      - adi,ad5735
 19      - adi,ad5737
 20
 21  reg:
 22    maxItems: 1
 23
 24  spi-cpha:
 25    description: Either this or spi-cpol but not both.
 26  spi-cpol: true
 27
 28  adi,ext-dc-dc-compenstation-resistor:
 29    $ref: /schemas/types.yaml#/definitions/flag
 30    description:
 31      Set if the hardware have an external resistor and thereby bypasses
 32      the internal compensation resistor.
 33
 34  adi,dc-dc-phase:
 35    $ref: /schemas/types.yaml#/definitions/uint32
 36    enum: [0, 1, 2, 3]
 37    description: |
 38      Valid values for DC DC Phase control is:
 39      0: All dc-to-dc converters clock on the same edge.
 40      1: Channel A and Channel B clock on the same edge,
 41         Channel C and Channel D clock on opposite edges.
 42      2: Channel A and Channel C clock on the same edge,
 43         Channel B and Channel D clock on opposite edges.
 44      3: Channel A, Channel B, Channel C, and Channel D
 45         clock 90 degrees out of phase from each other.
 46
 47  adi,dc-dc-freq-hz:
 48    enum: [250000, 410000, 650000]
 49
 50  adi,dc-dc-max-microvolt:
 51    description:
 52      Maximum allowed Vboost voltage supplied by the dc-to-dc converter.
 53    enum: [23000000, 24500000, 27000000, 29500000]
 54
 55  "#address-cells":
 56    const: 1
 57
 58  "#size-cells":
 59    const: 0
 60
 61  "#io-channel-cells":
 62    const: 1
 63
 64required:
 65  - compatible
 66  - reg
 67
 68patternProperties:
 69  "^channel@[0-7]$":
 70    type: object
 71    description: Child node to describe a channel
 72    properties:
 73      reg:
 74        maxItems: 1
 75
 76      adi,mode:
 77        $ref: /schemas/types.yaml#/definitions/uint32
 78        minimum: 0
 79        maximum: 6
 80        description: |
 81          Valid values for DAC modes is:
 82          0: 0 V to 5 V voltage range.
 83          1: 0 V to 10 V voltage range.
 84          2: Plus minus 5 V voltage range.
 85          3: Plus minus 10 V voltage range.
 86          4: 4 mA to 20 mA current range.
 87          5: 0 mA to 20 mA current range.
 88          6: 0 mA to 24 mA current range.
 89
 90      adi,ext-current-sense-resistor:
 91        $ref: /schemas/types.yaml#/definitions/flag
 92        description:
 93          Set if the hardware has an external current sense resistor
 94
 95      adi,enable-voltage-overrange:
 96        $ref: /schemas/types.yaml#/definitions/flag
 97        description: Enable voltage overrange
 98
 99      adi,slew:
100        $ref: /schemas/types.yaml#/definitions/uint32-array
101        description: |
102          Array of slewrate settings should contain 3 fields:
103          1: Should be either 0 or 1 in order to enable or disable slewrate.
104          2: Slew rate update frequency
105          3: Slew step size
106        items:
107          - enum: [0, 1]
108          - enum: [64000, 32000, 16000, 8000, 4000, 2000, 1000, 500, 250, 125, 64, 32, 16, 8, 4, 0]
109          - enum: [1, 2, 4, 16, 32, 64, 128, 256]
110
111    required:
112      - reg
113
114    additionalProperties: false
115
116oneOf:
117  - required:
118      - spi-cpha
119  - required:
120      - spi-cpol
121
122allOf:
123  - $ref: /schemas/spi/spi-peripheral-props.yaml#
124
125unevaluatedProperties: false
126
127examples:
128  - |
129    spi {
130        #address-cells = <1>;
131        #size-cells = <0>;
132
133        dac@0 {
134            #address-cells = <1>;
135            #size-cells = <0>;
136            compatible = "adi,ad5755";
137            reg = <0>;
138            spi-max-frequency = <1000000>;
139            spi-cpha;
140            adi,dc-dc-phase = <0>;
141            adi,dc-dc-freq-hz = <410000>;
142            adi,dc-dc-max-microvolt = <23000000>;
143            channel@0 {
144                reg = <0>;
145                adi,mode = <4>;
146                adi,ext-current-sense-resistor;
147                adi,slew = <0 64000 1>;
148            };
149            channel@1 {
150                reg = <1>;
151                adi,mode = <4>;
152                adi,ext-current-sense-resistor;
153                adi,slew = <0 64000 1>;
154            };
155            channel@2 {
156                reg = <2>;
157                adi,mode = <4>;
158                adi,ext-current-sense-resistor;
159                adi,slew = <0 64000 1>;
160            };
161            channel@3 {
162                reg = <3>;
163                adi,mode = <4>;
164                adi,ext-current-sense-resistor;
165                adi,slew = <0 64000 1>;
166            };
167        };
168    };
169...