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)
1.
Figure 5. STM32U5 mass erase steps (step 2)
2.
UM3227
Board setup
UM3227 - Rev 1 page 6/27

Figure 6. STM32U5 mass erase steps (step 3)
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