ST UM1870 User manual

May 2015 DocID027602 Rev 1 1/58
58
UM1870
User manual
BlueNRG-MS development kits
Introduction
This document describes the BlueNRG-MS development kits and related hardware and
software components. The BlueNRG-MS is a very low power Bluetooth
®
low energy (BLE)
single-mode network processor, compliant with Bluetooth specifications core 4.1. The
BlueNRG-MS can support multiple roles simultaneously.
The following BlueNRG-MS kits are available:
1. BlueNRG-MS development platform (order code: STEVAL-IDB005V1)
The BlueNRG-MS software package includes a graphical user interface application to
control the BlueNRG-MS through a simple ACI protocol.
www.st.com

Contents UM1870
2/58 DocID027602 Rev 1
Contents
1 Getting started . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1.1 STEVAL-IDB005V1 kit contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1.2 System requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1.3 BlueNRG-MS development kit setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
2 Hardware description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
2.1 STEVAL-IDB005V1 motherboard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
2.1.1 Microcontroller and connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
2.1.2 Power . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
2.1.3 Sensors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
2.1.4 Extension connector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
2.1.5 Push-buttons and joystick . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
2.1.6 JTAG connector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
2.1.7 LEDs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
2.1.8 Daughterboard interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
2.2 BlueNRG-MS daughterboard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
2.2.1 Current measurements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
2.2.2 Hardware setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
2.2.3 STM32L preprogrammed application . . . . . . . . . . . . . . . . . . . . . . . . . . 13
3 GUI software description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
3.1 Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
3.2 The BlueNRG-MS graphical user interface . . . . . . . . . . . . . . . . . . . . . . . 14
3.2.1 GUI main window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
3.2.2 Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
3.2.3 GUI scripts window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
3.2.4 GUI Beacon window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
4 Programming with BlueNRG-MS network processor . . . . . . . . . . . . . 32
4.1 Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
4.2 Software directory structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
5 BlueNRG-MS sensor profile demo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
5.1 Supported platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

DocID027602 Rev 1 3/58
UM1870 Contents
58
5.2 BlueNRG-MS app for smartphones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
5.3 BlueNRG-MS sensor profile demo: connection with a central device . . . 35
5.3.1 Initialization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
5.3.2 Add service and characteristics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
5.3.3 Set security requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
5.3.4 Enter connectable mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
5.3.5 Connection with central device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
5.4 BlueNRG-MS sensor demo: central profile role . . . . . . . . . . . . . . . . . . . . 37
5.4.1 Initialization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
5.4.2 Discovery a sensor peripheral device . . . . . . . . . . . . . . . . . . . . . . . . . . 38
5.4.3 Connect to discovered sensor peripheral device . . . . . . . . . . . . . . . . . . 38
5.4.4 Discovery sensor peripheral services and characteristics . . . . . . . . . . . 38
5.4.5 Enable sensor peripheral acceleration and free fall notifications . . . . . . 39
5.4.6 Read the sensor peripheral temperature sensor characteristic . . . . . . . 39
6 BlueNRG-MS chat demo application . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
6.1 Supported platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
6.2 BlueNRG-MS chat demo application: peripheral & central devices . . . . . 40
6.2.1 Initialization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
6.2.2 Add service and characteristics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
6.2.3 Set security requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
6.2.4 Enter connectable mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
6.2.5 Connection with central device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
7 BlueNRG-MS Beacon demonstration application . . . . . . . . . . . . . . . . 44
7.1 Supported platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
7.2 BLE Beacon application setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
7.2.1 Initialization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
7.2.2 Define advertising data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
7.2.3 Entering non-connectable mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
8 BLE remote control demo application . . . . . . . . . . . . . . . . . . . . . . . . . 46
8.1 Supported platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
8.2 BLE remote control application setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
8.2.1 Initialization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
8.2.2 Define advertising data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
8.2.3 Add service and characteristics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

Contents UM1870
4/58 DocID027602 Rev 1
8.2.4 Connection with a BLE Central device . . . . . . . . . . . . . . . . . . . . . . . . . 48
9 List of acronyms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
10 Available board schematics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
11 Revision history . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

