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.st.com for the latest version. For the 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 |
|
|
|
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 |
|
|
STM32CubeMonitor-RF is a tool provided to help designers to:
•Perform RF (Radio Frequency) tests of Bluetooth® Low Energy (BLE) applications
•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® devices connections
•Sniff 802.15.4 network
This software applies to microcontrollers of the STM32WB Series, based on Arm®(a) cores.
Supported operating systems and architectures
•Windows® 10, 32-bit (x86) or 64-bit (x64)
•Linux® Ubuntu®(b), minimum version 18.04 64-bit
•macOS®(c), minimum version macOS Catalina®(c), architecture Intel®(d) or M1
Software requirements
For Linux, java(e) runtime is required for the installer.
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
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.1Windows®
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.2Linux®
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.3macOS®
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 the screen
c)the Library folder is listed below the Home folder.
1.4Devices 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 |