BLE Gain Table#

To program region-based maximum power for the BLE device, follow the steps below.

See the Region-based Maximum Power section for more details.

Compile and insert the driver as described in the Compilation Steps and Installing the Driver sections.
Navigate to the rsi/release folder.
Run the following command:
```
 # ./bt_ble_gain_table_update <protocol ID>
```
For example:
```
 # ./bt_ble_gain_table_update 0
```
In this case, 0 is the Protocol ID value for BLE.
The commands above start the table programming and should display the following logs.
```
  ******************Successfully completed programming n gain tables***************** 
```
In this case, n is the number of structures given in wlan_gain_table.txt file.

Below is the reference Gain table structure format while updating the file

//!************************************************************
//! INSTRUCTIONS SHOULD BE FOLLOWED TO EDIT BELOW GAIN TABLES:
//!************************************************************
//! 1. Each value should be seperated by ',' and space characters.
//! 2. Multi-line comments not supported. (e.g. /* comment */)
//! 3. A space before comment is needed, for inline comments. (e.g. <Data> //<Comment>)
//! 4. Hexadecimal numbers not supported.
//! 5. No space between value and ',' character.
//! 6. Max power gain table with size more than 10 bytes is not supported.
//! 6. Offset gain table with size more than 128 bytes is not supported.
//! 7. Supported table names and their maximum supported size are
//!     For BLE Max Power Table        --- RS9116_BLE_REGION_BASED_MAXPOWER_XX           MAX_LENGTH =  10
//!     For BLE Offset Table           --- RS9116_BLE_REGION_BASED_MAXPOWER_VS_OFFSET_XX MAX_LENGTH =  128
//!    NOTE: No support for other table names.
//! 8. Update above mentioned respected generic tables with the required data
//! 9. Max Power Gain table Format:
//!    <TABLE NAME>[] = { //<COMMENTS if any>
//!    <REGION NAME 1>, <MAX POWER>,
//!    <REGION NAME 2>, <MAX POWER>,
//!    .
//!    .
//!    <REGION NAME N>, <MAX POWER>,
//!    }; //<COMMENTS if any>
//!    
//! 10. Offset Gain table Format:
//!    <TABLE NAME>[] = { //<COMMENTS if any>
//!    <NO.of Regions>,
//!        <REGION NAME 1>, <NO.OF CHANNELS IN THIS REGION>,
//!            <CHANNEL NUMBER 1>, <TX POWER OFFSET FOR PHY RATE = 1M>,  <TX POWER OFFSET FOR PHY RATE = 2M>, <TX POWER OFFSET FOR PHY RATE = 125kbps>, <TX POWER OFFSET FOR PHY RATE = 500kbps>,
//!            <CHANNEL NUMBER 2>, <TX POWER OFFSET FOR PHY RATE = 1M>,  <TX POWER OFFSET FOR PHY RATE = 2M>, <TX POWER OFFSET FOR PHY RATE = 125kbps>, <TX POWER OFFSET FOR PHY RATE = 500kbps>,
//!            .
//!            .
//!            <CHANNEL NUMBER m-1>, <TX POWER OFFSET FOR PHY RATE = 1M>,  <TX POWER OFFSET FOR PHY RATE = 2M>, <TX POWER OFFSET FOR PHY RATE = 125kbps>, <TX POWER OFFSET FOR PHY RATE = 500kbps>,
//!            <CHANNEL NUMBER m>, <TX POWER OFFSET FOR PHY RATE = 1M>,  <TX POWER OFFSET FOR PHY RATE = 2M>, <TX POWER OFFSET FOR PHY RATE = 125kbps>, <TX POWER OFFSET FOR PHY RATE = 500kbps>,
//!        <REGION NAME 2>, <NO.OF CHANNELS IN THIS REGION>,
//!            <CHANNEL NUMBER 1>, <TX POWER OFFSET FOR PHY RATE = 1M>,  <TX POWER OFFSET FOR PHY RATE = 2M>, <TX POWER OFFSET FOR PHY RATE = 125kbps>, <TX POWER OFFSET FOR PHY RATE = 500kbps>,
//!            <CHANNEL NUMBER 2>, <TX POWER OFFSET FOR PHY RATE = 1M>,  <TX POWER OFFSET FOR PHY RATE = 2M>, <TX POWER OFFSET FOR PHY RATE = 125kbps>, <TX POWER OFFSET FOR PHY RATE = 500kbps>,
//!            .
//!            .
//!            <CHANNEL NUMBER m-1>, <TX POWER OFFSET FOR PHY RATE = 1M>,  <TX POWER OFFSET FOR PHY RATE = 2M>, <TX POWER OFFSET FOR PHY RATE = 125kbps>, <TX POWER OFFSET FOR PHY RATE = 500kbps>,
//!            <CHANNEL NUMBER m>, <TX POWER OFFSET FOR PHY RATE = 1M>,  <TX POWER OFFSET FOR PHY RATE = 2M>, <TX POWER OFFSET FOR PHY RATE = 125kbps>, <TX POWER OFFSET FOR PHY RATE = 500kbps>,
//!        <REGION NAME 3>, <NO.OF CHANNELS IN THIS REGION>,
//!        .
//!        .
//!        <REGION NAME y>, <NO.OF CHANNELS IN THIS REGION>,
//!    }; //<COMMENTS if any>
//! 11. Supported Region names:
//!     FCC, ETSI, TELEC, WORLDWIDE, KCC
//!


For example:

RS9116_BLE_REGION_BASED_MAXPOWER_XX[] = {
    // REGION_NAME  MAX_POWER
    FCC,        16,
    ETSI,       8,
    TELEC,      10,
    WORLDWIDE,  16,
    KCC,        10,
};

RS9116_BLE_REGION_BASED_MAXPOWER_VS_OFFSET_XX[] = {
    5, //NUM_OF_REGIONS
    FCC,
    4, //NUM_OF_CHANNELS
    //chan_num   1M   2M   125 kbps 500 kbps
        255,	 0,   0,      6,   0,
        0,       0,   0,      6,   0,
        38,      0,   2,      6,   0,
        39,      0,   16,     6,   0,
    ETSI,
    4, //NUM_OF_CHANNELS
    //chan_num   1M   2M   125 kbps 500 kbps
        255,	 0,   0,      0,   0,
        0,       0,   0,      0,   0,
        19,      0,   0,      0,   0,
        39,      0,   0,      0,   0,
    TELEC,
    4, //NUM_OF_CHANNELS
    //chan_num   1M   2M   125 kbps 500 kbps
        255,	 0,   0,      0,   0,
        0,	     0,   0,      0,   0,
        19,      0,   0,      0,   0,
        39,      0,   0,      0,   0,
    WORLDWIDE,
    4, //NUM_OF_CHANNELS
    //chan_num   1M   2M   125 kbps 500 kbps
        255,	 0,   0,      0,   0,
        0,       0,   0,      0,   0,
        19,      0,   0,      0,   0,
        39,      0,   0,      0,   0,
    KCC,
    4, //NUM_OF_CHANNELS
    //chan_num  1M   2M   125 kbps 500 kbps
        255,	0,   0,      0,   0,
        0,	    0,   0,      0,   0,
        19,     0,   0,      0,   0,
        39,     0,   0,      0,   0,
};