BLE 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

GroupAT Command APIDescription
Common API's
rsi_opermodeSet Operating Mode
rsibt_setlocalnameSet Local Name
rsibt_getlocalnameQuery Local Name
rsibt_getrssiQuery RSSI
rsibt_getlocalbdaddrQuery Local BD Address
rsibt_getbtstackversionQuery BT Stack Version
rsibt_updategaintableoffsetMaxpowerUpdate Gain Table Offset and MaxPower
rsibt_btantennaselectBT Antenna Select
rsibt_setantennatxpowerlevelSet Antenna Tx Power Level
rsibt_btinitInitialize BLE Module
rsibt_btdeinitDeinitialize BLE Module
PER API's
rsibt_bletransmitBLE PER Transmit
rsibt_blereceiveBLE PER Receive
rsibt_perstatsPER Stats
rsibt_percwmodePER CW Mode
BLE test mode API's
rsibt_enhancedrxtestLE Enhanced Receiver Test Mode
rsibt_enhancedtxtestLE Enhanced Transmitter Test Mode
rsibt_endtestLE Enhanced End Test Mode
BLE GAP API's
rsibt_advertiseAdvertise Local Device
rsibt_connectConnect
rsibt_setresolutionenableBLE SetResolution Enable
rsibt_scanScan
rsibt_disconnectDisconnect
rsibt_getdevstateQuery Device State
rsibt_startencryptStart Encryption
rsibt_setadvertisedataBLE Set Advertise Data
rsibt_setscanrspdataBLE Set scan Response Data
rsibt_setrandaddBLE Set Random Device Address
rsibt_lewhitelistBLE Whitelist
rsibt_setphyBLE Set Phy Command
rsibt_readphyBLE Read Phy Command
rsibt_setdatalengthBLE Set Data Length Command
rsibt_readdatalengthBLE Read Maximum Data Length Command
rsibt_resolvlistBLE Resolve List
getresolvlistsizeBLE GetResolvlist Size
rsibt_setprivacymodeBLE SetPrivacy Mode
rsibt_updateparamsBLE connection Update Command
rsibt_leltkreqreplyLE LTK Request-Reply
BLE SMP API's
rsibt_smpreqSMP Pair Request
rsibt_smprespSMP Response
rsibt_smppasskeySMP Passkey
BLE GATT API's
rsibt_getcharservicesQuery Characteristic Services
at+rsibt_blesetmtuBLE Set MTU Size Command
rsibt_mtuexchangerespLE MTU Exchange Resp
rsibt_getallprofilesQuery Profiles List
rsibt_getprofileQuery Profile
rsibt_getincservicesQuery Include Services
rsibt_readbytypeRead Characteristic Value By UUID
rsibt_getdescriptorsQuery Attribute
rsibt_readvalueQuery Attribute Value
rsibt_readmultipleLE Read Multiple
rsibt_longreadQuery Long Attribute Value
rsibt_writevalueSet Attribute Value
rsibt_writecmdSet Attribute Value No Ack
rsibt_longwriteSet Long Attribute Value
rsibt_preparewriteSet Prepare Long Attribute Value
rsibt_executewriteExecute Long Attribute Value
BLE GATT - Server API's
rsibt_sendnotifySend Notify
rsibt_addserviceAdd GATT Service Record
rsibt_addattributeAdd Attribute Record
rsibt_setlocalattvalueSet Local Attribute Value
rsibt_getlocalattvalueGet Local Attribute Value
rsibt_readrespSend Read Response
rsibt_writeresponseWrite Response
rsibt_preparewriteresponsePrepare Write Response
rsibt_sendindicateSend Indicate
rsibt_removeserviceRemove Service
rsibt_removeattributeRemove Attribute

rsi_opermode :: Set Operating Mode

Description

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

Command Format

ext_custom_feature_bit_map gets enabled when 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>

ext_tcp_ip_feature_bit_map gets enabled when 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>

bt_feature_bit_map gets enabled when BIT(31) is set to ‘1’ in both custom_feature_bit_map and ext_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_feature_bit_map>

ble_custom_feature_bit_map gets enabled when BIT(31) is set to 1 in custom_feature_bitmap, ext_custom_feature_bit_map and 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_custom_feature_bit_map>

ble_custom_ext_feature_bit_map gets enable when 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_feature_bit_map>,<ext_tcp_ip_feature_bit_map>,<ble_custom_feature_bit_map>,<ble_custom_ext_feature_bit_map>

config_feature_bit_map gets enabled when 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_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 (4 bytes)

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

custom_feature_bit_map (4 bytes)

ext_custom_feature_bit_map (4 bytes)

bt_feature_bit_map (4 bytes)

ble_custom_feature_bit_map (4 bytes)

ble_custom_ext_feature_bit_map (4 bytes)

config_feature_bit_map (4 bytes)

Config Feature bitmapFunctionalitySet to 0Set to 1Notes
config_feature_bit_map[0]To select wakeup indication to host.If it is disabled UULP_GPIO_3 is used as a wakeup indication to host.If it is enabled UULP_GPIO_0 is used as a wakeup indication to host.DisableEnable
config_feature_bit_map[1:15]Reserved
config_feature_bit_map[16]Active high or low interrupt mode selection for wake on wireless operationIf it is disabled active low interrupt is used in wake on wireless operation.If it is enabled active high interrupt isused in wake on wireless operation.DisableEnable
config_feature_bit_map[23:17]Reserved
config_feature_bit_map[25:24]Configurability options for 40MHz XTAL good time in μs [00 = 1000], [01 = 2000], [10 = 3000], [11 = 600]These bits are used to select XTAL good time.These changes are available from Release2.3.0 onwards. Release prior to 2.3.0 these config_feature_bitmap[31:17] are reserved. Its only applicable for customers using chip not the module. Please contact Support for more details. Default value is 1000 µs.
config_feature_bit_map[31:26]Reserved for LMAC.

Note!


Response

Result CodeDescription
OKSuccess
ERROR Failure

Example 1

Enable WLAN and BLE operating mode with BLE power save index as 31 and 9116 compatible feature enabled.

Command

at+rsi_opermode=851968,0,1,2147483648,2150629376,3221225472,0,3760128000,2048

Response

OK
bt_loaded

Example 2

Enable 7 BLE slaves, 5 services and 25 attributes, 30 BLE power save index

Command

at+rsi_opermode=851968,0,1,2147483648,2150629376,3221225472,0,1996057

Response

OK
bt_loaded

[ Go to top ]


rsibt_setlocalname :: Set Local Name

Description

This is used to set name to the local device.

at+rsibt_setlocalname=<NameLength>,<Name>

Parameters

NameLength

Name (16 bytes)

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

Result CodeDescription
OK <name_length>,<local_device_name>Command Success.
ERROR <Error_code>Command Fail.

where ...

name_length

local_device_name (16 bytes)

Example

Command

at+rsibt_getlocalname?

Response

OK 6,silabs

[ Go to top ]


rsibt_getrssi :: Query RSSI

Description

This is used to query RSSI of the connected remote BD device

at+rsibt_getrssi=<BDAddress>?

Parameters

BDAddress (6 bytes)

Response

Result CodeDescription
OK Command Success
ERROR <Error_code>Command Fail

where ...

rssi value

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 the BD address of the local device

Command Format

at+rsibt_getlocalbdaddr?

Response

Result CodeDescription
OK Command Success with valid response.
ERROR <Error_code>Command Fail.

where ...

BDAddress (6 bytes)

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 the Current BT Stack Version.

Command Format

at+rsibt_getbtstackversion?

Response

Result CodeDescription
OK Command Success with valid response.
ERROR <Error_code>Command Fail.

where ...

stack version(10 bytes) - Current Stack Version

Example

Command

at+rsibt_getbtstackversion?

Response

OK 2.1.0

