Merge branch 'master' of git://git.kernel.org/pub/scm/linux/kernel/git/linville/wirel...
[linux-2.6/linux-acpi-2.6/ibm-acpi-2.6.git] / Documentation / btmrvl.txt
blob34916a46c0997dd58e1922a48e08038aab930e02
1 =======================================================================
2                 README for btmrvl driver
3 =======================================================================
6 All commands are used via debugfs interface.
8 =====================
9 Set/get driver configurations:
11 Path:   /debug/btmrvl/config/
13 gpiogap=[n]
14 hscfgcmd
15         These commands are used to configure the host sleep parameters.
16         bit 8:0  -- Gap
17         bit 16:8 -- GPIO
19         where GPIO is the pin number of GPIO used to wake up the host.
20         It could be any valid GPIO pin# (e.g. 0-7) or 0xff (SDIO interface
21         wakeup will be used instead).
23         where Gap is the gap in milli seconds between wakeup signal and
24         wakeup event, or 0xff for special host sleep setting.
26         Usage:
27                 # Use SDIO interface to wake up the host and set GAP to 0x80:
28                 echo 0xff80 > /debug/btmrvl/config/gpiogap
29                 echo 1 > /debug/btmrvl/config/hscfgcmd
31                 # Use GPIO pin #3 to wake up the host and set GAP to 0xff:
32                 echo 0x03ff >  /debug/btmrvl/config/gpiogap
33                 echo 1 > /debug/btmrvl/config/hscfgcmd
35 psmode=[n]
36 pscmd
37         These commands are used to enable/disable auto sleep mode
39         where the option is:
40                         1       -- Enable auto sleep mode
41                         0       -- Disable auto sleep mode
43         Usage:
44                 # Enable auto sleep mode
45                 echo 1 > /debug/btmrvl/config/psmode
46                 echo 1 > /debug/btmrvl/config/pscmd
48                 # Disable auto sleep mode
49                 echo 0 > /debug/btmrvl/config/psmode
50                 echo 1 > /debug/btmrvl/config/pscmd
53 hsmode=[n]
54 hscmd
55         These commands are used to enable host sleep or wake up firmware
57         where the option is:
58                         1       -- Enable host sleep
59                         0       -- Wake up firmware
61         Usage:
62                 # Enable host sleep
63                 echo 1 > /debug/btmrvl/config/hsmode
64                 echo 1 > /debug/btmrvl/config/hscmd
66                 # Wake up firmware
67                 echo 0 > /debug/btmrvl/config/hsmode
68                 echo 1 > /debug/btmrvl/config/hscmd
71 ======================
72 Get driver status:
74 Path:   /debug/btmrvl/status/
76 Usage:
77         cat /debug/btmrvl/status/<args>
79 where the args are:
81 curpsmode
82         This command displays current auto sleep status.
84 psstate
85         This command display the power save state.
87 hsstate
88         This command display the host sleep state.
90 txdnldrdy
91         This command displays the value of Tx download ready flag.
94 =====================
96 Use hcitool to issue raw hci command, refer to hcitool manual
98         Usage: Hcitool cmd <ogf> <ocf> [Parameters]
100         Interface Control Command
101         hcitool cmd 0x3f 0x5b 0xf5 0x01 0x00    --Enable All interface
102         hcitool cmd 0x3f 0x5b 0xf5 0x01 0x01    --Enable Wlan interface
103         hcitool cmd 0x3f 0x5b 0xf5 0x01 0x02    --Enable BT interface
104         hcitool cmd 0x3f 0x5b 0xf5 0x00 0x00    --Disable All interface
105         hcitool cmd 0x3f 0x5b 0xf5 0x00 0x01    --Disable Wlan interface
106         hcitool cmd 0x3f 0x5b 0xf5 0x00 0x02    --Disable BT interface
108 =======================================================================
111 SD8688 firmware:
113 /lib/firmware/sd8688_helper.bin
114 /lib/firmware/sd8688.bin
117 The images can be downloaded from:
119 git.infradead.org/users/dwmw2/linux-firmware.git/libertas/