| BlueNRG-1 Development kits (STSW-BLUENRG1-DK)

Release Notes 2.1.0/ 05-July-2016

# New Features/Changes

This section lists the new features/changes compared to previous BlueNRG-1 DK release (ALPHA package if applicable):

- BlueNRG-1 Bluetooth Low Energy (BLE) Stack binary libraries v1.0:
  - IAR, EWARM for ARM library: bluenrg1_stack_lib.a
  - Keil, MDK-ARM library: bluenrg1_stack_lib_keil.lib
  - Atollic, TrueStudio library: libbluenrg1_stack_lib_atollic.a
- BlueNRG-1 Bluetooth Low Energy network coprocessor support (SPI and UART configuration)
- BlueNRG-1 BLE stack APIs interface and event callbacks.
- BlueNRG-1 Bluetooth Low Energy demonstration applications
- BlueNRG-1 OTA Bluetooth Low Energy Firmware upgrade framework
- BlueNRG-1 Peripheral drivers demonstration applications
- Support for IAR, Keil and Atollic toolchains
- BlueNRG1 linker files for IAR, Keil and Atollic toolchains
- OTA BLE FW upgrade framework with improved speed.
- Added OTA Reset Manager and Service Manager support with Keil toolchain.
- Added Keil MDK-ARM support files (Pack) for BlueNRG-1.
- Added Atollic (GCC) support.
- NOTES:
  - USB to Serial DFU fw upgrade procedure :
    - In order to align the STEVAL-IDB007V1 USB-to-SERIAL firmware version to the latest available image (v1.5) the procedure provided on STEVAL-IDB007V1 USB to Serial DFU FW upgrade procedure must be addressed

## BlueNRG-1 Navigator PC application

- BlueNRG-1 Navigator 2.1.0 supporting BlueNRG-1 device:
  - Graphical user interface which provides an interactive, simple and user friendly interface to the resources available within the BlueNRG-1 DK SW package:
    - BlueNRG-1 Bluetooth Low Energy (BLE) Demonstration Applications
    - BlueNRG-1 Peripherals Drivers Examples
    - BlueNRG-1 Development Kits
    - Release Notes
    - License Files

## BlueNRG-1 Flasher PC application

- BlueNRG-1 Flasher 2.1.0 supporting BlueNRG-1 device:
  - It allows the BlueNRG-1 programming using the UART bootloader.

# Solved Issues

This section lists the solved issues compared to previous BlueNRG-1 DK release (ALPHA package if applicable):

NA: first official release.

# SW Package Contents

- BlueNRG-1 Navigator PC application
- BlueNRG-1 Flasher Utility PC application
- BlueNRG-1 Bluetooth Low Energy (BLE) stack binary library and header files
- BlueNRG-1 Bluetooth Low Energy (BLE) network coprocessor (SPI and UART mode) reference application (DTM)
- BlueNRG-1 Bluetooth Low Energy stack APIs and events callbacks doxygen documentation
- BlueNRG-1 Bluetooth Low Energy demonstration applications (header, sources and toolchains projectes) + doxygen documentation
- BlueNRG-1 Bluetooth Low Energy demonstration applications prebuilt images
- BlueNRG-1 CMSIS files
- BlueNRG-1 peripherals drivers + doxygen documentation
- BlueNRG-1 peripherals drivers examples (header, sources and toolchains projectes) + doxygen documentation
- BlueNRG-1 peripherals drivers examples prebuilt images
- BlueNRG-1 SDK and HAL drivers + doxygen documentation
- BlueNRG-1 network coprocessor SPI protocol specification html document
- Drivers for PC (USB Virtual COM)

## BlueNRG-1 Bluetooth Low Energy (BLE) demonstration applications

- The following BLE examples applications are available:
  1. BLE Beacon application:
     - Projects supporting BlueNRG-1 Development Kits (workspaces: Release, Use_OTA_ServiceManager).
  2. BLE Chat application:
     - Projects supporting BlueNRG-1 Development Kits (workspaces: Client, Server, Server Lower & Higher with OTA, Server with OTA Service Manager).
  3. BLE Chat Master & Slave application:
     - Projects supporting BlueNRG-1 Development Kits (workspace: Release).
  4. BLE OTA Reset Manager applications:
     - Projects supporting BlueNRG-1 Development Kits (workspaces: Release, ServiceManager).
  5. BLE HID/HOGP Mouse and Keyboard applications:
     - Projects supporting BlueNRG-1 Development Kits (workspaces: HID_Keyboard, HID_Mouse).
  6. BLE Remote Control example:
     - Projects supporting BlueNRG-1 Development Kits (workspaces: Release).
  7. BLE Sensor Demo application with acceleration and environmental sensors values (temperature & pressure):
     - Projects supporting BlueNRG-1 Development Kits (workspaces: Release, Lower & Higher with OTA, Use OTA Service Manager).
  8. BLE Throughput application:
     - Projects supporting BlueNRG-1 Development Kits (workspaces: Client & Server unidirectional throughput, Client & Server bidirectional throughput).
  9. BLE ANCS application supporting the notification consumer profile role:
     - Projects supporting BlueNRG-1 Development Kits (workspace: Release).

