Documentation/devicetree/bindings/power/supply/bq2515x.yaml

   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
   8 title: TI bq2515x 500-mA Linear charger family
   9
  10 maintainers:
  11   - Andrew Davis <afd@ti.com>
  12
  13 description: |
  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
  23 properties:
  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
  60 required:
  61   - compatible
  62   - reg
  63   - monitored-battery
  64
  65 additionalProperties: false
  66
  67 examples:
  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     i2c {
  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     };