You are viewing documentation for version: 2.5 | Version History

BT Classic Commands

The following sections document RS9116 WiSeConnect commands, parameters, responses and availability. For error codes returned by commands, see https://docs.silabs.com/rs9116-wiseconnect/latest/wifibt-wc-sapi-reference/error-codes .

Index

This section explains various Bluetooth Classic commands, their structures, parameters and their responses. For API prototypes of these commands, please refer to the API Library Section.

A command should not be issued by the Host before receiving the response of a previously issued command from the module.

[ Go to top ]

rsi_opermode :: Set Operating Mode

Description

This is the first command that needs to be sent from the Host after receiving card ready frame from module. This command configures the module in different functional modes.

Command Format

If BIT(31) is set to ‘1’ in custom_feature_bitmap

at+rsi_opermode=<oper_mode>,<feature_bit_map>,<tcp_ip_feature_bit_map>,<custom_feature_bitmap><ext_custom_feature_bit_map>

If BIT(31) is set to ‘1’ in tcp_ip_feature_bit_map

at+rsi_opermode=<oper_mode>,<feature_bit_map>,<tcp_ip_feature_bit_map>,<custom_feature_bitmap><ext_tcp_ip_feature_bit_map>

If BIT(31) is set to ‘1’ in both custom_feature and ext_custom_feature bit maps

at+rsi_opermode=<oper_mode>,<feature_bit_map>,<tcp_ip_feature_bit_map>,<custom_feature_bitmap><ext_custom_feature_bit_map> <bt_feature_bit_map> 

if BIT(31) is set to 1 in bt_feature_bit_map

at+rsi_opermode=<oper_mode>,<feature_bit_map>,<tcp_ip_feature_bit_map>,<custom_feature_bitmap><ext_custom_feature_bit_map><bt_feature_bit_map><ext_tcp_ip_feature_bit_map><ble_feature_bit_map>

If BIT(31) is set to 1 in ble_custom_feature_bit_map

at+rsi_opermode=<oper_mode>,<feature_bit_map>,<tcp_ip_feature_ bit_map>,<custom_feature_bitmap><ext_custom_feature_bit_map><bt_custom_feature_bit_map><ext_tcp_ip_feature_bit_map><ble_custom_feature_bit_map>,<ble_custom_ext_feature_bit_map>

If BIT(31) is set to 1 in both tcp_ip_feature_bit_map and ext_tcp_ip_feature_bit_map

at+rsi_opermode=<oper_mode>,<feature_bit_map>,<tcp_ip_feature_bit_map>,<custom_feature_bitmap><ext_custom_feature_bit_map><bt_custom_feature_bit_map><ext_tcp_ip_feature_bit_map><ble_custom_feature_bit_map>,<ble_custom_ext_feature_bit_map>,<config_feature_bit_map>

Parameters

oper_mode

• Sets the mode of operation. oper_mode contains two parts <wifi_oper_mode, coex_mode>. Lower two bytes represent wifi_oper_mode and higher two bytes represent coex_modes .

  oper_mode = ((wifi_oper_mode) | (coex_mode << 16))

Note!

• See Wi-Fi AT Command PRM for more details on WLAN and co-existence of other protocols with WLAN.
• In Bluetooth Low Energy (BLE) mode, Bluetooth Classic (BTC) mode also needs to be enabled.
• Coex mode 8 (Dual mode) and 4 (BT classic mode) are not supported.
• Instead of coexmode 8 and 4, To achieve the same functionality, please use coexmode 9 and 5.
• To achieve the power save functionality, please trigger the at+rsi_init command after the at+rsi_opermode command and also issue both WLAN and BT power save commands.
• If coex mode is enabled in opermode command, then BT / BLE protocol get starts and gives corresponding card ready in parallel with opermode command response (which will be handled by corresponding application).

custom_feature_bit_map

• This bitmap is used to enable following BT/BLE custom features:
  • BIT[11]: To Enable Packet Pending Indication( wake on wireless ) in UART mode
    • 0 - Disable
    • 1 - Enable
  • BIT[29]: To Enable IAP support in BT mode
    • 0 - Disable
    • 1 - Enable
  • BIT[31]: This bit is used to validate extended custom feature bitmap.
    • 0 - Extended feature bitmap valid
    • 1 - Extended feature bitmap is invalid
  • BIT[0:1],BIT[3:4],BIT[7],BIT[21],BIT[30]: Reserved, should be set to all 0 .

Note! For UART / USB-CDC in AT mode:

• The parameters feature_bit_map , tcp_ip_feature_bit_map and custom_feature_bit_map are optional in opermode command in UART mode. If user does not give these parameters then default configuration gets selected as explained above based on the operating mode configured.

ext_custom_feature_bit_map

• This feature bitmap is an extension of custom feature bitmap and is valid only if BIT[31] of custom feature bitmap is set. This enables the following feature. If this bit is enabled then connected clients which are in powersave may observe packet miss.
  • BIT[0]: To enable antenna diversity feature.
    • 0 - Disable antenna diversity feature
    • 1 - Enable antenna diversity feature
  • BIT[1]: This bit is used to enable 4096 bit RSA key support
    • 0 - Disable 4096 bit RSA key support
    • 1 - Enable 4096 bit RSA key support
  • BIT[5]: This bit is used to enable Pre-authentication Support.
    • 1 - Enable Pre-authentication Support
    • 0 - Disable Pre-authentication Support
  • BIT[6]: This bit is used to enable 40MHz Support
    • 0 - Disable 40MHz Support
    • 1 - Enable 40MHz Support
• BIT[20:21] - These bits are used to configure 384k mode (which is mandatory).
  • 0 - Disable
  • 1 - Enable
• BIT[31] This bit is used to validate bt and BLE feature bitmap.
  • 0 – BT & BLE feature bitmap is invalid
  • 1 – BT & BLE feature bitmap valid

bt_feature_bit_map

• This bitmap is valid only if BIT[31] of extended custom feature bit map is set.
  • BIT[0:7] - reserved
  • BIT[8] - BT_EDR_3MBPS_DISABLE
    • 0 - Enable BT EDR 3Mbps Feature
    • 1 - Disable BT EDR 3Mbps Feature
  • BIT[9] - BT_EDR_2MBPS_DISABLE
    • 0 - Enable BT EDR 2Mbps Feature
    • 1 - Disable BT EDR 2Mbps Feature
  • BIT[10] - BT_5_SLOT_PACKETS_DISABLE
    • 0 - Enable BT 5 Slot Packet Feature
    • 1 - Disable BT 5 Slot Packet Feature
  • BIT[11] - BT_3_SLOT_PACKETS_DISABLE
    • 0- Enable BT 3 Slot Packet Feature
    • 1 - Disable BT 3 Slot Packet Feature
  • BIT[12] - Noise Figure Feature
    • 0 - Disable Noise Figure
    • 1 - Enable Noise Figure
  • BIT[13] - SNIFF Feature Disable
    • 0- Enable SNIFF Feature
    • 1- Disable SNIFF Feature
  • BIT[14] - reserved
  • BIT[15] - HFP profile bit enable
    • 0 - disable the HFP profile
    • 1 - enable the HFP profile
  • BIT[16:19] - reserved for future use
  • BIT[20:22] - number of slaves supported by BT. Maximum number of BT slaves: 2
  • BIT[23] - A2DP profile bit enable
    • 0 - disable the A2DP profile
    • 1 - enable the A2DP profile
  • BIT[24] - A2DP profile role selection
    • 0 - A2DP sink
    • 1 - A2DP source
  • BIT[25] - A2DP accelerated mode selection
    • 0 - disable accelerated mode
    • 1 - enable accelerated mode
  • BIT[26] - A2DP I2S mode selection
    • 0 - disable i2s mode
    • 1 - enable i2s mode
  • BIT[27:29] - reserved
  • BIT[30] - RF Type selection
    • 0 - External RF Type selection
    • 1 - Internal RF Type selection
  • BIT[31] - Validate BLE feature bit map. For classic opermode this can be ignored.
    • 0 - Ignore BLE feature bit map
    • 1 - Valid BLE feature bit map
  • Note! A2DP, AVRCP and HFP Profiles are not supported currently.

config_feature_bit_map (4 bytes)

• This bitmap is valid only if BIT[31] of ext_tcp_ip_feature_bit_map is set.

Note!

• 32KHz external clock connection and power save pins
• As per Silicon Labs datasheet update in May 2019, the 32KHz external clock and the power save pins connections have changed. To keep SW compatibility between initial design (i.e. first EVKs developed by Silicon Labs) as well as new designs, there are currently 2 options for connecting the 32KHz external clock and the power save pins:
• Option 1
  • External 32KHz clock connection pins : XTAL_32KHZ_P & XTAL_32KHZ_N
  • Power Save connection pins : HOST_BYP_ULP_WAKEUP & UULP_VBAT_GPIO_3
• Option 2
  • External 32KHz clock connection pin : UULP_VBAT_GPIO_3
  • Power Save connection pins : HOST_BYP_ULP_WAKEUP & UULP_VBAT_GPIO_0
  • As per Silicon Labs datasheet updated in May'2019, Option 2 must be used for External 32KHz external clock and Power save connections in new designs

Response

Example

Command

at+rsi_opermode=327680,0,0,2147483648,2150629376,1073741824

Response

OK
bt_loaded

[ Go to top ]

rsibt_switch_proto :: Enable BT Protocol Switch proto

Description

