PM0237 datasheet(73/88 Pages) STMICROELECTRONICS

73 / 88 page

DocID027104 Rev 2

73/88

PM0237

Design an application using BlueNRG, BlueNRG-MS ACI APIs

3.6.2

Characteristics discovery procedures and related GATT events

Following is a list of the characteristic discovery APIs with associated description.

In the context of the BlueNRG sensor profile demo, follow a simple pseudocode illustrating

how a GAP Central application can discover all the characteristics of the Acceleration

service (refer to Section Table 45.: Second evt_att_read_by_group_resp event data):

uint16_t service_handle;

uint16_t end_group_handle;

#ifdef BLUENRG_MS

service_handle = 0x000C;

end_group_handle = 0x0012;

#else /*

service_handle_value

= 0x0010;

charac_handle_value = 0x0016;

#endif

/* BlueNRG GAP Central starts a discovery all the characteristics of a

service procedure: conn_handle is the connection handle returned on

HCI_Event_CB() event callback, EVT_LE_CONN_COMPLETE event */

if (aci_gatt_disc_all_charac_of_serv(conn_handle,

service_handle,/*

Service handle */

end_group_handle/*

End group 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_TYPE_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)

Table 47. BlueNRG ACI: characteristics discovery procedures APIs

Discovery service API

Description

aci_gatt_disc_all_charac_of_serv()

This API starts the GATT procedure to discover

all the characteristics of a given service.

aci_gatt_discovery_characteristic_by_uuid()

This API starts the GATT the procedure to

discover all the characteristics specified by a

UUID.

aci_gatt_disc_all_charac_descriptors()

This API starts the procedure to discover all

characteristic descriptors on the GATT server.

PM0237 数据表(PDF) 73 Page - STMicroelectronics

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

数据表下载