Bluetooth® Real-Time Lo cat i ng Li br ar y 3 .1. 2.0 GA
Gecko S DK Suit e 3.1
April 7, 2021
Silicon Labs is a leading vendor in Bluetooth hardware and software technologies, used
in products such as sports and fitness, consumer electronics, beacons, and smart home
applications.
The Real-Time Locating (RTL) library contains features fo r Angle of Arrival es timation and
spatial positioning. The software library comes with a C-programming language API for
Windows (x86_64) and Linux (ARM Cortex A, x86_64) hosts.
The RTL Library is released with the Bluetooth SDK. These release notes cover the following version(s):
Real-Time Locating Library 3.1.2.0 in Bluetooth SDK 3.1.2.0 released on April 7, 2021
Real-Time Locating Library 3.1.1.0 in Bluetooth SDK 3.1.1.0 released on January 27, 2021
Real-Time Locating Library 3.1.0.0 in Bluetooth SDK 3.1.0.0 released on December 9, 2020
KEY FEATURES
• First Gener ally Available release
• Azimuth and elevation calculation
• Tag X,Y,Z-pos i t io n in m ult i l oc at or se tu p
silabs.com | Buildin g a mor e co nnected w or l d. Bluetooth Real-Time Loc a ting Libra ry 3.1.2.0
Contents
Contents
1 New Items .................................................................................................................................................................................. 2
2 Improvements ............................................................................................................................................................................. 3
3 Fixed Issues ............................................................................................................................................................................... 4
4 Known Issues in the Current Release .......................................................................................................................................... 5
5 Deprecated Items ....................................................................................................................................................................... 6
6 Removed Items .......................................................................................................................................................................... 7
7 Using This Release .................................................................................................................................................................... 8
7.1 Installation and Use ............................................................................................................................................................. 8
7.2 Support ............................................................................................................................................................................... 8
8 Legal .......................................................................................................................................................................................... 9
8.1 Disclaimer ........................................................................................................................................................................... 9
8.2 Trademark Information ........................................................................................................................................................ 9
silabs.com | Buildin g a mor e co nnected w or l d. Bluetooth Real-Time Loc a t i ng Li brary 3.1. 2.0 | 2
New Items
1 New Items
Added in release 3.1.0.0
Initial release
silabs.com | Buildin g a mor e co nnected w or l d. Bluetooth Real-Time Loc a t i ng Li brary 3.1. 2.0 | 2
Improvements
2 Improvements
None
silabs.com | Buildin g a mor e co nnected w or l d. Bluetooth Real-Time Loc a t i ng Li brary 3.1. 2.0 | 3
ID #
Description
681301
AoA locator azimuth mask feature doesn't work with ranges that are transit over +-180 deg
668780
Locator’s ID in AoA Multilocator config file is case-sensitive
Fixed Issues
3 Fixed Issues
Fixed in release 3.1.2.0
408196 The Location estimator supports only one locator configuration and dimensionality mode per application
684660 Setting low values for FILTERING_AMOUNT causes segmentation fault in multi-locator host application
682291 Previous AoA-measurements may affect the results even if the AoX-estimator is reset in between
679243
679243 AoA multilocator Python GUI is rotating the locator images with incorrect logic
676757 Channel is always 0 in silabs cte iq report event
675134 AoA locator seems to sometimes mix IQ samples of tags transmitting connectionless CTE simultaneously
668780 aoa_asset_tag target application causes position error
661288 aoa_locator host application does not close nicely
Fixed in release 3.1.1.0
ID # Description
656483
Fix an issue where, in some rare cases, IQ sample QA may hang in an infinite loop when calling the sl_rtl_aox_process()
with IQ sample QA processing enabled.
When the multilocator has configured for N locator, it requires N angle data to push it to the estimator even if
multiple ( >= 2) angle data is available and there is no correlation between angle sequence ID and the collected
data
silabs.com | Buildin g a mor e co nnected w or l d. Bluetooth Real-Time Loc a t i ng Li brary 3.1. 2.0 | 4
ID #
Description
Workaround
Known Issues in the Current Releas e
4 Known Issues in the C urrent Release
Issues in bold were added since the previous release.
375152
653321
653422
653412
In heavy multipath conditions, the line-of-sight signal is not always
detected correctly. In s ome cases this may mean large errors in both
azimuth and elevation readings.
In certain environments, the elevation reading might get fixed to 89
degrees
Visualization script in aoa_multilocator_gui is missing implementation for
showing visualization lines for angles from locators
Visualization script aoa_multilocator_gui may occasionally fail with
"RunTimeError: dictionary changed size during iteration"
None
None
None
None
silabs.com | Buildin g a mor e co nnected w or l d. Bluetooth Real-Time Loc a t i ng Li brary 3.1. 2.0 | 5
Deprecated Item s
5 Deprecated Items
None
silabs.com | Buildin g a mor e co nnected w or l d. Bluetooth Real-Time Loc a t i ng Li brary 3.1. 2.0 | 6
Removed Items
6 Removed Items
None
silabs.com | Buildin g a mor e co nnected w or l d. Bluetooth Real-Time Loc a t i ng Li brary 3.1. 2.0 | 7
Using This Release
7 Using This Release
7.1 Installation and Use
For instructions on developing with the RTL library, see AN1296: Application Development with Silicon Labs’ RTL Library and the API
reference included with the documentation installed through Simplicity Studio in the Bluetooth SDK.
7.2 Support
Development Kit customers are eligible for training and technical support. Use the Silicon Labs Bluetooth LE web page to obtain infor-
mation about all Silicon Labs Bluetooth products and services, and to sign up for product support.
Contact Silicon Laboratories support at http://www.silabs.com/support or through links on the Simplicity Studio Welcome page.
silabs.com | Buildin g a mor e co nnected w or l d. Bluetooth Real-Time Loc a t i ng Li brary 3.1. 2.0 | 8
Legal
8 Legal
8.1 Disclaimer
Silicon Labs intends to provide customers with the latest, accurate, and in-depth documentation of all peripherals and modules available
for system and software implementers using or intending to use the Silicon Labs products. Characterization data, available modules and
peripherals, memory sizes and memory addresses refer to each specific device, and “Typical” parameters provided can and do vary in
different applications. Application examples described herein are for illustrative purposes only. Silicon Labs reserves the right to make
changes without further notice to the product information, specifications, and descriptions herein, and does not give warranties as to the
accuracy or completeness of the included information. Without prior notification, Silicon Labs may update product firmware during t he
manufacturing process for security or reliability reasons. Such changes will not alter the specifications or the performance of the product. Silicon Labs shall have no liability for the consequences of use of the information supplied in this document. This document does
not imply or expressly grant any license to design or fabricate any integrated circuits. The products are not designed or authorized to be
used within any FDA Class III devices, applications for which FDA premarket approval is required, or Life Support Systems without the
specific written conse nt of Silicon Labs. A “Life Support Syste m” i s any product or system intende d to support or sus tain l i fe and/or health,
which, if it fails, can be reasonably expected to result in significant personal injury or death. Silicon Labs products are not designed or
authorized for military applications. Si licon Labs produ cts shall under no circumsta nces be use d in weapon s of mass de struct ion including
(but not limited to) nuclear, biological or chemical weapons, or missiles capable of delivering such weapons. Silicon Labs disclaims all
express and implied warranties and shall not be responsible or liable for any injuries or damages related to use of a Silicon Labs product
in such unauthorized applications. Note: This content may contain offensive terminology that is now obsolete. Silicon Labs is
replacing these terms with inclusive language wherever possible. For more information, visit
sive-lexicon-project
www.silabs.com/about-us/inclu-
8.2 Trade mark Information
Silicon Laboratories Inc.®, Silicon Laboratories®, Silicon Labs®, SiLabs® and the Silicon Labs logo®, Bluegiga®, Bluegiga Logo®,
ClockBuilder®, CMEMS®, DSPLL®, EFM®, EFM32®, EFR, Ember®, Energy Micro, Energy Micro logo and combinations thereof, “the
world’s most energy friendly microcontrollers”, Ember®, EZLink®, EZRadio®, EZRadioPRO®, Gecko®, Gecko OS, Gecko OS Studio,
ISOmodem®, Precision32®, ProSLIC®, Simplicity Studio®, SiPHY®, Telegesis, the Telegesis Logo®, USBXpress®, Zentri, the Zentri
logo and Zentri DMS, Z-Wave®, and others are trademarks or registered trademarks of Silicon Labs. ARM, CORTEX, Cortex-M3 and
THUMB are trademarks or registered trademarks of ARM Holdings. Keil is a registered trademark of ARM Limited. Wi-Fi is a regi s t er e d
tr adem ark of the Wi -Fi Alliance. All other products or brand names mentioned herein are trademarks of their respective holders.
silabs.com | Buildin g a mor e co nnected w or l d. Bluetooth Real-Time Loc a t i ng Li brary 3.1. 2.0 | 9
Loading...