[ 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!


Command Format

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

Parameters

node_id

update_gain_table_type

payloadlength

payload

<TABLE NAME>[] = { 
                  <REGION NAME 1>, <MAX POWER>, 
                  <REGION NAME 1>, <MAX POWER>,
                  .
                  .
                  <REGION NAME N>, <MAX POWER> 
                  };
<TABLE NAME>[] = {
                  <Number Of Regions - 'r'>, 
                    <REGION NAME 1>, <Number Of Channels - 'm'>,
                      <CHANNEL NUMBER 1>, <OFFSET>, 
                      <CHANNEL NUMBER 2>, <OFFSET>,
                      . 
                      .
                      <CHANNEL NUMBER m>, <OFFSET>,
                    <REGION NAME 2>, <No Of Channels - 'n'>,
                      <CHANNEL NUMBER 1>, <OFFSET>, 
                      <CHANNEL NUMBER 2>, <OFFSET>,
                      . 
                      .
                      <CHANNEL NUMBER n>, <OFFSET>,
                     .
                     .
                     <REGION NAME r>, <No Of Channels - 'n'>,
                       <CHANNEL NUMBER 1>, <OFFSET>, 
                       <CHANNEL NUMBER 2>, <OFFSET>,
                       .
                       .
                       <CHANNEL NUMBER n>, <OFFSET>,
                   };
ValueRegion
0FCC
1ETSI
2TELEC
4KCC
3WORLDWIDE

Response

Result CodeDescription
OKSuccess with valid response.
ERROR <Error_code>Command Fail.
4F01 - Invalid gain table payload length
4F02 - Invalid region
4F03 - Invalid gain table offset request type
4F04 - Invalid node id request

Example 1 - Update BLE Max Power

Command

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

Example 2 - Update BLE Offset

Command

at+rsibt_updategaintableoffsetMaxpower= 0,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

Note! Here...


Response

OK

[ Go to top ]


rsibt_bletransmit :: BLE PER Transmit

Description

This command can be given to start the BLE transmission.

Command Format

at+rsibt_bletransmit=<enable>,<access_addr>,<ble_rate>,<rx_channel_num>,<tx_channel_num>,<scrambler_seed>,<le_channel_type>,<hopping_type>,<antenna_sel>,<pll_mode>,<rf_type>,<rf_chain>,<pkt_len>,<payload_type>,<tx_power_index>,<tx_mode>,<inter_packet_gap>,<num_of_packets>

Parameters

enable/disable

access_addr

ble_rate

rx_channel_num

tx_channel_num

scrambler_seed

le_channel_type

hopping_type

antenna_sel

pll_mode

rf_type

rf_chain

pkt_len

payload_type

tx_power_index

tx_mode

inter_pkt_gap

num_of_packets

Response

Result CodeDescription
OKCommand Success with valid response.
ERROR <Error_code>Command Fail.

Example

Command

at+rsibt_bletransmit=1,71764129,1,10,10,0,1,0,3,0,1,3,240,1,31,0,0,0

Response

OK

[ Go to top ]


rsibt_blereceive :: BLE PER Receive

Description

This command can be given to start the BLE reception.

Command Format

at+rsibt_blereceive=<enable>,<access_addr>,<ble_rate>,<rx_channel_num>,<tx_channel_num>,<scrambler_seed>,<le_channel_type>,<hopping_type>,<antenna_sel>,<pll_mode>,<rf_type>,<rf_chain>,<ext_data_len_ind>,<loop_back_mode>,<duty_cycling>

Parameters

enable

access_addr

ble_rate

rx_channel_num

tx_channel_num

scrambler_seed

le_channel_type

hopping_type

antenna_sel

pll_mode

rf_type

rf_chain

ext_data_len_ind

loop_back_mode

duty_cycling

Response

Result CodeDescription
OKCommand Success with valid response.
ERROR <Error_code>Command Fail.

Example

Command

at+rsibt_blereceive=1,71764129,1,10,10,0,1,0,3,0,1,3,240,1,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

at+rsibt_perstats

Parameters

Example

Command

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)

crc_pass_count (2 bytes)

tx_abort_count (2 bytes)

rx_drop_count (2 bytes)

rx_cca_idle_count (2 bytes)

rx_start_idle_count (2 bytes)

rx_abrt_count (2 bytes)

tx_dones (2 bytes)

rssi (1 byte integer)

id_pkts_rcvd (2 bytes)

dummy (2 bytes)

Response Example

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

BLE Channel Number Reference

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

ChannelCenter Freq (MHz)
02402
12404
22406
32408
42410
52412
62414
72416
82418
92420
102422
112424
122426
132428
142430
152432
162434
172436
182438
192440
202442
212444
222446
232448
242450
252452
262454
272456
282458
292460
302462
312464
322466
332468
342470
352472
362474
372476
382478
392480

[ Go to top ]


rsibt_percwmode :: PER CW Mode

Description

This command can be given to enable the Continuous Wave mode transmission. Need to issue this command after giving the BLE transmit command.

Command Format

at+rsibt_percwmode=<enable>

Parameters

enable

Example - Start CW mode

Command

at+rsibt_percwmode=1

Response

OK

[ Go to top ]


rsibt_advertise :: Advertise Local Device

Description

This is used to expose or advertise about the local device to the remote BT devices.

Command Format

All parameters should be in decimal except DirectAddr which should be in hexadecimal

at+rsibt_advertise=<Status>,<AdvertiseType>,<FilterType>,<DirectAddrType>,<DirectAddr>,<adv_int_min>,<adv_int_max>,<own_add_type>,<adv_channel_map>

Parameters

status

AdvertiseType (1 byte)

StateDescription
0x80connectable undirected
0x81connectable directed with high duty cycle
0x82scannable undirected
0x83Non connectable undirected
0x84connectable directed with low duty cycle

FilterType (1 byte)

Filter typeDescription
0Allow scan Request from Any, Allow connect Request from Any.
1Allow scan Request from White List Only, Allow connect Request from Any.
2Allow scan Request from Any, Allow connect Request from White List Only.
3Allow scan Request from White List Only, Allow connect Request from White List Only.

DirectAddrType (1 byte)

DirectAddr (1 byte)

adv_int_min (2 bytes)

adv_int_max (2 bytes)

own_add_type (1 byte)

adv_channel_map (1 byte)

ValueParameter Description
00000000bReserved for future use
xxxxxxx1bEnable channel 37 use
xxxxxx1xbEnable channel 38 use
xxxxx1xxbEnable channel 39 use
00000111bDefault (all channels enabled)

Response

Result CodeDescription
OKCommand Success.
ERROR <Error_code>Command Fail.

Example

Command

at+rsibt_advertise=1,128,0,0,0,32,32,0,7

Response

OK

Note! For scannable undirected and non-connectable undirected advertising modes, minimum advertising interval should be 41ms and maximum advertising interval should be 1.28s


[ Go to top ]


rsibt_scan :: Scan

Description

This is used to scan for remote LE advertising devices.

Command Format

at+rsibt_scan=<Status>,<Scantype>,<FilterType>,<own_add_type>,<scan_int>,<scan_win>

Parameters

All parameters are in decimal

Status (1 byte)

scantype (1 byte)

FilterType (1 byte)

own_add_type (1 byte)

scan_int (2 bytes)

scan_win (2 bytes)

Response

| Result Code | Description | | OK | Command Success. | | ERROR <Error_code> | Command Fail. |

Example

Disable scan

Command

at+rsibt_scan=0,0,0,0,100,10

Response

OK

Note!


rsibt_connect :: Connect

Description

This is used to create connection with remote LE device.

Command Format

at+rsibt_connect=< AddressType >, < BDAddress >< LeScanInterval >,< LeScanWindow >,< ConnIntervalMin >,< ConnIntervalMax >,< ConnLatency >,< SupervisionTimeout >

Parameters

AddressType (1 byte)

LescanInterval (2 bytes)

LescanWindow (2 bytes)

ConnIntervalMin (2 bytes)

ConnIntervalMax(2 bytes)

ConnLatency (2 bytes)

SupervisionTimeout (2 bytes)

Response

Result CodeDescription
OKCommand Success.
ERROR <Error_code>Command Fail.

Example

Command

at+rsibt_connect=0,B4-99-4C-64-BE-F5,96,32,160,160,0,100

Response

OK

Note!


[ Go to top ]


rsibt_disconnect :: Disconnect

Description

This is used to cancel create connection or disconnect HCI connection, if already connected.

Command Format

at+rsibt_disconnect=<BDAddress>

Parameters

BDAddress (6 bytes)

Response

| Result Code | Description | | OK | Command Success. | | ERROR <Error_code> | Command Fail. |

Example

Command

at+rsibt_disconnect=53-41-CC-FF-91-2A

Response

OK

[ Go to top ]


rsibt_getdevstate :: Query Device State

