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

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

[Aleksander Jan Bajkowski]

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

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

[Conor Dooley]

[-- 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 --]