Commit a5af82a8 authored by Florian Fainelli's avatar Florian Fainelli Committed by Rob Herring
Browse files

dt-bindings: usb: Convert BDC to YAML



Convert the Broadcom BDC device controller Device Tree binding to YAML
to help with validation.

Signed-off-by: default avatarFlorian Fainelli <f.fainelli@gmail.com>
Signed-off-by: default avatarRob Herring <robh@kernel.org>
Link: https://lore.kernel.org/r/20211217042001.479577-7-f.fainelli@gmail.com
parent 58e529ea
Loading
Loading
Loading
Loading
+0 −29
Original line number Diff line number Diff line
Broadcom USB Device Controller (BDC)
====================================

Required properties:

- compatible: must be one of:
                "brcm,bdc-udc-v2"
                "brcm,bdc"
- reg: the base register address and length
- interrupts: the interrupt line for this controller

Optional properties:

On Broadcom STB platforms, these properties are required:

- phys: phandle to one or two USB PHY blocks
        NOTE: Some SoC's have a single phy and some have
        USB 2.0 and USB 3.0 phys
- clocks: phandle to the functional clock of this block

Example:

        bdc@f0b02000 {
                compatible = "brcm,bdc-udc-v2";
                reg = <0xf0b02000 0xfc4>;
                interrupts = <0x0 0x60 0x0>;
                phys = <&usbphy_0 0x0>;
                clocks = <&sw_usbd>;
        };
+50 −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/usb/brcm,bdc.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Broadcom USB Device Controller (BDC)

maintainers:
  - Al Cooper <alcooperx@gmail.com>
  - Florian Fainelli <f.fainelli@gmail.com>

properties:
  compatible:
    items:
      - enum:
          - brcm,bdc-udc-v2
          - brcm,bdc

  reg:
    maxItems: 1

  interrupts:
    maxItems: 1

  phys:
    minItems: 1
    items:
      - description: USB 2.0 or 3.0 PHY
      - description: USB 3.0 PHY if there is a dedicated 2.0 PHY

  clocks:
    maxItems: 1

required:
  - compatible
  - reg
  - interrupts

additionalProperties: false

examples:
  - |
        usb@f0b02000 {
                compatible = "brcm,bdc-udc-v2";
                reg = <0xf0b02000 0xfc4>;
                interrupts = <0x0 0x60 0x0>;
                phys = <&usbphy_0 0x0>;
                clocks = <&sw_usbd>;
        };
+1 −1
Original line number Diff line number Diff line
@@ -3679,7 +3679,7 @@ M: Al Cooper <alcooperx@gmail.com>
L:	linux-usb@vger.kernel.org
L:	bcm-kernel-feedback-list@broadcom.com
S:	Maintained
F:	Documentation/devicetree/bindings/usb/brcm,bdc.txt
F:	Documentation/devicetree/bindings/usb/brcm,bdc.yaml
F:	drivers/usb/gadget/udc/bdc/
BROADCOM BMIPS CPUFREQ DRIVER