PM0237 datasheet(48/88 Pages) STMICROELECTRONICS

48 / 88 page

Design an application using BlueNRG, BlueNRG-MS ACI APIs

PM0237

48/88

DocID027104 Rev 2

3.2

BlueNRG, BlueNRG-MS events and events Callback

Whenever there is an ACI event to be processed, the ACI framework notifies this event to

the user application through the HCI_Event_CB() callback. The HCI_Event_CB() callback

is called within the HCI_Process() on file hci.c.

As a consequence, user application is requested to :

Define the void HCI_Event_CB(void *pckt) function within his main application

(pckt is a pointer to the received ACI packet)

Based on its own application scenario, the user has to identify the required device

events to be detected and handled and the application specific actions to be done as

consequence of such events.

When implementing a BLE application, the most common and widely used device events

are the ones related to the discovery, connection, terminate procedures, services and

characteristics discovery procedures, attribute modified events on a GATT server and

attribute notification/ indication events on a GATT client.

Table 33. ACI: main events, sub-events

Event/sub-event

Description

Main event

Where

EVT_DISCONN_COMPLETE

A connection is terminated

GAP

central/

peripheral

EVT_LE_CONN_COMPLETE

Indicates to both of the Hosts

forming the connection that a new

connection has been established

EVT_LE_META_

EVENT

GAP

central/

peripheral

EVT_BLUE_GATT_ATTRIBUTE_MODIFIED

Generated by the GATT server

when a client modifies any

attribute on the server, if event is

enabled.

EVT_VENDOR

GATT

server

EVT_BLUE_GATT_NOTIFICATION

Generated by the GATT client

when a server notifies any

attribute on the client

EVT_VENDOR

GATT

client

EVT_BLUE_GATT_INDICATION

Generated by the GATT client

when a server indicates any

attribute on the client

EVT_VENDOR

GATT

client

EVT_BLUE_GAP_PASS_KEY_REQUEST

Generated by the Security

manager to the application when a

passkey is required for pairing.

When this event is received, the

application has to respond with

the aci_gap_pass_key_response

() API

EVT_VENDOR

GAP

central/

peripheral

EVT_BLUE_GAP_PAIRING_CMPLT

Generated when the pairing

process has completed

successfully or a pairing

procedure timeout has occurred

or the pairing has failed

EVT_VENDOR

GAP

central/

peripheral

PM0237 데이터시트(PDF) 48 Page - STMicroelectronics

PM0237 데이터시트(HTML) 48 Page - STMicroelectronics

Html Pages

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88

데이터시트 다운로드

링크 URL