TI BLE Vendor Specific HCI Guide

TI BLE Vendor Specific
HCI Reference Guide

Version 1.3
TI BLE HCI Vendor Specific HCI Guide
TABLE OF CONTENTS
1.
PURPOSE ....................................................................................................................................... 7
2.
FUNCTIONAL OVERVIEW ......................................................................................................... 7
3.
NUMERICAL NOTATION CONVENTIONS .............................................................................. 8
4.
DEFINITIONS, ABBREVIATIONS, ACRONYMS...................................................................... 9
5.
REFERENCES................................................................................................................................ 9
6.
REVISION HISTORY .................................................................................................................. 10
7.
HCI OVERVIEW ......................................................................................................................... 10
8.
SPECIFICATION INTERFACE .................................................................................................. 10

8.1
HCI INTERFACE PROTOCOL ...................................................................................................... 10
8.1.1
Command Packet ............................................................................................................. 10
8.1.2
Asynchronous Data Packet .............................................................................................. 11
8.1.3
Synchronous Data Packet ................................................................................................ 11
8.1.4
Event Packet.................................................................................................................... 11
8.2
HCI COMMAND ........................................................................................................................ 12
8.3
HCI EVENTS ............................................................................................................................ 14
9.
VENDOR SPECIFIC INTERFACE ............................................................................................. 15

9.1
9.2
9.3
10.
VENDOR SPECIFIC COMMANDS.................................................................................................. 15

VENDOR SPECIFIC EVENTS........................................................................................................ 20
REQUEST AND RESPONSE TUNNELING........................................................................................ 24
HCI EXTENSION VENDOR SPECIFIC COMMANDS ........................................................ 25
10.1
10.2
10.3
10.4
10.5
10.6
10.7
10.8
10.9
10.10
10.11
10.12
10.13
10.14
10.15
10.16
10.17
10.18
10.19
10.20
HCI EXTENSION SET RECEIVER GAIN ........................................................................................ 25

HCI EXTENSION SET TRANSMITTER POWER .............................................................................. 25
HCI EXTENSION ONE PACKET PER EVENT ................................................................................. 26
HCI EXTENSION CLOCK DIVIDE ON HALT ................................................................................. 27
HCI EXTENSION DECLARE NV USAGE....................................................................................... 27
HCI EXTENSION DECRYPT ........................................................................................................ 28
HCI EXTENSION SET LOCAL SUPPORTED FEATURES ................................................................... 29
HCI EXTENSION SET FAST TRANSMIT RESPONSE TIME............................................................... 29
HCI EXTENSION MODEM TEST TRANSMIT ................................................................................. 30
HCI EXTENSION MODEM HOP TEST TRANSMIT ...................................................................... 31
HCI EXTENSION MODEM TEST RECEIVE ................................................................................ 32
HCI EXTENSION END MODEM TEST ...................................................................................... 33
HCI EXTENSION SET BDADDR ............................................................................................ 33
HCI EXTENSION SET SCA .................................................................................................... 34
HCI EXTENSION ENABLE PTM.............................................................................................. 35
HCI EXTENSION SET FREQUENCY TUNING ............................................................................. 35
HCI EXTENSION SAVE FREQUENCY TUNING .......................................................................... 36
HCI EXTENSION SET MAX DTM TRANSMITTER POWER ......................................................... 37
HCI EXTENSION MAP PM IO PORT ....................................................................................... 37
HCI EXTENSION DISCONNECT IMMEDIATE............................................................................. 39
Page 2 of 152
Copyright 2011 Texas Instruments, Inc

10.21
10.22
10.23
10.24
10.25
10.26
11.
HCI EXTENSION VENDOR SPECIFIC EVENTS ................................................................ 45
11.1
11.2
11.3
11.4
11.5
11.6
11.7
11.8
11.9
11.10
11.11
11.12
11.13
11.14
11.15
11.16
11.17
11.18
11.19
11.20
11.21
11.22
11.23
11.24
11.25
11.26
12.
HCI EXTENSION PACKET ERROR RATE .................................................................................. 39

HCI EXTENSION PACKET ERROR RATE BY CHANNEL ............................................................. 40
HCI EXTENSION EXTEND RF RANGE ..................................................................................... 41
HCI ADVERTISER EVENT NOTICE .......................................................................................... 42
HCI CONNECTION EVENT NOTICE ......................................................................................... 43
HCI HALT DURING RF .......................................................................................................... 44
HCI EXTENSION SET RECEIVER GAIN ........................................................................................ 45

HCI EXTENSION SET TRANSMITTER POWER .............................................................................. 45
HCI EXTENSION ONE PACKET PER EVENT ................................................................................. 46
HCI EXTENSION CLOCK DIVIDE ON HALT ................................................................................. 46
HCI EXTENSION DECLARE NV USAGE....................................................................................... 47
HCI EXTENSION DECRYPT ........................................................................................................ 47
HCI EXTENSION SET LOCAL SUPPORTED FEATURES ................................................................... 48
HCI EXTENSION SET FAST TRANSMIT RESPONSE TIME............................................................... 48
HCI EXTENSION MODEM TEST TRANSMIT ................................................................................. 49
HCI EXTENSION MODEM HOP TEST TRANSMIT ...................................................................... 49
HCI EXTENSION MODEM TEST RECEIVE ................................................................................ 50
HCI EXTENSION END MODEM TEST ...................................................................................... 50
HCI EXTENSION SET BDADDR ............................................................................................ 51
HCI EXTENSION SET SCA .................................................................................................... 51
HCI EXTENSION ENABLE PTM.............................................................................................. 52
HCI EXTENSION SET FREQUENCY TUNING ............................................................................. 52
HCI EXTENSION SAVE FREQUENCY TUNING .......................................................................... 52
HCI EXTENSION SET MAX DTM TRANSMITTER POWER ......................................................... 53
HCI EXTENSION MAP PM IO PORT ....................................................................................... 53
HCI EXTENSION DISCONNECT IMMEDIATE............................................................................. 54
HCI EXTENSION PACKET ERROR RATE .................................................................................. 54
HCI EXTENSION PACKET ERROR RATE BY CHANNEL ............................................................. 56
HCI EXTENSION EXTEND RF RANGE ..................................................................................... 56
HCI EXTENSION ADVERTISER EVENT NOTICE ........................................................................ 57
HCI EXTENSION CONNECTION EVENT NOTICE ....................................................................... 57
HCI EXTENSION HALT DURING RF ........................................................................................ 57
GAP VENDOR SPECIFIC COMMANDS ............................................................................... 58
12.1
12.2
12.3
12.4
12.5
12.6
12.7
12.8
12.9
12.10
12.11
12.12
12.13
12.14
12.15
12.16
GAP DEVICE INITIALIZATION ................................................................................................... 58

GAP CONFIGURE DEVICE ADDRESS .......................................................................................... 59
GAP DEVICE DISCOVERY REQUEST ........................................................................................... 60
GAP DEVICE DISCOVERY CANCEL ............................................................................................ 61
GAP MAKE DISCOVERABLE ...................................................................................................... 62
GAP UPDATE ADVERTISING DATA ............................................................................................ 64
GAP END DISCOVERABLE ........................................................................................................ 65
GAP ESTABLISH LINK REQUEST................................................................................................ 66
GAP TERMINATE LINK REQUEST .............................................................................................. 67
GAP AUTHENTICATE ............................................................................................................ 68
GAP UPDATE LINK PARAMETER REQUEST ............................................................................. 71
GAP PASSKEY UPDATE ......................................................................................................... 73
GAP SLAVE SECURITY REQUEST ........................................................................................... 74
GAP SIGNABLE .................................................................................................................... 75
GAP BOND .......................................................................................................................... 76
GAP TERMINATE AUTH ........................................................................................................ 77
Page 3 of 152

12.17
GAP SET PARAMETER .......................................................................................................... 78
12.18
GAP GET PARAMETER .......................................................................................................... 81
12.19
GAP RESOLVE PRIVATE ADDRESS ......................................................................................... 82
12.20
GAP SET ADVERTISEMENT TOKEN ........................................................................................ 83
12.21
GAP REMOVE ADVERTISEMENT TOKEN................................................................................. 84
12.22
GAP UPDATE ADVERTISEMENT TOKENS................................................................................ 86
12.22.1
GAP Bond Set Parameter............................................................................................. 87
12.22.2
GAP Bond Get Parameter ............................................................................................ 89
13.
GAP VENDOR SPECIFIC EVENTS ....................................................................................... 91
13.1
13.2
13.3
13.4
13.5
13.6
13.7
13.8
13.9
13.10
13.11
13.12
13.13
13.14
13.15
13.16
13.17
14.
UTIL VENDOR SPECIFIC COMMANDS............................................................................ 110
14.1
14.2
14.3
14.4
15.
UTIL RESET COMMAND ......................................................................................................... 110

UTIL NV READ COMMAND .................................................................................................... 110
UTIL NV WRITE COMMAND .................................................................................................. 112
UTIL FORCE BOOT COMMAND ............................................................................................... 113
L2CAP VENDOR SPECIFIC COMMANDS ......................................................................... 115
15.1
16.
L2CAP_CONNPARAMUPDATEREQ (0XFC92) ......................................................................... 115

L2CAP VENDOR SPECIFIC EVENTS ................................................................................. 117
16.1
16.2
17.
GAP DEVICE INIT DONE ........................................................................................................... 91

GAP DEVICE DISCOVERY ......................................................................................................... 92
GAP ADVERT DATA UPDATE DONE .......................................................................................... 93
GAP MAKE DISCOVERABLE DONE ............................................................................................ 93
GAP END DISCOVERABLE DONE ............................................................................................... 94
GAP LINK ESTABLISHED .......................................................................................................... 94
GAP LINK TERMINATED ........................................................................................................... 96
GAP LINK PARMETER UPDATE ................................................................................................. 97
GAP RANDOM ADDRESS CHANGED........................................................................................... 98
GAP SIGNATURE UPDATED ................................................................................................... 99
GAP AUTHENTICATION COMPLETE ..................................................................................... 100
GAP PASSKEY NEEDED....................................................................................................... 103
GAP SLAVE REQUESTED SECURITY ..................................................................................... 104
GAP DEVICE INFORMATION ................................................................................................ 105
GAP BOND COMPLETE ....................................................................................................... 107
GAP PAIRING REQUESTED .................................................................................................. 107
COMMAND STATUS ............................................................................................................. 109
L2CAP_CMDREJCT (0X0481) ................................................................................................ 117

L2CAP_CONNPARAMUPDATERSP (0X0493) ........................................................................... 117
ATT VENDOR SPECIFIC COMMANDS AND EVENTS .................................................... 119
17.1
17.2
17.3
17.4
17.5
17.6
17.7
17.8
17.9
17.10
ATT VENDOR SPECIFIC COMMANDS ....................................................................................... 119

ATT VENDOR SPECIFIC EVENTS ............................................................................................. 120
ATT_ERRORRSP (COMMAND = 0XFD01, EVENT = 0X0501) .................................................... 120
ATT_EXCHANGEMTUREQ (COMMAND = 0XFD02, EVENT = 0X0502) ..................................... 121
ATT_EXCHANGEMTURSP (COMMAND = 0XFD03, EVENT = 0X0503)...................................... 122
ATT_FINDINFOREQ (COMMAND = 0XFD04, EVENT = 0X0504) ............................................... 122
ATT_FINDINFORSP (COMMAND = 0XFD05, EVENT = 0X0505) ................................................ 122
ATT_FINDBYTYPEVALUEREQ (COMMAND = 0XFD06, EVENT = 0X0506)................................ 123
ATT_FINDBYTYPEVALUERSP (COMMAND = 0XFD07, EVENT = 0X0507) ................................ 124
ATT_READBYTYPEREQ (COMMAND = 0XFD08, EVENT = 0X0508) ..................................... 124
Page 4 of 152

17.11
17.12
17.13
17.14
17.15
17.16
17.17
17.18
17.19
17.20
17.21
17.22
17.23
17.24
17.25
17.26
17.27
17.28
18.
GATT VENDOR SPECIFIC COMMANDS .......................................................................... 135
18.1
18.2
18.3
18.4
18.5
18.6
18.7
18.8
18.9
18.10
18.11
18.12
18.13
18.14
18.15
18.16
18.17
18.18
18.19
18.20
18.21
18.22
18.23
18.24
18.25
19.
19.1
20.
ATT_READBYTYPERSP (COMMAND = 0XFD09, EVENT = 0X0509) ...................................... 125

ATT_READREQ (COMMAND = 0XFD0A, EVENT = 0X050A) ................................................ 126
ATT_READRSP (COMMAND = 0XFD0B, EVENT = 0X050B).................................................. 126
ATT_READBLOBREQ (COMMAND = 0XFD0C, EVENT = 0X050C) ........................................ 126
ATT_READBLOBRSP (COMMAND = 0XFD0D) ..................................................................... 127
ATT_READMULTIREQ (COMMAND = 0XFD0E, EVENT = 0X050E) ....................................... 127
ATT_READMULTIRSP (COMMAND = 0XFD0F, EVENT = 0X050F) ........................................ 128
ATT_READBYGRPTYPEREQ (COMMAND = 0XFD10, EVENT = 0X0510) ............................... 128
ATT_READBYGRPTYPERSP (COMMAND = 0XFD11, EVENT = 0X0511)................................ 129
ATT_WRITEREQ (COMMAND = 0XFD12, EVENT = 0X0512) ................................................ 129
ATT_WRITERSP (COMMAND = 0XFD13, EVENT = 0X0513) ................................................. 130
ATT_PREPAREWRITEREQ (COMMAND = 0XFD16, EVENT = 0X0516) ................................... 130
ATT_PREPAREWRITERSP (COMMAND = 0XFD17, EVENT = 0X0517) ................................... 131
ATT_EXECUTEWRITEREQ (COMMAND = 0XFD18, EVENT = 0X0518) .................................. 132
ATT_EXECUTEWRITERSP (COMMAND = 0XFD19, EVENT = 0X0519) ................................... 132
ATT_HANDLEVALUENOTI (COMMAND = 0XFD1B, EVENT = 0X051B) ................................. 132
ATT_HANDLEVALUEIND (COMMAND = 0XFD1D, EVENT = 0X051D) .................................. 133
ATT_HANDLEVALUECFM (COMMAND = 0XFD1E, EVENT = 0X051E) .................................. 133
GATT_EXCHANGEMTU (0XFD82) ........................................................................................ 135

GATT_DISCALLPRIMARYSERVICES (0XFD90) ....................................................................... 136
GATT_DISCPRIMARYSERVICEBYUUID (0XFD86) ................................................................. 136
GATT_FINDINCLUDEDSERVICES (0XFDB0) ........................................................................... 137
GATT_DISCALLCHARS (0XFDB2)......................................................................................... 137
GATT_DISCCHARSBYUUID (0XFD88).................................................................................. 138
GATT_DISCALLCHARDESCS (0XFD84) ................................................................................. 138
GATT_READCHARVALUE (0XFD8A)..................................................................................... 139
GATT_READUSINGCHARUUID (0XFDB4)............................................................................. 139
GATT_READLONGCHARVALUE (0XFD8C) ........................................................................ 140
GATT_READMULTICHARVALUES (0XFD8E) ..................................................................... 140
GATT_WRITENORSP (0XFDB6) ........................................................................................ 140
GATT_SIGNEDWRITENORSP (0XFDB8) ............................................................................. 141
GATT_WRITECHARVALUE (0XFD92) ................................................................................ 142
GATT_WRITELONGCHARVALUE (0XFD96) ....................................................................... 142
GATT_RELIABLEWRITES (0XFDBA).................................................................................. 143
GATT_READCHARDESC (0XFDBC) ................................................................................... 144
GATT_READLONGCHARDESC (0XFDBE) .......................................................................... 144
GATT_WRITECHARDESC (0XFDC0) .................................................................................. 144
GATT_WRITELONGCHARDESC (0XFDC2) ......................................................................... 145
GATT_NOTIFICATION (0XFD9B) ....................................................................................... 146
GATT_INDICATION (0XFD9D) ........................................................................................... 146
GATT_ADDSERVICE (0XFDFC) ......................................................................................... 146
GATT_DELSERVICE (0XFDFD) ......................................................................................... 147
GATT_ADDATTRIBUTE (0XFDFE)..................................................................................... 147
GATT VENDOR SPECIFIC EVENTS .................................................................................. 149

GATT_CLIENTCHARCFGUPDATED (0X0580) ......................................................................... 149
HOST ERROR CODES .......................................................................................................... 151
Page 5 of 152
TABLE OF FIGURES
Figure 1: Logical Organization of Application and BLE Stack ................................................................. 7
Figure 2: Single Device Configuration ...................................................................................................... 7
Figure 3: Dual Device Configuration ........................................................................................................ 8
Figure 4: Network Processor Configuration with HCI ............................................................................... 8
Figure 5: Command Packet .................................................................................................................... 11
Figure 6: Asynchronous Data Packet ...................................................................................................... 11
Figure 7: Event Packet............................................................................................................................ 12
Figure 8: Request/Response with Server Database in BLE Stack ............................................................. 24
Figure 9: Request/Response with Server Database not in BLE Stack ....................................................... 24
TABLE OF TABLES
Table 1: HCI Packet Types ..................................................................................................................... 10
Table 2: BLE Commands ....................................................................................................................... 14
Table 3: BLE Events .............................................................................................................................. 15
Table 4: Command Opcode Subgroups ................................................................................................... 15
Table 5: Vendor Specific Commands ...................................................................................................... 19
Table 6: Event Opcode Group................................................................................................................. 20
Table 7: Vendor Specific Events ............................................................................................................. 23
Table 8: List of Possible Host Error Codes ............................................................................................ 152
Page 6 of 152
1. Purpose
The purpose of this document is to describe the Texas Instruments Inc. (TI) vendor specific
Host Controller Interface (HCI) for Bluetooth low energy (BLE). This document is intended for
customer product software engineers and field application engineers working with the TI BLE
stack software.
2. Functional Overview
In BLE, there is a logical distinction between the Host software (often referred to as the higher
layer stack) and the Controller software (please see Figure 1).
Application
BLE Profiles/Protocols
BLE Host
BLE L2CAP
HCI
LL
BLE Controller
PHY
Figure 1: Logical Organization of Application and BLE Stack
These components can either exist on the same device (single-device configuration), or be
placed on separate devices (dual-device configuration) utilizing a Host Controller Interface
(HCI) for communication (see section 7 for more detail). In the single-device configuration,
there is obviously only one device, and the application software would execute on top of the
BLE profiles and stack (please see Figure 2).
Figure 2: Single Device Configuration
Page 7 of 152

In the a dual-device configuration, the application software would also execute on top of the
BLE profiles and stack, and only the controller would be located on a separate device (please
see Figure 3).
Figure 3: Dual Device Configuration
However, allowing an application to be developed on one device while communicating with the
BLE stack executing on another allows access to the BLE stack that would not normally be
available (please see Figure 4).
Figure 4: Network Processor Configuration with HCI

This configuration provides is a very convenient configuration for creating a test development
environment where the application is actually a test tool that can execute scripts, generate
logs, etc. Note however that the HCI as defined by Bluetooth only allows Controller commands
and events. As such, a set of Vendor Specific commands and events will be used instead, and
that is what this document intends to convey.
3. Numerical Notation Conventions

Multiple-octets may be specified in hexadecimal notation in one of two ways:
Standard Hexadecimal Notation
In this notation, a single hexadecimal radix indicator 0x precedes the entire value. The octet
order as read from left to right is from most significant octet to least significant octet. For
example, for the value 0x123456ABCDEF, 12 is the most significant octet and EF is the
least significant octet.
Colon Separated Hexadecimal Notation

In this notation, the hexadecimal radix indicator 0x is not used and octets are colon
separated. The octet order as read from left to right is from least significant octet to most
significant octet. For example, for the value 12:34:56:AB:CD:EF, 12 is the least significant
octet and EF is the most significant octet.
Page 8 of 152
4. Definitions, Abbreviations, Acronyms

Term
Definition
ATT
Attribute Protocol
BC
Broadcast
BLE
Bluetooth Low Energy
BT
Bluetooth
CMD
Command
CSG
Command Subgroup
EC
Event Code
EOEF
Event Opcode Event Field
EOGF
Event Opcode Group Field
ESG
Event Subgroup
GAP
Generic Access Profile
GATT
Generic Attribute Profile
HCI
Host Controller Interface
IDE
Integrated Development Environment
L2CAP
Logical Link Control and Adaptation Protocol
LE
Low Energy
LL
Link Layer
OCF
Opcode Command Field
OGF
Opcode Group Field
OTA
Over The Air
PB
Packet Boundary
PER
Packet Error Rate
PHY
Physical Layer
PPM
Parts Per Million
SCA
Sleep Clock Accuracy
SM
Security Manager
NV
Non-Volatile
5. References
[1] Specification of the Bluetooth System, Core Version 4.0, June 30, 2010.
http://www.bluetooth.com/Specification%20Documents/Core_V40.zip
Page 9 of 152
6. Revision History
Date (YMD)
Document
version
Description of changes
2010-09-30
V1.0
Initial
2011-07-13
V1.1
BLE V1.1 RTM.
2011-12-02
V1.1b
BLE V1.1b RTM.
2012-03-16
V1.2.1
BLE V1.2.1 RTM
2012-05-18
V1.2.2
BLE V1.2.2 RTM
2012-??-??
V1.3
BLE V1.3 RTM
7. HCI Overview
The HCI is a standardized Bluetooth interface for sending commands, receiving events, and
for sending and receiving data. It is typically realized as a serial interface, using either RS232
or USB communication devices. As the name implies, the HCI is used to bridge the Host and
Controller devices. Commands and Events can either be specified, or can be vendor specific
for extensibility. The following sections summarize the HCI protocol, the specification defined
commands and events used by BLE, and a detailed description of the vendor specific
commands and events defined by Texas Instruments Inc. For complete details on the HCI as
specified by the Special Interest Group (SIG), please see the Core specification [1].
8. Specification Interface
8.1 HCI Interface Protocol
The HCI supports four types of packets: Command Packet, Asynchronous Data Packet,
Synchronous Data Packet, and Event Packet. The packet type is a one byte value that
precedes the HCI packet. The packet type has the following values:
Packet
Packet Type
Command
Asynchronous Data
Synchronous Data
Event
Table 1: HCI Packet Types

