xref: /freebsd/sys/contrib/device-tree/Bindings/power/supply/bq2515x.yaml (revision 657729a89dd578d8cfc70d6616f5c65a48a8b33a) 
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:
57    $ref: /schemas/types.yaml#/definitions/phandle
58    description: phandle to the battery node being monitored
59
60required:
61  - compatible
62  - reg
63  - monitored-battery
64
65additionalProperties: false
66
67examples:
68  - |
69    bat: battery {
70      compatible = "simple-battery";
71      constant-charge-current-max-microamp = <50000>;
72      precharge-current-microamp = <2500>;
73      constant-charge-voltage-max-microvolt = <4000000>;
74    };
75    #include <dt-bindings/gpio/gpio.h>
76    i2c0 {
77      #address-cells = <1>;
78      #size-cells = <0>;
79
80      bq25150: charger@6b {
81        compatible = "ti,bq25150";
82        reg = <0x6b>;
83        monitored-battery = <&bat>;
84        input-current-limit-microamp = <100000>;
85
86        ac-detect-gpios = <&gpio1 28 GPIO_ACTIVE_HIGH>;
87        reset-gpios = <&gpio0 14 GPIO_ACTIVE_HIGH>;
88        powerdown-gpios = <&gpio0 15 GPIO_ACTIVE_HIGH>;
89        charge-enable-gpios = <&gpio0 13 GPIO_ACTIVE_LOW>;
90      };
91    };
92