xref: /freebsd/sys/contrib/device-tree/Bindings/power/supply/richtek,rt5033-charger.yaml (revision 5ca8e32633c4ffbbcd6762e5888b6a4ba0708c6c)
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
7title: Richtek RT5033 PMIC Battery Charger
8
9maintainers:
10  - Jakob Hauser <jahau@rocketmail.com>
11
12description:
13  The battery charger of the multifunction device RT5033 has to be instantiated
14  under sub-node named "charger" using the following format.
15
16properties:
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
54required:
55  - monitored-battery
56
57additionalProperties: false
58
59examples:
60  - |
61    charger {
62        compatible = "richtek,rt5033-charger";
63        monitored-battery = <&battery>;
64        richtek,usb-connector = <&usb_con>;
65    };
66