PM0237 datasheet(41/88 Pages) STMICROELECTRONICS

41 / 88 page

DocID027104 Rev 2

41/88

PM0237

Design an application using BlueNRG, BlueNRG-MS ACI APIs

Design an application using BlueNRG, BlueNRG-MS

ACI APIs

This section provides information and code examples about how to design and implement a

Bluetooth low energy application on the selected microcontroller.

User implementing a BLE host application on the selected MCU has to go through some

basic and common steps:

Initialization phase and main application Loop

BlueNRG, BlueNRG-MS events and events Callback setup

Services and characteristic configuration (on GATT server)

Create a connection: discoverable, connectable modes & procedures.

Security (pairing & bonding)

Service and characteristic discovery

Characteristic notification/indications, write, read

Basic/typical error conditions description

The STM32L1xx microcontroller is the reference external microcontroller used for the

programming guidelines described on the following sections, since the available BlueNRG,

BlueNRG-MS kits platforms are based on such microcontroller.

Note:

On the following sections, some user application “Defines” are used to simply identify the

devices Bluetooth low energy role (central, peripheral, client and server).

Further on each provided pseudo codes any reference to BlueNRG device is also valid for

the BlueNRG-MS device. Any specific difference is highlighted whenever it is needed by

using #ifdef BLUENRG_MS.

Table 31. User application defines for BLE devices role

Define

Description

GAP_CENTRAL

GAP central role

GAP_PERIPHERAL

GAP peripheral role

GATT_CLIENT

GATT client role

GATT_SERVER

GATT server role

PM0237 Datenblatt(PDF) 41 Page - STMicroelectronics