The contents of each packet are shown as follows (please see section 5.4 of [1], Vol. 2, Part E
for additional details).
8.1.1 Command Packet

The command packet is comprised of the opcode, the number of parameters, and parameters
themselves.
Page 10 of 152
Figure 5: Command Packet
8.1.2 Asynchronous Data Packet

The asynchronous data packet is comprised of the connection handle, fragmentation bits, the
number of data bytes, and the data bytes themselves.
Figure 6: Asynchronous Data Packet
8.1.3 Synchronous Data Packet

This synchronous data packet is not used in BLE.
8.1.4 Event Packet

The event packet is comprised of the event code, the number of event parameters, and the
event parameters themselves.
Page 11 of 152
Figure 7: Event Packet
8.2 HCI Command

HCI commands use a 16-bit opcode for identification. The opcode is subdivided into two parts:
a 10-bit Opcode Command Field (OCF) and a 6-bit Opcode Group Field (OGF).
The OGF values are defined by the Bluetooth (BT) Core specification. The LE specification
has its own OGF value. Also, there is an escape OGF value so that vendor specific OCF
codes can be used. The following OGF values are valid for BLE:
Link Control Commands:
Link Policy Commands:
Controller and Baseband Commands:
Informational Parameters:
Status Parameters:
Testing Commands:
LE Only Commands:
Vendor Specific Commands:
63
The following table lists all specification BLE commands and their opcodes. Note that while all
commands can be used in a Network Processor Configuration with HCI, not all events will be
returned as they will be trapped and possibly discarded by the BLE Stack.
Page 12 of 152
Commands
LE Commands
OGF
OCF
Opcode
LE Set Event Mask
0x2001
LE Read Buffer Size
0x2002
LE Read Local Supported Features
0x2003
LE Set Random Address
0x2005
LE Set Advertising Parameters
0x2006
LE Read Advertising Channel TX Power
0x2007
LE Set Advertising Data
0x2008
LE Set Scan Response Data
0x2009
LE Set Advertise Enable
10
0x200A
LE Set Scan Parameters
11
0x200B
LE Set Scan Enable
12
0x200C
LE Create Connection
13
0x200D
LE Create Connection Cancel
14
0x200E
LE Read White List Size
15
0x200F
LE Clear White List
16
0x2010
LE Add Device To White List
17
0x2011
LE Remove Device From White List
18
0x2012
LE Connection Update
19
0x2013
LE Set Host Channel Classification
20
0x2014
LE Read Channel Map
21
0x2015
LE Read Remote Used Features
22
0x2016
LE Encrypt
23
0x2017
LE Rand
24
0x2018
LE Start Encryption
25
0x2019
LE Long Term Key Requested Reply
26
0x201A
LE Long Term Key Requested Negative Reply
27
0x201B
LE Read Supported States
28
0x201C
LE Receiver Test
29
0x201D
LE Transmitter Test (max TX power for CC2541 is 0 dBm)
30
0x201E
LE Test End Command
31
0x201F
Page 13 of 152
Commands
BT Commands for LE
OGF
OCF
Opcode
Disconnect
0x0406
Read Remote Version Information
29
0x041D
Set Event Mask
0x0C01
Reset
0x0C03
Read Transmit Power Level
45
0x0C2D
Set Controller To Host Flow Control (optional)
49
0x0C31
Host Buffer Size (optional)
51
0x0C33
Host Number Of Completed Packets (optional)
53
0x0C35
Read Local Version Information
0x1001
Read Local Supported Commands (optional)
0x1002
Read Local Supported Features
0x1003
Read BD_ADDR
0x1009
Read RSSI
0x1405
Table 2: BLE Commands
8.3 HCI Events

HCI events use an 8-bit event code. All event codes are unique for BT and BLE. Only event
code 255 is reserved for vendor specific events. There is only one event code for all LE
events. The first event parameter is used as the subevent code to distinguish the LE event
types.
The following table lists all the BLE events and their event codes, and subevent codes when
applicable:
Events
LE Events
Event Code
Subevent Code
LE Connection Complete
0x3E
0x01
LE Advertising Report
0x3E
0x02
LE Connection Update Complete
0x3E
0x03
LE Read Remote Used Features Complete
0x3E
0x04
LE Long Term Key Requested
0x3E
0x05
BT Events
Event Code
Disconnection Complete
0x05
Encryption Change
0x08
Page 14 of 152
Read Remote Version Information Complete
0x0C
Command Complete
0x0E
Command Status
0x0F
Hardware Error (optional)
0x10
Number Of Completed Packets
0x13
Data Buffer Overflow
0x1A
Encryption Key Refresh Complete
0x30
Table 3: BLE Events
9. Vendor Specific Interface

As mentioned, vendors can specify their own HCI commands and events by using the predefined vendor specific opcode and vendor specific event code.
9.1 Vendor Specific Commands

A vendor specific opcode is indicated by an OGF value of 63. The vendor can use the
remaining 10 bits (i.e. the OCF) as they like. TI defines its vendor specific OCF values by
subdividing the 10 bits into a 3 MSB Command Subgroup (CSG) and a 7 LSB Command
(CMD). The CSG is used by the HCI to route the commands to a designated subsystem within
the BLE stack. In this way, vendor specific commands can be specified for any BLE stack
layer.
HCI Vendor Specific Command Opcode, CSG=0..6

15
10 9
111111b
7 6
CSG (=0..6)
0
Command
The Command Subgroups are defined as follows:
CSG
Subgroup
HCI
L2CAP
ATT
GATT
GAP
UTIL
Reserved
User Profile
Table 4: Command Opcode Subgroups
Page 15 of 152
For Command Subgroups 0 to 6, the remaining 7 bits of Command provide up to 128

commands for each subgroup. For Subgroup 7, the remaining 7 bits specify one of 128 profiles
and indicates that the subsequent byte is to be used as the command for that particular profile
(i.e. up to 256 commands per profile).
The following table lists all TI-specific HCI commands:
Vendor Specific Commands

LE Commands
OGF
CSG
CMD
Opcode
HCI Extension Set Rx Gain
63
0xFC00
HCI Extension Set Tx Power
63
0xFC01
HCI Extension One Packet Per Event
63
0xFC02
HCI Extension Clock Divide On Halt
63
0xFC03
HCI Extension Declare NV Usage
63
0xFC04
HCI Extension Decrypt
63
0xFC05
HCI Extension Set Local Supported Features
63
0xFC06
HCI Extension Set Fast Tx Response Time
63
0xFC07
HCI Extension Modem Test Tx
63
0xFC08
HCI Extension Modem Hop Test Tx
63
0xFC09
HCI Extension Modem Test Rx
63
10
0xFC0A
HCI Extension End Modem Test
63
11
0xFC0B
HCI Extension Set BDADDR
63
12
0xFC0C
HCI Extension Set SCA
63
13
0xFC0D
HCI Extension Enable PTM1
63
14
0xFC0E
HCI Extension Set Frequency Tuning
63
15
0xFC0F
HCI Extension Save Frequency Tuning
63
16
0xFC10
Not supported by HCI; only direct function call is allowed. No event is returned.
Page 16 of 152

LE Commands
OGF
CSG
CMD
Opcode
HCI Extension Set Max DTM Tx Power
63
17
0xFC11
HCI Extension Map PM IO Port
63
18
0xFC12
HCI Extension Disconnect Immediate
63
19
0xFC13
HCI Extension Packet Error Rate
63
20
0xFC14
HCI Extension Packet Error Rate by Channel2
63
21
0xFC15
HCI Extension Extend RF Range
63
22
0xFC16
63
23
0xFC17
HCI Extension Connection Event Notice
63
24
0xFC18
HCI Extension Halt During RF
63
25
0xFC19
L2CAP Connection Parameter Update Request
63
18
0xFC92
ATT Error Response
63
0xFD01
ATT Exchange MTU Request
63
0xFD02
ATT Exchange MTU Response
63
0xFD03
ATT Find Information Request
63
0xFD04
ATT Find Information Response
63
0xFD05
ATT Find By Type Value Request
63
0xFD06
ATT Find By Type Value Response
63
0xFD07
ATT Read By Type Request
63
0xFD08
ATT Read By Type Response
63
0xFD09
ATT Read Request
63
10
0xFD0A
ATT Read Response
63
11
0xFD0B
ATT Read Blob Request
63
12
0xFD0C
ATT Read Blob Response
63
13
0xFD0D
ATT Read Multiple Request
63
14
0xFD0E
ATT Read Multiple Response
63
15
0xFD0F
ATT Read By Group Type Request
63
16
0xFD10
ATT Read By Group Type Response
63
17
0xFD11
ATT Write Request
63
18
0xFD12
ATT Write Response
63
19
0xFD13
ATT Prepare Write Request
63
22
0xFD16
HCI Extension Advertiser Event Notice2

2
Page 17 of 152

LE Commands
OGF
CSG
CMD
Opcode
ATT Prepare Write Response
63
23
0xFD17
ATT Execute Write Request
63
24
0xFD18
ATT Execute Write Response
63
25
0xFD19
ATT Handle Value Notification
63
27
0xFD1B
ATT Handle Value Indication
63
29
0xFD1D
ATT Handle Value Confirmation
63
30
0xFD1E
GATT Discover Characteristics By UUID
63
0xFD88
GATT Write Long
63
22
0xFD96
GAP Device Initialization
63
0xFE00
GAP Configure Device Address
63
0xFE03
GAP Device Discovery Request
63
0xFE04
GAP Device Discovery Cancel
63
0xFE05
GAP Make Discoverable
63
0xFE06
GAP Update Advertising Data
63
0xFE07
GAP End Discoverable
63
0xFE08
GAP Establish Link Request
63
0xFE09
GAP Terminate Link Request
63
10
0xFE0A
GAP Authenticate
63
11
0xFE0B
GAP Passkey Update
63
12
0xFE0C
GAP Slave Security Request
63
13
0xFE0D
GAP Signable
63
14
0xFE0E
GAP Bond
63
15
0xFE0F
GAP Terminate Auth
63
16
0xFE10
GAP Update Link Parameter Request
63
17
0xFE11
GAP Set Parameter
63
48
0xFE30
GAP Get Parameter
63
49
0xFE31
GAP Resolve Private Address
63
50
0xFE32
GAP Set Advertisement Token
63
51
0xFE33
GAP Remove Advertisement Token
63
52
0xFE34
GAP Update Advertisement Tokens
63
53
0xFE35
GAP Bond Set Parameter
63
54
0xFE36
GAP Bond Get Parameter
63
55
0xFE37
Page 18 of 152

LE Commands
OGF
CSG
CMD
Opcode
UTIL Reset
63
0xFE80
UTIL NV Read
63
0xFE81
UTIL NV Write
63
0xFE82
Reserved
63
0xFF00
User Profiles
63
0xFF80
Table 5: Vendor Specific Commands
Page 19 of 152
9.2 Vendor Specific Events

A vendor specific event code is indicated by a value of 255. The vendor must then use event
parameters (following the length byte) to specify vendor specific events. TI defines the
following two bytes as the Event Opcode.
The Event Opcode was chosen to mirror the Command Opcode by dividing it into two parts: a
6 bit Event Opcode Group Field (EOGF), and a 10 bit Event Opcode Event Field (EOEF).
The EOEF is again chosen to mirror the Command OCF by dividing it into two parts: the Event
Subgroup (ESG) and the Event.
The EOGF is defined as follows:
EOGF
Group
Embedded Opcode
Core Opcode
Profile Request
Profile Response
4 .. 63
Reserved
Table 6: Event Opcode Group

The ESG is defined as in Table 4. The Events are as defined in the following table. Please
note that the value of the Events cannot be less than 0x400 as the first 1024 values are
reserved. The reason for this has to do with Client/Server Request/Response Tunneling, which
is described in the following section. Tunneling requires embedding Command Opcodes in HCI
Events. When this is done, the EOGF is zero, and the remaining 10 bits is the Command
Opcode. In order to prevent Command and Event Opcode overlap, the first 1024 values are
reserved in the Event Opcode space. Also note that the Event Code (EC) is always 0xFF since
normally only Controller events are returned via the HCI.
Page 20 of 152
Vendor Specific Events

LE Events
EC
EOGF ESG
Event
Opcode
HCI Extension Set Rx Gain
0xFF
0x0400
HCI Extension Set Tx Power
0xFF
0x0401
HCI Extension One Packet Per Event
0xFF
0x0402
HCI Extension Clock Divide On Halt
0xFF
0x0403
HCI Extension Declare NV Usage
0xFF
0x0404
HCI Extension Decrypt
0xFF
0x0405
HCI Extension Set Local Supported Features
0xFF
0x0406
HCI Extension Set Fast Tx Response Time
0xFF
0x0407
HCI Extension Modem Test Tx
0xFF
0x0408
HCI Extension Modem Hop Test Tx
0xFF
0x0409
HCI Extension Modem Test Rx
0xFF
10
0x040A
HCI Extension End Modem Test
0xFF
11
0x040B
HCI Extension Set BDADDR
0xFF
12
0x040C
HCI Extension Set SCA
0xFF
13
0x040D
0xFF
14
0x040E
HCI Extension Set Frequency Tuning
0xFF
15
0x040F
HCI Extension Save Frequency Tuning
0xFF
16
0x0410
HCI Extension Set Max DTM Tx Power
0xFF
17
0x0411
HCI Extension Map PM IO Port
0xFF
18
0x0412
HCI Extension Disconnect Immediate
0xFF
19
0x0413
HCI Extension Packet Error Rate
0xFF
20
0x0414
HCI Extension Packet Error Rate by Channel3
0xFF
21
0x0415
HCI Extension Extend RF Range
0xFF
22
0x0416
0xFF
23
0x0417
HCI Connection Event Notice
0xFF
24
0x0418
HCI Halt During RF
0xFF
25
0x0419
L2CAP Command Reject
0xFF
0x0481
0xFF
19
0x0493
0xFF
0x0501
HCI Extension Enable PTM
HCI Advertiser Event Notice
L2CAP
Connection
Response
ATT Error Response
Parameter
Update
Page 21 of 152

LE Events
EC
EOGF ESG
Event
Opcode
ATT Exchange MTU Request
0xFF
0x0502
ATT Exchange MTU Response
0xFF
0x0503
0xFF
0x0504
0xFF
0x0505
ATT Find By Type Value Request
0xFF
0x0506
ATT Find By Type Value Response
0xFF
0x0507
ATT Read By Type Request
0xFF
0x0508
ATT Read By Type Response
0xFF
0x0509
ATT Read Request
0xFF
10
0x050A
ATT Read Response
0xFF
11
0x050B
ATT Read Blob Request
0xFF
12
0x050C
ATT Read Blob Response
0xFF
13
0x050D
ATT Read Multiple Request
0xFF
14
0x050E
ATT Read Multiple Response
0xFF
15
0x050F
ATT Read By Group Type Request
0xFF
16
0x0510
ATT Read By Group Type Response
0xFF
17
0x0511
ATT Write Request
0xFF
18
0x0512
ATT Write Response
0xFF
19
0x0513
ATT Prepare Write Request
0xFF
22
0x0516
ATT Prepare Write Response
0xFF
23
0x0517
ATT Execute Write Request
0xFF
24
0x0518
ATT Execute Write Response
0xFF
25
0x0519
ATT Handle Value Notification
0xFF
27
0x051B
ATT Handle Value Indication
0xFF
29
0x051D
ATT Handle Value Confirmation
0xFF
30
0x051E
GAP Device Init Done
0xFF
0x0600
GAP Device Discovery
0xFF
0x0601
GAP Advert Data Update Done
0xFF
0x0602
GAP Make Discoverable Done
0xFF
0x0603
GAP End Discoverable Done
0xFF
0x0604
GAP Link Established
0xFF
0x0605
GAP Link Terminated
0xFF
0x0606
Page 22 of 152

LE Events
EC
EOGF ESG
Event
Opcode
GAP Link Parameter Update
0xFF
0x0607
GAP Random Address Changed
0xFF
0x0608
GAP Signature Updated
0xFF
0x0609
GAP Authentication Complete
0xFF
10
0x060A
GAP Passkey Needed
0xFF
11
0x060B
GAP Slave Requested Security
0xFF
12
0x060C
GAP Device Information
0xFF
13
0x060D
GAP Bond Complete
0xFF
14
0x060E
GAP Pairing Requested
0xFF
15
0x060F
Command Status
0xFF
127
0x067F
Table 7: Vendor Specific Events
You will note that there are two EOGF values for Profiles. At this time, no profiles are defined
well enough to document here. These values are defined in anticipation of not only needing
large numbers of profiles and their commands, but also of needing the direction the command
is travelling when embedded in an HCI Command or Event. You can see that ATT does not
have this issue as these commands are already defined using even values for commands and
odd values for events, and thus, direction is distinguishable. For profiles, it is not yet known
how the commands and events will be defined.
Page 23 of 152
9.3 Request and Response Tunneling

In the Client/Server model defined and supported by the BLE stack, the Client sends Requests
to the Server and the Server sends Responses back to the Client. The Requests sent by the
Client may be handled by a Server on the same device, or they may travel OTA to the Server
on another device. Similarly, the Response sent by the Server may be handled by a Client on
the same device, or may be sent OTA to a Client on another device from which the request
came. But in either case, as long as the Requests and Responses remain within the scope of
the BLE stack software (i.e. the BLE Server database is on the device), the BLE stack remains
unconcerned about whether the Requests and Responses are sent/received by the same
device or are from another device. Please see Figure 8.
Figure 8: Request/Response with Server Database in BLE Stack

However, when using the Network Processor Configuration with HCI such that the Server
database is not located on the device, then Requests and Reponses have to be mapped into
HCI Commands and Events. The HCI is specified such that only Commands are sent from the
Host to the Controller, and only Events are sent from the Controller to the Host. If the Server
database is located on say a PC, then when an OTA Request is received by the Server device,
it must be sent to the PC via the HCI. Even though the Request started out on one end as an
HCI Command, it must be provided to the remote PC as an HCI event on the other. Similarly,
when the PC sends the Response on one end, which will be an HCI Event to the remote PC on
the other, it must be sent to the device as an HCI Command. Thus, the Request, which starts
out as an HCI Command, must be embedded in an HCI Event when received by the remote
PC, and the Response, which starts out as an HCI Command, must be embedded in an HCI
Event when received by the remote PC. In this way, Requests and Responses are being
tunneled in HCI Commands and Events. Please see Figure 9.
Figure 9: Request/Response with Server Database not in BLE Stack

Page 24 of 152
10. HCI Extension Vendor Specific Commands

In addition to the BLE HCI commands, the following HCI Extension vendor specific commands are also
available.
10.1 HCI Extension Set Receiver Gain

Command
Opcode
Command Parameters
Return Parameters
HCI_EXT_SetRxGainCmd
0xFC00
rxGain
Status
Description
This command is used to set the RF receiver gain. The default system value for this feature is
standard receiver gain.
Command Parameters
rxGain: (1 byte)
Value
Parameter Description
0x00
HCI_EXT_RX_GAIN_STD
0x01
HCI_EXT_RX_GAIN_HIGH
Return Parameters
Status: (1 byte)
Value
0x00
HCI_SUCCESS
Event(s) Generated
When the HCI_EXT_SetRxGainCmd has completed, a vendor specific Command Complete event
shall be generated.
10.2 HCI Extension Set Transmitter Power

Command
Opcode
Command Parameters
Return Parameters
HCI_EXT_SetTxPowerCmd
0xFC01
txPower
Status
Description
This command is used to set the RF transmitter output power. The default system value for this feature
is 0 dBm. Note that a setting of 4dBm is only allowed for the CC2540.
Command Parameters
txPower: (1 byte)
Value
0x00
HCI_EXT_TX_POWER_MINUS_23_DBM
0x01
Page 25 of 152
Value
0x02
HCI_EXT_TX_POWER_0_DBM
0x03
HCI_EXT_TX_POWER_4_DBM (CC2540 only)
Return Parameters
Status: (1 byte)
Value
0x00
HCI_SUCCESS
Event(s) Generated
When the HCI_EXT_SetTxPowerCmd has completed, a vendor specific Command Complete event
shall be generated.
10.3 HCI Extension One Packet Per Event

Command
Opcode
Command Parameters
Return Parameters
HCI_EXT_OnePacketPerEventCm
d
0xFC02
control
Status
Description
This command is used to configure the Link Layer to only allow one packet per connection event. The
default system value for this feature is disabled.
This command can be used to tradeoff throughput and power consumption during a connection. When
enabled, power can be conserved during a connection by limiting the number of packets per
connection event to one, at the expense of more limited throughput. When disabled, the number of
packets transferred during a connection event is not limited, at the expense of higher power
consumption.
Command Parameters
control: (1 byte)
Value
0x00
HCI_EXT_DISABLE_ONE_PKT_PER_EVT
0x01
HCI_EXT_ENABLE_ONE_PKT_PER_EVT
Return Parameters
Status: (1 byte)
Value
0x00
HCI_SUCCESS
Event(s) Generated
When the HCI_EXT_OnePacketPerEventCmd has completed, a vendor specific Command Complete
event shall be generated.
Page 26 of 152
10.4 HCI Extension Clock Divide On Halt