This is used to enable BT protocol in case of coex opermodes (8/9 etc). By default, BT protocol is disabled only in "opermode 8" and "opermode 9", remaining opermodes not needed to enable it explicitly as it is enable by default.

Command Format

at+rsibt_switch_proto=<enable>

Parameters

enable

• 0 - disable
• 1 - enable

Example

Command

at+rsibt_switch_proto=1

Response

OK

[ Go to top ]

rsibt_setlocalname :: Set Local Name

DescriptionThis is used to set name to the local device.

Command Format

at+rsibt_setlocalname=<NameLength>,<Name>

Parameters

NameLength

• Length of the name of local device.

Name (16 bytes)

• Name of the local device. When the name of the local device is set to a value with length more than 16 bytes then error is returned with an error code 0x4E66 .

Example

Command

at+rsibt_setlocalname=6,silabs

Response

OK

[ Go to top ]

rsibt_getlocalname :: Query Local Name

Description

This is used to query the name of the local device.

Command Format

at+rsibt_getlocalname?

Response

where ...

name_length

• Length of the name

local_device_name (16 bytes)

• Name of the local device

Example

Command

at+rsibt_getlocalname?

Response

OK 8,silabs

[ Go to top ]

rsibt_setlocalcod :: Set Local COD

Description

This command indicates the capabilities of local device to other devices. It is a parameter received during the device discovery procedure on the BR/EDR physical transport, indicating the type of device. The Class of Device parameter is only used on BR/EDR and BR/EDR/LE devices using BR/EDR physical transport. It is defined in the following link Bluetooth Assigned Numbers .

Command Format

at+rsibt_setlocalcod=<local_device_class>

Parameters

local_device_class

• Class of the Device of local device

Example

Command

at+rsibt_setlocalcod=7A020C

Response

OK

[ Go to top ]

rsibt_getlocalcod :: Query Local COD

Description

This is used to query Class of Device of the local device.

Command Format

at+rsibt_getlocalcod?

Response

where ...

local_device_class - Class of the Device of the local device

Example

Command

at+rsibt_getlocalcod?

Response

OK 7A020C

[ Go to top ]

rsibt_getrssi :: Query RSSI

Description

This is used to query RSSI of the connected remote BT Device.

Command Format

at+rsibt_getrssi=<bd_addr>?

Parameters

bd_addr (6 bytes)

• BD Address of the connected remote device.

Response

where ...

rssi_value (1 byte)

• RSSI value of the connected remote device. The rssi is in the range -128 to +127 dBm.

Example

Command

at+rsibt_getrssi=AA-BB-CC-DD-EE-FF?

Response

OK -70

[ Go to top ]

rsibt_getlocalbdaddr :: Query Local BD Address

Description

This is used to query BD address of the local device.

Command Format

at+rsibt_getlocalbdaddr?

Response

where ...

bd_addr (6 bytes)

• BD Address of the local device

Example

Command

at+rsibt_getlocalbdaddr?

Response

OK AA-BB-CC-DD-EE-FF

[ Go to top ]

rsibt_getbtstackversion :: Query BT Stack Version

Description

This is used to query Current BT Stack Version.

Command Format

at+rsibt_getbtstackversion?

Response

where ...

*stack version (1 byte)

• Stack version

Example

Command

at+rsibt_getbtstackversion?

Response

OK 2.1.0

[ Go to top ]

rsibt_btinit :: Initialize BT Module

Description

This is used to initialize the BT module.

Command Format

at+rsibt_btinit

Example

Command

at+rsibt_btinit

Response

OK

[ Go to top ]

rsibt_btdeinit :: Deinitialize BT Module

Description

This is used to de-initialize the BT module. To again initialize the module Initialize BT module command can be used.

Command Format

at+rsibt_btdeinit

Example

Command

at+rsibt_btdeinit

Response

OK

[ Go to top ]

rsibt_btantennaselect :: BT Antenna Select

Description

This is used to select internal or external antenna of the BT module.

Command Format

at+rsibt_btantennaselect=<antenna_val>

Parameters

antenna_val (1 byte)

• Select the internal or external antenna
  • 0 - Internal Antenna
  • 1 - External Antenna

Example

Command

at+rsibt_btantennaselect=1

Response

OK

[ Go to top ]

rsibt_setfeaturebitmap :: Set Feature Bitmap

DescriptionSets the feature bitmap of module. But at present this command is used to enable/disable the BT Security.

If BT Security gets Enabled, then Stack sends IOCapablity Request positive Reply with the IOCapability data updated via Set SSP Mode command. Else, IOCapability Request Negative Reply will be called from stack.

Command Format

at+rsibt_setfeaturebitmap=<featurebitmap>

Parameters

featurebitmap (2 bytes)

• 0 - Disable BT security
• 1 - Enable BT security

Example

at+rsibt_setfeaturebitmap=1

Response

OK

[ Go to top ]

rsibt_setantennatxpowerlevel :: Set Antenna Tx Power Level

Description

This is used to set the Bluetooth antenna transmit power level.This command serves for selecting the maximum power to be used for the device.

Command Format

at+rsibt_setantennatxpowerlevel=<protocol_mode>,<power_level>

Parameters

protocol_mode (1 byte)

• 1 - BT Classic

power_level (1 byte)

• Power level used in the range 1-14 dBm

Example

at+rsibt_setantennatxpowerlevel=1,10

Response

OK

[ Go to top ]

rsibt_updategaintableoffsetMaxpower :: Update Gain Table Offset and MaxPower

Description

This command is used to configure region based gain table the module from user. This method is used for overwriting default region based gain tables that are present in firmware.

There are two types of gain tables for BT and BLE protocols

• Gain table holding Max Tx power values
• Gain table with Max power vs offset values Customer must configure both gain tables mentioned above in the same order to apply the changes in the firmware properly.

Note!

• This command must be used immediately after the opermode request.
• Internally, the firmware maintains two tables.
  • Gain table holding the Max Tx power values for all supported regions.
  • Gain table holding the Max power vs offset values for each channel for all supported regions
• There are 5 regions supported and they are FCC, ETSI, TELEC, KCC and WORLDWIDE. These FCC/ETSI/TELEC/KCC gain table max power level and offset values should be loaded in end-to-end mode via BT/BLE User Gain table. This has to be called upon on every boot-up since this information is not saved inside the flash. SoC uses these tables in FCC/ETSI/TELEC/KCC regions to limit power and not to violate the allowed limits.
• In worldwide regions, firmware uses worldwide TX power values. In other regions, firmware uses minimum of worldwide and region-based TX values. Keep in mind that these values vary with different parts. Also, the offsets are estimated during manufacturing, which are then applied as a correction factor during normal mode of operation.
• This frame has to be used by customers who have done FCC/ETSI/TELEC/KCC certification with their own antenna. All other customers should not use this. Any other use of this frame may result in violation of FCC/ETSI/TELEC/KCC or any other certifications and Silicon labs is not liable for it.
• In the max power per region configurations, update all regions.
• Update all the regions that are not certified with max power as ZERO.
• Update the world-wide region with proper max power provided in Gain Tables with the release. This represents values of the initial chip certifications.
• In max power vs offset configuration, only the region that is certified can be updated. Other regions can be ignored.

Command Format

at+rsibt_updategaintableoffsetMaxpower=<node_id>,<update_gain_table_type>,<payloadlength>,<payload>

Parameters

node_id

• 0 - BLE
• 1 - BT

update_gain_table_type

• Request type to select appropriate gain table
  • 0 - Update gain table with max power values
  • 1 - Update gain table with offset values

payloadlength

• Gain table payload length; must be equal to the size of payload

payload

• Gain table payload data consist of channel power values for different regions in the below mentioned format.
• Gain table holding Max Tx power values : (Each entry of the table is 1 byte)

  <TABLE NAME>[] = {
                <REGION NAME 1>, <MAX POWER>,
                <REGION NAME 1>, <MAX POWER>,
                .
                .
                <REGION NAME N>, <MAX POWER>
                };

• Gain table with Max power vs offset values : (Each entry of the table is 1 byte)

  <TABLE NAME>[] = {
                <Number Of Regions - 'r'>,
                  <REGION NAME 1>, <#Channels - 'm'>,
                    <CHANNEL NUMBER 1>, <OFFSET>,
                    <CHANNEL NUMBER 2>, <OFFSET>,
                    .
                    .
                    <CHANNEL NUMBER m>, <OFFSET>,
                  <REGION NAME 2>, <#Channels - 'n'>,
                    <CHANNEL NUMBER 1>, <OFFSET>,
                    <CHANNEL NUMBER 2>, <OFFSET>,
                    .
                    .
                    <CHANNEL NUMBER n>, <OFFSET>,
                   .
                   .
                   <REGION NAME r>, <#Channels - 'n'>,
                     <CHANNEL NUMBER 1>, <OFFSET>,
                     <CHANNEL NUMBER 2>, <OFFSET>,
                     .
                     .
                     <CHANNEL NUMBER n>, <OFFSET>,
                 };

• Supported Region names

  • The following are the regions and there values to be passed instead of macros in the example.
    • 0 - FCC
    • 1 - ETSI
    • 2 - TELEC
    • 3 - WORLDWIDE
    • 4 - KCC

• If Tx powers of all the channels are same, then channel number as 255. If Tx power is not same for all channels, then indicate no-of channels and specify tx power values for all the channels indicated

Response

where ...

error_code

• 4F01 - Invalid gain table payload length
• 4F02 - Invalid region
• 4F03 - Invalid gain table offset request type
• 4F04 - Invalid node id request

