Re: [PATCH v3] dt-bindings: mips: lantiq: Document lantiq dcdc binding

[Conor Dooley <conor@kernel.org>]

[-- Attachment #1: Type: text/plain, Size: 2412 bytes --]

On Mon, Aug 18, 2025 at 11:37:28PM +0200, Aleksander Jan Bajkowski wrote:
> Lantiq DCDC is a voltage converter with a voltage sensor. The converter
> is inside the SoC. This driver only reads the voltage and prints it at
> startup. The voltage supplied by this converter powers one of the power
> domains. It powers the CPU core and probably other peripherals as well.
> The voltage is programmed by the bootloader and Linux never touches it.
> 
> Signed-off-by: Aleksander Jan Bajkowski <olek2@wp.pl>
> ---
> v3:
> - extended commit description
> v2:
> - added missing commit description
> ---
>  .../mips/lantiq/lantiq,dcdc-xrx200.yaml       | 38 +++++++++++++++++++
>  1 file changed, 38 insertions(+)
>  create mode 100644 Documentation/devicetree/bindings/mips/lantiq/lantiq,dcdc-xrx200.yaml
> 
> diff --git a/Documentation/devicetree/bindings/mips/lantiq/lantiq,dcdc-xrx200.yaml b/Documentation/devicetree/bindings/mips/lantiq/lantiq,dcdc-xrx200.yaml
> new file mode 100644
> index 000000000000..d951012392bf
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/mips/lantiq/lantiq,dcdc-xrx200.yaml

Still in a weird directory, why isn't this under regulators?

> @@ -0,0 +1,38 @@
> +# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
> +%YAML 1.2
> +---
> +$id: http://devicetree.org/schemas/mips/lantiq/lantiq,dcdc-xrx200.yaml#
> +$schema: http://devicetree.org/meta-schemas/core.yaml#
> +
> +title: Lantiq DCDC (DC-DC converter with voltage sensor)
> +
> +maintainers:
> +  - Aleksander Jan Bajkowski <olek2@wp.pl>
> +
> +description:
> +  Lantiq DCDC is a voltage converter with a voltage sensor. The converter is
> +  inside the xRX200 SoC. This driver only reads the voltage and prints it at
> +  startup. The voltage supplied by this converter powers one of the power
> +  domains. It powers the CPU core and probably other peripherals as well.
> +
> +properties:
> +  compatible:
> +    items:
> +      - enum:
> +          - lantiq,dcdc-xrx200

An items list containing one element doesn't do anything, just get rid
of it and use enum directly.

> +
> +  reg:
> +    maxItems: 1
> +
> +required:
> +  - compatible
> +  - reg
> +
> +additionalProperties: false
> +
> +examples:
> +  - |
> +    dcdc@106a00 {
> +        compatible = "lantiq,dcdc-xrx200";
> +        reg = <0x106a00 0x200>;
> +    };
> -- 
> 2.47.2
> 

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 228 bytes --]