Documentation/devicetree/bindings/power/supply/richtek,rt5033-charger.yaml

   1 # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/power/supply/richtek,rt5033-charger.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: Richtek RT5033 PMIC Battery Charger
   8
   9 maintainers:
  10   - Jakob Hauser <jahau@rocketmail.com>
  11
  12 description:
  13   The battery charger of the multifunction device RT5033 has to be instantiated
  14   under sub-node named "charger" using the following format.
  15
  16 properties:
  17   compatible:
  18     const: richtek,rt5033-charger
  19
  20   monitored-battery:
  21     $ref: /schemas/types.yaml#/definitions/phandle
  22     description: |
  23       Phandle to the monitored battery according to battery.yaml. The battery
  24       node needs to contain five parameters.
  25
  26       precharge-current-microamp:
  27       Current of pre-charge mode. The pre-charge current levels are 350 mA
  28       to 650 mA programmed by I2C per 100 mA.
  29
  30       constant-charge-current-max-microamp:
  31       Current of fast-charge mode. The fast-charge current levels are 700 mA
  32       to 2000 mA programmed by I2C per 100 mA.
  33
  34       charge-term-current-microamp:
  35       This property is end of charge current. Its level ranges from 150 mA
  36       to 600 mA. Between 150 mA and 300 mA in 50 mA steps, between 300 mA and
  37       600 mA in 100 mA steps.
  38
  39       precharge-upper-limit-microvolt:
  40       Voltage of pre-charge mode. If the battery voltage is below the pre-charge
  41       threshold voltage, the charger is in pre-charge mode with pre-charge
  42       current. Its levels are 2.3 V to 3.8 V programmed by I2C per 0.1 V.
  43
  44       constant-charge-voltage-max-microvolt:
  45       Battery regulation voltage of constant voltage mode. This voltage levels
  46       from 3.65 V to 4.4 V by I2C per 0.025 V.
  47
  48   richtek,usb-connector:
  49     $ref: /schemas/types.yaml#/definitions/phandle
  50     description:
  51       Phandle to a USB connector according to usb-connector.yaml. The connector
  52       should be a child of the extcon device.
  53
  54 required:
  55   - monitored-battery
  56
  57 additionalProperties: false
  58
  59 examples:
  60   - |
  61     charger {
  62         compatible = "richtek,rt5033-charger";
  63         monitored-battery = <&battery>;
  64         richtek,usb-connector = <&usb_con>;
  65     };