Description

This is used to query state of the local device.

Command Format

at+rsibt_getdevstate?
Result CodeDescription
OK,Command Success.
ERROR <Error_code>Command Fail.

where ...

DeviceState (1 byte)

Example

Command

at+rsibt_getdevstate?

Response

OK 8

[ Go to top ]


rsibt_startencrypt :: Start Encryption

Description

This is used to initiate the Encryption procedure.

Command Format

at+rsibt_startencrypt=<BDAddress>,<RemoteEDIV>,<RemoteRand>,<RemoteLTK>

Parameters

BDAddress (6 bytes)

RemoteEDIV (2 bytes)

RemoteRand (8 bytes)

RemoteLTK (16 bytes)

Response

Result CodeDescription
OKCommand Success.
ERROR <Error_code>Command Fail.

Example

Command

at+rsibt_startencrypt=B4-99-4C-64-BE-F5,253C,45,B6,53,7A,37,42,85,9D,65,BA,84,DA,CC,56,85,9D,3A,74,3C,45,23,78,4D,3A

Response

OK

[ Go to top ]


rsibt_smpreq :: SMP Pair Request

Description

This is used to send SMP Pair Request command to the connected remote device.

at+rsibt_smpreq=<BDAddress>,<IO Capability>

Parameters

BDAddress (6 bytes)

IOCapability (1 byte)

Response

Result CodeDescription
OKCommand Success.
ERROR <Error_code>Command Fail.

Example

Command

at+rsibt_smpreq=B4-99-4C-64-BE-F5,1

Response

OK

[ Go to top ]


rsibt_smpresp :: SMP Response

Description

This is used to send SMP response to the SMP request made by the remote device.

Command Format

at+rsibt_smpresp=<BDAddress>,<IOCapability>

Parameters

BDAddress (6 bytes)

IOCapability (1 byte)

Response

Result CodeDescription
OKCommand Success.
ERROR <Error_code>Command Fail.

Example

Command

at+rsibt_smpresp=74-04-2B-7A-93-EF,1

Response

OK

[ Go to top ]


rsibt_smppasskey :: SMP Passkey

Description

This is used to send SMP Passkey required to connect with the remote device.

Command Format

at+rsibt_smppasskey=<BDAddress>,<Passkey>

Parameters

BDAddress (6 bytes)

Passkey (4 bytes)

Response

Result CodeDescription
OKCommand Success.
ERROR <Error_code>Command Fail.

Example

Command

at+rsibt_smppasskey=B4-99-4C-64-BE-F5,12345

Response

OK

[ Go to top ]


rsibt_btinit :: Initialize BLE Module

Description

This is used to initialize the BLE module

Command Format

at+rsibt_btinit
Result CodeDescription
OKCommand Success.
ERROR <Error_code>Command Fail.

Example

Command

at+rsibt_btinit

Response

OK

[ Go to top ]


rsibt_btdeinit :: Deinitialize BLE Module

Description

This is used to deinitialize the BLE module.

Command Format

at+rsibt_btdeinit

Response

Result CodeDescription
OKCommand Success.
ERROR <Error_code>Command Fail.

Example

Command

at+rsibt_btdeinit

Response

OK

[ Go to top ]


rsibt_btantennaselect :: BT Antenna Select

Description

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

Command Format

at+rsibt_btantennaselect=<AntennaVal>

Parameters

AntennaVal (1 byte)

Response

Result CodeDescription
OKCommand Success.
ERROR <Error_code>Command Fail.

Example

Command

at+rsibt_btantennaselect=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)

power_level (1 byte)

Tx Power IndexTx Power Mode
1 - 31BLE - 0dBm Mode
33 - 63BLE - 10 dBm Mode
64 - 75BLE - HP Mode

Example

at+rsibt_setantennatxpowerlevel=2,31

Response

OK

[ Go to top ]


rsibt_setadvertisedata :: BLE Set Advertise Data

Description

This command is used to set the advertise data to expose remote devices.

Command Format

at+rsibt_setadvertisedata=<DataLen>,<Data>

Parameters

Length (1 byte)

Data (31 bytes)

Response

Result CodeDescription
OKCommand Success.
ERROR <Error_code>Command Fail.

Example

Command

at+rsibt_setadvertisedata=8,2,1,6,4,9,72,72,72

Response

OK

Note! Name set in this command will be shown on remote device when remote device scan for advertising device(except for ios versions). For more information on this advertising data with types, information is available at following link: https://www.bluetooth.com/specifications/assigned-numbers/generic-access-profile


Advertising or scan Response Data

[ Go to top ]


rsibt_setscanrspdata :: BLE Set scan Response Data

Description

This command is used to set the scan response data.

Command Format

at+rsibt_setscanrspdata=<DataLen>,<Data>

Parameters

Length (1 byte)

Data (31 bytes)

Response

Result CodeDescription
OKCommand Success.
ERROR <Error_code>Command Fail.

Example

Command

at+rsibt_setscanrspdata=8,2,1,6,4,9,72,72,72

Response

OK

Note!


[ Go to top ]


rsibt_setrandadd :: BLE Set Random Device Address

Description

This command is used by the Host to set the LE Random Device Address in the Controller.

Command Format

at+rsibt_setrandadd=<BDAddress>

Parameters

BDAddress (6 bytes)

Response

Result CodeDescription
OK Command Success.
ERROR <Error_code>Command Fail.

where ...

status

Example

Command

at+rsibt_setrandadd=B4-99-4C-64-BE-F5

Response

OK

[ Go to top ]


BLE Data Encrypt

Description

This command is used to encrypt the data. This is the HCI_LE_Encrypt command and is used to request the Controller to encrypt the data(Plaintext_Data) in the command using the Key given in the command and returns the Encrypted_Data to the Host. It uses the AES-128 bit block cypher alogo to generate encrypted data. Refer to Bluetooth Spec 5.0 for further details

Command

at+rsibt_leencrypt=<key>,<data> 

Parameters

key

data

Response

Result CodeDescription
OK Command Success.
ERROR <Error_code>Command Fail.

where ...

EncData (16 Bytes)

Example

Command

at+rsibt_leencrypt=1,2,3,4,5,6,7,8,9,0,B,C,D,E,F,10,1,2,3,4,5,6,7,8,9,0,B,C,D,E,F,10

Response

OK 10 93 c1 5a e4 a5 db fd 5e c2 4c 61 8a a3 11 28 

[ Go to top ]


rsibt_lewhitelist :: BLE Whitelist

Description

This is used to add a particular BD-Address to the white list. Maximum number of device address that firmware can store is 10.

Command Format

at+rsibt_lewhitelist=<operation>,<BDAddress>,<BDAddressType>

Parameters

operation (1 byte)

BDAddress (6 bytes)

BDAddressType (1 byte)

Response

Result CodeDescription
OKCommand Success.
ERROR <Error_code>Command Fail.

Example

Command

at+rsibt_lewhitelist=1,00-23-A7-80-6F-CD,1

Response

OK

[ Go to top ]


rsibt_blesetmtu :: BLE Set MTU Size Command

Description

This is used to set the MTU size for the BLE stack. By default MTU size is 240bytes. Until issue this command, MTU size won't be changed from 240bytes.

Command Format

at+rsibt_blesetmtu=<BDAddress>,<MTU Size>

Parameters

BDAddress (6 bytes)

mtu_size

Response

Result CodeDescription
OKCommand Success.
ERROR <Error_code>Command Fail.

Example

Command

at+rsibt_blesetmtu=69-76-4A-4C-13-8C,80

Response

OK

[ Go to top ]


rsibt_mtuexchangeresp :: LE MTU Exchange Resp

Description

This is used to set the MTU size for the BLE stack.

Command Format

at+rsibt_mtuexchangeresp=<BDAddress>,<MTU Size>

Response

Result CodeDescription
OKCommand Success.
ERROR <Error_code>Command Fail.

Example

Command

at+rsibt_mtuexchangeresp=69-76-4A-4C-13-8C,75

Response

OK

Note!


[ Go to top ]


rsibt_setphy :: BLE Set Phy Command

Description

The LE_Set_PHY command is used to set the PHY preferences for the connection identified by the connection_Handle.

Command Format

at+rsibt_setphy=<remotebdaddress>,<all_phy>,<tx_phy>,<rx_phy>,<phy_options>

Parameters

