Message ID | 20220111175017.223966-3-krzysztof.kozlowski@canonical.com (mailing list archive) |
---|---|
State | Handled Elsewhere, archived |
Headers | show |
Series | leds/power/regulator/mfd: dt-bindings: maxim,max77693: convert to dtschema | expand |
Hi, On Tue, Jan 11, 2022 at 06:50:15PM +0100, Krzysztof Kozlowski wrote: > Convert the Charger bindings of Maxim MAX77693 MUIC to DT schema format. > The existing bindings were defined in ../bindings/mfd/max77693.txt. > > Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@canonical.com> > Reviewed-by: Rob Herring <robh@kernel.org> > --- I expect this to go through Rob's or Lee's tree: Acked-by: Sebastian Reichel <sebastian.reichel@collabora.com> -- Sebastian > .../bindings/power/supply/maxim,max77693.yaml | 70 +++++++++++++++++++ > MAINTAINERS | 1 + > 2 files changed, 71 insertions(+) > create mode 100644 Documentation/devicetree/bindings/power/supply/maxim,max77693.yaml > > diff --git a/Documentation/devicetree/bindings/power/supply/maxim,max77693.yaml b/Documentation/devicetree/bindings/power/supply/maxim,max77693.yaml > new file mode 100644 > index 000000000000..a21dc1a8890f > --- /dev/null > +++ b/Documentation/devicetree/bindings/power/supply/maxim,max77693.yaml > @@ -0,0 +1,70 @@ > +# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause > +%YAML 1.2 > +--- > +$id: http://devicetree.org/schemas/power/supply/maxim,max77693.yaml# > +$schema: http://devicetree.org/meta-schemas/core.yaml# > + > +title: Maxim MAX77693 MicroUSB and Companion Power Management IC Charger > + > +maintainers: > + - Krzysztof Kozlowski <krzysztof.kozlowski@canonical.com> > + > +description: | > + This is a part of device tree bindings for Maxim MAX77693 MicroUSB Integrated > + Circuit (MUIC). > + > + See also Documentation/devicetree/bindings/mfd/maxim,max77693.yaml for > + additional information and example. > + > +properties: > + compatible: > + const: maxim,max77693-charger > + > + maxim,constant-microvolt: > + description: | > + Battery constant voltage in uV. The charger will operate in fast > + charge constant current mode till battery voltage reaches this level. > + Then the charger will switch to fast charge constant voltage mode. > + Also vsys (system voltage) will be set to this value when DC power is > + supplied but charger is not enabled. > + Valid values: 3650000 - 4400000, step by 25000 (rounded down) > + minimum: 3650000 > + maximum: 4400000 > + default: 4200000 > + > + maxim,min-system-microvolt: > + description: | > + Minimal system voltage in uV. > + enum: [3000000, 3100000, 3200000, 3300000, 3400000, 3500000, > + 3600000, 3700000] > + default: 3600000 > + > + maxim,thermal-regulation-celsius: > + description: | > + Temperature in Celsius for entering high temperature charging mode. > + If die temperature exceeds this value the charging current will be > + reduced by 105 mA/Celsius. > + enum: [70, 85, 100, 115] > + default: 100 > + > + maxim,battery-overcurrent-microamp: > + description: | > + Overcurrent protection threshold in uA (current from battery to > + system). > + Valid values: 2000000 - 3500000, step by 250000 (rounded down) > + minimum: 2000000 > + maximum: 3500000 > + default: 3500000 > + > + maxim,charge-input-threshold-microvolt: > + description: | > + Threshold voltage in uV for triggering input voltage regulation loop. > + If input voltage decreases below this value, the input current will > + be reduced to reach the threshold voltage. > + enum: [4300000, 4700000, 4800000, 4900000] > + default: 4300000 > + > +required: > + - compatible > + > +additionalProperties: false > diff --git a/MAINTAINERS b/MAINTAINERS > index b5e4f14f6768..ead08768fb78 100644 > --- a/MAINTAINERS > +++ b/MAINTAINERS > @@ -11681,6 +11681,7 @@ M: Krzysztof Kozlowski <krzysztof.kozlowski@canonical.com> > M: Bartlomiej Zolnierkiewicz <b.zolnierkie@samsung.com> > L: linux-pm@vger.kernel.org > S: Supported > +F: Documentation/devicetree/bindings/power/supply/maxim,max77693.yaml > F: drivers/power/supply/max14577_charger.c > F: drivers/power/supply/max77693_charger.c > > -- > 2.32.0 >
diff --git a/Documentation/devicetree/bindings/power/supply/maxim,max77693.yaml b/Documentation/devicetree/bindings/power/supply/maxim,max77693.yaml new file mode 100644 index 000000000000..a21dc1a8890f --- /dev/null +++ b/Documentation/devicetree/bindings/power/supply/maxim,max77693.yaml @@ -0,0 +1,70 @@ +# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/power/supply/maxim,max77693.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Maxim MAX77693 MicroUSB and Companion Power Management IC Charger + +maintainers: + - Krzysztof Kozlowski <krzysztof.kozlowski@canonical.com> + +description: | + This is a part of device tree bindings for Maxim MAX77693 MicroUSB Integrated + Circuit (MUIC). + + See also Documentation/devicetree/bindings/mfd/maxim,max77693.yaml for + additional information and example. + +properties: + compatible: + const: maxim,max77693-charger + + maxim,constant-microvolt: + description: | + Battery constant voltage in uV. The charger will operate in fast + charge constant current mode till battery voltage reaches this level. + Then the charger will switch to fast charge constant voltage mode. + Also vsys (system voltage) will be set to this value when DC power is + supplied but charger is not enabled. + Valid values: 3650000 - 4400000, step by 25000 (rounded down) + minimum: 3650000 + maximum: 4400000 + default: 4200000 + + maxim,min-system-microvolt: + description: | + Minimal system voltage in uV. + enum: [3000000, 3100000, 3200000, 3300000, 3400000, 3500000, + 3600000, 3700000] + default: 3600000 + + maxim,thermal-regulation-celsius: + description: | + Temperature in Celsius for entering high temperature charging mode. + If die temperature exceeds this value the charging current will be + reduced by 105 mA/Celsius. + enum: [70, 85, 100, 115] + default: 100 + + maxim,battery-overcurrent-microamp: + description: | + Overcurrent protection threshold in uA (current from battery to + system). + Valid values: 2000000 - 3500000, step by 250000 (rounded down) + minimum: 2000000 + maximum: 3500000 + default: 3500000 + + maxim,charge-input-threshold-microvolt: + description: | + Threshold voltage in uV for triggering input voltage regulation loop. + If input voltage decreases below this value, the input current will + be reduced to reach the threshold voltage. + enum: [4300000, 4700000, 4800000, 4900000] + default: 4300000 + +required: + - compatible + +additionalProperties: false diff --git a/MAINTAINERS b/MAINTAINERS index b5e4f14f6768..ead08768fb78 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -11681,6 +11681,7 @@ M: Krzysztof Kozlowski <krzysztof.kozlowski@canonical.com> M: Bartlomiej Zolnierkiewicz <b.zolnierkie@samsung.com> L: linux-pm@vger.kernel.org S: Supported +F: Documentation/devicetree/bindings/power/supply/maxim,max77693.yaml F: drivers/power/supply/max14577_charger.c F: drivers/power/supply/max77693_charger.c