[mirror_ubuntu-bionic-kernel.git] / Documentation / devicetree / bindings / phy / sun9i-usb-phy.txt

Allwinner sun9i USB PHY
-----------------------

Required properties:
- compatible : should be one of
  * allwinner,sun9i-a80-usb-phy
- reg : a list of offset + length pairs
- #phy-cells : from the generic phy bindings, must be 0
- phy_type : "hsic" for HSIC usage;
	     other values or absence of this property indicates normal USB
- clocks : phandle + clock specifier for the phy clocks
- clock-names : depending on the "phy_type" property,
  * "phy" for normal USB
  * "hsic_480M", "hsic_12M" for HSIC
- resets : a list of phandle + reset specifier pairs
- reset-names : depending on the "phy_type" property,
  * "phy" for normal USB
  * "hsic" for HSIC

Optional Properties:
- phy-supply : from the generic phy bindings, a phandle to a regulator that
	       provides power to VBUS.

It is recommended to list all clocks and resets available.
The driver will only use those matching the phy_type.

Example:
	usbphy1: phy@a01800 {
		compatible = "allwinner,sun9i-a80-usb-phy";
		reg = <0x00a01800 0x4>;
		clocks = <&usb_phy_clk 2>, <&usb_phy_clk 10>,
		       <&usb_phy_clk 3>;
		clock-names = "hsic_480M", "hsic_12M", "phy";
		resets = <&usb_phy_clk 18>, <&usb_phy_clk 19>;
		reset-names = "hsic", "phy";
		#phy-cells = <0>;
	};
Commit	Line	Data
9c3b4430 CYT	1	Allwinner sun9i USB PHY
	2	-----------------------
	3
	4	Required properties:
	5	- compatible : should be one of
	6	* allwinner,sun9i-a80-usb-phy
	7	- reg : a list of offset + length pairs
	8	- #phy-cells : from the generic phy bindings, must be 0
	9	- phy_type : "hsic" for HSIC usage;
	10	other values or absence of this property indicates normal USB
	11	- clocks : phandle + clock specifier for the phy clocks
	12	- clock-names : depending on the "phy_type" property,
	13	* "phy" for normal USB
	14	* "hsic_480M", "hsic_12M" for HSIC
	15	- resets : a list of phandle + reset specifier pairs
	16	- reset-names : depending on the "phy_type" property,
	17	* "phy" for normal USB
	18	* "hsic" for HSIC
	19
	20	Optional Properties:
	21	- phy-supply : from the generic phy bindings, a phandle to a regulator that
	22	provides power to VBUS.
	23
	24	It is recommended to list all clocks and resets available.
	25	The driver will only use those matching the phy_type.
	26
	27	Example:
48c926cd	28	usbphy1: phy@a01800 {
9c3b4430 CYT	29	compatible = "allwinner,sun9i-a80-usb-phy";
	30	reg = <0x00a01800 0x4>;
	31	clocks = <&usb_phy_clk 2>, <&usb_phy_clk 10>,
	32	<&usb_phy_clk 3>;
	33	clock-names = "hsic_480M", "hsic_12M", "phy";
	34	resets = <&usb_phy_clk 18>, <&usb_phy_clk 19>;
	35	reset-names = "hsic", "phy";
9c3b4430 CYT	36	#phy-cells = <0>;
9c3b4430 CYT	37	};