Commit 2609a127 authored by Maxime Ripard's avatar Maxime Ripard Committed by Rob Herring
Browse files

dt-bindings: interconnect: Convert Allwinner MBUS controller to a schema 



The older Allwinner SoCs have an MBUS controller that is used by Linux,
with a matching Device Tree binding.

Now that we have the DT validation in place, let's convert the device tree
bindings for that controller over to a YAML schemas.

Signed-off-by: default avatarMaxime Ripard <maxime@cerno.tech>
Signed-off-by: default avatarRob Herring <robh@kernel.org>
parent f78ed3c5

Documentation/devicetree/bindings/arm/sunxi/allwinner,sun4i-a10-mbus.yaml

0 → 100644
+65 −0
Original line number Diff line number Diff line 
# SPDX-License-Identifier: GPL-2.0

%YAML 1.2

---

$id: http://devicetree.org/schemas/arm/sunxi/allwinner,sun4i-a10-mbus.yaml#

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



title: Allwinner Memory Bus (MBUS) controller



maintainers:

  - Chen-Yu Tsai <wens@csie.org>

  - Maxime Ripard <mripard@kernel.org>



description: |

  The MBUS controller drives the MBUS that other devices in the SoC

  will use to perform DMA. It also has a register interface that

  allows to monitor and control the bandwidth and priorities for

  masters on that bus.



  Each device having to perform their DMA through the MBUS must have

  the interconnects and interconnect-names properties set to the MBUS

  controller and with "dma-mem" as the interconnect name.



properties:

  "#interconnect-cells":

    const: 1

    description:

      The content of the cell is the MBUS ID.



  compatible:

    enum:

      - allwinner,sun5i-a13-mbus

      - allwinner,sun8i-h3-mbus



  reg:

    maxItems: 1



  clocks:

    maxItems: 1



  dma-ranges:

    description:

      See section 2.3.9 of the DeviceTree Specification.



required:

  - "#interconnect-cells"

  - compatible

  - reg

  - clocks

  - dma-ranges



additionalProperties: false



examples:

  - |

    #include <dt-bindings/clock/sun5i-ccu.h>



    mbus: dram-controller@1c01000 {

        compatible = "allwinner,sun5i-a13-mbus";

        reg = <0x01c01000 0x1000>;

        clocks = <&ccu CLK_MBUS>;

        dma-ranges = <0x00000000 0x40000000 0x20000000>;

        #interconnect-cells = <1>;

    };



...

Documentation/devicetree/bindings/arm/sunxi/sunxi-mbus.txt

deleted100644 → 0
+0 −37
Original line number Diff line number Diff line 
Allwinner Memory Bus (MBUS) controller



The MBUS controller drives the MBUS that other devices in the SoC will

use to perform DMA. It also has a register interface that allows to

monitor and control the bandwidth and priorities for masters on that

bus.



Required properties:

 - compatible: Must be one of:

	- allwinner,sun5i-a13-mbus

	- allwinner,sun8i-h3-mbus

 - reg: Offset and length of the register set for the controller

 - clocks: phandle to the clock driving the controller

 - dma-ranges: See section 2.3.9 of the DeviceTree Specification

 - #interconnect-cells: Must be one, with the argument being the MBUS

   port ID



Each device having to perform their DMA through the MBUS must have the

interconnects and interconnect-names properties set to the MBUS

controller and with "dma-mem" as the interconnect name.



Example:



mbus: dram-controller@1c01000 {

	compatible = "allwinner,sun5i-a13-mbus";

	reg = <0x01c01000 0x1000>;

	clocks = <&ccu CLK_MBUS>;

	dma-ranges = <0x00000000 0x40000000 0x20000000>;

	#interconnect-cells = <1>;

};



fe0: display-frontend@1e00000 {

	compatible = "allwinner,sun5i-a13-display-frontend";

	...

	interconnects = <&mbus 19>;

	interconnect-names = "dma-mem";

};