mirror of
https://github.com/torvalds/linux.git
synced 2024-12-11 05:33:09 +00:00
dt-bindings: Add rt5033 MFD, Regulator and Charger
Add device tree binding documentation for rt5033 multifunction device, voltage regulator and battery charger. Signed-off-by: Jakob Hauser <jahau@rocketmail.com> Reviewed-by: Linus Walleij <linus.walleij@linaro.org> Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org> Signed-off-by: Lee Jones <lee@kernel.org> Link: https://lore.kernel.org/r/bff139976865c2a489ab62333d78c4e3179a8eae.1684182964.git.jahau@rocketmail.com
This commit is contained in:
Jakob Hauser
Lee Jones
parent
3952891146
commit
b54185c1e3
138
Documentation/devicetree/bindings/mfd/richtek,rt5033.yaml
Normal file
138
Documentation/devicetree/bindings/mfd/richtek,rt5033.yaml
Normal file
@ -0,0 +1,138 @@
|
||||
# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
|
||||
%YAML 1.2
|
||||
---
|
||||
$id: http://devicetree.org/schemas/mfd/richtek,rt5033.yaml#
|
||||
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
||||
|
||||
title: Richtek RT5033 Power Management Integrated Circuit
|
||||
|
||||
maintainers:
|
||||
- Jakob Hauser <jahau@rocketmail.com>
|
||||
|
||||
description:
|
||||
RT5033 is a multifunction device which includes battery charger, fuel gauge,
|
||||
flash LED current source, LDO and synchronous Buck converter for portable
|
||||
applications. It is interfaced to host controller using I2C interface. The
|
||||
battery fuel gauge uses a separate I2C bus.
|
||||
|
||||
properties:
|
||||
compatible:
|
||||
const: richtek,rt5033
|
||||
|
||||
reg:
|
||||
maxItems: 1
|
||||
|
||||
interrupts:
|
||||
maxItems: 1
|
||||
|
||||
regulators:
|
||||
description:
|
||||
The regulators of RT5033 have to be instantiated under a sub-node named
|
||||
"regulators". For SAFE_LDO voltage there is only one value of 4.9 V. LDO
|
||||
voltage ranges from 1.2 V to 3.0 V in 0.1 V steps. BUCK voltage ranges
|
||||
from 1.0 V to 3.0 V in 0.1 V steps.
|
||||
type: object
|
||||
patternProperties:
|
||||
"^(SAFE_LDO|LDO|BUCK)$":
|
||||
type: object
|
||||
$ref: /schemas/regulator/regulator.yaml#
|
||||
unevaluatedProperties: false
|
||||
additionalProperties: false
|
||||
|
||||
charger:
|
||||
type: object
|
||||
$ref: /schemas/power/supply/richtek,rt5033-charger.yaml#
|
||||
|
||||
required:
|
||||
- compatible
|
||||
- reg
|
||||
- interrupts
|
||||
|
||||
additionalProperties: false
|
||||
|
||||
examples:
|
||||
- |
|
||||
#include <dt-bindings/interrupt-controller/irq.h>
|
||||
|
||||
battery: battery {
|
||||
compatible = "simple-battery";
|
||||
precharge-current-microamp = <450000>;
|
||||
constant-charge-current-max-microamp = <1000000>;
|
||||
charge-term-current-microamp = <150000>;
|
||||
precharge-upper-limit-microvolt = <3500000>;
|
||||
constant-charge-voltage-max-microvolt = <4350000>;
|
||||
};
|
||||
|
||||
extcon {
|
||||
usb_con: connector {
|
||||
compatible = "usb-b-connector";
|
||||
label = "micro-USB";
|
||||
type = "micro";
|
||||
};
|
||||
};
|
||||
|
||||
i2c {
|
||||
#address-cells = <1>;
|
||||
#size-cells = <0>;
|
||||
|
||||
i2c@0 {
|
||||
#address-cells = <1>;
|
||||
#size-cells = <0>;
|
||||
reg = <0>;
|
||||
|
||||
fuel-gauge@35 {
|
||||
compatible = "richtek,rt5033-battery";
|
||||
reg = <0x35>;
|
||||
|
||||
interrupt-parent = <&msmgpio>;
|
||||
interrupts = <121 IRQ_TYPE_EDGE_FALLING>;
|
||||
|
||||
pinctrl-names = "default";
|
||||
pinctrl-0 = <&fg_alert_default>;
|
||||
|
||||
power-supplies = <&rt5033_charger>;
|
||||
};
|
||||
};
|
||||
|
||||
i2c@1 {
|
||||
#address-cells = <1>;
|
||||
#size-cells = <0>;
|
||||
reg = <1>;
|
||||
|
||||
pmic@34 {
|
||||
compatible = "richtek,rt5033";
|
||||
reg = <0x34>;
|
||||
|
||||
interrupt-parent = <&msmgpio>;
|
||||
interrupts = <62 IRQ_TYPE_EDGE_FALLING>;
|
||||
|
||||
pinctrl-names = "default";
|
||||
pinctrl-0 = <&pmic_int_default>;
|
||||
|
||||
regulators {
|
||||
safe_ldo_reg: SAFE_LDO {
|
||||
regulator-name = "SAFE_LDO";
|
||||
regulator-min-microvolt = <4900000>;
|
||||
regulator-max-microvolt = <4900000>;
|
||||
regulator-always-on;
|
||||
};
|
||||
ldo_reg: LDO {
|
||||
regulator-name = "LDO";
|
||||
regulator-min-microvolt = <2800000>;
|
||||
regulator-max-microvolt = <2800000>;
|
||||
};
|
||||
buck_reg: BUCK {
|
||||
regulator-name = "BUCK";
|
||||
regulator-min-microvolt = <1200000>;
|
||||
regulator-max-microvolt = <1200000>;
|
||||
};
|
||||
};
|
||||
|
||||
rt5033_charger: charger {
|
||||
compatible = "richtek,rt5033-charger";
|
||||
monitored-battery = <&battery>;
|
||||
richtek,usb-connector = <&usb_con>;
|
||||
};
|
||||
};
|
||||
};
|
||||
};
|
||||
@ -0,0 +1,65 @@
|
||||
# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
|
||||
%YAML 1.2
|
||||
---
|
||||
$id: http://devicetree.org/schemas/power/supply/richtek,rt5033-charger.yaml#
|
||||
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
||||
|
||||
title: Richtek RT5033 PMIC Battery Charger
|
||||
|
||||
maintainers:
|
||||
- Jakob Hauser <jahau@rocketmail.com>
|
||||
|
||||
description:
|
||||
The battery charger of the multifunction device RT5033 has to be instantiated
|
||||
under sub-node named "charger" using the following format.
|
||||
|
||||
properties:
|
||||
compatible:
|
||||
const: richtek,rt5033-charger
|
||||
|
||||
monitored-battery:
|
||||
$ref: /schemas/types.yaml#/definitions/phandle
|
||||
description: |
|
||||
Phandle to the monitored battery according to battery.yaml. The battery
|
||||
node needs to contain five parameters.
|
||||
|
||||
precharge-current-microamp:
|
||||
Current of pre-charge mode. The pre-charge current levels are 350 mA
|
||||
to 650 mA programmed by I2C per 100 mA.
|
||||
|
||||
constant-charge-current-max-microamp:
|
||||
Current of fast-charge mode. The fast-charge current levels are 700 mA
|
||||
to 2000 mA programmed by I2C per 100 mA.
|
||||
|
||||
charge-term-current-microamp:
|
||||
This property is end of charge current. Its level ranges from 150 mA
|
||||
to 600 mA. Between 150 mA and 300 mA in 50 mA steps, between 300 mA and
|
||||
600 mA in 100 mA steps.
|
||||
|
||||
precharge-upper-limit-microvolt:
|
||||
Voltage of pre-charge mode. If the battery voltage is below the pre-charge
|
||||
threshold voltage, the charger is in pre-charge mode with pre-charge
|
||||
current. Its levels are 2.3 V to 3.8 V programmed by I2C per 0.1 V.
|
||||
|
||||
constant-charge-voltage-max-microvolt:
|
||||
Battery regulation voltage of constant voltage mode. This voltage levels
|
||||
from 3.65 V to 4.4 V by I2C per 0.025 V.
|
||||
|
||||
richtek,usb-connector:
|
||||
$ref: /schemas/types.yaml#/definitions/phandle
|
||||
description:
|
||||
Phandle to a USB connector according to usb-connector.yaml. The connector
|
||||
should be a child of the extcon device.
|
||||
|
||||
required:
|
||||
- monitored-battery
|
||||
|
||||
additionalProperties: false
|
||||
|
||||
examples:
|
||||
- |
|
||||
charger {
|
||||
compatible = "richtek,rt5033-charger";
|
||||
monitored-battery = <&battery>;
|
||||
richtek,usb-connector = <&usb_con>;
|
||||
};
|
||||
Loading…
Reference in New Issue
Block a user