Status | Date | Doc Version | Applicable | Confidentiality |
RELEASED | 01 Aug 2024 | v1.6 | WPE 1.3.x, 1.4.x, 1.5.x, PosApp, PosLib | PUBLIC |
General Information
This document collects the Wirepas Positioning errata. The document is updated when new errata item is added, or the errata item is updated either work around or information on fix for Wirepas Positioning release. Revision history summarizes all the updates to this document.
Severity has three levels: Low, Medium and High. Severity is provided just for information to understand the impact on Wirepas Positioning functionality or performance. The workaround outlines if there is a way to overcome the bug visible in Affected Versions (Errata). The Fix Version (Errata) indicates the version where the errata item is resolved (possible workaround is not anymore needed).
Revision history summarizes all the updates to this document.
Errata Summary
Key | Errata Title | Errata Description | Errata Severity | Affected Versions (errata) | Fix Version (errata) | Errata Workaround Exists? | Errata Workaround Description |
POS-554 | Deleting a single network break the area matching for shared areas | When network is deleted/purged also internal area (zone) bounds information is deleted from the other networks. This happens when the area has not been bound into any specific network, but is used by all the networks (for example WNT defines areas in this way). In this case, the deletion of some network leads to a situation, in which nodes from other networks are not anymore located into the floor plan(s) where there were shared areas. | High | v1.6.0 | v1.7.0 | Yes | The issue can be fixed by restarting the WPE services, which will cause the area information to be refreshed from WNT. Please note that if WPE is used in a stand alone mode, then issue can be fixed by configuring the area information again. |
POS-545 | Area deletion does not work correctly if there are multiple networks configured into WPE | It is possible to configure multiple networks into WPE by adding anchors or areas that are linked to different networks. In such case, if area deletion is called without specifying the network (as done by WNT), the area is deleted only from the common and the first network’s data structure. This causes that the tags might be still located within the “already deleted” area in the rest of the networks. This will cause exception inside WPE, as the data structures are not in-sync. | Medium | v1.6.0 | v1.7.0 | Yes | The issue can be avoided by restarting the WPE services after areas have been deleted. |
POS-542 | Calculated tag floor might differ from the floor of the matched area | WPE may locate tag to a certain floor and simultaneous match it to and area in a different floor. This kind of situation might occur since tag location calculation and area matching use only the (currently 3) strongest anchors, while floor matching algorithm uses all the anchor information provided in the measurement. The described situation is expected to be unusual and may occur only if the anchors in different floors are densely deployed and overheard without too much of radio signal attenuation between the floors. | Medium | v1.4.0, v1.5.0, v1.6.0, v1.7.0, v1.7.1 |
| No | For the calculation logic there is no direct workaround. However, client system can build logic to check if the area and floor information provided by the WPE is coherent to recognize potential problems with the logic. |
POS-558 | Backend location calculation time is returned as timestamp if WPE is not able to calculate location | WPE will return backend location calculation time, instead of measurement timestamp, when it is not able to calculate location. | Low | v1.6.0, v1.7.0 | v1.7.1 | No | - |
POS-541 | Floor matching has limited support for scenarios where some anchors are located on floors and some not | Current WPE floor matching has limited support for situations, where some anchors are located within buildings and floors and some not (in which case they are located e.g. to WNT “world map”). This kind of configuration is not supported, if such anchors with mixed floor and non-floor configuration are within the same radio range. In such cases, WPE locates the tags to a floor within a building, even if the actual calculated location might be correctly outside the building / floor. | Low | v1.4.0, v1.5.0, v1.6.0, v1.7.0, v1.7.1 |
| Yes | If there is a need to have a configuration, where all the anchors are not located on building floorplans, the suggestion is to create a “background” floor for the surrounding areas and attach those anchors that are not in other floorplans to that. |
POS-473 | Incorrect measurement time | When using WPE with WNT the reported measurement time is not set correctly for all the calculated locations. This is due to WPE using the first measurement time for all the measurements in a batch. This can cause relatively big error in the measurement time value due to different latencies for the messages in the mesh network. | Low | v1.5.0 | v1.6.0 | No |
|
POS-360 | WPE: SSL error | In some rare occasions ssl_transport_security.cc can trigger an error: OPENSSL_internal:WRONG_VERSION_NUMBER This is a known error of the gRPC library (open Issue #9538). The library will be updated once a fix for this issue exists. In case of occurring WPE will have to be restarted. | Low | v1.3.1, v1.4.0, v1.5.0, v1.6.0, v1.7.0, v1.7.1 |
| No |
|
POS-334 | WPE: TLS connection to MQTT does not work | Setting up a TLS connection to MQTT from WPE does not work because of lack of CA root certificates in the WPE Docker image | Low | v1.3.1 | v1.4.0 | No |
|
POS-327 | WPE: Area definition always requires "uid" field | Area configuration does not allow to use only uuid (string) and requires that uid (uint64) field is also defined. | Low | v1.3.1 | v1.4.0 | Yes | The field uid must be defined |
POS-298 | WPE: When configuration from WNT is disabled areas are still injected | When configuration form WNT is disabled areas can still be injected by from WNT. | Low | v1.3.1 | v1.4.0 | No |
|
POSAPP-62 | PositioningApp: incomplete measurements in autoscan mode | Due to a potential race condition in autoscan mode the measurement set can in be incomplete in some random instants. This can result in higher position error than expected. | Medium | v5.0.0 | v1.2.1.2 | Yes | The recommended production mode for tags is NRLS and for anchor opportunistic. These modes are not affected by the error observed in autoscan mode. |
11 issues
Revision History
Date | Version | Notes |
21 Jan 2021 | v1.0A | 1st version of Wirepas Positioning Engine Errata document (with POSAPP-62) |
08 Jun 2021 | v1.1 | Added new errata: POS-298, POS-327, POS-334 and POS-360 |
30 Sep 2021 | v1.2 | Updated POS-360 by adding v1.5.0 to the list of Affected Versions (Errata) |
13 Apr 2023 | v1.3 | Added new errata: POS-541, POS-542 Updated POS-360 by adding v1.6.0 to Affected Versions (Errata) |
03 Oct 2023 | v1.4 | Added new errata: POS-545 |
04 Jan 2024 | v1.5 | Added new errata: POS-473 and POS-554 Updated POS-545 by adding v1.7.0 as Fix Version (Errata) |
01 Aug 2024 | v1.6 | Updated POS-541, POS-542 and POS-360 by adding v1.7.1 to Affected Versions (Errata) Updated POS-558 by adding v1.7.1 as Fix Version (Errata) |
Legal Notice
Use of this document is strictly subject to Wirepas’ Terms of Use and Legal Notice.
Copyright © 2024 Wirepas Oy