DocID027602 Rev 1 5/58
UM1870 Getting started
58
1 Getting started
This section describes all the software and hardware requirements for running the
BlueNRG-MS GUI utility as well as the related installation procedure.
1.1 STEVAL-IDB005V1 kit contents
This kit is composed of the following items:
•1 development motherboard
•1 BlueNRG-MS daughterboard
•1 2.4 GHz Bluetooth antenna
•1 USB cable
Figure 1. BlueNRG-MS kit motherboard with the STEVAL-IDB005V1 daughterboard
connected
1.2 System requirements
The BlueNRG-MS graphical user interface utility has the following minimum requirements:
•PC with Intel
®
or AMD
®
processor running one of the following Microsoft
®
operating
systems:
– Windows XP SP3
– Windows Vista
– Windows 7
•At least 128 Mb of RAM
•2 USB ports
•40 Mb of hard disk space available
•Adobe Acrobat Reader 6.0 or later.

Getting started UM1870
6/58 DocID027602 Rev 1
1.3 BlueNRG-MS development kit setup
•Extract the content of the BlueNRG_DK_-x.x.x-Setup.zip file into a temporary directory.
•Launch the BlueNRG-DK-x.x.x-Setup.exe file and follow the on-screen instructions.
Note: EWARM Compiler 6.60 version is required for building the BlueNRG_DK_x.x.x
demonstration applications.
BlueNRG DK software package supports both BlueNRG and BlueNRG-MS devices.

DocID027602 Rev 1 7/58
UM1870 Hardware description
58
2 Hardware description
The following sections describe the components of the kits.
2.1 STEVAL-IDB005V1 motherboard
The motherboard included in the development kit allows testing of the functionality of the
BlueNRG-MS processor. The board can be used as a simple interface between the
BlueNRG-MS and a GUI application on the PC. The STM32L microcontroller on the board
can also be programmed, so the board can be used to develop applications using the
BlueNRG-MS. A connector on the motherboard (Figure 1) allows access to the JTAG
interface for programming and debugging. The board can be powered through a mini-USB
connector that can also be used for I/O interaction with a USB Host. The board includes
sensors, and buttons and a joystick for user interaction. The RF daughterboard can be
easily connected through a dedicated interface.
This is a list of some of the features that are available on the boards:
•STM32L151RBT6 64-pin microcontroller
•Mini USB connector for power supply and I/O
•JTAG connector
•RF daughterboard interface
•One RESET button and one USER button
•One LIS3DH accelerometer
•One STLM75 temperature sensor
•One joystick
•5 LEDs
•One PWR LED
•One battery holder for 2 AAA batteries
•One row of test points on the interface to the RF daughterboard
Figure 2. Motherboard for the BlueNRG-MS development kit

Hardware description UM1870
8/58 DocID027602 Rev 1
2.1.1 Microcontroller and connections
The board features an STM32L151RB microcontroller, which is an ultra low-power
microcontroller with 128 KB of Flash memory, 16 KB of RAM, 32-bit core ARM cortex-M3, 4
KB of data EEPROM, RTC, LCD, timers, USART, I
2
C, SPI, ADC, DAC and comparators.
The microcontroller is connected to various components such as buttons, LEDs and
connectors for external circuitry. The following table shows what functionality is available on
each microcontroller pin.
Table 1. MCU pin description versus board function
Pin
name Pin
Board function
LEDs DB connector Buttons /
joystick Acceler. Temp. sensor USB JTAG Ext. conn
VLCD 1
PC13 2 DB_SDN_RST
PC14 3 3
PC15 4 5
OSC_IN 5
OSC_O
UT 6
NRST 7 RESET 7
PC0 8 LED1
PC1 9 LED2
PC2 10 DB_PIN3
PC3 11 9
VSSA 12
VDDA 13
PA0 14 11
PA1 15 13
PA2 16 15
PA3 17 17
VSS_4 18
VDD_4 19
PA4 20 SPI1_NSS
PA5 21 SPI1_SCK
PA6 22 SPI1_MISO
PA7 23 SPI1_MOSI
PC4 24 LED4
PC5 25 LED5
PB0 26 JOY_DOWN

