STMicroelectronics RN0104 User Manual

RN0104

Release note

STM32CubeMonRF release 2.7.0

Introduction

This release note is updated periodically to keep abreast of STM32CubeMonRF (hereinafter referred to as STM32CubeMonitor-RF) evolution, problems, and limitations.

Check the STMicroelectronics support website at www latest release summary, refer to Table 1.

Table 1. STM32CubeMonRF 2.7.0 release summary

Type Summary

Alignment of OpenThread API with version 1.1.0 and addition of CoAP

Official release

Secure API Addition of 802.15.4 sniffer mode

.st.com for the latest version. For the

Customer support

For more information or help concerning STM32CubeMonitor-RF, contact the nearest STMicroelectronics sales office. For a complete list of STMicroelectronics offices and distributors, refer to the www.st.com web page.

Software updates

Software updates and all the latest documentation can be downloaded from the ST microcontroller support www.st.com web page.

February 2021 RN0104 Rev 13 1/12

www.st.com

General information RN0104

1 General information

1.1 Overview

STM32CubeMonitor-RF is a tool provided to help designers to:

• Pe

• Perform RF (Radio Frequency) tests of 802.15.4 applications

• Send commands to BLE parts to perform tests

• Configure BLE beacon and manage file over-the-air (OTA) transfers

• Discover BLE devices profiles and interacts with services

• Send commands to OpenThread parts to perform tests

• Visualize Thread

• Sniff 802.15.4 network

This software applies to microcontrollers of the STM32WB Series, based on Arm

rform RF (Radio Frequency) tests of Bluetooth® Low Energy (BLE) applications

devices connections

®(a)

cores.

1.2 Host PC system requirements

Supported operating systems and architectures

• Windows® 10, 32-bit (x86) or 64-bit (x64)

• Linux

• macOS

Ubuntu

®(c)

Software requirements

For Linux, java

For 802.15.4 sniffer only:

• Wireshark v2.4.6 or later available from http://www.wireshark.org

• Python v2.7.x or later available from https://www.python.org/downloads

• pySerial v3.4 or later, available from https://pypi.org/project/pyserial

®(b)

, minimum version 18.04 64-bit

, minimum version macOS Catalina

(e)

runtime is required for the installer.

®(c)

, architecture Intel

®(d)

or M1

a. Arm is a registered trademark of Arm Limited (or its subsidiaries) in the US and/or elsewhere.

b. Ubuntu is a registered trademark of Canonical Ltd.

c. macOS and macOS Catalina are trademarks of Apple Inc. registered in the U.S. and other countries.

d. Intel is a trademark of Intel Corporation in the U.S. and/or other countries.

e. Oracle and Java are registered trademarks of Oracle and/or its affiliates.

2/12 RN0104 Rev 13

RN0104 General information

1.3 Setup procedure

1.3.1 Windows

Install

If an older version of STM32CubeMonitor-RF is already installed, the existing version must be uninstalled before installing the new one. The user must have administrator rights on the computer to perform the installation.

1. Download STM32CMonRFWin.zip

2. Unzip this file in a temporary location

3. Launch setupSTM32CubeMonitor-RF.exe to be guided through the setup process

Uninstall

To uninstall STM32CubeMonitor-RF, follow the steps below:

1. Open the Windows Control panel

2. Select Programs and Features to display the list of programs installed on the computer

3. Left-click on STM32CubeMonitor-RF from STMicroelectronics publisher and select the Uninstall function

1.3.2 Linux

Software requirements

The Java™ Run Time Environment is required for the Linux installer. It can be installed with the command apt-get install default-jdk or with the package manager.

Install

1. Download STM32CMonRFLin.tar.gz

2. Unzip this file in a temporary location

3. Make sure you have access rights to the target installation directory

4. Launch the execution of the SetupSTM32CubeMonitor-RF.jar file, or launch manually the installation with java -jar <install path>/SetupSTM32CubeMonitor-RF.jar

5. An icon appears on the desktop. If the icon is not executable, edit its properties and select the option “Allow executing file as program” or for Ubuntu 19.10, select the option “Allow launching”.

Information about com port on Ubuntu

The modemmanager process is checking the com port when the board is plugged. Due to this activity, the com port is busy for a few seconds, and STM32CubeMonitor-RF is unable to connect.

The users need to wait for the end of the modemmanager activity before opening the com port. If the modemmanager is not required by the user, it is possible to uninstall it with the command sudo apt-get purge modemmanager.

For the sniffer mode, the modem manager must be uninstalled or disabled through the command sudo systemctl stop ModemManger.service before connecting the sniffer device.

If the modem manager cannot be disabled, it is also possible to define rules so that the modem manager ignores the sniffer device. 10-stsniffer.rules available in the

RN0104 Rev 13 3/12

General information RN0104

~/STMicroelectronics/STM32CubeMonitor-RF/sniffer directory can be copied in /etc/udev/rules.d.

Uninstall

1. Launch the “uninstaller.jar” located in installation directory /STMicroelectronics/STM32CubeMonitor-RF/Uninstaller. If the icon is not executable,

edit its properties and select the option “Allow executing file as program”.

2. Select “Force deletion...” and click on the Uninstall button.

1.3.3 macOS

Install

1. Download “STM32CMonRFMac.zip”.

2. Unzip this file in a temporary location.

3. Make sure you have access rights to the target installation directory.

4. Double click on the installerSTM32CubeMonitor-RF.dmg file.

5. Open the STM32CubeMonitor-RF new disk.

6. Drag and drop the STM32CubeMonitor-RF shortcut to the Applications shortcut.

7. Drag and drop the document folder to a location of your choice.

If an error “STM32CubeMonitor-RF can't be opened because it is from an unidentified developer” occurs, the command sudo spctl --master-disabl must be used to disable the verification.

Uninstall

1. In the applications folder, select the STM32CubeMonitor-RF icon and move it to trash.

2. In the user’s home directory, remove the folder Library/STM32CubeMonitor-RF. If the Library folder is hidden:

a) open Finder

b) hold down Alt (Option) and choose Go from the drop-down menu bar at the top of

c) the Library folder is listed below the Home folder.

the screen

1.4 Devices supported by STM32CubeMonitor-RF

Supported devices

The tool is tested with the STM32WB Nucleo board (P-NUCLEO-WB55).

Boards based on STM32WBxx are compatible if they feature:

• A connection through a USB “Virtual COM port” or a serial link and

• A “transparent mode” firmware, bridging the UART to the BLE stack controller or

command-line software.

The device connection details and firmware location are described in Section 2 of the user manual STM32CubeMonitor-RF software tool for wireless performance measurements (UM2288).

4/12 RN0104 Rev 13

+ 8 hidden pages