Re: [PATCH v11 4/5] dt-bindings: serial: document LiteUART bindings

From: Geert Uytterhoeven
Date: Fri Sep 25 2020 - 09:16:38 EST


Hi Mateusz,

On Wed, Sep 23, 2020 at 12:10 PM Mateusz Holenko <mholenko@xxxxxxxxxxxx> wrote:
> From: Filip Kokosinski <fkokosinski@xxxxxxxxxxxx>
>
> Add documentation for LiteUART devicetree bindings.
>
> Signed-off-by: Filip Kokosinski <fkokosinski@xxxxxxxxxxxx>
> Signed-off-by: Mateusz Holenko <mholenko@xxxxxxxxxxxx>
> Reviewed-by: Rob Herring <robh@xxxxxxxxxx>

Thanks for your patch!

> --- /dev/null
> +++ b/Documentation/devicetree/bindings/serial/litex,liteuart.yaml
> @@ -0,0 +1,38 @@
> +# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
> +
> +%YAML 1.2
> +---
> +$id: http://devicetree.org/schemas/serial/litex,liteuart.yaml#
> +$schema: http://devicetree.org/meta-schemas/core.yaml#
> +
> +title: LiteUART serial controller
> +
> +maintainers:
> + - Karol Gugala <kgugala@xxxxxxxxxxxx>
> + - Mateusz Holenko <mholenko@xxxxxxxxxxxx>
> +
> +description: |
> + LiteUART serial controller is a part of LiteX FPGA SoC builder. It supports

part of the

> + multiple CPU architectures, currently including e.g. OpenRISC and RISC-V.
> +
> +properties:
> + compatible:
> + const: litex,liteuart

Have you already decided how to handle future LiteUART variants that add
new features (e.g. CTS/RTS, DMA)?


> +
> + reg:
> + maxItems: 1
> +
> + interrupts:
> + maxItems: 1
> +
> +required:
> + - compatible
> + - reg
> +
> +examples:
> + - |
> + uart0: serial@e0001800 {
> + compatible = "litex,liteuart";
> + reg = <0xe0001800 0x100>;
> + interrupts = <2>;
> + };
> --
> 2.25.1
>


--
Gr{oetje,eeting}s,

Geert

--
Geert Uytterhoeven -- There's lots of Linux beyond ia32 -- geert@xxxxxxxxxxxxxx

In personal conversations with technical people, I call myself a hacker. But
when I'm talking to journalists I just say "programmer" or something like that.
-- Linus Torvalds