Example 1 - Update BT Maxpower

Command

at+rsibt_updategaintableoffsetMaxpower= 1,0,10,0,17,1,10,2,14,3,20,4,12

Example 2 - Update BT Offset

Command

at+rsibt_updategaintableoffsetMaxpower= 1,1,55,5,0,4,255,0,0,0,39,0,78,2,1,4,255,0,0,0,39,0,78,0,2,4,255,3,12,0,15,5,26,1,3,6,255,0,0,0,3,0,39,1,75,2,78,0,4,4,255,3,2,2,5,5,7,1\r\n

Note! Here...

• 255 represents all channels except explicitly mentioned -> zero offset.
• 0th channel-> zero offset.
• 39th channel-> zero offset.
• 78th channel-> 2 offset

Response

OK

[ Go to top ]

rsibt_bredrtransmit :: BR-EDR PER Transmit

Description

This command can be given to start br -edr transmission.

Command Format

at+rsibt_bredrtransmit=<enable>,<device_address>,<pkt_len>,<pkt_type>,<BR/EDR_mode>,<rx_channel_num>,<tx_channel_num>,<link_type>,<scrambler_seed>,<hopping_type>,<antenna_sel>,<pll_mode>,<rf_type>,<rf_chain>,<payload_type>,<tx_power_index>,<tx_mode>,<inter_packet_gap>,<num_of_packets>

Parameters

enable

• This parameter enables/disables the bt per transmit mode
  • 0 - PER Transmit Disable
  • 1 - PER Transmit Enable

device_address

• A 48-bit address in hexadecimal format e.g. 0023A7010203 .
• Does not need to be the modules BD address, it can be any 48bit BD address however the same address should be used for the transmit and receive command.

pkt_len

• Length of the packet in bytes to be transmitted

pkt_type

• Type of the packet to be transmitted as per the Bluetooth standard.

BR/EDR_mode

• BT Classic mode
  • 1 - basic rate
  • 2,3 - enhanced_rate

rx_channel_num

• Receive channel index as per the Bluetooth standard. i.e, 0 to 78

tx_channel_num

• Transmit channel index as per the Bluetooth standard. i.e, 0 to 78

link_type

• The type of the channel is used
  • 0 - sco
  • 1 - acl
  • 2 - esco

scrambler_seed

• Initial seed to be used for whitening. It should be set to ‘0’ in order todisable whitening.In order to enable, one should give the scrambler seed value which is used on the receive side

hopping_type

• This field defines the frequency hopping type to be used
  • 0 - No Hopping
  • 1 - Fixed Hopping
  • 2 - Random Hopping (rx_chnl_num, tx_chnl_num parameters areunused in this mode)

antenna_sel

• This field defines the antenna selection (onboard/external) to be used for reception
  • 2 - ONBOARD_ANT_SEL
  • 3 - EXT_ANT_SEL

pll_mode

• This field define the pll_mode type to be used
  • 0 - PLL_MODE0 (default)
  • 1 - PLL_MODE1

rf_type

• This field defines the selection of RF type (internal/external)
  • 0 - External RF
  • 1 - Internal RF

rf_chain

• This field corresponds to the selection of RF chain (HP/LP) to be used
  • 2 - BT_HP_CHAIN
  • 3 - BT_LP_CHAIN

payload_type

• Type of payload data sequence
  • 0x00 - PRBS9 sequence 11111111100000111101...
  • 0x01 - Repeated 11110000
  • 0x02 - Repeated 10101010
  • 0x03 - PRBS15
  • 0x04 - Repeated 11111111
  • 0x05 - Repeated 00000000
  • 0x06 - Repeated 00001111
  • 0x07 - Repeated 01010101

tx_power_index

• Transmit power value should be between 0 and 10

tx_mode

• This field corresponds to the transmit mode to be used either Burst/Continuous
  • 0 - BURST_MODE
  • 1 - CONTINUOUS_MODE
  • 2 - CONTINUOUS_WAVE_MODE (CW_MODE)

inter_pkt_gap

• This field takes the value of interpacket gap. Number of slots to be skipped between two packets. Each slot will be 1250usec

num_of_packets

• This field defines the number of packets to be transmitted, default to zero for continuous transmission. It is valid only when the <tx_mode> is set to Burst mode.

Example

Command

at+rsibt_bredrtransmit= 1,11-11-11-11-11-11,339,15,1,10,10,1,0,0,2,0,1,2,0,10,0,0,0

Response

OK

[ Go to top ]

rsibt_bredrreceive :: BR-EDR PER Receive

Description

This command can be given to start the br -edr reception.

Command Format

at+rsibt_bredrreceive=<enable>,<device_address>,<pkt_len>,<pkt_type>,<BR/EDR_mode>,<rx_channel_num>,<tx_channel_num>,<link_type>,<scrambler_seed>,<hopping_type>,<antenna_sel>,<pll_mode>,<rf_type>,<rf_chain>,<loop_back_mode>

Parameters

enable/disable (1 byte)

• This parameter enables/disables the bt per Receive mode
  • 0 - PER Receive Disable
  • 1 - PER Receive Enable

device_address (6 bytes)

• 48-bit address in hexadecimal format, e.g, 000012345678

pkt_len (1 byte)

• Length of the packet in bytes is received.

pkt_type (1 byte)

• Type of the packet is received, as per the Bluetooth standard.

BR/EDR_mode (1 byte)

• BT Classic Mode
  • 1- basic rate
  • 2 - enhanced_rate

rx_channel_num (1 byte)

• Receive channel index as per the Bluetooth standard. i.e, 0 to 78

tx_channel_num (1 byte)

• Transmit channel index as per the Bluetooth standard. i.e, 0 to 78

link_type (1 byte)

• The type of the channel is used
  • 0 - sco
  • 1 - acl
  • 2 - esco

scrambler_seed (1 byte)

• Initial seed to be used for whitening. It should be set to ‘0’ inorder to disable whitening.

hopping_type (1 byte)

• This field defines the frequency hopping type to be used 0 - No Hopping 1 - Fixed Hopping 2 - Random Hopping (rx_chnl_num, tx_chnl_num parametersare unused in this mode)

antenna_sel (1 byte)

• This field defines the antenna selection (onboard/external) to be used for reception
  • 2 - ONBOARD_ANT_SEL
  • 3 - EXT_ANT_SEL

pll_mode (1 byte)

• This field define the pll_mode type to be used
  • 0 - PLL_MODE0 (to be used by Default)
  • 1 - PLL_MODE1
  • 2 - PLL_MODE2

rf_type (1 byte)

• This field defines the selection of RF type (internal/external)
  • 0 - External RF
  • 1 - Internal RF

rf_chain (1 byte)

• This field corresponds to the selection of RF chain (HP/LP) to be used
  • 2 -BT_HP_CHAIN
  • 3 - BT_LP_CHAIN

loop_back_mode (1 byte)

• 0 - Disable
• 1 - Enable

Example

Command

at+rsibt_bredrreceive= 1,11-11-11-11-11-11,339,15,1,10,10,1,0,0,2,0,1,2,0

Response

OK

[ Go to top ]

rsibt_perstats :: PER Stats

Description

The following PER statistics are returned. This command may be used for BTC and BLE.

Command Format

at+rsibt_perstats

Response

OK <crc_fail_count>,<crc_pass_count>,<tx_abort_count>,<rx_drop_count>,<rx_cca_idle_count>,<rx_start_idle_count>,<rx_abrt_count>,<tx_dones>,<rssi>,<id_pkts_rcvd>,<dummy> 

where ...

crc_fail_count (2 bytes)

• The number of packets received which are passed CRC check

crc_pass_count (2 bytes)

• The number of packets received which failed CRC check

tx_abort_count (2 bytes)

• The number of aborted TX packets

rx_drop_count (2 bytes)

• The number of dropped RX packets

rx_cca_idle_count (2 bytes)

• The number of CCA(Clear Channel Assesment) Idle packets

rx_start_idle_count (2 bytes)

• The number of RX start packets

rx_abrt_count (2 bytes)

• The number of aborted RX packets

tx_dones (2 bytes)

• The number of Successful Transmitted packets

rssi (1 byte integer)

• The RSSI value of the last received packet

id_pkts_rcvd (2 bytes)

• The number of ID packets Received

dummy (2 bytes)

• Dummy array of length 5

Example

The following is an example response

OK 000a 00a0 000F 0000 0000 0000 0000 00b0 001f 0000 0000  

BT Channel Number Reference

The band and bandwidth for all BT channels is 2.4 GHz and 1 MHz respectively.

BT Packet Summary

Note! In eSCO (link type = 3), having capability of maximum 90 bytes (Packet Length) only.

[ Go to top ]

rsibt_setprofilemode :: Set Profile Mode

Description

This is used to initialize the particular profiles in Bluetooth embedded host stack. At present, only SPP and HID profiles are supported.

Command Format

at+rsibt_setprofilemode=<ProfileMode>

Parameters

ProfileMode (1 byte)

• Set specific bits to enable the profiles.

Example

Command

at+rsibt_setprofilemode=1

Response

OK

[ Go to top ]

rsibt_setdiscvmode :: Set Device Discovery Mode

Description

This is used to set the BT module in any of the three Discovery modes. Timeout can be used for only limited discovering.

Command Format

at+rsibt_setdiscvmode=<mode>,<timeout>

Parameters

Mode (1 byte)