DocID027602 Rev 1 9/58
UM1870 Hardware description
58
PB1 27 JOY_RIGHT
PB2 28 18
PB10 29 INT1
PB11 30 INT2
VSS_1 31
VDD_1 32
PB12 33 DB_CSN
(1)
PB13 34 DB_SCLK
(1)
PB14 35 DB_SDO
(1)
PB15 36 DB_SDI
(1)
PC6 37 PUSH_BTN
PC7 38 DB_IO0
(1)
PC8 39 DB_IO1
(1)
PC9 40 DB_IO2
(1)
PA8 41 JOY_LEFT
PA9 42 JOY_CENTER
PA10 43 JOY_UP
PA11 44 USB_DM
PA12 45 USB_DP
PA13 46 JTMS 16
VSS_2 47
VDD_2 48
PA14 49 JTCK 14
PA15 50 JTDI 12
PC10 51 DB_IO3_IRQ
(1)
PC11 52 DB_PIN1
PC12 53 DB_PIN2
PD2 54 LED3
PB3 55 JTDO 10
PB4 56 JNTRST 8
PB5 57 TSEN_INT
PB6 58 I2C1_SCL
PB7 59 I2C1_SDA
Table 1. MCU pin description versus board function (continued)
Pin
name Pin
Board function
LEDs DB connector Buttons /
joystick Acceler. Temp. sensor USB JTAG Ext. conn

Hardware description UM1870
10/58 DocID027602 Rev 1
2.1.2 Power
The board can be powered either by the mini USB connector CN1 (A in Figure 2) or by 2
AAA batteries. To power the board through USB bus, jumper JP1 must be in position 1-2, as
in Figure 2 (B). To power the board using batteries, 2 AAA batteries must be inserted in the
battery holder at the rear of the board, and jumper JP1 set to position 2-3.
When the board is powered, the green LED DL6 is on (C).
If needed, the board can be powered by an external DC power supply. Connect the positive
output of the power supply to the central pin of JP1 (pin 2) and ground to one of the four test
point connectors on the motherboard (TP1, TP2, TP3 and TP4).
2.1.3 Sensors
Two sensors are available on the motherboard:
– LIS3DH, an ultra-low power high performance three-axis linear accelerometer (D
in Figure 2). The sensor is connected to the STM32L through the SPI interface.
Two lines for interrupts are also connected.
– STLM75, a high precision digital CMOS temperature sensor, with I²C interface (E
in Figure 2). The pin for the alarm function is connected to one of the STM32L
GPIOs.
2.1.4 Extension connector
There is the possibility to solder a connector on the motherboard to extend its functionality
(F in Figure 2). 16 pins of the microcontroller are connected to this expansion slot (Table 1).
2.1.5 Push-buttons and joystick
For user interaction the board has two buttons. One is to reset the microcontroller, while the
other is available to the application. There is also a digital joystick with 4 possible positions
(left, right, up, down) (G in Figure 2).
2.1.6 JTAG connector
A JTAG connector on the board (H in Figure 2) allows the programming and debugging of
the STM32L microcontroller on board
(a)
, using an in-circuit debugger and programmer such
as the ST-LINK/V2.
BOOT0 60
PB8 61 4
PB9 62 6
VSS_3 63
VDD_3 64
1. These lines are also available on the test point row
Table 1. MCU pin description versus board function (continued)
Pin
name Pin
Board function
LEDs DB connector Buttons /
joystick Acceler. Temp. sensor USB JTAG Ext. conn

DocID027602 Rev 1 11/58
UM1870 Hardware description
58
2.1.7 LEDs
Five LEDs are available (I in Figure 2).
– DL1: green
– DL2: orange
– DL3: red
– DL4: blue
– DL5: yellow
2.1.8 Daughterboard interface
The main feature of the motherboard is the capability to control an external board,
connected to the J4 and J5 connectors (L in Figure 2). Table 1 shows which pins of the
microcontroller are connected to the daughterboard.
Some of the lines are connected also to a row of test points (M).
a. The STM32L is preprogrammed with a DFU firmware that allows the downloading of a firmware image without
the use of a programmer. If an user accidentally erases DFU firmware, he can reprogram it through STLink
using the hex image DFU_Bootloader.hex available on BlueNRG-MS DK SW package, firmware folder.

