xref: /freebsd/sys/contrib/device-tree/Bindings/usb/usb-nop-xceiv.txt (revision c66ec88fed842fbaad62c30d510644ceb7bd2d71)
1*c66ec88fSEmmanuel VadotUSB NOP PHY
2*c66ec88fSEmmanuel Vadot
3*c66ec88fSEmmanuel VadotRequired properties:
4*c66ec88fSEmmanuel Vadot- compatible: should be usb-nop-xceiv
5*c66ec88fSEmmanuel Vadot- #phy-cells: Must be 0
6*c66ec88fSEmmanuel Vadot
7*c66ec88fSEmmanuel VadotOptional properties:
8*c66ec88fSEmmanuel Vadot- clocks: phandle to the PHY clock. Use as per Documentation/devicetree
9*c66ec88fSEmmanuel Vadot  /bindings/clock/clock-bindings.txt
10*c66ec88fSEmmanuel Vadot  This property is required if clock-frequency is specified.
11*c66ec88fSEmmanuel Vadot
12*c66ec88fSEmmanuel Vadot- clock-names: Should be "main_clk"
13*c66ec88fSEmmanuel Vadot
14*c66ec88fSEmmanuel Vadot- clock-frequency: the clock frequency (in Hz) that the PHY clock must
15*c66ec88fSEmmanuel Vadot  be configured to.
16*c66ec88fSEmmanuel Vadot
17*c66ec88fSEmmanuel Vadot- vcc-supply: phandle to the regulator that provides power to the PHY.
18*c66ec88fSEmmanuel Vadot
19*c66ec88fSEmmanuel Vadot- reset-gpios: Should specify the GPIO for reset.
20*c66ec88fSEmmanuel Vadot
21*c66ec88fSEmmanuel Vadot- vbus-detect-gpio: should specify the GPIO detecting a VBus insertion
22*c66ec88fSEmmanuel Vadot                    (see Documentation/devicetree/bindings/gpio/gpio.txt)
23*c66ec88fSEmmanuel Vadot- vbus-regulator : should specifiy the regulator supplying current drawn from
24*c66ec88fSEmmanuel Vadot  the VBus line (see Documentation/devicetree/bindings/regulator/regulator.txt).
25*c66ec88fSEmmanuel Vadot
26*c66ec88fSEmmanuel VadotExample:
27*c66ec88fSEmmanuel Vadot
28*c66ec88fSEmmanuel Vadot	hsusb1_phy {
29*c66ec88fSEmmanuel Vadot		compatible = "usb-nop-xceiv";
30*c66ec88fSEmmanuel Vadot		clock-frequency = <19200000>;
31*c66ec88fSEmmanuel Vadot		clocks = <&osc 0>;
32*c66ec88fSEmmanuel Vadot		clock-names = "main_clk";
33*c66ec88fSEmmanuel Vadot		vcc-supply = <&hsusb1_vcc_regulator>;
34*c66ec88fSEmmanuel Vadot		reset-gpios = <&gpio1 7 GPIO_ACTIVE_LOW>;
35*c66ec88fSEmmanuel Vadot		vbus-detect-gpio = <&gpio2 13 GPIO_ACTIVE_HIGH>;
36*c66ec88fSEmmanuel Vadot		vbus-regulator = <&vbus_regulator>;
37*c66ec88fSEmmanuel Vadot		#phy-cells = <0>;
38*c66ec88fSEmmanuel Vadot	};
39*c66ec88fSEmmanuel Vadot
40*c66ec88fSEmmanuel Vadothsusb1_phy is a NOP USB PHY device that gets its clock from an oscillator
41*c66ec88fSEmmanuel Vadotand expects that clock to be configured to 19.2MHz by the NOP PHY driver.
42*c66ec88fSEmmanuel Vadothsusb1_vcc_regulator provides power to the PHY and GPIO 7 controls RESET.
43*c66ec88fSEmmanuel VadotGPIO 13 detects VBus insertion, and accordingly notifies the vbus-regulator.
44