Documentation/devicetree/bindings/phy/bcm-ns-usb2-phy.yaml

   1 # SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/phy/bcm-ns-usb2-phy.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: Broadcom Northstar USB 2.0 PHY
   8
   9 description: >
  10   To initialize USB 2.0 PHY driver needs to setup PLL correctly.
  11   To do this it requires passing phandle to the USB PHY reference clock.
  12
  13 maintainers:
  14   - Rafał Miłecki <rafal@milecki.pl>
  15
  16 properties:
  17   compatible:
  18     const: brcm,ns-usb2-phy
  19
  20   reg:
  21     anyOf:
  22       - maxItems: 1
  23         description: PHY control register
  24       - maxItems: 1
  25         description: iomem address range of DMU (Device Management Unit)
  26         deprecated: true
  27
  28   reg-names:
  29     items:
  30       - const: dmu
  31
  32   brcm,syscon-clkset:
  33     description: phandle to syscon for clkset register
  34     $ref: /schemas/types.yaml#/definitions/phandle
  35
  36   clocks:
  37     items:
  38       - description: USB PHY reference clock
  39
  40   clock-names:
  41     items:
  42       - const: phy-ref-clk
  43
  44   "#phy-cells":
  45     const: 0
  46
  47 required:
  48   - compatible
  49   - reg
  50   - clocks
  51   - clock-names
  52   - "#phy-cells"
  53
  54 oneOf:
  55   - required:
  56       - brcm,syscon-clkset
  57   - required:
  58       - reg-names
  59
  60 additionalProperties: false
  61
  62 examples:
  63   - |
  64     #include <dt-bindings/clock/bcm-nsp.h>
  65     phy@1800c164 {
  66         compatible = "brcm,ns-usb2-phy";
  67         reg = <0x1800c164 0x4>;
  68         brcm,syscon-clkset = <&clkset>;
  69         clocks = <&genpll BCM_NSP_GENPLL_USB_PHY_REF_CLK>;
  70         clock-names = "phy-ref-clk";
  71         #phy-cells = <0>;
  72     };