Hardware description UM1870
12/58 DocID027602 Rev 1
2.2 BlueNRG-MS daughterboard
The BlueNRG-MS daughterboard (Figure 3) included in the development kit is a small
circuit board to be connected to the main board. It contains the BlueNRG-MS network
processor (in a QFN32 package), an SMA antenna connector, discrete passive components
for RF matching and balun, and small number of additional components required by the
BlueNRG-MS for proper operation (see the schematic diagram in Figure 18).
Figure 3. BlueNRG-MS daughterboard
The main features of the BlueNRG-MS daughterboard are:
– BlueNRG-MS low power network processor for Bluetooth low energy (BLE), with
embedded host stack
– High frequency 16 MHz crystal
– Low frequency 32 kHz crystal for the lowest power consumption
– Integrated balun and harmonic filter
– SMA connector
The daughterboard is also equipped with a discrete inductor for the integrated high-
efficiency DC-DC converter, for best-in-class power consumption. It is still possible to
disable the DC-DC converter. In this case the following changes must be performed on the
daughterboard (see Figure 18):
– Remove inductor from solder pads 1 and 2 of D1
– Place a 0 ohm resistor between pads 1 and 3
– Move resistor on R2 to R1
For proper operation, jumpers must be set as indicated in Figure 3.
The following tables show the connections between the daughterboard and the main board.

DocID027602 Rev 1 13/58
UM1870 Hardware description
58
2.2.1 Current measurements
To monitor power consumption of the entire BlueNRG-MS daughterboard, remove the
jumper from U2 and insert an ammeter between pins 1 and 2 of the connector. Since power
consumption of the BlueNRG-MS during most operation time is very low, an accurate
instrument in the range of few microamps may be required.
2.2.2 Hardware setup
1. Plug the BlueNRG-MS daughterboard into J4 and J5 connectors as in Figure 1.
2. Ensure the jumper configuration on the daughterboard is as in Figure 1
3. Connect the motherboard to the PC with an USB cable (through connector CN1).
4. Verify the PWR LED lights is on.
2.2.3 STM32L preprogrammed application
The STM32L on STEVAL-IDB005V1 motherboard is preprogrammed with the sensor demo
application when the kits components are assembled (refer to Section 5 for the application
description).
Table 2. Connections between BlueNRG-MS board and motherboard on left connector
Pin J4 motherboard J3 daughterboard
1 DB_PIN1 NC
2 3V3 3V3
3 DB_PIN3 NC
4 NC NC
5 GND GND
6 DB_PIN2 nS
7 GND GND
8 3V3 U2 pin 1
9 DB_SDN_RST RST
10 3V3 U2 pin 1
Table 3. Connections between BlueNRG-MS board and motherboard on right
connector
Pin J5 motherboard J4 daughterboard
1 GND GND
2 GND GND
3 DB_CSN CSN
4 DB_IO3_IRQ IRQ
5 DB_SCLK CLK
6 DB_IO2 NC
7 DB_SDI MOSI
8 DB_IO1 NC
9 DB_SDO MISO
10 DB_IO0 NC

