ST AN5623 User Manual

x, y , z

INFRASTRUCTURE

GPS-LIKE POSITIONINGSINGLE SELF-POSITIONING

x, y , z

x, y , z

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
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.

‑

like positioning within

Figure 1. Visualization of 3D modes in BspLocClient

AN5623 - Rev 1 - April 2021

For further information contact your local STMicroelectronics sales office.

www.st.com

1 General 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

AN5623

General information

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

2 Install 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

AN5623

Install BspLocClient

AN5623 - Rev 1

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

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

3 Configure 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:

AN5623

Configure the topology (optional)

sudo mv FILEPATH /etc/BeSpoon/base_position.ini

AN5623 - Rev 1

page 5/20

4 Set 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

AN5623

Set BspLocClient for 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