ST STEVAL-MKBOXPRO User manual

Introduction

The STEVAL-MKBOXPRO (SensorTile.box PRO) is the new ready-to-use programmable wireless box kit for developing any IoT

application based on remote data gathering and evaluation. Exploit the full kit potential by leveraging both motion and

environmental data sensing. Enhance the connectivity and smartness of whatever environment that you find yourself in.

The STSW-MKBOX-BLEDK is a software package for the BlueNRG-LP Bluetooth® Low Energy system-on-chip supporting

Bluetooth 5.2 specifications. Key highlights of this package are as following:

• Smart sensor node firmware with BlueNRG-LP as controller

• Supports both motion and environmental data sensing

• Over the air (OTA) Firmware upgrade

• Communication with ST BLE Sensor Classic app

• Bluetooth® Low Energy examples like beacon, throughput, and serial Port

Figure 1. STEVAL-MKBOXPRO (SensorTile.box PRO) multisensor and wireless connectivity development kit

STSW-MKBOX-BLEDK software package for BlueNRG-LP

UM3227

User manual

UM3227 - Rev 1 - September 2023

For further information contact your local STMicroelectronics sales office.

www.st.com

1 Acronyms and abbreviations

Table 1. List of acronyms

Acronym Description

BLE Bluetooth Low Energy

MHz Mega Hertz

MCU Microcontroller unit

I2C Inter Integrated Circuit

UM3227

Acronyms and abbreviations

UM3227 - Rev 1 page 2/27

2 Getting started

2.1 Overview

Users can program the BlueNRG-LP to run following BLE Application:

• BLE Sensor Demo

• BLE OTA Reset Manager

• BLE OTA Firmware Manager

• BLE Beacon

• BLE Throughput

• BLE Serial Port Master Slave

There are several ST products used including BLE controllers and sensors on SensorTile.box PRO board:

• BlueNRG-LP (Host BLE Microcontroller)

• LSM6DSV16X (iNEMO 3D accelerometer & 3D gyroscope)

• LPS22DF (Pressure Sensor)

• STTS22H (Temperature Sensor)

• LIS2MDL (Magnetic sensor)

• LIS2DU12 (Ultra-low-power 3-axis linear accelerometer)

Figure 2. SensorTile.box PRO PCB Components description

Below is a high-level Block diagram of the board with respect to BlueNRG-LP:

UM3227

Getting started

UM3227 - Rev 1 page 3/27

Figure 3. Example block diagram

2.2 Folder Structure

The STSW-MKBOX-BLEDK software package files are organized in the following main directories:

•Firmware: contains prebuilt binary Bluetooth® Low Energy sample applications

•Drivers:

–BSP: SDK drivers providing an API interface to the BlueNRG-LP/BlueNRG-LPS platform hardware

resources (LEDs, buttons, sensors, I/O channel)

–CMSIS: BlueNRG-LP/BlueNRG-LPS CMSIS files

–Components: Sensors driver source files

–Peripherals_Drivers: BlueNRG-LP/BlueNRG-LPS drivers for device peripherals (ADC, AES, CRC,

DMA, clock, GPIO, I²C, IWDG, LPUART, PWR, RCC, RNG, RTC, SPI, SysTick, TIM, and USART)

•Middleware:

–Bluetooth® Low Energy: Bluetooth® Low Energy stack binary library and all the definitions of stack

APIs, stack, and events callbacks. Bluetooth® Low Energy stack v3.x configuration header and

source files

–BLE_Application: Bluetooth® Low Energy application framework files (Bluetooth® Low Energy

stack layers define values, OTA FW upgrade, Bluetooth® Low Energy utilities, master library, GATT,

GAP standard profiles, ATT Prepare Write Queue framework)

–cryptolib: AES crypto library

–HAL: hardware abstraction level APIs to abstract certain BlueNRG-LP/BlueNRG-LPS HW/SW

features (Crash handler, memory utilities, FIFO management, compiler macros, over-the-air utilities

for 2.4 GHz radio proprietary solution, general utilities).

–NVMDB: nonvolatile memory drivers

–AESMGR: AES manager

–BLECNTR: Bluetooth® Low Energy controller manager

–PKAMGR: PKA manager

–RNGMGR: RNG manager

•Projects