• Enable/disable discovery
  • 0 - disable discovery
  • 1 - enable discovery
  • 2 - limited discovery

TimeOut (4 bytes)

• Timeout value in milliseconds, it is recommende to keep the timeout below 1 hour (3600000 ms)

Example

Command

at+rsibt_setdiscvmode=2,10000

Response

OK

[ Go to top ]

rsibt_getdiscvmode :: Get Device Discovery Mode

Description

This is used to get the discovery mode of the BT module, currently the BT module was set.

Command Format

at+rsibt_getdiscvmode?

Response

where ...

mode (1 byte)

• 0 - discovery mode disabled
• 1 - discovery mode enabled

Example

Command

at+rsibt_getdiscvmode?

Response

OK 1

[ Go to top ]

rsibt_setconnmode :: Set Connectability Mode

Description

This is used to set the BT module in one of the two Connectability modes.

Command Format

at+rsibt_setconnmode=<ConnMode>

Parameters

ConnMode (1 byte)

• Enable/disable connectability
  • 0 - disable connection mode
  • 1 - enable connection mode

Example

Command

at+rsibt_setconnmode=1

Response

OK

[ Go to top ]

rsibt_getconnmode :: Get Connectablility Mode

Description

This is used to get the connectable mode, currently the BT module was set.

Command Format

at+rsibt_getconnmode? 

Response

where ...

ConnMode (1 byte)

• enabled/disabled connection mode
  • 0 - Disabled connection mode
  • 1 - Enabled connection mode

Example

Command

at+rsibt_getconnmode?

Response

OK 1

[ Go to top ]

rsibt_rmtnamereq :: Remote Name Request

Description

This is used to know the name of the remote BT device, using its BD address. The response to this command containing the remote BT device name will be sent to the host through "RMTDEVNAME" event.

Command Format

at+rsibt_rmtnamereq=<bd_addr>

Parameters

bd_addr (6 bytes)

• remote device BD Address

Example

Command

at+rsibt_rmtnamereqcancel=AA-BB-CC-DD-EE-FF

Response

OK

[ Go to top ]

rsibt_rmtnamereqcancel :: Remote Name Request Cancel

Description

This will cancel the request served by "Remote Name Request" command. The cancellation is confirmed through "Remote Name Request Cancelled" event.

Command Format

at+rsibt_rmtnamereqcancel=<bd_addr>

Parameters

bd_addr (6 bytes)

• remote device BD Address

Example

Command

at+rsibt_rmtnamereqcancel=AA-BB-CC-DD-EE-FF

Response

OK

[ Go to top ]

Inquiry

Description

This performs an inquiry to find any BT devices in the vicinity. The response is sent using "INQRESP" event.

Command Format

at+rsibt_inquiry=<InquiryType>,<Duration>,<MaxNbrdev>

Parameters

inquiryType (1 byte)

• 0 - Standard inquiry
• 1 - Inquiry with RSSI
• 2 - Extended Inquiry
• 3 - Inquiry followed by Remote name request

Duration (4 bytes)

• Extended Time in milliseconds (up to 10000ms)

MaxNbrdev (1 byte)

• Maximum number of devices to scan (from 1 to 10)

Example

Command

at+rsibt_inquiry=1,10000,10

Response

OK

[ Go to top ]

rsibt_inquirycancel :: Inquiry Cancel

Description

This will cancel the inquiry scan which was already in the process, served by "Inquiry" command.

Command Format

at+rsibt_inquirycancel

Example

Command

at+rsibt_inquirycancel

Response

OK

[ Go to top ]

rsibt_seteir :: Extended Inquiry Response Data

Description

This command is used to set the Extended Inquiry Response data.

Command Format

at+rsibt_seteir=<DataLen>,<Data>

Parameters

Length (1 byte)

• data length. Max EIR data length is 200 Bytes.

Data (200 bytes)

• Actual data in hex format

Example

Command

at+rsibt_seteir=8,2,1,0,4,9,72,72,72

Response

OK

Extended Inquiry Response

[ Go to top ]

rsibt_bond :: Bond or Create Connection

Description

This will create bonding (connection) between the BT module and the remote BT device based on BD address along with security.

Command Format

at+rsibt_bond=<bd_addr>

Parameters

bd_addr (6 bytes)

• remote device BD Address.

Example

Command

at+rsibt_bond=AA-BB-CC-DD-EE-FF

Response

OK

[ Go to top ]

rsibt_bondcancel :: Bond Cancel Or Create Connection Cancel

Description

This will disconnect the connection between the BT module and the remote BT device only while the bonding is in progress.

Command Format

at+rsibt_bondcancel=<bd_addr>

Parameters

bd_addr (6 bytes)

• Remote device BD Address

Example

Command

at+rsibt_bondcancel=AA-BB-CC-DD-EE-FF

Response

OK

[ Go to top ]

rsibt_unbond :: UnBond Or Disconnect

Description

This un-bonds the device which was already bonded based on BD address of the remote BT device.

Command Format

at+rsibt_unbond=<bd_addr>

Parameters

bd_addr (6 bytes)

• Remote device BD Address

Example

at+rsibt_unbond=AA-BB-CC-DD-EE-FF

Response

OK

[ Go to top ]

rsibt_usrconfirmation :: User Confirmation

Description

This gives the confirmation for the values sent by remote BT devices at the time of bonding.

Command Format

at+rsibt_usrconfirmation=<bd_addr>,<Confirmation>

Parameters

bd_addr (6 bytes)

• BD address of the remote BT device which sends connection request.

confirmation (1 byte)

• 0 - NO. If both remote and local values are not same.
• 1 - YES. If both remote and local values are same.

Example

Command

at+rsibt_usrconfirmation=AA-BB-CC-DD-EE-FF,1

Response

OK

[ Go to top ]

rsibt_usrpasskey :: Pass Key Request Reply

Description

The user passkey entry is used to respond on a User Passkey Entry Request (UPER).

Command Format

at+rsibt_usrpasskey=<bd_addr>,<ReplyType>,<Passkey>

Parameters

bd_addr (6 bytes)

• Remote BD Address.

ReplyType (1 byte)

• 0 - negative reply
• 1 - positive reply

Passkey (4 bytes)

• Entered Passkey number in decimal (range from 0 to 999999).

Example

Command

at+rsibt_usrpasskey=AA-BB-CC-DD-EE-FF,1,123456

Response

OK

[ Go to top ]

rsibt_usrpincode :: Pincode Request Reply

Description

The user pincode entry is used to respond on a user pin code entry request (UPER). To make connection with remote device then need to respond with positive reply, otherwise send a negative reply.

Command Format

at+rsibt_usrpincode=<bd_addr>,<ReplyType>,<Pincode>

Parameters

bd_addr (6 bytes)

• Remote BD Address.

ReplyType (1 byte)

• 0 - negative reply
• 1 - positive reply

Reserved

• Padding

Pincode (16 bytes)

• Entered Pincode number (must be in string format max string length is 16 bytes).

Response

Example

Command

at+rsibt_usrpincode=AA-BB-CC-DD-EE-FF,1,1234

Response

OK

[ Go to top ]

rsibt_getmasterslaverole :: Get Local Device Role

Description

This gets the role of the local BT module when connected with a particular remote BT device, based on BD address of the remote BT device.

Command Format

at+rsibt_getmasterslaverole=<bd_addr>?

Parameters

bd_addr (6 bytes)

• Remote BD Address

Response

where ...

role (1 byte)

• 0 - Master role
• 1 - Slave role

Example

Command

at+rsibt_getmasterslaverole=AA-BB-CC-DD-EE-FF?

Response

OK 1

[ Go to top ]

rsibt_setmasterslaverole :: Set Local Device Role Or Switch The Role

Description

This is used to change the current role of the local BT module with respect to the remote BT device.

Command Format

at+rsibt_setmasterslaverole=<bd_addr>,<Role>

Parameters

bd_addr (6 bytes)

• Remote BD Address

Role (1 byte)

• 0 - Master role
• 1 - Slave role

Example

Command

at+rsibt_setmasterslaverole=AA-BB-CC-DD-EE-FF,1

Response

OK

[ Go to top ]

rsibt_getsrvs :: Get Service List

Description

This is used to search for the services supported by the remote BT device.

Command Format

at+rsibt_getsrvs=<bd_addr>

Parameters

bd_addr (1 byte)

• Remote BD Address

Response

where ...

nbr_srvs_found (1 byte)

• Number of services in the list

ServiceUUIDs (4 bytes)

• List of service UUIDs, displayed as 32 bit UUIDs

Example

Command

at+rsibt_getsrvs=AA-BB-CC-DD-EE-FF

Response

OK <1800>,<1801>....

[ Go to top ]

rsibt_searchsrv :: Search Service

Description

This is used to find whether a particular service is supported by the remote BT device.

Command Format

at+rsibt_searchsrv=<bd_addr>,<ServiceUUID> 

Parameters

bd_addr (6 bytes)

• Remote BD Address ServiceUUID - 16 bit or 32 bit UUID.

Response

where ...

search_result (1 byte)

• 0 - No
• 1 - Yes

Example

Command

at+rsibt_searchsrv=AA-BB-CC-DD-EE-FF,1105

Response

OK 1

[ Go to top ]

rsibt_usrlinkkey :: Linkkey Reply

Description

The link key reply is used to respond on a link key request event. If previous link key of connecting device available then need to respond with positive reply,else send negative reply.

Command Format

at+rsibt_usrlinkkey=<bd_addr>,<ReplyType>,<LinkKey>

