Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
dt-bindings:iio:adc:mediatek,mt2701-auxadc: rename and yaml conversion.
The current driver and indeed binding are named after a part that they
do not list in the compatible. Hence renamed the binding to reflect
one that does.
>From the driver it looks like there is a lot more backwards compatibility
than the binding currently reflects. We could consider expressing that
more explicitly in the yaml for the compatible property. I have
added one explicit pair that was present in the upstream dtsi files.
I added Matthias alongside Zhiyong Tao because I don't think
Zhiyong Tao has reviewed recent patches. Please let me know if this
isn't the right thing to do.
Signed-off-by: Jonathan Cameron <Jonathan.Cameron@huawei.com>
Reviewed-by: Rob Herring <robh@kernel.org>
Cc: Zhiyong Tao <zhiyong.tao@mediatek.com>
Cc: Matthias Brugger <matthias.bgg@gmail.com>
Link: https://lore.kernel.org/r/20201031184854.745828-34-jic23@kernel.org
+77
-34
+77
Documentation/devicetree/bindings/iio/adc/mediatek,mt2701-auxadc.yaml
+77
Documentation/devicetree/bindings/iio/adc/mediatek,mt2701-auxadc.yaml
···
1
+
# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2
+
%YAML 1.2
3
+
---
4
+
$id: http://devicetree.org/schemas/iio/adc/mediatek,mt2701-auxadc.yaml#
5
+
$schema: http://devicetree.org/meta-schemas/core.yaml#
6
+
7
+
title: Mediatek AUXADC - ADC on Mediatek mobile SoC (mt65xx/mt81xx/mt27xx)
8
+
9
+
maintainers:
10
+
- Zhiyong Tao <zhiyong.tao@mediatek.com>
11
+
- Matthias Brugger <matthias.bgg@gmail.com>
12
+
13
+
description: |
14
+
The Auxiliary Analog/Digital Converter (AUXADC) is an ADC found
15
+
in some Mediatek SoCs which among other things measures the temperatures
16
+
in the SoC. It can be used directly with register accesses, but it is also
17
+
used by thermal controller which reads the temperatures from the AUXADC
18
+
directly via its own bus interface. See mediatek-thermal bindings
19
+
for the Thermal Controller which holds a phandle to the AUXADC.
20
+
21
+
properties:
22
+
compatible:
23
+
oneOf:
24
+
- enum:
25
+
- mediatek,mt2701-auxadc
26
+
- mediatek,mt2712-auxadc
27
+
- mediatek,mt6765-auxadc
28
+
- mediatek,mt7622-auxadc
29
+
- mediatek,mt8173-auxadc
30
+
- items:
31
+
- enum:
32
+
- mediatek,mt7623-auxadc
33
+
- const: mediatek,mt2701-auxadc
34
+
- items:
35
+
- enum:
36
+
- mediatek,mt8183-auxadc
37
+
- mediatek,mt8516-auxadc
38
+
- const: mediatek,mt8173-auxadc
39
+
40
+
reg:
41
+
maxItems: 1
42
+
43
+
clocks:
44
+
maxItems: 1
45
+
46
+
clock-names:
47
+
const: main
48
+
49
+
"#io-channel-cells":
50
+
const: 1
51
+
52
+
additionalProperties: false
53
+
54
+
required:
55
+
- compatible
56
+
- reg
57
+
- clocks
58
+
- clock-names
59
+
- "#io-channel-cells"
60
+
61
+
examples:
62
+
- |
63
+
#include <dt-bindings/clock/mt8183-clk.h>
64
+
soc {
65
+
#address-cells = <2>;
66
+
#size-cells = <2>;
67
+
68
+
adc@11001000 {
69
+
compatible = "mediatek,mt8183-auxadc",
70
+
"mediatek,mt8173-auxadc";
71
+
reg = <0 0x11001000 0 0x1000>;
72
+
clocks = <&infracfg CLK_INFRA_AUXADC>;
73
+
clock-names = "main";
74
+
#io-channel-cells = <1>;
75
+
};
76
+
};
77
+
...
-34
Documentation/devicetree/bindings/iio/adc/mt6577_auxadc.txt
-34
Documentation/devicetree/bindings/iio/adc/mt6577_auxadc.txt
···
1
-
* Mediatek AUXADC - Analog to Digital Converter on Mediatek mobile soc (mt65xx/mt81xx/mt27xx)
2
-
===============
3
-
4
-
The Auxiliary Analog/Digital Converter (AUXADC) is an ADC found
5
-
in some Mediatek SoCs which among other things measures the temperatures
6
-
in the SoC. It can be used directly with register accesses, but it is also
7
-
used by thermal controller which reads the temperatures from the AUXADC
8
-
directly via its own bus interface. See
9
-
Documentation/devicetree/bindings/thermal/mediatek-thermal.txt
10
-
for the Thermal Controller which holds a phandle to the AUXADC.
11
-
12
-
Required properties:
13
-
- compatible: Should be one of:
14
-
- "mediatek,mt2701-auxadc": For MT2701 family of SoCs
15
-
- "mediatek,mt2712-auxadc": For MT2712 family of SoCs
16
-
- "mediatek,mt6765-auxadc": For MT6765 family of SoCs
17
-
- "mediatek,mt7622-auxadc": For MT7622 family of SoCs
18
-
- "mediatek,mt8173-auxadc": For MT8173 family of SoCs
19
-
- "mediatek,mt8183-auxadc", "mediatek,mt8173-auxadc": For MT8183 family of SoCs
20
-
- "mediatek,mt8516-auxadc", "mediatek,mt8173-auxadc": For MT8516 family of SoCs
21
-
- reg: Address range of the AUXADC unit.
22
-
- clocks: Should contain a clock specifier for each entry in clock-names
23
-
- clock-names: Should contain "main".
24
-
- #io-channel-cells: Should be 1, see ../iio-bindings.txt
25
-
26
-
Example:
27
-
28
-
auxadc: adc@11001000 {
29
-
compatible = "mediatek,mt2701-auxadc";
30
-
reg = <0 0x11001000 0 0x1000>;
31
-
clocks = <&pericfg CLK_PERI_AUXADC>;
32
-
clock-names = "main";
33
-
#io-channel-cells = <1>;
34
-
};