Commit fb87c979 authored by Linus Walleij's avatar Linus Walleij Committed by Greg Kroah-Hartman
Browse files

dt-bindings: usb: Convert FOTG210 to dt schema 



This converts the Faraday FOTG210 OTG USB controller to use
a YAML schema. We add all the right includes for OTG controllers
and make it possible to specify dr_mode and phy.

Cc: devicetree@vger.kernel.org
Cc: Hans Ulli Kroll <ulli.kroll@googlemail.com>
Signed-off-by: default avatarLinus Walleij <linus.walleij@linaro.org>
Reviewed-by: default avatarRob Herring <robh@kernel.org>
Link: https://lore.kernel.org/r/20220925123546.770843-1-linus.walleij@linaro.org


Signed-off-by: default avatarGreg Kroah-Hartman <gregkh@linuxfoundation.org>
parent 1c703e29

Documentation/devicetree/bindings/usb/faraday,fotg210.txt

deleted100644 → 0
+0 −35
Original line number Diff line number Diff line 
Faraday FOTG Host controller



This OTG-capable USB host controller is found in Cortina Systems

Gemini and other SoC products.



Required properties:

- compatible: should be one of:

  "faraday,fotg210"

  "cortina,gemini-usb", "faraday,fotg210"

- reg: should contain one register range i.e. start and length

- interrupts: description of the interrupt line



Optional properties:

- clocks: should contain the IP block clock

- clock-names: should be "PCLK" for the IP block clock



Required properties for "cortina,gemini-usb" compatible:

- syscon: a phandle to the system controller to access PHY registers



Optional properties for "cortina,gemini-usb" compatible:

- cortina,gemini-mini-b: boolean property that indicates that a Mini-B

  OTG connector is in use

- wakeup-source: see power/wakeup-source.txt



Example for Gemini:



usb@68000000 {

	compatible = "cortina,gemini-usb", "faraday,fotg210";

	reg = <0x68000000 0x1000>;

	interrupts = <10 IRQ_TYPE_LEVEL_HIGH>;

	clocks = <&cc 12>;

	clock-names = "PCLK";

	syscon = <&syscon>;

	wakeup-source;

};

Documentation/devicetree/bindings/usb/faraday,fotg210.yaml

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

# Copyright 2022 Linaro Ltd.

%YAML 1.2

---

$id: http://devicetree.org/schemas/usb/faraday,fotg210.yaml#

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



title: Faraday Technology FOTG210 HS OTG USB 2.0 controller Bindings



maintainers:

  - Linus Walleij <linus.walleij@linaro.org>



allOf:

  - $ref: usb-drd.yaml#

  - $ref: usb-hcd.yaml#



properties:

  compatible:

    oneOf:

      - const: faraday,fotg210

      - items:

          - const: cortina,gemini-usb

          - const: faraday,fotg210



  reg:

    maxItems: 1



  interrupts:

    maxItems: 1



  clocks:

    maxItems: 1



  clock-names:

    items:

      - const: PCLK



  resets:

    maxItems: 1



  syscon:

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

    description: a phandle to the global Gemini system controller on

      Gemini systems



  dr_mode: true



  phys:

    maxItems: 1



  phy-names:

    const: usb2-phy



required:

  - compatible

  - reg

  - interrupts

  - clocks

  - clock-names



additionalProperties: false



examples:

  - |

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

    #include <dt-bindings/clock/cortina,gemini-clock.h>

    #include <dt-bindings/reset/cortina,gemini-reset.h>

    usb0: usb@68000000 {

        compatible = "cortina,gemini-usb", "faraday,fotg210";

        reg = <0x68000000 0x1000>;

        interrupts = <10 IRQ_TYPE_LEVEL_HIGH>;

        resets = <&syscon GEMINI_RESET_USB0>;

        clocks = <&syscon GEMINI_CLK_GATE_USB0>;

        clock-names = "PCLK";

        syscon = <&syscon>;

        dr_mode = "host";

    };