Command
Opcode
Command Parameters
Return Parameters
HCI_EXT_ClkDivOnHaltCmd
0xFC03
control
Status
Description
This command is used to configure the Link Layer to divide the system clock when the MCU is halted
during a radio operation. The default system value for this feature is disabled.
Note: This command is only valid when the MCU is halted during RF operation (please see
HCI_EXT_HaltDuringRfCmd).
Command Parameters
control: (1 byte)
Value
0x00
HCI_EXT_DISABLE_CLK_DIVIDE_ON_HALT
0x01
HCI_EXT_ENABLE_CLK_DIVIDE_ON_HALT
Return Parameters
Status: (1 byte)
Value
0x00
HCI_SUCCESS
Event(s) Generated
When the HCI_EXT_ClkDivOnHaltCmd has completed, a vendor specific Command Complete event
shall be generated.
10.5 HCI Extension Declare NV Usage

Command
Opcode
Command Parameters
Return Parameters
HCI_EXT_DeclareNvUsageCmd
0xFC04
mode
Status
Description
This command is used to inform the Controller whether the Host is using NV memory during BLE
operations. The default system value for this feature is NV In Use.
When the NV is not in use during BLE operations, the Controller is able to bypass internal checks that
reduce overhead processing, thereby reducing average power consumption.
Note: This command is only allowed when the BLE Controller is idle.
Note: Using NV when declaring it is not in use may result in a hung BLE Connection.
Page 27 of 152
Command Parameters
control: (1 byte)
Value
0x00
HCI_EXT_NV_NOT_IN_USE
0x01
HCI_EXT_NV_IN_USE
Return Parameters
Status: (1 byte)
Value
0x00
HCI_SUCCESS
Event(s) Generated
When the HCI_EXT_DeclareNvUsageCmd has completed, a vendor specific Command Complete
10.6 HCI Extension Decrypt

Command
Opcode
Command Parameters
Return Parameters
HCI_EXT_DecryptCmd
0xFC05
key, encText
Status
Description
This command is used to decrypt encrypted text using AES128.
Command Parameters
key: (16 bytes)
Value
0xXXXXXXXXXXXXXXXX
XXXXXXXXXXXXXXXX
128 bit key for the decryption of the data given in the command.
The most significant octet of the data corresponds to key[0] using
the notation specified in FIPS 197.
encText: (16 bytes)

Value
0xXXXXXXXXXXXXXXXX
XXXXXXXXXXXXXXXX
128 bit encrypted data to be decrypted. The most significant octet

of the key corresponds to key[0] using the notation specified in
FIPS 197.
Return Parameters
Status: (1 byte)
Value
Page 28 of 152
0x00
HCI_SUCCESS
Event(s) Generated
When the HCI_EXT_DecryptCmd has completed, a vendor specific Command Complete event shall
be generated.
10.7 HCI Extension Set Local Supported Features

Command
Opcode
Command Parameters
Return Parameters
HCI_EXT_SetLocalSupportedFeaturesCm
d
0xFC06
localFeatures
Status
Description
This command is used to set the Controllers Local Supported Features. For a complete list of
supported LE features, please see [1], Part B, Section 4.6.
Note: This command can be issued either before or after one or more connections are formed.
However, the local features set in this manner are only effective if performed before a Feature
Exchange Procedure has been initiated by the Master. Once this control procedure has been
completed for a particular connection, only the exchanged feature set for that connection will be used.
Command Parameters
localFeatures: (8 bytes)
Value
0x0000000000000001
Encryption Feature
0xFFFFFFFFFFFFFFF
E
Reserved for future use
Return Parameters
Status: (1 byte)
Value
0x00
HCI_SUCCESS
Event(s) Generated
When the HCI_EXT_SetLocalSupportedFeaturesCmd has completed, a vendor specific Command
Complete event shall be generated.
10.8 HCI Extension Set Fast Transmit Response Time

Command
Opcode
Command Parameters
Return Parameters
HCI_EXT_SetFastTxResponseTimeCmd
0xFC07
control
Status
Description
Page 29 of 152

This command is used to configure the Link Layer fast transmit response time feature. The default
system value for this feature is enabled.
Note: This command is only valid for a Slave controller.
When the Host transmits data, the controller (by default) ensures the packet is sent over the LL
connection with as little delay as possible, even when the connection is configured to use slave
latency. That is, the transmit response time will tend to be no longer than the connection interval. This
results in lower power savings since the LL may need to wake to transmit during connection events that
would normally have been skipped. If saving power is more critical than fast transmit response time,
then this feature can be disabled using this command. When disabled, the transmit response time will
be no longer than slave latency + 1 times the connection interval.
Command Parameters
control: (1 byte)
Value
0x00
HCI_EXT_DISABLE_FAST_TX_RESP_TIME
0x01
HCI_EXT_ENABLE_FAST_TX_RESP_TIME
Return Parameters
Status: (1 byte)
Value
0x00
HCI_SUCCESS
Event(s) Generated
When the HCI_EXT_SetFastTxResponseTimeCmd has completed, a vendor specific Command
Complete event shall be generated.
10.9 HCI Extension Modem Test Transmit

Command
Opcode
Command Parameters
Return Parameters
HCI_EXT_ModemTestTxCmd
0xFC08
cwMode, txFreq
Status
Description
This API is used to start a continuous transmitter modem test, using either a modulated or
unmodulated carrier wave tone, at the frequency that corresponds to the specified RF channel. Use the
HCI_EXT_EndModemTest command to end the test.
Note: The RF channel, not the BLE frequency, is specified! You can obtain the RF channel from the
BLE frequency as follows: RF Channel = (BLE Frequency 2402) / 2.
Note: When the HCI_EXT_EndModemTest is issued to stop this test, a Controller reset will take place.
Note: The device will transmit at the default output power (0 dBm) unless changed by
HCI_EXT_SetTxPowerCmd.
Page 30 of 152

Note: This modem test can be used to satisfy in part radio regulation requirements as specific in
standards such as ARIB STD-T66.
Command Parameters
cwMode: (1 byte)
Value
0x00
HCI_EXT_TX_MODULATED_CARRIER
0x01
HCI_EXT_TX_UNMODULATED_CARRIER
t
txFreq: (1 bytes)
Value
0..39
RF channel of transmit frequency.
Return Parameters
Status: (1 byte)
Value
0x00
HCI_SUCCESS
Event(s) Generated
When the HCI_EXT_ModemTestTxCmd has completed, a vendor specific Command Complete event
shall be generated.
10.10 HCI Extension Modem Hop Test Transmit

Command
Opcode
HCI_EXT_ModemHopTestTxCmd
0xFC09
Command Parameters
Return Parameters
Status
Description
This API is used to start a continuous transmitter direct test mode test using a modulated carrier wave
and transmitting a 37 byte packet of pseudo-random 9 bit data. A packet is transmitted on a different
frequency (linearly stepping through all RF channels 0..39) every 625us. Use the
HCI_EXT_EndModemTest command to end the test.
Note: The device will transmit at the default output power (0 dBm) unless changed by
HCI_EXT_SetTxPowerCmd.
Command Parameters:
Page 31 of 152

None
Return Parameters
Status: (1 byte)
Value
0x00
HCI_SUCCESS
Event(s) Generated
When the HCI_EXT_ModemHopTestTxCmd has completed, a vendor specific Command Complete
10.11 HCI Extension Modem Test Receive

Command
Opcode
Command Parameters
Return Parameters
HCI_EXT_ModemTestRxCmd
0xFC0A
rxFreq
Status
Description
This API is used to start a continuous receiver modem test using a modulated carrier wave tone, at the
frequency that corresponds to the specific RF channel. Any received data is discarded. Receiver gain
may be adjusted using the HCI_EXT_SetRxGain command. RSSI may be read during this test by
using the HCI_ReadRssi command. Use HCI_EXT_EndModemTest command to end the test.
Note: The RF channel, not the BLE frequency, is specified! You can obtain the RF channel from the
BLE frequency as follows: RF Channel = (BLE Frequency 2402) / 2.
Command Parameters
rxFreq: (1 bytes)
Value
0..39
RF channel of receive frequency.
Return Parameters
Status: (1 byte)
Value
0x00
HCI_SUCCESS
Event(s) Generated
When the HCI_EXT_ModemTestRxCmd has completed, a vendor specific Command Complete event
shall be generated.
Page 32 of 152
10.12 HCI Extension End Modem Test

Command
Opcode
HCI_EXT_EndModemTestCmd
0xFC0B
Command Parameters
Return Parameters
Status
Description
This API is used to shutdown a modem test. A Controller reset will take place.
Command Parameters
None
Return Parameters
Status: (1 byte)
Value
0x00
HCI_SUCCESS
Event(s) Generated
When the HCI_EXT_EndModemTestCmd has completed, a vendor specific Command Complete
10.13 HCI Extension Set BDADDR

Command
Opcode
Command Parameters
Return Parameters
HCI_EXT_SetBDADDRCmd
0xFC0C
bdAddr
Status
Description
This command is used to set this devices BLE address (BDADDR). This address will override the
devices address determined when the device is reset (i.e. a hardware reset, not an HCI Controller
Reset). To restore the devices initialized address, issue this command with an invalid address.
Note: This command is only allowed when the Controller is in the Standby state.
Command Parameters
bdAddr: (6 bytes)
Value
0x000000000000..
Valid BLE device address.
0xFFFFFFFFFFFE
0xFFFFFFFFFFFF
Invalid BLE device address. Used to restore the device address to

that which was determined at initialization.
Page 33 of 152
Return Parameters
Status: (1 byte)
Value
0x00
HCI_SUCCESS
Event(s) Generated
When the HCI_EXT_SetBDADDRCmd has completed, a vendor specific Command Complete event
shall be generated.
10.14 HCI Extension Set SCA

Command
Opcode
Command Parameters
Return Parameters
HCI_EXT_SetSCACmd
0xFC0D
scaInPPM
Status
Description
This command is used to set this devices Sleep Clock Accuracy (SCA) value, in parts per million
(PPM), from 0 to 500. For a Master device, the value is converted to one of eight ordinal values
representing a SCA range (per [1], Volume 6, Part B, Section 2.3.3.1, Table 2.2), which will be used
when a connection is created. For a Slave device, the value is directly used. The system default value
for a Master and Slave device is 50ppm and 40ppm, respectively.
Note: This command is only allowed when the device is not in a connection.
Note: The devices SCA value remains unaffected by an HCI Reset.
Command Parameters
scaInPPM: (2 bytes)
Value
0..0x1F4
Valid SCA value.
0x01F5..0xFFFF
Invalid SCA value.
Return Parameters
Status: (1 byte)
Value
0x00
HCI_SUCCESS
Event(s) Generated
When the HCI_EXT_SetSCACmd has completed, a vendor specific Command Complete event shall
be generated.
Page 34 of 152
10.15 HCI Extension Enable PTM

Command
Opcode
HCI_EXT_EnablePTMCmd
0xFC0E
Command Parameters
Return Parameters
Status
Description
This command is used to enable Production Test Mode (PTM). This mode is used by the customer
during assembly of their product to allow limited access to the BLE Controller for testing and
configuration. This command is only available when the BLE Controller is built without external access
to the Controller (i.e. when no transport interface such as RS232 is permitted). This mode will remain
enabled until the device is reset. Please see the related application note for additional details.
Note: This command is only allowed as a direct function call, and is only intended to be used by an
embedded application. No vendor specific Command Complete event will be generated.
Command Parameters
None
Return Parameters
Status: (1 byte)
Value
0x00
HCI_SUCCESS
0x0C
HCI_ERROR_CODE_CMD_DISALLOWED
Event(s) Generated
When the HCI_EXT_EnablePTMCmd has completed, it will simply return. No vendor specific
Command Complete event will be generated.
10.16 HCI Extension Set Frequency Tuning

Command
Opcode
Command Parameters
Return Parameters
HCI_EXT_SetFreqTuneCmd
0xFC0F
step
Status
Description
This PTM-only command is used to set this devices Frequency Tuning either up one step or down one
step. When the current setting is already at its max value, then stepping up will have no effect. When
the current setting is already at its min value, then stepping down will have no effect. This setting will
only remain in effect until the device is reset unless HCI_EXT_SaveFreqTuneCmd is used to save it
in non-volatile memory.
Page 35 of 152
Command Parameters
mode: (1 bytes)
Value
HCI_PTM_SET_FREQ_TUNE_DOWN
HCI_PTM_SET_FREQ_TUNE_UP
Return Parameters
Status: (1 byte)
Value
0x00
HCI_SUCCESS
Event(s) Generated
When the HCI_EXT_SetFreqTuneCmd has completed, a vendor specific Command Complete event
shall be generated.
10.17 HCI Extension Save Frequency Tuning

Command
Opcode
HCI_EXT_SaveFreqTuneCmd
0xFC10
Command Parameters
Return Parameters
Status
Description
This PTM-only command is used to save this devices Frequency Tuning setting in non-volatile
memory. This setting will be used by the BLE Controller upon reset, and when waking from Sleep.
Command Parameters
None
Return Parameters
Status: (1 byte)
Value
0x00
HCI_SUCCESS
Event(s) Generated
When the HCI_EXT_SaveFreqTuneCmd has completed, a vendor specific Command Complete
Page 36 of 152
10.18 HCI Extension Set Max DTM Transmitter Power

Command
Opcode
Command Parameters
Return Parameters
HCI_EXT_SetMaxDtmTxPowerCmd
0xFC11
txPower
Status
Description
This command is used to override the RF transmitter output power used by the Direct Test Mode
(DTM). Normally, the maximum transmitter output power setting used by DTM is the maximum
transmitter output power setting for the device (i.e. 4 dBm for the CC2540; 0 dBm for the CC2541).
This command will change the value used by DTM.
Note: When DTM is ended by a call to HCI_LE_TestEndCmd, or a HCI_Reset is used, the transmitter
output power setting is restored to the default value of 0 dBm.
Command Parameters
txPower: (1 byte)
Value
0x00
0x01
0x02
HCI_EXT_TX_POWER_0_DBM
0x03
HCI_EXT_TX_POWER_4_DBM (CC2540 only)
Return Parameters
Status: (1 byte)
Value
0x00
HCI_SUCCESS
Event(s) Generated
When the HCI_EXT_SetMaxDtmTxPowerCmd has completed, a vendor specific Command Complete
10.19 HCI Extension Map PM IO Port

Command
Opcode
Command Parameters
Return Parameters
HCI_EXT_MapPmInOutPortCmd
0xFC12
ioPort, ioPin
Status
Description
This command is used to configure and map a CC254x I/O Port as a General-Purpose I/O (GPIO)
output signal that reflects the Power Management (PM) state of the CC254x device. The GPIO output
will be High on Wake, and Low upon entering Sleep. This feature can be disabled by specifying
HCI_EXT_PM_IO_PORT_NONE for the ioPort (ioPin is then ignored). The system default value upon
hardware reset is disabled.
This command can be used to control an external DC-DC Converter (its actual intent) such has the TI
TPS62730 (or any similar converter that works the same way). This command should be used with
Page 37 of 152

extreme care as it will override how the Port/Pin was previously configured! This includes the
mapping of Port 0 pins to 32kHz clock output, Analog I/O, UART, Timers; Port 1 pins to Observables,
Digital Regulator status, UART, Timers; Port 2 pins to an external 32kHz XOSC. The selected Port/Pin
will be configured as an output GPIO with interrupts masked. Careless use can result in a
reconfiguration that could disrupt the system. For example, if the Port/Pin is being used as part of the
serial interface for the device, the Port/Pin will be reconfigured from its original Peripheral function to a
GPIO, disrupting the serial port. It is therefore the users responsibility to ensure the selected
Port/Pin does not cause any conflicts in the system.
Note: Only Pins 0, 3 and 4 are valid for Port 2 since Pins 1 and 2 are mapped to debugger signals DD
and DC.
Note: Port/Pin signal change will obviously only occur when Power Savings is enabled.
Note: The CC254xEM modules map the TI TPS62730 control signal to P1.2, which happens to map to
the SmartRF05EB LCD Chip Select. Thus, the LCD cant be used when setup this way.
Command Parameters
ioPort: (1 byte)
Value
0x00
HCI_EXT_PM_IO_PORT_P0
0x01
0x02
0xFF
HCI_EXT_PM_IO_PORT_NONE
ioPin: (1 byte)
Value
0x00
HCI_EXT_PM_IO_PORT_PIN0
0x01
0x02
0x03
0x04
0x05
0x06
0x07
Return Parameters
Status: (1 byte)
Value
0x00
HCI_SUCCESS
Event(s) Generated
When the HCI_EXT_MapPmIoPortCmd has completed, a vendor specific Command Complete event
shall be generated.
Page 38 of 152
10.20 HCI Extension Disconnect Immediate

Command
Opcode
Command Parameters
Return Parameters
HCI_EXT_DisconnectImmedCmd
0xFC13
connHandle
Status
Description
This command is used to disconnect a connection immediately. This command can be useful for when
a connection needs to be ended without the latency associated with the normal BLE Controller
Terminate control procedure.
Note that the Host issuing the command will still receive the HCI Disconnection Complete event with a
Reason status of 0x16 (i.e. Connection Terminated by Local Host), followed by an HCI Vendor Specific
Event.
Command Parameters
connHandle: (2 bytes)
Value
Connection Handle to be used to identify a connection.
Note: 0x0F00 0x0FFF are reserved for future use.
0x0000 .. 0x0EFF
Return Parameters
Status: (1 byte)
Value
0x00
HCI_SUCCESS
Event(s) Generated
When the HCI_EXT_DisconnectImmedCmd has completed, an HCI Disconnection Complete event
followed by a vendor specific Command Complete event shall be generated.
10.21 HCI Extension Packet Error Rate

Command
Opcode
Command Parameters
Return Parameters
HCI_EXT_PacketErrorRateCmd
0xFC14
connHandle, command
Status
Description
This command is used to Reset or Read the Packet Error Rate counters for a connection. When Reset,
the counters are cleared; when Read, the total number of packets received, the number of packets
received with a CRC error, the number of events, and the number of missed events are returned. The
system default value upon hardware reset is Reset.
Note: The counters are only 16 bits. At the shortest connection interval, this provides a little over 8
minutes of data.
Command Parameters
Value
Page 39 of 152
Value
0x0000 .. 0x0EFF
command: (1 byte)
Value
0x00
HCI_EXT_PER_RESET
0x01
HCI_EXT_PER_READ
Return Parameters
Status: (1 byte)
Value
0x00
HCI_SUCCESS
Event(s) Generated
When the HCI_EXT_PacketErrorRateCmd has completed, a vendor specific Command Complete
event followed by a vendor specific Command Complete event shall be generated.
10.22 HCI Extension Packet Error Rate By Channel

Command
Opcode
Command Parameters
Return Parameters
HCI_EXT_PERbyChanCmd
0xFC15
connHandle, *perByChan
Status
Description
This command is used to start or end Packet Error Rate by Channel counter accumulation for a
connection, and can be used by an application to make Coexistence assessments. Based on the
results, an application can perform an Update Channel Classification command to limit channel
interference from other wireless standards. If *perByChan is NULL, counter accumulation will be
discontinued. If *perByChan is not NULL, then it is assumed that there is sufficient memory for the
PER data, based on the following type definition perByChan_t located in ll.h:
#define LL_MAX_NUM_DATA_CHAN 37
// Packet Error Rate Information By Channel

typedef struct
{
uint16 numPkts[ LL_MAX_NUM_DATA_CHAN ];
uint16 numCrcErr[ LL_MAX_NUM_DATA_CHAN ];
} perByChan_t;
Page 40 of 152

embedded application.
Note: It is the users responsibility to ensure there is sufficient memory allocated! The user is
also responsible for maintaining the counters, clearing them if required before starting accumulation.
Note: As indicated, the counters are 16 bits. At the shortest connection interval, this provides a bit over
8 minutes of data.
Note: This command can be used in combination with HCI_EXT_PacketErrorRateCmd.
Command Parameters
Value
0x0000 .. 0x0EFF
*perByChan: (1 byte)
Value
NULL
Non-NULL
End counter accumulation.

Start counter accumulation by channel.
Return Parameters
Status: (1 byte)
Value
0x00
HCI_SUCCESS
Event(s) Generated
When the HCI_EXT_PERbyChanCmd has completed, a vendor specific Command Complete event
shall be generated.
10.23 HCI Extension Extend RF Range

Command
Opcode
HCI_EXT_ExtendRfRangeCmd
0xFC16
Command Parameters
Return Parameters
Status
Description
This command is used to configure the CC254x to automatically control the TI CC2590 2.4GHz RF
Front End device. Using the CC2590 allows a maximum Tx output power of 10dBm (the specified BLE
maximum), and increases Rx sensitivity, thus extending the RF range of the CC254x. Once this
command is used, the configuration will not change unless the CC254x is reset.
Automatic control of the CC2590 is achieved using the CC254x Observables, which take control of
GPIO P1.2 and P1.3. The GPIO P1.1 is also taken to control RF gain. These GPIOs are therefore not
available when using this feature.
Page 41 of 152

