Download libtrf v1.5.4 release package
Introduction
thinkRF’s libtrf API is a multi-platform API library that can be used for interfacing with existing generation thinkRF RTSA devices (R5xx0) and will be maintained into the future to support interfacing with future thinkRF devices. In addition, the API supports and will be evolved to increasingly provide sophisticated signal processing capabilities that can be easily integrated into end-user application code.
The libtrf library is currently released as builds for Microsoft Windows 64-bit (.h/.dll/.lib) and Linux (.h/.so) for both x86_64 (Intel/AMD) and aarch64 (ARM v8+) targets. The interface is presented as undecorated ‘C’ compatible with the C99 (ISO/IEC 9899:1999) and later standards.
This document describes the release information of libtrf API software version 1.5.4. Refer to the companion ‘libtrf API Reference Manual’ 1.5.4 document for full libtrf and its usage details.
Important Note: If your RTSA has firmware v1.7.0/1.7.1 for R55x0 or v1.2.0/1.2.1 for R57x0, it is critical that you should update it to the latest to use libtrf’s spectrum capture as mentioned in section 4 below.
- Supported Devices The versions of libtrf currently released support all thinkRF’s RTSA products R55x0/R57x0 products (408/418/427 models).
New Features
The following new feature(s) and capabiliti(es) were added in version 1.5.4. Refer to the Reference Manual for full details.
- NA.
Enhancements
The following other change(s) were made:
- Added trfUnsupportedParameter error response for when a bit-packing or digital gain is not supported by the RTSA or its firmware version.
Fixed Defects
The following issue(s) are fixed in:
- Addressed the handling of spectrum capture with span around ~20MHz when used with bit packing option.
Deprecated
This section lists the deprecated capabilities, functions, or parameters:
- NA.
Known Issues and Limitations
The following are the known limitations or other issues present since libtrf version 1.4.0:
- Limitation: R55x0/R57x0 products only - Between 30MHz and 50MHz centre frequencies, it is not possible to stream a full 40MHz IFBW as IQ data. This is due to the switching of the RTSA hardware technology types at the 50MHz point, between DD (Direct Digitizer) and SH (SuperHeterodyne) modes.
This issue does not impact sweep spectrum data at that frequency range. - For IQ sampling with center frequency below 50MHz and IFBWs lower than 20MHz, the IQ stream will run for a maximum of around 500msec. This is due to the inherent limitations of the directsampling range on R5xx0 receivers.
- Below 50MHz frequency range, IFBW below 1MHz exhibits sinc-type spectral distortion. This is a libtrf’s constraint, not an RTSA hardware issue.