GUI software description UM1870
14/58 DocID027602 Rev 1
3 GUI software description
The BlueNRG-MS GUI included in the software package is a graphical user interface that
can be used to interact and evaluate the capabilities of the BlueNRG-MS network
processor.
This utility can send standard and vendor-specific HCI commands to the controller and
receive events from it. It lets the user configure each field of the HCI command packets to
be sent and analyzes all received packets. In this way BlueNRG-MS can be easily managed
at low level.
3.1 Requirements
In order to use the BlueNRG-MS GUI, make sure you have correctly set up your hardware
and software (BlueNRG-MS GUI installed). The STM32L in the STEVAL-IDB005V1 kit has
been preprogrammed with a demo application (see Section 5). Hence, new firmware must
be loaded into the STM32L. Firmware images can be found within the firmware folder. The
firmware image that must be programmed is latest BlueNRG_VCOM_x_x.hex available
within the BlueNRG DK SW package. The GUI has the ability to Flash new firmware.
In order to download binary images into the internal Flash of the STM32L, the
microcontroller must be put into a special DFU (device firmware upgrade) mode. To enter
DFU mode:
1. BlueNRG-MS development platform (STEVAL-IDB005V1)
– Power up the board
– Press and hold USER button
– Reset the board using RESET button (keep USER button pressed while resetting)
The orange LED DL2 will start to blink
– Release USER button
– Use BlueNRG-MS GUI to Flash the device with new firmware (Tools -> Flash
motherboard FW).
3.2 The BlueNRG-MS graphical user interface
This section describes the main functions of BlueNRG-MS GUI application.
You can run this utility by clicking on the BlueNRG-MS GUI icon on the Desktop or under:
Start → STMicroelectronics → BlueNRG DK X.X.X → BlueNRG-MS GUI

DocID027602 Rev 1 15/58
UM1870 GUI software description
58
3.2.1 GUI main window
Figure 4. BlueNRG-MS GUI main window
The BlueNRG-MS GUI main window is characterized by different zones. Some of these
zones can be resized.
Port and interface selection
The uppermost zone allows the user to open the COM port associated to the BLE controller.
When a COM port is opened the following information are displayed:
– BlueNRG-MS HW version
– BlueNRG-MS FW version
– STM32L motherboard GUI firmware (VCOM) version
HCI commands
The HCI Commands tab contains a list of all the available HCI commands. Commands can
be filtered by checking/unchecking boxes under the filter section. After clicking on one of the
commands, all the packet fields will be displayed on the command packet table in the upper-
right section of the tab (see Figure 5).

GUI software description UM1870
16/58 DocID027602 Rev 1
Figure 5. Command packet table
The command packet table contains four columns:
•Parameter: name of the packet field as they are named in volume 2, part E of
Bluetooth specification.
•Value: field value represented in hexadecimal format (right-click on a cell to change its
representation format).
•Literal: meaning of the current field value.
•Info: description of the corresponding field.
Only the yellow cells of this table can be modified by the user. The Parameter Total Length is
fixed or automatically calculated after modifying cell content.
After the fields have been modified (if required) the command can be sent using the Send
button.
HCI Packet history and details
At the bottom of the main window, two tables show packets sent to and received from the
BLE controller, as well as other events. The left table (sent/received packets) holds a history
of all packets (see Figure 6). The right one (packet details) shows all the details of the
selected packet as is done in the command packet table (Figure 6).
Figure 6. Packet history and details
Double-clicking on a row of the sent/received packets table shows the raw packet.

DocID027602 Rev 1 17/58
UM1870 GUI software description
58
Figure 7. Raw packet dump
Some events (displayed in yellow cells) can provide other information. HCI packets sent
towards the BLE controller are displayed in gray cells while received packets are shown
inside white cells.
The Sent/received packets table can be cleared by clicking on clear list button. Update and
auto-scrolling check boxes enable or disable updating and auto-scrolling of the
Sent/received packets table while new packets are sent or received (however, information
will still be printed).
3.2.2 Tools
The BlueNRG-MS GUI has some functions that can be accessed through the tools menu.
These tools are described in this section.
BlueNRG-MS updater
This tool can be used to update the firmware inside the BlueNRG-MS by using its internal
bootloader. VCOM firmware must be present on the STM32L and COM port must be open,
in order to use this function.
1. Go to Tools -> BlueNGR updater
2. Select the correct stack firmware (.img)
3. Press update to start the update procedure. If the procedure completes with no errors,
the new firmware has been loaded into the BlueNRG-MS internal Flash.
BlueNRG-MS IFR
To preserve BlueNRG-MS's flexibility, its firmware uses a table of configurable parameters.
This table resides in a sector of the Flash called Information Register (IFR). The BlueNRG-
MS IFR tool can read and modify this portion of BlueNRG-MS's Flash. This tool is available
in BlueNRG-MS GUI, Tools, BlueNRG IFR... item.
The BlueNRG-MS GUI IFR utility is a tool that allow the customer to define the IFR data in a
controller way. Using this utility is the only supported mode to define IFR data based on
customer needs. The utility provides the following windows:
•View/Edit view: displays the IFR regions with related fields and description. The user can
modify some of these fields according to his needs.
•Memory view: displays the IFR field memory addresses and related values that are
generated by BlueNRG-MS GUI according to the specified values.