BDAddress (6 bytes)

All_phy (1 byte)

tx_phy (1 byte)

rx_phy (1 byte)

phy_options (2 bytes)

Response

Result CodeDescription
OKCommand Success.
ERROR <Error_code>Command Fail.

Example

Command

at+rsibt_setphy=00-23-A7-00-00-0D,0,1,2,0

Response

OK

[ Go to top ]


rsibt_readphy :: BLE Read Phy Command

Description

The LE_Read_PHY command is used to read the current transmitter PHY and receiver PHY on the connection identified by the connection_Handle.

Command Format

at+rsibt_readphy=<remotebdaddr>

Parameters

remotebdaddr (6 bytes)

Response

Result CodeDescription
OK,,<tx_phy>,<rx_phy>Command Success.
ERROR <Error_code>Command Fail.

where ...

Remotebdaddr (6 bytes)

tx_phy

rx_phy

Example

Command

at+rsibt_readphy=00-23-A7-00-00-0D

Response

OK 88-DA-1A-9E-BE-6A,2,2

[ Go to top ]


rsibt_setdatalength :: BLE Set Data Length Command

Description

The LE_Set_Data_Length command allows the Host to suggest maximum transmission packet size and maximum packet transmission time.

Command Format

at+rsibt_setdatalength=<BDAddress>,<TXOctets><TXTime>

Parameters

BDAddress (6 bytes)

TXOctets (2 bytes)

TXTime (2 bytes)

Response

Result CodeDescription
OKCommand Success.
ERROR <Error_code>Command Fail.

Example

Command

at+rsibt_setdatalength =00-23-A7-80-6F-CD,40,330

Response

OK

[ Go to top ]


rsibt_readdatalength :: BLE Read Maximum Data Length Command

Description

The LE_Read_Maximum_Data_Length command allows the Host to read the Controller's maximum supported payload octets and packet duration times for transmission and reception.

Command Format

at+rsibt_readdatalength?

Response

Result CodeDescription
OK ,,,,Command Success.
ERROR <Error_code>Command Fail.

where ...

ParameterDescription

maxtxoctets

maxtxtime

maxrxoctets

maxrxtime

Example

Command

at+rsibt_readdatalength?

Response

OK 230,750,230,750

[ Go to top ]


rsibt_resolvlist :: BLE Resolve List

Description

The Resolving List command is used to add/remove/clear one device to the list of address translations used to resolve Resolvable Private Addresses in the Controller.

Command Format

at+rsibt_resolvlist=<Process_type>,<address_type>,<peer_address>,<peer_irk>,<local_irk>

Parameters

Process_type

AddressType

peer_address

peer_irk

local_irk

Response

Result CodeDescription
OKCommand Success
ERROR_CODECommand Fail.

Examples

Add device to resolvlist

Command

at+rsibt_resolvlist=<Process_type>,<address_type>,<peer_address>,<peer_irk>,<local_irk>  ... for example ...
at+rsibt_resolvlist=1,0,00-23-A7-00-00-0D,01,01,01,01,01,01,01,01,01,01,01,01,01,01,01,01,02,02,02,02,02,02,02,02,02,02,02,02,02,02,02,02

Remove device from resolvlist

Command

at+rsibt_resolvlist=2,<address_type>,<peer_address>  ... for example ...
at+rsibt_resolvlist=2,0,00-23-A7-00-00-0D

Clear resolvlist

Command

at+rsibt_resolvlist=<Process_type>  ... for example ...
at+rsibt_resolvlist=3

Response

Assuming success in each case ...

OK

[ Go to top ]


getresolvlistsize :: BLE GetResolvlist Size

Description

The BLE_Read_Resolving_List_Size command is used to read the total number of address translation entries in the resolving list that can be stored in the Controller.

Command Format

at+rsibt_ getresolvlistsize?

Response

Result CodeDescription
OK,Command Success
ERROR_CODECommand Fail.

where ...

size (1 byte)

Example

Command

at+rsibt_ getresolvlistsize?

Response

OK 5

[ Go to top ]


rsibt_setresolutionenable :: BLE SetResolution Enable

Description

The BLE_Set_Address_Resolution_Enable command is used to enable resolution of Resolvable Private Addresses in the Controller, The LE _Timeout command sets the length of time the Controller uses a Resolvable Private Address before a new resolvable private address is generated and starts being used. This timeout applies to all addresses generated by the Controller.

Command Format

at+rsibt_setresolutionenable=<enable>,<timeout>

Parameters

enable

timeout

Response

Result CodeDescription
OKCommand Success
ERROR_CODECommand Fail.

Example

Command

at+rsibt_setresolutionenable=1,60

Response

OK

[ Go to top ]


rsibt_setprivacymode :: BLE SetPrivacy Mode

Description

The HCI_LE_Set_Privacy_Mode command is used to allow the Host to specify the privacy mode to be used for a given entry on the resolving list.

Command Format

at+rsibt_setprivacymode=<peer_addr_type>,<peer_addr>,<privacy_mode>

Parameters

peer_addr_type

peer_addr

privacy_mode

Response

Result CodeDescription
OKCommand Success
ERROR_CODECommand Fail.

Example

Command

at+rsibt_setprivacymode=0,00-23-A7-00-00-0D,1

Response

OK

[ Go to top ]


rsibt_updateparams :: BLE connection Update Command

Description

The LE_UPDATE_PARAMS command is used to change the Link Layer connection parameters of a connection.

Command Format

at+rsibt_updateparams=<bd_addr>,<Conn_Interval_Min>,<Conn_Interval_Max>,<Conn_Latency>,<Supervision_Timeout>

Parameters

bd_addr

Conn_Interval_Min

Conn_Interval_Max

Conn_Latency)

Supervision_Timeout

Response

Result CodeDescription
OKCommand Success
ERROR_CODECommand Fail.

Example

Command

at+rsibt_updateparams=00-1A-7D-DA-71-13,12,12,0,500

Response

OK

[ Go to top ]


rsibt_getallprofiles :: Query Profiles List

Description

This is used to query all the supported profiles list from the connected remote device.

Command Format

at+rsibt_getallprofiles=<BDAddress>,<StartHandle>,<EndHandle>

Parameters

