Documentation/devicetree/bindings/power/supply/bq256xx.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/bq256xx.yaml#"
   6 $schema: "http://devicetree.org/meta-schemas/core.yaml#"
   7
   8 title: TI bq256xx Switch Mode Buck Charger
   9
  10 maintainers:
  11   - Ricardo Rivera-Matos <r-rivera-matos@ti.com>
  12
  13 description: |
  14   The bq256xx devices are a family of highly-integrated battery charge
  15   management and system power management ICs for single cell Li-ion and Li-
  16   polymer batteries.
  17
  18   Datasheets:
  19     - https://www.ti.com/lit/ds/symlink/bq25600.pdf
  20     - https://www.ti.com/lit/ds/symlink/bq25601.pdf
  21     - https://www.ti.com/lit/ds/symlink/bq25600d.pdf
  22     - https://www.ti.com/lit/ds/symlink/bq25601d.pdf
  23     - https://www.ti.com/lit/ds/symlink/bq25611d.pdf
  24     - https://www.ti.com/lit/ds/symlink/bq25618.pdf
  25     - https://www.ti.com/lit/ds/symlink/bq25619.pdf
  26
  27 properties:
  28   compatible:
  29     enum:
  30       - ti,bq25600
  31       - ti,bq25601
  32       - ti,bq25600d
  33       - ti,bq25601d
  34       - ti,bq25611d
  35       - ti,bq25618
  36       - ti,bq25619
  37
  38   reg:
  39     maxItems: 1
  40
  41   ti,watchdog-timeout-ms:
  42     default: 0
  43     description: |
  44       Watchdog timer in ms. 0 (default) disables the watchdog
  45     minimum: 0
  46     maximum: 160000
  47     enum: [ 0, 40000, 80000, 160000]
  48
  49   input-voltage-limit-microvolt:
  50     description: |
  51        Minimum input voltage limit in µV with a 100000 µV step
  52     minimum: 3900000
  53     maximum: 5400000
  54
  55   input-current-limit-microamp:
  56     description: |
  57        Maximum input current limit in µA with a 100000 µA step
  58     minimum: 100000
  59     maximum: 3200000
  60
  61   monitored-battery:
  62     $ref: /schemas/types.yaml#/definitions/phandle
  63     description: phandle to the battery node being monitored
  64
  65   interrupts:
  66     maxItems: 1
  67     description: |
  68       Interrupt sends an active low, 256 μs pulse to host to report the charger
  69       device status and faults.
  70
  71 required:
  72   - compatible
  73   - reg
  74   - monitored-battery
  75
  76 additionalProperties: false
  77
  78 examples:
  79   - |
  80     bat: battery {
  81       compatible = "simple-battery";
  82       constant-charge-current-max-microamp = <2040000>;
  83       constant-charge-voltage-max-microvolt = <4352000>;
  84       precharge-current-microamp = <180000>;
  85       charge-term-current-microamp = <180000>;
  86     };
  87     #include <dt-bindings/gpio/gpio.h>
  88     #include <dt-bindings/interrupt-controller/irq.h>
  89     i2c {
  90
  91       clock-frequency = <400000>;
  92
  93       #address-cells = <1>;
  94       #size-cells = <0>;
  95
  96       charger@6b {
  97         compatible = "ti,bq25601";
  98         reg = <0x6b>;
  99         monitored-battery = <&bat>;
 100
 101         interrupt-parent = <&gpio1>;
 102         interrupts = <16 IRQ_TYPE_EDGE_FALLING>;
 103         ti,watchdog-timeout-ms = <40000>;
 104
 105         input-voltage-limit-microvolt = <4500000>;
 106         input-current-limit-microamp = <2400000>;
 107        };
 108     };
 109 ...