TELINK SEMICONDUCTOR TLSR8232 - HCI Event

Telink TLSR8232 BLE SDK Developer Handbook
AN-19112700-E1 59 Ver.1.0.0
#define HCI_FLAG_EVENT_BT_STD (1<<25)
“HCI_FLAG_EVENT_TLK_MODULE” will be introduced in “Telink defined event”, while
“HCI_FLAG_EVENT_BT_STD” indicates the current event is Controller HCI event.
In the callback function prototype, “para” and “n” indicate data and data length of event.
The data is consistent with the definition in BLE Spec. Users can refer to usage in 5316
module as well as the implementation of “controller_event_handler” function.
blc_hci_registerControllerEventHandler(controller_event_handler);
3.2.6.1 HCI Event
T5316 BLE SDK supports a few HCI events. The following lists some events users
would like to know.
#define HCI_EVT_DISCONNECTION_COMPLETE 0x05
#define HCI_EVT_ENCRYPTION_CHANGE 0x08
#define HCI_EVT_READ_REMOTE_VER_INFO_COMPLETE 0x0C
#define HCI_EVT_ENCRYPTION_KEY_REFRESH 0x30
#define HCI_EVT_LE_META 0x3E
1) HCI_EVT_DISCONNECTION_COMPLETE
Please refer to Core_v5.0 (Vol 2/Part E/7.7.5 “Disconnection Complete Event”).
Total data length of this event is 7, and 1-byte “param len” is 4, as shown below.
Please refer to BLE Spec for data definition.
hci
event
0x04
event
code
0x05
param
len
status
connection
handle
reason
4
0x00
Figure 3-14 Disconnection Complete Event
2) HCI_EVT_ENCRYPTION_CHANGE and CI_EVT_ENCRYPTION_KEY_REFRESH
Please refer to Core_v5.0 (Vol 2/Part E/7.7.8 & 7.7.39).
The two events are related to Controller encryption, and the processing is
assembled in library.
3) HCI_EVT_READ_REMOTE_VER_INFO_COMPLETE
Please refer to Core_v5.0 (Vol 2/Part E/7.7.12).
When Host uses “HCI_CMD_READ_REMOTE_VER_INFO” command to exchange
version information between Controller and BLE peer device, and version of peer
device is received, this event will be reported to Host.
Total data length of this event is 11, and 1-byte “param len” is 8, as shown below.
Please refer to BLE Spec for data definition.
hci
event
0x04
event
code
0x0c
param
len
status
connection
handle
version
0x00
manufacture
name
subversion
8
Figure 3-15 Read Remote Version Information Complete Event