From: Rob Herring <robh@kernel.org>
To: Thierry Reding <thierry.reding@gmail.com>
Cc: Krzysztof Kozlowski <krzysztof.kozlowski+dt@linaro.org>,
Conor Dooley <conor+dt@kernel.org>,
Jon Hunter <jonathanh@nvidia.com>,
devicetree@vger.kernel.org, linux-serial@vger.kernel.org,
linux-tegra@vger.kernel.org
Subject: Re: [PATCH] dt-bindings: serial: tegra-hsuart: Convert to json-schema
Date: Fri, 30 Jun 2023 10:54:47 -0600 [thread overview]
Message-ID: <20230630165447.GA1888122-robh@kernel.org> (raw)
In-Reply-To: <20230630135843.1092770-1-thierry.reding@gmail.com>
On Fri, Jun 30, 2023 at 03:58:43PM +0200, Thierry Reding wrote:
> From: Thierry Reding <treding@nvidia.com>
>
> Convert the Tegra High-Speed UART bindings from the free-form text
> format to json-schema.
>
> Signed-off-by: Thierry Reding <treding@nvidia.com>
> ---
> .../bindings/serial/nvidia,tegra20-hsuart.txt | 73 -----------
> .../serial/nvidia,tegra20-hsuart.yaml | 124 ++++++++++++++++++
> 2 files changed, 124 insertions(+), 73 deletions(-)
> delete mode 100644 Documentation/devicetree/bindings/serial/nvidia,tegra20-hsuart.txt
> create mode 100644 Documentation/devicetree/bindings/serial/nvidia,tegra20-hsuart.yaml
>
> diff --git a/Documentation/devicetree/bindings/serial/nvidia,tegra20-hsuart.txt b/Documentation/devicetree/bindings/serial/nvidia,tegra20-hsuart.txt
> deleted file mode 100644
> index f709304036c2..000000000000
> --- a/Documentation/devicetree/bindings/serial/nvidia,tegra20-hsuart.txt
> +++ /dev/null
> @@ -1,73 +0,0 @@
> -NVIDIA Tegra20/Tegra30 high speed (DMA based) UART controller driver.
> -
> -Required properties:
> -- compatible : should be,
> - "nvidia,tegra20-hsuart" for Tegra20,
> - "nvidia,tegra30-hsuart" for Tegra30,
> - "nvidia,tegra186-hsuart" for Tegra186,
> - "nvidia,tegra194-hsuart" for Tegra194.
> -
> -- reg: Should contain UART controller registers location and length.
> -- interrupts: Should contain UART controller interrupts.
> -- clocks: Must contain one entry, for the module clock.
> - See ../clocks/clock-bindings.txt for details.
> -- resets : Must contain an entry for each entry in reset-names.
> - See ../reset/reset.txt for details.
> -- reset-names : Must include the following entries:
> - - serial
> -- dmas : Must contain an entry for each entry in dma-names.
> - See ../dma/dma.txt for details.
> -- dma-names : Must include the following entries:
> - - rx
> - - tx
> -
> -Optional properties:
> -- nvidia,enable-modem-interrupt: Enable modem interrupts. Should be enable
> - only if all 8 lines of UART controller are pinmuxed.
> -- nvidia,adjust-baud-rates: List of entries providing percentage of baud rate
> - adjustment within a range.
> - Each entry contains sets of 3 values. Range low/high and adjusted rate.
> - <range_low range_high adjusted_rate>
> - When baud rate set on controller falls within the range mentioned in this
> - field, baud rate will be adjusted by percentage mentioned here.
> - Ex: <9600 115200 200>
> - Increase baud rate by 2% when set baud rate falls within range 9600 to 115200
> -
> -Baud Rate tolerance:
> - Standard UART devices are expected to have tolerance for baud rate error by
> - -4 to +4 %. All Tegra devices till Tegra210 had this support. However,
> - Tegra186 chip has a known hardware issue. UART Rx baud rate tolerance level
> - is 0% to +4% in 1-stop config. Otherwise, the received data will have
> - corruption/invalid framing errors. Parker errata suggests adjusting baud
> - rate to be higher than the deviations observed in Tx.
> -
> - Tx deviation of connected device can be captured over scope (or noted from
> - its spec) for valid range and Tegra baud rate has to be set above actual
> - Tx baud rate observed. To do this we use nvidia,adjust-baud-rates
> -
> - As an example, consider there is deviation observed in Tx for baud rates as
> - listed below.
> - 0 to 9600 has 1% deviation
> - 9600 to 115200 2% deviation
> - This slight deviation is expcted and Tegra UART is expected to handle it. Due
> - to the issue stated above, baud rate on Tegra UART should be set equal to or
> - above deviation observed for avoiding frame errors.
> - Property should be set like this
> - nvidia,adjust-baud-rates = <0 9600 100>,
> - <9600 115200 200>;
> -
> -Example:
> -
> -serial@70006000 {
> - compatible = "nvidia,tegra30-hsuart", "nvidia,tegra20-hsuart";
I guess this wasn't valid? Would be good if the commit msg said that.
> - reg = <0x70006000 0x40>;
> - reg-shift = <2>;
> - interrupts = <0 36 0x04>;
> - nvidia,enable-modem-interrupt;
> - clocks = <&tegra_car 6>;
> - resets = <&tegra_car 6>;
> - reset-names = "serial";
> - dmas = <&apbdma 8>, <&apbdma 8>;
> - dma-names = "rx", "tx";
> - nvidia,adjust-baud-rates = <1000000 4000000 136>; /* 1.36% shift */
> -};
> diff --git a/Documentation/devicetree/bindings/serial/nvidia,tegra20-hsuart.yaml b/Documentation/devicetree/bindings/serial/nvidia,tegra20-hsuart.yaml
> new file mode 100644
> index 000000000000..247ee33f8a01
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/serial/nvidia,tegra20-hsuart.yaml
> @@ -0,0 +1,124 @@
> +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
> +%YAML 1.2
> +---
> +$id: http://devicetree.org/schemas/serial/nvidia,tegra20-hsuart.yaml#
> +$schema: http://devicetree.org/meta-schemas/core.yaml#
> +
> +title: NVIDIA Tegra20/Tegra30 high speed (DMA based) UART controller driver
> +
> +maintainers:
> + - Thierry Reding <thierry.reding@gmail.com>
> + - Jon Hunter <jonathanh@nvidia.com>
> +
> +properties:
> + compatible:
> + oneOf:
> + - const: nvidia,tegra20-hsuart
> + - const: nvidia,tegra30-hsuart
> + - items:
> + - const: nvidia,tegra124-hsuart
> + - const: nvidia,tegra30-hsuart
> + - const: nvidia,tegra186-hsuart
> + - const: nvidia,tegra194-hsuart
All the single entry entries can be an enum.
With those fixes:
Reviewed-by: Rob Herring <robh@kernel.org>
prev parent reply other threads:[~2023-06-30 16:55 UTC|newest]
Thread overview: 2+ messages / expand[flat|nested] mbox.gz Atom feed top
2023-06-30 13:58 [PATCH] dt-bindings: serial: tegra-hsuart: Convert to json-schema Thierry Reding
2023-06-30 16:54 ` Rob Herring [this message]
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20230630165447.GA1888122-robh@kernel.org \
--to=robh@kernel.org \
--cc=conor+dt@kernel.org \
--cc=devicetree@vger.kernel.org \
--cc=jonathanh@nvidia.com \
--cc=krzysztof.kozlowski+dt@linaro.org \
--cc=linux-serial@vger.kernel.org \
--cc=linux-tegra@vger.kernel.org \
--cc=thierry.reding@gmail.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).