[deliverable/linux.git] / Documentation / devicetree / bindings / usb / dwc2.txt

Platform DesignWare HS OTG USB 2.0 controller
-----------------------------------------------------

Required properties:
- compatible : One of:
  - brcm,bcm2835-usb: The DWC2 USB controller instance in the BCM2835 SoC.
  - hisilicon,hi6220-usb: The DWC2 USB controller instance in the hi6220 SoC.
  - rockchip,rk3066-usb: The DWC2 USB controller instance in the rk3066 Soc;
  - "rockchip,rk3188-usb", "rockchip,rk3066-usb", "snps,dwc2": for rk3188 Soc;
  - "rockchip,rk3288-usb", "rockchip,rk3066-usb", "snps,dwc2": for rk3288 Soc;
  - snps,dwc2: A generic DWC2 USB controller with default parameters.
- reg : Should contain 1 register range (address and length)
- interrupts : Should contain 1 interrupt
- clocks: clock provider specifier
- clock-names: shall be "otg"
Refer to clk/clock-bindings.txt for generic clock consumer properties

Optional properties:
- phys: phy provider specifier
- phy-names: shall be "usb2-phy"
Refer to phy/phy-bindings.txt for generic phy consumer properties
- dr_mode: shall be one of "host", "peripheral" and "otg"
  Refer to usb/generic.txt
- g-use-dma: enable dma usage in gadget driver.
- g-rx-fifo-size: size of rx fifo size in gadget mode.
- g-np-tx-fifo-size: size of non-periodic tx fifo size in gadget mode.
- g-tx-fifo-size: size of periodic tx fifo per endpoint (except ep0) in gadget mode.

Example:

        usb@101c0000 {
                compatible = "ralink,rt3050-usb, snps,dwc2";
                reg = <0x101c0000 40000>;
                interrupts = <18>;
		clocks = <&usb_otg_ahb_clk>;
		clock-names = "otg";
		phys = <&usbphy>;
		phy-names = "usb2-phy";
        };
Commit	Line	Data
5b9974b1 MK	1	Platform DesignWare HS OTG USB 2.0 controller
	2	-----------------------------------------------------
	3
	4	Required properties:
831eae69 SW	5	- compatible : One of:
831eae69 SW	6	- brcm,bcm2835-usb: The DWC2 USB controller instance in the BCM2835 SoC.
37dd9d65	7	- hisilicon,hi6220-usb: The DWC2 USB controller instance in the hi6220 SoC.
3675029a KY	8	- rockchip,rk3066-usb: The DWC2 USB controller instance in the rk3066 Soc;
	9	- "rockchip,rk3188-usb", "rockchip,rk3066-usb", "snps,dwc2": for rk3188 Soc;
	10	- "rockchip,rk3288-usb", "rockchip,rk3066-usb", "snps,dwc2": for rk3288 Soc;
831eae69	11	- snps,dwc2: A generic DWC2 USB controller with default parameters.
5b9974b1 MK	12	- reg : Should contain 1 register range (address and length)
5b9974b1 MK	13	- interrupts : Should contain 1 interrupt
65b4eb9e MP	14	- clocks: clock provider specifier
	15	- clock-names: shall be "otg"
	16	Refer to clk/clock-bindings.txt for generic clock consumer properties
	17
	18	Optional properties:
	19	- phys: phy provider specifier
9d4bde5f	20	- phy-names: shall be "usb2-phy"
65b4eb9e	21	Refer to phy/phy-bindings.txt for generic phy consumer properties
fc1b0e2a KY	22	- dr_mode: shall be one of "host", "peripheral" and "otg"
fc1b0e2a KY	23	Refer to usb/generic.txt
b2f93ef3	24	- g-use-dma: enable dma usage in gadget driver.
bb8693a9 GH	25	- g-rx-fifo-size: size of rx fifo size in gadget mode.
	26	- g-np-tx-fifo-size: size of non-periodic tx fifo size in gadget mode.
	27	- g-tx-fifo-size: size of periodic tx fifo per endpoint (except ep0) in gadget mode.
5b9974b1 MK	28
	29	Example:
	30
	31	usb@101c0000 {
	32	compatible = "ralink,rt3050-usb, snps,dwc2";
	33	reg = <0x101c0000 40000>;
	34	interrupts = <18>;
65b4eb9e MP	35	clocks = <&usb_otg_ahb_clk>;
	36	clock-names = "otg";
	37	phys = <&usbphy>;
	38	phy-names = "usb2-phy";
5b9974b1	39	};