===============================================================================
            U S E R  M A N U A L for Robust BT-WLAN coex (RBC)

 Copyright (C) 2012, Marvell International Ltd. 
 All Rights Reserved
===============================================================================

###############################

# Abbreviations and acronyms

###############################
RBC - Robust BT-WLAN co-existence 
TMD - Time Distribute
SMPS - Spatial Multiplexing Power Save

###############################

# Default RBC modes:

###############################
1.  For systems where BT and WLAN have seperate antennas, RBC mode is 
    automatically disabled in FW after detecting this from FEM cal data. e.g. 
    For 1x1 Dual-Ant system and 2x2 3-Ant system RBC mode is disabled.
2.  For systems where BT and WLAN share an antenna, RBC mode is automatically 
    enabled in FW after detecting this from FEM cal data. 
    Default modes:
    1x1 single antenna system: TMD RBC
    2x2 2-antenna system: 1x1 SMPS RBC


#################################

# 2x2 2-antenna system RBC modes

#################################
There are three mutually exclusive RBC modes for a 2x2 system. 
The default RBC mode is 1x1 SMPS RBC. The required RBC mode must be 
configured before starting uAP or associating in-STA. The mode cannot be 
changed dynamically when any of these connections is active. The modes are 
described below:
1.  1x1 SMPS RBC mode: WLAN switches to 1x1 FEM when BT is turned on. Also, 
    in-STA goes to SMPS mode w.r.t. ext-AP. When BT is turned off, WLAN 
    switches back to 2x2 FEM setting and in-STA moves out of SMPS.
    uAP starts bss with only 1-stream even BT is off because it cannot 
    dynamically move between 1-stream and 2-stream rates like in-STA. To start
    uAP with 2-stream, RBC mode has to be disabled.
2.  1x2 SMPS RBC mode: Similar as 1x1 SMPS RBC mode. WLAN switches to 1x2 FEM
    when BT is turned on. In this mode, it is expected that when BT is not 
    actively transmitting, WLAN can receive on both the antennas to enhance 
    the range. Note that 1-stream rates are used for receive and transmit.
3.  2x2 TMD RBC mode: WLAN uses 2x2 antenna setting and timeshares the antenna
    with BT.

###############################

# RBC mode select:

###############################

User can use robust_btc.conf and hostcmd to select different RBC mode:

hostcmd robust_btc_get
hostcmd robust_btc_enable
hostcmd robust_btc_disable
    This command is used to get/set Robust BT Coex.
    robust_btc_get: get the current configuration
    robust_btc_enable: enable and set the Robust BT Coex timing
    robust_btc_disable: disable the Robust BT Coex

    Usage:
        mlanconfig mlanX hostcmd config/robust_btc.conf robust_btc_get
        mlanconfig mlanX hostcmd config/robust_btc.conf robust_btc_enable
        mlanconfig mlanX hostcmd config/robust_btc.conf robust_btc_disable
