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