Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 31ca694e authored by Maxime Ripard's avatar Maxime Ripard Committed by Rob Herring
Browse files

dt-bindings: bus: Convert Allwinner DE2 bus to a schema 



The Allwinner SoCs using the second generation of the display engine have a
bus for that display engine. The bus is supported in 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.ripard@bootlin.com>
[robh: add 'type: object' for child nodes]
Signed-off-by: default avatarRob Herring <robh@kernel.org>
parent 5bf2845e

Documentation/devicetree/bindings/bus/allwinner,sun50i-a64-de2.yaml

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

%YAML 1.2

---

$id: http://devicetree.org/schemas/bus/allwinner,sun50i-a64-de2.yaml#

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



title: Allwinner A64 Display Engine Bus Device Tree Bindings



maintainers:

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

  - Maxime Ripard <maxime.ripard@bootlin.com>



properties:

  $nodename:

    pattern: "^bus(@[0-9a-f]+)?$"



  "#address-cells":

    const: 1



  "#size-cells":

    const: 1



  compatible:

    oneOf:

      - const: allwinner,sun50i-a64-de2

      - items:

          - const: allwinner,sun50i-h6-de3

          - const: allwinner,sun50i-a64-de2



  reg:

    maxItems: 1



  allwinner,sram:

    allOf:

      - $ref: /schemas/types.yaml#definitions/phandle-array

      - maxItems: 1

    description:

      The SRAM that needs to be claimed to access the display engine

      bus.



  ranges: true



patternProperties:

  # All other properties should be child nodes with unit-address and 'reg'

  "^[a-zA-Z][a-zA-Z0-9,+\\-._]{0,63}@[0-9a-fA-F]+$":

    type: object

    properties:

      reg:

        maxItems: 1



    required:

      - reg



required:

  - compatible

  - reg

  - "#address-cells"

  - "#size-cells"

  - ranges

  - allwinner,sram



additionalProperties: false



examples:

  - |

    bus@1000000 {

        compatible = "allwinner,sun50i-a64-de2";

        reg = <0x1000000 0x400000>;

        allwinner,sram = <&de2_sram 1>;

        #address-cells = <1>;

        #size-cells = <1>;

        ranges = <0 0x1000000 0x400000>;



        display_clocks: clock@0 {

            compatible = "allwinner,sun50i-a64-de2-clk";

            reg = <0x0 0x100000>;

            clocks = <&ccu 52>, <&ccu 99>;

            clock-names = "bus", "mod";

            resets = <&ccu 30>;

            #clock-cells = <1>;

            #reset-cells = <1>;

        };

    };



...

Documentation/devicetree/bindings/bus/sun50i-de2-bus.txt

deleted100644 → 0
+0 −40
Original line number Diff line number Diff line 
Device tree bindings for Allwinner DE2/3 bus



The Allwinner A64 DE2 is on a special bus, which needs a SRAM region (SRAM C)

to be claimed for enabling the access. The DE3 on Allwinner H6 is at the same

situation, and the binding also applies.



Required properties:



 - compatible:		Should be one of:

				- "allwinner,sun50i-a64-de2"

				- "allwinner,sun50i-h6-de3", "allwinner,sun50i-a64-de2"

 - reg:			A resource specifier for the register space

 - #address-cells:	Must be set to 1

 - #size-cells:		Must be set to 1

 - ranges:		Must be set up to map the address space inside the

			DE2, for the sub-blocks of DE2.

 - allwinner,sram:	the SRAM that needs to be claimed



Example:



	de2@1000000 {

		compatible = "allwinner,sun50i-a64-de2";

		reg = <0x1000000 0x400000>;

		allwinner,sram = <&de2_sram 1>;

		#address-cells = <1>;

		#size-cells = <1>;

		ranges = <0 0x1000000 0x400000>;



		display_clocks: clock@0 {

			compatible = "allwinner,sun50i-a64-de2-clk";

			reg = <0x0 0x100000>;

			clocks = <&ccu CLK_DE>,

				 <&ccu CLK_BUS_DE>;

			clock-names = "mod",

				      "bus";

			resets = <&ccu RST_BUS_DE>;

			#clock-cells = <1>;

			#reset-cells = <1>;

		};

	};