1 # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-C 1 # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2 # Copyright 2019-2020 Artur Rojek 2 # Copyright 2019-2020 Artur Rojek
3 %YAML 1.2 3 %YAML 1.2
4 --- 4 ---
5 $id: http://devicetree.org/schemas/iio/adc/ing 5 $id: http://devicetree.org/schemas/iio/adc/ingenic,adc.yaml#
6 $schema: http://devicetree.org/meta-schemas/co 6 $schema: http://devicetree.org/meta-schemas/core.yaml#
7 7
8 title: Ingenic JZ47xx ADC controller IIO 8 title: Ingenic JZ47xx ADC controller IIO
9 9
10 maintainers: 10 maintainers:
11 - Artur Rojek <contact@artur-rojek.eu> 11 - Artur Rojek <contact@artur-rojek.eu>
12 12
13 description: > 13 description: >
14 Industrial I/O subsystem bindings for ADC co 14 Industrial I/O subsystem bindings for ADC controller found in
15 Ingenic JZ47xx SoCs. 15 Ingenic JZ47xx SoCs.
16 16
17 ADC clients must use the format described in 17 ADC clients must use the format described in
18 https://github.com/devicetree-org/dt-schema/ 18 https://github.com/devicetree-org/dt-schema/blob/master/schemas/iio/iio-consumer.yaml,
19 giving a phandle and IIO specifier pair ("io 19 giving a phandle and IIO specifier pair ("io-channels") to the ADC controller.
20 20
21 properties: 21 properties:
22 compatible: 22 compatible:
23 enum: 23 enum:
24 - ingenic,jz4725b-adc 24 - ingenic,jz4725b-adc
25 - ingenic,jz4740-adc 25 - ingenic,jz4740-adc
26 - ingenic,jz4760-adc 26 - ingenic,jz4760-adc
27 - ingenic,jz4760b-adc 27 - ingenic,jz4760b-adc
28 - ingenic,jz4770-adc 28 - ingenic,jz4770-adc
29 29
30 '#io-channel-cells': 30 '#io-channel-cells':
31 const: 1 31 const: 1
32 description: 32 description:
33 Must be set to <1> to indicate channels 33 Must be set to <1> to indicate channels are selected by index.
34 34
35 reg: 35 reg:
36 maxItems: 1 36 maxItems: 1
37 37
38 clocks: 38 clocks:
39 maxItems: 1 39 maxItems: 1
40 40
41 clock-names: 41 clock-names:
42 items: 42 items:
43 - const: adc 43 - const: adc
44 44
45 interrupts: 45 interrupts:
46 maxItems: 1 46 maxItems: 1
47 47
48 ingenic,use-internal-divider: 48 ingenic,use-internal-divider:
49 description: 49 description:
50 If present, battery voltage is read from 50 If present, battery voltage is read from the VBAT_IR pin, which has an
51 internal 1/4 divider. If absent, it is r 51 internal 1/4 divider. If absent, it is read through the VBAT_ER pin,
52 which does not have such a divider. 52 which does not have such a divider.
53 type: boolean 53 type: boolean
54 54
55 if: 55 if:
56 not: 56 not:
57 properties: 57 properties:
58 compatible: 58 compatible:
59 contains: 59 contains:
60 const: ingenic,jz4760b-adc 60 const: ingenic,jz4760b-adc
61 then: 61 then:
62 properties: 62 properties:
63 ingenic,use-internal-divider: false 63 ingenic,use-internal-divider: false
64 64
65 required: 65 required:
66 - compatible 66 - compatible
67 - '#io-channel-cells' 67 - '#io-channel-cells'
68 - reg 68 - reg
69 - clocks 69 - clocks
70 - clock-names 70 - clock-names
71 - interrupts 71 - interrupts
72 72
73 additionalProperties: false 73 additionalProperties: false
74 74
75 examples: 75 examples:
76 - | 76 - |
77 #include <dt-bindings/clock/ingenic,jz4740 77 #include <dt-bindings/clock/ingenic,jz4740-cgu.h>
78 #include <dt-bindings/iio/adc/ingenic,adc. 78 #include <dt-bindings/iio/adc/ingenic,adc.h>
79 79
80 adc@10070000 { 80 adc@10070000 {
81 compatible = "ingenic,jz4740-adc"; 81 compatible = "ingenic,jz4740-adc";
82 #io-channel-cells = <1>; 82 #io-channel-cells = <1>;
83 83
84 reg = <0x10070000 0x30>; 84 reg = <0x10070000 0x30>;
85 85
86 clocks = <&cgu JZ4740_CLK_ADC>; 86 clocks = <&cgu JZ4740_CLK_ADC>;
87 clock-names = "adc"; 87 clock-names = "adc";
88 88
89 interrupt-parent = <&intc>; 89 interrupt-parent = <&intc>;
90 interrupts = <18>; 90 interrupts = <18>;
91 }; 91 };
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.