Download MATLAB API v4.1.1

View release notes

1 Introduction 

This document describes versions 4.1.0 & 4.1.1 release of the MATLAB API for ThinkRF Real-Time Spectrum Analyzer (RTSA). The release package is included in a compressed zip folder. See the API Reference Guide included in \documentation folder as a starting point. 

The API is set to run with \include\Dll\rtsaInterface.dll, a 64-bit version. To use the API in 32-bit MATLAB, copy the DLL files from \include\Dllx32 to \include\Dll folder. This version is compatible with all ThinkRF R5xx0 products, including R55x0 (all models) and R57x0 (all models). 

2 Fixed Defects 

The following issues are fixed in the version 4.1.0. 1. Included many fixes mentioned in the C++ API DLL v1.5.2 release. The following issues are fixed in the version 4.1.1. 2. Included fixes mentioned in the C++ API DLL v1.5.3 release. 3. Fixed frequency min & max attributes due to DD mode. 4. Disallowed frequency level trigger in DD mode and updated CaptureTraceSpectrumExample.mlapp GUI accordingly. 5. Fixed checking of the frequency related fields of SweepDeviceExample.mlapp GUI. 

3 New Features 

The following new features and capabilities were added to the version 4.1.0. 

  1. Added loadDLL.m which is used to pre-load the DLL into an mfile called rtsaInterfaceLib.m instead (as included in the 'api' folder). This method reduces the need of loading the DLL at each run time, hence, speed up the processing time of example scripts or application significantly. See loadDLL.m if needed to update the rtsaInterfaceLib.m with a new DLL for instance. 
  2. Added new methods, most target toward RTSA R57x0 products with a GNSS module: 
    1. enableGNSS() 
    2. getGNSSStatus() 
    3. getGNSSPosition() 
    4. getGNSSFixSource() 
    5. setGNSSAntennaDelay() 
    6. getGNSSAntennaDelay() 
    7. setGNSSConstellation() 
    8. getGNSSConstellation() 
    9. setReferencePPS() 
    10. getReferencePPS() 
    11. readGNSSContextPkt() 
    12. getReadAccess() 
    13. armTraceCapture() 
    14. traceCaptureAndContext() 
    15. captureTraceSpectrumAndContext() 
    16. readVRTPacket() 
  3. Added new structs to handle the VRT context, including that of GNSS: 
    1. vrt_header 
    2. vrt_context 
    3. vrt_gnss_geolocn
      See the end of rtsaInterfaceLib.m file for the list of struct members.
  4. Added new script examples: 
    1. readIQandGNSSData.m 
    2. captureTraceSpectrumAndGNSS.m 
  5. Added a readPersist option to setTraceLevelTrigger() to allow for the number of times to retry reading the data socket. 
  6. Added IQ imbalance correction for ZIF mode. 
  7. Added errorCodes.m file to \definitions folder to handle particular warning or error codes from the underlying DLL. In this release, WARNING_SOCKETTIMEOUT (code -20201) has been added. 

4 Other Changes 

The following other changes were made in version 4.1.0. 

  1. Read acquisition is now needed at the beginning of your application so that if data read is done within a loop, this query is not repeated. To get the read access, the code line would be as such: % Get read acquisition [~, ~] = Interface.getReadAccess(); 
  2. Changed all 'double' to 'single' in the API & examples. 
  3. Improved errors handling. 
  4. Included many changes mentioned in the C++ API DLL v1.5.2 release. 
  5. Examples have been updated to reflect the changes. 

5 Known Issues and Limitations 


Download MATLAB API v4.1.1

View release notes