UM1870 datasheet(32/58 Pages) STMICROELECTRONICS

32 / 58 page

Programming with BlueNRG-MS network processor

UM1870

32/58

DocID027602 Rev 1

Programming with BlueNRG-MS network processor

The BlueNRG-MS provides a high level interface to control its operation. This interface is

called ACI (application-controller interface). The ACI is implemented as an extension to the

standard Bluetooth HCI interface. Since BlueNRG-MS is a network processor, the stack

runs inside the device itself. Hence, no library is required on the external microcontroller,

except for profiles and all the functions needed to communicate with the BlueNRG-MS SPI

interface.

The development kit software includes sample code that shows how to configure BlueNRG-

MS and send commands or parsing events. The source library is called simple BlueNRG-

MS HCI to distinguish it from the library for the complete profile framework (not present in

the software development kit). This library is able to handle multiple profiles at the same

time and supports several Bluetooth GATT-based profiles for BlueNRG-MS. Documentation

on the ACI is provided in a separate document.

Figure 12. Profile framework structure

4.1

Requirements

In order to communicate with BlueNRG-MS network processor very few resources are

needed by the main processor. These are listed below:

–

SPI interface

–

Platform-dependent code to write/read to/from SPI

–

A timer to handle SPI timeouts or to run Bluetooth LE Profiles

Minimum requirements in terms of Flash and RAM space largely depend on the functionality

needed by the application, on the microprocessor that will run the code and on the compiler

toolchain used to build the firmware.

4.2

Software directory structure

The Project folder contains some sample code that can be used on the application

processor to control the BlueNRG-MS. Platform-dependent code is also provided for

STM32L1 platforms. The example project provided in the package will run “as is” on the

development kit.

The files are organized using the following folder structure:

–

Bluetooth LE. Contains the code that is used to send ACI commands to the

BlueNRG-MS network processor. It contains also definitions of BlueNRG-MS

events.

–

platform. Contains all the platform-dependent files. These can be taken as an

example to build applications that can be run on other platforms.

–

Project. Contains source code that can be used as an example to build other

applications that will use the Bluetooth technology with the BlueNRG-MS. Project

files for IAR embedded workbench are also available.

Proximity

FindMe

HOGP

...

Basic profile framework

UM1870 Datasheet(PDF) 32 Page - STMicroelectronics

UM1870 Datasheet(HTML) 32 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

Datasheet Descarga

Enlace URL