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
 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    description: |
22      Phandle to the monitored battery according to battery.yaml. The battery
23      node needs to contain five parameters.
24
25      precharge-current-microamp:
26      Current of pre-charge mode. The pre-charge current levels are 350 mA
27      to 650 mA programmed by I2C per 100 mA.
28
29      constant-charge-current-max-microamp:
30      Current of fast-charge mode. The fast-charge current levels are 700 mA
31      to 2000 mA programmed by I2C per 100 mA.
32
33      charge-term-current-microamp:
34      This property is end of charge current. Its level ranges from 150 mA
35      to 600 mA. Between 150 mA and 300 mA in 50 mA steps, between 300 mA and
36      600 mA in 100 mA steps.
37
38      precharge-upper-limit-microvolt:
39      Voltage of pre-charge mode. If the battery voltage is below the pre-charge
40      threshold voltage, the charger is in pre-charge mode with pre-charge
41      current. Its levels are 2.3 V to 3.8 V programmed by I2C per 0.1 V.
42
43      constant-charge-voltage-max-microvolt:
44      Battery regulation voltage of constant voltage mode. This voltage levels
45      from 3.65 V to 4.4 V by I2C per 0.025 V.
46
47  richtek,usb-connector:
48    $ref: /schemas/types.yaml#/definitions/phandle
49    description:
50      Phandle to a USB connector according to usb-connector.yaml. The connector
51      should be a child of the extcon device.
52
53required:
54  - monitored-battery
55
56allOf:
57  - $ref: power-supply.yaml#
58
59additionalProperties: false
60
61examples:
62  - |
63    charger {
64        compatible = "richtek,rt5033-charger";
65        monitored-battery = <&battery>;
66        richtek,usb-connector = <&usb_con>;
67    };