Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
dt-bindings:iio:adc:ti,palmas-gpadc: txt to yaml format conversion.
Simple conversion of the binding doc for this subnode of the palmas
PMIC.
Given age of driver and lack interaction with original authors,
I've guessed at Tony for a maintainer on this one. Tony, if you
are happy with that great, otherwise I can default back to myself.
Signed-off-by: Jonathan Cameron <Jonathan.Cameron@huawei.com>
Reviewed-by: Rob Herring <robh@kernel.org>
Cc: Tony Lindgren <tony@atomide.com>
Link: https://lore.kernel.org/r/20201031184854.745828-35-jic23@kernel.org
+87
-48
-48
Documentation/devicetree/bindings/iio/adc/palmas-gpadc.txt
-48
Documentation/devicetree/bindings/iio/adc/palmas-gpadc.txt
···
1
-
* Palmas general purpose ADC IP block devicetree bindings
2
-
3
-
Channels list:
4
-
0 battery type
5
-
1 battery temp NTC (optional current source)
6
-
2 GP
7
-
3 temp (with ext. diode, optional current source)
8
-
4 GP
9
-
5 GP
10
-
6 VBAT_SENSE
11
-
7 VCC_SENSE
12
-
8 Backup Battery voltage
13
-
9 external charger (VCHG)
14
-
10 VBUS
15
-
11 DC-DC current probe (how does this work?)
16
-
12 internal die temp
17
-
13 internal die temp
18
-
14 USB ID pin voltage
19
-
15 test network
20
-
21
-
Required properties:
22
-
- compatible : Must be "ti,palmas-gpadc".
23
-
- #io-channel-cells: Should be set to <1>.
24
-
25
-
Optional sub-nodes:
26
-
ti,channel0-current-microamp: Channel 0 current in uA.
27
-
Values are rounded to derive 0uA, 5uA, 15uA, 20uA.
28
-
ti,channel3-current-microamp: Channel 3 current in uA.
29
-
Values are rounded to derive 0uA, 10uA, 400uA, 800uA.
30
-
ti,enable-extended-delay: Enable extended delay.
31
-
32
-
Example:
33
-
34
-
pmic {
35
-
compatible = "ti,twl6035-pmic", "ti,palmas-pmic";
36
-
...
37
-
gpadc {
38
-
compatible = "ti,palmas-gpadc";
39
-
interrupts = <18 0
40
-
16 0
41
-
17 0>;
42
-
#io-channel-cells = <1>;
43
-
ti,channel0-current-microamp = <5>;
44
-
ti,channel3-current-microamp = <10>;
45
-
};
46
-
};
47
-
...
48
-
};
+87
Documentation/devicetree/bindings/iio/adc/ti,palmas-gpadc.yaml
+87
Documentation/devicetree/bindings/iio/adc/ti,palmas-gpadc.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/ti,palmas-gpadc.yaml#
5
+
$schema: http://devicetree.org/meta-schemas/core.yaml#
6
+
7
+
title: Palmas general purpose ADC IP block devicetree bindings
8
+
9
+
maintainers:
10
+
- Tony Lindgren <tony@atomide.com>
11
+
12
+
description: |
13
+
This ADC is often used to provide channels via the io-channels
14
+
consumer framework.
15
+
Channels list:
16
+
0 battery type
17
+
1 battery temp NTC (optional current source)
18
+
2 GP
19
+
3 temp (with ext. diode, optional current source)
20
+
4 GP
21
+
5 GP
22
+
6 VBAT_SENSE
23
+
7 VCC_SENSE
24
+
8 Backup Battery voltage
25
+
9 external charger (VCHG)
26
+
10 VBUS
27
+
11 DC-DC current probe (how does this work?)
28
+
12 internal die temp
29
+
13 internal die temp
30
+
14 USB ID pin voltage
31
+
15 test network
32
+
33
+
properties:
34
+
compatible:
35
+
const: ti,palmas-gpadc
36
+
37
+
interrupts:
38
+
minItems: 1
39
+
maxItems: 3
40
+
41
+
"#io-channel-cells":
42
+
const: 1
43
+
44
+
ti,channel0-current-microamp:
45
+
$ref: /schemas/types.yaml#/definitions/uint32
46
+
description: Channel 0 current in uA.
47
+
enum:
48
+
- 0
49
+
- 5
50
+
- 15
51
+
- 20
52
+
53
+
ti,channel3-current-microamp:
54
+
$ref: /schemas/types.yaml#/definitions/uint32
55
+
description: Channel 3 current in uA.
56
+
enum:
57
+
- 0
58
+
- 10
59
+
- 400
60
+
- 800
61
+
62
+
ti,enable-extended-delay:
63
+
$ref: /schemas/types.yaml#/definitions/flag
64
+
description: Enable extended delay.
65
+
66
+
additionalProperties: false
67
+
68
+
required:
69
+
- compatible
70
+
- "#io-channel-cells"
71
+
72
+
examples:
73
+
- |
74
+
#include <dt-bindings/clock/mt8183-clk.h>
75
+
pmic {
76
+
compatible = "ti,twl6035-pmic", "ti,palmas-pmic";
77
+
adc {
78
+
compatible = "ti,palmas-gpadc";
79
+
interrupts = <18 0
80
+
16 0
81
+
17 0>;
82
+
#io-channel-cells = <1>;
83
+
ti,channel0-current-microamp = <5>;
84
+
ti,channel3-current-microamp = <10>;
85
+
};
86
+
};
87
+
...