| BlueNRG GUI SW package (STSW-BNRGUI)

Release Notes V2.2.2 / 02-December-2016

# New Features

- Added support for NUCLEO-L152RE + BlueNRG-1, STEVAL-IDB007V1 platform configured as DTM network coprocessor (SPI mode):
  - Nucleo-L152RE platform must be loaded with STM32L_Nucleo_DTM_SPI.hex binary file available on \Firmware\BlueNRG1\Nucleo_L152RE.
  - BlueNRG-1, STEVAL-IDB007V1 platform must be loaded with DTM_SPI.hex binary file available on Firmware\BlueNRG1\DTM.
- Added new information on Service Management... tab:
  - Number of records required for the defined attribute database (useful for defining NUM_APP_GATT_ATTRIBUTES value on BlueNRG-1 BLE applications)
  - Size of the storage area for Attribute values (useful for defining ATT_VALUE_ARRAY_SIZE value on BlueNRG-1 BLE applications)
- Updated BlueNRG-1 DTM application version to v1.7.
- NOTES:
  - Before using a BlueNRG-1, STEVAL-IDB007V1 platform, upgrade the USB to Serial DFU fw to the latest available version (v1.6).
    - Refer to BlueNRG GUI SW package (STSW-BNRGUI) User Manual UM2058, Section: BlueNRG-1 network coprocessor.
  - Before using a BlueNRG-1, STEVAL-IDB007V1 platform as network coprocessor (UART or SPI), upgrade the DTM application to the latest available version (v1.7):
    - UART mode: Firmware\BlueNRG1\DTM\DTM_UART_16MHz.hex binary file.
    - SPI mode: Firmware\BlueNRG1\DTM\DTM_SPI.hex binary file.
  - Refer to BlueNRG GUI SW package (STSW-BNRGUI) User Manual UM2058, Section: Tools, Flash motherboard firmware.
  - BlueNRG-1 DTM UART HS crystal (16 or 32MHz) is selected at compile time and it cannot be changed through BlueNRG GUI IFR.
  - BlueNRG-MS FW stack v7.2c features are aligned to BlueNRG-1 BLE stack v1.0a features.

## BlueNRG GUI

- BlueNRG GUI PC application V2.2.2 supports BlueNRG-1, BlueNRG-MS and BlueNRG Bluetooth Low Energy devices.

## BlueNRG Script Launcher Utility

- BlueNRG script launcher PC utility V2.2.2 supports BlueNRG-1, BlueNRG-MS and BlueNRG Bluetooth Low Energy devices.

## Supported BLE devices and BLE stacks versions

- BlueNRG-1 FW v1.x
- BlueNRG-MS FW v7.2x
- BlueNRG FW v6.4x

## Supported serial baud rates

| Baud Rate | Notes
--- | --- | ---
BlueNRG-1 development platform | 115200 | UART serial channel
BlueNRG, BlueNRG-MS STEVAL-IDB00XV1 platforms | Not Applicable | USB virtual COM channel
NUCLEO-L152RE platform + BlueNRG, BlueNRG-MS Nucleo board | 115200 | Nucleo UART serial channel
NUCLEO-L152RE platform + BlueNRG-1 STEVAL-IDB007V1 configured as DTM network coprocessor (SPI mode) | 115200 | Nucleo UART serial channel

- The serial baud rate can be set as follow:
  1. BlueNRG GUI PC application: Menu Setting, Set Baud Rate ... option
  2. BlueNRG Script Launcher PC utility: use -b option

# Solved Issues, Changes

- ID 2384: DTM no boot image: pages of Flash are not erased depending on current DTM image and this could cause errors.
- ID 2438: TX/RX event alert activation not supported on BlueNRG-1 DTM application v1.6
- ID 2540: DTM application v1.6: DTM_StackInit() function to be updated for aligning to HS startup time max value
- Improved device selection algorithm on OTA bootloader utility (used internal optimized macro as OTA_Central.py script)
- Internal code review and improvements for BlueNRG GUI and script launcher.

# BlueNRG GUI SW Package Contents

