Gitiles
Code Review Sign In
gerrit-public.fairphone.software / kernel / msm-4.19 / a7340d31abacf60efb68b299829c85e171878eae / . / Documentation / btmrvl.txt
blob: ec57740ead0c7566475b2b3111e9b78195ae7c30 [file] [log] [blame]
Mauro Carvalho Chehab7f4e0122017-05-14 08:03:53 -0300[diff] [blame]1=============
2btmrvl driver
3=============
Bing Zhao196be0c2009-06-02 14:29:38 -0700[diff] [blame]4
5All commands are used via debugfs interface.
6
Mauro Carvalho Chehab7f4e0122017-05-14 08:03:53 -0300[diff] [blame]7Set/get driver configurations
8=============================
Bing Zhao196be0c2009-06-02 14:29:38 -0700[diff] [blame]9
10Path: /debug/btmrvl/config/
11
Mauro Carvalho Chehab7f4e0122017-05-14 08:03:53 -0300[diff] [blame]12gpiogap=[n], hscfgcmd
13 These commands are used to configure the host sleep parameters::
Bing Zhao196be0c2009-06-02 14:29:38 -0700[diff] [blame]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
Mauro Carvalho Chehab7f4e0122017-05-14 08:03:53 -0300[diff] [blame]24 Usage::
25
Bing Zhao196be0c2009-06-02 14:29:38 -0700[diff] [blame]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
Mauro Carvalho Chehab7f4e0122017-05-14 08:03:53 -0300[diff] [blame]34psmode=[n], pscmd
Bing Zhao196be0c2009-06-02 14:29:38 -0700[diff] [blame]35 These commands are used to enable/disable auto sleep mode
36
Mauro Carvalho Chehab7f4e0122017-05-14 08:03:53 -0300[diff] [blame]37 where the option is::
38
Bing Zhao196be0c2009-06-02 14:29:38 -0700[diff] [blame]39 1 -- Enable auto sleep mode
40 0 -- Disable auto sleep mode
41
Mauro Carvalho Chehab7f4e0122017-05-14 08:03:53 -0300[diff] [blame]42 Usage::
43
Bing Zhao196be0c2009-06-02 14:29:38 -0700[diff] [blame]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
Mauro Carvalho Chehab7f4e0122017-05-14 08:03:53 -0300[diff] [blame]53hsmode=[n], hscmd
Bing Zhao196be0c2009-06-02 14:29:38 -0700[diff] [blame]54 These commands are used to enable host sleep or wake up firmware
55
Mauro Carvalho Chehab7f4e0122017-05-14 08:03:53 -0300[diff] [blame]56 where the option is::
57
Bing Zhao196be0c2009-06-02 14:29:38 -0700[diff] [blame]58 1 -- Enable host sleep
59 0 -- Wake up firmware
60
Mauro Carvalho Chehab7f4e0122017-05-14 08:03:53 -0300[diff] [blame]61 Usage::
62
Bing Zhao196be0c2009-06-02 14:29:38 -0700[diff] [blame]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
Mauro Carvalho Chehab7f4e0122017-05-14 08:03:53 -0300[diff] [blame]72Get driver status
73=================
Bing Zhao196be0c2009-06-02 14:29:38 -0700[diff] [blame]74
75Path: /debug/btmrvl/status/
76
Mauro Carvalho Chehab7f4e0122017-05-14 08:03:53 -0300[diff] [blame]77Usage::
78
Bing Zhao196be0c2009-06-02 14:29:38 -0700[diff] [blame]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
Mauro Carvalho Chehab7f4e0122017-05-14 08:03:53 -0300[diff] [blame]95Issuing a raw hci command
96=========================
Bing Zhao196be0c2009-06-02 14:29:38 -0700[diff] [blame]97
98Use hcitool to issue raw hci command, refer to hcitool manual
99
Mauro Carvalho Chehab7f4e0122017-05-14 08:03:53 -0300[diff] [blame]100Usage::
Bing Zhao196be0c2009-06-02 14:29:38 -0700[diff] [blame]101
Mauro Carvalho Chehab7f4e0122017-05-14 08:03:53 -0300[diff] [blame]102 Hcitool cmd <ogf> <ocf> [Parameters]
103
104Interface Control Command::
105
Bing Zhao196be0c2009-06-02 14:29:38 -0700[diff] [blame]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
Mauro Carvalho Chehab7f4e0122017-05-14 08:03:53 -0300[diff] [blame]113SD8688 firmware
114===============
Bing Zhao196be0c2009-06-02 14:29:38 -0700[diff] [blame]115
Mauro Carvalho Chehab7f4e0122017-05-14 08:03:53 -0300[diff] [blame]116Images:
Bing Zhao196be0c2009-06-02 14:29:38 -0700[diff] [blame]117
Mauro Carvalho Chehab7f4e0122017-05-14 08:03:53 -0300[diff] [blame]118- /lib/firmware/sd8688_helper.bin
119- /lib/firmware/sd8688.bin
Bing Zhao196be0c2009-06-02 14:29:38 -0700[diff] [blame]120
121
122The images can be downloaded from:
123
124git.infradead.org/users/dwmw2/linux-firmware.git/libertas/