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

   1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
   2 # Copyright (C) 2020 Texas Instruments Incorporated
   3 %YAML 1.2
   4 ---
   5 $id: "http://devicetree.org/schemas/power/supply/bq25980.yaml#"
   6 $schema: "http://devicetree.org/meta-schemas/core.yaml#"
   7
   8 title: TI BQ25980 Flash Charger
   9
  10 maintainers:
  11   - Dan Murphy <dmurphy@ti.com>
  12   - Ricardo Rivera-Matos <r-rivera-matos@ti.com>
  13
  14 description: |
  15   The BQ25980, BQ25975, and BQ25960 are a series of flash chargers intended
  16   for use in high-power density portable electronics. These inductorless
  17   switching chargers can provide over 97% efficiency by making use of the
  18   switched capacitor architecture.
  19
  20 allOf:
  21   - $ref: power-supply.yaml#
  22
  23 properties:
  24   compatible:
  25     enum:
  26       - ti,bq25980
  27       - ti,bq25975
  28       - ti,bq25960
  29
  30   reg:
  31     maxItems: 1
  32
  33   ti,watchdog-timeout-ms:
  34     description: |
  35       Watchdog timer in milli seconds. 0 disables the watchdog.
  36     default: 0
  37     minimum: 0
  38     maximum: 300000
  39     enum: [ 0, 5000, 10000, 50000, 300000]
  40
  41   ti,sc-ovp-limit-microvolt:
  42     description: |
  43       Minimum input voltage limit in micro volts with a when the charger is in
  44       switch cap mode. 100000 micro volt step.
  45     default: 17800000
  46     minimum: 14000000
  47     maximum: 22000000
  48
  49   ti,sc-ocp-limit-microamp:
  50     description: |
  51       Maximum input current limit in micro amps with a 100000 micro amp step.
  52     minimum: 100000
  53     maximum: 3300000
  54
  55   ti,bypass-ovp-limit-microvolt:
  56     description: |
  57       Minimum input voltage limit in micro volts with a when the charger is in
  58       switch cap mode. 50000 micro volt step.
  59     minimum: 7000000
  60     maximum: 12750000
  61
  62   ti,bypass-ocp-limit-microamp:
  63     description: |
  64       Maximum input current limit in micro amps with a 100000 micro amp step.
  65     minimum: 100000
  66     maximum: 3300000
  67
  68   ti,bypass-enable:
  69     type: boolean
  70     description: Enables bypass mode at boot time
  71
  72   interrupts:
  73     description: |
  74       Indicates that the device state has changed.
  75
  76   monitored-battery:
  77     $ref: /schemas/types.yaml#/definitions/phandle
  78     description: phandle to the battery node being monitored
  79
  80 required:
  81   - compatible
  82   - reg
  83   - monitored-battery
  84
  85 unevaluatedProperties: false
  86
  87 examples:
  88   - |
  89     bat: battery {
  90       compatible = "simple-battery";
  91       constant-charge-current-max-microamp = <4000000>;
  92       constant-charge-voltage-max-microvolt = <8400000>;
  93       precharge-current-microamp = <160000>;
  94       charge-term-current-microamp = <160000>;
  95     };
  96     #include <dt-bindings/gpio/gpio.h>
  97     #include <dt-bindings/interrupt-controller/irq.h>
  98     i2c0 {
  99       #address-cells = <1>;
 100       #size-cells = <0>;
 101
 102       bq25980: charger@65 {
 103           compatible = "ti,bq25980";
 104           reg = <0x65>;
 105           interrupt-parent = <&gpio1>;
 106           interrupts = <16 IRQ_TYPE_EDGE_FALLING>;
 107           ti,watchdog-timer = <0>;
 108           ti,sc-ocp-limit-microamp = <2000000>;
 109           ti,sc-ovp-limit-microvolt = <17800000>;
 110           monitored-battery = <&bat>;
 111       };
 112     };
 113
 114 ...