1 # SPDX-License-Identifier: GPL-2.0 1 # SPDX-License-Identifier: GPL-2.0
2 %YAML 1.2 2 %YAML 1.2
3 --- 3 ---
4 $id: http://devicetree.org/schemas/iio/adc/adc 4 $id: http://devicetree.org/schemas/iio/adc/adc.yaml#
5 $schema: http://devicetree.org/meta-schemas/co 5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6 6
7 title: IIO Common Properties for ADC Channels 7 title: IIO Common Properties for ADC Channels
8 8
9 maintainers: 9 maintainers:
10 - Jonathan Cameron <jic23@kernel.org> 10 - Jonathan Cameron <jic23@kernel.org>
11 11
12 description: 12 description:
13 A few properties are defined in a common way 13 A few properties are defined in a common way ADC channels.
14 14
15 properties: 15 properties:
16 $nodename: 16 $nodename:
17 pattern: "^channel(@[0-9a-f]+)?$" 17 pattern: "^channel(@[0-9a-f]+)?$"
18 description: 18 description:
19 A channel index should match reg. 19 A channel index should match reg.
20 20
21 reg: 21 reg:
22 maxItems: 1 22 maxItems: 1
23 23
24 label: 24 label:
25 description: Unique name to identify which 25 description: Unique name to identify which channel this is.
26 26
27 bipolar: 27 bipolar:
28 $ref: /schemas/types.yaml#/definitions/fla 28 $ref: /schemas/types.yaml#/definitions/flag
29 description: If provided, the channel is t 29 description: If provided, the channel is to be used in bipolar mode.
30 30
31 diff-channels: 31 diff-channels:
32 $ref: /schemas/types.yaml#/definitions/uin 32 $ref: /schemas/types.yaml#/definitions/uint32-array
33 maxItems: 2 33 maxItems: 2
34 minItems: 2 34 minItems: 2
35 description: 35 description:
36 Many ADCs have dual Muxes to allow diffe 36 Many ADCs have dual Muxes to allow different input pins to be routed
37 to both the positive and negative inputs 37 to both the positive and negative inputs of a differential ADC.
38 The first value specifies the positive i 38 The first value specifies the positive input pin, the second
39 specifies the negative input pin. 39 specifies the negative input pin.
40 40
41 single-channel: <<
42 $ref: /schemas/types.yaml#/definitions/uin <<
43 description: <<
44 When devices combine single-ended and di <<
45 channel for a single element to be speci <<
46 differential channels). If this and diff <<
47 shall be used instead. <<
48 <<
49 common-mode-channel: <<
50 $ref: /schemas/types.yaml#/definitions/uin <<
51 description: <<
52 Some ADCs have differential input pins t <<
53 single-ended or pseudo-differential inpu <<
54 in addition to single-channel to signal <<
55 not differential but still specify two i <<
56 <<
57 The input pair is specified by setting s <<
58 input pin and common-mode-channel to the <<
59 <<
60 settling-time-us: 41 settling-time-us:
61 description: 42 description:
62 Time between enabling the channel and fi 43 Time between enabling the channel and first stable readings.
63 44
64 oversampling-ratio: 45 oversampling-ratio:
65 $ref: /schemas/types.yaml#/definitions/uin 46 $ref: /schemas/types.yaml#/definitions/uint32
66 description: 47 description:
67 Oversampling is used as replacement of o 48 Oversampling is used as replacement of or addition to the low-pass filter.
68 In some cases, the desired filtering cha 49 In some cases, the desired filtering characteristics are a function the
69 device design and can interact with othe 50 device design and can interact with other characteristics such as
70 settling time. 51 settling time.
71 <<
72 anyOf: <<
73 - oneOf: <<
74 - required: <<
75 - reg <<
76 - diff-channels <<
77 - required: <<
78 - reg <<
79 - single-channel <<
80 - required: <<
81 - reg <<
82 52
83 additionalProperties: true 53 additionalProperties: true
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.