–BLE_Examples: Bluetooth® Low Energy demonstration application including headers, source files

and EWARM and Keil® project files

UM3227

Folder Structure

UM3227 - Rev 1 page 4/27

2.3 Hardware requirements

To use the STSW-MKBOX-BLEDK package you need following:

•STEVAL-MKBOXPRO (SensorTile.box PRO Hardware) – (2 Qty required for BLE_Throughput and BLE

Serial Port Application)

• STLINK-V3 Programmer and Cable – (2 Qty required for BLE Throughput and BLE Serial Port Application)

• STEVAL-IDB011V1 (BlueNRG-LP EVK) – (Required for BLE OTA Reset Manager Application)

• PC Windows 10 or higher

• Mobile (Android/IOS)

2.4 Software requirements

To use the STSW-MKBOX-BLEDK package you need following:

•STSW-MKBOX-BLEDK software package.

• IAR ARM v9.20.1/MDK -ARM v5.37.0

• RF-Flasher Utility GUI

• STM32CubePROGRAMMER GUI

• ST BLE Sensor Classic Mobile App for Android/IOS

• BlueNRG-GUI – (Required for BLE OTA Reset Manager Application)

• Tera Term

2.5 Board setup

In the SensorTile.box PRO there are components like sensors, LED, switches connected both BlueNRG-LP and

STM32U5 controllers. More than one controller that simultaneously controls these components could lead to

unwanted circumstances. To avoid such a case, we need to first mass erase the STM32U5 following below steps:

Step 1. To mass erase the STM32U5 start the DFU Mode:

– Connect the board with the USB cable

– With the board off, press button BT2, then turn on the board and release button BT2

UM3227

Hardware requirements

UM3227 - Rev 1 page 5/27

Step 2. Then use the STM32 Cube Programmer: make sure you have the latest STM32CubePROGRAMMER

version (old versions might not get recognize the U5 in DFU Mode)

– Select USB, Select the port USB1, click on Connect (see Figure 4)

– Go on the page in Orange Arrow (see Figure 5)

– Click on Full Chip Erase marked by Red circle (see Figure 6)

Figure 4. STM32U5 mass erase steps (step 1)

Figure 5. STM32U5 mass erase steps (step 2)

UM3227

Board setup

UM3227 - Rev 1 page 6/27

Figure 6. STM32U5 mass erase steps (step 3)

UM3227

Board setup

UM3227 - Rev 1 page 7/27

3 BLE applications

3.1 BLE Sensor demo

The Bluetooth® Low Energy sensor demo application for ST BLE Sensor Classic app is supported on the

SensorTile.box PRO kit. This application shows how to implement a sensor demo custom profile application

tailored for interacting with the ST BLE Sensor Classic smartphone app. Once configured and connected, the

BlueNRG-LP device sends the data collected from the motion sensor (accelerometer, gyroscope, and

magnetometer) and environmental sensor (pressure and temperature) to the ST BLE Sensor Classic smartphone

app, which displays this information.

Figure 7. Sensors orientation

Running the application:

Two versions (Android and iOS) of the smartphone ST BLE Sensor Classic app are available for download.

Step 1. Connect the STLINK V3 programmer probe to JP3 header on SensorTile.box PRO board. Connect the

programmer to PC with a USB Cable

Step 2. Build the related BLE Sensor Demo application (STSW-MKBOX BLEDK\Projects\BLE_Examples\

BLE_SensorDemo) on the selected platform (pre-built image is available on STSW-MKBOX-

BLEDK\Firmware\ BLE_Examples\BLE_SensorDemo\BlueNRG-LP\Release folder and can be loaded

through RF Flasher Utility)

Step 3. Load the firmware on the hardware either using IAR/KEIL workspace or flashing Binary File(.hex/.bin)

directly using RF Flasher Utility GUI

Note: While flashing BLE_SensorDemo binary(.bin) using RF Flasher Utility enter the image “Flash from

Address” as “0x10040000”.

Step 4. Remove the STLINK Debugger and Power reset the Board using S1 switch

Step 5. Install the app and launch it.

Step 6. The app starts scanning for the BlueNRG-LP Sensor Demo peripheral device. A device called

“BLESenBP” appears on the screen

Step 7. Select the “BLESenBP” name and connect to the selected platform. The ST BLE Sensor Classic app

