ST AN5623 User Manual

AN5623

Application note

Visualizing of 3D modes in BeSpoon location client tool

Introduction

BeSpoon location client (BspLocClient) is conceived as a server frontend for BeSpoon real time location system (RTLS), for example, to visualize the position of a device on a 2D map in real time and to record positions. Basic features such as tracking

visualization, record, replay, are available on Windows® and Ubuntu®, with or without a server. Advanced features such as

Viewer 1D, Calibration 2D, Debug 2D, UWB Stats, Server Stats, and LOS indicator are available on Ubuntu® only and require a server.

If you already use BeSpoon RTLS, BspLocClient is installed on the server PC. If you use B-UWB-MEK1 hardware only, installation files are included in the SDK, in tools > exe for Windows®, and tools > deb for Ubuntu®. In the application note, BspLocClient is used without any server connection, in two device-centric tracking modes: 3D Single Self-Positioning or 3D GPS like positioning, as illustrated in Figure 1.

This application note complements the information available in the SDK. It is intended for advanced users already familiar with 3D-single self-positioning mode in the quick start guide and 3D GPS like positioning mode in the 3D GPS like positioning within BeSpoon RTLS application note. The procedures are done with Terminal, BspLocClient, BeSpoon MOD1/MEK1 programming tool, and BeSpoon location server WebUI applications.

The documentation is based on system version 3.x.

Figure 1. Visualization of 3D modes in BspLocClient

SINGLE SELF-POSITIONING

GPS-LIKE POSITIONING

	, z
x,	y

INFRASTRUCTURE

x, y, z

x, y, z

AN5623 - Rev 1 - April 2021	www.st.com
For further information contact your local STMicroelectronics sales office.

AN5623

General information

1General information

B-UWB-MEK1 embeds the B-UWB-MOD1, which features the STM32L476JE 32-bit microcontroller based on the Arm® 32-bit Cortex® M4 processor.

Note:	Arm is a registered trademark of Arm Limited (or its subsidiaries) in the US and/or elsewhere.
	Definitions
	Table 1 presents the definition of acronyms that are relevant for a better understanding of this document.

	Table 1. List of acronyms
Term	Definition
3D_SELF	3D single self-positioning
BLR	Beacon-listening rate
HF	Hyperframe
PHS	Protocol hyperframe size
PSN	Protocol slot number
PSS	Protocol slot size
RTLS	Real time locating system
RV	Rendez-vous (slot and zone)
SF	Superframe
SFI	Superframe information
TDMA	Time-division multiple access
UWB	Ultra-wideband

References

Refer to the following documents for an introduction to the B-UWB-MEK1 and B-UWB-MOD1 products in indoor location systems:

•Ultra-wideband module for high-precision indoor location (DB4404)

•Evaluation kit for the B-UWB-MOD1 ultra-wideband module (DB4392)

•B-UWB-MEK1 quick start guide (UM2798)

•SDK advanced documentation

Demonstration software

Contact the local STMicroelectronics sales office or distributor (refer to www.st.com) for the latest software and associated documentation.

AN5623 - Rev 1	page 2/20

AN5623

Install BspLocClient

2Install BspLocClient

On Windows®, the application can be started directly from the .exe file. In the SDK package, just open tools > exe and click on bsplocclient_basic_X. XX.X_amd64.exe to start BspLocClient.

On Ubuntu® (not needed if BeSpoon RTLS server is installed on the PC, as the client application is part of the server package):

Step 1. Search [Terminal] by typing "Terminal" in the Ubuntu® search tool.

The application icons can be dragged and dropped to the left menu bar for quick access.

Figure 2. Dragged and dropped application icons to the left menu bar for quick access

Step 2. Open [Terminal].

Step 3. Ensure the computer is connected to the Internet, to ensure the automatic download of the execution applications Qt packages from the Linux® software repository.

Step 4. Enter the following command (installing Qtx.x.x packages):

sudo apt-get install qt5-default libqt5svg5 libqt5serialport5 libqwt-qt5-6

The programming tool displays a progress bar and device information.

Step 5. Check if a previous version is installed:

–No previous version installed: skip to step 6.

–Previous version installed:

a.Save the old client configuration files.

b.Uninstall previous packages with the following command:

sudo dpkg –-purge bsplocclient libbsptransport bsploclibrary

AN5623 - Rev 1	page 3/20

AN5623

Install BspLocClient

Step 6. Access the deb directory in the SDK by using the Linux® command cd ("change directory") and entering the corresponding path.

In the example below, the user is navigating from the home directory and the SDK directory is stored on the desktop:

cd Desktop/mod1_SDK_3.x.x_REVISION/tools/deb

Step 7. Install the BspLocClient with the following command:

sudo dpkg -i *.deb

Step 8. To check the installation, start typing “bsp” or "BeSpoon" in the search tool.

It displays an icon labeled as "BeSpoon Location Viewer".

Figure 3. BeSpoon Location Viewer icon

AN5623 - Rev 1	page 4/20

AN5623

Configure the topology (optional)

3Configure the topology (optional)

Note:	Skip this section if you want to visualize the mobile device only.
	BspLocClient can display the mobile device together with the fixed devices used to track it:
	•	Fixed MEK1 boards in 3D single self-positioning
	•	Anchors in 3D GPS like positioning within a BeSpoon RTLS.

To take this topology into account, the application needs a file named base_position.ini.

The following procedure shows how to create this file and import it into BspLocClient.

Step 1. Retrieve the topology:

–3D_SELF: In MOD1/MEK programming tool > Localization > INFRA, select [Export To Ini].

–3D_GPS: In BeSpoon Loc Server WebUI > DEVICES > Devices management, click on [Export devices].

Step 2. Get the file path.

Step 3. Rename the file base_position.ini and move it into the right system administration directory (/et c/BeSpoon) . On Ubuntu®, use the following command:

sudo mv FILEPATH /etc/BeSpoon/base_position.ini

AN5623 - Rev 1	page 5/20

AN5623

Set BspLocClient for MEK positioning

4Set BspLocClient for MEK positioning

On Windows®, the application directly starts with preferences adapted to MEK1 positioning, as shown in Figure 4.

Figure 4. Application preferences adapted to MEK positioning

On Ubuntu®:

Step 1. Open BspLocClient.

Step 2. In the start window, select [Local File].

Step 3. As the application doesn't find any connection to a BeSpoon RTLS server, it asks to confirm that BspLocClient is used without a server.

Figure 5. Use of BspLocClient without server connection

Click on [Yes]

The application first opens as a standard interface for BeSpoon RTLS use.

Step 4. In the main menu, select [Tools > Preferences].

AN5623 - Rev 1	page 6/20