Commit 23c091d9 authored by Maxime Ripard's avatar Maxime Ripard Committed by Rob Herring
Browse files

dt-bindings: usb: Convert Allwinner A10 mUSB controller to a schema 



The Allwinner SoCs have an mUSB controller that 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@cerno.tech>
Signed-off-by: default avatarRob Herring <robh@kernel.org>
parent 067c650c

Documentation/devicetree/bindings/usb/allwinner,sun4i-a10-musb.txt

deleted100644 → 0
+0 −28
Original line number Diff line number Diff line 
Allwinner sun4i A10 musb DRC/OTG controller

-------------------------------------------



Required properties:

 - compatible      : "allwinner,sun4i-a10-musb", "allwinner,sun6i-a31-musb",

                     "allwinner,sun8i-a33-musb" or "allwinner,sun8i-h3-musb"

 - reg             : mmio address range of the musb controller

 - clocks          : clock specifier for the musb controller ahb gate clock

 - reset           : reset specifier for the ahb reset (A31 and newer only)

 - interrupts      : interrupt to which the musb controller is connected

 - interrupt-names : must be "mc"

 - phys            : phy specifier for the otg phy

 - phy-names       : must be "usb"

 - dr_mode         : Dual-Role mode must be "host" or "otg"

 - extcon          : extcon specifier for the otg phy



Example:



	usb_otg: usb@1c13000 {

		compatible = "allwinner,sun4i-a10-musb";

		reg = <0x01c13000 0x0400>;

		clocks = <&ahb_gates 0>;

		interrupts = <38>;

		interrupt-names = "mc";

		phys = <&usbphy 0>;

		phy-names = "usb";

		extcon = <&usbphy 0>;

	};

Documentation/devicetree/bindings/usb/allwinner,sun4i-a10-musb.yaml

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

%YAML 1.2

---

$id: http://devicetree.org/schemas/usb/allwinner,sun4i-a10-musb.yaml#

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



title: Allwinner A10 mUSB OTG Controller Device Tree Bindings



maintainers:

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

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



properties:

  compatible:

    oneOf:

      - const: allwinner,sun4i-a10-musb

      - const: allwinner,sun6i-a31-musb

      - const: allwinner,sun8i-a33-musb

      - const: allwinner,sun8i-h3-musb

      - items:

          - enum:

              - allwinner,sun8i-a83t-musb

              - allwinner,sun50i-h6-musb

          - const: allwinner,sun8i-a33-musb



  reg:

    maxItems: 1



  interrupts:

    maxItems: 1



  interrupt-names:

    const: mc



  clocks:

    maxItems: 1



  resets:

    maxItems: 1



  phys:

    description: PHY specifier for the OTG PHY



  phy-names:

    const: usb



  extcon:

    description: Extcon specifier for the OTG PHY



  dr_mode:

    enum:

      - host

      - otg

      - peripheral



  allwinner,sram:

    description: Phandle to the device SRAM

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



required:

  - compatible

  - reg

  - interrupts

  - interrupt-names

  - clocks

  - phys

  - phy-names

  - dr_mode

  - extcon



if:

  properties:

    compatible:

      contains:

        enum:

          - allwinner,sun6i-a31-musb

          - allwinner,sun8i-a33-musb

          - allwinner,sun8i-h3-musb



then:

  required:

    - resets



additionalProperties: false



examples:

  - |

    usb_otg: usb@1c13000 {

      compatible = "allwinner,sun4i-a10-musb";

      reg = <0x01c13000 0x0400>;

      clocks = <&ahb_gates 0>;

      interrupts = <38>;

      interrupt-names = "mc";

      phys = <&usbphy 0>;

      phy-names = "usb";

      extcon = <&usbphy 0>;

      dr_mode = "peripheral";

    };



...