- BlueNRG GUI V2.2.2 PC application
- BlueNRG Script Launcher V2.2.2 PC utility
- BlueNRG, BlueNRG-MS GUI scripts:
  - BLE Beacon script example
  - Multiple Connection scripts example
  - Simultaneously Master/Slave scripts examples
  - OTA BLE FW upgrade client script example
  - Security scripts examples
  - BlueNRG, BlueNRG-MS FW stacks upgrade script examples
- BlueNRG, BlueNRG-MS stacks images
- BlueNRG_VCOM_x.x STM32L prebuilt images for BlueNRG and BlueNRG-MS devices
- Nucleo L152RE prebuilt binary images for BlueNRG, BlueNRG-MS configurations
- BlueNRG-1 DTM binary files for configuring a BlueNRG-1 device as a network coprocessor
- BlueNRG-1 STEVAL-IDB007V1 USB to serial binary file
- Drivers for PC (DFU & USB Virtual COM)
- BlueNRG ACIs and events html documentation
- BlueNRG-MS ACIs and events html documentation
- BlueNRG-1 ACIs and events html documentation
- Nucleo L152RE prebuilt binary image for BlueNRG-1 network coprocessor configuration
- Nucleo L152RE -STEVAL_IDB007V1 platform HW/SW setup steps doxygen documentation
- Web link to BlueNRG GUI SW package (STSW-BNRGUI) databrief
- Web link to BlueNRG GUI SW package (STSW-BNRGUI) User Manual (UM2058).

# Supported platforms

- BlueNRG-1 development platform (order code: STEVAL-IDB007V1)
- BlueNRG-MS development platform (order code: STEVAL-IDB005V1)
- BlueNRG-MS Daughter Board (order code: STEVAL-IDB005V1D)
- BlueNRG-MS USB dongle (order code: STEVAL-IDB006V1)
- BlueNRG development platform (order code: STEVAL-IDB002V1)
- BlueNRG USB dongle (order code: STEVAL-IDB003V1)
- STM32L152 Nucleo (order code: NUCLEO-L152RE) and BlueNRG module (order code: X-NUCLEO_IDB04A1), BlueNRG-MS module (order code: X-NUCLEO_IDB05A1)
- STM32L152 Nucleo (order code: NUCLEO-L152RE) and BlueNRG-1, STEVAL-IDB007V1 platform configured as network coprocessor (SPI mode)

- NOTES:
  1. When using a NUCLEO-L152RE platform, install the related ST-Link, ST-Link/V2, ST-Link/V2-1 USB driver signed for XP, Windows7, Windows8 (STSW-LINK009).
  2. When using a NUCLEO-L152RE platform, make sure the ST-Link firmware is updated to latest version available on ST web page. This can be checked/achieved by using the STM32 ST-LINK Utility v3.6.0 (or later):
     1. Connect a NUCLEO-L152RE platform to a PC USB port
     2. Download and install STM32 ST-LINK Utility v3.6.0 (or later): it is available on ST web site (STSW-LINK004).
     3. Run the STM32 ST-LINK Utility v3.6.0 (or later).
     4. From Target menu, select Connect
     5. From ST-LINK menu, select Firmware Upgrade and Device Connect. Click on Yes >>> tab for performing the ST-LINK firmware upgrade.

# Known problems and limitations

This section lists the issues known at release time. Issues found after this release are listed as solved or limitations on newer releases.

- ID 2624: Old DTM FW window appears when using Nucleo-L152RE + BlueNRG-1 network coprocessor platforms:
  - User can just press OK on the window, and use the BlueNRG GUI features.
- ID 2639: Hardware Activation of DTM Updater (v1.7, SPI mode) has been disabled.

# Documentation

- Refer to BlueNRG GUI SW package (STSW-BNRGUI) User Manual (UM2058).
- Refer to Nucleo L152RE - STEVAL_IDB007V1 HW/SW setup doxygen documentation for information about the NUCLEO-L152RE platform + BlueNRG-1, STEVAL-IDB007V1 configured as DTM network coprocessor (SPI mode).