xref: /freebsd/sys/contrib/device-tree/Bindings/power/supply/maxim,max8903.yaml (revision 02e9120893770924227138ba49df1edb3896112a) 
1# SPDX-License-Identifier: GPL-2.0
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/power/supply/maxim,max8903.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Maxim Semiconductor MAX8903 Battery Charger
8
9maintainers:
10  - Sebastian Reichel <sre@kernel.org>
11
12allOf:
13  - $ref: power-supply.yaml#
14
15properties:
16  compatible:
17    const: maxim,max8903
18
19  dok-gpios:
20    maxItems: 1
21    description: Valid DC power has been detected (active low, input)
22
23  uok-gpios:
24    maxItems: 1
25    description: Valid USB power has been detected (active low, input)
26
27  cen-gpios:
28    maxItems: 1
29    description: Charge enable pin (active low, output)
30
31  chg-gpios:
32    maxItems: 1
33    description: Charger status pin (active low, input)
34
35  flt-gpios:
36    maxItems: 1
37    description: Fault pin (active low, output)
38
39  dcm-gpios:
40    maxItems: 1
41    description: Current limit mode setting (DC=1 or USB=0, output)
42
43  usus-gpios:
44    maxItems: 1
45    description: USB suspend pin (active high, output)
46
47required:
48  - compatible
49
50anyOf:
51  - required:
52      - dok-gpios
53  - required:
54      - uok-gpios
55
56additionalProperties: false
57
58examples:
59  - |
60    #include <dt-bindings/gpio/gpio.h>
61    charger {
62      compatible = "maxim,max8903";
63      dok-gpios = <&gpio2 3 GPIO_ACTIVE_LOW>;
64      flt-gpios = <&gpio2 2 GPIO_ACTIVE_LOW>;
65      chg-gpios = <&gpio3 15 GPIO_ACTIVE_LOW>;
66      cen-gpios = <&gpio2 5 GPIO_ACTIVE_LOW>;
67    };
68