Parameters

bd_addr (6 bytes)

• Remote BD Address.

ReplyType (1 byte)

• 0 - negitive reply
• 1 - positive reply

LinkKey (16 bytes)

• Link key saved for the remote BD address in host.

Example 1 - Positive reply with linkkey

Command

at+rsibt_usrlinkkey=AA-BB-CC-DD-EE-FF,1,3C,A5,50,25,DC,D0,B0,AB,B7,C3,4F,4D,9,79,2C,5C

Example 2 - Negative reply without linkkey

Command

at+rsibt_usrlinkkey=AA-BB-CC-DD-EE-FF,0

Response

OK

Note! When a negative reply is given, the remote device may either initiate a re-pairing process or disconnect. In disconnection case, remove the pair info on the remote device side and initate a new connection process.

[ Go to top ]

rsibt_setsspmode :: Set SSP Mode

Description

Set SSP mode is used to enable Simple Secure Pair mode and also used to select the IO Capability for SSP mode.

Command Format

at+rsibt_setsspmode=<PairMode>,<IOCapability>

Parameters

PairMode (1 byte)

• 0 - Disable
• 1 - Enable

IOCapability (1 byte)

• 0x00 - DisplayOnly
• 0x01 - DisplayYesNo
• 0x02 - KeyboardOnly
• 0x03 - NoInputNoOutput

Example

at+rsibt_setsspmode=1,1

Response

OK

[ Go to top ]

rsibt_sniffmode :: Sniff Mode

Description

Enables the Host to support a low-power policy and allows the devices to enter Inquiry Scan, Page Scan, and a number of other possible actions.

The local device will return the actual sniff interval in the Interval parameter of the Mode Change event, if the command is successful.

Command Format

at+rsibt_sniffmode=<bd_addr>,<SniffMaxIntr>,<SniffMinIntr>,<SniffAttempt>,<sniffTimeout>

Parameters

bd_addr(6 bytes)

• Remote BD Address.

SniffMaxIntr (2 bytes)

• Specifies the maximum Sniff Mode period.

SniffMinIntrv (2 bytes)

• Specifies the minimum Sniff Mode period.

SniffAttempt (2 bytes)

• Master shall poll the slave at least once in the sniff attempt transmit slots starting at each sniff anchor point.

SniffTimeout (2 bytes)

• Timeout after which device enter sniff subrating mode.

Example

at+rsibt_sniffmode=AA-BB-CC-DD-EE-FF,192,160,4,2

Response

OK

[ Go to top ]

rsibt_sniffexit :: Sniff Exit

Description

To end the Sniff mode.

Command Format

at+rsibt_sniffexit=<bd_addr>

Parameters

bd_addr (6 bytes)

• Remote BD Address.

Example

at+rsibt_sniffexit=AA-BB-CC-DD-EE-FF

Response

OK

[ Go to top ]

rsibt_adddeviceid :: Add Device ID

Description

Add device Identification in SDP protocol.

Command Format

at+rsibt_adddeviceid=<SpecificationID>,<VendorID>,<ProductID>,<Version>,<PrimaryRecord>,<VendorIDSource>

Parameters

SpecificationID (2 bytes)

• The version number of the Bluetooth Device ID Profile specification supported by the device.

VendorID (2 bytes)

• Uniquely identify vendor of the device, see Vendor IDs

ProductID (2 bytes)

• Distinguish between different products made by the vendor

Version (2 bytes)

• A numeric expression identifying the device release number in Binary-Coded Decimal

PrimaryRecord

• Set to 1 in the case single Device ID Service Record exists in the device.
• Set to 0 if multiple Device ID Service Records exist, and no primary record has been defined.

VendorIDSource (2 bytes)

• This attribute designates which organization assigned the VendorID attribute, 0x201 .

Example

at+rsibt_adddeviceid=512,513,514,515,1,2

Response

OK

[ Go to top ]

rsibt_sppconn :: SPP Connect

Description

This is used to establish SPP connection with the remote BT device specified by the BD address. Note that the SPP profile will not connect without completing the pair process or authentication.

Command Format

at+rsibt_sppconn=<bd_addr>

Parameters

bd_addr (6 bytes)

• Remote BD Address.

Example

Command

at+rsibt_sppconn=AA-BB-CC-DD-EE-FF

Response

OK

[ Go to top ]

rsibt_sppdisconn :: SPP Disconnect

Description

This is used to disconnect the SPP connection with the remote BT device.

Command Format

at+rsibt_sppdisconn=<bd_addr>

Parameters

bd_addr (6 bytes)

• Remote BD address

Example

Command

at+rsibt_sppdisconn=AA-BB-CC-DD-EE-FF

Response

OK

[ Go to top ]

rsibt_spptx :: SPP Transfer

Description

This is used to send data to the remote BT device using SPP profile. This command contains a data length field which tells the BT module about the length of data in bytes user wants to send from the application.

Command Format

at+rsibt_spptx=<DataLength>,<Data>

Parameters

DataLength (1 byte)

• SPP data length (range of Data length is 1 to 200 bytes).

Data (200 bytes)

• SPP data.

Example

at+rsibt_spptx=5,iiiii

Response

OK

[ Go to top ]

rsibt_afhmap :: AFH_MAP

Description

This command mode is used to configure the following parameters..

Command

at+rsibt_afhmap=<startingchannel>,<endingchannel>

Parameters

startchannel

• This parameter indicates the starting channel index, as per the Bluetooth standard. The range is from 0 to 78.

endchannel

• This parameter indicates the ending channel index, as per the Bluetooth standard. The range is from 0 to 78.

Example

Command

at+rsibt_afhmap=12,30

Response

OK

[ Go to top ]

RSIBT_ROLECHANGED : Role Change Status Event

Description

This event describes the status of the command "Change Master Slave Role".

Event Format

AT+RSIBT_ROLECHANGED <bd_addr>,<Changed_Role>,<RoleChangeStatus>

where ...

bd_addr

• Remote BD Address

Changed_Role

• 0 - Master role
• 1 - Slave role

RoleChangeStatus

• 0 - Success
• 1 - Failure

Example

AT+RSIBT_ ROLECHANGED AA-BB-CC-DD-EE-FF,1,0

[ Go to top ]

RSIBT_UNBONDRESP :: Unbond Or Disconnect Status Event

Description

This event describes the status of unbonding between the BT module and remote BT device.

Event Format

AT+RSIBT_UNBONDRESP <bd_addr>,<unbond_status>

where ...

bd_addr

• BD address of the remote BT device in the vicinity of the BT module.

bond_status

• 0 - Success
• 1 - Failure

Example

AT+RSIBT_UNBONDRESP AA-BB-CC-DD-EE-FF,1

[ Go to top ]

RSIBT_BONDRESP :: Bond Response Event

Description

This event will be sent to the host, containing the status for "Bond" command.

Event Format

AT+RSIBT_BONDRESP <bd_addr>,<bond_status>

where ...

bd_addr

• BD address of the remote BT device in the vicinity of the BT module.

bond_status

• 0 - Success
• 1 - Failure

Example

AT+RSIBT_BONDRESP AA-BB-CC-DD-EE-FF,0

[ Go to top ]

RSIBT_INQRESP :: Inquiry Response Event

Description

This event will be sent in response to the "Inquiry" command. This event contains the details of BT device (like device name, BD address, COD, RSSI value) in the vicinity of the BT module.

Event Format

Standard Inquiry

AT+RSIBT_INQRESP <InquiryType>,<bd_addr>,<NameLength>,<RemoteDeviceName>.

Inquiry with RSSI

AT+RSIBT_INQRESP<InquiryType>,<bd_addr>,<NameLength>,<RemoteDeviceName>,<Rssi>,<cod>

where ...

InquiryType

• 0 - Standard Inquiry
• 1 - Inquiry with RSSI.
• 2 - Extended inquiry with RSSI.
• 3 - Inquiry with Remote Name request

bd_addr

• BD address of remote BT device in the vicinity of the BT module. This parameter will be sent by host for all inquiry types.

NameLength

• Length of the remote device name.

RemoteDeviceName

• Name of the remote BT device, with corresponding BD address. This parameter will be sent by host for all inquiry types. This parameter is present only if the "rmt_name_len" value is non- zero.

cod

• Class of the remote BT device. This parameter is sent by host for all inquiry types.

rssi

• RSSI value between BT module and the remote BT device. This parameter will be sent only for inquiry types 1, 2 and 3.

Example

Standard Inquiry

AT+RSIBT_INQRESP 0,AA-BB-CC-DD-EE-FF,7,silabs

Inquiry with RSSI

AT+RSIBT_INQRESP 1,AA-BB-CC-DD-EE-FF,7,silabs,-59,7a020c

[ Go to top ]

RSIBT_RMTDEVNAME :: Remote Device Name Event

Description

This event will be sent to the host in response to the "Remote Name Request" command. This event contains the name of the remote BT device, which was requested by the host.

Event Format

AT+RSIBT_RMTDEVNAME <bd_addr>,<NameLength>,<RemoteDeviceName>

where ...

bd_addr

• BD address of remote BT device in the vicinity of the BT module.

NameLength

• Length of the remote device name. If remote device name is not found this parameter will be zero and the "rmt_dev_name" contains the error code.

RemoteDeviceName

• Name of the remote BT device, with corresponding BD address. If the remote device name is not available or remote device is not connected, this parameter contains the corresponding error code.

Example