GUI software description UM1870
18/58 DocID027602 Rev 1
•C view: displays the C language structure related to the IFR configuration data region
matching the View/Edit and Memory view.
Figure 8. BlueNRG GUI IFR tool: View/Edit view
In the View/Edit view, the following operations are available:
•Select the high speed (HS) crystal (16 or 32 MHz) and the low speed oscillator source (32
kHz or the internal ring oscillator)
•Set the Power Management options (SMPS inductor or SMPS off configuration)
•Change stack mode. Each mode has a different functionality:
– Mode 1: slave/master, 1 connection only, small GATT database (RAM2 off during
sleep)
– Mode 2: slave/master, 1 connection only, large GATT database (RAM2 on during
sleep)
– Mode 3: slave/master, 8 connections, small GATT database (RAM2 on during sleep)

DocID027602 Rev 1 19/58
UM1870 GUI software description
58
•Change HS startup time parameter. This parameter control the time offset between the
wakeup of the device and the start of RX/TX phase. It must be big enough to allow the
device to be ready to transmit or receive after wakeup from sleep. This time depends on
the startup time of the high speed crystal.
•Change sleep clock accuracy. This must reflect the actual clock accuracy, depending on
the low speed oscillator or crystal in use.
•Set low speed (LS) crystal period and frequency
•View/change date to distinguish between different versions of configurations.
•View registers that are written into the radio (hot and cold table)
•Set some test modes for specific tests
•Read IFR content from BlueNRG-MS.
•Write IFR configuration to BlueNRG-MS IFR.
The following general utilities are also available:
•Load button: allows to load a configuration file.
•Save button: allows to save the current parameters into a configuration file.
Flash motherboard firmware
The BlueNRG-MS GUI embeds a utility that allows to Flash firmware to the STM32L
microcontroller on the motherboard without a JTAG/SWD programmer. This utility uses a
bootloader that has been programmed in the first 12 KB of the Flash. Any application to be
programmed to the STM32L by this tool must first consider that the lower area of the Flash
is used by the bootloader
(b)
.
OTA bootloader
OTA bootloader is a tool that allows to Flash new firmware to the STM32L of a remote
device via Bluetooth low energy technology. Refer to the dedicated application note for
more information.
Get production data
From the tools menu it is possible to retrieve production information from the BlueNRG-MS
daughterboard. This data is stored in the EEPROM on the daughterboard.
Get version
The Get version tool is used to retrieve the version of the BlueNRG-MS GUI firmware
(VCOM) on the STM23L, and hardware and firmware version from the BlueNRG-MS.
Settings
This tool allows to configure the firmware stack version to be used from the GUI (when no
device is actually connected to a PC USB port). Further, it allows to configure the GUI serial
baud rate (valid only for communication over serial UART and not through USB Virtual
COM).
In order to use this function.
b. Two precautions must be taken for any firmware: 1) change memory regions in linker script (vector table and
Flash must start at 0x08003000); 2) Change the vector table offset (NVIC_SetVectorTable())

GUI software description UM1870
20/58 DocID027602 Rev 1
1. Go to Settings --> select FW 7.1 for BlueNRG-MS device
2. Go to Settings --> select Set Baud Rate… and choose the value (default is 9600)
3.2.3 GUI scripts window
The BlueNRG-MS GUI scripts window provides several tabs to allow testing of some
BlueNRG-MS application scenarios.
Figure 9. BlueNRG GUI scripts window
Central and Peripheral roles are supported with the BLE operations described in Table 4,
Table 5 and Table 6.