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

Release Notes 2.3.0/ 02-December-2016

# New Features/Changes

This section lists the new features/changes compared to previous BlueNRG-1 DK release:

- Added STM32L - BlueNRG-1 network coprocessor framework (SPI configuration) example on folder Library\STM32L (STM32L52RE - Nucleo L152RE + BlueNRG-1 - STEVAL-IDB007V1 platforms)
- Added STM32L - BlueNRG-1 network coprocessor framework demonstrations applications on folder Firmware\STM32L (Beacon, Chat master & Slave, Sensor Demo and DTM application for BlueNRG GUI)
- Added STM32L - BlueNRG-1 network coprocessor framework demonstrations applications prebuilt binary files for STM32L52RE - Nucleo L152RE platform (folder: Project\STM32L)
- Added STM32L - BlueNRG-1 network coprocessor framework example doxygen documentation (guidelines for building applications and APIs/events description)
- Updated BlueNRG-1 DTM application version to 1.7
- New document: BlueNRG-1 BLE stack programming guidelines document Rev1 (PM2057) providing the following information:
  - Fundamentals of Bluetooth low energy (BLE) technology
  - BlueNRG-1 BLE stack library APIs and events callbacks overview
  - How to design an application using the BlueNRG-1 stack library APIs and events callbacks:
    - It provides some common BLE uses cases and the associated SW APIs workflow with parameters description.
- Added BlueNRG-1 GATT database size guidelines doxygen documentation
- Added BlueNRG-1 Applications debugging guidelinees doxygen documentation
- Added crash handler macros doxygen documentation
- NOTES:
  - Before using a STEVAL-IDB007V1 platform, align the USB to Serial DFU fw to the latest available version (v1.6) :
    - In order to update the STEVAL-IDB007V1 USB-to-SERIAL firmware version, the procedure provided on STEVAL-IDB007V1 USB to Serial DFU FW upgrade document must be addressed.

## BlueNRG-1 Navigator PC application

- BlueNRG-1 Navigator 2.3.0 supporting BlueNRG-1 device.

## BlueNRG-1 Flasher PC application

- BlueNRG-1 Flasher 2.3.0 supporting BlueNRG-1 device.

## BlueNRG-1 PC application/utilities (available on standalone SW packages)

- BlueNRG GUI PC application and script launcher utility supporting BlueNRG-1 device are available on STSW-BNRGUI web page (GET SOFTWARE section).
- BlueNRG current consumption estimation tool supporting BlueNRG-1 device is available on STSW-BNRG001 web page (GET SOFTWARE section).

# Solved Issues

This section lists the solved issues compared to previous BlueNRG-1 DK release:

- ID 1555: sleep management improvement
- ID 2189: AN4818 Bringing Up Rev2 issue: measurement of HS startup time test requires application going to sleep (DTM_SPI.hex or any sleeping application shoudl be used)
- 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 DTM application v1.6.
- ID 2400: GPIO_WriteBit GPIO_ResetBits GPIO_SetBits don't work properly: clear operation clears all the previous bits set.
- ID 2524: SPI protocol - First byte of header is a dummy byte (not 0xFF)
- ID 2540: DTM application v1.6: DTM_StackInit() function to be updated for aligning to HS startup time max value.

# SW Package Contents

- 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 Master/Central library APIs and 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
- BlueNRG-1 GATT database size guidelines doxygen documentation
- BlueNRG-1 Applications debugging guidelinees doxygen documentation
- Drivers for PC (USB Virtual COM)
- BlueNRG-1 Navigator PC application:
  - It 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 Utility PC application .
  - It allows the BlueNRG-1 programming using the UART bootloader.
- STM32L - BlueNRG-1 network coprocessor framework example doxygen documentation
- STM32L - BlueNRG-1 network coprocessor APIs/events doxygen documentation

## 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 Sensor Demo Central which emulates the Sensor Demo applications available for smartphones (iOS and android):
     - Projects supporting BlueNRG-1 Development Kits (workspace: Release.
  9. BLE Throughput application:
     - Projects supporting BlueNRG-1 Development Kits (workspaces: Client & Server unidirectional throughput, Client & Server bidirectional throughput).
  10. 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 v1.7 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_16MHz_noboot, Release_UART_32MHz_noboot).

- NOTES :
  - Before using a STEVAL-IDB007V1 platform as network coprocessor (UART or DTM), upgrade the DTM application to the latest available version (v1.7) .
    - Prebuilt DTM binary images (DTM_SPI.hex, DTM_UART_16MHz, DTM_UART_32MHz) are available on Firmware//BLE_Examples/DTM folder and can be downloaded using the BlueNRG-1 Navigator or Flasher tool.
  - The workspaces Release_SPI, Release_UART_16MHz, Release_UART_32MHz also include the bootloader/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_16MHz_noboot, Release_UART_32MHz_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_16MHz_noboot, Release_UART_32MHz_noboot DTM binary files.
  - BlueNRG GUI PC application supporting BlueNRG-1 network coprocessor with updated DTM FW v1.7 is provided within the STSW-BNRGUI SW package v2.2.2 or later.

## BlueNRG-1 Peripheral drivers examples

- The following Peripherals Drivers examples are available:

  1. ADC examples:
     1. DMA
     2. PDM
     3. 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). Check on Keil web site for latest available version (1.2.0).
  - Before installing a new Keil pack, please remove the current one.
  - After new pack installation, when opening a Keil project, please select the ST-Link Debugger option on Keil Project, Option for Target '...', Debug, Use tab and then save the selected configuration on file *.uvoptx.

- 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 development kit (order code: STEVAL-IDB007V1).
- NUCLEO-L152RE platform + BlueNRG-1 STEVAL-IDB007V1 configured as DTM 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 2070: STEVAL-IDB007V1 development kit 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 2089: If the DL2 led (BOOT pin) is high before the BlueNRG-1 goes to sleep, the pin level stays high (~2 V with 3.3 V of VDD).
- ID 2524: SPI protocol - First byte of header.
- ID 2639: Hardware Activation of DTM Updater (v1.7, SPI mode) has been disabled.