1 # SPDX-License-Identifier: (GPL-2.0-only OR BS 1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2 %YAML 1.2 2 %YAML 1.2
3 --- 3 ---
4 $id: http://devicetree.org/schemas/power/suppl 4 $id: http://devicetree.org/schemas/power/supply/adc-battery.yaml#
5 $schema: http://devicetree.org/meta-schemas/co 5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6 6
7 title: ADC battery 7 title: ADC battery
8 8
9 maintainers: 9 maintainers:
10 - Sebastian Reichel <sre@kernel.org> 10 - Sebastian Reichel <sre@kernel.org>
11 11
12 description: 12 description:
13 Basic battery capacity meter, which only rep 13 Basic battery capacity meter, which only reports basic battery data
14 via ADC channels and optionally indicate tha 14 via ADC channels and optionally indicate that the battery is full by
15 polling a GPIO line. 15 polling a GPIO line.
16 16
17 The voltage is expected to be measured betwe 17 The voltage is expected to be measured between the battery terminals
18 and mandatory. The optional current/power ch 18 and mandatory. The optional current/power channel is expected to
19 monitor the current/power flowing out of the 19 monitor the current/power flowing out of the battery. Last but not
20 least the temperature channel is supposed to 20 least the temperature channel is supposed to measure the battery
21 temperature. 21 temperature.
22 22
23 allOf: 23 allOf:
24 - $ref: power-supply.yaml# 24 - $ref: power-supply.yaml#
25 25
26 properties: 26 properties:
27 compatible: 27 compatible:
28 const: adc-battery 28 const: adc-battery
29 29
30 charged-gpios: 30 charged-gpios:
31 description: 31 description:
32 GPIO which signals that the battery is f 32 GPIO which signals that the battery is fully charged. The GPIO is
33 often provided by charger ICs, that are 33 often provided by charger ICs, that are not software controllable.
34 maxItems: 1 34 maxItems: 1
35 35
36 io-channels: 36 io-channels:
37 minItems: 1 37 minItems: 1
38 maxItems: 4 38 maxItems: 4
39 39
40 io-channel-names: 40 io-channel-names:
41 minItems: 1 41 minItems: 1
42 items: 42 items:
43 - const: voltage 43 - const: voltage
44 - enum: [ current, power, temperature ] 44 - enum: [ current, power, temperature ]
45 - enum: [ power, temperature ] 45 - enum: [ power, temperature ]
46 - const: temperature 46 - const: temperature
47 47
48 monitored-battery: true 48 monitored-battery: true
49 49
50 required: 50 required:
51 - compatible 51 - compatible
52 - io-channels 52 - io-channels
53 - io-channel-names 53 - io-channel-names
54 - monitored-battery 54 - monitored-battery
55 55
56 unevaluatedProperties: false 56 unevaluatedProperties: false
57 57
58 examples: 58 examples:
59 - | 59 - |
60 #include <dt-bindings/gpio/gpio.h> 60 #include <dt-bindings/gpio/gpio.h>
61 61
62 fuel-gauge { 62 fuel-gauge {
63 compatible = "adc-battery"; 63 compatible = "adc-battery";
64 charged-gpios = <&gpio 42 GPIO_ACTIVE_ 64 charged-gpios = <&gpio 42 GPIO_ACTIVE_HIGH>;
65 io-channels = <&adc 13>, <&adc 37>; 65 io-channels = <&adc 13>, <&adc 37>;
66 io-channel-names = "voltage", "current 66 io-channel-names = "voltage", "current";
67 67
68 power-supplies = <&charger>; 68 power-supplies = <&charger>;
69 monitored-battery = <&battery>; 69 monitored-battery = <&battery>;
70 }; 70 };
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.