dt-bindings: mfd: ams,as3711: Convert to json-schema
Convert the Austria MicroSystems AS3711 Quad Buck High Current PMIC with Charger Device Tree binding documentation to json-schema. Signed-off-by: Geert Uytterhoeven <geert+renesas@glider.be> Reviewed-by: Rob Herring <robh@kernel.org> Link: https://lore.kernel.org/r/56a5ebee588696f9022fa29fa8e266c8bdee6fd7.1698228043.git.geert+renesas@glider.be Signed-off-by: Lee Jones <lee@kernel.org>
This commit is contained in:
Geert Uytterhoeven
Lee Jones
parent
4ae08845db
commit
a89c3d8327
223
Documentation/devicetree/bindings/mfd/ams,as3711.yaml
Normal file
223
Documentation/devicetree/bindings/mfd/ams,as3711.yaml
Normal file
@ -0,0 +1,223 @@
|
||||
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
|
||||
%YAML 1.2
|
||||
---
|
||||
$id: http://devicetree.org/schemas/mfd/ams,as3711.yaml#
|
||||
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
||||
|
||||
title: Austria MicroSystems AS3711 Quad Buck High Current PMIC with Charger
|
||||
|
||||
maintainers:
|
||||
- Guennadi Liakhovetski <guennadi.liakhovetski@linux.intel.com>
|
||||
|
||||
description:
|
||||
AS3711 is an I2C PMIC from Austria MicroSystems with multiple DC/DC and LDO
|
||||
power supplies, a battery charger and an RTC. So far only bindings for the
|
||||
two step-up DC/DC converters are defined.
|
||||
|
||||
properties:
|
||||
compatible:
|
||||
const: ams,as3711
|
||||
|
||||
reg:
|
||||
maxItems: 1
|
||||
|
||||
backlight:
|
||||
description:
|
||||
Step-up converter configuration, to be used as a backlight source
|
||||
type: object
|
||||
additionalProperties: false
|
||||
properties:
|
||||
compatible:
|
||||
const: ams,as3711-bl
|
||||
|
||||
su1-dev:
|
||||
description: Framebuffer phandle for the first step-up converter
|
||||
$ref: /schemas/types.yaml#/definitions/phandle
|
||||
|
||||
su1-max-uA:
|
||||
description: Maximum current for the first step-up converter
|
||||
$ref: /schemas/types.yaml#/definitions/uint32
|
||||
|
||||
su2-dev:
|
||||
description: Framebuffer phandle for the second step-up converter
|
||||
$ref: /schemas/types.yaml#/definitions/phandle
|
||||
|
||||
su2-max-uA:
|
||||
description: Maximum current for the second step-up converter
|
||||
$ref: /schemas/types.yaml#/definitions/uint32
|
||||
|
||||
su2-feedback-voltage:
|
||||
description: Second step-up converter uses voltage feedback
|
||||
type: boolean
|
||||
|
||||
su2-feedback-curr1:
|
||||
description:
|
||||
Second step-up converter uses CURR1 input for current feedback
|
||||
type: boolean
|
||||
|
||||
su2-feedback-curr2:
|
||||
description:
|
||||
Second step-up converter uses CURR2 input for current feedback
|
||||
type: boolean
|
||||
|
||||
su2-feedback-curr3:
|
||||
description:
|
||||
Second step-up converter uses CURR3 input for current feedback
|
||||
type: boolean
|
||||
|
||||
su2-feedback-curr-auto:
|
||||
description:
|
||||
Second step-up converter uses automatic current feedback selection
|
||||
type: boolean
|
||||
|
||||
su2-fbprot-lx-sd4:
|
||||
description:
|
||||
Second step-up converter uses LX_SD4 for over-voltage protection
|
||||
type: boolean
|
||||
|
||||
su2-fbprot-gpio2:
|
||||
description:
|
||||
Second step-up converter uses GPIO2 for over-voltage protection
|
||||
type: boolean
|
||||
|
||||
su2-fbprot-gpio3:
|
||||
description:
|
||||
Second step-up converter uses GPIO3 for over-voltage protection
|
||||
type: boolean
|
||||
|
||||
su2-fbprot-gpio4:
|
||||
description:
|
||||
Second step-up converter uses GPIO4 for over-voltage protection
|
||||
type: boolean
|
||||
|
||||
su2-auto-curr1:
|
||||
description:
|
||||
Second step-up converter uses CURR1 input for automatic current
|
||||
feedback
|
||||
type: boolean
|
||||
|
||||
su2-auto-curr2:
|
||||
description:
|
||||
Second step-up converter uses CURR2 input for automatic current
|
||||
feedback
|
||||
type: boolean
|
||||
|
||||
su2-auto-curr3:
|
||||
description:
|
||||
Second step-up converter uses CURR3 input for automatic current
|
||||
feedback
|
||||
type: boolean
|
||||
|
||||
required:
|
||||
- compatible
|
||||
|
||||
dependentRequired:
|
||||
# To use the SU1 converter as a backlight source the following two
|
||||
# properties must be provided:
|
||||
su1-dev: [ su1-max-uA ]
|
||||
su1-max-uA: [ su1-dev ]
|
||||
|
||||
# To use the SU2 converter as a backlight source the following two
|
||||
# properties must be provided:
|
||||
su2-dev: [ su2-max-uA ]
|
||||
su2-max-uA: [ su2-dev ]
|
||||
|
||||
su2-feedback-voltage: [ su2-dev ]
|
||||
su2-feedback-curr1: [ su2-dev ]
|
||||
su2-feedback-curr2: [ su2-dev ]
|
||||
su2-feedback-curr3: [ su2-dev ]
|
||||
su2-feedback-curr-auto: [ su2-dev ]
|
||||
su2-fbprot-lx-sd4: [ su2-dev ]
|
||||
su2-fbprot-gpio2: [ su2-dev ]
|
||||
su2-fbprot-gpio3: [ su2-dev ]
|
||||
su2-fbprot-gpio4: [ su2-dev ]
|
||||
su2-auto-curr1: [ su2-feedback-curr-auto ]
|
||||
su2-auto-curr2: [ su2-feedback-curr-auto ]
|
||||
su2-auto-curr3: [ su2-feedback-curr-auto ]
|
||||
|
||||
dependentSchemas:
|
||||
su2-dev:
|
||||
allOf:
|
||||
- oneOf:
|
||||
- required:
|
||||
- su2-feedback-voltage
|
||||
- required:
|
||||
- su2-feedback-curr1
|
||||
- required:
|
||||
- su2-feedback-curr2
|
||||
- required:
|
||||
- su2-feedback-curr3
|
||||
- required:
|
||||
- su2-feedback-curr-auto
|
||||
- oneOf:
|
||||
- required:
|
||||
- su2-fbprot-lx-sd4
|
||||
- required:
|
||||
- su2-fbprot-gpio2
|
||||
- required:
|
||||
- su2-fbprot-gpio3
|
||||
- required:
|
||||
- su2-fbprot-gpio4
|
||||
|
||||
su2-feedback-curr-auto:
|
||||
anyOf:
|
||||
- required:
|
||||
- su2-auto-curr1
|
||||
- required:
|
||||
- su2-auto-curr2
|
||||
- required:
|
||||
- su2-auto-curr3
|
||||
|
||||
regulators:
|
||||
description: Other DC/DC and LDO supplies
|
||||
type: object
|
||||
unevaluatedProperties: false
|
||||
patternProperties:
|
||||
"^(sd[1-4]|ldo[1-8])$":
|
||||
type: object
|
||||
$ref: /schemas/regulator/regulator.yaml#
|
||||
unevaluatedProperties: false
|
||||
|
||||
required:
|
||||
- compatible
|
||||
- reg
|
||||
|
||||
additionalProperties: false
|
||||
|
||||
examples:
|
||||
- |
|
||||
i2c {
|
||||
#address-cells = <1>;
|
||||
#size-cells = <0>;
|
||||
|
||||
pmic@40 {
|
||||
compatible = "ams,as3711";
|
||||
reg = <0x40>;
|
||||
|
||||
regulators {
|
||||
sd4 {
|
||||
regulator-name = "1.215V";
|
||||
regulator-min-microvolt = <1215000>;
|
||||
regulator-max-microvolt = <1235000>;
|
||||
};
|
||||
ldo2 {
|
||||
regulator-name = "2.8V CPU";
|
||||
regulator-min-microvolt = <2800000>;
|
||||
regulator-max-microvolt = <2800000>;
|
||||
regulator-always-on;
|
||||
regulator-boot-on;
|
||||
};
|
||||
};
|
||||
|
||||
backlight {
|
||||
compatible = "ams,as3711-bl";
|
||||
su2-dev = <&lcdc>;
|
||||
su2-max-uA = <36000>;
|
||||
su2-feedback-curr-auto;
|
||||
su2-fbprot-gpio4;
|
||||
su2-auto-curr1;
|
||||
su2-auto-curr2;
|
||||
su2-auto-curr3;
|
||||
};
|
||||
};
|
||||
};
|
||||
@ -1,73 +0,0 @@
|
||||
AS3711 is an I2C PMIC from Austria MicroSystems with multiple DCDC and LDO power
|
||||
supplies, a battery charger and an RTC. So far only bindings for the two stepup
|
||||
DCDC converters are defined. Other DCDC and LDO supplies are configured, using
|
||||
standard regulator properties, they must belong to a sub-node, called
|
||||
"regulators" and be called "sd1" to "sd4" and "ldo1" to "ldo8." Stepup converter
|
||||
configuration should be placed in a subnode, called "backlight."
|
||||
|
||||
Compulsory properties:
|
||||
- compatible : must be "ams,as3711"
|
||||
- reg : specifies the I2C address
|
||||
|
||||
To use the SU1 converter as a backlight source the following two properties must
|
||||
be provided:
|
||||
- su1-dev : framebuffer phandle
|
||||
- su1-max-uA : maximum current
|
||||
|
||||
To use the SU2 converter as a backlight source the following two properties must
|
||||
be provided:
|
||||
- su2-dev : framebuffer phandle
|
||||
- su1-max-uA : maximum current
|
||||
|
||||
Additionally one of these properties must be provided to select the type of
|
||||
feedback used:
|
||||
- su2-feedback-voltage : voltage feedback is used
|
||||
- su2-feedback-curr1 : CURR1 input used for current feedback
|
||||
- su2-feedback-curr2 : CURR2 input used for current feedback
|
||||
- su2-feedback-curr3 : CURR3 input used for current feedback
|
||||
- su2-feedback-curr-auto: automatic current feedback selection
|
||||
|
||||
and one of these to select the over-voltage protection pin
|
||||
- su2-fbprot-lx-sd4 : LX_SD4 is used for over-voltage protection
|
||||
- su2-fbprot-gpio2 : GPIO2 is used for over-voltage protection
|
||||
- su2-fbprot-gpio3 : GPIO3 is used for over-voltage protection
|
||||
- su2-fbprot-gpio4 : GPIO4 is used for over-voltage protection
|
||||
|
||||
If "su2-feedback-curr-auto" is selected, one or more of the following properties
|
||||
have to be specified:
|
||||
- su2-auto-curr1 : use CURR1 input for current feedback
|
||||
- su2-auto-curr2 : use CURR2 input for current feedback
|
||||
- su2-auto-curr3 : use CURR3 input for current feedback
|
||||
|
||||
Example:
|
||||
|
||||
as3711@40 {
|
||||
compatible = "ams,as3711";
|
||||
reg = <0x40>;
|
||||
|
||||
regulators {
|
||||
sd4 {
|
||||
regulator-name = "1.215V";
|
||||
regulator-min-microvolt = <1215000>;
|
||||
regulator-max-microvolt = <1235000>;
|
||||
};
|
||||
ldo2 {
|
||||
regulator-name = "2.8V CPU";
|
||||
regulator-min-microvolt = <2800000>;
|
||||
regulator-max-microvolt = <2800000>;
|
||||
regulator-always-on;
|
||||
regulator-boot-on;
|
||||
};
|
||||
};
|
||||
|
||||
backlight {
|
||||
compatible = "ams,as3711-bl";
|
||||
su2-dev = <&lcdc>;
|
||||
su2-max-uA = <36000>;
|
||||
su2-feedback-curr-auto;
|
||||
su2-fbprot-gpio4;
|
||||
su2-auto-curr1;
|
||||
su2-auto-curr2;
|
||||
su2-auto-curr3;
|
||||
};
|
||||
};
|
||||
Loading…
x
Reference in New Issue
Block a user