AT+RSIBT_RMTDEVNAME AA-BB-CC-DD-EE-FF,7,silabs

[ Go to top ]

RSIBT_USRCONFIRMREQ :: User Confirmation Request Event

Description

This event is raised when User Confirmation Request comes from the remote BT Device.

Event Format

AT+RSIBT_USRCONFIRMREQ <bd_addr>,<confirmation_value>

where ...

bd_addr

• The remote BT device BD address.

confirmation_value

• Range from 0 to 999999 in decimal.

Example

AT+RSIBT_USRCONFIRMREQ AA-BB-CC-DD-EE-FF,1234

[ Go to top ]

RSIBT_USRPASSKEYDISP :: User Passkey Display Event

Description

This event is raised when User Passkey comes from the module.

Event Format

AT+RSIBT_USRPASSKEYDISP <bd_addr>,<Passkey>

where ...

bd_addr

• The remote BT device BD address.

passkey

• Range from 0 to 999999 in decimal.

Example

AT+RSIBT_USRPASSKEYDISP AA-BB-CC-DD-EE-FF,12345

[ Go to top ]

RSIBT_USRPINCODEREQ :: User Pincode Request Event

Description

This event is raised when User Pincode is invoked by the remote BT Device. In such a case, user shall respond with Pincode Reply Command.

Event Format

AT+RSIBT_USRPINCODEREQ <bd_addr>

where ...

bd_addr

• BD Address of the remote BT device.

Example

AT+RSIBT_USRPINCODEREQ AA-BB-CC-DD-EE-FF

[ Go to top ]

RSIBT_USRPASSKEYREQ :: User Passkey Request Event

Description

This event is raised when User passkey request comes from the remote BT Device.

Event Format

AT+RSIBT_USRPASSKEYREQ <bd_addr>

where ...

bd_addr

• BD Address of the remote BT device.

[ Go to top ]

RSIBT_INQCOMPLETE :: Inquiry Complete Event

Description

This event is raised after the Inquiry is completed.

Event Format

AT+RSIBT_INQCOMPLETE

[ Go to top ]

RSIBT_USRLNKKEYREQ :: User Linkkey Request

Description

This event is raised when user linkkey request comes from the remote BT Device.

Event Format

AT+RSIBT_USRLNKKEYREQ <bd_addr>

where ...

bd_addr

• BD Address of the remote BT device.

Example

AT+RSIBT_USRLINKKEYREQ AA-BB-CC-DD-EE-FF

[ Go to top ]

RSIBT_SIMPLEPAIRINGCOMPLETED :: SSP Enable Event

Description

This event is raised when a device pairing mode set to Simple Secure pairing mechanism.

Event Format

AT+RSIBT_SIMPLEPAIRINGCOMPLETED <bd_addr>,<status>

where ...

bd_addr

• BD Address of the remote BT device.

Status

• 0 - Simple Pairing succeeded.
• 1 - Simple pairing failed.

Example

AT+RSIBT_SIMPLEPAIRINGCOMPLETED AA-BB-CC-DD-EE-FF,0

[ Go to top ]

RSIBT_USRLINKKEYSAVE :: User Linkkey Save Event

Description

This event is raised when a device is paired and linkkey for remote BT Device is given to host.

Event Format

AT+RSIBT_USRLINKKEYSAVE <bd_addr>,<LinkKey>

where ...

bd_addr

• BD Address of the remote BT device.

LinkKey

• Link key for the remote BT device.

Example

AT+RSIBT_USRLINKKEYSAVE AA-BB-CC-DD-EE-FF,3C,A5,50,25,DC,D0,B0,AB,B7,C3,4F,4D,9,79,2C,5C

[ Go to top ]

RSIBT_AUTHENTICATION_STATUS :: Auth Complete Event

Description

This event describes the status of authentication process.

Event Format

AT+RSIBT_AUTHENTICATION_STATUS <bd_addr>,<STATUS/ERROR>

where ...

bd_addr

• BD Address of the remote device.

[ Go to top ]

RSIBT_MODECHANGED :: Mode Change

Description

This event occurs when sniff mode is enabled by either remote device or local device and it is raised to indicate whenever the device changes between Active mode and Sniff mode.

Event Format

AT+RSIBT_MODECHANGED <bd_addr>,<current mode>,<ModeInterval>

where ...

bd_addr

• BD Address of the remote BT device.

current_mode

• State the connection is currently in.
  • 0 - Active mode
  • 1 - Hold mode (currently Not supported)
  • 2 - Sniff mode

Mode Interval

• Specify a time amount specific to each state. Time Range: 2-65534

Example

AT+RSIBT_MODECHANGED AA-BB-CC-DD-EE-FF,1,192

[ Go to top ]

Disconnected Event

RSIBT_DISCONNECTED :: Description

This event is raised when disconnection happens between the local BT device and the remote device.

Event Format

AT+RSIBT_DISCONNECTED <bd_addr>,<reason>

where ...

bd_addr

• BD address of the remote BT device.

Example

AT+RSIBT_CLASSIC_DISCONNECTED AA-BB-CC-DD-EE-FF,0

[ Go to top ]

RSIBT_SPPRX :: SPP Receive Event

Description

This event is sent to the host when data is received from remote BT device through SPP. This data_len field contains the length of data to be send to the host.

Event Format

AT+RSIBT_SPPRX <DataLength>,<Data>

where ...

Datalength

• length of the data (from 1 byte to 200 bytes)

Example

AT+RSIBT_SPPRX 4,rtrt

[ Go to top ]

RSIBT_SPPCONNECTED :: SPP Connected Event

Description

This event will be sent to the host, when the connection is established between BT Module and the remote BT device based on SPP profile.

Event Format

AT+RSIBT_SPPCONNECTED <bd_addr>

where ...

bd_addr

• BD Address of the remote BT device.

Example

AT+RSIBT_SPPCONNECTED AA-BB-CC-DD-EE-FF

[ Go to top ]

RSIBT_SPPDISCONNECTED :: SPP Disconnected Event

Description

This event will be sent to the host, when the existing SPP connection of the BT Module with the remote BT device is disconnected.

Event Format

AT+RSIBT_SPPDISCONNECTED <bd_addr>

where ...

bd_addr

• BD Address of the disconnected device

Example

AT+RSIBT_SPPDISCONNECTED AA-BB-CC-DD-EE-FF

[ Go to top ]

RSIBT_IAP_CONNECTED :: IAP Connected Event

Description

This event indicates that the connection was established between an Apple device and accessory.

Event Format

AT+RSIBT_IAP_CONNECTED <bd_addr>,<IAP_Protocol_Ver>

where ...

bd_addr

• BD address of the remote BT device.

IAP_Protocol_Version

• Version of the IAP supported by the Apple device which was connected.
  • 1 for IAP1
  • 2 for IAP2.

Example

AT+RSIBT_IAP_CONNECTED AA-BB-CC-DD-EE-FF,1

[ Go to top ]

RSIBT_IAP_DISCONNECTED :: IAP Disconnected Event

Description

This event will be sent to the host when the connection between accessory and an Apple device get disconnected.

Event Format

AT+RSIBT_IAP_DISCONNECTED <bd_addr>,<IAP_Protocol_Ver>

where ...

bd_addr

• BD address of the remote BT device.

IAP_Protocol_Version

• Version of the IAP supported by the Apple device, which was connected.
  • 1 for IAP1
  • 2 for IAP2

Example

AT+RSIBT_IAP_DISCONNECTED AA-BB-CC-DD-EE-FF,1

[ Go to top ]

RSIBT_IAP1_ACCESSORY_AUTH_STARTED :: IAP1 Accessory Authentication Started Event

Description

This indicates the start of the Accessory Authentication procedure by the Apple device.

Event Format

AT+RSIBT_IAP1_ACCESSORY_AUTH_STARTED

where ...

None

Example

AT+RSIBT_IAP1_ACCESSORY_AUTH_STARTED

[ Go to top ]

RSIBT_IAP1_ACCESSORY_AUTH_FAILED :: IAP1 Accessory Authentication Failed Event

Description

When the Accessory Authentication gets failed, it will be indicated by this event. The reason for failure is indicated by the error code.

Event Format

AT+RSIBT_IAP1_ACCESSORY_AUTH_FAILED <error_code>

where ...

error_code

• The reason for failure is indicated by this error code.

Example

AT+RSIBT_IAP1_ACCESSORY_AUTH_FAILED 0x8002

[ Go to top ]

RSIBT_IAP1_ACCESSORY_AUTH_COMPLETED :: IAP1 Accessory Authentication Completed Event

Description

This event indicates the completion of the Authentication procedure by the Apple device.

Event Format

AT+RSIBT_IAP1_ACCESSORY_AUTH_COMPLETED

where ...

None

Example

AT+RSIBT_IAP1_ACCESSORY_AUTH_COMPLETED

[ Go to top ]

RSIBT_IAP1_CURR_APP_BUNDLE_NAME :: IAP1 Now Playing App Bundle Name Event

Description

This event contains the current playing application bundle name. This event will be generated when the music player starts playing, or when voice memo starts recording etc.

Event Format

AT+RSIBT_IAP1_CURR_APP_BUNDLE_NAME <name>

where ...

name

• Name of the current playing application name.

Example

AT+RSIBT_IAP1_CURR_APP_BUNDLE_NAME com.apple.mobileipod

[ Go to top ]

RSIBT_IAP1_CURR_APP_DISPLAY_NAME :: IAP1 Now Playing Application Display Name Event