This command can be used in combination with HCI_EXT_SetTxPowerCmd, resulting in a cumulative
Tx output power. Therefore, for the CC2540, attempting to set Tx output power to 4dBm (i.e. using
HCI_EXT_TX_POWER_4_DBM), will instead set the Tx output power to 0dBm.
The command HCI_EXT_SetRxGainCmd should be used to set the Rx gain per usual. That is, the
CC254x Rx Standard/High gain setting is mirrored to the CC2590 High Gain Mode (HGM) Low/High
setting.
When this command is used, the CC254x Tx output power is set to 0dBm and Rx gain is set to
Standard/Low (i.e. the optimal power consumption setting).
Command Parameters
None
Return Parameters
Status: (1 byte)
Value
0x00
HCI_SUCCESS
Event(s) Generated
When the HCI_EXT_ExtendRfRangeCmd has completed, a vendor specific Command Complete
10.24 HCI Advertiser Event Notice

Command
Opcode
Command Parameters
Return Parameters
HCI_EXT_AdvEventNoticeCmd
0xFC17
taskID, taskEvent
Status
Description
This command is used to configure the CC254x to set a user tasks event when an Advertisement
event completes. Only a single task event value is allowed (i.e. must be a power of two). A non-zero
taskEvent value is taken to be "enable", while a zero valued taskEvent is taken to be "disable". The
default value is disable.
Command Parameters
taskID: (1 byte)
Value
0x00..0xFF
OSAL task ID.
taskEvent: (2 bytes)
Value
0
14
2 ..2
15
OSAL task event. Note that 2 is a reserved system task
event.
Page 42 of 152

Return Parameters
Status: (1 byte)
Value
0x00
HCI_SUCCESS
0x12
HCI_ERROR_CODE_INVALID_HCI_CMD_PARAMS
Event(s) Generated
When the HCI_EXT_AdvEventNoticeCmd has completed, it will simply return. No vendor specific
10.25 HCI Connection Event Notice

Command
Opcode
Command Parameters
Return Parameters
HCI_EXT_ConnEventNoticeCmd
0xFC18
taskID, taskEvent
Status
Description
This command is used to configure the CC254x to set a user tasks event when a Connection event
completes. Only a single task event value is allowed (i.e. must be a power of two). A non-zero
taskEvent value is taken to be "enable", while a zero valued taskEvent is taken to be "disable". The
default value is disable.
Note: Only a Slave connection is supported.
Command Parameters
taskID: (1 byte)
Value
0x00..0xFF
OSAL task ID.
taskEvent: (2 bytes)
Value
0
14
2 ..2
15
OSAL task event. Note that 2 is a reserved system task
event.
Return Parameters
Status: (1 byte)
Value
0x00
HCI_SUCCESS
0x02
HCI_ERROR_CODE_UNKNOWN_CONN_ID
Page 43 of 152
0x12
Event(s) Generated
When the HCI_EXT_ConnEventNoticeCmd has completed, it will simply return. No vendor specific
10.26 HCI Halt During RF

Command
Opcode
Command Parameters
Return Parameters
HCI_EXT_HaltDuringRfCmd
0xFC19
mode
Status
Description
This command is used to enable or disable the halting of the MCU while the radio is operating. When
the MCU is not halted, the peak current is higher, but the system is more responsive. When the MCU is
halted, the peak current consumption is reduced, but the system is less responsive. The default value
is Enable.
Note: This command will be disallowed if there are any active BLE connections.
Note: The HCI_EXT_ClkDivOnHaltCmd will be disallowed if the halt during RF is not enabled.
Command Parameters
mode: (1 byte)
Value
0x00
HCI_EXT_HALT_DURING_RF_DISABLE
0x01
HCI_EXT_HALT_DURING_RF_ENABLE
Return Parameters
Status: (1 byte)
Value
0x00
HCI_SUCCESS
Event(s) Generated
When the HCI_EXT_HaltDuringRfCmd has completed, a vendor specific Command Complete event
shall be generated.
Page 44 of 152
11. HCI Extension Vendor Specific Events

The HCI Extension vendor specific commands generate the following vendor specific events.
11.1 HCI Extension Set Receiver Gain

Event
Opcode
Event Parameters
HCI_Vendor_Specific_Event
0x0400
Status, cmdOpcode
Description
This event is sent to indicate the RF receiver gain has been set, or that there was an error.
Event Parameters
Status: (1 byte)
Value
0x00
HCI_SUCCESS
0x12
cmdOpcode: (2 bytes)
Value
0xFC00
HCI Extension Set Receiver Gain Command
11.2 HCI Extension Set Transmitter Power

Event
Opcode
Event Parameters
0x0401
Status, cmdOpcode
Description
This event is sent to indicate the RF transmitter power has been set, or that there was an error.
Event Parameters
Status: (1 byte)
Value
0x00
HCI_SUCCESS
0x12
Value
0xFC01
HCI Extension Set Transmitter Power Command

Page 45 of 152
11.3 HCI Extension One Packet Per Event

Event
Opcode
Event Parameters
0x0402
Status, cmdOpcode
Description
This event is sent to indicate the One Packet Per Event feature has been enabled or disabled, or that
there was an error.
Event Parameters
Status: (1 byte)
Value
0x00
HCI_SUCCESS
0x12
Value
0xFC02
HCI Extension One Packet Per Event Command
11.4 HCI Extension Clock Divide On Halt

Event
Opcode
Event Parameters
0x0403
Status, cmdOpcode
Description
This event is sent to indicate the Clock Divide On Halt feature has been enabled or disabled, or that
there was an error.
Event Parameters
Status: (1 byte)
Value
0x00
HCI_SUCCESS
0x0C
0x12
Value
0xFC03
HCI Extension Clock Divide On Halt Command

Page 46 of 152
11.5 HCI Extension Declare NV Usage

Event
Opcode
Event Parameters
0x0404
Status, cmdOpcode
Description
This event is sent to indicate the Declare NV Usage feature has been set, or that there was an error.
Event Parameters
Status: (1 byte)
Value
0x00
HCI_SUCCESS
0x0C
0x12
Value
0xFC04
HCI Extension Declare NV Usage Command
11.6 HCI Extension Decrypt

Event
Opcode
Event Parameters
0x0405
Status, cmdOpcode, plainTextData
Description
This event is sent to indicate Decryption has completed.
Event Parameters
Status: (1 byte)
Value
0x00
HCI_SUCCESS
Value
0xFC05
HCI Extension Decrypt Command
Page 47 of 152
plainTextData: (16 bytes)

Value
0xXXXXXXXXXXXXXXXX
XXXXXXXXXXXXXXXX
128 bit decrypted data block. The most significant octet of

plainTextData corresponds to plainTextData [0] using the notation
specified in FIPS 197.
11.7 HCI Extension Set Local Supported Features

Event
Opcode
Event Parameters
0x0406
Status, cmdOpcode
Description
This event is sent to indicate the Set Local Supported Features command has completed.
Event Parameters
Status: (1 byte)
Value
0x00
HCI_SUCCESS
Value
0xFC06
HCI Extension Set Local Supported Features Command
11.8 HCI Extension Set Fast Transmit Response Time

Event
Opcode
Event Parameters
0x0407
Status, cmdOpcode
Description
This event is sent to indicate the Set Fast Transmit Response Time feature has been enabled or
disabled, or that there was an error.
Event Parameters
Status: (1 byte)
Value
0x00
HCI_SUCCESS
Page 48 of 152
Value
0x0C
0x12
Value
0xFC07
HCI Extension Set Fast Transmit Response Time Command
11.9 HCI Extension Modem Test Transmit

Event
Opcode
Event Parameters
0x0408
Status, cmdOpcode
Description
This event is sent to indicate the Modem Test Transmit test has started, or that there was an error.
Event Parameters
Status: (1 byte)
Value
0x00
HCI_SUCCESS
0x12
0x21
HCI_ERROR_CODE_ROLE_CHANGE_NOT_ALLOWED
Value
0xFC08
HCI Extension Modem Test Transmit Command
11.10 HCI Extension Modem Hop Test Transmit

Event
Opcode
Event Parameters
0x0409
Status, cmdOpcode
Description
This event is sent to indicate the Modem Hop Test Transmit test has started, or that there was an error.
Event Parameters
Status: (1 byte)
Value
0x00
HCI_SUCCESS
Page 49 of 152
Value
0x21
Value
0xFC09
HCI Extension Modem Hop Test Transmit Command
11.11 HCI Extension Modem Test Receive

Event
Opcode
Event Parameters
0x040A
Status, cmdOpcode
Description
This event is sent to indicate the Modem Test Receive test has started, or that there was an error.
Event Parameters
Status: (1 byte)
Value
0x00
HCI_SUCCESS
0x12
0x21
Value
0xFC0A
HCI Extension Modem Test Receive Command
11.12 HCI Extension End Modem Test

Event
Opcode
Event Parameters
0x040B
Status, cmdOpcode
Description
This event is sent to indicate the modem test has been shutdown, or that there was an error.
Event Parameters
Status: (1 byte)
Value
0x00
HCI_SUCCESS
0x21
Page 50 of 152
Value
0xFC0B
HCI Extension End Modem Test Command
11.13 HCI Extension Set BDADDR

Event
Opcode
Event Parameters
0x040C
Status, cmdOpcode
Description
This event is sent to indicate the devices BLE address has been set, or that there was an error.
Event Parameters
Status: (1 byte)
Value
0x00
HCI_SUCCESS
0x0C
0x12
Value
0xFC0C
HCI Extension Set BDADDR Command
11.14 HCI Extension Set SCA

Event
Opcode
Event Parameters
0x040D
Status, cmdOpcode
Description
This event is sent to indicate the devices SCA has been set, or that there was an error.
Event Parameters
Status: (1 byte)
Value
0x00
HCI_SUCCESS
0x0C
Page 51 of 152
0x12
Value
0xFC0D
HCI Extension Set SCA Command
11.15 HCI Extension Enable PTM

There is not a corresponding event opcode (0x040E) and parameters for this command as it is only
allowed as a direct function call by the application software.
11.16 HCI Extension Set Frequency Tuning

Event
Opcode
Event Parameters
0x040F
Status, cmdOpcode
Description
This event is sent to indicate the devices frequency tuning value has be adjusted one step up or down,
or that there was an error.
Event Parameters
Status: (1 byte)
Value
0x00
HCI_SUCCESS
0x0C
0x12
Value
0xFC0F
HCI Extension Set Frequency Tuning Command
11.17 HCI Extension Save Frequency Tuning

Event
Opcode
Event Parameters
0x0410
Status, cmdOpcode
Description
Page 52 of 152

This event is sent to indicate the devices current frequency tuning value has been saved to nonvolatile memory, or that there was an error.
Event Parameters
Status: (1 byte)
Value
0x00
HCI_SUCCESS
0x0C
Value
0xFC10
HCI Extension Save Frequency Tuning Command
11.18 HCI Extension Set Max DTM Transmitter Power

Event
Opcode
Event Parameters
0x0411
Status, cmdOpcode
Description
This event is sent to indicate the maximum Direct Test Mode (DTM) RF transmitter power has been
set, or that there was an error.
Event Parameters
Status: (1 byte)
Value
0x00
HCI_SUCCESS
0x12
Value
0xFC11
HCI Extension Set Transmitter Power Command
11.19 HCI Extension Map PM IO Port

Event
Opcode
Event Parameters
0x0412
Status, cmdOpcode
Description
This event is sent to indicate the PM IO Port has been configured and mapped, or that there was an
error.
Page 53 of 152

Event Parameters
Status: (1 byte)
Value
0x00
HCI_SUCCESS
0x0C
0x12
Value
0xFC12
HCI Extension Map PM IO Port Command
11.20 HCI Extension Disconnect Immediate

Event
Opcode
Event Parameters
0x0413
Status, cmdOpcode
Description
This event is sent to indicate the Disconnect Immediate command has completed, or that there was an
error.
Event Parameters
Status: (1 byte)
Value
0x00
HCI_SUCCESS
0x02
0x0C
0x12
Value
0xFC13
HCI Extension Disconnect Immediate Command
11.21 HCI Extension Packet Error Rate

Event
Opcode
Event Parameters
0x0414
Status, cmdOpcode, cmdVal, numPkts,

numCrcErr, numEvents, numMissedEvts
Page 54 of 152

Description
This event is sent to indicate the Packet Error Rate Reset or Read command has completed, or that
there was an error.
Event Parameters
Status: (1 byte)
Value
0x00
HCI_SUCCESS
0x02
0x0C
0x12
Value
0xFC14
HCI Extension Packet Error Rate Command
cmdVal: (2 bytes)
Value
0x00
HCI_EXT_PER_RESET
0x01
HCI_EXT_PER_READ
Note: The following event parameters are for the Read command only.
numPkts: (2 bytes)
Value
0x0000 .. 0xFFFF
Total number of received packets.
numCrcErr: (2 bytes)
Value
0x0000 .. 0xFFFF
Number of received packets with CRC error.
numEvents: (2 bytes)
Value
0x0000 .. 0xFFFF
Number of connection events.
numMissedEvents: (2 bytes)
Page 55 of 152
Value
0x0000 .. 0xFFFF
Number of missed connection events.
11.22 HCI Extension Packet Error Rate By Channel

Event
Opcode
Event Parameters
0x0415
Status, cmdOpcode
Description
This event is sent to indicate the Packet Error Rate By Channel command has completed, or that there
was an error.
Event Parameters
Status: (1 byte)
Value
0x00
HCI_SUCCESS
0x02
Value
0xFC15
HCI Extension Packet Error Rate By Channel Command
11.23 HCI Extension Extend RF Range

Event
Opcode
Event Parameters
0x0416
Status, cmdOpcode
Description
This event is sent to indicate the Extend RF Range command has completed.
Event Parameters
Status: (1 byte)
Value
Page 56 of 152
0x00
HCI_SUCCESS
Value
0xFC16
HCI Extension Extend RF Range Command
11.24 HCI Extension Advertiser Event Notice

There is not a corresponding event opcode (0x0417) and parameters for this command as it is only
11.25 HCI Extension Connection Event Notice

There is not a corresponding event opcode (0x0418) and parameters for this command as it is only
11.26 HCI Extension Halt During RF

Event
Opcode
Event Parameters
0x0419
Status, cmdOpcode
Description
This event is sent to indicate the Halt During RF feature has been enabled or disabled, or that there
was an error.
Event Parameters
Status: (1 byte)
Value
0x00
HCI_SUCCESS
0x0C
0x12
Value
0xFC19
HCI Extension Halt During RF Command
Page 57 of 152
12. GAP Vendor Specific Commands

12.1 GAP Device Initialization
Command
Opcode
Command Parameters
Return Parameters
GAP_DeviceInit
0xFE00
profileRole,
maxScanResponses, IRK,
CSRK, signCounter
Status
Description:
This command is used to setup the device in a GAP Role and should only be called once per reboot.
To enable multiple combinations setup multiple GAP Roles (profileRole parameter).
Multiple Role settings examples:
GAP_PROFILE_PERIPHERAL and GAP_PROFILE_BROADCASTER allows a connection and
advertising (non-connectable) at the same time.
GAP_PROFILE_PERIPHERAL and GAP_PROFILE_OBSERVER allows a connection (with
master) and scanning at the same time.
GAP_PROFILE_PERIPHERAL,
GAP_PROFILE_OBSERVER
and
GAP_PROFILE_BROADCASTER allows a connection (with master) and scanning or advertising at
the same time.
GAP_PROFILE_CENTRAL and GAP_PROFILE_BROADCASTER allows connections and
advertising (non-connectable) at the same time.
Command Parameters:
profileRole: Bit Mask (1 octet)
Value
0x01
GAP_PROFILE_BROADCASTER
0x02
GAP_PROFILE_OBSERVER
0x04
GAP_PROFILE_PERIPHERAL
0x08
GAP_PROFILE_CENTRAL
maxScanResponses: (1 octet)
Range
0 0xFF
Central or Observer only: The device will allocate buffer

space for received advertisement packets. The default is
3. The larger the number, the more RAM that is needed
and maintained.
IRK: (16 octets)

Page 58 of 152
Range
XX:XX:XX:XX:
XX:XX:XX:XX:
XX:XX:XX:XX:
XX:XX:XX:XX
16 byte Identity Resolving Key (IRK). If this value is all

0s, the GAP will randomly generate all 16 bytes. This
key is used to generate Resolvable Private Addresses.
CSRK: (16 octets)

Range
XX:XX:XX:XX:
XX:XX:XX:XX:
XX:XX:XX:XX:
XX:XX:XX:XX
16 byte Connection Signature Resolving Key (CSRK). If

this value is all 0s, the GAP will randomly generate all
16 bytes. This key is used to generate data Signatures.
signCounter: (4 octets)
Range
0x00000000 0xFFFFFFFF
32 bit Signature Counter. Initial signature counter.
Return Parameters:
Status: (1 octet)
Value
0x00
SUCCESS
0x02
INVALIDPARAMETER
Event(s) Generated:
When device initialization is received, the host will send the HCI Ext Command Status Event with the
Status parameter. When initialization task is complete, the host will send the GAP Device Init Done
Event.
12.2 GAP Configure Device Address

Command
Opcode
Command Parameters
Return Parameters
GAP_ConfigDeviceAdd
r
0xFE03
addrType, Addr
Status
Description:
Send this command to set the devices address type.
selected, the address will change periodically.
If ADDRTYPE_PRIVATE_RESOLVE is
Page 59 of 152
Command Parameters:
addrType: (1 octet)
Value
ADDRTYPE_PUBLIC
ADDRTYPE_STATIC
ADDRTYPE_PRIVATE_NONRESOLVE
ADDRTYPE_PRIVATE_RESOLVE
Addr: (6 octet)
Range
XX:XX:XX:XX:XX:XX
Intended address. Only used with ADDRTYPE_STATIC

or ADDRTYPE_PRIVATE_NONRESOLVE.
Return Parameters:
Status: (1 octet)
Value
0x00
SUCCESS
0x02
INVALIDPARAMETER
0x10
GAP_DeviceInit must be completed first.
0x12
Address type cant be change during an active

connection.
Event(s) Generated:
When this command is received, the host will send the HCI Ext Command Status Event with the
Status parameter.
If ADDRTYPE_PRIVATE_RESOLVE addrType is selected, the GAP Random
Address Changed Event will be generated when the address is automatically updated.
12.3 GAP Device Discovery Request

Command
Opcode
Command Parameters
Return Parameters
GAP_DeviceDiscoveryReques
t
0xFE04
mode, activeScan, whiteList
Status
Description:
Page 60 of 152

Send this command to start a scan for advertisement packets. This command is valid for a central or a
peripheral device.
Command Parameters:
mode: (1 octet)
Value
Non-Discoverable Scan
General Mode Scan
Limited Mode Scan
Scan for all devices
activeScan: (1 octet)
Value
Turn off active scanning (SCAN_REQ)
Turn on active scanning (SCAN_REQ)
whiteList: (1 octet)
Value
Dont use the white list during a scan
Use the white list during a scan
Return Parameters:
Status: (1 octet)
Value
0x00
SUCCESS
0x11
Scan is not available.
0x12
Invalid profile role.
Event(s) Generated:
Status parameter. During the scan, the device will generate GAP Device Information Events for
advertising devices, then issue a GAP Device Discovery Event when the scan is completed.
12.4 GAP Device Discovery Cancel
Page 61 of 152
Command
Opcode
GAP_DeviceDiscoveryCance
l
0xFE05
Command Parameters
Return Parameters
Status
Description:
Send this command to end a scan for advertisement packets. This command is valid for a central or a
peripheral device.
Command Parameters:
None
Return Parameters:
Status: (1 octet)
Value
0x00
SUCCESS
0x11
Scan is not available.
0x12
Event(s) Generated:
Status parameter, then issue a GAP Device Discovery Event to display the scan progress since the
start of the scan.
12.5 GAP Make Discoverable

Command
Opcode
Command Parameters
Return Parameters
GAP_MakeDiscoverabl
e
0xFE06
eventType, initiatorAddrType,
initiatorAddr, channelMap,
filterPolicy
Status
Description:
Send this command to start the device advertising.
Command Parameters:
Page 62 of 152

eventType: (1 octet)
Value
Connectable undirected advertisement
Connectable directed advertisement
Discoverable undirected advertisement
Non-connectable undirected advertisement
initiatorAddrType: (1 octet)
Value
ADDRTYPE_PUBLIC
ADDRTYPE_STATIC
initiatorAddr: (6 octet)
Range
XX:XX:XX:XX:XX:XX
Intended address. Only used for directed advertisments
channelMap: Bit Mask (1 octet)

Bit Definitions
Channel 37
Channel 38
Channel 39
37
reserved
filterPolicy: (1 octet)
Value
Allow scan requests from any, allow connect request

from any.
Allow scan requests from white list only, allow connect

request from any.
Allow scan requests from any, allow connect request

from white list only.
Allow scan requests from white list only, allow connect

requests from white list only.
4 0xFF
reserved
Page 63 of 152
Return Parameters:
Status: (1 octet)
Value
0x00
SUCCESS
0x10
Advertising data isnt setup.
0x11
Not available at this time.
0x12
Event(s) Generated:
Status parameter, then, when the device starts advertising the GAP Make Discoverable Done Event is
generated. When advertising is completed (limited mode advertising has a time limit), the GAP End
Discoverable Event is generated.
12.6 GAP Update Advertising Data