## BlueNRG-1 Bluetooth Low Energy (BLE) network coprocessor

- DTM application for network coprocessor mode (UART or SPI):
  - It supports network coprocessor configurations: UART (16MHz or 32MHz) and SPI.
  - Projects supporting BlueNRG-1 Development Kits (workspaces: Release_SPI, Release_UART_16MHz, Release_UART_32MHz,Release_SPI_noboot,Release_UART_noboot).

- NOTES :
  - The workspaces Release_SPI, Release_UART_16MHz, Release_UART_32MHz also include the bootoader/updater code which allows to upgrade the network coprocessor code with new FW versions using the BlueNRG GUI, Tools, BlueNRG Updater .... utility.
  - The Release_SPI_noboot,Release_UART_noboot workspaces allow to build the DTM binary files to be used with the BlueNRG GUI, Tools, BlueNRG Updater .... utility provided the BlueNRG-1 kit is already configured as network coprocessor mode.
  - Release_UART_16MHz is the network coprocessor UART configuration to be used for the BlueNRG-1 platform STEVAL-IDB007V1 (BlueNRG-1 DIO8 pin for UART TX and DIO11 pin for UART RX)
  - The SPI network coprocessor configuration requires some HW changes on BlueNRG-1 platform STEVAL-IDB007V1 (refer to the SPI protocol specification document which also describes the required BlueNRG-1 SPI lines).
  - The BlueNRG GUI, Tools, BlueNRG Updater .... utility allows to upgrade only the Release_SPI_noboot,Release_UART_noboot DTM binary files.
  - BlueNRG GUI PC application supporting BlueNRG-1 network coprocessor is provided within the STSW-BNRGUI SW package v2.1.0.

## BlueNRG-1 Peripheral drivers examples

- The following Peripherals Drivers examples are available:

  1. ADC examples:
     1. Polling
  2. GPIO examples:
     1. Input Interrupt
     2. IO Toggle
     3. IO Wakeup
  3. I2C examples:
     1. Master Polling
     2. Master Sensor (Dma, Polling & Interrupt)
     3. Slave Polling
     4. Master DMA
     5. Slave DMA
  4. MFT examples:
     1. Mode 1
     2. Mode 1a
     3. Mode 2
     4. Mode 3
     5. Mode 4
  5. Micro examples:
     1. Hello World
     2. Sleep test
  6. RTC examples:
     1. Clock watch
     2. Time Base
     3. Time Base Pattern
  7. SPI examples:
     1. Master Polling
     2. Master Sensor (Dma, Polling & Interrupt)
     3. Slave Polling
  8. SysTick examples:
     1. Time Base
  9. UART examples:
     1. Dma
     2. Interrupt
     3. Polling
  10. WDG examples:
      1. Reset
      2. Wakeup

# Development Toolchains

- IAR Embedded Workbench for ARM (EWARM) toolchain V7.70 or later
- NOTES:
  - IAR EWARM 7.40.3 version can be used: user is requested to install the Utility\EWARM_BlueNRG-1_Flasher.exe under the EWARM 7.40.3 installation folder.

- Keil uVision V5 (MDK-ARM) toolchain V5.17
- NOTES:
  - User is requested to install the BlueNRG-1 Keil, MDK-ARM support files (Pack). It is provided on Utility folder (Keil.STBlueNRG-1_DFP.0.0.1.pack)

- Atollic TrueStudio for ARM (GCC) toolchain V5.40
- NOTES:
  - BlueNRG-1 flasher is not yet available: BlueNRG-1 Flasher PC application can be used for downloading the built application.

# Supported BlueNRG-1 platforms

- STEVAL-IDB007V1 version 3 development kit (order code: STEVAL-IDB007V1)

# 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 2070: STEVAL-IDB007V1 version 3 max output power is +6dBm.
- ID 2071: OTA framework is not supported when using Atollic, TrueStudio toolchain due to the limited optimization size of this toolchain, which doesn't fit with OTA framework memory layout.
- ID 2095: Atollic DTM SPI configuration doesn't work properly.