Description

This event contains the current playing application Display name. This event will be generated when the music player starts playing, when the voice memo starts recording etc.

Event Format

AT+RSIBT_IAP1_CURR_APP_DISPLAY_NAME <name>

where ...

name

• Name of the current playing application name.

Example

AT+RSIBT_IAP1_CURR_APP_DISPLAY_NAME Music

[ Go to top ]

RSIBT_IAP1_ASSISTIVE_TOUCH :: IAP1 Assistive Touch Status Event

Description

This event indicates a change in the status of the Assistive Touch. This event will be sent to the host, whenever there is a change (ON/OFF) in the status of Assistive Touch.

Event Format

AT+RSIBT_IAP1_ASSISTIVE_TOUCH <status>

where ...

status

• Status of Assistive touch.
  • 0 for OFF
  • 1 for ON

Example

AT+RSIBT_IAP1_ASSISTIVE_TOUCH 1

[ Go to top ]

RSIBT_IAP1_IPODOUT :: IAP1 iPod Out Status Event

Description

This event denotes the status of iPod out.

Event Format

AT+RSIBT_IAP1_IPODOUT <status>

where ...

status

• Status of iPod out.
  • 0 - for OFF
  • 1 - for ON

Example

AT+RSIBT_IAP1IPODOUT 0

[ Go to top ]

RSIBT_IAP1_FLOW_CONTROL :: IAP1 Flow Control Status Event

Description

This event will be sent to the host when the connection is established between BT Module and the remote BT device based on SPP profile.

Event Format

AT+RSIBT_IAP1_FLOW_CONTROL <IAP_Protocol_Ver>

where ...

IAP_Protocol_Version

• Version of the IAP supported by the Apple device, which was connected.
  • 1 for IAP1
  • 2 for IAP2

Example

AT+RSIBT_IAP1_FLOW_CONTROL

[ Go to top ]

RSIBT_IAP1_RADIO_TAGGING :: IAP1 Radio Tagging Status Event

Description

This event indicates the radio tagging status.

Event Format

AT+RSIBT_IAP1_RADIO_TAGGING <status>

where ...

Status

• 0 - Tagging operation successful
• 1 - Tagging operation failed
• 2 - Information available for tagging (all required RT)
• 3 - Information not available for tagging

Example

AT+RSIBT_IAP1_RADIO_TAGGING 0

[ Go to top ]

RSIBT_IAP1_CAMERA : IAP1 Camera Status Event

Description

This event indicates the camera status.

Event Format

AT+RSIBT_IAP1_CAMERA <status>

where ...

Status

• 0 - Camera App off
• 3 - Preview
• 4 - Recording

Example

AT+RSIBT_IAP1_CAMERA 3

[ Go to top ]

RSIBT_IAP1_DATABASE_CHANGED :: IAP1 Database Changed Status Event

Description

This event will be raised when there is a change in the Apple device database.

Event Format

AT+RSIBT_IAP1_DATABASE_CHANGED

Example

AT+RSIBT_IAP1_DATABASE_CHANGED

[ Go to top ]

RSIBT_IAP1_SESSION_SPACE_AVAILABLE :: IAP1 Session Space Available Event

Description

This event will be sent to the host, when the connection is established between BT Module and the remote BT device based on SPP profile.

Event Format

AT+RSIBT_IAP1_SESSION_SPACE_AVAILABLE

Example

AT+RSIBT_IAP1_SESSION_SPACE_AVAILABLE

[ Go to top ]

IAP1 Bluetooth Status

Description

This event will be sent to the host, when the connection is established between BT Module and the remote BT device based on SPP profile.

Event Format

AT+RSIBT_IAP1_BLUETOOTH_STATUS <IAP_Protocol_Ver>

where ...

IAP_Protocol_Version

• Version of the IAP supported by the Apple device, which was connected.
  • 1 for IAP1
  • 2 for IAP2

Example

AT+RSIBT_IAP1_BLUETOOTH_STATUS

[ Go to top ]

RSIBT_IAP1_VOICEOVER_PARAM_CHANGED :: IAP1 Voiceover Parameter Changed Event

Description

This event occurs whenever there is a change in any of the voiceover parameter like voiceover volume, speech rate.

Event Format

AT+RSIBT_IAP1_VOICEOVER_PARAM_CHANGED <param_type>,<changed_value>

where ...

param_type

• Type of the parameter changed.
  • 0 - Voiceover Volume.
  • 1 - Voiceover speech rate.

changed_value

• The changed value of the voiceover parameter.

Example

AT+RSIBT_IAP1_VOICEOVER_PARAM_CHANGED 0,150

[ Go to top ]

RSIBT_IAP1_OPEN_DATA_SESSION :: IAP1 Application Data Session Opened Event

Description

This event indicates that a session is opened by an Apple device. The details of the session are denoted by session id and protocol index which is assigned through the EAProtocolToken at the time of Identification Procedure. If the data session is accepted by the user, this must be acknowledgment by "" command.

Event Format

AT+RSIBT_IAP1_OPEN_DATA_SESSION? <session_id>,<protocol_index>

where ...

session_id

• ID of the session opened by the Apple device.

protocol index

• Protocol index assigned for an application at the time of Identification.

Example

AT+RSIBT_IAP1_OPEN_DATA_SESSION? 25,1

[ Go to top ]

RSIBT_IAP1_CLOSE_DATA_SESSION :: IAP1 Application Data Session Closed Event

Description

This event indicates the closure of the data session by the Apple device. This must be acknowledged by "" command.

Event Format

AT+RSIBT_IAP1_CLOSE_DATA_SESSION? <session_id>

where ...

session_id

• Session ID of the application to be closed.

Example

AT+RSIBT_IAP1_CLOSE_DATA_SESSION? 25

[ Go to top ]

RSIBT_IAP1_IPOD_DATA_RECEIVED :: IAP1 iPod Data Received Event

Description

This event indicates the data received from the Apple device. If the data is received correctly, an acknowledgment is sent to the Apple device.

Event Format

AT+RSIBT_IAP1_IPOD_DATA_RECEIVED <session_id>,<data_len>,<data>

where ...

session_id

• Session ID

data_len

• Length of the data received from the Apple device.

data

• Actual data received from the Apple device.

Example

AT+RSIBT_IAP1_IPOD_DATA_RECEIVED 25,7,welcome

[ Go to top ]

RSIBT_IAP1_IPOD_DATA_RECEIVED :: IAP1 Accessory HID Report

Description

This event indicates the accessory HID report sent by the Apple device. For example an LED report sent to the keyboard accessory.

Event Format

AT+RSIBT_IAP1_IPOD_DATA_RECEIVED <desc_index>,<report_type>,<len>,<report>

where ...

desc_index

• HID descriptor index, already registered with the Apple device.

report_type

• Input report.

len

• Length of the report in bytes.

report

• Device report. The report values are not the ASCII values, but the numerical values.

Example

AT+RSIBT_IAP1_ACCESSORY_HID_REPORT 0,1,3, 01 00 00

[ Go to top ]

rsibt_afhchannelclassification :: AFH Channel Classification

Description

This is used to read and write the channel assessment modes and to set the AFH channel classification.

Command Format

at+rsibt_afhchannelclassification=<ChannelAssessmentMode>,<enable>,<channel_map>

where ...

ChannelAssessmentMode (1 byte)

• Whether to read from, or write to, the controller.

Enable (1 byte)

• Channel assessment mode Enable or Disable.

channel_map (10 bytes)

- 0 - ChannelAssessmentMode is Disabled
- 1 - ChannelAssessmentMode is Enabled
- Other - Reserved for future use. 

Example

Command

at+rsibt_afhchannelclassification=1,1,ff,ff,ff,ff,0,0,0,0,0,7f

Response

OK

[ Go to top ]

RSIBT_HID_CONNECTED :: HID Connected Event

Description

This event will be sent to the host, when the HID profile level connection between the device and Host is successful.

Event Format

AT+RSIBT_HID_CONNECTED <bd_addr>,<MTU size>

where ...

bd_addr

• BD address of the remote BT device.

MTU Size

• Size of the L2CAP connection

Example

AT+RSIBT_HID_CONNECTED AA-BB-CC-DD-EE-FF,3EA

[ Go to top ]

RSIBT_HID_DISCONNECTED :: HID Disconnected Event

Description

This event will be sent to the host when the HID profile level connection between the device and Host is closed.

Event Format

AT+RSIBT_HID_DISCONNECTED <bd_addr>,<Reason Code>

where ...

bd_addr

• BD address of the remote BT device.

Reason Code

• Reason Code for disconnection

Example

AT+RSIBT_HID_DISCONNECTED AA-BB-CC-DD-EE-FF,13

[ Go to top ]

RSIBT_HID_HANDSHAKE_MSG_EVENT :: HID Handshake Message Event

Description

This event will be sent to the host when HID profile handshake message is received.

Event Format

AT+RSIBT_HID_HANDSHAKE_MSG_EVENT <bd_addr>,<result_code>

where ...

bd_addr

• BD address of the remote BT device.

result_code

• Result Code received in Handshake message for previous control message
  • 0 - SUCCESSFUL
  • 2 - ERR_INVALID_REPORT_ID
  • 3 - ERR_UNSUPPORTED_REQUEST
  • 4 - ERR_INVALID_PARAMETER
  • 14 - ERR_UNKNOWN
  • 15 - ERR_FATAL

Example

AT+RSIBT_HID_HANDSHAKE_MSG_EVENT AA-BB-CC-DD-EE-FF,0

