Release Notes: RSA API (Application Programming Interface) for 32-bit Windows

-------------------------------------------------------------------------------
Version 3.9.0029 Date: September 30, 2016
-------------------------------------------------------------------------------

This release note summarizes new features, improvements and bug fixes contained
in the above software release.

The RSA API is a Windows C/C++ DLL that provides direct access to the RSA300/500/600 devices.
It enables full control of these RSA devices and provides several forms of data and measurements
to support custom applications independent of SignalVu-PC.

The current software for the RSA API is available at www.tektronix.com

Version 3.9.0029 adds the following functions.

Added the following API functions to control and query the Frequency Reference configuration and the Time Reference system when GNSS
is used to align it for high-precision timing.

CONFIG_SetFrequencyReferenceSource
CONFIG_GetFrequencyReferenceSource
CONFIG_SetModeGnssFreqRefCorrection
CONFIG_GetModeGnssFreqRefCorrection
CONFIG_GetStatusGnssFreqRefCorrection
CONFIG_SetEnableGnssTimeRefAlign
CONFIG_GetEnableGnssTimeRefAlign
CONFIG_GetStatusGnssTimeRefAlign
CONFIG_SetFreqRefUserSetting
CONFIG_GetFreqRefUserSetting
CONFIG_DecodeFreqRefUserSettingString
GNSS_GetStatusRxLock
REFTIME_GetReferenceTimeSource


Bug fixes and other enhancements
--------------------------------
- IQBLK_GetMaxIQRecordLength() now returns the correct max number of available IQ samples for the current IQ bandwidth.
- Corrected Windows declspec(import/export) decorations for API function declarations.

Known Issues
------------
=====
Note: Before installing this new version of the RSA API please manually uninstall any previously installed version prior to 3.6.0043.
=====

Documentation
-------------
The API Programming Reference manual is available on www.tektronix.com.


-------------------------------------------------------------------------------
Version 3.7.0567 Date: May 27, 2016
-------------------------------------------------------------------------------

This release note summarizes new features, improvements and bug fixes contained
in the above software release.

The RSA API is a Windows C/C++ DLL that provides direct access to the RSA300/500/600 devices.
It enables full control of these RSA devices and provides several forms of data and measurements
to support custom applications independent of SignalVu-PC.

The current software for the RSA API is available at www.tektronix.com

Version 3.7.0567 adds the following functions.

Maintenance release - no new functions.


Bug fixes and other enhancements
--------------------------------
- Removed occasional phase noise transients on RSA500/RSA600.
- Improved reliability of RSA500/RSA600 alignment and product manufacturability.


Known Issues
------------
=====
Note: Before installing this new version of the RSA API please manually uninstall any previously installed version prior to 3.6.0043.
=====

Documentation
-------------
The API Programming Reference manual is available on www.tektronix.com.


-------------------------------------------------------------------------------
Version 3.7.0561 Date: March 22, 2016
-------------------------------------------------------------------------------

This release note summarizes new features, improvements and bug fixes contained
in the above software release.

The RSA API is a Windows C/C++ DLL that provides direct access to the RSA300/500/600 devices.
It enables full control of these RSA devices and provides several forms of data and measurements
to support custom applications independent of SignalVu-PC.

The current software for the RSA API is available at www.tektronix.com

Version 3.7.0561 adds the following functions.

Added support for models RSA306B, RSA503A, RSA507A, RSA603A, RSA607A.
Rework/update of the entire API. Compatability with the previous API is maintained where possible.
For details see the version compatibility section of the RSA API reference manual.


Bug fixes and other enhancements
--------------------------------


Known Issues
------------
=====
Note: Before installing this new version of the RSA API please manually uninstall any previously installed version prior to 3.6.0043.
=====

Documentation
-------------
The API Programming Reference manual is available on www.tektronix.com.


-------------------------------------------------------------------------------
Version 3.6.0043 Date: May 15, 2015
-------------------------------------------------------------------------------

This release note summarizes new features, improvements and bug fixes contained
in the above software release.

The RSA306 API is a Windows C/C++ DLL that provides direct access to the RSA306. It enables full control of the RSA306
and provides several forms of data and measurements to support custom applications independent of SignalVu-PC.

The current software for the RSA306 API is available at www.tektronix.com

Version 3.6.0043 adds the following functions.

Spectrum traces up to the full span of the instrument.
Streaming IQ data in 5 MHz, 10 MHz, 20 MHz or 40 MHz bandwidth.
32-bit version of the API is now available.


Bug fixes and other enhancements
--------------------------------
- Improved audio output performance to better reject signals at CF+/-8MHz.
- Added new API function to return calibration data version information:
RSA300_API_DLL ReturnStatus GetCalibConstantFilesVersion(char *calibConstNames[], char *versions[], int *numFiles);
- Fixed buffer sizing control in AUDIO_GetData() to prevent potential buffer overwrite.


Known Issues
------------
- RSA306 USB driver may not be installed correctly if confirmation prompts are not accepted.
Workaround: Accept all prompts to confirm RSA306 USB driver installation.
- Search() returns the same Serial Number for all RSA306 devices connected to the host PC.
Workaround: Connect only 1 RSA306 to the host PC.
- GetIQBandwidth() returns the IQ bandwidth requested by SetIQBandwidth(), not the actual IQ Bandwidth
in use, which may be considerably wider than requested.
Workaround: Calculate the IQ Bandwidth as the smallest value of 40 MHz/(2^n) which is equal or larger than the requested BW.
- GetIQSampleRate() is not valid until Run() is executed with current settings.
Workaround: To determine how many data samples are needed for a requested time record, the IQ Bandwidth must be set
then Run() and Stop() called. Then use GetIQSampleRate() and finally SetIQRecordLength() to set the actual desired rec length.
- GetMaxAquisitionSamples() always returns 56e6 (actually 54*1024*1024). This is not correct for acquisition BW's other than 40MHz.
Workaround: None.
- SetIQBandwidth() and GetIQBandwidth() allow bandwidth values greater than 40MHz, which are actually invalid.
Workaround: Do not set IQ bandwidth greater than 40MHz.


Documentation
-------------

The RSA306 API Programming Reference manual has been updated to include new commands and functions.
The API Programming Reference manual is available on www.tektronix.com.