Unverified Commit 17a9ab02 authored by Thierry Reding's avatar Thierry Reding Committed by Mark Brown
Browse files

dt-bindings: spi: tegra-sflash: Convert to json-schema 



Convert the Tegra SFLASH controller bindings from the free-form text
format to json-schema.

Signed-off-by: default avatarThierry Reding <treding@nvidia.com>
Reviewed-by: default avatarRob Herring <robh@kernel.org>
Link: https://lore.kernel.org/r/20230705152603.2514235-2-thierry.reding@gmail.com


Signed-off-by: default avatarMark Brown <broonie@kernel.org>
parent 8c87a46e

Documentation/devicetree/bindings/spi/nvidia,tegra20-sflash.txt

deleted100644 → 0
+0 −37
Original line number Diff line number Diff line 
NVIDIA Tegra20 SFLASH controller.



Required properties:

- compatible : should be "nvidia,tegra20-sflash".

- reg: Should contain SFLASH registers location and length.

- interrupts: Should contain SFLASH 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:

  - spi

- dmas : Must contain an entry for each entry in clock-names.

  See ../dma/dma.txt for details.

- dma-names : Must include the following entries:

  - rx

  - tx



Recommended properties:

- spi-max-frequency: Definition as per

                     Documentation/devicetree/bindings/spi/spi-bus.txt



Example:



spi@7000c380 {

	compatible = "nvidia,tegra20-sflash";

	reg = <0x7000c380 0x80>;

	interrupts = <0 39 0x04>;

	spi-max-frequency = <25000000>;

	#address-cells = <1>;

	#size-cells = <0>;

	clocks = <&tegra_car 43>;

	resets = <&tegra_car 43>;

	reset-names = "spi";

	dmas = <&apbdma 11>, <&apbdma 11>;

	dma-names = "rx", "tx";

};

Documentation/devicetree/bindings/spi/nvidia,tegra20-sflash.yaml

0 → 100644
+81 −0
Original line number Diff line number Diff line 
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)

%YAML 1.2

---

$id: http://devicetree.org/schemas/spi/nvidia,tegra20-sflash.yaml#

$schema: http://devicetree.org/meta-schemas/core.yaml#



title: NVIDIA Tegra20 SFLASH controller



maintainers:

  - Thierry Reding <thierry.reding@gmail.com>

  - Jon Hunter <jonathanh@nvidia.com>



properties:

  compatible:

    const: nvidia,tegra20-sflash



  reg:

    maxItems: 1



  interrupts:

    maxItems: 1



  clocks:

    items:

      - description: module clock



  resets:

    items:

      - description: module reset



  reset-names:

    items:

      - const: spi



  dmas:

    items:

      - description: DMA channel used for reception

      - description: DMA channel used for transmission



  dma-names:

    items:

      - const: rx

      - const: tx



  spi-max-frequency:

    description: Maximum SPI clocking speed of the controller in Hz.

    $ref: /schemas/types.yaml#/definitions/uint32



allOf:

  - $ref: spi-controller.yaml



unevaluatedProperties: false



required:

  - compatible

  - reg

  - interrupts

  - clocks

  - resets

  - reset-names

  - dmas

  - dma-names



examples:

  - |

    #include <dt-bindings/clock/tegra20-car.h>

    #include <dt-bindings/interrupt-controller/arm-gic.h>



    spi@7000c380 {

        compatible = "nvidia,tegra20-sflash";

        reg = <0x7000c380 0x80>;

        interrupts = <GIC_SPI 39 IRQ_TYPE_LEVEL_HIGH>;

        spi-max-frequency = <25000000>;

        #address-cells = <1>;

        #size-cells = <0>;

        clocks = <&tegra_car TEGRA20_CLK_SPI>;

        resets = <&tegra_car 43>;

        reset-names = "spi";

        dmas = <&apbdma 11>, <&apbdma 11>;

        dma-names = "rx", "tx";

    };