[ Go to top ]

RSIBT_HID_CONTROL_MSG_EVENT :: HID Control Message Event

Description

This event will be sent to the host when HID profile control message is received.

Event Format

AT+RSIBT_HID_CONTROL_MSG_EVENT <bd_addr>,<Control Operation>

where ...

bd_addr

• BD address of the remote BT device.

Control Operation

• Control Operation received in Control message

Example

AT+RSIBT_HID_CONTROL_MSG_EVENT AA-BB-CC-DD-EE-FF,5

[ Go to top ]

HID Get Report Event

Description

This event will be sent to the host, when HID profile Get Report is received.

Event Format

AT+RSIBT_HID_GET_REPORT_EVENT <bd_addr>,<Report Type>,<Buffer Size Field status>,<Report ID>,<Buffer Size>

where ...

bd_addr

• BD address of the remote BT device. Report Type: Report Type of the data received

**Report Type

• 1 - Input
• 2 - Output
• 3 - Feature

Buffer Size Field Status

• Is buffer size field present

Report Id

• Report ID requested by the host

Buffer Size

• Buffer Size of the data accepted by the Host

Example

AT+RSIBT_HID_GET_REPORT_EVENT AA-BB-CC-DD-EE-FF,1,0,1

[ Go to top ]

RSIBT_HID_SET_REPORT_EVENT :: HID Set Report Event

Description

This event will be sent to the host when HID profile Set Report is received.

Event Format

AT+RSIBT_HID_SET_REPORT_EVENT <bd_addr>,<Report Type>,<Length of Data>,<data>

where ...

bd_addr

• BD address of the remote BT device.

Report Type

• Report Type of the data received
  • 1 - Input
  • 2 - Output
  • 3 - Feature

Length of Data

• Length of data from the host

data

• Data sent from the host; in hex format separated by commas

Example

AT+RSIBT_HID_SET_REPORT_EVENT AA-BB-CC-DD-EE-FF,1,5,1,2,3,4,5

[ Go to top ]

RSIBT_HID_GET_PROTOCOL_EVENT :: HID Get Protocol Event

Description

This event will be sent to the host when HID profile Get Protocol is received.

Event Format

AT+RSIBT_HID_GET_PROTOCOL_EVENT <bd_addr>

where ...

bd_addr

• BD address of the remote BT device.

Example

AT+RSIBT_HID_GET_PROTOCOL_EVENT AA-BB-CC-DD-EE-FF

[ Go to top ]

RSIBT_HID_SET_PROTOCOL_EVENT :: HID Set Protocol Event

Description

This event will be sent to the host when HID profile Set Protocol is received.

Event Format

AT+RSIBT_HID_SET_PROTOCOL_EVENT <bd_addr>,<Protocol Mode>

where ...

bd_addr

• BD address of the remote BT device.

Protocol Mode

• Protocol Mode the Device needs to set

Example

AT+RSIBT_HID_SET_PROTOCOL_EVENT AA-BB-CC-DD-EE-FF,1

[ Go to top ]

RSIBT_HID_RX_CONTROL_DATA :: HID Control Data Received Event

Description

This event will be sent to the host, when the HID profile receives data on control channel.

Event Format

AT+RSIBT_HID_RX_CONTROL_DATA <bd_addr >,<Report Type>,<Length of Data>,<data>

where ...

bd_addr

• BD address of the remote BT device.

Report Type

• Report Type of the data received
  • 1 - Input
  • 2 - Output
  • 3 - Feature

Length of Data

• Length of data from the host

data

• Data sent from the host; in hex format separated by commas

Example

AT+RSIBT_HID_RX_CONTROL_DATA AA-BB-CC-DD-EE-FF,2,2,1,1

[ Go to top ]

RSIBT_HID_RX_INTR_DATA :: HID Interrupt Data Received Event

Description

This event will be sent to the host, when HID profile receives data on interrupt channel.

Event Format

AT+RSIBT_HID_RX_INTR_DATA <bd_addr>,<Report Type>,<Length of Data>,<data>

where ...

bd_addr

• BD address of the remote BT device.

Report Type

• Report Type of the data received
  • 1 - Input
  • 2 - Output
  • 3 - Feature

Length of Data

• Length of data from the host

data

• Data sent from the host; in hex format separated by commas

Example

AT+RSIBT_HID_RX_INTR_DATA AA-BB-CC-DD-EE-FF,2,2,1,1

[ Go to top ]

rsibt_hidsendinterruptdata :: HID Send Interrupt Data

Description

The data is sent to the remote HID device using Interrupt channel.

Command Format

at+rsibt_hidsendinterruptdata=<bd_addr>,<Report Type>,<Length of Data>,<data>

Parameters

bd_addr

• BD address of the remote BT device.

Report Type

• Report Type of the data received
  • 1 - Input
  • 2 - Output
  • 3 - Feature

Length of Data

• Length of data from the host

data

• Data sent from the host; in hex format separated by commas

Example

Command

at+rsibt_hidsendinterruptdata=AA-BB-CC-DD-EE-FF,1,9,1,2,3,4,5,6,7,8,9

Response

OK

[ Go to top ]

HID Send Control Data

Description

The data is sent to the remote HID device using Control channel.

Command Format

at+rsibt_hidsendcontroldata=<bd_addr>,<Report Type>,<Length of Data>,<data>

Parameters

bd_addr

• BD address of the remote BT device.

Report Type

• Report Type of the data received
  • 1 - Input
  • 2 - Output
  • 3 - Feature

Length of Data

• Length of data from the host

data

• Data sent from the host; in hex format separated by commas

Example

Command

at+rsibt_hidsendcontroldata=AA-BB-CC-DD-EE-FF,1,9,1,2,3,4,5,6,7,8,9

Response

OK

[ Go to top ]

rsibt_hidsendhandshakemsg :: HID Send Handshake Message

Description

The result of a received control message is sent to the remote HID device using Control channel.

Command Format

at+rsibt_hidsendhandshakemsg=<bd_addr>,<result_code>

Parameters

bd_addr

• Remote BD Address.

result_code

• Result Code received in Handshake message for previous control message
  • 0 - SUCCESSFUL
  • 1 - NOT_READY
  • 2 - ERR_INVALID_REPORT_ID
  • 3 - ERR_UNSUPPORTED_REQUEST
  • 4 - ERR_INVALID_PARAMETER
  • 14 - ERR_UNKNOWN
  • 15 - ERR_FATAL

Example

at+rsibt_hidsendhandshakemsg=AA-BB-CC-DD-EE-FF,0

Response

OK

[ Go to top ]

rsibt_hidsendcontrolmsg :: HID Send Control Message

Description

The control operation is sent to the remote HID device using Control channel.

Command Format

at+rsibt_hidsendcontrolmsg=<bd_addr>,<Control Operation>

Parameters

bd_addr

• Remote BD Address.

Control Operation

• Control Operation received in Control message

Example

Command

at+rsibt_hidsendcontrolmsg=AA-BB-CC-DD-EE-FF,5

Response

OK

[ Go to top ]

rsibt_hidsendsdpconfig :: HID Send SDP Configuration Data

Description

Configures the SDP records attributes of the HID service with Service Name, Country Code, SDP Report Desc Data. This command must be executed after setting the profile mode to HID_PROFILE and is one time configurable.

Command Format

at+rsibt_hidsendsdpconfig=<Service Name>,<Country Code>,<Desc len>,<Desc Data>

Parameters

Service Name

• Service Name is written to SDP HID attribute record

Country Code

• Country Code configuration in SDP HID attribute record

Desc len

• SDP REPORT Desc len that is in data field

Desc Data

• SDP REPORT Desc Data in Hex format (Separated by commas)

Example

at+rsibt_hidsendsdpconfig=KeyboardService,33,160,35,9e,35,9c,08,22,25,98,05,01,09,06,a1,01,85,01,75,01,95,08,05,07,19,e0,29,e7,15,00,25,01,81,02,95,01,75,08,81,03,95,05,75,01,05,08,19,01,29,05,91,02,95,01,75,03,91,03,95,06,75,08,15,00,26,ff,00,05,07,19,00,29,ff,81,00,c0,05,0c,09,01,a1,01,85,03,15,00,25,01,75,01,95,0d,0a,23,02,0a,21,02,0a,83,01,09,b6,09,b5,09,e9,09,ea,09,cd,09,b7,09,e2,0a,8a,01,09,30,09,b8,81,02,95,01,75,0b,81,03,c0,05,01,09,80,a1,01,85,04,15,00,25,01,75,01,95,03,09,81,09,82,09,83,81,02,95,01,75,05,81,03,c0

Response

OK

[ Go to top ]

rsibt_hidreconnect :: HID Reconnect

Description

HID Reconnect command is used to connect to a device with HID profile.

This command needs prior exchange of SDP records with the master device during initial connection for profile level exchanges.

Command Format

at+rsibt_hidreconnect=<BD Address>

Parameters

BD Address

• BD Address of the device to reconnect

Example

at+rsibt_hidreconnect=AA-BB-CC-DD-EE-FF

Response

OK

[ Go to top ]

rsibt_enabledevicetestmode :: Enable Device Under TestMode

Description

This is used to request the local device to enable test mode. This command should only be called after the commands:

• rsi_bt_start_discoverable
• rsi_bt_set_connectable

Command Format

at+rsibt_enabledevicetestmode

Example

Command

at+rsibt_enabledevicetestmode

Response

OK