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