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/power/suppl 4 $id: http://devicetree.org/schemas/power/supply/gpio-charger.yaml#
5 $schema: http://devicetree.org/meta-schemas/co 5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6 6
7 title: simple battery chargers only communicat 7 title: simple battery chargers only communicating through GPIOs
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 This binding is for all chargers, which are 13 This binding is for all chargers, which are working more or less
14 autonomously, only providing some status GPI 14 autonomously, only providing some status GPIOs and possibly some
15 GPIOs for limited control over the charging 15 GPIOs for limited control over the charging process.
16 16
17 properties: 17 properties:
18 compatible: 18 compatible:
19 const: gpio-charger 19 const: gpio-charger
20 20
21 charger-type: 21 charger-type:
22 enum: 22 enum:
23 - unknown 23 - unknown
24 - battery 24 - battery
25 - ups 25 - ups
26 - mains 26 - mains
27 - usb-sdp # USB standa 27 - usb-sdp # USB standard downstream port
28 - usb-dcp # USB dedica 28 - usb-dcp # USB dedicated charging port
29 - usb-cdp # USB chargi 29 - usb-cdp # USB charging downstream port
30 - usb-aca # USB access 30 - usb-aca # USB accessory charger adapter
31 description: 31 description:
32 Type of the charger, e.g. "mains" for a 32 Type of the charger, e.g. "mains" for a wall charger.
33 33
34 gpios: 34 gpios:
35 maxItems: 1 35 maxItems: 1
36 description: GPIO indicating the charger p 36 description: GPIO indicating the charger presence
37 37
38 charge-status-gpios: 38 charge-status-gpios:
39 maxItems: 1 39 maxItems: 1
40 description: GPIO indicating the charging 40 description: GPIO indicating the charging status
41 41
42 charge-current-limit-gpios: <<
43 minItems: 1 <<
44 maxItems: 32 <<
45 description: GPIOs used for current limiti <<
46 <<
47 charge-current-limit-mapping: <<
48 description: List of tuples with current i <<
49 this order). The tuples must be provided <<
50 current limit. <<
51 $ref: /schemas/types.yaml#/definitions/uin <<
52 items: <<
53 items: <<
54 - description: <<
55 Current limit in uA <<
56 - description: <<
57 Encoded GPIO setting. Bit 0 repres <<
58 charge-current-limit-gpios propert <<
59 GPIO and so on. <<
60 <<
61 required: 42 required:
62 - compatible 43 - compatible
63 44
64 anyOf: 45 anyOf:
65 - required: 46 - required:
66 - gpios 47 - gpios
67 - required: 48 - required:
68 - charge-status-gpios 49 - charge-status-gpios
69 - required: <<
70 - charge-current-limit-gpios <<
71 <<
72 dependencies: <<
73 charge-current-limit-gpios: [ charge-current <<
74 charge-current-limit-mapping: [ charge-curre <<
75 50
76 additionalProperties: false 51 additionalProperties: false
77 52
78 examples: 53 examples:
79 - | 54 - |
80 #include <dt-bindings/gpio/gpio.h> 55 #include <dt-bindings/gpio/gpio.h>
81 56
82 charger { 57 charger {
83 compatible = "gpio-charger"; 58 compatible = "gpio-charger";
84 charger-type = "usb-sdp"; 59 charger-type = "usb-sdp";
85 60
86 gpios = <&gpd 28 GPIO_ACTIVE_LOW>; 61 gpios = <&gpd 28 GPIO_ACTIVE_LOW>;
87 charge-status-gpios = <&gpc 27 GPIO_ACTI 62 charge-status-gpios = <&gpc 27 GPIO_ACTIVE_LOW>;
88 <<
89 charge-current-limit-gpios = <&gpioA 11 <<
90 <&gpioA 12 <<
91 charge-current-limit-mapping = <2500000 <<
92 <700000 0 <<
93 <0 0x02>; <<
94 }; 63 };
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.