xref: /OK3568_Linux_fs/kernel/Documentation/devicetree/bindings/net/btusb.txt (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593SmuzhiyunGeneric Bluetooth controller over USB (btusb driver)
2*4882a593Smuzhiyun---------------------------------------------------
3*4882a593Smuzhiyun
4*4882a593SmuzhiyunRequired properties:
5*4882a593Smuzhiyun
6*4882a593Smuzhiyun  - compatible : should comply with the format "usbVID,PID" specified in
7*4882a593Smuzhiyun		 Documentation/devicetree/bindings/usb/usb-device.txt
8*4882a593Smuzhiyun		 At the time of writing, the only OF supported devices
9*4882a593Smuzhiyun		 (more may be added later) are:
10*4882a593Smuzhiyun
11*4882a593Smuzhiyun		  "usb1286,204e" (Marvell 8997)
12*4882a593Smuzhiyun		  "usbcf3,e300" (Qualcomm QCA6174A)
13*4882a593Smuzhiyun		  "usb4ca,301a" (Qualcomm QCA6174A (Lite-On))
14*4882a593Smuzhiyun
15*4882a593Smuzhiyun
16*4882a593SmuzhiyunAlso, vendors that use btusb may have device additional properties, e.g:
17*4882a593SmuzhiyunDocumentation/devicetree/bindings/net/marvell-bt-8xxx.txt
18*4882a593Smuzhiyun
19*4882a593SmuzhiyunOptional properties:
20*4882a593Smuzhiyun
21*4882a593Smuzhiyun  - interrupt-names: (see below)
22*4882a593Smuzhiyun  - interrupts : The interrupt specified by the name "wakeup" is the interrupt
23*4882a593Smuzhiyun		 that shall be used for out-of-band wake-on-bt. Driver will
24*4882a593Smuzhiyun		 request this interrupt for wakeup. During system suspend, the
25*4882a593Smuzhiyun		 irq will be enabled so that the bluetooth chip can wakeup host
26*4882a593Smuzhiyun		 platform out of band. During system resume, the irq will be
27*4882a593Smuzhiyun		 disabled to make sure unnecessary interrupt is not received.
28*4882a593Smuzhiyun
29*4882a593SmuzhiyunExample:
30*4882a593Smuzhiyun
31*4882a593SmuzhiyunFollowing example uses irq pin number 3 of gpio0 for out of band wake-on-bt:
32*4882a593Smuzhiyun
33*4882a593Smuzhiyun&usb_host1_ehci {
34*4882a593Smuzhiyun    #address-cells = <1>;
35*4882a593Smuzhiyun    #size-cells = <0>;
36*4882a593Smuzhiyun
37*4882a593Smuzhiyun    mvl_bt1: bt@1 {
38*4882a593Smuzhiyun	compatible = "usb1286,204e";
39*4882a593Smuzhiyun	reg = <1>;
40*4882a593Smuzhiyun	interrupt-parent = <&gpio0>;
41*4882a593Smuzhiyun	interrupt-names = "wakeup";
42*4882a593Smuzhiyun	interrupts = <3 IRQ_TYPE_LEVEL_LOW>;
43*4882a593Smuzhiyun    };
44*4882a593Smuzhiyun};
45