Documentation/devicetree/bindings/power/supply/bq2415x.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/bq2415x.yaml#
   6 $schema: http://devicetree.org/meta-schemas/core.yaml#
   7
   8 title: TI bq2415x 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     enum:
  19       - ti,bq24150
  20       - ti,bq24150a
  21       - ti,bq24151
  22       - ti,bq24151a
  23       - ti,bq24152
  24       - ti,bq24153
  25       - ti,bq24153a
  26       - ti,bq24155
  27       - ti,bq24156
  28       - ti,bq24156a
  29       - ti,bq24158
  30
  31   reg:
  32     maxItems: 1
  33
  34   ti,current-limit:
  35     $ref: /schemas/types.yaml#/definitions/uint32
  36     description: initial maximum current charger can pull from power supply in mA.
  37
  38   ti,weak-battery-voltage:
  39     $ref: /schemas/types.yaml#/definitions/uint32
  40     description: |
  41       weak battery voltage threshold in mV.
  42       The chip will use slow precharge if battery voltage is below this value.
  43
  44   ti,battery-regulation-voltage:
  45     $ref: /schemas/types.yaml#/definitions/uint32
  46     description: maximum charging voltage in mV.
  47
  48   ti,charge-current:
  49     $ref: /schemas/types.yaml#/definitions/uint32
  50     description: maximum charging current in mA.
  51
  52   ti,termination-current:
  53     $ref: /schemas/types.yaml#/definitions/uint32
  54     description: |
  55       charge will be terminated when current in constant-voltage phase drops
  56       below this value (in mA).
  57
  58   ti,resistor-sense:
  59     $ref: /schemas/types.yaml#/definitions/uint32
  60     description: value of sensing resistor in milliohm.
  61
  62   ti,usb-charger-detection:
  63     $ref: /schemas/types.yaml#/definitions/phandle
  64     description: phandle to usb charger detection device (required for auto mode)
  65
  66 required:
  67   - compatible
  68   - reg
  69   - ti,current-limit
  70   - ti,weak-battery-voltage
  71   - ti,battery-regulation-voltage
  72   - ti,charge-current
  73   - ti,termination-current
  74   - ti,resistor-sense
  75
  76 additionalProperties: false
  77
  78 examples:
  79   - |
  80     i2c {
  81       #address-cells = <1>;
  82       #size-cells = <0>;
  83
  84       charger@6b {
  85         compatible = "ti,bq24150a";
  86         reg = <0x6b>;
  87
  88         ti,current-limit = <100>;
  89         ti,weak-battery-voltage = <3400>;
  90         ti,battery-regulation-voltage = <4200>;
  91         ti,charge-current = <650>;
  92         ti,termination-current = <100>;
  93         ti,resistor-sense = <68>;
  94
  95         ti,usb-charger-detection = <&isp1704>;
  96       };
  97     };