PM0237 datasheet(69/88 Pages) STMICROELECTRONICS

69 / 88 page

DocID027104 Rev 2

69/88

PM0237

Design an application using BlueNRG, BlueNRG-MS ACI APIs

3.6.1

Service discovery procedures and related GATT events

Following is a list of the service discovery APIs with related description.

The following pseudocode example illustrates the aci_gatt_disc_all_prim_services()

API:

/* GAP Central starts a discovery all services procedure: conn_handle is the

connection handle returned on HCI_Event_CB() event callback,

EVT_LE_CONN_COMPLETE event */

if (aci_gatt_disc_all_prim_services(conn_handle) != BLE_STATUS_SUCCESS)

{

if (ret != BLE_STATUS_SUCCESS) PRINTF("Failure.\n")}

}

The responses of the procedure are given through the

EVT_BLUE_ATT_READ_BY_GROUP_RESP

event raised on HCI_Event_CB() callback

(EVT_VENDOR as main event) . The end of the procedure is indicated by

EVT_BLUE_GATT_PROCEDURE_COMPLETE

event on the HCI_Event_CB() callback

(EVT_VENDOR as main event):

void HCI_Event_CB(void *pckt)

{

hci_uart_pckt *hci_pckt = pckt;

hci_event_pckt *event_pckt = (hci_event_pckt*)hci_pckt->data;

if(hci_pckt->type != HCI_EVENT_PKT return;

switch(event_pckt->evt){

case EVT_VENDOR:

{

Table 43. ACI: service discovery procedures APIs

Discovery Service API

Description

aci_gatt_disc_all_prim_services()

This API starts the GATT client procedure to

discover all primary services on the GATT server.

It is used when a GATT client connects to a

device and it wants to find all the primary services

provided on the device to determine what it can

do.

aci_gatt_disc_ prim_services_by_service_uuid()

This API starts the GATT client procedure to

discover a primary service on the GATT server

by using its UUID. It is used when a GATT client

connects to a device and it wants to find a

specific service without the need to get any other

services.

aci_gatt_find_included_services()

This API starts the procedure to find all included

services. It is used when a GATT client wants to

discover secondary services once the primary

services have been discovered.

PM0237 数据表(PDF) 69 Page - STMicroelectronics

PM0237 数据表(HTML) 69 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

数据表下载