xref: /linux/Documentation/devicetree/bindings/power/supply/bq2515x.yaml (revision 00a37271c8a68070dc64f81a5d64644beb4cef2f) 
1# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2# Copyright (C) 2020 Texas Instruments Incorporated
3%YAML 1.2
4---
5$id: http://devicetree.org/schemas/power/supply/bq2515x.yaml#
6$schema: http://devicetree.org/meta-schemas/core.yaml#
7
8title: TI bq2515x 500-mA Linear charger family
9
10maintainers:
11  - Andrew Davis <afd@ti.com>
12
13description: |
14  The BQ2515x family is a highly integrated battery charge management IC that
15  integrates the most common functions for wearable devices, namely a charger,
16  an output voltage rail, ADC for battery and system monitoring, and
17  push-button controller.
18
19  Specifications about the charger can be found at:
20    http://www.ti.com/lit/ds/symlink/bq25150.pdf
21    http://www.ti.com/lit/ds/symlink/bq25155.pdf
22
23properties:
24  compatible:
25    enum:
26      - ti,bq25150
27      - ti,bq25155
28
29  reg:
30    maxItems: 1
31    description: I2C address of the charger.
32
33  ac-detect-gpios:
34    description: |
35       GPIO used for connecting the bq2515x device PG (AC Detect)
36       pin.
37    maxItems: 1
38
39  reset-gpios:
40    description: GPIO used for hardware reset.
41    maxItems: 1
42
43  powerdown-gpios:
44    description: GPIO used for low power mode of IC.
45    maxItems: 1
46
47  charge-enable-gpios:
48    description: GPIO used to turn on and off charging.
49    maxItems: 1
50
51  input-current-limit-microamp:
52    description: Maximum input current in micro Amps.
53    minimum: 50000
54    maximum: 500000
55
56  monitored-battery: true
57
58required:
59  - compatible
60  - reg
61  - monitored-battery
62
63allOf:
64  - $ref: power-supply.yaml#
65
66additionalProperties: false
67
68examples:
69  - |
70    bat: battery {
71      compatible = "simple-battery";
72      constant-charge-current-max-microamp = <50000>;
73      precharge-current-microamp = <2500>;
74      constant-charge-voltage-max-microvolt = <4000000>;
75    };
76    #include <dt-bindings/gpio/gpio.h>
77    i2c {
78      #address-cells = <1>;
79      #size-cells = <0>;
80
81      bq25150: charger@6b {
82        compatible = "ti,bq25150";
83        reg = <0x6b>;
84        monitored-battery = <&bat>;
85        input-current-limit-microamp = <100000>;
86
87        ac-detect-gpios = <&gpio1 28 GPIO_ACTIVE_HIGH>;
88        reset-gpios = <&gpio0 14 GPIO_ACTIVE_HIGH>;
89        powerdown-gpios = <&gpio0 15 GPIO_ACTIVE_HIGH>;
90        charge-enable-gpios = <&gpio0 13 GPIO_ACTIVE_LOW>;
91      };
92    };
93