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

   1 # SPDX-License-Identifier: GPL-2.0
   2 # Copyright (C) 2021 Sebastian Reichel
   3 %YAML 1.2
   4 ---
   5 $id: http://devicetree.org/schemas/power/supply/bq25890.yaml#
   6 $schema: http://devicetree.org/meta-schemas/core.yaml#
   7
   8 title: Bq25890, bq25892, bq25895 and bq25896 Li-Ion Charger
   9
  10 maintainers:
  11   - Sebastian Reichel <sre@kernel.org>
  12
  13 allOf:
  14   - $ref: power-supply.yaml#
  15
  16 properties:
  17   compatible:
  18     oneOf:
  19       - enum:
  20           - ti,bq25890
  21       - items:
  22           - enum:
  23               - ti,bq25892
  24               - ti,bq25895
  25               - ti,bq25896
  26           - const: ti,bq25890
  27
  28   reg:
  29     maxItems: 1
  30
  31   interrupts:
  32     maxItems: 1
  33
  34   ti,battery-regulation-voltage:
  35     $ref: /schemas/types.yaml#/definitions/uint32
  36     description: maximum charging voltage (in uV)
  37
  38   ti,charge-current:
  39     $ref: /schemas/types.yaml#/definitions/uint32
  40     description: maximum charging current (in uA)
  41
  42   ti,termination-current:
  43     $ref: /schemas/types.yaml#/definitions/uint32
  44     description: |
  45       charge will be terminated when current in constant-voltage phase
  46       drops below this value (in uA)
  47
  48   ti,precharge-current:
  49     $ref: /schemas/types.yaml#/definitions/uint32
  50     description: maximum charge current during precharge phase (in uA)
  51
  52   ti,minimum-sys-voltage:
  53     $ref: /schemas/types.yaml#/definitions/uint32
  54     description: |
  55       when battery is charging and it is below minimum system voltage,
  56       the system will be regulated above minimum-sys-voltage setting (in uV)
  57
  58   ti,boost-voltage:
  59     $ref: /schemas/types.yaml#/definitions/uint32
  60     description: VBUS voltage level in boost mode (in uV)
  61
  62   ti,boost-max-current:
  63     $ref: /schemas/types.yaml#/definitions/uint32
  64     description: maximum allowed current draw in boost mode (in uA)
  65
  66   ti,boost-low-freq:
  67     description: boost mode frequency will be 500kHz, otherwise 1.5MHz
  68     type: boolean
  69
  70   ti,use-ilim-pin:
  71     description: |
  72       ILIM resistor will be used and the input current will be the lower
  73       between the resistor setting and the IINLIM register setting
  74     type: boolean
  75
  76   ti,thermal-regulation-threshold:
  77     $ref: /schemas/types.yaml#/definitions/uint32
  78     description: |
  79       temperature above which the charge current is lowered, to avoid overheating
  80       (in degrees Celsius). If omitted, the default setting will be used (120 degrees)
  81
  82   ti,ibatcomp-micro-ohms:
  83     description: value of a resistor in series with the battery (in Micro Ohms)
  84
  85   ti,ibatcomp-clamp-microvolt:
  86     description: max. charging voltage adjustment due to expected voltage drop on in-series resistor
  87
  88 required:
  89   - compatible
  90   - reg
  91   - interrupts
  92   - ti,battery-regulation-voltage
  93   - ti,charge-current
  94   - ti,termination-current
  95   - ti,precharge-current
  96   - ti,minimum-sys-voltage
  97   - ti,boost-voltage
  98   - ti,boost-max-current
  99
 100 unevaluatedProperties: false
 101
 102 examples:
 103   - |
 104     #include <dt-bindings/interrupt-controller/irq.h>
 105     i2c0 {
 106       #address-cells = <1>;
 107       #size-cells = <0>;
 108
 109       charger@6a {
 110         compatible = "ti,bq25890";
 111         reg = <0x6a>;
 112
 113         interrupt-parent = <&gpio1>;
 114         interrupts = <16 IRQ_TYPE_EDGE_FALLING>;
 115
 116         ti,battery-regulation-voltage = <4200000>;
 117         ti,charge-current = <1000000>;
 118         ti,termination-current = <50000>;
 119         ti,precharge-current = <128000>;
 120         ti,minimum-sys-voltage = <3600000>;
 121         ti,boost-voltage = <5000000>;
 122         ti,boost-max-current = <1000000>;
 123
 124         ti,use-ilim-pin;
 125         ti,thermal-regulation-threshold = <120>;
 126       };
 127     };