4f4cfa6c56
There are lots of documents that belong to the admin-guide but are on random places (most under Documentation root dir). Move them to the admin guide. Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org> Acked-by: Alexandre Belloni <alexandre.belloni@bootlin.com> Acked-by: Bartlomiej Zolnierkiewicz <b.zolnierkie@samsung.com>
125 lines
2.7 KiB
ReStructuredText
125 lines
2.7 KiB
ReStructuredText
=============
|
|
btmrvl driver
|
|
=============
|
|
|
|
All commands are used via debugfs interface.
|
|
|
|
Set/get driver configurations
|
|
=============================
|
|
|
|
Path: /debug/btmrvl/config/
|
|
|
|
gpiogap=[n], hscfgcmd
|
|
These commands are used to configure the host sleep parameters::
|
|
bit 8:0 -- Gap
|
|
bit 16:8 -- GPIO
|
|
|
|
where GPIO is the pin number of GPIO used to wake up the host.
|
|
It could be any valid GPIO pin# (e.g. 0-7) or 0xff (SDIO interface
|
|
wakeup will be used instead).
|
|
|
|
where Gap is the gap in milli seconds between wakeup signal and
|
|
wakeup event, or 0xff for special host sleep setting.
|
|
|
|
Usage::
|
|
|
|
# Use SDIO interface to wake up the host and set GAP to 0x80:
|
|
echo 0xff80 > /debug/btmrvl/config/gpiogap
|
|
echo 1 > /debug/btmrvl/config/hscfgcmd
|
|
|
|
# Use GPIO pin #3 to wake up the host and set GAP to 0xff:
|
|
echo 0x03ff > /debug/btmrvl/config/gpiogap
|
|
echo 1 > /debug/btmrvl/config/hscfgcmd
|
|
|
|
psmode=[n], pscmd
|
|
These commands are used to enable/disable auto sleep mode
|
|
|
|
where the option is::
|
|
|
|
1 -- Enable auto sleep mode
|
|
0 -- Disable auto sleep mode
|
|
|
|
Usage::
|
|
|
|
# Enable auto sleep mode
|
|
echo 1 > /debug/btmrvl/config/psmode
|
|
echo 1 > /debug/btmrvl/config/pscmd
|
|
|
|
# Disable auto sleep mode
|
|
echo 0 > /debug/btmrvl/config/psmode
|
|
echo 1 > /debug/btmrvl/config/pscmd
|
|
|
|
|
|
hsmode=[n], hscmd
|
|
These commands are used to enable host sleep or wake up firmware
|
|
|
|
where the option is::
|
|
|
|
1 -- Enable host sleep
|
|
0 -- Wake up firmware
|
|
|
|
Usage::
|
|
|
|
# Enable host sleep
|
|
echo 1 > /debug/btmrvl/config/hsmode
|
|
echo 1 > /debug/btmrvl/config/hscmd
|
|
|
|
# Wake up firmware
|
|
echo 0 > /debug/btmrvl/config/hsmode
|
|
echo 1 > /debug/btmrvl/config/hscmd
|
|
|
|
|
|
Get driver status
|
|
=================
|
|
|
|
Path: /debug/btmrvl/status/
|
|
|
|
Usage::
|
|
|
|
cat /debug/btmrvl/status/<args>
|
|
|
|
where the args are:
|
|
|
|
curpsmode
|
|
This command displays current auto sleep status.
|
|
|
|
psstate
|
|
This command display the power save state.
|
|
|
|
hsstate
|
|
This command display the host sleep state.
|
|
|
|
txdnldrdy
|
|
This command displays the value of Tx download ready flag.
|
|
|
|
Issuing a raw hci command
|
|
=========================
|
|
|
|
Use hcitool to issue raw hci command, refer to hcitool manual
|
|
|
|
Usage::
|
|
|
|
Hcitool cmd <ogf> <ocf> [Parameters]
|
|
|
|
Interface Control Command::
|
|
|
|
hcitool cmd 0x3f 0x5b 0xf5 0x01 0x00 --Enable All interface
|
|
hcitool cmd 0x3f 0x5b 0xf5 0x01 0x01 --Enable Wlan interface
|
|
hcitool cmd 0x3f 0x5b 0xf5 0x01 0x02 --Enable BT interface
|
|
hcitool cmd 0x3f 0x5b 0xf5 0x00 0x00 --Disable All interface
|
|
hcitool cmd 0x3f 0x5b 0xf5 0x00 0x01 --Disable Wlan interface
|
|
hcitool cmd 0x3f 0x5b 0xf5 0x00 0x02 --Disable BT interface
|
|
|
|
SD8688 firmware
|
|
===============
|
|
|
|
Images:
|
|
|
|
- /lib/firmware/sd8688_helper.bin
|
|
- /lib/firmware/sd8688.bin
|
|
|
|
|
|
The images can be downloaded from:
|
|
|
|
git.infradead.org/users/dwmw2/linux-firmware.git/libertas/
|