Command
Opcode
Command Parameters
Return Parameters
GAP_UpdateAdvertisingDat
a
0xFE07
adType, dataLen, advertData
Status
Description:
Send this command to set the raw advertising or scan response data.
Command Parameters:
adType: (1 octet)
Value
SCAN_RSP data
Advertisement data
dataLen: (1 octet)
Range
0 31
Length of the advertData field (in octets)
advertData: (dataLen octets)

Page 64 of 152
Value
XX:XX XX
Raw advertising data
Return Parameters:
Status: (1 octet)
Value
0x00
SUCCESS
0x12
Event(s) Generated:
Status parameter, then, when the task is complete the GAP Advert Data Update Done Event is
generated.
12.7 GAP End Discoverable

Command
Opcode
GAP_EndDiscoverabl
e
0xFE08
Command Parameters
Return Parameters
Status
Description:
Send this command to end advertising.
Command Parameters:
None
Return Parameters:
Status: (1 octet)
Value
0x00
SUCCESS
0x12
Not advertising
Event(s) Generated:
Page 65 of 152

Status parameter, then issue a GAP End Discoverable Done Event advertising has stopped.
12.8 GAP Establish Link Request

Command
Opcode
Command Parameters
Return Parameters
GAP_EstablishLinkRequest
0xFE09
highDutyCycle, whiteList,
addrTypePeer, peerAddr
Status
Description:
Send this command to initiate a connection with a peripheral device. Only central devices can issue
this command.
Command Parameters:
highDutyCycle: (1 octet)
Value
disabled
enabled
A central device may use high duty cycle scan parameters in order to achieve low latency
connection time with a peripheral device using directed link establishment.
whiteList: (1 octet)
Value
Dont use the white list
Only connect to a device in the white list
addrTypePeer: (1 octet)
Value
ADDRTYPE_PUBLIC
ADDRTYPE_STATIC
peerAddr: (6 octet)
Range
XX:XX:XX:XX:XX:XX
Peripheral address to connect with.

Page 66 of 152
Return Parameters:
Status: (1 octet)
Value
0x00
SUCCESS
0x10
Not ready to perform this action. Performing a

scan.
0x12
Event(s) Generated:
Status parameter. When the connection has been made, the GAP Link Established Event will be
generated.
12.9 GAP Terminate Link Request

Command
Opcode
Command Parameters
Return Parameters
GAP_TerminateLinkReques
t
0xFE0A
connHandle
Status
Description:
Send this command to terminate a connection link, a connection request or all connected links.
Command Parameters:
connHandle: (2 octets)
Value
0 0xFFFD
Existing connection handle to terminate
0xFFFE
Terminate the Establish Link Request
0xFFFF
Terminate all links
Return Parameters:
Status: (1 octet)
Value
0x00
SUCCESS
0x12
No link to terminate
Page 67 of 152

Event(s) Generated:
Status parameter. When the connection is terminated, the GAP Link Terminated Event will be
generated.
12.10 GAP Authenticate

Command
Opcode
Command Parameters
Return Parameters
GAP_Authenticate
0xFE0B
connHandle, secReq.ioCaps,
secReq.oobAvailable,
secReq.oob,
secReq.authReq,
secReq.maxEncKeySize,
secReq.keyDist,
Status
pairReq.Enable,
pairReq.ioCaps,
pairReq.oobDataFlag,
pairReq.authReq,
pairReq.maxEncKeySize,
pairReq.keyDist
Description:
Send this command to initiate the pairing process (if Central device), wait for the pairing process (if
Peripheral device), or accept a pairing request (if Peripheral device).
Command Parameters:
Value
0 0xFFFD
Connection handle
secReq.ioCaps: (1 octet)
Value
Display Only
Display Yes or No
Keyboard Only
No Input and No Output
Keyboard and Display
5 0xFF
reserved
Page 68 of 152

secReq.oobAvailable: (1 octet)
Value
Out-Of-Bounds (OOB) data is NOT available
Out-Of-Bounds (OOB) data is available
secReq.oob: (16 octets)

Value
XX:XX:XX:XX:
XX:XX:XX:XX:
XX:XX:XX:XX:
XX:XX:XX:XX
Out-Of-Bounds data - Initial TK value for the pairing

process.
secReq.authReq: Bit Mask (1 octet)

Bit
Bonding exchange and save key information
Reserved
Man-In-The-Middle protection
37
Reserved
secReq.maxEncKeySize: (1 octet)
Range
7 16
Maximum encryption key size to support
secReq.keyDist: Bit Mask (1 octet)

Bit
Slave Encryption Key
Slave Identification Key
Slave Signing Key
Master Encryption Key
Master Identification Key
Master Signing Key
67
Reserved
pairReq.Enable: (1 octet)
Value
Pairing Request hasnt been received.

Page 69 of 152
Value
Pairing Request has already been received. Peripheral

Role only.
The following fields should be exact same values received in the Pairing Request.
pairReq.ioCaps: (1 octet)
Value
Display Only
Display Yes or No
Keyboard Only
5 0xFF
reserved
pairReq.oobDataFlag: (1 octet)
Value
pairReq.authReq: Bit Mask (1 octet)

Bit
Reserved
37
Reserved
pairReq.maxEncKeySize: (1 octet)
Range
7 16
pairReq.keyDist: Bit Mask (1 octet)

Bit

Page 70 of 152
Bit
Slave Signing Key
Master Signing Key
67
Reserved
Return Parameters:
Status: (1 octet)
Value
0x00
SUCCESS
0x02
Invalid Parameter
0x11
Already in this mode
0x12
Incorrect Profile Role
0x14
Invalid connection handle
Event(s) Generated:
Status parameter. When the pairing process is complete (either SUCCESS or Failure), a GAP
Authentication Complete Event will be generated. If a passkey is needed, a GAP Passkey Needed
Event will be generated.
12.11 GAP Update Link Parameter Request

Command
Opcode
Command Parameters
Return Parameters
GAP_UpdateLinkParamReq
0xFE11
connectionHandle,
intervalMin, intervalMax,
connLatency, connTimeout
Status
Description:
Send this command to change the Link Layer connection parameters of a connection. This command
can only be used when the local devices role is Master.
Command Parameters:
Value
Page 71 of 152
Value
0 0xFFFD
Connection handle
intervalMin: (2 octets)
Range
6 - 3200
Minimum value for the connection event interval. This

shall be less than or equal to intervalMax.
Range: 0x0006 to 0x0C80
Time = intervalMin * 1.25 msec
Time Range: 7.5 msec to 4 seconds.
intervalMax: (2 octets)
Range
6 - 3200
Maximum value for the connection event interval. This

shall be greater than or equal to intervalMin.
Time = intervalMax * 1.25 msec
Time Range: 7.5 msec to 4 seconds.
connLatency: (2 octets)
Range
0 - 499
Slave latency for the connection in number of connection

events.
Range: 0x0000 to 0x01F3
connTimeout: (2 octets)
Range
10 - 3200
Supervision timeout for the LE Link.

Range: 0x000A to 0x0C80
Time = connTimeout * 10 msec
Time Range: 100 msec to 32 seconds
Return Parameters:
Status: (1 octet)
Value
0x00
SUCCESS
Page 72 of 152
0x01
FAILURE
0x02
INVALIDPARAMETER
0x12
bleIncorrectMode
0x14
bleNotConnected
Event(s) Generated:
Status parameter. When the connection parameters have been applied by the Controller, the GAP
Link Parameter Update Event will be generated.
12.12 GAP Passkey Update

Command
Opcode
Command Parameters
Return Parameters
GAP_PasskeyUpdate
0xFE0C
connHandle, passkey
Status
Description:
Send this command when the GAP Passkey Needed Event is received.
passkey needed during the Pairing Process.
This command sends a
Command Parameters:
Value
0 0xFFFD
Connection handle to issue the passkey
passkey: (6 octets)
Value
6 character ASCII string of numbers (ex. 019655 )
Return Parameters:
Status: (1 octet)
Value
0x00
SUCCESS
0x03
Passkey is NULL, or isnt formatted properly
0x12
Link not found
Page 73 of 152

Event(s) Generated:
Status parameter.
12.13 GAP Slave Security Request

Command
Opcode
Command Parameters
Return Parameters
GAP_SlaveSecurityReques
t
0xFE0D
connHandle, authReq
Status
Description:
Send this command, Peripheral Role only, to initiate security from a slave device. This message is
also sent, by the Peripheral, to upgrade security (Pairing) to Authenticated, make sure to ask for ManIn-The-Middle (MITM) protection in the authReq field.
Command Parameters:
Value
0 0xFFFD
Connection handle
authReq: Bit Mask (1 octet)

Bit
Reserved
37
Reserved
Return Parameters:
Status: (1 octet)
Value
0x00
SUCCESS
0x11
wrong GAP role, must be a Peripheral Role
0x14
Link not found
Event(s) Generated:
Page 74 of 152

When this command is received, the host will send the GAP HCI Ext Command Status Event with the
Status parameter.
12.14 GAP Signable

Command
Opcode
Command Parameters
Return Parameters
GAP_Signable
0xFE0E
connHandle, authenticated,
CSRK, signCounter
Status
Description:
Send this command for a connected and bound device to enable signed data.
Command Parameters:
Value
0 0xFFFD
Connection handle
authenticated: (1 octet)
Value
CSRK is not authenticated
CSRK is authenticated
CSRK: (16 octets)

Value
XX:XX:XX:XX:
XX:XX:XX:XX:
XX:XX:XX:XX:
XX:XX:XX:XX
CSRK of connected device.
Range
0x00000000 0xFFFFFFFF
32 bit Signature Counter. The connected devices last

saved sign counter.
Return Parameters:
Status: (1 octet)
Page 75 of 152
Value
0x00
SUCCESS
0x12
0x14
Link not found
Event(s) Generated:
Status parameter.
12.15 GAP Bond

Command
Opcode
Command Parameters
Return Parameters
GAP_Bond
0xFE0F
connHandle, authenticated,
LTK, DIV, rand, LTKsize
Status
Description:
Send this command for a connected and bound device to load the encryption key.
Command Parameters:
Value
0 0xFFFD
Connection handle
Value
LTK is not authenticated
LTK is authenticated
LTK: (16 octets)

Value
XX:XX:XX:XX:
XX:XX:XX:XX:
XX:XX:XX:XX:
XX:XX:XX:XX
16 byte Long Term Key (LTK).
DIV: (2 octets)
Page 76 of 152
Range
0 0xFFFF
The DIV used with this LTK.
rand: (8 octets)
Value
XX:XX:XX:XX:
XX:XX:XX:XX
The 8 byte random number generated for this LTK.
LTKsize: (1 octet)
Range
7 16
Encryption key size
Return Parameters:
Status: (1 octet)
Value
0x00
SUCCESS
0x12
0x14
Link not found
Event(s) Generated:
Status parameter. When both connected devices have setup encryption, the GAP Bond Complete
Event is generated.
12.16 GAP Terminate Auth

Command
Opcode
Command Parameters
Return Parameters
GAP_TerminateAuth
0xFE10
connHandle, reason
Status
Description:
Send this command to terminate a pairing process.
Command Parameters:
Value
Page 77 of 152
Value
0 0xFFFD
Connection handle
reason: (1 octet)
Value
0xXX
Pairing Fail reason code
Return Parameters:
Status: (1 octet)
Value
0x00
SUCCESS
0xXX
Error code
Event(s) Generated:
Status parameter. When the existing pairing had ended, the GAP Authentication Complete Event with
be generated.
12.17 GAP Set Parameter

Command
Opcode
Command Parameters
Return Parameters
GAP_SetParam
0xFE30
paramID, paramValue
Status
Description:
Send this command to write a GAP Parameter.
Command Parameters:
paramID: (2 octets)
Value
Minimum time to remain advertising, when in Discoverable mode (mSec).

Setting this parameter to 0 turns off the timer (default).
Maximum time to remain advertising, when in Limited Discoverable mode

(mSec).
Minimum time to perform scanning, when performing General Discovery

proc (mSec).
Minimum time to perform scanning, when performing Limited Discovery

Page 78 of 152
Value
proc (mSec).
Advertising timeout, when performing Connection Establishment proc

(mSec).
Link Layer connection parameter update notification timer, connection

parameter update proc (mSec).
Minimum advertising interval, when in limited discoverable mode (mSec).
Maximum advertising interval, when in limited discoverable mode (mSec).
Minimum advertising interval, when in General discoverable mode (mSec).
Maximum advertising interval, when in General discoverable mode

(mSec).
10
Minimum advertising interval, when in Connectable mode (mSec).
11
Maximum advertising interval, when in Connectable mode (mSec).
12
Scan interval used during Link Layer Initiating state, when in Connectable
mode (mSec).
13
Scan window used during Link Layer Initiating state, when in Connectable
mode (mSec).
14
Scan interval used during Link Layer Initiating state, when in Connectable
mode, high duty scan cycle scan paramaters (mSec).
15
Scan window used during Link Layer Initiating state, when in Connectable
mode, high duty scan cycle scan paramaters (mSec).
16
Scan interval used during Link Layer Scanning state, when in General
Discovery proc (mSec).
17
Scan window used during Link Layer Scanning state, when in General
18
Scan interval used during Link Layer Scanning state, when in Limited
19
Scan window used during Link Layer Scanning state, when in Limited
20
Advertising interval, when using Connection Establishment proc (mSec).
21
Minimum Link Layer connection interval, when using Connection

Establishment proc (mSec).
22
Maximum Link Layer connection interval, when using Connection

23
Scan interval used during Link Layer Initiating state, when using
Connection Establishment proc (mSec).
24
Scan window used during Link Layer Initiating state, when using
Connection Establishment proc (mSec).
25
Link Layer connection supervision timeout, when using Connection

26
Link Layer connection slave latency, when using Connection Establishment

Page 79 of 152
Value
proc (mSec)
27
Local informational parameter about min len of connection needed, when

using Connection Establishment proc (mSec).
28
Local informational parameter about max len of connection needed, when

using Connection Establishment proc (mSec).
29
Minimum Time Interval between private (resolvable) address changes. In

minutes (default 15 minutes).
30
SM Message Timeout (milliseconds). (default 30 seconds).
31
SM Minimum Key Length supported (default 7).
32
SM Maximum Key Length supported (default 16).
33
Filter duplicate advertising reports (Default TRUE).
34
Minimum RSSI required for scan responses to be reported to the app

(Default -127).
The following parameters are use for testing only (DO NOT USE):
Value
35
GAP Test Modes:

0 Test Mode Off
1 No Response
2 Reject Connection Parameter Update Request
36
SM Test Modes:
0 Test Mode Off
1 No Response
2 Send Bad Confirm
3 Bad Confirm Verify
4 Send SMP Confirm Message
100
GATT Test Modes:

0 Test Mode Off
1 Ignore incoming request
2 Forward Prepare Write Request right away
3 Use Max ATT MTU size with Exchange MTU Response
4 Corrupt incoming Prepare Write Request data
101
ATT Test Modes:

0 Test Mode Off
1 Do Not authenticate incoming signature
102
GGS Test Modes:

0 Test Mode Off
1 Make Device Name attribute writable
2 Make Appearance attribute writable
Page 80 of 152

paramValue: (2 octets)
Value
0xXXXX
Depends on the parameter
Return Parameters:
Status: (1 octet)
Value
0x00
SUCCESS
0x02
Invalid paramID
Event(s) Generated:
Status parameter.
12.18 GAP Get Parameter

Command
Opcode
Command Parameters
Return Parameters
GAP_GetParam
0xFE31
paramID,
Status, paramValue
Description:
Send this command to read a GAP Parameter.
Command Parameters:
paramID: (2 octets)
Value
0xXXXX
See paramID list in GAP Set Parameter
Return Parameters:
Status: (1 octet)
Value
0x00
SUCCESS
0x02
Invalid paramID
paramValue: (2 octets)
Value
Page 81 of 152
Value
0xXXXX
Depends on the paramID passed in. See paramID

descriptions in GAP Set Parameter for size and values.
Event(s) Generated:
Status and paramValue parameters.
12.19 GAP Resolve Private Address

Command
Opcode
Command Parameters
Return Parameters
GAP_ResolvePrivateAdd
r
0xFE32
IRK, addr
Status
Description:
Send this command to resolve a Private Resolvable Address.
Command Parameters:
IRK: (16 octets)
Value
XX:XX:XX:XX:
XX:XX:XX:XX:
XX:XX:XX:XX:
XX:XX:XX:XX
IRK to resolve addr with
addr: (6 octet)
Range
XX:XX:XX:XX:XX:XX
Private resolvable address to resolve (with IRK).
Return Parameters:
Status: (1 octet)
Value
0x00
SUCCESS addr resolves
0x01
FAILURE addr doesnt resolve
Event(s) Generated:
Page 82 of 152

Status parameter.
12.20 GAP Set Advertisement Token

Command
Opcode
Command Parameters
Return Parameters
GAP_SetAdvToken
0xFE33
adType, advDataLen,
advData
Status
Description:
Send this command to add an Advertisement Data Token to the advertisement data field of an
advertisement packet.
Command Parameters:
adType: (1 octet)
Value
0x01
Flags: Discovery Mode
0x02
Service: More 16-bit UUIDs available
0x03
Service: Complete list of 16-bit UUIDs
0x04
0x05
0x06
0x07
0x08
Shortened local name
0x09
Complete local name
0x0A
TX Power Level: 0xXX: -127 to +127 dBm
0x0D
Simple Pairing OOB Tag: Class of device (3

octets)
0x0E
Simple Pairing OOB Tag: Simple Pairing Hash

C (16 octets)
0x0F
Simple Pairing OOB Tag: Simple Pairing

Randomizer R (16 octets)
0x10
Security Manager TK Value
0x11
Secutiry Manager OOB Flags
0x12
Min and Max values of the connection interval

(2 octets Min, 2 octets Max) (0xFFFF indicates
Page 83 of 152

no conn interval min or max)
0x13
Signed Data field
0x14
Service Solicitation: list of 16-bit Service

UUIDs
0x15

UUIDs
0x16
Service Data
0xFF
Manufacturer Specific Data: first 2 octets

contain the Company Identifier Code followed
by the additional manufacturer specific data
advDataLen: (1 octet)
Value
0xXX
Length (in octets) of advData
advData: (advDataLen octets)

Value
XX:XXXX
Advertisement token data (over-the-air format).
Return Parameters:
Status: (1 octet)
Value
0x00
SUCCESS
0x02
Invalid Advertisement Type
0x0B
Token takes up too much space and doesnt fit

into Advertisement data and Scan response
data.
0x12
Invalid GAP Profile Role
0x18
Advertisement Type already exists
Event(s) Generated:
Status parameter.
12.21 GAP Remove Advertisement Token
Page 84 of 152
Command
Opcode
Command Parameters
Return Parameters
GAP_RemoveAdvToke
n
0xFE34
adType
Status
Description:
Send this command to remove an Advertisement Data Token from the advertisement data field of an
advertisement packet.
Command Parameters:
adType: (1 octet)
Value
0x01
Flags: Discovery Mode
0x02
0x03
0x04
0x05
0x06
0x07
0x08
Shortened local name
0x09
Complete local name
0x0A
TX Power Level: 0xXX: -127 to +127 dBm
0x0D
Simple Pairing OOB Tag: Class of device (3

octets)
0x0E
Simple Pairing OOB Tag: Simple Pairing Hash

C (16 octets)
0x0F
Simple Pairing OOB Tag: Simple Pairing

Randomizer R (16 octets)
0x10
Security Manager TK Value
0x11
Secutiry Manager OOB Flags
0x12
Min and Max values of the connection interval

(2 octets Min, 2 octets Max) (0xFFFF indicates
no conn interval min or max)
0x13
Signed Data field
0x14

UUIDs
0x15

UUIDs
0x16
Service Data
Page 85 of 152
0xFF
Manufacturer Specific Data: first 2 octets

contain the Company Identifier Code followed
by the additional manufacturer specific data
Return Parameters:
Status: (1 octet)
Value
0x00
SUCCESS
0x02
adType not found.
Event(s) Generated:
Status parameter.
12.22 GAP Update Advertisement Tokens

Command
Opcode
GAP_UpdateAdvToke
n
0xFE35
Command Parameters
Return Parameters
Status
Description:
After adding an removing advertisement tokens, they must be updated to actual advertisements by
sending this command.
Command Parameters:
none
Return Parameters:
Status: (1 octet)
Value
0x00
SUCCESS
Event(s) Generated:
Status parameter.
Page 86 of 152
12.22.1 GAP Bond Set Parameter

Command
Opcode
Command Parameters
Return Parameters
GAP_BondSetParam
0xFE36
paramID, paramDataLen,
paramData
Status
Description:
Send this command to set a GAP Bond parameter.
Command Parameters:
paramID: (2 octets)
Value
0x0400
Pairing Mode - Read/Write. Size is uint8. Values:

0x00 Pairing Not allowed
0x01 Wait for Request (default)
0x02 Dont wait, initiate a Slave Requested Security command (not
available yet).
0x0401
Pairing Mode Initiate wait timeout. This is the time it will wait for a Pairing
Request before sending the Slave Initiate Request. Read/Write. Size is
uint16. Default is 1000(in milliseconds).
0x0402
Man-In-The-Middle (MITM) basically turns on Passkey protection in the

pairing algorithm. Read/Write. Size is uint8. Values:
0x00 Disabled (default).
0x01 Enabled.
0x0403
I/O capabilities. Read/Write. Size is uint8. Values:

0x00 Display Only Device (default)
0x01 Display Yes an No capable
0x02 Keyboard only
0x03 No Input, No Output
0x04 Keyboard and Display
0x0404
OOB data available for pairing algorithm. Read/Write. Size is uint8.

