Re: [PATCH v1 1/2] regulator: rt6160: Add DT binding documet for Richtek RT6160

From: Rob Herring
Date: Thu May 06 2021 - 11:29:09 EST


On Mon, May 03, 2021 at 06:15:16PM +0800, cy_huang wrote:
> From: ChiYuan Huang <cy_huang@xxxxxxxxxxx>

Typo in the subject.

>
> Add the DT binding document for Richtek RT6160 voltage regulator.
>
> Signed-off-by: ChiYuan Huang <cy_huang@xxxxxxxxxxx>
> ---
> .../regulator/richtek,rt6160-regulator.yaml | 68 ++++++++++++++++++++++
> 1 file changed, 68 insertions(+)
> create mode 100644 Documentation/devicetree/bindings/regulator/richtek,rt6160-regulator.yaml
>
> diff --git a/Documentation/devicetree/bindings/regulator/richtek,rt6160-regulator.yaml b/Documentation/devicetree/bindings/regulator/richtek,rt6160-regulator.yaml
> new file mode 100644
> index 00000000..fe7b168
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/regulator/richtek,rt6160-regulator.yaml
> @@ -0,0 +1,68 @@
> +# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
> +%YAML 1.2
> +---
> +$id: http://devicetree.org/schemas/regulator/richtek,rt6160-regulator.yaml#
> +$schema: http://devicetree.org/meta-schemas/core.yaml#
> +
> +title: Richtek RT6160 BuckBoost converter
> +
> +maintainers:
> + - ChiYuan Huang <cy_huang@xxxxxxxxxxx>
> +
> +description: |
> + The RT6160 is a high-efficiency buck-boost converter that can provide
> + up to 3A output current from 2025mV to 5200mV. And it support the wide
> + input voltage range from 2200mV to 5500mV.
> +
> + Datasheet is available at
> + https://www.richtek.com/assets/product_file/RT6160A/DS6160A-00.pdf
> +
> +properties:
> + compatible:
> + enum:
> + - richtek,rt6160
> +
> + reg:
> + maxItems: 1
> +
> + enable-gpios:
> + description: A connection of the 'enable' gpio line.
> + maxItems: 1
> +
> + richtek,vsel_active_low:
> + description: |
> + Used to indicate the 'vsel' pin active level. if not specified, use
> + high active level as the default.
> + type: boolean
> +
> +patternProperties:
> + buckboost:

foo-buckboost-bar is valid name?

It's not a pattern, so move to 'properties'.

> + description: BuckBoost converter regulator description.
> + type: object
> + $ref: regulator.yaml#
> +
> +required:
> + - compatible
> + - reg
> +
> +additionalProperties: false
> +
> +examples:
> + - |
> + i2c {
> + #address-cells = <1>;
> + #size-cells = <0>;
> +
> + rt6160@75 {
> + compatible = "richtek,rt6160";
> + reg = <0x75>;
> + enable-gpios = <&gpio26 2 0>;
> +
> + buckboost {
> + regulator-name = "rt6160-buckboost";
> + regulator-min-microvolt = <2025000>;
> + regulator-max-microvolt = <5200000>;
> + regulator-allowed-modes = <0 1>;
> + };
> + };
> + };
> --
> 2.7.4
>