Merge 4.14.92 into android-4.14-p
[GitHub/moto-9609/android_kernel_motorola_exynos9610.git] / Documentation / btmrvl.txt
CommitLineData
7f4e0121
MCC
1=============
2btmrvl driver
3=============
196be0cd
BZ
4
5All commands are used via debugfs interface.
6
7f4e0121
MCC
7Set/get driver configurations
8=============================
196be0cd
BZ
9
10Path: /debug/btmrvl/config/
11
7f4e0121
MCC
12gpiogap=[n], hscfgcmd
13 These commands are used to configure the host sleep parameters::
196be0cd
BZ
14 bit 8:0 -- Gap
15 bit 16:8 -- GPIO
16
17 where GPIO is the pin number of GPIO used to wake up the host.
18 It could be any valid GPIO pin# (e.g. 0-7) or 0xff (SDIO interface
19 wakeup will be used instead).
20
21 where Gap is the gap in milli seconds between wakeup signal and
22 wakeup event, or 0xff for special host sleep setting.
23
7f4e0121
MCC
24 Usage::
25
196be0cd
BZ
26 # Use SDIO interface to wake up the host and set GAP to 0x80:
27 echo 0xff80 > /debug/btmrvl/config/gpiogap
28 echo 1 > /debug/btmrvl/config/hscfgcmd
29
30 # Use GPIO pin #3 to wake up the host and set GAP to 0xff:
31 echo 0x03ff > /debug/btmrvl/config/gpiogap
32 echo 1 > /debug/btmrvl/config/hscfgcmd
33
7f4e0121 34psmode=[n], pscmd
196be0cd
BZ
35 These commands are used to enable/disable auto sleep mode
36
7f4e0121
MCC
37 where the option is::
38
196be0cd
BZ
39 1 -- Enable auto sleep mode
40 0 -- Disable auto sleep mode
41
7f4e0121
MCC
42 Usage::
43
196be0cd
BZ
44 # Enable auto sleep mode
45 echo 1 > /debug/btmrvl/config/psmode
46 echo 1 > /debug/btmrvl/config/pscmd
47
48 # Disable auto sleep mode
49 echo 0 > /debug/btmrvl/config/psmode
50 echo 1 > /debug/btmrvl/config/pscmd
51
52
7f4e0121 53hsmode=[n], hscmd
196be0cd
BZ
54 These commands are used to enable host sleep or wake up firmware
55
7f4e0121
MCC
56 where the option is::
57
196be0cd
BZ
58 1 -- Enable host sleep
59 0 -- Wake up firmware
60
7f4e0121
MCC
61 Usage::
62
196be0cd
BZ
63 # Enable host sleep
64 echo 1 > /debug/btmrvl/config/hsmode
65 echo 1 > /debug/btmrvl/config/hscmd
66
67 # Wake up firmware
68 echo 0 > /debug/btmrvl/config/hsmode
69 echo 1 > /debug/btmrvl/config/hscmd
70
71
7f4e0121
MCC
72Get driver status
73=================
196be0cd
BZ
74
75Path: /debug/btmrvl/status/
76
7f4e0121
MCC
77Usage::
78
196be0cd
BZ
79 cat /debug/btmrvl/status/<args>
80
81where the args are:
82
83curpsmode
84 This command displays current auto sleep status.
85
86psstate
87 This command display the power save state.
88
89hsstate
90 This command display the host sleep state.
91
92txdnldrdy
93 This command displays the value of Tx download ready flag.
94
7f4e0121
MCC
95Issuing a raw hci command
96=========================
196be0cd
BZ
97
98Use hcitool to issue raw hci command, refer to hcitool manual
99
7f4e0121
MCC
100Usage::
101
102 Hcitool cmd <ogf> <ocf> [Parameters]
103
104Interface Control Command::
196be0cd 105
196be0cd
BZ
106 hcitool cmd 0x3f 0x5b 0xf5 0x01 0x00 --Enable All interface
107 hcitool cmd 0x3f 0x5b 0xf5 0x01 0x01 --Enable Wlan interface
108 hcitool cmd 0x3f 0x5b 0xf5 0x01 0x02 --Enable BT interface
109 hcitool cmd 0x3f 0x5b 0xf5 0x00 0x00 --Disable All interface
110 hcitool cmd 0x3f 0x5b 0xf5 0x00 0x01 --Disable Wlan interface
111 hcitool cmd 0x3f 0x5b 0xf5 0x00 0x02 --Disable BT interface
112
7f4e0121
MCC
113SD8688 firmware
114===============
196be0cd 115
7f4e0121 116Images:
196be0cd 117
7f4e0121
MCC
118- /lib/firmware/sd8688_helper.bin
119- /lib/firmware/sd8688.bin
196be0cd
BZ
120
121
122The images can be downloaded from:
123
124git.infradead.org/users/dwmw2/linux-firmware.git/libertas/