Values:
0x01 Enabled.
0x0405
OOB Data. Read/Write. size uint8[16]. Default is all 0's.
0x0406
Request Bonding during the pairing process if enabled. Read/Write. Size is

uint8. Values:
Page 87 of 152

0x01 Enabled.
0x0407
The key distribution list for bonding. size is uint8. Bit Values:
Bit 0 Slave LTK and key information (default)
Bit 1 Slave IRK and ID information (default)
Bit 2 Slave CSRK
Bit 3 Master LTK and key information
Bit 4 Master IRK and ID information (default).
Bit 5 Master CSRK (default)
0x0408
The default passcode for MITM protection. size is uint32.

Range is 0 - 999,999. Default is 0.
0x0409
Erase all of the bonded devices. Write Only - command. No Size.
0x040A
Test mode to automatically send a Pairing Fail when a Pairing Request is

received. Read/Write. size is uint8. Default is 0 (disabled). Set to 1 to
enable.
0x040B
Test mode Pairing Fail reason when auto failing. Read/Write. size is uint8.
Default is 0x05 (SMP_PAIRING_FAILED_NOT_SUPPORTED).
0x040C
Key Size used in pairing. Read/Write. Size is uint8. Default is 16.
0x040D
Clears the White List adds to it each unique address stored by bonds in NV.
Read/Write. Size is uint8. Default is FALSE.
0x040E
Gets the total number of bonds stored in NV. Read Only. Size is uint8.
Default is 0 (no bonds).
paramDataLen: (1 octet)
Value
0xXX
Length (in octets) of paramData
paramData: (paramDataLen octets)

Value
XX:XXXX
Parameter data depends on paramID.
Return Parameters:
Status: (1 octet)
Value
0x00
SUCCESS
0x02
Invalid paramID
0x18
Invalid paramDataLen
Page 88 of 152
Event(s) Generated:
Status parameter.
12.22.2 GAP Bond Get Parameter

Command
Opcode
Command Parameters
Return Parameters
GAP_BondGetParam
0xFE37
paramID
Status, paramDataLen,
paramData
Description:
Send this command to read a GAP Bond parameter.
Command Parameters:
paramID: (2 octets)
Value
0xXX
See paramID in GAP Bond Set Parameter
Return Parameters:
Status: (1 octet)
Value
0x00
SUCCESS
0x02
Invalid paramID
0x18
Invalid paramDataLen
paramDataLen: (1 octet)
Value
0xXX
Length (in octets) of paramData
paramData: (paramDataLen octets)

Value
XX:XXXX
Depends on the paramID.
Page 89 of 152

Event(s) Generated:
Status, paramDataLen, paramData parameters.
Page 90 of 152
13. GAP Vendor Specific Events

13.1 GAP Device Init Done
Event
Opcode
Event Parameters
GAP_DeviceInitDone
0x0600
Status, devAddr, dataPktLen, numDataPkts, IRK,

CSRK,
Description:
This event is sent to indicate that the device is done initializing.
Event Parameters:
Status: (1 octet)
Value
0x00
SUCCESS
devAddr: (6 octets)
Value
XX:XX:XX:XX:XX:XX
The devices public address (BD_ADDR).
dataPktLen: (2 octets)
Range
0x0000 0xFFFF
HC_LE_Data_Packet_Length
numDataPkts: (1 octet)
Range
0x00 0xFF
HC_Total_Num_LE_Data_Packets
IRK: (16 octets)

Value
XX:XX:XX:XX:
XX:XX:XX:XX:
XX:XX:XX:XX:
XX:XX:XX:XX
16 byte Identity Resolving Key (IRK). This is either a

randomly generated key or the original key passed in the
GAP_DeviceInit command.
CSRK: (16 octets)

Page 91 of 152
Value
XX:XX:XX:XX:
XX:XX:XX:XX:
XX:XX:XX:XX:
XX:XX:XX:XX
16 byte Connection Signature Resolving Key (CSRK).

This is either a randomly generated key or the original
key passed in the GAP_DeviceInit command.
13.2 GAP Device Discovery

Event
Opcode
Event Parameters
GAP_DeviceDiscovery
0x0601
Status, numDevs, array of {eventType, addrType,

addr}
Description:
This event is sent to indicate that the scan is complete.
Event Parameters:
Status: (1 octet)
Value
0x00
SUCCESS
numDevs: (1 octet)
Range
0 0xFF
The number of advertising devices detected during the

scan. The number reflects the type of filter used during
the scan.
Value
Scan Response
addrType: (1 octet)
Value
Page 92 of 152
Value
ADDRTYPE_PUBLIC
ADDRTYPE_STATIC
addr: (6 octets)
Range
XX:XX:XX:XX:XX:XX
Address of the device scanned.
13.3 GAP Advert Data Update Done

Event
Opcode
Event Parameters
GAP_AdvertDataUpdateDon
e
0x0602
Status , adType
Description:
This event is sent when the device sets the advertising data because of the GAP Update Advertising
Data Command.
Event Parameters:
Status: (1 octet)
Value
0x00
SUCCESS
adType: (1 octet)
Value
SCAN_RSP data
Advertisement data
13.4 GAP Make Discoverable Done

Event
Opcode
Event Parameters
Page 93 of 152
Event
Opcode
Event Parameters
GAP_MakeDiscoverableDon
e
0x0603
Status
Description:
This event is sent when the device starts advertising.
Event Parameters:
Status: (1 octet)
Value
0x00
SUCCESS
interval: (2 octets)
Range
0xXXXX
Actual advertising interval selected by the Controller
13.5 GAP End Discoverable Done

Event
Opcode
Event Parameters
GAP_EndDiscoverableDon
e
0x0604
Status
Description:
This event is sent when the device ends advertising.
Event Parameters:
Status: (1 octet)
Value
0x00
SUCCESS
13.6 GAP Link Established
Page 94 of 152
Event
Opcode
Event Parameters
GAP_LinkEstablished
0x0605
Status, devAddrType, devAddr, connHandle,

connInterval, connLatency, connTimeout,
clockAccuracy
Description:
This message is sent when a connection is established with another device. On a Central device, this
message is a result for a GAP Establish Link Request. On a Peripheral device, this message is
received when a central device initiated a connection.
Event Parameters:
Status: (1 octet)
Value
0x00
SUCCESS
devAddrType: (1 octet)
Value
ADDRTYPE_PUBLIC
ADDRTYPE_STATIC
devAddr: (6 octets)
Range
XX:XX:XX:XX:XX:XX
Address of the connected device
Range
0 0xFFFD
Handle of the connection. This will be used to reference

the connection in other connection based commands.
connInterval: (2 octets)
Value
N = 0xXXXX
Connection interval used on this connection.

Time = N * 1.25 msec
Page 95 of 152
Value
Time Range: 7.5 msec to 4 seconds
Value
N = 0xXXXX
Connection latency used on this connection.

Value
N = 0xXXXX
Connection supervision timeout.

clockAccuracy: (1 octet)
Value
500 ppm
250 ppm
150 ppm
100 ppm
75 ppm
50 ppm
30 ppm
20 ppm
8 0xFF
reserved
13.7 GAP Link Terminated

Event
Opcode
Event Parameters
GAP_LinkTerminated
0x0606
Status, connHandle, reason
Page 96 of 152

Description:
This message is sent whenever a link is terminated.
Event Parameters:
Status: (1 octet)
Value
0x00
SUCCESS
Value
XX
Connection Handle of terminated link
reason: (1 octet)
Value
0x08
Supervisor Timeout
0x13
Peer Requested
0x16
Host Requested
0x22
Control Packet Timeout
0x28
Control Packet Instant Passed
0x3B
LSTO Violation
0x3D
MIC Failure
13.8 GAP Link Parmeter Update

Event
Opcode
Event Parameters
GAP_LinkParamUpdate
0x0607
Status, connHandle, connInterval, connLatency,

connTimeout
Description:
This message is sent whenever connection parameter update is completed.
Event Parameters:
Status: (1 octet)
Value
0x00
SUCCESS
Page 97 of 152
Value
XX
Connection Handle of link
connInterval: (2 octets)
Value
N = 0xXXXX
Connection interval used on this connection.

Value
N = 0xXXXX
Connection latency used on this connection.

Range: 0x0000 to 0x01F3
Value
N = 0xXXXX
Connection supervision timeout.

Range: 0x000A to 0x0C80
Time = N * 10 msec
Time Range: 100 msec to 32 seconds
13.9 GAP Random Address Changed

Event
Opcode
Event Parameters
GAP_RandomAddrChanged
0x0608
Status, addrType, newRandomAddr
Description:
This message is sent whenever the devices Private Resolvable Address automatically changes.
Event Parameters:
Page 98 of 152

Status: (1 octet)
Value
0x00
SUCCESS
addrType: (1 octet)
Value
ADDRTYPE_PUBLIC
ADDRTYPE_STATIC
newRandomAddr: (6 octets)
Value
XX:XX:XX:XX:XX:XX
New Private Resolvable Address was generated.
13.10 GAP Signature Updated

Event
Opcode
Event Parameters
GAP_SignatureUpdated
0x0609
Status, addrType, devAddr, signCounter
Description:
This message is sent whenever sign counter is updated (incremented). This message will be
generated when a new sign counter is received from a connected device or when this device
increments its own sign counter.
Event Parameters:
Status: (1 octet)
Value
0x00
SUCCESS
addrType: (1 octet)
Value
ADDRTYPE_PUBLIC
ADDRTYPE_STATIC
Page 99 of 152
Value
devAddr: (6 octets)
Range
XX:XX:XX:XX:XX:XX
The device address of the sign counter that changed. It

may be this device or a connected device.
Range
0 0xFFFFFFFF
The new sign counter value for the referenced device.
13.11 GAP Authentication Complete

Event
Opcode
Event Parameters
GAP_AuthenticationComplet
e
0x060A
Status, connHandle,
authState,
secInfo,
secInfo.LTKsize, secInfo.LTK, secInfo.DIV,
secInfo.rand,
devSecInfo,
devSecInfo.LTKsize, devSecInfo.LTK,
devSecInfo.DIV, devSecInfo.rand,
identityInfo,
identityInfo.IRK, identityInfo.BD_ADDR,
signingInfo,
signingInfo.CSRK, signingInfo.signCounter
Description:
This event is generated whenever the pairing process is completed (pass or fail).
Event Parameters:
Status: (1 octet)
Value
0x00
SUCCESS
0x01 0xFF
Pairing failures
Page 100 of 152


Value
XX
authState: Bit Mask (1 octet)

Bit
Reserved
37
Reserved
secInfo: (1 octet)
Value
0x00
The following secInfo parameters are NOT enabled in

this event.
0x01
The following secInfo parameters are enabled in this

event.
The following security information is for the device itself:
secInfo.LTKsize: (1 octet)
Range
7 16
Encryption key size
secInfo.LTK: (16 octets)

Value
XX:XX:XX:XX:
XX:XX:XX:XX:
XX:XX:XX:XX:
XX:XX:XX:XX
secInfo.DIV: (2 octets)
Range
0 0xFFFF
secInfo.rand: (8 octets)
Value
Page 101 of 152
Value
XX:XX:XX:XX:
XX:XX:XX:XX
devSecInfo: (1 octet)
Value
0x00
The following devSecInfo parameters are NOT enabled

in this event.
0x01
The following devSecInfo parameters are enabled in

this event.
The following security information is for the connected peer device:
devSecInfo.LTKsize: (1 octet)
Range
7 16
Encryption key size
devSecInfo.LTK: (16 octets)

Value
XX:XX:XX:XX:
XX:XX:XX:XX:
XX:XX:XX:XX:
XX:XX:XX:XX
devSecInfo.DIV: (2 octets)
Range
0 0xFFFF
devSecInfo.rand: (8 octets)
Value
XX:XX:XX:XX:
XX:XX:XX:XX
identityInfo: (1 octet)
Value
0x00
The following identityInfo parameters are NOT enabled

in this event.
Page 102 of 152
Value
0x01
The following identityInfo parameters are enabled in

this event.
identityInfo.IRK: (16 octets)

Value
XX:XX:XX:XX:
XX:XX:XX:XX:
XX:XX:XX:XX:
XX:XX:XX:XX
16 byte Identity Root Key (IRK). Used to resolve Private

Resolvable Addresses.
identityInfo.BD_ADDR: (6 octets)
Range
XX:XX:XX:XX:XX:XX
The connected devices Public Address.
signingInfo: (1 octet)
Value
0x00
The following signingInfo parameters are NOT enabled

in this event.
0x01
The following signingInfo parameters are enabled in

this event.
signingInfo.IRK: (16 octets)

Value
XX:XX:XX:XX:
XX:XX:XX:XX:
XX:XX:XX:XX:
XX:XX:XX:XX
16 byte Connected Signature Resolving Key (CSRK).
signingInfo.signCounter: (2 octets)
Range
0 0xFFFF
The connected devices current sign counter
13.12 GAP Passkey Needed

Event
Opcode
Event Parameters
GAP_PasskeyNeeded
0x060B
Status, devAddr, connHandle, uiInputs, uiOutputs

Page 103 of 152
Description:
This event is generated during the pairing process if a passkey is needed.
Event Parameters:
Status: (1 octet)
Value
0x00
SUCCESS
devAddr: (6 octets)
Range
XX:XX:XX:XX:XX:XX
Address of the pairing device.
Value
XX
uiInput: (1 octet)
Value
0x00
Dont ask user to input a passcode
0x01
Ask user to input a passcode
uiOuput: (1 octet)
Value
0x00
Dont display passcode
0x01
Display a passcode
13.13 GAP Slave Requested Security

Event
Opcode
Event Parameters
GAP_SlaveRequestedSecurit
y
0x060C
Status, connHandle, devAddr, authReq
Description:
Page 104 of 152


This message is generated when the master device receives an SM Slave Request from the
connected slave device.
Event Parameters:
Status: (1 octet)
Value
0x00
SUCCESS
Value
XX
devAddr: (6 octets)
Range
XX:XX:XX:XX:XX:XX
The connected devices address.

Bit
Reserved
37
Reserved
13.14 GAP Device Information

Event
Opcode
Event Parameters
GAP_DeviceInformation
0x060D
Status, eventTypes, addrType, addr, rssi,

dataLen, dataField
Description:
This message is sent during a scan and represents another devices advertisement or SCAN_RSP
packet.
Event Parameters:
Status: (1 octet)
Page 105 of 152
Value
0x00
SUCCESS
Value
Scan Response
addrType: (1 octet)
Value
ADDRTYPE_PUBLIC
ADDRTYPE_STATIC
addr: (6 octets)
Range
XX:XX:XX:XX:XX:XX
Address of the device scanned.
rssi: (1 octet)
Range
0x00 0xFF
dataLen: (1 octet)
Range
0x00 0xFF
Number of octets in the following dataField field.
dataField: (dataLen octets)

Range
XX:XX XX
Data field of the advertisement or SCAN_RSP packets.
Page 106 of 152

13.15 GAP Bond Complete

Event
Opcode
Event Parameters
GAP_BondComplete
0x060E
Status, connHandle
Description:
This message is sent when a bond is complete and the connection is encrypted.
Event Parameters:
Status: (1 octet)
Value
0x00
SUCCESS
0x01 0xFF
error
Value
XX
13.16 GAP Pairing Requested

Event
Opcode
Event Parameters
GAP_PairingRequested
0x060F
Status, connHandle, ioCap, oobDataFlag,

authReq, maxEncKeySize, keyDist
Description:
This message is sent when a bond is complete and the connection is encrypted.
Event Parameters:
Status: (1 octet)
Value
0x00
SUCCESS
0x01 0xFF
error
Page 107 of 152
Value
XX
ioCap: (1 octet)
Value
Display Only
Display Yes or No
Keyboard Only
5 0xFF
reserved
oobDataFlag: (1 octet)
Value

Bit
Reserved
37
Reserved
maxEncKeySize: (1 octet)
Range
7 16
keyDist: Bit Mask (1 octet)

Bit
Slave Signing Key

Page 108 of 152
Bit
Master Signing Key
67
Reserved
13.17 Command Status

Event
Opcode
Event Parameters
CommandStatus
0x067F
Status, opCode, dataLen, payload
Description:
The Command Status event is used to indicate that the command given by opCode parameter has
been received and is being processed. If successful, an HCI vendor specific event that corresponds to
the command will follow. Otherwise, no event will follow since the command was not started.
Event Parameters:
Status: (1 octet)
Value
0x00
SUCCESS
0x01 0xFF
See Host Error Codes [20]
opCode: (2 octets)
Value
XX
dataLen: (1 octet)
Value
XX
Length of payload
payload: (dataLen octets)

Value
XX:XXXX
Command payload
Page 109 of 152

14. UTIL Vendor Specific Commands

14.1 UTIL Reset Command
Command
Opcode
Command Parameters
Return Parameters
UTIL_Reset
0xFE80
resetType
Status
Description:
Send this command to set reset the device.
Command Parameters:
resetType: (1 octet)
Value
Hard reset
Soft reset
Return Parameters:
Status: (1 octet)
Value
0x00
SUCCESS
0x02
Invalid resetType
Event(s) Generated:
Status parameter and reset the device in 100 milliseconds.
14.2 UTIL NV Read Command

Command
Opcode
Command Parameters
Return Parameters
UTIL_NVRead
0xFE81
nvID, nvDataLen
Status, nvData
Description:
Send this command to read an NV parameter.
Command Parameters:
Page 110 of 152

nvID: (1 octet)
Value
0x02
This devices IRK. Size is 16 bytes.
0x03
This devices CSRK. Size is 16 bytes.
0x04
This devices sign counter. Size is uint32.
0x20 0x5F
GAP Bond Manager NV Items.
GAP Bond Manager NV Items:

This range is taken with the following repeating ID offsets, used below:
0 bondRecord
1 localLTK
2 deviceLTK
3 deviceIRK
4 deviceCSRK
5 deviceSignCounter
To calculate an NV item for the GAP Bond Manager:
The NV definitions:
NVID_GB_START (0x20) - starting GAP Bond Manager NV ID
GAP_BONDINGS_MAX (default 10) - Maximum number of bonding allowed (10 is max
for number of NV IDs allocated in bcomdef.h).
Definitions for the formulas:
KEYLEN 16 bytes
B_ADDR_LEN 6 bytes
MAX_OFFSETS = 6
B_RANDOM_NUM_SIZE = 8
Structure definitions:
typedef struct
{
uint8
LTK[KEYLEN];
uint16 div;
uint8
rand[B_RANDOM_NUM_SIZE];
uint8
keySize;
} gapBondLTK_t;
typedef struct
{
uint8
publicAddr[B_ADDR_LEN];
uint8
reconnectAddr[B_ADDR_LEN];
uint16 stateFlags;
} gapBondRec_t;
// Master's address
A single bonding entry consists of 6 components (NV items):

Bond Record - defined as gapBondRec_t and uses for an NV ID offset
local LTK Info - defined as gapBondLTK_t and uses localLTK for an NV ID offset
device LTK Info - defined as gapBondLTK_t and uses deviceLTK for an NV ID offset
Page 111 of 152
device IRK - defined as "uint8 [KEYLEN]" and uses deviceIRK for an NV ID offset
device CSRK - defined as "uint8 [KEYLEN]" and uses deviceCSRK for an NV ID offset
device Sign Counter - defined as a uint32 and uses deviceSignCounter for an NV ID
offset
When the device is initialized for the first time, all (GAP_BONDINGS_MAX) NV items are
created and initialized to all 0xFF's. A bonding record of all 0xFF's indicates that the bonding
record is empty and free to use.
Example calculation for each bonding records NV IDs, bondIdx represents the bond record (0-9):
mainRecordNvID = ((bondIdx * MAX_OFFSETS) + NVID_GB_START)
localLTKNvID = (((bondIdx * MAX_OFFSETS) + localLTK) + NVID_GB_START)
devlLTKNvID = (((bondIdx * MAX_OFFSETS) + devlLTK) + NVID_GB_START)
devIRKNvID = (((bondIdx * MAX_OFFSETS) + devIRK) + NVID_GB_START)
devCSRKNvID = (((bondIdx * MAX_OFFSETS) + devCSRK) + NVID_GB_START)
devSignCounterNvID = (((bondIdx * MAX_OFFSETS) + devSignCounter) +
NVID_GB_START)
nvDataLen: (1 octet)
Value
0xXX
Length (in octets) to read from nvID
Return Parameters:
Status: (1 octet)
Value
0x00
SUCCESS
0xXX
failure
nvData: (nvDataLen octets)

Value
XX:XXXX
NV Data depends on the nvID passed in.
Event(s) Generated:
Status and nvData parameters.
14.3 UTIL NV Write Command

Command
Opcode
Command Parameters
Return Parameters
Page 112 of 152
Command
Opcode
Command Parameters
Return Parameters
UTIL_NVWrite
0xFE82
nvID, nvDataLen, nvData
Status
Description:
Send this command to write an NV parameter.
Command Parameters:
nvID: (1 octet)
Value
0xXX
See the nvID description in the UTIL NV Read

Command
nvDataLen: (1 octet)
Value
0xXX
Length (in octets) nvData
nvData: (nvDataLen octets)

Value
XX:XXXX
NV Data depends on the nvID
Return Parameters:
Status: (1 octet)
Value
0x00
SUCCESS
0xXX
failure
Event(s) Generated:
Status parameter.
14.4 UTIL Force Boot Command

Command
Opcode
Command Parameters
Return Parameters
UTIL_ForceBoot
0xFE83
None
Status
Page 113 of 152