BDAddress (6 bytes

StartHandle (2 bytes)

EndHandle (2 bytes)

Response

Result CodeDescription
OK ,<number_profiles>,Command Success.
ERROR <Error_code>Command Fail.

where ...

number_profiles (1 byte)

profile descriptors list (10 bytes)

Example

Command

at+rsibt_getallprofiles=B4-99-4C-64-BE-F5,1,10

Response

OK 3
1,B,2,1800
C,F,2,1801
10,FFFF,2,180A

Note! This command is a sync command, while using this command Need to disable BIT(29): GATT Async bit in ble_custom_feature_bit_map


[ Go to top ]


rsibt_getprofile :: Query Profile

Description

This is used to query particular profile details from the connected remote device.

Command Format

at+rsibt_getprofile=<BDAddress>,<size_uuid>,<ProfileUUID>

Parameters

BDAddress (6 bytes)

Size_uuid

ProfileUUID

Response

Result CodeDescription
OK ,Command Success.
ERROR <Error_code>Command Fail.

where ...

profile descriptors list (28 bytes)

Example 1

Command

at+rsibt_getprofile=77-A8-E3-CC-41-CB,2,1800

Response

OK 1,5,2,1800

Example 2 - 128 bit UUID

Command

at+rsibt_getprofile=77-A8-E3-CC-41-CB,16,0000aaa0-0000-1000-8000-bb,aa,ff,ee,dd,cc

Response

OK 1,5,2,0000aaa0-0000-1000-8000-bb,aa,ff,ee,dd,cc

Note! This command is a sync command, while using this command Need to disable BIT(29): GATT Async bit in ble_custom_feature_bit_map


[ Go to top ]


rsibt_getcharservices :: Query Characteristic Services

Description

This is used to query characteristic services, within the particular range, from the connected remote device.

Command Format

at+rsibt_getcharservices=<BDAddress>,<StartHandle>,<EndHandle>

Parameters

BDAddress (6 bytes)

StartHandle (2 bytes)

EndHandle (2 bytes)

Response

Result CodeDescription
OK ,,Command Success.
ERROR <Error_code>Command Fail.

where ...

NumberOfCharServices (1 byte)

CharacteristicService (5 bytes)

Example

at+rsibt_getcharservices=B4-99-4C-64-BE-F5,1,10

Response

OK 5,2,2,3,2,2A00
4,2,5,2,2A01
6,2,7,2,2A02
8,8,9,2,2A03
A,2,B,2,2A04

Note! This command is a sync command, while using this command Need to disable BIT(29): GATT Async bit in ble_custom_feature_bit_map


[ Go to top ]


rsibt_getincservices :: Query Include Services

Description

This is used to query include services, within the particular range, from the connected remote device.

Command Format

at+rsibt_getincservices=<BDAddress>,<StartHandle>,<EndHandle>

Parameters

BDAddress (6 bytes)

StartHandle (2 bytes)

EndHandle (2 bytes)

Response

Result CodeDescription
OK ,,Command Success.
ERROR <Error_code>Command Fail.

where ...

NumberOfIncServices (1 byte)

IncludedService (5 bytes)

Example

at+rsibt_getincservices=68-2F-10-0B-62-63,1,10

Response

OK 1,15,11,12,2,AABB

Note! This command is a sync command, while using this command Need to disable BIT(29): GATT Async bit in ble_custom_feature_bit_map


[ Go to top ]


rsibt_readbytype :: Read Characteristic Value By UUID

Description

This is used to get the characteristic attribute value of the specified UUID.

Command Format

at+rsibt_readbytype=<BDAddress>,<StartHandle>,<Endhandle>,<size>,<UUID>

Parameters

BDAddress (6 bytes)

StartHandle (2 bytes)

EndHandle (2 bytes)

size

UUID

Response

Result CodeDescription
OK ,,Command Success.
ERROR <Error_code>Command Fail.

where ...

NumberOfValues (1 byte)

CharacterValue (30 bytes)

Example

Command

at+rsibt_readbytype=65-65-11-B4-8C-08,1,10,2,2A00

Response

OK 6,3,0,69,50,61,64

Note! This command is a sync command, while using this command Need to disable BIT(29): GATT Async bit in ble_custom_feature_bit_map


[ Go to top ]


rsibt_getdescriptors :: Query Attribute

Description

This is used to query the Attribute Descriptors from the connected remote device. The Descriptor includes both the Handle and UUID.

Command Format

at+rsibt_getdescriptors=<BDAddress>,<StartHandle>,<EndHandle>

Parameters

BDAddress (6 bytes)

StartHandle (2 bytes)

EndHandle (2 bytes)

Response

Result CodeDescription
OK ,Command Success.
ERROR <Error_code>Command Fail.

where ...

NumberOfAttributes (1 byte)

AttributeDescriptor (5 bytes)

Example

Command

at+rsibt_getdescriptors=B4-99-4C-64-BE-F5,1,ffff

Response

OK 5
1,2,2800
2,2,2803
3,2,2A00
4,2,2803
5,2,2A01

Note! This command is a sync command, while using this command Need to disable BIT(29): GATT Async bit in ble_custom_feature_bit_map


[ Go to top ]


rsibt_readvalue :: Query Attribute Value

Description

This is used to query Attribute value from the connected remote device.

Command Format

at+rsibt_readvalue=<BDAddress>,<Handle>

Parameters

BDAddress (6 bytes)

Handle (2 bytes)

Response

Result CodeDescription
OK ,,Command Success.
ERROR <Error_code>Command Fail.

where ...

NumberOfValues (1 byte)

AttributeValues (30 bytes)

Example

at+rsibt_readvalue=65-65-11-B4-8C-08,1

Response

OK 2,0,18

Note! This command is a sync command, while using this command Need to disable BIT(29): GATT Async bit in ble_custom_feature_bit_map


[ Go to top ]


rsibt_enhancedrxtest :: LE Enhanced Receiver Test Mode

Description

This command is used to start a test where the DUT receives test reference packets at a fixed interval.

Command Format

at+rsibt_enhancedrxtest=<RX_channel>,<phy>,<Modulation>

Parameters

RX_channel (1 byte)

phy (1 byte)

Modulation (1 byte)

Response

Result CodeDescription
OKCommand Success.
ERROR <Error_code>Command Fail.

Example

Command

at+rsibt_enhancedrxtest=30,1,1

Response

OK

rsibt_enhancedtxtest :: LE Enhanced Transmitter Test Mode

Description

This command is used to start a test where the DUT generates test reference packets at a fixed interval.

Command Format

at+rsibt_enhancedtxtest=<TX_channel>,<phy>,<TxLen>,<TxDataMode>

Parameters

TX_channel (1 byte)

phy (1 byte)

TxLen (1 byte)

TxDataMode (1 byte)

Response

Result CodeDescription
OKCommand Success.
ERROR <Error_code>Command Fail.

Example

Command

at+rsibt_enhancedtxtest=30,1,2,0

Response

OK

rsibt_endtest :: LE Enhanced End Test Mode

Description

This command is used to stop any test which is in progress.

Command Format

at+rsibt_endtest

Parameters

NumOfPkts (2 bytes)

Response

Result CodeDescription
OKCommand Success.
ERROR <Error_code>Command Fail.

Example

Command

at+rsibt_endtest

Response

OK 100

[ Go to top ]


rsibt_leltkreqreply :: LE LTK Request-Reply

Description

This is used to intimate the controller about the long-term key in the host.

Command Format

at+rsibt_leltkreqreply=<BDAddress>,<reply_type>,<Long_term_key>

Parameters

BDAddress (6 bytes)

Reply_Type (1 byte)

Long_term_key (16 bytes)

Response

Result CodeDescription
OKCommand Success.
ERROR <Error_code>Command Fail.

Example

Command

at+rsibt_leltkreqreply=6E-35-7C-35-50-2F,0,0
at+rsibt_leltkreqreply=6E-35-7C-35-50-2F,1,<LocalLTK of 16 bytes>

Response

OK

[ Go to top ]


rsibt_readmultiple :: LE Read Multiple

Description

This is used to query Multiple Attribute values from the connected remote device.

Command Format

at+rsibt_readmultiple=<BDAddress>,<NumberofHandles>,<Handles>

Parameters

BDAddress (6 bytes)

NumberOfHandles (1 byte)

Handles (10 bytes)

Response

Result CodeDescription
OK,,Command Success.
ERROR <Error_code>Command Fail.

where ...

NumberOfValues (2 bytes)

AttributeValues (30 bytes)

Example

Command

at+rsibt_readmultiple=65-65-11-B4-8C-08,3,1,2,5

Response

OK 9,0,18,2,3,0,0,2A,80,2

[ Go to top ]


rsibt_longread :: Query Long Attribute Value

Description

This is used to query long Attribute value from the connected remote device. This is useful when the Attribute value is more than 30 bytes.

Command Format

at+rsibt_longread=<BDAddress>,<Handle>,<Offset>

Parameters

BDAddress (6 bytes)

Handle (2 bytes)

Offset (2 bytes)

Response

Result CodeDescription
OK ,,Command Success.
ERROR <Error_code>Command Fail.

where ...

NumberOfValues

LongAttValue

Example

Command

at+rsibt_longread=65-65-11-B4-8C-08,10,1

Response

OK 12,0,D9,D9,AA,FD,BD,9B,21,98,A8,49,E1,45,F3,D8,D1,69

[ Go to top ]


rsibt_writevalue :: Set Attribute Value

Description

This is used to Set the attribute value of the connected remote device.

Command Format

at+rsibt_writevalue=<BDAddress>,<Handle>,<Length>,<value>

Parameters

BDAddress (6 bytes)

Handle (2 bytes)

Length (1 byte)

Value (25 bytes)

Response

Result CodeDescription
OKCommand Success.
ERROR <Error_code>Command Fail.

Example

Command

at+rsibt_writevalue=65-65-11-B4-8C-08,34,2,1,0

Response

OK

[ Go to top ]


rsibt_writecmd :: Set Attribute Value No Ack

Description

This is used to Set the attribute value of the connected remote device. If the Attribute value is set using this command, Ack will not be received from the remote device.

Command Format

at+rsibt_writecmd=<BDAddress>,<Handle>,<Length>,<value>

Parameters

BDAddress (6 bytes)

Handle (2 bytes)

Length (1 byte)

Value (25 bytes)

Response

Result CodeDescription
OKCommand Success.
ERROR <Error_code>Command Fail.

Example

Command

at+rsibt_writecmd=65-65-11-B4-8C-08,1,1,2

Response

OK

[ Go to top ]


rsibt_longwrite :: Set Long Attribute Value

Description

This is used to Set the long attribute value of the connected remote device. This is useful when the number of bytes to be set is more than 25 and when particular offset bytes are written.

Command Format

at+rsibt_longwrite=<BDAddress>,<Handle>,<Offset>,<Length>,<value>

Parameters

BDAddress (6 bytes)

Handle (2 bytes)

Offset (2 bytes)

Length (1 byte)

Value (40 bytes)

Response

Result CodeDescription
OKCommand Success.
ERROR <Error_code>Command Fail.

Example

Command

at+rsibt_longwrite=C0-FF-EE-C0-FF-EE,1,1,1,2

Response

OK

[ Go to top ]


rsibt_longwrite :: Set Prepare Long Attribute Value

Description

This is used to Set the Long Attribute value in the connected remote device. When Value is set using this API, the remote device will wait for "Execute Long Attribute Value " to come before updating its handle with its value.

Command Format

at+rsibt_longwrite=<BDAddress>,<Handle>,<Offset>,<Length>,<value>

Parameters

BDAddress (6 bytes)

Handle (2 bytes)

Offset (2 bytes)

Length (1 byte)

Value (40 bytes)

Response

Result CodeDescription
OKCommand Success.
ERROR <Error_code>Command Fail.

Example

Command

at+rsibt_longwrite=C0-FF-EE-C0-FF-EE,1,1,1,2

Response

OK

[ Go to top ]


rsibt_preparewrite :: Set Prepare Long Attribute Value

Description

This is used to Set the Long Attribute value in the connected remote device. When Value is set using this API, the remote device will wait for "Execute Long Attribute Value " to come before updating its handle with its value.

Command Format

at+rsibt_preparewrite=<BDAddress>,<Handle>,<Offset>,<Length>,<Value>

Parameters

BDAddress (6 bytes)

Handle (2 bytes)

Offset (2 bytes)

Length (1 byte)

Value (40 bytes)

Response

Result CodeDescription
OKCommand Success.
ERROR <Error_code>Command Fail.

Example

Command

at+rsibt_preparewrite=B4-99-4C-64-BC-AF,1,1,1,2

Response

OK

[ Go to top ]


rsibt_executewrite :: Execute Long Attribute Value

Description

This is used to send Execute Long Attribute Value to the connected remote device. Depending on the "flag" of this command, the remote device will either set/not set the previously sent Prepare Long Attribute values.

Command Format

at+rsibt_executewrite=<BDAddress>,<Flag>

Parameters

BDAddress (6 bytes)

Flag (1 byte)

Example

Command

at+rsibt_executewrite=C0-FF-EE-C0-FF-EE,1

Response

OK

[ Go to top ]


rsibt_addservice :: Add GATT Service Record

Description

This is used to add the new service Record in the BLE GATT record list. If service is created successfully service record handle is returned, else the error value is returned.

Command Format

at+rsibt_addservice=<uuid_size>,<ServiceUUID>,<NbrAttributes>,<MaxAttDataSize>

Parameters

ServiceUUID

numberAttributes (2 bytes)

MaxAttDataSize (2 bytes)

Response

Result CodeDescription
OK,,Command Success.
ERROR <Error_code>Command Fail.

where ...

ServiceHndlerPtr

StartHndl (2 bytes)

Example

Command

at+rsibt_addservice=2,18ff,3,30

Response

OK 157A8,A

rsibt_addattribute :: Add Attribute Record

Description

This is used to add the attribute record to the specific service using the service record handle. The is used to add characteristic declaration and characteristic definition of the record.

Command Format

at+rsibt_addattribute=<ServiceHndlerPtr>,<Hndl>,<AttUUIDsize>,<AttUUID>,<prop>,<DataLen>,<ConfigBitmap>,<Data>

Parameters

ServiceHndlerPtr

Hndl (2 bytes)

AttUUID

Prop (1 byte)

DataLen (2 bytes)

Data (max 20 bytes)

ConfigBitmap

Response

Result CodeDescription
OKCommand Success.
ERROR <Error_code>Command Fail.

Example

Command

at+rsibt_addattribute=157A8,A,2,2A02,2,9,0,1,2,3,4,5,6,7,8,0

Response

OK

Example

Creation of a service UUID (AABB) with a Characteristic UUID = 1BB1 and a notify property.

-- Service creation
at+rsibt_addservice=2,AABB,3,30
uuid_size           = 2
ServiceUUID         = 180A
NbrAttributes       = 3
MaxAttDataSize      = 30

-- Characteristic declaration; the data contains information about the definition in the format: <Prop (001A), Handle (000B), UUID (1BB1)>
at+rsibt_addattribute=157A8,A,2,2803,8,6,0,1A,0,0E,00,B1,1B 
ServiceHndlerPtr    = 157A8
Hndl                = A
AttUUIDsize         = 2
AttUUID             = 2803
prop                = 8
DataLen             = 6
ConfigBitmap        = 0
Data                = 1A,0,0B,00,B1,1B

-- Characteristic definition; the data is the actual Characteristic Value
at+rsibt_addattribute=157A8,B,2,1BB1,1A,a,0,1,2,3,4,5,6,7,8,9,0
ServiceHndlerPtr    = 157A8
Hndl                = B
AttUUIDsize         = 2
AttUUID             = 1BB1
prop                = 1A
DataLen             = a
ConfigBitmap        = 0
Data                = 1,2,3,4,5,6,7,8,9,0

-- Client Characteristic Configuration Descriptor (CCCD)
at+rsibt_addattribute=157A8,C,2,2902,A,2,0,0,0
ServiceHndlerPtr    = 157A8
Hndl                = C
AttUUIDsize         = 2
AttUUID             = 2902
prop                = A
DataLen             = 2
ConfigBitmap        = 0
Data                = 0,0

[ Go to top ]


rsibt_setlocalattvalue :: Set Local Attribute Value

Description

This is used to set/change the local attribute record value to the specific service using the service record handle.

Command Format

at+rsibt_setlocalattvalue=<Hndl>,<DataLen>,<Data>

Parameters

Hndl (2 bytes)

DataLen (2 bytes)

Data (31 bytes)

Response

Result CodeDescription
OKCommand Success.
ERROR <Error_code>Command Fail.

Example

Command

at+rsibt_setlocalattvalue=A,1,EE

Response

OK

[ Go to top ]


rsibt_getlocalattvalue :: Get Local Attribute Value

Description

This is used to read the local attribute record value to the specific service using the service record handle.

Command Foramt

at+rsibt_getlocalattvalue=<Hndl>

Parameters

Hndl (2 bytes)

Response

Result CodeDescription
OK ,,<data_len>,Command Success
ERROR <Error_code>Command Fail

Parameters

Hndl (2 bytes)

DataLen (2 bytes)

Data (31 bytes)

Example

Command

at+rsibt_getlocalattvalue=A

Response

OK A,1,EE

[ Go to top ]


rsibt_readresp :: Send Read Response

Description

Send the response for the read request received from the remote device. Use this command only when the attribute record is maintained in the host.

Command Format

at+rsibt_readresp=<bd_address>,<read_type>,<data_len>,<data>

Parameters

bd_address

read_type

data_len

data

Response

Result CodeDescription
OKCommand Success
ERROR <Error_code>Command Fail

Example

Command

at+rsibt_readresp=62-CB-12-9D-CA-F2,0,2,1,2

Response

OK

[ Go to top ]


rsibt_writeresponse :: Write Response

Description

Sends write response ACK to the server/remote device when a valid request is received. Use this command only when the attribute record is maintained in the host.

Command Format

at+rsibt_writeresponse=<bdaddress>,<type>

Parameters

bd_address

type

Response

Result CodeDescription
OKCommand Success
ERROR <Error_code>Command Fail

Example

Command

at+rsibt_writeresponse=62-CB-12-9D-CA-F2,1

Response

OK

[ Go to top ]


rsibt_preparewriteresponse :: Prepare Write Response

Description

Sent in response to a received Prepare Write Request to acknowledge that the value has been successfully received and placed in the prepare write queue. Use this command only when the attribute record is maintained in the host.

Command Format

at+rsibt_preparewriteresponse=<p_remote_addr>,<handle>,<offset>,<data_len>,<data>

Parameters

p_remote_addr

handle (2 bytes)

offset (2 bytes)

data_len (1 byte)

data (40 bytes)

Response

Result CodeDescription
OKCommand Success
ERROR <Error_code>Command Fail

Example

Command

at+rsibt_preparewriteresponse=6C-27-39-31-9C-D6,E,0,14,1,2,3,4,5,6,7,8,9,10,1,2,3,4

Response

OK

[ Go to top ]


rsibt_sendnotify :: Send Notify

Description

This command will be used to send notification events to the specific remote device. Use this command only when the attribute record is maintained in the host.

Command Format

at+rsibt_sendnotify=<bd_address>,<handle>,<data_len>,<data>

Parameters

bd_address

handle

data_len

data

Response

Result CodeDescription
OKCommand Success
ERROR <Error_code>Command Fail

Example

Command

at+rsibt_sendnotify=62-CB-12-9D-CA-F2,A,2,1,0

Response

OK

[ Go to top ]


rsibt_sendindicate :: Send Indicate

Description

This command will be used to send indication events to the specific remote device. Use this command only when the attribute record is maintained in the host.

Command Format

at+rsibt_sendindicate=<bd_address>,<handle>,<data_len>,<data>

Parameters

bd_address

handle

data_len

data

Response

Result CodeDescription
OKCommand Success
ERROR <Error_code>Command Fail

Example

Command

at+rsibt_sendindicate=62-CB-12-9D-CA-F2,A,2,1,0

Response

OK

[ Go to top ]


rsibt_removeservice :: Remove Service

Description

This command is used to remove the service from the profile.

Command Format

at+rsibt_removeservice=<Servicehandlerptr>

Parameters

ServiceHndlerPtr

Example

Command

at+rsibt_removeservice=157A8

Response OK

[ Go to top ]


rsibt_removeattribute :: Remove Attribute

Description

This command is used to remove an attribute.

Command Format

at+rsibt_removeattribute=<Servicehandlerptr>,<AttHandle>

Parameters

ServiceHndlerPtr

AttHandle (2 bytes)

Example

Command

at+rsibt_removeattribute=157A8,10

Response

OK

[ Go to top ]


Advertise Report Event

Description

This event indicates the remote device's Advertisement. It comes when scan is enabled in the local device.

Event Format

AT+RSIBT_ADVRTISE,<addr_type>,<bd_addr>,<RSSI>,<Type>,<adv_data_len>,<adv_data>

where ... addr_type (1 byte)

bd_addr (6 bytes)

RSSI (1 byte)

adv_data_len (1 byte)

adv_data (31 bytes)

type(1 byte)

Example

In this example

[ Go to top ]


LE Connected Event

Description

This event indicates either the connection is Success or not, when 9113 compatible features BIT[30] is set from ble_custom_feature_bit_map in opermode.

Event Format

AT+RSIBT_LE_DEVICE_CONNECTED=<addr_type>,<bd_addr>,<status>

where ...

addr_type (1 byte)

bd_addr (6 bytes)

status (1 byte)

Example

AT+RSIBT_LE_DEVICE_CONNECTED=0,B4-99-4C-64-BE-F5,0

[ Go to top ]


Disconnected Event

Description

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

Event Format

AT+RSIBT_LE_DISCONNECTED <bd_addr>,<error>

where ...

bd_addr (6 bytes)

error (4 bytes)

Example

AT+RSIBT_LE_DISCONNECTED 62-CB-12-9D-CA-F2,4E13

[ Go to top ]


SMP Request Event

Description

This event is raised when the SMP Request comes from the connected remote device. Upon reception of this event SMP Response command has to be given.

Event Format

AT+RSIBT_SMP_REQUEST <bd_addr>

where ...

bd_addr (6 bytes)

Example

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

[ Go to top ]


SMP Response Event

Description

This event is raised when the SMP Response comes from the connected remote device. Upon reception of this event SMP Passkey command has to be given.

Event Format

AT+RSIBT_SMP_RESPONSE <bd_addr>

Parameters

bd_addr (6 bytes)

Example

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

[ Go to top ]


SMP Passkey Event

Description

This event is raised when the SMP Passkey comes from the connected remote device. Upon reception of this event SMP Passkey command has to be given.

Event Format

AT+RSIBT_SMPPASSKEY <bd_addr>

where ...

bd_addr (6 bytes)

Example

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

[ Go to top ]


SMP Failed Event

Description

This event is raised when the SMP exchange fails. The reason for failure would be present in the Descriptor frame.

Event Format

AT+RSIBT_SMP_FAILED,<bd_addr>,<error>

Parameters

bd_addr (6 bytes)

error (4 bytes)

Example

AT+RSIBT_SMP_FAILED ,AA-BB-CC-DD-EE-FF,4B01

[ Go to top ]


SMP Encrypt Enabled Event

Description

This event is raised when the encryption gets started. If some problem occurs in starting the encryption, an error code will be sent in this event.

Event Format

AT+RSIBT_ENCRYPTION_ENABLED <bd_addr>,<local_ediv>,<local_rand>,<local_ltk>
AT+RSIBT_ENCRYPTION_DISABLED

where ... bd_addr (6 bytes)

local_ediv (2 bytes)

local_rand (8 bytes)

local_ltk (16 bytes)

Example

AT+RSIBT_ENCRYPTION_ENABLED 88-DA-1A-9E-81-87,[Local EDIV=]1FFF,[Local RAND=]71,80,0,BF,0,0,C0,1[Local LTK=]63,63,6D,45,62,55,81,9D,A4,22,8E,69,CA,77,7F,B0         

[ Go to top ]


LE MTU Size Event

Description

This event is raised after LE connection.

Event Format

AT+RSIBT_LE_REMOTE_MTU_SIZE ,<bd_addr>,<mtu_size>

Parameters

bd_addr (6 bytes)

MTU_size (2 bytes)

Example

AT+RSIBT_LE_REMOTE_MTU_SIZE 00-1A-7D-34-54-66,64

[ Go to top ]


LE MTU Exchange Info Event

Description

This event is triggered when:

Event Format

AT+RSIBT_LE_MTU_EXCHANGE_INFORMATION <remote_dev_addr>,<remote_mtu_size>,<local_mtu_size>,<initiated_role>

Parameters

bd_addr (6 bytes)

Remote_MTU_size (2 bytes)

Local_MTU_size (2 bytes)

Initiated_role (1 byte)

Example

AT+RSIBT_LE_MTU_EXCHANGE_INFORMATION 6C-F2-1B-3E-BF-50,FA,F0,1

[ Go to top ]


SMP Passkey Display Event

Description

This event is raised when the SMP Passkey comes from the connected remote device. If IO_Capability request in SMP Passkey Request is DISPLAY_ONLY then only this event occurs.

Upon reception of this event SMP Passkey command is not required.

Event Format

AT+RSIBT_SMPPASSKEY_DISPLAY <bd_addr>,<Passkey>

whnere ...

bd_addr (6 bytes)

Passkey (4 bytes)

Example

AT+RSIBT_SMP_PASSKEY_DISPLAY AA-BB-CC-DD-EE-FF,123456

Note!

If IO_Capability request as DISPLAY_ONLY in both sides then SMP will won't work.

[ Go to top ]


Phy Update Event

Description

The LE PHY Update Complete Event is used to indicate that the Controller has changed the transmitter PHY or receiver PHY in use.

Event Format

AT+RSIBT_LE_PHY_UPDATE_COMPLETE =<bd_addr>,<status>,<Tx_phy><Rx_phy>

where ...

bd_addr (6 bytes)

status (1 byte)

Tx_phy(1 byte)

Rx_phy (1 byte)

Example

AT+RSIBT_ LE_PHY_UPDATE_COMPLETE =B4-99-4C-64-BE-F5,0,2,1

[ Go to top ]


BLE Data Length Change Event

Description

The LE Data Length Change event notifies the Host of a change to either the maximum Payload length or the maximum transmission time of packets in either direction.

Event Format

AT+RSIBT_LE_DATA_LENGTH_CHANGE_EVENT <BDAddress><MaxTxOctets>,<MaxTxTime>,<MaxRxOctets><MaxRxTime>

where ...

BDAddress (6 bytes)

MaxTxOctets (2 bytes)

MaxTxTime (2 bytes)

MaxRxOctets (2 bytes)

MaxRxTime (2 bytes)

Example

AT+RSIBT_LE_DATA_LENGTH_UPDATE 00-23-A7-12-23-24,40,330,50,320

[ Go to top ]


SMP Secure connection Passkey Event

Description

This event is raised when the SMP Secure connection Passkey comes from the connected remote device. Upon reception of this event SMP Passkey command has to be given.

Event Format

AT+RSIBT_LE_SC_PASSKEY = <bd_addr>,<passkey>

where ...

bd_addr (6 bytes)

Passkey (4 bytes)

Example

AT+RSIBT_LE_SC_PASSKEY 00-23-A7-12-23-24,435622

[ Go to top ]

LE Directed Advertising Report Event

Description

The LE Directed Advertising Report event indicates that directed advertisements have been received.

Event Format

AT+RSIBT_LE_DIRECTED_ADV_REPORT <AddressType>,<Address>,<DirectedAddressType>,<DirectedAddress>,<Rssi>

where ...

AddressType (1 byte)

BDAddress (18 bytes)

DirectedAddressType (1 byte)

DirectedAddress (18 bytes)

Rssi (1 byte)

Example

AT+RSIBT_LE_DIRECTED_ADV_REPORT 1,00-23-A7-12-23-24,1,00-23-A7-12-23-24,21

[ Go to top ]

Enhanced connection Complete Event

Description

Enhanced connection Complete Event indicates both of the hosts forming a connection that a new connection has been established.

Event Format

AT+RSIBT_LE_DEVICE_ENHANCE_CONNECTED=<addr_type>,<bd_addr>,<status>,<LocalResolvableAddr>,<PeerResolvableAddr>

where ...

addr_type

BDAddress

Status

LocalResolvableAddr

PeerResolvableAddr

Example

AT+RSIBT_LE_DEVICE_ENHANCE_CONNECTED=0,B4-99-4C-64-BE-F5,0,74-99-4C-64-BB-F5,48-99-4C-64-BE-F5

[ Go to top ]

LE LTK Request Event

Description

This event is raised when the LE long-term key of the local device is requested by its LE controller.

Event Format

AT+RSIBT_LTK_REQUEST <bd_addr>,<LocalEDIV>,<LocalRand>

where ... bd_addr

LocalEDIV (2 bytes)

LocalRand (8 bytes)

Example

AT+RSIBT_LTK_REQUEST 68-13-4C-69-1E-90, Local EDIV: F259, Local RAND: 21,A4,B2,86,F5,10,52,59

[ Go to top ]


LE Security Keys Event

Description

This event is raised after encryption enabled with the remote device.

Event Format

AT+RSIBT_ <LocalIRK>,<RemoteIRK>,<RemoteEDIV>,<RemoteRand>,<RemoteLTK>,<Remote Identity Address Type>,<Remote Identity Address>

where ...

BDAddress (6 bytes)

LocalIRK (16 bytes)

RemoteIRK (16 bytes)

RemoteEDIV (2 bytes)

RemoteRand (16 bytes)

RemoteLTK (16 bytes)

IdentityAddressType (1 byte)

IdentityAddress (6 bytes)

Example

AT+RSIBT_ local IRK:9D,9,A5,B,E9,97,3C,15,C2,34,AE,EB,5F,8E,74,D
Remote IRK:49,7D,83,E6,19,2A,2,60,8E,9B,37,3D,3C,D7,E0,6B
Remote EDIV:0
Remote RAND:0,0,0,0,0,0,0,0
Remote LTK:0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0
Remote Identity Address Type:0,
Remote Identity Address:34-82-C5-34-1D-30,

[ Go to top ]


Conn Update Event

Description

The LE CONN Update Complete Event is used to indicate that the Controller has changed the connection parameter.

Event Format

AT+RSIBT_LE_CONN_UPDATE_COMPLETE <BDAddress>,<status>,<Conn_Interval>,<Conn_Latency>,<Supervision_Timeout>

where ...

bd_addr (6 bytes)

status (1 byte)

Conn_Interval (2 bytes)

Conn_Latency (2 bytes)

Supervision_Timeout (2 bytes)

Example

AT+RSIBT_LE_CONN_UPDATE_COMPLETE 00-1A-7D-DA-71-13,0,6,0,C80

[ Go to top ]

GATT Notification

Description

This event is raised when the GATT Notification packet is received from the connected remote device.

Event Format

AT+RSIBT_NOTIFY,<bd_addr>,<handle>,<length>,<value>

where ...

bd_addr (6 bytes)

handle (2 bytes)

length (1 byte)

value (50 bytes)


Note!


Example

In this example

[ Go to top ]


GATT Indication

Description

This event is raised when the GATT Indication packet is received from the connected remote device.

Event Format

AT+RSIBT_INDICATION,<bd_addr>,<handle + pkt_type>,<length>,<value>

where ...

bd_addr (6 bytes)

handle (2 bytes)

length (1 byte)

value (50 bytes)


Note!


Example

In this example

[ Go to top ]


GATT Write

Description

This event is raised when GATT write packet is received from the connected remote device.

Event Format

AT+RSIBT_WRITE,<bd_addr>,<handle>,<length>,<value>

where ...

bd_addr (6 bytes)

handle (2 bytes)

length (1 byte)

value (50 bytes)


Note!

Example

In this example

[ Go to top ]


Prepare Write Event

Description

This event is raised when prepare write packet is received from the connected remote device.

Event Format

AT+RSIBT_PREPARE_WRITE_REQ,<bd_addr>,<handle>,<offset>,<length>,<value>

bd_addr (6 bytes)

handle (2 bytes)

length (1 byte)

value (50 bytes)

Example

AT+RSIBT_PREPARE_WRITE_REQ 6C-27-39-31-9C-D6,E,0,14,1,2,3,4,5,6,7,8,9,10,1,2,3,4

[ Go to top ]


GATT Read

Description

This event is raised when a read request is received from the connected remote device. In BLE mode, enable BT mode.

Event Format

AT+RSIBT_READ_REQ,<bd_addr>,<handle>

where ...

bd_addr (6 bytes)

handle (2 bytes)

[ Go to top ]


GATT Read Blob

Description

This event is raised when a read blob request is received from the connected remote device. In BLE mode, enable BT mode.

Event Format

AT+RSIBT_READ_BLOB_REQ,<bd_addr>,<handle>,<offset>

where ...

bd_addr (6 bytes)

handle (2 bytes)

offset (2 bytes)


Note!

ext_custom_feature_bit_map gets enabled when 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>

ext_tcp_ip_feature_bit_map gets enabled when 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>

bt_feature_bit_map gets enabled when BIT(31) is set to ‘1’ in both custom_feature_bit_map and ext_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_feature_bit_map>

ble_custom_feature_bit_map gets enabled when BIT(31) is set to 1 in custom_feature_bitmap, ext_custom_feature_bit_map and 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_custom_feature_bit_map>

ble_custom_ext_feature_bit_map gets enable when 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_feature_bit_map>,<ext_tcp_ip_feature_bit_map>,<ble_custom_feature_bit_map>,<ble_custom_ext_feature_bit_map>

config_feature_bit_map gets enabled when 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_feature_bit_map>,<ext_tcp_ip_feature_bit_map>,<ble_custom_feature_bit_map>,<ble_custom_ext_feature_bit_map>,<config_feature_bit_map>

ext_custom_feature_bit_map gets enabled when 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>

ext_tcp_ip_feature_bit_map gets enabled when 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>

bt_feature_bit_map gets enabled when BIT(31) is set to ‘1’ in both custom_feature_bit_map and ext_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_feature_bit_map>

ble_custom_feature_bit_map gets enabled when BIT(31) is set to 1 in custom_feature_bitmap,ext_custom_feature_bit_map and 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_custom_feature_bit_map>

ble_custom_ext_feature_bit_map gets enable when 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_feature_bit_map>,<ext_tcp_ip_feature_bit_map>,<ble_custom_feature_bit_map>,<ble_custom_ext_feature_bit_map>

config_feature_bit_map gets enabled when 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_feature_bit_map>,<ext_tcp_ip_feature_bit_map>,<ble_custom_feature_bit_map>,<ble_custom_ext_feature_bit_map>,<config_feature_bit_map>