enables notifications on the motion characteristic (Accelerometer, Gyroscope, Magnetometer) and on

the environment characteristics (pressure and temperature) and displays the received environment

characteristic values on the screen

UM3227

BLE applications

UM3227 - Rev 1 page 8/27

Step 8. Select the ST BLE Sensor Classic Demo, Plot Data window and select sensor options to plot the

received values. The sensor values are displayed on a graphical chart.

Figure 8. Expected output on ST BLE Sensor Classic App

3.2 BLE beacon

This is a BLE beacon demo that shows how to configure a BlueNRG-LP device to advertise specific

manufacturing data and allow another BLE device to know if it is in the range of the BlueNRG-LP beacon device.

It provides a reference example about how to use the BLE over-the-air (OTA) service manager firmware upgrade

capability. This example also allows us to use the extended advertising feature to configure beacon also on a

secondary advertising channel. Further a specific configuration (PeriodicAdv) allows to configure a beacon with

periodic advertising. On BlueNRG-LPS, the AoA_Tag configuration allows to configure a BlueNRG-LPS device as

an AoA tag for connectionless scenario.

The beacon demo configures a BlueNRG-LP device in advertising mode (nonconnectable mode) with specific

manufacturing data. It transmits advertisement packets at regular intervals which contain the following

manufacturing data:

Figure 9. Manufacturing data table

• (1): SIG company identifiers are available on https://www.bluetooth.com/specifications/assigned-numbers/

company-identifiers/

• NA: Not Applicable

Note: OTA service manager support requires to build application by enabling

CONFIG_OTA_USE_SERVICE_MANAGER (preprocessor, linker) options and through files: OTA_btl.[ch] (refer

to Release_with_OTA_ServiceManager IAR workspace).

Running the Application:

UM3227

BLE beacon

UM3227 - Rev 1 page 9/27

Step 1. Connect the STLINK V3 programmer probe to JP3 header on SensorTile.box PRO board. Connect the

programmer to PC with a USB Cable

Step 2. Build the related BLE Beacon application (STSW-MKBOX BLEDK\Projects\BLE_Examples\

BLE_Beacon) on the selected platform (pre-built image is available on STSW-MKBOX-

BLEDK\Firmware\ BLE_Examples\BLE_Beacon\Release folder and can be loaded through RF Flasher

Utility)

Step 3. Load the firmware on the hardware either using IAR/KEIL workspace or flashing Binary File (.hex/.bin)

directly using RF Flasher Utility GUI

Step 4. Remove the Debugger, Power reset the Board using S1 switch. Plug the Debugger again to PC for

serial terminal

Step 5. Open Serial terminal like Tera-Term and select the serial port. Set the baud rate as 115200

Step 6. The device will start advertising according to the configuration selected (Release, Extended, Periodic)

and the Printf logs will be visible in serial terminal

UM3227

BLE beacon

UM3227 - Rev 1 page 10/27

Table of contents

Popular Microcontroller manuals by other brands

AMS

AMS AS7261 Demo Kit user guide

Novatek

Novatek NT6861 manual

Espressif Systems

Espressif Systems ESP8266 SDK AT Instruction Set

Nuvoton

Nuvoton ISD61S00 ChipCorder Design guide

STMicrolectronics

STMicrolectronics ST7 Assembler Linker user manual

Texas Instruments

Texas Instruments Chipcon CC2420DK user manual

Lantronix

Lantronix Intrinsyc Open-Q 865XR SOM user guide

NEC

NEC 78GK0S/K 1+ Series Application note

Mikroe

Mikroe SEMITECH N-PLC Click Application note

Intel

Intel Agilex user guide

Cypress

Cypress CY4607 HX2VL quick start guide

DIGITAL-LOGIC

DIGITAL-LOGIC MICROSPACE manual

Texas Instruments

Texas Instruments TMS320F2837 D Series Workshop Guide and Lab Manual

CYPRES

CYPRES CY14NVSRAMKIT-001 user guide

Texas Instruments

Texas Instruments INA-DUAL-2AMP-EVM user guide

Espressif Systems

Espressif Systems ESP8266EX Programming guide

Abov

Abov AC33M8128L user manual

Laird

Laird BL654PA user guide