Description:
Force the boot loader to run.
Command Parameters:
None
Return Parameters:
Status: (1 octet)
Value
0x02
INVALIDPARAMETER
Event(s) Generated:
When this command is received, the device resets if the boot loader is present. Otherwise, the host will
send the HCI Ext Command Status Event with the Status parameter set to 0x02.
Page 114 of 152

15. L2CAP Vendor Specific Commands

All L2CAP commands have the following format:
Name
Size (octets)
Description
Opcode
PDU operation code
connectionHandle
Command PDU
Variable
Command parameters
Note: The connection handle of 0xFFFE is considered as the loopback connection. All message sent to
this connection will be loop backed to the local host.
For the command parameters, please see the corresponding section below.
15.1 L2CAP_ConnParamUpdateReq (0xFC92)

The Connection Parameter Update Request is sent from the LE slave device to the LE master device.
This request allows the LE slave Host to request a set of new connection parameters.
Command Parameters:
intervalMin: (2 octets)
Range
6 - 3200
Defines minimum value for the connection event interval

in the following manner:
connIntervalMin = Interval Min * 1.25 ms. Interval Min
range: 6 to 3200 frames where 1 frame is 1.25 ms and
equivalent to 2 BR/EDR slots. Values outside the range
are reserved. Interval Min shall be less than or equal to
Interval Max.
intervalMax: (2 octets)
Range
6 - 3200
Defines maximum value for the connection event

interval in the following manner:
connIntervalMax = Interval Max * 1.25 ms. Interval Max
range: 6 to 3200 frames. Values outside the range are
reserved. Interval Max shall be equal to or greater than
the Interval Min.
slaveLatency: (2 octets)
Range
Page 115 of 152
Range
0 - 500
Defines the slave latency parameter (as number of LL

connection events) in the following manner:
connSlaveLatency = Slave Latency. The Slave Latency
field shall have a value in the range of 0 to
((connSupervisionTimeout / connIntervalMax) - 1). The
Slave Latency field shall be less than 500.
timeoutMultiplier: (2 octets)
Range
10 - 3200
Defines connection timeout parameter in the following

manner:
connSupervisionTimeout = Timeout Multiplier * 10 ms
The Timeout Multiplier field shall have a value in the
range of 10 to 3200.
Return Parameters:
Status: (1 octet)
Value
0x00
SUCCESS
0x01
FAILURE
0x02
INVALIDPARAMETER
0x04
MSG_BUFFER_NOT_AVAIL
0x13
bleMemAllocError
0x14
bleNotConnected
0x15
bleNoResources
Event(s) Generated:
When this request is received, the LE slave host will send the Command Status Event with the Status
parameter after forwarding the request to the LE master host. The LE master host will send the
Connection Parameter Update Response (L2CAP_ConnParamUpdateRsp) event back.
If the LE slave host receives this request, it will respond with a Command Reject (L2CAP_CmdReject)
with reason 0x0000 (command not understood).
Page 116 of 152

16. L2CAP Vendor Specific Events

All L2CAP events have the following format:
Name
Size (octets)
Description
Opcode
PDU operation code
status
Event status
connectionHandle
Event PDU
Variable
Event parameters
Event Status:
Value
0x00
SUCCESS
0x14
bleNotConnected
0x17
bleTimeout
For the event parameters, please see the corresponding section below.
16.1 L2CAP_CmdRejct (0x0481)

The Command Reject is sent in response to a command with an unknown command code or when
sending the corresponding response is inappropriate.
Event Parameters:
reason: (2 octets)
Value
0x0000
Command not understood
0x0001
Signaling MTU exceeded
0x0002
Invalid CID in request
16.2 L2CAP_ConnParamUpdateRsp (0x0493)

This Connection Parameter Update Response is sent from the LE master device to the LE slave
device. This response is sent by the master Host when it receives a Connection Parameter Update
Request packet.
Event Parameters:
Page 117 of 152

result: (2 octets)
Value
0x0000
Connection Parameters accepted
0x0001
Connection Parameters rejected
Page 118 of 152

17. ATT Vendor Specific Commands and Events

Most of the ATT requests and responses have two associated opcodes, command and event, due to
Request and Response Tunneling as per section 9.3.
17.1 ATT Vendor Specific Commands

All ATT commands have the following format:
Name
Size (octets)
Description
Opcode
PDU operation code
connectionHandle
Command PDU
Variable
Command parameters
Note: The connection handle of 0xFFFE is considered as the loopback connection. All messages sent
to this connection will be loop backed to the local host.
Event(s) Generated:
When an ATT command is received, the host will send the Command Status Event with the Status
parameter.
Return Parameters:
Status: (1 octet)
Value
0x00
SUCCESS
0x02
INVALIDPARAMETER
0x04
0x13
bleMemAllocError
0x14
bleNotConnected
0x16
blePending
0x19
bleLinkEncrypted
0x40
bleInvalidPDU
0x41
bleInsufficientAuthen
0x42
bleInsufficientEncrypt
0x43
bleInsufficientKeySize
Page 119 of 152

17.2 ATT Vendor Specific Events

All ATT events have the following format:
Name
Size (octets)
Description
Opcode
PDU operation code
status
Event status
connectionHandle
pduLen
Length of event PDU
Event PDU
Variable
Event parameters
Event Status:
Value
0x00
SUCCESS
0x14
bleNotConnected
0x17
bleTimeout
0x1A
bleProcedureComplete
17.3 ATT_ErrorRsp (Command = 0xFD01, Event = 0x0501)

The Error Response is used to state that a given request cannot be performed and to provide the
reason.
Note: The Write Command does not generate an Error Response.
Response Parameters:
reqOpcode: (1 octet)
Value
XX
The request that generated this error response
handle: (2 octets)
Range
0x0001 0xFFFF
The attribute handle that generated this error response

Page 120 of 152
errCode: (1 octet)
Value
0x01
0x02
0x03
0x04
0x05
0x06
0x07
0x08
0x09
0x0A
0x0B
0x0C
0x0D
0x0E
0x0F
0x10
0x11
0x80
The attribute handle given was not valid on this server.
The attribute cannot be read.
The attribute cannot be written.
The attribute PDU was invalid.
The attribute requires authentication before it can be
read or written.
Attribute server does not support the request received
from the client.
Offset specified was past the end of the attribute.
The attribute requires authorization before it can be read
or written.
Too many prepare writes have been queued.
No attribute found within the given attribute handle
range.
The attribute cannot be read or written using the Read
Blob Request.
The Encryption Key Size used for encrypting this link is
insufficient.
The attribute value length is invalid for the operation.
The attribute request that was requested has
encountered an error that was unlikely, and therefore
could not be completed as requested.
The attribute requires encryption before it can be read or
written.
The attribute type is not a supported grouping attribute as
defined by a higher layer specification.
Insufficient Resources to complete the request.
The attribute value is invalid for the operation.
17.4 ATT_ExchangeMTUReq (Command = 0xFD02, Event = 0x0502)

The Exchange MTU Request is used by the client to inform the server of the clients maximum receive
MTU size and request the server to respond with its maximum receive MTU size is used to state that a
given request cannot be performed and to provide the reason.
Request Parameters:
clientRxMTU: (2 octets)
Value
XX
Client receive MTU size
Page 121 of 152


Event(s) Generated:
When this request is received, the server will send the Exchange MTU Response.
17.5 ATT_ExchangeMTURsp (Command = 0xFD03, Event = 0x0503)

The Exchange MTU Response is sent in reply to a received Exchange MTU Request.
serverRxMTU: (2 octets)
Value
XX
Attribute server receive MTU size
17.6 ATT_FindInfoReq (Command = 0xFD04, Event = 0x0504)

The Find Information Request is used to obtain the mapping of attribute handles with their associated
types. This allows a client to discover the list of attributes and their types on a server.
Request Parameters:
startHandle: (2 octets)
Value
0xXXXX
First requested handle number
endHandle: (2 octets)
Value
0xXXXX
Last requested handle number
Event(s) Generated:
When this request is received, the server will send the Find Information Response. The client will
forward all the Find Information Responses to the calling application. The response with the status of
bleProcedureComplete will indicate the end of the sub-procedure.
If no attributes will be returned or any of the requested parameters is invalid, the server will send an
Error Response.
17.7 ATT_FindInfoRsp (Command = 0xFD05, Event = 0x0505)

The Find Information Response is sent in reply to a received Find Information Request and contains
information about the server.
Page 122 of 152


format: (1 octet)
Value
0x01
0x02
A list of 1 or more handles with their 16-bit Bluetooth
UUIDs
A list of 1 or more handles with their 128-bit UUIDs
info: (4 to (ATT_MTU - 2) octets)

Value
XX:XX:XX:XXXX
The information data whose format is
determined by the format field
The information data field is comprised of a list of data defined in the tables below depending on the
value chosen for the format.
format = 0x01 (handles and their 16-bit Bluetooth UUIDs)

Handle
2 octets
16-bit Bluetooth UUID

2 octets
format = 0x02 (handles and their 128-bit UUIDs)

Handle
2 octets
128-bit UUID
16 octets
17.8 ATT_FindByTypeValueReq (Command = 0xFD06, Event = 0x0506)

The Find By Type Value Request is used to obtain the handles of attributes that have a 16-bit UUID
attribute type and attribute value. This allows the range of handles associated with a given attribute to
be discovered when the attribute type determines the grouping of a set of attributes.
Request Parameters:
Value
0xXXXX
Value
0xXXXX
Page 123 of 152


type: (2 octets)
Value
XX:XX
2 octet UUID to find
value: (0 to (ATT_MTU - 7) octets)

Value
XX:XXXX
Attribute value to find
Event(s) Generated:
When this request is received, the server will send the Find By Type Value Response. The client will
forward all the Find By Type Value Responses to the calling application. The response with the status
of bleProcedureComplete will indicate the end of the sub-procedure.
If no attributes will be returned or any of the requested parameters is invalid, the server will send an
Error Response.
17.9 ATT_FindByTypeValueRsp (Command = 0xFD07, Event = 0x0507)

The Find By Type Value Response is sent in reply to a received Find By Type Value Request and
contains information about this server.
handlesInfo: (4 to (ATT_MTU - 1) octets)
Value
XX:XX:XX:XXXX
A list of 1 or more Handle Information.
The Handles Information List field is a list of one or more Handle Information. The Handles Information
field is an attribute handle range as defined in Format of the Handles Information table below:
Format of Handles Information

Found Attribute Handle
Handle Group End Handle
2 octets
2 octets
17.10 ATT_ReadByTypeReq (Command = 0xFD08, Event = 0x0508)

The Read By Type Request is used to obtain the values of attributes where the attribute type is known
but the handle is not known.
Request Parameters:
Page 124 of 152

Value
0xXXXX
Value
0xXXXX
type: (2 or 16 octets)
Value
XX:XX or XX:XXXX
2 or 16 octet UUID
Event(s) Generated:
When this request is received, the server will send the Read By Type Response. The client will forward
all the Read By Type Responses to the calling application. The response with the status of
If no attribute with the given type exists within the handle range or the attribute value cannot be read,
the server will send an Error Response.
17.11 ATT_ReadByTypeRsp (Command = 0xFD09, Event = 0x0509)

The Read By Type Response is sent in reply to a received Read By Type Request and contains the
handles and values of the attributes that have been read.
length: (1 octet)
Value
0xXX
The size of each attribute handle-value pair
data: (2 to (ATT_MTU-2) octets)

Value
XX:XXXX
A list of Attribute Data.
The Attribute Data field is comprised of a list of attribute handle and value pairs as defined in Format
of the Attribute Data table below:
Format of Attribute Data

Page 125 of 152
Attribute Handle
Attribute Value
2 octets
(Length - 2) octets
17.12 ATT_ReadReq (Command = 0xFD0A, Event = 0x050A)

The Read Request is used request the server to read the value of an attribute and return its value in a
Read Response.
Request Parameters:
handle: (2 octets)
Value
0xXXXX
The handle of the attribute to be read
Event(s) Generated:
When this request is received, the server will send the Read Response.
If the attribute handle is invalid or the attribute value cannot be read, the server will send an Error
Response.
17.13 ATT_ReadRsp (Command = 0xFD0B, Event = 0x050B)

The Read Response is sent in reply to a received Read Request and contains the value of the attribute
that has been read.
Value
XX:XXXX
The value of the attribute with the handle given
17.14 ATT_ReadBlobReq (Command = 0xFD0C, Event = 0x050C)

The Read Blob Request is used request the server to read part of the value of an attribute at a given
offset and return a specific part of the value in a Read Blob Response.
Request Parameters:
handle: (2 octets)
Value
0xXXXX
The handle of the attribute to be read
Page 126 of 152

offset: (2 octets)
Value
0xXXXX
The offset of the first octet to be read
Event(s) Generated:
When this request is received, the server will send the Read Blob Response. The client will forward all
the Read Blob Responses to the calling application. The response with the status of
If the attribute handle or offset is invalid, or the attribute value cannot be read, the server will send an
Error Response.
17.15 ATT_ReadBlobRsp (Command = 0xFD0D)

The Read Blob Response is sent in reply to a received Read Blob Request and contains part of the
value of the attribute that has been read.
Value
XX:XXXX
Part of the value of the attribute with the handle given
17.16 ATT_ReadMultiReq (Command = 0xFD0E, Event = 0x050E)

The Read Multiple Request is used to request the server to read two or more values of a set of
attributes and return their values in a Read Multiple Response. Only values that have a known fixed
size can be read, with the exception of the last value that can have a variable length.
Request Parameters:
handles: (4 to (ATT_MTU-1) octets)
Value
XX:XX:XX:XXXX
A set of two or more attribute handles.
Event(s) Generated:
When this request is received, the server will send the Read Multiple Response.
If any of the attribute handles are invalid or any of the attribute values cannot be read, the server will
send an Error Response.
Page 127 of 152

17.17 ATT_ReadMultiRsp (Command = 0xFD0F, Event = 0x050F)

The Read Multiple Response is sent in reply to a received Read Multiple Request and contains the
values of the attributes that have been read.
values: (0 to (ATT_MTU - 1) octets)
Value
A set of two or more values.
XXXX
17.18 ATT_ReadByGrpTypeReq (Command = 0xFD10, Event = 0x0510)

The Read By Group Type Request is used to obtain the values of attributes where the attribute type is
known, the type of a grouping attribute as defined by a higher layer specification, but the handle is not
known.
Request Parameters:
Value
0xXXXX
Value
0xXXXX
groupType: (2 or 16 octets)
Value
XX:XX or XX:XXXX
2 or 16 octet UUID
Event(s) Generated:
When this request is received, the server will send the Read By Group Type Response. The client will
forward all the Read By Group Type Responses to the calling application. The response with the status
of bleProcedureComplete will indicate the end of the sub-procedure.
If no attributes with the given type exists within the handle ranges or the Attribute Group Type is not a
supported grouping attribute, the server will send an Error Response.
Page 128 of 152

17.19 ATT_ReadByGrpTypeRsp (Command = 0xFD11, Event = 0x0511)

The Read By Group Type Response is sent in reply to a received Read By Group Type Request and
contains the handles and values of the attributes that have been read.
length: (1 octet)
Value
0xXX
The size of each attribute handle-value pair
attrData: (2 to (ATT_MTU - 2) octets)

Value
XX:XX:XX
A list of Attribute Data.
The Attribute Data field is comprised of a list of attribute handle and value pairs as defined in Format
of the Attribute Data table below:
Format of Attribute Data

Attribute Handle
End Group Handle
Attribute Value
2 octets
2 octets
(Length - 4) octets
17.20 ATT_WriteReq (Command = 0xFD12, Event = 0x0512)

The Write Request is used to request the server to write the value of an attribute and acknowledge that
this has been achieved in a Write Response.
The command field is set for the Write Command. The signature and command fields are set for the
Signed Write Command.
Request Parameters:
The signature field represents different data as defined in the tables below depending on the type of
the message.
signature: (1 octet) when the field is part of a command

Value
0x00
0x01
Do not include the Authentication Signature with the
Write PDU.
Include the Authentication Signature with the Write PDU.
signature: (1 octet) - when the field is part of an event

Page 129 of 152
Value
0x00
0x01
0x02
The Authentication Signature is not included with the
Write PDU.
The included Authentication Signature is valid.
The included Authentication Signature is not valid.
command: (1 octet)
Value
0x00 or 0x01
Whether this is a Write Command:
0x00 - No
0x01 - Yes
handle: (2 octets)
Value
0xXXXX
The handle of the attribute to be Written.

Value
XXXX
The value to be written to the attribute.
Event(s) Generated:
When this request is received, the server will send the Write Response.
If the attribute handle is invalid or the attribute value cannot be written, the server will send an Error
Response. The server will not send an Error Response for the Write Command.
17.21 ATT_WriteRsp (Command = 0xFD13, Event = 0x0513)

The Write Response is sent in reply to a valid Write Request and acknowledges that the attribute has
been successfully written.
None
17.22 ATT_PrepareWriteReq (Command = 0xFD16, Event = 0x0516)

The Prepare Write Request is used to request the server to prepare to write the value of an attribute.
The server will respond to this request with a Prepare Write Response, so that the client can verify that
the value was received correctly.
A client may send more than one Prepare Write Request to a server, which will queue and send a
response for each handle value pair.
Page 130 of 152
Request Parameters:
handle: (2 octets)
Value
0xXXXX
offset: (2 octets)
Value
0xXXXX
The offset of the first octet to be Written.

Value
XXXX
Part of the value of the attribute to be written.
Event(s) Generated:
When this request is received, the server will send the Prepare Write Response. The client will forward
the response to the calling application only when the compile option TESTMODES is used.
If the attribute handle is invalid or the attribute value cannot be written, the server will send an Error
Response.
17.23 ATT_PrepareWriteRsp (Command = 0xFD17, Event = 0x0517)

The Prepare Write Response is sent in response to a received Prepare Write Request and
acknowledges that the value has been successfully received and placed in the prepare write queue.
handle: (2 octets)
Value
0xXXXX
offset: (2 octets)
Value
0xXXXX

Value
Page 131 of 152

Value
XXXX
Part of the value of the attribute to be written.
17.24 ATT_ExecuteWriteReq (Command = 0xFD18, Event = 0x0518)

The Execute Write Request is used to request the server to write or cancel the write of all the prepared
values currently held in the prepare queue from this client. This request shall be handled by the server
as an atomic operation.
Request Parameters:
flags: (1 octet)
Value
0x00
0x01
Cancel all prepared writes
Immediately write all pending prepared values
Event(s) Generated:
When this request is received, the server will send the Execute Write Response.
If the attribute value cannot be written, the server will send an Error Response.
17.25 ATT_ExecuteWriteRsp (Command = 0xFD19, Event = 0x0519)

The Execute Write Response is sent in response to a received Execute Write Request.
None
17.26 ATT_HandleValueNoti (Command = 0xFD1B, Event = 0x051B)

A server can send a notification of an attributes value at any time.
Request Parameters:
Value
0x00 or 0x01
Whether or not an authenticated link is required:
0x00 - No
0x01 - Yes
handle: (2 octets)
Page 132 of 152
Value
0xXXXX
The handle of the attribute.

Value
XXXX
The current value of the attribute.
Event(s) Generated:
None
17.27 ATT_HandleValueInd (Command = 0xFD1D, Event = 0x051D)

A server can send an indication of an attributes value at any time.
Request Parameters:
Value
0x00 or 0x01
Whether or not an authenticated link is required:
0x00 - No
0x01 - Yes
handle: (2 octets)
Value
0xXXXX
The handle of the attribute.

Value
XXXX
The current value of the attribute.
Event(s) Generated:
The client shall send a Handle Value Confirmation in response to a Handle Value Indication. No further
indications to this client shall occur until the confirmation has been received by the server.
17.28 ATT_HandleValueCfm (Command = 0xFD1E, Event = 0x051E)

The Handle Value Confirmation is sent in response to a received Handle Value Indication and confirms
that the client has received an indication of the given attribute.
Page 133 of 152
Request Parameters:
None
Page 134 of 152

18. GATT Vendor Specific Commands

All GATT commands have the following format:
Name
Size (octets)
Description
Opcode
PDU operation code
connectionHandle
Command PDU
Variable
Command parameters
Event(s) Generated:
When a GATT command is received, the host will send the Command Status Event with the Status
parameter.
Return Parameters:
Status: (1 octet)
Value
0x00
SUCCESS
0x02
INVALIDPARAMETER
0x04
0x13
bleMemAllocError
0x14
bleNotConnected
0x40
bleInvalidPDU
18.1 GATT_ExchangeMTU (0xFD82)

This sub-procedure is used by a client to set the ATT_MTU to the maximum possible value that can be
supported by both devices when the client supports a value greater than the default ATT_MTU for the
Attribute Protocol. This sub-procedure shall only be initiated once during a connection.
The ATT Exchange MTU Request is used by this sub-procedure.
Request Parameters:
Please refer to Section 17.4 for the format of the request parameters.
Page 135 of 152


Event(s) Generated:
This sub-procedure is complete when either ATT_ExchangeMTURsp (with SUCCESS or bleTimeout
status) or ATT_ErrorRsp (with SUCCESS status) is received by the calling application task.
18.2 GATT_DiscAllPrimaryServices (0xFD90)

