xref: /freebsd/sys/contrib/device-tree/Bindings/phy/bcm-ns-usb2-phy.yaml (revision 2e3507c25e42292b45a5482e116d278f5515d04d) 
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
7title: Broadcom Northstar USB 2.0 PHY
8
9description: >
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
13maintainers:
14  - Rafał Miłecki <rafal@milecki.pl>
15
16properties:
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
47required:
48  - compatible
49  - reg
50  - clocks
51  - clock-names
52  - "#phy-cells"
53
54oneOf:
55  - required:
56      - brcm,syscon-clkset
57  - required:
58      - reg-names
59
60additionalProperties: false
61
62examples:
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    };
73