Configuring Common BLE Parameters#

The following sections describe common BLE configuration parameters that enable/disable or configure various BLE features of the SiWT917 Open Source Driver (OSD).

Note: The following insmod command may be used to configure multiple parameters at the same time. Note that this only applies to the parameters below that are configuring using insmod.

Replace module_param with the module parameter to be configured and <value> with the corresponding value that needs to be assigned. Module parameters in this section are grouped according to the corresponding feature.

insmod rsi_91x.ko [module_param = <value>], [module_param = <value>], ... , [module_param = <value>]

1. insmod rsi_91x.ko bt_rf_type = < value >: This variable selects the BT RF TYPE which the module has to operate. The following are the possible values:

   • 0 - EXTERNAL RF

   • 1 - INTERNAL RF (Default)

   For example, bt_rf_type = 1 sets bt rf type to Internal RF.

2. insmod rsi_91x.ko ble_tx_pwr_inx = < value > :This module param selects the BLE_TX_PWR index value. Default Value for BLE Tx Power Index is 30. The following are the possible values:

   For LP Chain : Power Index Range: 1 to 63

   • 1 to 31: BLE mode with 0 dBm output power.

   • 33 to 63: BLE mode with 10 dBm output power.

   Note: Modules do not support LP chain 10 dBm mode.

   For HP Chain : Power Index Range: 1 to 25, 40 to 91, and 127

   • 1 to 25: BLE mode with output power approximately equal to the selected power index, with a step size of 1 dB

     • Notes:

       • Power index vs output power for ICs and modules in this range (1 to 25) is identical.

       • Output power saturates between power index 22 and 25.

   • 40 to 91: BLE mode with output power approximately equal to (selected power index - 40) / 2, with a step size of 0.5 dB

   • 127: Maximum power supported as per country region regulations.

   For example, you can set the value as shown here.

   ble_tx_pwr_inx=0x1e

   Power Index vs Output Power Tables#

   Following are the Power Index vs Output Power in dBm for ICs and Modules

   Note: Output power varies from board to board..

   i. Modules in LP Chain#

   Power Index	Output Power (dBm)
   31	-0.7
   30	-0.7
   29	-0.8
   28	-0.8
   27	-0.9
   26	-1.0
   25	-1.1
   24	-1.2
   23	-1.2
   22	-1.3
   21	-1.4
   20	-1.6
   19	-1.7
   18	-1.8
   17	-2.0
   16	-2.2
   15	-2.5
   14	-2.7
   13	-3.0
   12	-3.4
   11	-3.7
   10	-4.2
   9	-4.7
   8	-5.4
   7	-6.1
   6	-7.1
   5	-8.3
   4	-9.8
   3	-12.0
   2	-15.1
   1	-20.1

   ii. ICs in LP Chain (Power Index 1-31)#

   Power Index	Output Power (dBm)
   31	-0.9
   30	-0.9
   29	-1.0
   28	-1.0
   27	-1.1
   26	-1.1
   25	-1.2
   24	-1.3
   23	-1.4
   22	-1.4
   21	-1.5
   20	-1.6
   19	-1.8
   18	-1.9
   17	-2.1
   16	-2.2
   15	-2.4
   14	-2.7
   13	-2.9
   12	-3.2
   11	-3.6
   10	-3.9
   9	-4.4
   8	-5.0
   7	-5.6
   6	-6.5
   5	-7.6
   4	-9.1
   3	-11.1
   2	-14.1
   1	-19.1

   iii. ICs in LP Chain (Power Index 33-63)#

   Power Index	Output Power (dBm)
   63	6.7
   62	6.6
   61	6.5
   60	6.4
   59	6.3
   58	6.2
   57	6.1
   56	5.9
   55	5.9
   54	5.7
   53	5.5
   52	5.3
   51	5.1
   50	5.1
   49	4.8
   48	4.5
   47	4.4
   46	4.0
   45	3.5
   44	3.0
   43	2.5
   42	1.9
   41	1.6
   40	0.8
   39	0.2
   38	-1.0
   37	-2.3
   36	-4.2
   35	-6.4
   34	-9.8
   33	-15.7

3. insmod rsi_91x.ko ble_power_save_options = < value >: This variable selects the BLE_PWR_SAVE_OPTIONS mode value. The following are the possible values.

   • BIT(0) - BLE_DUTY_CYCLING

   • BIT(1) - BLR_DUTY_CYCLING

   • BIT(2) - BLE_PWR_SAVE_4X_MODE

   Default value is 2 i.e. BIT(1)- BLR_DUTY_CYCLING is set.

4. insmod rsi_91x.ko ble_roles = < value >: This varialble sets the number of BLE roles allowed.

   • BIT[3:0] represents the number of central roles allowed.

   • BIT[7:4] represents the number of peripheral roles allowed.

   Default value is set to 19.

5. insmod rsi_91x.ko bt_bdr_mode = < value >: BDR mode in classic.

   • BIT(0) - BDR only selection

   • BIT(1) - BDR in LP chain selection

   Default value is bt_bdr_mode = 0.

6. insmod rsi_91x.ko bt_rf_tx_power_mode = < value >:

   Default value is 0.

7. insmod rsi_91x.ko bt_rf_rx_power_mode = < value >:

   Default value is 0.

8. insmod rsi_91x.ko bt_feature_bitmap = < value >: The bt_feature map can be assigned a value as explained below.

   • BIT[0] - For Enabling role switch from host set this bit to 1

   • BIT[1] - For Enabling sniff from host set this bit to 1

   • BIT[5] - For Enabling BT Spoof MAC address i.e to use HARDCODE_MAC_ADDR in BT this bit should be set to 1

   • BIT[7:3] - Reserved

   Default value is 0.

Note:

See the Common Software Parameters section for Configuring Common Software Parameters.

See the Common Wi-Fi Parameters section for Configuring Common Wi-Fi Parameters.