This sub-procedure is used by a client to discover all the primary services on a server.
The ATT Read By Group Type Request is used with the Attribute Type parameter set to the UUID for
"Primary Service". The Starting Handle is set to 0x0001 and the Ending Handle is set to 0xFFFF.
Request Parameters:
None.
Event(s) Generated:
This sub-procedure is complete when either ATT_ReadByGrpTypeRsp (with bleProcedureComplete or
bleTimeout status) or ATT_ErrorRsp (with SUCCESS status) is received by the calling application task.
18.3 GATT_DiscPrimaryServiceByUUID (0xFD86)

This sub-procedure is used by a client to discover a specific primary service on a server when only the
Service UUID is known. The specific primary service may exist multiple times on a server. The primary
service being discovered is identified by the service UUID.
The ATT Find By Type Value Request is used with the Attribute Type parameter set to the UUID for
"Primary Service" and the Attribute Value set to the 16-bit Bluetooth UUID or 128-bit UUID for the
specific primary service. The Starting Handle shall be set to 0x0001 and the Ending Handle shall be
set to 0xFFFF.
Request Parameters:
Value
XX:XXXX
Attribute value to find
Event(s) Generated:
This sub-procedure is complete when either ATT_FindByTypeValueRsp (with bleProcedureComplete
or bleTimeout status) or ATT_ErrorRsp (with SUCCESS status) is received by the calling application
task.
Page 136 of 152

18.4 GATT_FindIncludedServices (0xFDB0)

This sub-procedure is used by a client to find include service declarations within a service definition on
a server. The service specified is identified by the service handle range.
The ATT Read By Type Request is used with the Attribute Type parameter set to the UUID for
"Included Service". The Starting Handle is set to starting handle of the specified service and the
Ending Handle is set to the ending handle of the specified service.
Request Parameters:
Value
0xXXXX
Value
0xXXXX
Event(s) Generated:
This sub-procedure is complete when either ATT_ReadByTypeRsp (with bleProcedureComplete or
18.5 GATT_DiscAllChars (0xFDB2)

This sub-procedure is used by a client to find all the characteristic declarations within a service
definition on a server when only the service handle range is known. The service specified is identified
by the service handle range.
The ATT Read By Type Request is used with the Attribute Type parameter set to the UUID for
"Characteristic". The Starting Handle is set to starting handle of the specified service and the Ending
Handle is set to the ending handle of the specified service.
Request Parameters:
Value
0xXXXX
Value
0xXXXX
Page 137 of 152


Event(s) Generated:
18.6 GATT_DiscCharsByUUID (0xFD88)

This sub-procedure is used by a client to discover service characteristics on a server when only the
service handle ranges are known and the characteristic UUID is known. The specific service may exist
multiple times on a server. The characteristic being discovered is identified by the characteristic UUID.
The ATT Read By Type Request is used with the Attribute Type is set to the UUID for "Characteristic"
and the Starting Handle and Ending Handle parameters is set to the service handle range.
Request Parameters:
Value
0xXXXX
Value
0xXXXX
type: (2 or 16 octets)
Value
XX:XX or XX:XXXX
2 or 16 octet UUID
Event(s) Generated:
18.7 GATT_DiscAllCharDescs (0xFD84)

This sub-procedure is used by a client to find all the characteristic descriptors Attribute Handles and
Attribute Types within a characteristic definition when only the characteristic handle range is known.
The characteristic specified is identified by the characteristic handle range.
The ATT Find Information Request is used with the Starting Handle set to starting handle of the
specified characteristic and the Ending Handle set to the ending handle of the specified characteristic.
The UUID Filter parameter is NULL (zero length).
Request Parameters:
Page 138 of 152

Event(s) Generated:
This sub-procedure is complete when either ATT_FindInfoRsp (with bleProcedureComplete or
18.8 GATT_ReadCharValue (0xFD8A)

This sub-procedure is used to read a Characteristic Value from a server when the client knows the
Characteristic Value Handle. The ATT Read Request is used with the Attribute Handle parameter set to
the Characteristic Value Handle. The Read Response returns the Characteristic Value in the Attribute
Value parameter.
The Read Response only contains a Characteristic Value that is less than or equal to (ATT_MTU 1)
octets in length. If the Characteristic Value is greater than (ATT_MTU 1) octets in length, the Read
Long Characteristic Value procedure may be used if the rest of the Characteristic Value is required.
Request Parameters:
Event(s) Generated:
This sub-procedure is complete when either ATT_ReadRsp (with bleProcedureComplete or bleTimeout
18.9 GATT_ReadUsingCharUUID (0xFDB4)

This sub-procedure is used to read a Characteristic Value from a server when the client only knows the
characteristic UUID and does not know the handle of the characteristic.
The ATT Read By Type Request is used to perform the sub-procedure. The Attribute Type is set to the
known characteristic UUID and the Starting Handle and Ending Handle parameters shall be set to the
range over which this read is to be performed. This is typically the handle range for the service in
which the characteristic belongs.
Request Parameters:
Event(s) Generated:
Page 139 of 152

18.10 GATT_ReadLongCharValue (0xFD8C)

This sub-procedure is used to read a Characteristic Value from a server when the client knows the
Characteristic Value Handle and the length of the Characteristic Value is longer than can be sent in a
single Read Response Attribute Protocol message.
The ATT Read Blob Request is used in this sub-procedure.
Request Parameters:
Event(s) Generated:
This sub-procedure is complete when either ATT_ReadBlobRsp (with bleProcedureComplete or
18.11 GATT_ReadMultiCharValues (0xFD8E)

This sub-procedure is used to read multiple Characteristic Values from a server when the client knows
the Characteristic Value Handles. The Attribute Protocol Read Multiple Requests is used with the Set
Of Handles parameter set to the Characteristic Value Handles. The Read Multiple Response returns
the Characteristic Values in the Set Of Values parameter.
The ATT Read Multiple Request is used in this sub-procedure.
Request Parameters:
Event(s) Generated:
This sub-procedure is complete when either ATT_ReadMultiRsp (with SUCCESS or bleTimeout status)
or ATT_ErrorRsp (with SUCCESS status) is received by the calling application task.
18.12 GATT_WriteNoRsp (0xFDB6)

This sub-procedure is used to write a Characteristic Value to a server when the client knows the
Characteristic Value Handle and the client does not need an acknowledgement that the write was
successfully performed. This sub-procedure only writes the first (ATT_MTU 3) octets of a
Characteristic Value. This sub-procedure can not be used to write a long characteristic; instead the
Write Long Characteristic Values sub-procedure should be used.
The ATT Write Command is used for this sub-procedure. The Attribute Handle parameter shall be set
to the Characteristic Value Handle. The Attribute Value parameter shall be set to the new
Characteristic Value.
Request Parameters:
Page 140 of 152


handle: (2 octets)
Value
0xXXXX

Value
XXXX
Event(s) Generated:
No response will be sent to the calling application task for this sub-procedure. If the Characteristic
Value write request is the wrong size, or has an invalid value as defined by the profile, then the write
will not succeed and no error will be generated by the server.
18.13 GATT_SignedWriteNoRsp (0xFDB8)

Characteristic Value Handle and the ATT Bearer is not encrypted. This sub-procedure shall only be
used if the Characteristic Properties authenticated bit is enabled and the client and server device share
a bond as defined in the GAP.
This sub-procedure only writes the first (ATT_MTU 15) octets of an Attribute Value. This subprocedure cannot be used to write a long Attribute.
The ATT Write Command is used for this sub-procedure. The Attribute Handle parameter shall be set
to the Characteristic Value Handle. The Attribute Value parameter shall be set to the new
Characteristic Value authenticated by signing the value, as defined in the Security Manager.
Request Parameters:
handle: (2 octets)
Value
0xXXXX

Value
XXXX
Event(s) Generated:
No response will be sent to the calling application task for this sub-procedure. If the authenticated
Characteristic Value that is written is the wrong size, or has an invalid value as defined by the profile,
or the signed value does not authenticate the client, then the write will not succeed and no error will be
generated by the server.
Page 141 of 152
18.14 GATT_WriteCharValue (0xFD92)

This sub-procedure is used write a characteristic value to a server when the client knows the
characteristic value handle. This sub-procedure only writes the first (ATT_MTU-3) octets of a
characteristic value. This sub-procedure can not be used to write a long attribute; instead the Write
Long Characteristic Values sub-procedure should be used.
The ATT Write Request is used in this sub-procedure. The Attribute Handle parameter shall be set to
the Characteristic Value Handle. The Attribute Value parameter shall be set to the new characteristic.
Request Parameters:
Event(s) Generated:
This sub-procedure is complete when either ATT_WriteRsp (with SUCCESS or bleTimeout status) or
ATT_ErrorRsp (with SUCCESS status) is received by the calling application task.
18.15 GATT_WriteLongCharValue (0xFD96)

Characteristic Value Handle but the length of the Characteristic Value is longer than can be sent in a
single Write Request Attribute Protocol message.
The ATT Prepare Write Request and Execute Write Request are used to perform this sub-procedure.
Request Parameters:
handle: (2 octets)
Value
0xXXXX
offset: (2 octets)
Value
0xXXXX
value: (0 to 512 octets)

Value
XXXX
The value of the attribute to be written. Note: the stack
implementation supports the maximum length of 512
octets but this is always bound by the physical interface
used to communicate with the device.
Page 142 of 152


Event(s) Generated:
This sub-procedure is complete when either ATT_PrepareWriteRsp (with bleTimeout status),
ATT_ExecuteWriteRsp (with SUCCESS or bleTimeout status), or ATT_ErrorRsp (with SUCCESS
status) is received by the calling application task.
18.16 GATT_ReliableWrites (0xFDBA)

Characteristic Value Handle, and assurance is required that the correct Characteristic Value is going to
be written by transferring the Characteristic Value to be written in both directions before the write is
performed. This sub-procedure can also be used when multiple values must be written, in order, in a
single operation.
The sub-procedure has two phases; the first phase prepares the characteristic values to be written.
Once this is complete, the second phase performs the execution of all of the prepared characteristic
value writes on the server from this client.
In the first phase, the ATT Prepare Write Request is used. In the second phase, the attribute protocol
Execute Write Request is used.
Request Parameters:
numberRequests: (1 octet)
Value
The number of Prepare Write Request messages.
0xXX
requests: (0 to 512 octets)

Value
XX:XX:XX
A list of Prepare Write Request messages. Note: the
stack implementation supports the maximum length of
512 octets but this is always bound by the physical
interface used to communicate with the device.
The Requests field is comprised of a list of Attribute Value Length and Prepare Write Request as
defined in Format of the Requests table below:
Format of Requests
Attribute Value
Length
Prepare Write Request
1 octet
Please see Section 17.22 for the format of Prepare Write

Request
Event(s) Generated:
Page 143 of 152


18.17 GATT_ReadCharDesc (0xFDBC)

This sub-procedure is used to read a Characteristic Descriptor from a server when the client knows the
Characteristic Descriptors Handle.
The ATT Read Request is used for this sub-procedure. The Read Request is used with the Attribute
Handle parameter set to the characteristic descriptor handle. The Read Response returns the
characteristic descriptor value in the Attribute Value parameter.
Request Parameters:
Event(s) Generated:
This sub-procedure is complete when either ATT_ReadRsp (with bleProcedureComplete or bleTimeout
18.18 GATT_ReadLongCharDesc (0xFDBE)

This sub-procedure is used to read a Characteristic Descriptor from a server when the client knows the
Characteristic Descriptor Declarations Attribute Handle and the length of the Characteristic Descriptor
Declaration is longer than can be sent in a single Read Response Attribute Protocol message.
The ATT Read Blob Request is used to perform this sub-procedure. The Attribute Handle parameter
shall be set to the characteristic descriptor handle. The Value Offset parameter shall be the offset
within the characteristic descriptor to be read.
Request Parameters:
Event(s) Generated:
This sub-procedure is complete when either ATT_ReadBlobRsp (with bleProcedureComplete or
18.19 GATT_WriteCharDesc (0xFDC0)

This sub-procedure is used write a characteristic descriptor to a server when the client knows the
characteristic descriptor handle.
The ATT Write Request is used for this sub-procedure. The Attribute Handle parameter shall be set to
the characteristic descriptor handle. The Attribute Value parameter shall be set to the new
characteristic descriptor value.
Page 144 of 152
Request Parameters:
Event(s) Generated:
This sub-procedure is complete when either ATT_WriteRsp (with SUCCESS or bleTimeout status) or
ATT_ErrorRsp (with SUCCESS status) is received by the calling application task.
18.20 GATT_WriteLongCharDesc (0xFDC2)

Characteristic Value Handle but the length of the Characteristic Value is longer than can be sent in a
single Write Request Attribute Protocol message.
The ATT Prepare Write Request and Execute Write Request are used to perform this sub-procedure.
Request Parameters:
handle: (2 octets)
Value
0xXXXX
offset: (2 octets)
Value
0xXXXX
value: (0 to 512 octets)

Value
XXXX
The value of the attribute to be written. Note: the stack
implementation supports the maximum length of 512
octets but this is always bound by the physical interface
used to communicate with the device.
Event(s) Generated:
Page 145 of 152

18.21 GATT_Notification (0xFD9B)

This sub-procedure is used when a server is configured to notify a characteristic value to a client
without expecting any attribute protocol layer acknowledgement that the notification was successfully
received.
The ATT Handle Value Notification is used in this sub-procedure.
Note: A notification may be sent at any time and does not invoke a confirmation.
Request Parameters:
Event(s) Generated:
None.
18.22 GATT_Indication (0xFD9D)

This sub-procedure is used when a server is configured to indicate a characteristic value to a client and
expects an attribute protocol layer acknowledgement that the indication was successfully received.
The ATT Handle Value Indication is used in this sub-procedure.
Request Parameters:
Event(s) Generated:
This sub-procedure is complete when ATT_HandleValueCfm (with SUCCESS or bleTimeout status) is
received by the calling application task.
18.23 GATT_AddService (0xFDFC)

This command is used to add a new service to the GATT Server on the Network Processor when the
GATT Database is implemented on the Application Processor. The GATT_AddAttribute command
described in Section 18.25 must be used to add additional attributes to the service. The new service
will be automatically registered with the GATT Server if it has no additional attribute to be added.
Note: The Command Status Event will have the Start Handle and End Handle for the service
registered with the GATT Server.
No ATT request is used to perform this command.
Request Parameters:
UUID: (2 octets)
Value
Page 146 of 152
Value
00:28 or 01:28
The type of the service to be added:
0x2800 Primary Service
0x2801 Secondary Service
numAttrs: (2 octets)
Value
XX:XX
The number of the attributes in the service (including the
service attribute).
Event(s) Generated:
None.
18.24 GATT_DelService (0xFDFD)

This command is used to delete a service from the GATT Server on the Network Processor when the
GATT Database is implemented on the Application Processor.
Request Parameters:
handle: (2 octets)
Value
XX:XX
The handle of the service to be deleted (0x0000 if the
service hasnt been registered with the GATT Server
yet).
Event(s) Generated:
None.
18.25 GATT_AddAttribute (0xFDFE)

This command is used to add a new attribute to the service being added to the GATT Server on the
Network Processor when the GATT Database is implemented on the Application Processor. The
service will be automatically registered with the GATT Server when its last attribute is added.
Note: The Command Status Event will have the Start Handle and End Handle for the service
registered with the GATT Server.
Request Parameters:
UUID: (2 or 16 octets)
Page 147 of 152
Value
XX:XX or XX::XX
The type of the attribute to be added to a service.
permissions: Bit Mask (1 octet)

Value
0x01
GATT_PERMIT_READ
0x02
GATT_PERMIT_WRITE
0x04
GATT_PERMIT_AUTHEN_READ
0x08
GATT_PERMIT_AUTHEN_WRITE
0x10
GATT_PERMIT_AUTHOR_READ
0x20
GATT_PERMIT_AUTHOR_WRITE
Event(s) Generated:
None.
Page 148 of 152

19. GATT Vendor Specific Events

All GATT events have the following format:
Name
Size (octets)
Description
Opcode
PDU operation code
status
Event status
connectionHandle
pduLen
Length of event PDU
Event PDU
Variable
Event parameters
Event Status:
Value
0x00
SUCCESS
0x14
bleNotConnected
0x17
bleTimeout
0x1A
19.1 GATT_ClientCharCfgUpdated (0x0580)

The Client Characteristic Configuration Updated event is generated whenever the Client Characteristic
Configuration attribute value is updated for a connection (i.e., GATT client).
attributeHandle: (2 octets)
Value
The handle of the Client Characteristic Configuration
attribute
0xXXXX
value: Bit Mask (2 octets)

Value
0x0000
No operation
Page 149 of 152
Value
0x0001
The Characteristic Value is configured to be notified
0x0002
The Characteristic Value is configured to be indicated
0xFFF4
Reserved for future use
Page 150 of 152

20. Host Error Codes

This section lists the various possible error codes generated by the Host. If an HCI extension command
that sent a Command Status with the error code SUCCESS before processing may find an error
during execution then the error is reported in the normal completion command for the original
command.
The error code 0x00 means SUCCESS. The possible range of failure error codes is 0x01-0xFF. The
table below provides an error code description for each failure error code.
Value
0x00
SUCCESS
0x00
FAILURE
0x02
INVALIDPARAMETER
0x03
INVALID_TASK
0x04
0x05
INVALID_MSG_POINTER
0x06
INVALID_EVENT_ID
0x07
INVALID_INTERRUPT_ID
0x08
NO_TIMER_AVAIL
0x09
NV_ITEM_UNINIT
0x0A
NV_OPER_FAILED
0x0B
INVALID_MEM_SIZE
0x0C
NV_BAD_ITEM_LEN
0x10
bleNotReady
0x11
bleAlreadyInRequestedMode
0x12
bleIncorrectMode
0x13
bleMemAllocError
0x14
bleNotConnected
0x15
bleNoResources
0x16
blePending
0x17
bleTimeout
0x18
bleInvalidRange
0x19
bleLinkEncrypted
0x1A
0x30
bleGAPUserCanceled
0x31
bleGAPConnNotAcceptable
0x32
bleGAPBondRejected
Page 151 of 152
0x40
bleInvalidPDU
0x41
bleInsufficientAuthen
0x42
bleInsufficientEncrypt
0x43
bleInsufficientKeySize
0xFF
INVALID_TASK_ID
Table 8: List of Possible Host Error Codes
Page 152 of 152


TI BLE Vendor Specific HCI Guide

Uploaded by

Copyright:

Available Formats

TI BLE Vendor Specific HCI Guide

Uploaded by

Document Information

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

TI BLE Vendor Specific HCI Guide

Uploaded by

Copyright:

Available Formats

TI BLE Vendor Specific

HCI Reference Guide

TI BLE HCI Vendor Specific HCI Guide

FUNCTIONAL OVERVIEW ......................................................................................................... 7

NUMERICAL NOTATION CONVENTIONS .............................................................................. 8

DEFINITIONS, ABBREVIATIONS, ACRONYMS...................................................................... 9

REVISION HISTORY .................................................................................................................. 10

HCI OVERVIEW ......................................................................................................................... 10

SPECIFICATION INTERFACE .................................................................................................. 10

VENDOR SPECIFIC INTERFACE ............................................................................................. 15

VENDOR SPECIFIC COMMANDS.................................................................................................. 15

HCI EXTENSION SET RECEIVER GAIN ........................................................................................ 25

TI BLE HCI Vendor Specific HCI Guide

HCI EXTENSION VENDOR SPECIFIC EVENTS ................................................................ 45

HCI EXTENSION PACKET ERROR RATE .................................................................................. 39

HCI EXTENSION SET RECEIVER GAIN ........................................................................................ 45

GAP VENDOR SPECIFIC COMMANDS ............................................................................... 58

GAP DEVICE INITIALIZATION ................................................................................................... 58

TI BLE HCI Vendor Specific HCI Guide

GAP VENDOR SPECIFIC EVENTS ....................................................................................... 91

UTIL VENDOR SPECIFIC COMMANDS............................................................................ 110

UTIL RESET COMMAND ......................................................................................................... 110

L2CAP_CONNPARAMUPDATEREQ (0XFC92) ......................................................................... 115

GAP DEVICE INIT DONE ........................................................................................................... 91

L2CAP_CMDREJCT (0X0481) ................................................................................................ 117

ATT VENDOR SPECIFIC COMMANDS ....................................................................................... 119

TI BLE HCI Vendor Specific HCI Guide

GATT VENDOR SPECIFIC COMMANDS .......................................................................... 135

ATT_READBYTYPERSP (COMMAND = 0XFD09, EVENT = 0X0509) ...................................... 125

GATT_EXCHANGEMTU (0XFD82) ........................................................................................ 135

GATT VENDOR SPECIFIC EVENTS .................................................................................. 149

TI BLE HCI Vendor Specific HCI Guide

TI BLE HCI Vendor Specific HCI Guide

Figure 1: Logical Organization of Application and BLE Stack

Figure 2: Single Device Configuration

TI BLE HCI Vendor Specific HCI Guide

Figure 3: Dual Device Configuration

Figure 4: Network Processor Configuration with HCI

3. Numerical Notation Conventions

Colon Separated Hexadecimal Notation

TI BLE HCI Vendor Specific HCI Guide

4. Definitions, Abbreviations, Acronyms

Bluetooth Low Energy

Event Opcode Event Field

Event Opcode Group Field

Generic Access Profile

Generic Attribute Profile

Host Controller Interface

Integrated Development Environment

Logical Link Control and Adaptation Protocol

Opcode Command Field

Opcode Group Field

Over The Air

Packet Error Rate

Parts Per Million

Sleep Clock Accuracy

TI BLE HCI Vendor Specific HCI Guide

BLE V1.1 RTM.

BLE V1.1b RTM.

BLE V1.2.1 RTM