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

Group AT Command API Description
Common API's
rsi_opermode Set Operating Mode
rsibt_setlocalname Set Local Name
rsibt_getlocalname Query Local Name
rsibt_getrssi Query RSSI
rsibt_getlocalbdaddr Query Local BD Address
rsibt_getbtstackversion Query BT Stack Version
rsibt_updategaintableoffsetMaxpower Update Gain Table Offset and MaxPower
rsibt_btantennaselect BT Antenna Select
rsibt_setantennatxpowerlevel Set Antenna Tx Power Level
rsibt_btinit Initialize BLE Module
rsibt_btdeinit Deinitialize BLE Module
PER API's
rsibt_bletransmit BLE PER Transmit
rsibt_blereceive BLE PER Receive
rsibt_perstats PER Stats
rsibt_percwmode PER CW Mode
BLE test mode API's
rsibt_enhancedrxtest LE Enhanced Receiver Test Mode
rsibt_enhancedtxtest LE Enhanced Transmitter Test Mode
rsibt_endtest LE Enhanced End Test Mode
BLE GAP API's
rsibt_advertise Advertise Local Device
rsibt_connect Connect
rsibt_setresolutionenable BLE SetResolution Enable
rsibt_scan Scan
rsibt_disconnect Disconnect
rsibt_getdevstate Query Device State
rsibt_startencrypt Start Encryption
rsibt_setadvertisedata BLE Set Advertise Data
rsibt_setscanrspdata BLE Set scan Response Data
rsibt_setrandadd BLE Set Random Device Address
rsibt_lewhitelist BLE Whitelist
rsibt_setphy BLE Set Phy Command
rsibt_readphy BLE Read Phy Command
rsibt_setdatalength BLE Set Data Length Command
rsibt_readdatalength BLE Read Maximum Data Length Command
rsibt_resolvlist BLE Resolve List
getresolvlistsize BLE GetResolvlist Size
rsibt_setprivacymode BLE SetPrivacy Mode
rsibt_updateparams BLE connection Update Command
rsibt_leltkreqreply LE LTK Request-Reply
BLE SMP API's
rsibt_smpreq SMP Pair Request
rsibt_smpresp SMP Response
rsibt_smppasskey SMP Passkey
BLE GATT API's
rsibt_getcharservices Query Characteristic Services
at+rsibt_blesetmtu BLE Set MTU Size Command
rsibt_mtuexchangeresp LE MTU Exchange Resp
rsibt_getallprofiles Query Profiles List
rsibt_getprofile Query Profile
rsibt_getincservices Query Include Services
rsibt_readbytype Read Characteristic Value By UUID
rsibt_getdescriptors Query Attribute
rsibt_readvalue Query Attribute Value
rsibt_readmultiple LE Read Multiple
rsibt_longread Query Long Attribute Value
rsibt_writevalue Set Attribute Value
rsibt_writecmd Set Attribute Value No Ack
rsibt_longwrite Set Long Attribute Value
rsibt_preparewrite Set Prepare Long Attribute Value
rsibt_executewrite Execute Long Attribute Value
BLE GATT - Server API's
rsibt_sendnotify Send Notify
rsibt_addservice Add GATT Service Record
rsibt_addattribute Add Attribute Record
rsibt_setlocalattvalue Set Local Attribute Value
rsibt_getlocalattvalue Get Local Attribute Value
rsibt_readresp Send Read Response
rsibt_writeresponse Write Response
rsibt_preparewriteresponse Prepare Write Response
rsibt_sendindicate Send Indicate
rsibt_removeservice Remove Service
rsibt_removeattribute Remove 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 bitmap Functionality Set to 0 Set to 1 Notes
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. Disable Enable
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. Disable Enable
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 Code Description
OK Success
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
coex_mode Description
0 WLAN
2 Zigbee
3 WLAN + Zigbee
4 Bluetooth
5 WLAN + Bluetooth
6 Bluetooth + Zigbee co-existence
7 WLAN + Bluetooth + Zigbee co-existence
8 Dual Mode (Bluetooth and BLE)
9 WLAN + Dual Mode
10 Dual Mode + Zigbee co-existence
11 WLAN + Dual Mode + Zigbee co-existence
12 BLE mode
13 WLAN + BLE
14 BLE and Zigbee co-existence

[ 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 Code Description
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 Code Description
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 Code Description
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 Code Description
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>,
                   };
Value Region
0 FCC
1 ETSI
2 TELEC
4 KCC
3 WORLDWIDE

Response

Result Code Description
OK Success 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 Code Description
OK Command 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 Code Description
OK Command 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.

Channel Center Freq (MHz)
0 2402
1 2404
2 2406
3 2408
4 2410
5 2412
6 2414
7 2416
8 2418
9 2420
10 2422
11 2424
12 2426
13 2428
14 2430
15 2432
16 2434
17 2436
18 2438
19 2440
20 2442
21 2444
22 2446
23 2448
24 2450
25 2452
26 2454
27 2456
28 2458
29 2460
30 2462
31 2464
32 2466
33 2468
34 2470
35 2472
36 2474
37 2476
38 2478
39 2480

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

State Description
0x80 connectable undirected
0x81 connectable directed with high duty cycle
0x82 scannable undirected
0x83 Non connectable undirected
0x84 connectable directed with low duty cycle

FilterType (1 byte)

Filter type Description
0 Allow scan Request from Any, Allow connect Request from Any.
1 Allow scan Request from White List Only, Allow connect Request from Any.
2 Allow scan Request from Any, Allow connect Request from White List Only.
3 Allow 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)

Value Parameter Description
00000000b Reserved for future use
xxxxxxx1b Enable channel 37 use
xxxxxx1xb Enable channel 38 use
xxxxx1xxb Enable channel 39 use
00000111b Default (all channels enabled)

Response

Result Code Description
OK Command 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 Code Description
OK Command 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 Code Description
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 Code Description
OK Command 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 Code Description
OK Command 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 Code Description
OK Command 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 Code Description
OK Command 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 Code Description
OK Command 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 Code Description
OK Command 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 Code Description
OK Command 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 Index Tx Power Mode
1 - 31 BLE - 0dBm Mode
33 - 63 BLE - 10 dBm Mode
64 - 75 BLE - 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 Code Description
OK Command 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 Code Description
OK Command 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 Code Description
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 Code Description
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 Code Description
OK Command 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 Code Description
OK Command 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 Code Description
OK Command 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 Code Description
OK Command 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 Code Description
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 Code Description
OK Command 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 Code Description
OK , , , , Command Success.
ERROR <Error_code> Command Fail.

where ...

Parameter Description

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 Code Description
OK Command Success
ERROR_CODE Command 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 Code Description
OK, Command Success
ERROR_CODE Command 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 Code Description
OK Command Success
ERROR_CODE Command 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 Code Description
OK Command Success
ERROR_CODE Command 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 Code Description
OK Command Success
ERROR_CODE Command 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 Code Description
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 Code Description
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 Code Description
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 Code Description
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 Code Description
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 Code Description
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 Code Description
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 Code Description
OK Command 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 Code Description
OK Command 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 Code Description
OK Command 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 Code Description
OK Command 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 Code Description
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 Code Description
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 Code Description
OK Command 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 Code Description
OK Command 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 Code Description
OK Command 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 Code Description
OK Command 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 Code Description
OK Command 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 Code Description
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 Code Description
OK Command 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 Code Description
OK Command 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 Code Description
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 Code Description
OK Command 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 Code Description
OK Command 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 Code Description
OK Command 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 Code Description
OK Command 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 Code Description
OK Command 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>