Silicon Labs RS9113 User Manual
RS9113 WiSeConnectTM
BBlluueettooootthh CCllaassssiicc SSooffttwwaarree PPrrooggrraammmmiinngg RReeffeerreennccee
MMaannuuaall
VVeerrssiioonn 11..77..99
MMaayy 22002200
silabs.com | Building a more connected world.
RRSS99111133--WWiiSSeeCCoonnnneecct
t
TTM
M
BBlluueettooootthh CCllaassssiicc SSooffttwwaarree PPrrooggrraammmmiinngg RReeffeerreennccee
MMaannuuaall
VVeerrssiioonn 11..77..99
About this Document
This document describes the commands to operate the RS9113-WiSeConnect Module Family for
Bluetooth. Bluetooth stack is used for Host layers and the commands describe various profiles supported
by Bluetooth stack. This document should be used by the developer to write software on Host MCU to
control and operate the module.
silabs.com | Building a more connected world. Page 3
RRSS99111133--WWiiSSeeCCoonnnneecct
t
TTM
M
BBlluueettooootthh CCllaassssiicc SSooffttwwaarree PPrrooggrraammmmiinngg RReeffeerreennccee
MMaannuuaall
VVeerrssiioonn 11..77..99
Table Of Contents
1 Overview ........................................................................... 11
1.1 Bluetooth Software Programming ......................................11
1.2 Bluetooth Software Architecture ........................................11
1.2.1 Profiles ......................................................................................... 11
1.2.2 Bluetooth Core .............................................................................. 11
1.2.3 L2CAP .......................................................................................... 11
1.2.4 OS Abstraction Layer ..................................................................... 12
1.3 Bluetooth Command Format ...............................................12
1.4 Interfaces ..........................................................................17
1.4.1 UART ........................................................................................... 18
Features ............................................................................................... 18
Default Parameters ................................................................................ 18
1.4.2 USB ............................................................................................. 18
Features ............................................................................................... 18
1.4.3 SPI .............................................................................................. 19
Features ............................................................................................... 19
Communication through SPI .................................................................... 19
SPI Settings .......................................................................................... 19
Interrupt............................................................................................... 19
1.5 Bluetooth Classic commands ............................................................20
1.5.1 Generic commands ............................................................................. 20
1.5.1.1 Set Operating Mode.................................................................. 20
1.5.1.2 Set Local name ........................................................................ 30
1.5.1.3 Query Local name .................................................................... 30
1.5.1.4 Set Local COD ......................................................................... 31
1.5.1.5 Query Local COD ...................................................................... 31
1.5.1.6 Query RSSI ............................................................................. 32
1.5.1.7 Query Link Quality ................................................................... 32
1.5.1.8 Query Local BD Address ............................................................ 33
1.5.1.9 Initialize BT module .................................................................. 33
1.5.1.10 Deinitialize BT module ............................................................. 34
1.5.1.11 BT Antenna Select................................................................... 34
1.5.1.12 Set Feature Bitmap ................................................................. 35
1.5.1.13 Set Antenna Tx power level ...................................................... 35
1.5.2 Core commands................................................................................. 36
1.5.2.1 Set Profile Mode ....................................................................... 36
1.5.2.2 Set Device Discovery mode ....................................................... 37
1.5.2.3 Get Device Discovery mode ....................................................... 37
1.5.2.4 Set Connectability mode ........................................................... 38
1.5.2.5 Get Connectablility mode .......................................................... 38
1.5.2.6 Set Pair mode .......................................................................... 39
1.5.2.7 Get Pair mode ............................................................................. 39
1.5.2.8 Remote Name Request ............................................................. 40
1.5.2.9 Remote Name Request Cancel ................................................... 41
1.5.2.10 Inquiry .................................................................................. 41
1.5.2.11 Inquiry Cancel ........................................................................ 42
1.5.2.12 Extended Inquiry Response Data .............................................. 42
1.5.2.13 Bond or Create Connection ....................................................... 43
silabs.com | Building a more connected world. Page 4
RRSS99111133--WWiiSSeeCCoonnnneecct
t
TTM
M
BBlluueettooootthh CCllaassssiicc SSooffttwwaarree PPrrooggrraammmmiinngg RReeffeerreennccee
MMaannuuaall
VVeerrssiioonn 11..77..99
1.5.2.14 Bond Cancel or Create Connection Cancel .................................. 44
1.5.2.15 UnBond or Disconnect ............................................................ 44
1.5.2.16 Set Pin type ........................................................................... 45
1.5.2.17 Get Pin type ........................................................................... 45
1.5.2.18 User confirmation ................................................................... 46
1.5.2.19 Pass key Request Reply ........................................................... 46
1.5.2.20 Pincode Request Reply............................................................. 47
1.5.2.21 Get Local Device Role .............................................................. 47
1.5.2.22 Set Local Device Role or switch the role ..................................... 48
1.5.2.23 Get Service List ...................................................................... 49
1.5.2.24 Search Service ....................................................................... 50
1.5.2.25 Linkkey Reply ......................................................................... 50
1.5.2.26 Set SSP mode ........................................................................ 51
1.5.2.27 Sniff Mode ............................................................................. 52
1.5.2.28 Sniff Exit ................................................................................ 52
1.5.2.29 Sniff Subrating ....................................................................... 53
1.5.3 SPP Commands ............................................................................. 54
1.5.3.1 SPP Connect ............................................................................ 54
1.5.3.2 SPP Disconnect ........................................................................ 54
1.5.3.3 SPP Transfer............................................................................ 55
1.5.4 Power Save................................................................................... 55
1.5.4.1 Power save Operations ............................................................. 55
1.5.4.1.1 Power save Mode 0 ............................................................. 56
1.5.4.1.2 Power Save Mode 2 (GPIO based mode): ............................... 56
1.5.4.1.3 Power Save Mode 3 (Message based mode): .......................... 56
1.5.4.1.4 Power Save Mode 8 (GPIO based mode): ............................... 56
1.5.4.1.5 Power Save Mode 9 (Message based mode): .......................... 57
1.5.5 IAP commands .............................................................................. 57
1.5.5.1 IAP connect ............................................................................. 57
1.5.5.2 IAP Disconnect ........................................................................ 58
1.5.5.3 IAP Set Accessory Information ................................................... 58
1.5.5.4 IAP Find Protocol Type .............................................................. 59
1.5.5.5 IAP Set Protocol Type ............................................................... 60
1.5.5.6 IAP Set Application Protocol Information ..................................... 61
1.5.5.7 IAP1 Identification.................................................................... 62
1.5.5.8 IAP1 Apple Device Authentication ............................................... 63
1.5.5.9 Set Assistive Touch .................................................................. 63
1.5.5.10 Set Voice Over ....................................................................... 64
1.5.5.11 IAP1 Get Ipod Info (Name, SW version, serial number) ............... 65
1.5.5.12 IAP1 Set Extended Interface Mode (ON/OFF) .............................. 65
1.5.5.13 IAP1 Get Lingo Protocol Version ................................................ 66
1.5.5.14 IAP1 Set Ipod Preferences........................................................ 67
1.5.5.15 IAP1 Get Ipod Preferences ....................................................... 68
1.5.5.16 IAP1 Set UI Mode.................................................................... 69
1.5.5.17 IAP1 Get UI Mode ................................................................... 69
1.5.5.18 IAP1 Set Event Notification ...................................................... 70
1.5.5.19 IAP1 Get Event Notification ...................................................... 71
1.5.5.20 IAP1 Get Supported Event Notification ....................................... 72
1.5.5.21 IAP1 Launch Application........................................................... 73
1.5.5.22 IAP1 Get Localization Info ........................................................ 73
1.5.5.23 IAP1 Application Data Session Acknowledgment ......................... 74
1.5.5.24 IAP1 Application Accessory Data Transfer .................................. 75
silabs.com | Building a more connected world. Page 5
RRSS99111133--WWiiSSeeCCoonnnneecct
t
TTM
M
BBlluueettooootthh CCllaassssiicc SSooffttwwaarree PPrrooggrraammmmiinngg RReeffeerreennccee
MMaannuuaall
VVeerrssiioonn 11..77..99
1.5.5.25 IAP1 Get Voice Over Parameter ................................................ 75
1.5.5.26 IAP1 Set VoiceOver Parameter.................................................. 76
1.5.5.27 IAP1 Set VoiceOver Context ..................................................... 77
1.5.5.28 IAP1 VoiceOver Event .............................................................. 78
1.5.5.29 IAP1 VoiceOver Text Event ....................................................... 79
1.5.5.30 IAP1 VoiceOver Touch Event .................................................... 79
1.5.5.31 IAP1 Current VoiceOver Value .................................................. 80
1.5.5.32 IAP1 Current VoiceOver Hint .................................................... 81
1.5.5.33 IAP1 Current VoiceOver Trait .................................................... 81
1.5.5.34 IAP1 iPod Out Button ............................................................... 82
1.5.5.35 IAP1 Video Button ................................................................... 83
1.5.5.36 IAP1 Audio Button ................................................................... 84
1.5.5.37 IAP1 Context Button ................................................................ 85
1.5.5.38 IAP1 Radio Button ................................................................... 86
1.5.5.39 IAP1 Camera Button ................................................................ 87
1.5.5.40 IAP1 Rotation Input................................................................. 87
1.5.5.41 IAP1 Register HID Report Descriptor ......................................... 88
1.5.5.42 IAP1 Send HID Report ............................................................. 89
1.5.5.43 IAP1 Unregister HID Report Descriptor ...................................... 90
1.5.6 Core events .................................................................................. 91
1.5.6.1 Role change status ................................................................... 91
1.5.6.2 Unbond or Disconnect status ..................................................... 91
1.5.6.3 Bond Response ........................................................................ 92
1.5.6.4 Inquiry response ...................................................................... 92
1.5.6.5 Remote device name ................................................................ 93
1.5.6.6 Disconnected ........................................................................... 93
1.5.6.7 User confirmation Request ........................................................ 94
1.5.6.8 User passkey display ................................................................ 94
1.5.6.9 User pincode request ............................................................... 95
1.5.6.10 User passkey request .............................................................. 95
1.5.6.11 Inquiry complete .................................................................... 95
1.5.6.12 Auth complete ........................................................................ 95
1.5.6.13 User linkkey Request ............................................................... 96
1.5.6.14 User linkkey save .................................................................... 96
1.5.6.15 SSP Enable ............................................................................ 96
1.5.6.16 Mode change .......................................................................... 97
1.5.6.17 Sniff subrating ........................................................................ 98
1.5.7 SPP events ................................................................................... 99
1.5.7.1 SPP Receive ............................................................................ 99
1.5.7.2 SPP connected ......................................................................... 99
1.5.7.3 SPP Disconnected..................................................................... 99
1.5.8 Apple IAP1 Events ....................................................................... 100
1.5.8.1 IAP Connected ....................................................................... 100
1.5.8.2 IAP Disconnected ................................................................... 100
1.5.8.3 IAP1 Accessory Authentication Started...................................... 100
1.5.8.4 IAP1 Accessory Authentication Failed ........................................ 101
1.5.8.5 IAP1 Accessory Authentication Completed ................................. 101
1.5.8.6 IAP1 Now Playing Application Bundle Name ............................... 101
1.5.8.7 IAP1 Now Playing Application Display Name .............................. 101
1.5.8.8 IAP1 Assistive Touch Status .................................................... 101
1.5.8.9 IAP1 IPodOut Status ............................................................... 102
1.5.8.10 IAP1 Flow Control Status ....................................................... 102
silabs.com | Building a more connected world. Page 6
RRSS99111133--WWiiSSeeCCoonnnneecct
t
TTM
M
BBlluueettooootthh CCllaassssiicc SSooffttwwaarree PPrrooggrraammmmiinngg RReeffeerreennccee
MMaannuuaall
VVeerrssiioonn 11..77..99
1.5.8.11 IAP1 Radio Tagging Status ..................................................... 102
1.5.8.12 IAP1 Camera status .............................................................. 103
1.5.8.13 IAP1 Database changed status ............................................... 103
1.5.8.14 IAP1 Session Space Available Notification ................................ 103
1.5.8.15 IAP1 Bluetooth Status ........................................................... 103
1.5.8.16 IAP1 Voiceover Parameter Changed status ............................... 104
1.5.8.17 IAP1 Application Data Session Opened..................................... 104
1.5.8.18 IAP1 Application Data Session Closed ...................................... 104
1.5.8.19 IAP1 Ipod Data Received ....................................................... 104
1.5.8.20 IAP1 Accessory HID Report .................................................... 105
2 Bluetooth Classic Error Codes .......................................... 106
Generic Error Codes ................................................................................ 106
Core Error Codes .................................................................................... 108
3 Bluetooth API Library ...................................................... 114
3.1 API File Organization ....................................................... 114
3.2 API Prototypes ................................................................ 114
3.2.1 Generic Prototypes ...................................................................... 114
3.2.1.1 Set Local name ...................................................................... 114
3.2.1.2 Query Local name .................................................................. 114
3.2.1.3 Set Local COD ....................................................................... 114
3.2.1.4 Query Local COD .................................................................... 114
3.2.1.5 Query RSSI ........................................................................... 114
3.2.1.6 Query Link Quality ................................................................. 114
3.2.1.7 Query Local BD Address .......................................................... 114
3.2.1.8 Initialize BT Module ................................................................ 114
3.2.1.9 Deinitialize BT Module ............................................................. 114
3.2.1.10 BT Antenna Select................................................................. 114
3.2.1.11 Set Feature Bitmap ............................................................... 115
3.2.2 BT Classic Core Prototypes ........................................................... 115
3.2.2.1 Set Profile mode .................................................................... 115
3.2.2.2 Set Discovery mode ............................................................... 115
3.2.2.3 Get Discovery mode ............................................................... 115
3.2.2.4 Set Connectability mode ......................................................... 115
3.2.2.5 Get Connectability mode ......................................................... 115
3.2.2.6 Set Pair Mode ........................................................................ 115
3.2.2.7 Get Pair Mode ........................................................................ 115
3.2.2.8 Remote Name Request ........................................................... 115
3.2.2.9 Remote Name Request Cancel ................................................. 115
3.2.2.10 Inquiry ................................................................................ 115
3.2.2.11 Inquiry Cancel ...................................................................... 115
3.2.2.12 Set EIR data ......................................................................... 115
3.2.2.13 Bond or Create Connection ..................................................... 115
3.2.2.14 Bond Cancel or Create Connection Cancel ................................ 116
3.2.2.15 Unbond or Disconnect ........................................................... 116
3.2.2.16 Set Pin Type ......................................................................... 116
3.2.2.17 Get Pin Type ........................................................................ 116
3.2.2.18 User Confirmation ................................................................. 116
3.2.2.19 Passkey Request Reply .......................................................... 116
3.2.2.20 Pincode Reply ....................................................................... 116
3.2.2.21 Get Local Device Role ............................................................ 116
3.2.2.22 Set Local Device Role ............................................................ 116
silabs.com | Building a more connected world. Page 7
RRSS99111133--WWiiSSeeCCoonnnneecct
t
TTM
M
BBlluueettooootthh CCllaassssiicc SSooffttwwaarree PPrrooggrraammmmiinngg RReeffeerreennccee
MMaannuuaall
VVeerrssiioonn 11..77..99
3.2.2.23 Get Service List .................................................................... 116
3.2.2.24 Search Service ..................................................................... 116
3.2.2.25 Linkkey Reply ....................................................................... 116
3.2.2.26 Enable SSP mode .................................................................. 116
3.2.2.27 Accept SSP confirm ............................................................... 116
3.2.2.28 Reject SSP confirm................................................................ 116
3.2.2.29 Start sniff mode .................................................................... 116
3.2.2.30 Exit sniff mode ..................................................................... 116
3.2.2.31 Sniff subrating mode ............................................................. 117
3.2.3 BT SPP Prototypes ....................................................................... 117
3.2.3.1 SPP connect .......................................................................... 117
3.2.3.2 SPP Disconnect ...................................................................... 117
3.2.3.3 SPP Transfer.......................................................................... 117
4 Application ...................................................................... 118
5 Appendix A: Sample flow ................................................. 120
Configure BT device in Master mode........................................... 120
Configure BT device in Slave mode ............................................. 122
Configure BT device in Master Mode and do SPP Tx .................... 123
Configure BT device in Slave Mode and do SPP Tx ...................... 124
AT command sequence to perform SPP data transfer in BT Master
mode ......................................................................................... 125
AT command sequence to perform SPP data transfer in BT Slave
mode ......................................................................................... 126
silabs.com | Building a more connected world. Page 8
RRSS99111133--WWiiSSeeCCoonnnneecct
t
TTM
M
BBlluueettooootthh CCllaassssiicc SSooffttwwaarree PPrrooggrraammmmiinngg RReeffeerreennccee
MMaannuuaall
VVeerrssiioonn 11..77..99
Table of Figures
Figure 1: Bluetooth Software Architecture ................................................. 11
Figure 2: Command frame format .............................................................. 13
Figure 3 Sample flow in BT master Mode while Link key reply is negative 120
Figure 4 Sample flow in BT master Mode while Link key reply is positive 121
Figure 5 Sample flow in BT Slave Mode .................................................... 122
Figure 6 Sample flow in BT Master Mode and do SPP Tx ........................... 123
Figure 7 Sample flow in BT Slave Mode and do SPP Tx ............................. 124
Figure 8 AT command flow in BT Master mode ......................................... 125
Figure 9 AT command flow in BT Slave mode ........................................... 126
silabs.com | Building a more connected world. Page 9
RRSS99111133--WWiiSSeeCCoonnnneecct
t
TTM
M
BBlluueettooootthh CCllaassssiicc SSooffttwwaarree PPrrooggrraammmmiinngg RReeffeerreennccee
MMaannuuaall
VVeerrssiioonn 11..77..99
Table of Tables
Table 1 Frame Descriptor ........................................................................... 13
Table 2 Command IDs in BT Classic mode .................................................. 15
Table 3 Response IDs in BT Classic mode ................................................... 17
Table 4 Event IDs in BT Classic mode ......................................................... 17
Table 5: Coex Modes Supported ................................................................. 22
Table 6 Bluetooth Generic Error Codes ..................................................... 107
Table 7 BT Classic Error Codes ................................................................. 111
Table 8 BT Event Queue Error Codes ........................................................ 111
silabs.com | Building a more connected world. Page 10
RRSS99111133--WWiiSSeeCCoonnnneecct
t
TTM
M
BBlluueettooootthh CCllaassssiicc SSooffttwwaarree PPrrooggrraammmmiinngg RReeffeerreennccee
MMaannuuaall
VVeerrssiioonn 11..77..99
1 Overview
This document describes the commands to operate RS9113-WiSeConnect Module Family in
Bluetooth. The parameters in the commands and their valid values with the expected
responses from the modules are also described. The document should be used by the
developer to write software on the Host MCU to control and operate the module.
1.1 Bluetooth Software Programming
The following sections describe Bluetooth software architecture and commands to operate
and configure the RS9113 modules in Bluetooth.
1.2 Bluetooth Software Architecture
Figure 1: Bluetooth Software Architecture Application
The application layer launches the Bluetooth stack and uses the commands to access
various profiles on the remote Bluetooth devices over the network.
1.2.1 Profiles
There are number of Bluetooth profiles defined in the Bluetooth specification. We currently
support profiles including Serial Port Profile (SPP). We provide framework to develop new
profiles very easily. We will continue to add new profiles.
1.2.2 Bluetooth Core
The Bluetooth core contains the following higher layers of the stack.
RFCOMM
SDP
1.2.3 L2CAP
HCI Generic Driver
HCI BUS Driver
silabs.com | Building a more connected world. Page 11
RRSS99111133--WWiiSSeeCCoonnnneecct
t
TTM
M
BBlluueettooootthh CCllaassssiicc SSooffttwwaarree PPrrooggrraammmmiinngg RReeffeerreennccee
MMaannuuaall
VVeerrssiioonn 11..77..99
Frame Descriptor (16 bytes )
Frame Body (multiples of 4 bytes)
RFCOMM is a transport protocol based on L2CAP. It emulates RS-232 serial ports. The
RFCOMM protocol supports up to 60 simultaneous connections between two BT devices.
RFCOMM provides data stream interface for higher level applications and profiles.
SDP (Service Discovery Protocol) provides a means for applications to discover which
services are available and to determine the characteristics of those available services. SDP
uses an existing L2CAP connection. Further connection to Bluetooth devices can be
established using information obtained via SDP.
L2CAP (Logical Link Control and Adaptation Protocol) provides connection-oriented and
connectionless data services to upper layer protocols with data packet size up to 64 KB in
length. L2CAP performs the segmentation and reassemble of I/O packets from the
baseband controller.
HCI Generic Driver – This driver implements the HCI Interface standardized by Bluetooth
SIG. It establishes the communication between the Stack and the HCI Firmware in the
Bluetooth hardware. It communicates with the Bluetooth controller hardware via the HCI
Bus driver.
HCI Transport Layer Driver – The Bluetooth controllers are connected to the host using
interface like UART, USB, SDIO, SPI, USB-CDC etc. The HCI Transport Layer Driver provides
hardware abstraction to the rest of the Bluetooth stack software. This driver makes it
possible to use Bluetooth stack with different hardware interfaces.
1.2.4 OS Abstraction Layer
This layer abstracts RTOS services (semaphores, mutexes and critical sections) that are used
by the whole stack and the applications. The stack, which is designed in an RTOSindependent manner, can be used with any RTOS by porting this layer. It is also possible to
use the Bluetooth stack standalone without RTOS.
1.3 Bluetooth Command Format
This section explains the general command format. The commands should be sent to the
Module in the specified format.
The commands are sent to the module and the responses are read from the module using frame
write/frame read (as mentioned in the preceeding sections). These commands are called as
command frames.
The format of the command frames are divided into two parts:
1. Frame descriptor
2. Frame Body(Frame body is often called as Payload)
Command frame format is shown below. This description is for a Little Endian System.
silabs.com | Building a more connected world. Page 12
RRSS99111133--WWiiSSeeCCoonnnneecct
t
TTM
M
BBlluueettooootthh CCllaassssiicc SSooffttwwaarree PPrrooggrraammmmiinngg RReeffeerreennccee
MMaannuuaall
VVeerrssiioonn 11..77..99
Word
Frame Descriptor
Word0
W0[15:0]
Bits [11:0] – Length of the frame
Bits [15:12] – 2(indicates Bluetooth packet).
Word1
W1[15:0]
Bits [15:0] - Packet type
Word2
W2[15:0]
Reserved
Word3
W3[15:0]
Reserved
Word4
W4[15:0]
Reserved
Word5
W5 [15:0]
Reserved
Word
W6 [15:0]
1. (0x0000) when sent from host to module.
2. When sent from module to host (as response frame),
it contains the status.
Word7
W7 [15:0]
Reserved
Figure 2: Command frame format
W0
W1
W2
W3
Frame Descriptor
Status word W6[15:0]
(for frames sent from module to host)
W1[15:0] Packet type
Frame Body
Payload
W5
W6
W7
W4
W0[11:0] Packet Length
W0[15:12] Queue type
The following table provides the general description of the frame descriptor.
Table 1 Frame Descriptor
silabs.com | Building a more connected world. Page 13
RRSS99111133--WWiiSSeeCCoonnnneecct
t
TTM
M
BBlluueettooootthh CCllaassssiicc SSooffttwwaarree PPrrooggrraammmmiinngg RReeffeerreennccee
MMaannuuaall
VVeerrssiioonn 11..77..99
Command
Command ID
Set Local Name
0x0001
Query Local Name
0x0002
Set Local COD
0x0003
Query Local COD
0x0004
Query RSSI
0x0005
Query Link Quality
0x0006
Query Local BD Address
0x0007
Set Profile Mode
0x0008
Set Device Discover Mode
0x0009
Get Device Discover Mode
0x000A
Set Connection mode
0x000B
Get Connection mode
0x000C
Set Pair mode
0x000D
Get Pair mode
0x000E
Remote Name Request
0x000F
Remote Name Request Cancel
0x0010
Inquiry
0x0011
Inquiry Cancel
0x0012
Bond or Create Connection
0x0013
Three types of frames will get exchanged between the module and the
host.
1. Request/Command frames - These are sent from Host to Module. Each Request/ Command has
an asscociated response with it.
2. Response frames – These are sent from Module to Host. These are given in response to the
previous Request/Command from the Host. Each command has a single reponse.
3. Event frames – These are sent from Module to Host. These are given when
a) There are multiple reponses for a particular Request/ Command frame
b) There is Asynchonous message to be sent to host.
The following are the types of frame requests and responses and the
corresponding codes. The commands are different for both Classic and LE
modes. The below table lists the Command, Response and Event frames
in Classic mode.
In both the modes, the corresponding code is to be filled in W1 [15:0]
mentioned in the table above.
silabs.com | Building a more connected world. Page 14
RRSS99111133--WWiiSSeeCCoonnnneecct
t
TTM
M
BBlluueettooootthh CCllaassssiicc SSooffttwwaarree PPrrooggrraammmmiinngg RReeffeerreennccee
MMaannuuaall
VVeerrssiioonn 11..77..99
Bond Cancel or Create
Connection Cancel
0x0014
Unbond or Disconnect
0x0015
Set Pin Type
0x0016
Get Pin Type
0x0017
User Confirmation
0x0018
Passkey Reply
0x0019
Pincode Reply
0x001A
Get Local Device Role
0x001B
Set Local Device Role
0x001C
Get Service List
0X001D
Search Service
0X001E
SPP connect
0X001F
SPP Disconnect
0X0020
SPP Transfer
0X0021
Initialize BLE module
0x008D
Deinitialize BLE module
0x008E
Antenna Select
0x008F
Linkkey Reply
0x0091
PER Transmit
0x0098
PER Receive
0x0099
PER Stats
0x009A
PER CW mode
0x009B
Sniff Mode
0x009D
Sniff Exit
0x009E
Sniff Subrating
0x009F
Feature Bit map
0x00A6
Set antenna Tx power level
0x00A7
Set EIR data
0x00A9
Response
Response ID
Card ready
0x0505
Set Local Name
0x0001
Query Local Name
0x0002
Set Local COD
0x0003
Query Local COD
0x0004
Table 2 Command IDs in BT Classic mode
silabs.com | Building a more connected world. Page 15
RRSS99111133--WWiiSSeeCCoonnnneecct
t
TTM
M
BBlluueettooootthh CCllaassssiicc SSooffttwwaarree PPrrooggrraammmmiinngg RReeffeerreennccee
MMaannuuaall
VVeerrssiioonn 11..77..99
Query RSSI
0x0005
Query Link Quality
0x0006
Query Local BD Address
0x0007
Set Profile Mode
0x0008
Set Device Discover Mode
0x0009
Get Device Discover Mode
0x000A
Set Connection mode
0x000B
Get Connection mode
0x000C
Set Pair mode
0x000D
Get Pair mode
0x000E
Remote Name Request
0x000F
Remote Name Request Cancel
0x0010
Inquiry
0x0011
Inquiry Cancel
0x0012
Bond or Create Connection
0x0013
Bond Cancel or Create
Connection Cancel
0x0014
Unbond or Disconnect
0x0015
Set Pin Type
0x0016
Get Pin Type
0x0017
User Confirmation
0x0018
Passkey reply
0x0019
Pincode Reply
0x001A
Get Local Device Role
0x001B
Set Local Device Role
0x001C
Get Service List
0X001D
Search Service
0X001E
SPP connect
0X001F
SPP Disconnect
0X0020
SPP Transfer
0X0021
BT Classic init
0x008D
BT Classic deint
0x008E
Antenna Select
0x008F
Linkkey Reply
0x0091
PER Transmit
0x0098
PER Recieve
0x0099
PER Stats
0x009A
PER CW mode
0x009B
silabs.com | Building a more connected world. Page 16
RRSS99111133--WWiiSSeeCCoonnnneecct
t
TTM
M
BBlluueettooootthh CCllaassssiicc SSooffttwwaarree PPrrooggrraammmmiinngg RReeffeerreennccee
MMaannuuaall
VVeerrssiioonn 11..77..99
SSP Mode
0x00A0
Sniff Mode
0x009D
Sniff Exit
0x009E
Sniff Subrating
0x009F
Feature Bit Map
0x00A6
Set antenna Tx power level
0x00A7
Set EIR data
0x00A9
Event
Event ID
Role change status
0x1000
Unbond or Disconnect
0x1001
Bond Response
0x1002
Inquiry response
0x1003
Remote Device Name
0x1004
Remote Name Request cancelled
0x1005
Disconnected
0x1006
User confirmation request
0x1007
User passkey display
0x1008
User pincode request
0x1009
User passkey request
0x100A
Inquiry complete
0x100B
Auth complete
0x100C
User linkkey request
0x100D
User linkkey save
0x100E
SPP Receive
0x1100
SPP connected
0x1101
SPP Disconnected
0x1102
Mode Changed
0x1010
Sniff Subrating Changed
0x1011
Table 3 Response IDs in BT Classic mode
Table 4 Event IDs in BT Classic mode
1.4 Interfaces
Host can interface with RS9113-WiSeConnect Module using following list
of host interfaces to configure and send/receive data.
UART
SPI
silabs.com | Building a more connected world. Page 17
RRSS99111133--WWiiSSeeCCoonnnneecct
t
TTM
M
BBlluueettooootthh CCllaassssiicc SSooffttwwaarree PPrrooggrraammmmiinngg RReeffeerreennccee
MMaannuuaall
VVeerrssiioonn 11..77..99
1.4.1 UART
SPI
SPI
Host
INTERRUPT
UART
UART
RS9113-WisConnect Module
USB
USB
The UART on the RS9113-WiSeConnect module is used as a host
interface to configure the module, send and receive data.
USB
Features
Supports hardware (RTS/CTS) flow control.
Supports following list of baud rates
o 9600 bps
o 19200 bps
o 38400 bps
o 57600 bps
o 115200 bps
o 230400 bps
o 460800 bps
NOTE: For BT/ BLE there is no support for 921600 bps
Default Parameters
Data bits - 8
Stop bits - 1
Parity – None
Flow control - None
1.4.2 USB
RS9113-WiSeConnect module supports USB interface, allow host to
configure and send/receive data through module using USB interface.
Features
USB 2.0 (USB-HS core)
silabs.com | Building a more connected world. Page 18
RRSS99111133--WWiiSSeeCCoonnnneecct
t
TTM
M
BBlluueettooootthh CCllaassssiicc SSooffttwwaarree PPrrooggrraammmmiinngg RReeffeerreennccee
MMaannuuaall
VVeerrssiioonn 11..77..99
o USB 2.0 offers the user a longer bandwidth with increasing
data throughput.
o USB 2.0 supports additional data rate of 480 Mbits/Sec in
addition to 1.5Mbits/Sec and 12 Mbits/Sec.
Supports USB-CDC
1.4.3 SPI
This section describes RS9113-WiSeConnect module SPI interface and the
commands & processes to operate the module using the SPI interface.
Features
Supports 8-bit and 32-bit data mode
Supports flow control
Communication through SPI
The RS9113-WiSeConnect module can be configured and operated from
the Host by sending commands through the SPI interface.
SPI Settings
The SPI Interface is a full duplex serial Host interface, which supports 8bit and 32-bit data mode. The SPI interface of the module consists of the
following signals:
SPI_MOSI (Input) – Serial data input for the module.
SPI_MISO (Output) – Serial data output for the module.
SPI_CS (Input) – Active low slave select signal. This should be low when
SPI transactions are to be carried out.
SPI_CLK (Input) – SPI clock. Maximum value allowed is 80 MHz
INTR (Output) – Active high (Default), Active low, level interrupt output
from the module.
The module acts as a SPI slave only while the Host is the SPI master.
Following parameters should be in the host SPI interface.
CPOL (clock polarity) = 0,
CPHA (clock phase) = 0.
Interrupt
The module’s INTERRUPT output signal should be connected to the
interrupt input of the Host MCU. The INTERRUPT signal is an active
high, level triggered signal. It is raised by the module in the following
cases:
1) When the module needs to indicate to the Host that it has received
data from the remote terminal and the data needs to be read by the
Host.
2) When the module needs to indicate to the Host that a response to a
command sent by the Host is ready to be read from the module.
silabs.com | Building a more connected world. Page 19
RRSS99111133--WWiiSSeeCCoonnnneecct
t
TTM
M
BBlluueettooootthh CCllaassssiicc SSooffttwwaarree PPrrooggrraammmmiinngg RReeffeerreennccee
MMaannuuaall
VVeerrssiioonn 11..77..99
To indicate to the Host that it should read a CARD READY message from
module. This operation is described in the subsequent sections.
1.5 Bluetooth Classic commands
The following sections will explain various RS9113-WiSeConnect Bluetooth Classic
commands, their structures, the parameters they take and their responses. For API
prototypes of these commands, please refer to the API Library Section
Note: All BT/BLE AT command are case sensitive and lower case.
NOTE:
1. A new command has to be called only after getting the response for the previous
command
2. In the following commands, wherever the BD Address is applicable, it should be given in
hex format and upper case characters
Please refer to the example commands in each section for more information.
1.5.1 Generic commands
1.5.1.1 Set Operating Mode
Description:
This is the first command that needs to be sent from the Host after receiving card ready
frame from module. This command configures the module in different functional modes.
Command Format:
AT Mode:
at+rsi_opermode=<oper_mode>,<feature_bit_map>,<tcp_ip_feature_bit_map>,<custom_f
eature_bit_map>,<ext_custom_feature_bit_map>,< bt_custom_feature_bit_map>r\n
Binary Mode:
The structure of the payload is give below
typedef struct
{
uint32 oper_mode;
uint32 feature_bit_map;
uint32 tcp_ip_feature_bit_map;
uint32 custom_feature_bit_map;
uint32 ext_custom_feature_bit_map;
uint32 bt_custom_feature_bit_map;
uint32 ext_tcp_ip_feature_bitmap;
} operModeFrameSnd;
silabs.com | Building a more connected world. Page 20
RRSS99111133--WWiiSSeeCCoonnnneecct
t
TTM
M
BBlluueettooootthh CCllaassssiicc SSooffttwwaarree PPrrooggrraammmmiinngg RReeffeerreennccee
MMaannuuaall
VVeerrssiioonn 11..77..99
Command Parameters:
Oper_mode:
Sets the mode of operation. oper_mode contains two parts <wifi_oper_mode,
coex_mode>. Lower two bytes represent wifi_oper_mode and higher two bytes represent
coex_modes.
oper_mode = ((wifi_oper_mode) | (coex_mode << 16))
Wifi_oper_mode values:
0 - Wi-Fi Client Mode. The module works as a normal client that can connect to an Access
Point with different security modes other than enterprise security.
1 – Wi-Fi Direct™ or Autonomous GO. In this mode, the module either acts as a Wi-Fi Direct
node or as an Autonomous GO (with intent value 16), depending on the inputs supplied for
the command “Configure Wi-Fi Direct Peer-to-Peer Mode” in RS9113-WiseConnect-
Software-PRM-v1.7.6.pdf at docs folder in release package.
. In Autonomous GO and in Wi-Fi Direct GO mode, a maximum of 4 client devices are
supported.
2 – Enterprise Security Client Mode. The module works as a client that can connect to an
Access Point with WPA/WPA2-Enterprise security.
6 – Access Point mode. In this mode, the module acts as an Access Point, depending on the
inputs supplied for the command “Configure AP Mode” in RS9113-WiseConnect-Software-
PRM-v1.7.6.pdf at docs folder in release package.
. In Access Point mode, a maximum of 8 client devices are supported.
8 - PER Mode. This mode is used for calculating packet error rate and mostly used during RF
certification tests.
9 – Concurrent mode. This mode is used to run module in concurrent mode. In concurrent
mode, host can connect to a AP and can create AP simultaneously.
NOTE: In concurrent mode
1. AP MAC address last byte will differ and it will be one plus the station mode MAC last
byte.
2. In TCP/IP non bypass mode, Broadcast/Multicast packet will go to first created
interface (e.g. if Station mode connects first the broadcast/multicast packet will go to
network belonging to station mode).
3. IPV6 support is not present in the current release.
coex_mode bit values: enables respective protocol
BIT 0 : Enable/Disable WLAN mode.
0 – Disable WLAN mode
1 – Enable WLAN mode
BIT 1 : Enable/Disable ZigBee mode.
0 – Disable ZigBee mode
silabs.com | Building a more connected world. Page 21
RRSS99111133--WWiiSSeeCCoonnnneecct
t
TTM
M
BBlluueettooootthh CCllaassssiicc SSooffttwwaarree PPrrooggrraammmmiinngg RReeffeerreennccee
MMaannuuaall
VVeerrssiioonn 11..77..99
Coex_mode
Description
0
WLAN only mode
3
WLAN and ZigBee coexistence mode.
5
WLAN and BT coexistence mode.
13
WLAN and BTLE coexistence mode.
14
BTLE and ZigBee coexistence mode.
1 – Enable ZigBee mode
BIT 2 : Enable/Disable BT mode.
0 – Disable BT mode
1 – Enable BT mode
BIT 3 : Enable/Disable BTLE mode.
0 – Disable BTLE mode
1 – Enable BTLE mode
NOTE: In BTLE mode, need to enable BT mode also.
Following table represents possible coex modes supported:
Table 5: Coex Modes Supported
NOTE: Following CoeX mode is supported currently
1. WLAN STA+BT (Only TCP/IP Bypass mode)
2. WLAN STA + BLE
3. WLAN STA + ZB
4. BLE + ZB
5. WLAN AP + BT (Only support is present in TCP/IP Bypass mode)
6. WLAN AP + BLE
7. WLAN AP + ZB
To select proper CoeX mode please refer
WiSeConnect_TCPIP_Feature_Selection_v1.7.6.xlsx at docs folder given in the release
package
NOTE: If coex mode enabled in opermode command, then BT/BLE or ZigBee protocol will
start and give corresponding card ready in parallel with opermode command response
(which will be handled by corresponding application).
BT card ready frame is described in
RS9113-WiseConnect-BT-Classic-Software-PRM-API-Guide-v1.7.6.pdf ,
BLE card ready frame is described in
RS9113-WiseConnect-BLE-Software-PRM-API-Guide-v1.7.6.pdf
silabs.com | Building a more connected world. Page 22
RRSS99111133--WWiiSSeeCCoonnnneecct
t
TTM
M
BBlluueettooootthh CCllaassssiicc SSooffttwwaarree PPrrooggrraammmmiinngg RReeffeerreennccee
MMaannuuaall
VVeerrssiioonn 11..77..99
and ZigBee card ready frame is described in
RS9113-WiseConnect-ZigBee-Software-PRM-API-Guide-v1.7.6.pdf
at docs folder in release package.
feature_bit_map: this bitmap is used to enable following WLAN features:
feature_bit_map[0]- To enable open mode
0 - Open Mode Disabled
1- Open Mode enabled (No Security)
feature_bit_map[1]- To enable PSK security
0 - PSK security disabled
1 - PSK security enabled
feature_bit_map[2]-To enable Aggregation in station mode
0-Aggregation disabled
1-Aggregation enabled
feature_bit_map[3]-To enable LP GPIO hand shake
0 – LP GPIO hand shake disabled
1 – LP GPIO hand shake enabled
feature_bit_map[4]-To enable ULP GPIO hand shake
0 – ULP GPIO hand shake disabled
1 – ULP GPIO hand shake enabled
feature_bit_map[5]-To select module to host wakeup pin
0 – GPIO_21 is used as module to host wakeup pin
1 – ULP_GPIO_1 is used as module to host wakeup pin
feature_bit_map[6]-To select RF supply voltage
0 – RF voltage is set to 1.9V
1 – RF voltage is set to 3.3V
feature_bit_map[7]-To disable WPS support
0 – WPS enable
1 - WPS disable in AP mode and station Mode
feature_bit_map[8:31]- Reserved. Should set to be ‘0’
NOTE: feature_bit_map[0], feature_bit_map[1] are valid only in Wi-Fi client mode.
tcp_ip_feature_bit_map: To enable TCP/IP related features.
tcp_ip_feature_bit_map[0]- To enable TCP/IP bypass
0 - TCP/IP bypass mode disabled
silabs.com | Building a more connected world. Page 23
RRSS99111133--WWiiSSeeCCoonnnneecct
t
TTM
M
BBlluueettooootthh CCllaassssiicc SSooffttwwaarree PPrrooggrraammmmiinngg RReeffeerreennccee
MMaannuuaall
VVeerrssiioonn 11..77..99
1 - TCP/IP bypass mode enabled
tcp_ip_feature_bit_map[1]- To enable http server
0 - HTTP server disabled
1 - HTTP server enabled
tcp_ip_feature_bit_map[2]- To enable DHCPv4 client
0 - DHCPv4 client disabled
1 - DHCPv4 client enabled
tcp_ip_feature_bit_map[3]- To enable DHCPv6 client
0 - DHCPv6 client disabled
1 - DHCPv6 client enabled
tcp_ip_feature_bit_map[4]- To enable DHCPv4 server
0 - DHCPv4 server disabled
1 - DHCPv4 server enabled
tcp_ip_feature_bit_map[5]- To enable DHCPv6 server
0 - DHCPv6 server disabled
1 - DHCPv6 server enabled
tcp_ip_feature_bit_map[6]- To enable Dynamic update of web pages (JSON objects)
0 - JSON objects disabled
1 - JSON objects enabled
tcp_ip_feature_bit_map[7]- To enable HTTP client
0 - To disable HTTP client
1 - To enable HTTP client
tcp_ip_feature_bit_map[8]- To enable DNS client
0 - To disable DNS client
1 - To enable DNS client
tcp_ip_feature_bit_map[9]- To enable SNMP agent
0 - To disable SNMP agent
1 - To enable SNMP agent
tcp_ip_feature_bit_map[10]- To enable SSL
0 - To disable SSL
1 - To enable SSL
tcp_ip_feature_bit_map[11]- To enable PING from module(ICMP)
0 - To disable ICMP
1 - To enable ICMP
tcp_ip_feature_bit_map[12]- To enable HTTPS Server
silabs.com | Building a more connected world. Page 24
RRSS99111133--WWiiSSeeCCoonnnneecct
t
TTM
M
BBlluueettooootthh CCllaassssiicc SSooffttwwaarree PPrrooggrraammmmiinngg RReeffeerreennccee
MMaannuuaall
VVeerrssiioonn 11..77..99
0 - To disable HTTPS Server
1 - To enable HTTPS Server
tcp_ip_feature_bit_map[14]- To send configuration details to host on submitting
configurations on wireless configuration page
0 - Do not send configuration details to host
1 - Send configuration details to host
tcp_ip_feature_bit_map[15]- To enable FTP client
0 - To disable FTP client
1 - To enable FTP client
tcp_ip_feature_bit_map[16]- To enable SNTP client
0 - To disable SNTP client
1 - To enable SNTP client
tcp_ip_feature_bit_map[17]- To enable IPv6 mode
0 - To disable IPv6 mode
1 - To enable IPv6 mode
IPv6 will also get enabled if DHCP v6 client/DHCP v6 server is enabled irrespective of
tcp_ip_feature_bit_map[17].
tcp_ip_feature_bit_map[19]- To MDNS and DNS-SD
0 - To disable MDNS and DNS-SD
1 - To Enable MDNS and DNS-SD
tcp_ip_feature_bit_map[20]- To enable SMTP client
0 - To disable SMTP client
1 - To Enable SMTP client
tcp_ip_feature_bit_map[21 - 24]- To select no of sockets
possible values are 1 to 10 . If User tried to select more than 10 sockets it will be reset to 10
sockets only . Default no of sockets is 10, if this selection is not done by the user.
tcp_ip_feature_bit_map[25]- To select Single SSL socket
0 – selecting single socket is Disabled
1- Selecting single socket is enabled
NOTE: By default two SSL sockets are supported
tcp_ip_feature_bit_map[26]- To allow loading Private & Public certificates
0 – Disable loading private & public certificates
1- Allow loading private & public certificates
silabs.com | Building a more connected world. Page 25
RRSS99111133--WWiiSSeeCCoonnnneecct
t
TTM
M
BBlluueettooootthh CCllaassssiicc SSooffttwwaarree PPrrooggrraammmmiinngg RReeffeerreennccee
MMaannuuaall
VVeerrssiioonn 11..77..99
NOTE : If Secure handshake is with CA – certificate alone , then disable loading Private and
public keys and erase these certificates from the flash using load_cert API .
Or if Secure handshake needed verification of Private and Public keys , then enable loading
of private and public keys.
tcp_ip_feature_bit_map[27]- To load SSL certificate on to the RAM
tcp_ip_feature_bit_map[28]- To enable TCP-IP data packet Dump on UART2
tcp_ip_feature_bit_map[29]- To enable POP3 client
0 - To disable POP3 client
1 - To Enable POP3 client
tcp_ip_feature_bit_map[13], tcp_ip_feature_bit_map[18], tcp_ip_feature_bit_map[30:31]-All
set to ‘0’.
NOTE:
SSL(tcp_ip_feature_bit_map[10], tcp_ip_feature_bit_map[12]) is supported only in
opermode 0
NOTE:
Feature selection utility is provided in the package. WiSeConnect device supports the
selected features combination only if it is feasible according to the
WiSeConnect_TCPIP_Feature_Selection_v1.7.6.xlsx at docs folder given in the release
package.
custom_feature_bit_map:
This bitmap used to enable following custom features:
BIT[2]: If this bit is set to ‘1’, the DHCP server behavior, when the module is in AP mode,
changes. The DHCP server, when it assigns IP addresses to the client nodes, does not send
out a Gateway address, and sends only the assigned IP and Subnet values to the client. It is
highly recommended to keep this value at ‘0’ as the changed behavior is required in only
very specialised use cases and not in normal AP functionality. The default value of this bit is
‘0’.
BIT[5]: If this bit is set to ‘1’, Hidden SSID is enabled in case of AP mode. The default value of
this bit is ‘0’.
BIT[6]:To enable/disable DNS server IP address in DHCP offer response in AP mode.
1- In AP mode, DHCP server sends DNS server IP address in DHCP offer
0- Not to include DNS server address in DHCP offer response
BIT[8]: - Enable/Disable DFS channel passive scan support
1- Enable
0-Disable
BIT[9] : – To Enable/disable LED(GPIO_16) after module initialization(INIT).
1- Enable LED support
silabs.com | Building a more connected world. Page 26
RRSS99111133--WWiiSSeeCCoonnnneecct
t
TTM
M
BBlluueettooootthh CCllaassssiicc SSooffttwwaarree PPrrooggrraammmmiinngg RReeffeerreennccee
MMaannuuaall
VVeerrssiioonn 11..77..99
0– Disable LED support
BIT[10]: Used to enable/disable Asynchronous messages to host to indicate the module
state.
1- Enable asynchronous message to host
0-Disable asynchronous message to host
BIT[11] : To enable/disable packet pending (Wakeon wireless) indication in UART mode
1 – Enable packet pending indication
0- Disable packet pending indication
BIT[12]:Used to enable or disable AP blacklist feature in client mode during roaming or
rejoin. By default module maintains AP blacklist internally to avoid some access points.
1 – Disable AP black list feature
0 – Enable AP black list feature
BIT[13-16]:Used to set the maximum number of stations or client to support in AP or Wi-Fi
Direct mode. Possible values are 1 to 8 in AP mode and 1 to 4 in Wi-Fi Direct mode.
Note1: If these bits are not set, default maximum clients supported is set to 4.
BIT[17] : to select between de-authentication or Null data (with power management bit
set) based roaming, Depending on selected method station will send deauth or Null data to
connected AP when roam from connected AP to newly selected AP.
0 – To enable de-authentication based roaming
1 – To enable Null data based roaming
BIT[18]: Reserved
BIT[19]: Reserved
BIT[20]: Used to start/stop auto connection process on bootup, until host triggers it using
Trigger Auto Configuration command
1 – Enable
0 – Disable
BIT[22]: Used to enable per station power save packet buffer limit in AP mode. When
enabled, only two packets per station will be buffered when station is in power save
1 – Enable
0 – Disable
BIT[23] : To enable/disable HTTP/HTTPs authentication
1 - Enable
0 – Disable
BIT[24]: To enable/disable higher clock frequency in module to improve throughputs
1 - Enable
0 – Disable
BIT[25]: To give HTTP server credentials to host in get configuration command
silabs.com | Building a more connected world. Page 27
RRSS99111133--WWiiSSeeCCoonnnneecct
t
TTM
M
BBlluueettooootthh CCllaassssiicc SSooffttwwaarree PPrrooggrraammmmiinngg RReeffeerreennccee
MMaannuuaall
VVeerrssiioonn 11..77..99
1 – To include HTTP server credentials in get configuration command response
0 – To exclude HTTP server credentials in get configuration command response
BIT[26]: To accept or reject new connection request when maximum clients are connected
in case of LTCP.
1 - Reject
0 – Accept
By default this bit value is zero.
When BIT[26] is zero: For a LTCP socket when maximum clients are connected if a new
connection request is received, then this connection request will not be rejected.
Instead module will maintain this connection request in LTCP pending list.
This request will be served when any of the connected client is disconnected.
When BIT[26] is set: For a LTCP socket when maximum clients are connected if a new
connection request is received, then this connection request will be rejected
immediately. Module will not maintain this connection request in LTCP pending list.
BIT[27]: To enable dual band roaming and rejoin feature this bit is used.
1 - Enable dual band roaming and rejoin
0 – Disable dual band roaming and rejoin.
BIT[28]: To enable real time clock from host
1 - Enable real time clock feature given by host
0 – Disable real time clock feature
BIT[29]: To Enable IAP support in BT mode
1 - Enable
0 – Disable
BIT[31]: This bit is used to validate extended custom feature bitmap.
1 – Extended feature bitmap valid
0 – Extended feature bitmap is invalid
BIT[0:1],BIT[3:4],BIT[7],BIT[21], BIT[30]: Reserved, should be set to all ‘0’.
NOTE: For UART/USB-CDC in AT mode:
When user does not give any tcp_ip_feature_bit_map value then default settings for client
mode, Enterprise client mode, WiFi-Direct mode are:
HTTP server, DHCPv4 client, DHCPv6 client and JSON objects are enabled.
When user does not give any tcp_ip_feature_bit_map value then default settings for Access
point mode are:
HTTP server, DHCPv4 server, DHCPv6 server and JSON objects are enabled.
Parameters- feature_bit_map, tcp_ip_feature_bit_map and custom_feature_bit_map are
optional in opermode command in UART mode for AT mode. If user does not give these
parameters then default configuration gets selected, as explained above, based upon the
operating mode configured.
silabs.com | Building a more connected world. Page 28
RRSS99111133--WWiiSSeeCCoonnnneecct
t
TTM
M
BBlluueettooootthh CCllaassssiicc SSooffttwwaarree PPrrooggrraammmmiinngg RReeffeerreennccee
MMaannuuaall
VVeerrssiioonn 11..77..99
Result Code
Description
OK
Successful execution of the command
ERROR<Error code>
Failure
If opermode is 8 (PER mode is selected) - feature_bit_map, tcp_ip_feature_bit_map and
custom_feature_bit_map can be ignored or not valid. Set to zero.
ext_custom_feature_bit_map:
This feature bitmap is extention of custom feature bitmap and is valid only if BIT[31] of
custom feature bitmap is set. This enables the following feature.
BIT[0]: To enable antenna diversity feaute.
1 – Enable antenna diversity feature
0 – Disble antenna diversity feature
BIT[1]:This bit is used to enable 4096 bit RSA key support
1 – Enable 4096 bit RSA key support
0 – Disable 4096 bit RSA key support
Note: This bit is required to set for 4096 bit RSA key support. If key size is 4096 bit, module
will use software rountine for exponentiation, so connection time will increase.
BIT[2]:This bit is used to set the module type.This is applicable only if manufacturing
software version of the module is below 3.1 (i.e. manufacturing version 3 and
subversion 1).
0 - Module will ignore the module type given through the set region
command.
1 - Module will accept the module type given through the set region
command.
bt_custom_feature_bit_map:
Currently this bitmap is not valid in case of BT-Classic.
Response:
AT Mode:
Binary Mode:
There is no response payload for this command.
Example:
AT Mode:
at+rsi_opermode=327680,0,1,0\r\n
Response:
OK
bt_loaded\r\n
silabs.com | Building a more connected world. Page 29
RRSS99111133--WWiiSSeeCCoonnnneecct
t
TTM
M
BBlluueettooootthh CCllaassssiicc SSooffttwwaarree PPrrooggrraammmmiinngg RReeffeerreennccee
MMaannuuaall
VVeerrssiioonn 11..77..99
1.5.1.2 Set Local name
Result Code
Description
OK <name_length>,<local_device_name>
Command Success.
ERROR <Error_code>
Command Fail.
Description: This is used to set name to the local device.
Binary Payload Structure:
typedef struct rsi_bt_cmd_set_local_name {
UINT08 NameLength;
INT08 Name[50];
} RSI_BT_CMD_SET_LOCAL_NAME;
AT command format:
at+rsibt_setlocalname=<NameLength>,<Name>\r\n
Parameters:
NameLength – Length of the name of the local device.
Name – Name of the local device.
Response Payload:
There is no response payload for this command.
AT command Ex: at+rsibt_setlocalname=8,redpines\r\n
Response: OK\r\n
NOTE: Namelength parameter should be in decimal format.
1.5.1.3 Query Local name
Description: This is used to query the name of the local device.
Binary Payload Structure:
No Payload required.
AT command format:
at+rsibt_getlocalname?\r\n
Response Payload:
typedef struct rsi_bt_resp_query_local_name {
UINT08 NameLength;
INT08 Name[50];
} RSI_BT_RESP_QUERY_LOCAL_NAME;
Response Parameters:
NameLength – Length of the name of the local device.
Name – Name of the local device.
silabs.com | Building a more connected world. Page 30
RRSS99111133--WWiiSSeeCCoonnnneecct
t
TTM
M
BBlluueettooootthh CCllaassssiicc SSooffttwwaarree PPrrooggrraammmmiinngg RReeffeerreennccee
MMaannuuaall
VVeerrssiioonn 11..77..99
AT command Ex: at+rsibt_getlocalname?\r\n
Result Code
Description
OK <local_device_class>
Command Success.
ERROR <Error_code>
Command Fail.
Response: OK 8,redpines\r\n
1.5.1.4 Set Local COD
Description: This is used to indicate the capabilities of the local device to other devices.
It is a parameter received during the device discovery procedure on the BR/EDR physical
transport, indicating the type of device. The Class of Device parameter is only used on
BR/EDR and BR/EDR/LE devices using the BR/EDR physical transport.
Binary Payload Structure:
typedef struct rsi_bt_cmd_set_local_cod {
UINT32 LocalCOD;
} RSI_BT_CMD_SET_LOCAL_COD;
AT command format:
at+rsibt_setlocalcod=<local_device_class>\r\n
Parameters:
Local COD – Class of the Device of the local device
Response Payload:
There is no response payload for this command.
AT command Ex: at+rsibt_setlocalcod=7A020C\r\n
Response: OK\r\n
1.5.1.5 Query Local COD
Description: This is used to query Class of Device of the local device.
Binary Payload Structure:
No Payload required.
AT command format:
at+rsibt_getlocalcod?\r\n
Response Payload:
typedef struct rsi_bt_resp_query_local_cod {
UINT32 LocalCOD;
} RSI_BT_RESP_QUERY_LOCAL_COD;
Response Parameters:
LocalCOD – Class of the Device of the local device
silabs.com | Building a more connected world. Page 31
Loading...