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   - Andrew Davis <afd@ti.com>
  12
  13 description: |
  14   The BQ25980, BQ25975, and BQ25960 are a series of flash chargers intended
  15   for use in high-power density portable electronics. These inductorless
  16   switching chargers can provide over 97% efficiency by making use of the
  17   switched capacitor architecture.
  18
  19 allOf:
  20   - $ref: power-supply.yaml#
  21
  22 properties:
  23   compatible:
  24     enum:
  25       - ti,bq25980
  26       - ti,bq25975
  27       - ti,bq25960
  28
  29   reg:
  30     maxItems: 1
  31
  32   ti,watchdog-timeout-ms:
  33     description: |
  34       Watchdog timer in milli seconds. 0 disables the watchdog.
  35     default: 0
  36     minimum: 0
  37     maximum: 300000
  38     enum: [ 0, 5000, 10000, 50000, 300000]
  39
  40   ti,sc-ovp-limit-microvolt:
  41     description: |
  42       Minimum input voltage limit in micro volts with a when the charger is in
  43       switch cap mode. 100000 micro volt step.
  44     default: 17800000
  45     minimum: 14000000
  46     maximum: 22000000
  47
  48   ti,sc-ocp-limit-microamp:
  49     description: |
  50       Maximum input current limit in micro amps with a 100000 micro amp step.
  51     minimum: 100000
  52     maximum: 3300000
  53
  54   ti,bypass-ovp-limit-microvolt:
  55     description: |
  56       Minimum input voltage limit in micro volts with a when the charger is in
  57       switch cap mode. 50000 micro volt step.
  58     minimum: 7000000
  59     maximum: 12750000
  60
  61   ti,bypass-ocp-limit-microamp:
  62     description: |
  63       Maximum input current limit in micro amps with a 100000 micro amp step.
  64     minimum: 100000
  65     maximum: 3300000
  66
  67   ti,bypass-enable:
  68     type: boolean
  69     description: Enables bypass mode at boot time
  70
  71   interrupts:
  72     maxItems: 1
  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     i2c {
  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-timeout-ms = <0>;
 108           ti,sc-ocp-limit-microamp = <2000000>;
 109           ti,sc-ovp-limit-microvolt = <17800000>;
 110           monitored-battery = <&bat>;
 111       };
 112     };
 113
 114 ...