ThinkRF R5500 Programmer's Manual
Real-time spectrum analyzer
Hide thumbs
Also See for R5500:
- Programmer's manual (107 pages) ,
- Programmer's manual (95 pages) ,
- Quick start manual (12 pages)
Table of Contents
Advertisement
Quick Links
ThinkRF R5500/R5550
Real-Time Spectrum Analyzer
Programmer's Guide
Version 4.4.1
April 26, 2020
Document no. 75-0025-200426
Copyright © 2015-2020 ThinkRF Corporation, all rights reserved.
All product names are trademarks of their respective companies.
This document contains information that is proprietary to ThinkRF Corporation.
Advertisement
Table of Contents
Related Manuals for ThinkRF R5500
Summary of Contents for ThinkRF R5500
- Page 1 Real-Time Spectrum Analyzer Programmer's Guide Version 4.4.1 April 26, 2020 Document no. 75-0025-200426 Copyright © 2015-2020 ThinkRF Corporation, all rights reserved. All product names are trademarks of their respective companies. This document contains information that is proprietary to ThinkRF Corporation.
- Page 2 Customer. ThinkRF will warrant repaired units for a period of 90 days from date of mechanical, recording, shipment from ThinkRF to the Customer. If the remaining period on the original...
-
Page 3: Table Of Contents
Conventions ..........................10 Obtaining Documentation and Releases ................10 Document Feedback ......................11 Obtaining Technical Assistance ..................11 R5500/R5550 Functional Overview ..................12 System Overview ........................12 The Architecture ........................15 RF Receiver Front-End ......................17 Direct-Conversion Receiver Technology ................18 DC Offset Correction ..................... - Page 4 SCPI Command Set ........................43 SCPI Language Overview ..................... 43 IEEE Mandated SCPI Commands ..................44 *CLS ............................ 44 *ESE/*ESE? ........................44 *ESR? ..........................45 *IDN? ........................... 45 *OPC/*OPC? ........................45 *RST ............................ 45 *SRE/*SRE? ........................46 *STB? ..........................46 *TST? ..........................
- Page 5 :INPut:GAIN ......................... 65 :INPut:GAIN:HDR ........................ 66 :INPut:MODE ........................66 SOURce Commands ......................67 :SOURce:REFerence:PLL ....................67 SENSe Commands ......................... 67 [:SENSe]:DECimation ......................67 [:SENSe]:FREQuency:CENTer ................... 68 [:SENSe]:FREQuency:IF? ....................69 [:SENSe]:FREQuency:INVersion? ..................69 [:SENSe]:FREQuency:LOSCillator? ..................70 [:SENSe]:FREQuency:SHIFt ....................70 [:SENSe]:LOCK:REFerence? ....................71 [:SENSe]:LOCK:RF? ......................
- Page 6 .......................... 97 Error and Event Queue ......................97 Appendix E: SCPI Error Codes Used ................98 Appendix F: SCPI Commands Quick Reference ............99 WSA5000 vs. R5500/R5550 List of Changes ............... 105 References ............................. 106 Document Revision History ....................107...
-
Page 7: Abbreviations
Abbreviations Analog-to-Digital Converter Application Programming Interface Cascaded Integrator-Comb Direct Current Direct Digitizer Digital Down Converter Direct Digital Synthesizer Digital Signal Processing Fast Fourier Transform Finite Impulse Response FPGA Field-Programmable Gate Array GPIO General Purpose Input/Output Graphical User Interface High Dynamic Range High Intermediate Frequency Instantaneous Bandwidth IEEE... -
Page 8: List Of Figures
List of Figures Figure 1: R55x0 Functional Block Diagram ....................13 Figure 2: RF Receiver Front-end and Capture Controller Functional Block Diagram ....... 16 Figure 3: DC Offset with Amplitude Roll-Off at +50MHz ................18 Figure 4: IQ Offset Correction ........................19 Figure 5: DDC Functional Block Diagram .................... -
Page 9: List Of Tables
Table 7: The Categories of VRT Packet Streams Supported by ThinkRF's R55x0 ........28 Table 8: A List of Stream Identifiers as Used by ThinkRF for Different Packet Classes ......29 Table 9: Receiver Context Packet Class Structure .................. 30 Table 10: Receiver Context Indicator Field Positions ................ -
Page 10: Preface
Audience This document is written for software developers wishing to develop and/or maintain a software interface to the R5500/R5550 (R55x0 for short) and who have a basic understanding, familiarity and experience with network test and measurement equipment. Conventions This section describes the conventions used in this document. -
Page 11: Document Feedback
The ThinkRF Support website provides online documents for resolving technical issues with ThinkRF products at www.thinkrf.com/resources. For all customers who hold a valid end-user license, ThinkRF provides technical assistance 9 AM to 5 PM Eastern Time, Monday to Friday. Contact us at www.thinkrf.com/support/... -
Page 12: R5500/R5550 Functional Overview
R5500/R5550 Functional Overview R5500/R5550 Functional Overview This section overviews the R5500/5550's (R55x0 for short) functionality and protocols used, and summarizes the SCPI command sets for controlling the individual functions. Note: This is a living and evolving document. We welcome your feedback. -
Page 13: Figure 1: R55X0 Functional Block Diagram
R5500/R5550 Functional Overview Figure 1: R55x0 Functional Block Diagram ThinkRF's products conform with standardized protocols for interoperability. ThinkRF provides application programming interfaces (APIs) designed for easy integration with third-party applications. Standard protocols include the Standard Commands for Programmable Instruments (SCPI) protocol for controlling and obtaining status from the RTSA and the VITA-49 Radio Transport (VRT) protocol for digitized data and its associated context information. - Page 14 Presets the R55x0 (similar to *RST) :QUEStionable [:EVENt]? Queries the Questionable Status Register for any questionable event :CONDition? Queries the Questionable Condition Register for any questionable event :ENABle[?] Enables or queries bits in the Questionable Enable Register ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide...
-
Page 15: The Architecture
Traces and sweeps are controlled by the capture controller as illustrated in the Digitizer portion of Figure 2. A trace and a sweep are defined as a single (block or continuously streamed) capture and a series of captures, respectively, each with their associated hardware configurations. ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 16: Figure 2: Rf Receiver Front-End And Capture Controller Functional Block Diagram
Note: The GPS (GNSS) option is not included in R55x0) The R55x0 supports different RFE modes of operation and subsequent DSP capabilities as per Table 2 and as described in the following subsections. ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 17: Rf Receiver Front-End
The three signal processing paths are further classified into different modes of operation for the capture engine as shown in Table 2. The radio modes ZIF, SH, SHN and HDR support tuning the center frequency from 50MHz to the maximum frequency supported by ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 18: Direct-Conversion Receiver Technology
Figure 3: DC Offset with Amplitude Roll-Off at +50MHz If the application only needs to utilize up to 50MHz of IBW, a simple alternative to DC offset compensation is to use the SH mode of operation. ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 19: Iq Offset Correction
F r e q u e n c y Figure 4: IQ Offset Correction A correction algorithm would be needed to adjust this offset necessary for signal analysis, especially for the ZIF mode. The ThinkRF's APIs have included a correction. Table 3: RF Front-End Control/Status Commands SCPI Command... -
Page 20: Digital Signal Processing
IQ input using a complex multiplier, to shift or offset the signal spectrum from the selected carrier frequency. This process provides the frequency fine-tuning (and shifting) feature as mentioned in the previous subsections. ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 21: Triggers
The user defines a single amplitude level within a frequency range. The frequency range encompasses all FFT bins with center frequencies within the range defined by START ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 22: Periodic Triggering
(page 25) for additional details. Caution: The pulse and sync-word is applied to the GPIO's TRIG IN pin, while PPS is through PPS pin. Contact ThinkRF's Support for details on how to use the GPIO port prior to connecting anything to the port. -
Page 23: Capture Controller
"pushed" from the R55x0). Once it is issued, data packets will be sent instantly (conditional on triggering) and continuously on best effort basis (in other words, data might not be continuous from one packet to the next once the internal buffer is full). ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 24: Sweep Capture Control
Defines the number of times the list is repeated during execution :STARt Begins execution of the current sweep list from the first entry :STATus? Get the current sweep status :STOP Stops execution of the current sweep list ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 25: Synchronized Sweep
(:SWEep:ENTRy:TRIGger:TYPE PULSE | WORD). The synchronization trigger is generated and delivered from the master's GPIO to that of the slaves to indicate the beginning of a capture. ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 26: Figure 7: Synchronized Sweep Using Sync-Word
VRT Receiver Context packets. The rate of sweep versus the amount of missed captures may be balanced by adjusting the delay values. ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 27: Figure 8: Synchronized Sweep With A Missed Capture
Figure 8: Synchronized Sweep with a Missed Capture SWEep Commands section (page 78) for further interface details or contact ThinkRF's Support for more information. ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 28: Vita-49 Radio Transport Protocol
Extension Context Stream RECEIVER DIGITIZER IF Data Stream Figure 9: Connectivity and 4 Different Packet Streams Supported by R55x0 Table 7: The Categories of VRT Packet Streams Supported by ThinkRF's R55x0 Standard Formats Custom Formats Contents IF Context Packet Stream... -
Page 29: Packet Classes And Streams
Stream Identifiers used by ThinkRF for different Packet Class Stream. Each ID will be mentioned in the subsequent corresponding Packet Class sections. Table 8: A List of Stream Identifiers as Used by ThinkRF for Different Packet Classes Stream Identifier Packet Class... -
Page 30: Table 9: Receiver Context Packet Class Structure
Table 11: Receiver Context Field Definition and Values Indicator Context Field Type # of Words in Period of Bit Name Position Context Fields Validity Context Field Change Indicator RF Reference Frequency Persistent Gain Persistent ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 31: Context Field Change Indicator
Fractional RF Digitizer Context Packet Class This Packet Class is a type of IF Context Packet Class. The packet information conveys changes in the configuration and status of the R55x0's IF digitizer. ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 32: Table 14: Digitizer Context Packet Class Structure
Context Indicator Field. The fields shall be ordered in the identical order of their occurrence in the Context Indicator Field. Table 16 for the definition and associated value of each field. ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 33: Context Field Change Indicator
Fractional RF Reference Value(19..0) Reference Level The Reference Level provides a power level reference so that the magnitude of the received data can be calculated by a user. The reference level provided in the context ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 34: Extension Context Packet Class
Extension Context Packet Class This Packet Class conveys metadata concerning IF Data Packet Class that cannot be communicated in the IF Context Packet Class. See Table 20 for the organization of this context packet class. ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 35: Table 20: Extension Context Packet Class Structure
Context Indicator Field. The fields shall be ordered in the identical order of their occurrence in the Context Indicator Field. See Table 22 for the definition and associated value of each field. ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 36: Context Field Change Indicator
IQ gain and phase imbalances. The artifacts are compensated by using a specific correction algorithm, which incorporates both time- and frequency-domain corrections. Contact ThinkRF's Support if interested in further information on the algorithm and its usage. New Stream Start ID The New Stream Start ID indicator indicates a new stream capture has started, any packets following this Context Packet belong to this new stream capture. -
Page 37: New Sweep Start Id
1. Pkt Type shall be 0001, indicating that a stream identifier is present. 2. C shall be set to 0, indicating that there is no class identifier present. 3. T shall be set to 1, indicating there is a trailer word in the packet. ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 38: Picosecond Timestamp Words Format
2. The data payload shall consist of an integer number of contiguous 32-bit words. 3. IF Data Packets convey either the time domain in-phase (I or real) and/or quadrature (Q or imaginary) components forming the Complex Cartesian samples. } Data Payload Format ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 39: Table 30: {I } Data Payload Arrangement With Upper 2-Bit Signed Extended To {I
8. Each data word is one I-component as seen in Table 9. Each I data is a signed two's-complement 24-bit sample with signed extended into 32-bit. Thus, each component is an integer ranging from -8388608 to +8388607 (or ±2 ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 40: Trailer Word Format
7. The Reference Lock Indicator, when set to 1, shall indicate all PLLs in the system are locked and stable, and when set to 0, shall indicate one or all of the PLLs is not locked or unstable. It is very crucial to check this indicator bit. ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 41: Table 35: Conditions Causing Abnormal Indicator State And Suggested Resolution
For WB ADC, the over- - If :ATTentuator is already on, range threshold is at Vpeak = reduce the input level or the 1.0 V; and for NB ADC, Vpeak gain settings. = 1.6 V. ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 42: Figure 10: An Example Illustrating Uninverted And Inverted Spectrums
Use a decimation value such Loss Stream mode when the internal that the transfer rate matches buffer is full. that of the capture rate. Figure 10: An Example Illustrating Uninverted and Inverted Spectrums ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 43: Scpi Language Overview
SCPI Command Set SCPI Command Set This section is a SCPI reference guide for controlling the ThinkRF R55x0 Real Time Spectrum Analyzer. The R55x0 supports the Standard Commands for Programmable Instruments (SCPI) standard version 1999.0 as described in the following sections. SCPI lends itself to a command line interface and scripting, is supported by the major instrument vendors and provides a high level of familiarity for instrument users. -
Page 44: Ieee Mandated Scpi Commands
*ESE? query returns the decimal sum of the enabled bits in the ESE register. The decimal sum is the binary equivalent of the 8-bit mask. See Figure for the ESE/ESR register bits mapping. Syntax *ESE <integer> *ESE? Parameter/Response 0 - 255 I/O Data Type <integer> ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 45: Esr
Syntax *OPC *OPC? Parameter None Query Response *RST Resets the R55x0 to its default settings. This includes stopping any running capture mode and trigger mode, and also performs :SYSTem:FLUSh. ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 46: Sre/*Sre
Query Response <integer> *TST? *TST? (self-test) query initiates the device's internal self-test and returns one of the following results: 0 - all tests passed. • 1 - one or more tests failed. • ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 47: Wai
When stream or sweep mode is stopped, block mode will resume. Syntax :SYSTem:CAPTure:MODE? Parameter None Query Response BLOCK | STREAMING | SWEEPING Output Data Type <character> *RST State BLOCK :SYST:CAPTURE:MODE? Example ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 48: System:communicate:hislip:session
DHCP. To set the box back to DHCP from a working STATIC mode, use this command or the web-browser as mentioned in the RTSA User's Guide. Syntax SYSTem:COMMunicate:LAN:CONFigure DHCP | STATIC ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 49: System:communicate:lan:dns
RTSA's LAN interface. Syntax SYSTem:COMMunicate:LAN:DNS <main DNS>[,alternative DNS] SYSTem:COMMunicate:LAN:DNS? [CURRENT] Parameter Input: D.D.D.D[,D.D.D.D] where D = 0 – 255 Query: [CURRENT] Query Response D.D.D.D[,D.D.D.D] I/O Data Type <string> *RST State ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 50: System:communicate:lan:ip
Syntax SYSTem:COMMunicate:LAN:IP <IPv4 address> SYSTem:COMMunicate:LAN:IP? [CURRENT] Parameter Input: D.D.D.D where D = 0 – 255 Query: [CURRENT] Query Response D.D.D.D I/O Data Type <string> *RST State Examples SYST:COMM:LAN:IP 101.125.1.16 SYSTEM:COMM:LAN:IP? SYST:COMM:LAN:IP? CURRENT ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 51: System:communicate:lan:netmask
RTSA's LAN interface. Syntax SYSTem:COMMunicate:LAN:NETMask <address> SYSTem:COMMunicate:LAN:NETMask? [CURRENT] Parameter Input: D.D.D.D where D = 0 – 255 Query: [CURRENT] Query Response D.D.D.D I/O Data Type <string> *RST State Examples SYST:COMM:LAN:NETMASK 255.255.255.0 SYSTEM:COMMUNICATE:LAN:NETM? SYST:COMM:LAN:NETM? CURRENT ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 52: System:error[:Next]
This query returns all the uncleared error codes and messages from the SCPI error/event queue. If there are no error messages, the query returns 0,"No error". *RST does not affect the error queue. ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 53: System:error:code:all
Output Data Type Comma separated <NR1> Description Refer to the Appendix E: SCPI Error Codes Used section *RST State :SYST:ERR:CODE:ALL? Example :SYSTem:ERRor:COUNt? This query returns the number of errors/events in the error/event queue. ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 54: System:lock:have
Syntax :SYSTem:LOCK:HAVE? ACQuisition Parameter ACQuisition Input Data Type <character> Query Response 1 | 0 1 – Have the lock 0 – Does not have the lock Output Data Type <boolean> *RST State ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 55: System:options
Syntax :SYSTem:LOCK:REQuest? ACQuisition Parameter ACQuisition Input Data Type <character> Query Response 1 | 0 1 – Successfully locked 0 – Failed to lock Output Data Type <boolean> *RST State Example :SYST:LOCK:REQ? ACQ ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 56: System:sync:master
Model :OUTput:MODE is defaulted to DIGitizer WBIQ are special R55x0 model variants, not available on all R55x0s. Contact ThinkRF for more details on the usage of this variant. :SYSTem:SYNC:MASTer This command sets the RTSA unit to be the master or slave for a synchronization trigger system with multiple units, in which only one unit can be the master. -
Page 57: System:time
DISable automatically. The time returned is representative of the current time mode that is UTC. This command is not affected by a power-on, factory reset, or *RST command. Syntax :SYSTem:TIME <integer>,<integer>,<integer>[,<integer>] :SYSTem:TIME? Parameters <hour>,<minute>,<second>[,<millisecond>] ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 58: System:time:sync
:SYSTem:TIME:SYNC DISable | NTP,{ONCE | CONTinuous} :SYSTem:TIME:SYNC? Parameter DISable | NTP,{ONCE | CONTinuous} Query Response DISabled | NTP,{ONCE | CONTinuous} I/O Data Type <character> | Comma separated <characters> *RST State DISable Examples :SYST:TIME:SYNC NTP,ONCE :SYST:TIME:SYNC DISABLE :SYSTEM:TIME:SYNC? ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 59: Status Commands
IEEE 488.2. These registers conform to the IEEE 488.2 specification and each may be comprised of a condition register, an event register, an enable register, and negative and positive transition filters. ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 60: Status:operation[:Event]
The data in this register is continuously updated to reflect the most current conditions. See Figure for the Operation Condition Register bits mapping. Syntax :STATus:OPERation:CONDition? Parameter None Query Response 0 – 32767 (2 Output Data Type <integer> *RST State None Example :STAT:OPER:COND? ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 61: Status:operation:enable
Bits enabled in OPTR will allow a positive transition in the corresponding condition to set the bit in the OSR (see page 96). Syntax :STATus:OPERation:PTRansition <integer> :STATus:OPERation:PTRansition? Parameter/Response 0 – 32767 (2 I/O Data Type <integer> *RST State Examples :STAT:OPER:PTR 256 :STAT:OPER:PTR? ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 62: Status:preset
See Figure for the QCR bits mapping. Syntax :STATus:QUEStionable:CONDition? Parameter None Query Response 0 – 32767 (2 Output Data Type <integer> *RST State None :STAT:QUES:COND? Example ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 63: Status:questionable:enable
Bits enabled in QPTR will allow a positive transition in the corresponding condition to set the bit in the QSR (see page 96). Syntax :STATus:QUEStionable:PTRansition <integer> :STATus:QUEStionable:PTRansition? Parameter/Response 0 – 32767 (2 I/O Data Type <integer> *RST State Examples :STAT:QUES:PTR 256 :STAT:QUES:PTR? ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 64: Status:temperature
Notes: - This command applies to R55x0-418, -427, and their variants only. For R55x0-408 and their variants, see :INPut:ATTenuator command instead. - Recommend setting the attenuation to 0 dB for best performance ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 65: Input:gain
1 (ON) Not Optimal* 1 (ON) 0 (OFF) Medium Good DANL and Saturation Level 1 (ON) 1 (ON) High Best DANL (Reference Level context data provided) * This setting is not recommended. ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 66: Input:gain:hdr
ZIF | DD | HDR | SH | SHN I/O Data Type <character> *RST State Product version dependent Also see the Caution note of the *RST command if DD mode is used ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 67: Source Commands
FIR filter with a fixed decimation of 2 to arrive at the rate set. For example, for a rate of 16, I and Q data will first pass-through the CIC filters with a decimation rate ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 68: [:Sense]:Frequency:center
In addition, depending on the product models, the allowable range of programmable frequencies varies. Check with your product's data sheet. For example, R55x0-408 has a range of 0.1 to 8GHz, while R55x0-427 has 0.1 to 27GHz. ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 69: [:Sense]:Frequency:if
The results can than be stored in a look-up table, for example. Also, this command does not apply with HDR path of the RFE modes. ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 70: [:Sense]:Frequency:loscillator
[:SENSe]:FREQuency:SHIFt <NRf [unit]> [:SENSe]:FREQuency:SHIFt? [MAX | MIN] Parameters <Frequency [unit]> Input Data Type <NRf> [<character>] Allowable Values -62.5 – 62.5 MHz Query Response Shifted frequency Output Data Type <integer> Default I/O Unit *RST State ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 71: [:Sense]:Lock:reference
+ all commands affecting the digitizer data path of the R55x0 will not apply, these include TRACe Commands, level triggering (:TRIGger:LEVel) and digital signal processing ([:SENSe]:DECimation or :SWEep:ENTRy:DECimation, [:SENSe]:FREQuency:SHIFt and :SWEep:ENTRy:FREQuency:SHIFt). + no VRT context packets will be sent out from the RTSA. ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 72: Trigger Commands
Table 35 is required depending on the frequency input. The spectral inversion indicator is available through the GPIO port. Contact ThinkRF's Support for further details. - The CONNector mode only works on certain R55x0 model. Verify that your product supports this method. -
Page 73: Trigger:level
Level: Signed integer [<character>] Allowable Values Frequency: See [:SENSe]:FREQuency:CENTer Levels: Dependent on the attenuation setting. See Table Output Data Type <integer>,<integer>,<signed integer> Default I/O Units Hz,Hz,dBm *RST State N/A (Trigger is off) ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 74: Trigger:periodic
Data Payload Format, page 38. ThinkRF's R55x0 data packet returned through a network is complied with the industry standard VRT protocol. Therefore, every data packet returned is encapsulated with a VRT header and a VRT trailer. In addition, the VRT packet format sets a limit on the maximum number of samples per packet. -
Page 75: Trace:block:packets
Input: <Packet value> Query: [MAX | MIN] Input Data Type <integer> | <character> Allowable Values 1 – (RTSA's maximum storage capacity ÷ (# bytes-per-sample * (SPP value + 6 Header and trailer words))) ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 76: Trace:sppacket
:TRACe:STReam:STARt This command begins the execution of the real time stream capture. It will also initiate data capturing. Data packets will be streamed (or pushed) from the R55x0 whenever data is available. ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 77: Trace:stream:stop
+ If you write your own application without using ThinkRF’s APIs, a network socket clean-up of remnant packets remained in the network is a must. This could be done by using a loop to read the header of each packet to determine how many bytes to read;... -
Page 78: Sweep Commands
- Unlike :TRACe:BLOCk capture, sweep mode data packets, whether VRT context or digitized data, are “streamed” (similar to :TRACe:STReam). As soon as ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 79: Sweep:list:iterations
When no ID value is provided, the default ID value 0 is returned in the Context Packet. Syntax :SWEep:LIST:STARt [ID] Parameter <List ID> Input Data Type Unsigned 32-bit integer Query Response None *RST State 0 (Sweep stopped) Examples :SWEEP:LIST:STAR :SWE:LIST:START ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 80: Sweep:list:status
<Sweep entry integer index> Input Data Type Unsigned integer Allowable Values :SWEep:ENTRy:COUNt? returns non-zero, 1 to :COUNt? value :SWEep:ENTRy:COUNt? returns zero, an execution error is returned Query Response None *RST State :SWEEP:ENTR:COPY Examples :SWE:ENTRY:COPY ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 81: Sweep:entry:count
:SWEep:ENTRy:COUNt? query value Query Response <integer>,<{integer | character}> <RFE mode>,<freq start>,<freq stop>,<freq step>,<freq shift>, <decimation>,<attenuator>,<IF gain>,<HDR gain>,<SPPacket>, <packets>,<dwell:second>,<dwell:microsecond>, <trigger type: NONE | PULSe | WORD | <LEVel,freq start,freq stop, amplitude> | PPS> ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 82: Sweep:entry:save
:SWEep:ENTRy:ATTenuator:VARiable Refers to the :INPut:ATTenuator:VARiable section (page 64) for the definition of this command. Examples :SWEEP:ENTRY:ATT:VAR 10 :SWEEP:ENTR:ATT:VAR? :SWEep:ENTRy:DECimation Refers to the [:SENSe]:DECimation section (page 67) for the definition of this command. ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 83: Sweep:entry:frequency:center
Query Response <integer> Default I/O Units *RST State 100000000 Examples :SWEEP:ENTRY:FREQ:STEP 10.5 MHZ :SWE:ENTRY:FREQ:STEP 4000 KHZ :SWEEP:ENTR:FREQ:STEP 10000000 :SWEEP:ENTR:FREQ:STEP? :SWEep:ENTRy:FREQuency:SHIFt Refers to the [:SENSe]:FREQuency:SHIFt section (page 70) for the definition of this command. ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 84: Sweep:entry:gain:hdr
:TRACe:BLOCk:PACKets command since at each sweep frequency step of an entry, a block of data can be captured. Refers to the :TRACe:BLOCk:PACKets section (page 75) for the definition of this command. ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 85: Sweep:entry:sppacket
PPS (or pulse range) time frame, the sweep step tuning time, and the decimation rate. For safe measure, it should be less than 500 ms for PPS type. A large capture size could cause missing the pulse. Examples :SWEEP:ENTR:TRIG:TYPE LEVEL :SWEEP:ENTRY:TRIG:TYPE? ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 86: Appendix A: Connecting To Rtsa
Appendix A: Connecting to RTSA Appendix A: Connecting to RTSA ThinkRF RTSA supports two different methods of device connection, which will be explained in the following sections. Caution pertaining to multi-users: ThinkRF RTSA allows multiple applications to connect to a unit simultaneously or concurrently, however, each connection method mentioned in this section will behave differently. -
Page 87: Connection Using Hislip
RTSA, both <IP>:37001 and <IP>:37000 sockets must be created one right after the other. The order is important. In addition, refer to the “Connecting to the R55x0” of the R5500 User Guide (v4.0 or higher) or R5550 User Guide for more information on how to connect to R55x0 and to determine its IP address. -
Page 88: Figure 15: Hislip And Tcp Connections To Rtsa
HiSLIP message format. All values are in network order (big-endian). Table 40: HiSLIP Message Header Format Field Octets Field Offset Prologue (ASCII “HS”) Message Type Control Code Message Parameter Payload Length Data (optional) Payload Length ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 89: Table 41: Thinkrf Vendor Specific Message Type Value Definitions
This message pair used to establish the data channel is modeled after the HiSLIP AsyncInitialize and AsyncInitializeResponse messages used to establish the asynchronous channel on port 4880. Table 41: ThinkRF Vendor Specific Message Type Value Definitions Designation Channel Numerical Value... -
Page 90: Appendix B: Protocols For Discovering Rtsa
RTSAs on a different network. Discovery Using mDNS/DNS-SD Note: This method of discovery only applies to R5500 with firmware version 1.5.0 or higher and R5550 with firmware 1.6.1 or higher, and is a recommended method. Firmware update may be downloaded from www.thinkrf.com/download-updates/. - Page 91 The IP address of an RTSA can be retrieved from the responding socket. The RTSA may be identified by matching the serial number (S/N) in the response message with the S/N on the label of the RTSA. ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide...
-
Page 92: Appendix C: Scpi Command Syntax
Note: At the end of each SCPI command string, whether a single command or multiple commands separated by semicolons “;”, a new line-feed or carriage return is required. Example in C: “:FREQ:CENTER 2400 MHZ\n” or “FREQ:CENT 2400 MHZ;INP:ATT 0\n”. ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 93: Notation
Ex: MAXimum or MEDium <string> ASCII string surrounded by single or double quotes Ex: “This is an example” Default Units Parameter Default Unit frequency time s or ns where applicable voltage absolute amplitude relative amplitude ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... - Page 94 Note the following examples, which are all equivalent. Example :FREQ:CENTer 2441.5 MHz is equivalent to :FREQ:CENTer 2441500000 :FREQ:CENTer 2441500000 Hz is equivalent to :FREQ:CENTer 2441500 kHz is equivalent to :FREQ:CENTer 2441.5e6 is equivalent to ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide...
-
Page 95: Appendix D: Scpi Status And Event Registers
Request Control (RQC) This bit is not used and always 0. Query Error (QYE) Set to indicate that a query has been made for which no response is available. ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 96: Operational Status Register (Osr)
Questionable Status Register (QSR) The QSR is a 16-bit register that is used to indicate conditions that may cause the measurement results to be of questionable quality. It is read by issuing a :STATus:QUEStionable[:EVENt]? command. ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 97: Output Queue
The R55x0 has an Error and Event FIFO Queue that holds up to 16 errors and events. It is queried using the :SYSTem:ERRor[:NEXT]? command. The *CLS command clears all entries from the queue. ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 98: Appendix E: Scpi Error Codes Used
Read trace command issued while there is no data available. -911 Need firmware upgrade The current firmware needs upgrading. -912 Invalid option license The option could not be installed because of invalid license. ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 99: Appendix F: Scpi Commands Quick Reference
ZIF | DD | HDR | SH | SHN Select the receiver mode of operation. v1.0 – ZIF, See the complete command description section SH, SHN, DD for special notes. v1.3 – HDR :MODE? :OUTput Page ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... - Page 100 :QTRansition Enables bits in the Operation Positive Transition v1.5.0 Register :QTRansition? :PRESET Presets the R55x0 (similar to *RST) v1.0 :QUEStionable [:EVENt]? Return the standard Questionable Status v1.0 Register (QSR) for any event ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide...
- Page 101 As defined in [:SENSe]:FREQuency:SHIFt, page v1.0 :SHIFt? v1.0 :STEP <NRf [unit]> Set the amount of frequency that the center v1.0 frequency is stepped by :STEP? :GAIN :HDR As defined in :INPut:GAIN:HDR, page v1.3 ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide...
-
Page 102: Level
Set the RTSA's LAN Gateway address v1.0 :GATEway? [CURRENT] <IPv4 address> Set the new IPv4 address for the RTSA's LAN v1.0 :IP? [CURRENT] :MTU <MTU value> Set the MTU value between 256 and 1500, v1.4.6 inclusive ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... - Page 103 Adjust the system time relative to its current time DISable | NTP,{ONCE | :SYNC Select the synchronization source and mode v1.4 CONTinuous} :SYNC? v1.4 :STATus? Return the status of the time synchronization ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide...
- Page 104 Set the time period of a periodic trigger :PERiodic? :TYPE LEVel | PERiodic | PPS | Set or disables the trigger type v1.0 – PULSE PULSe | WORD | NONE | WORD | NONE v1.4 – LEVel | :TYPE? ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide...
-
Page 105: Wsa5000 Vs. R5500/R5550 List Of Changes
HIF and IQIN option. The HIF option is now in :OUTput:MODE as HIF is made available in all R5500 models, and the IQIN option is no longer supported. + :GAIN – Change in the gain stage 'index' values for different models... -
Page 106: References
2. "VITA Radio Transport (VRT) Draft Standard" VITA-49.0 – 2007, VITA Standard Organization, 31 October 2007, Draft 0.21, http://www.vita.com/ "IEEE Standard Codes, Formats, Protocols, and Common Commands", ANSI/IEEE Standard 488.2-1992, http://ieeexplore.ieee.org/xpl/freeabs_all.jsp? tp=&isnumber=5581&arnumber=213762&punumber=2839 ThinkRF R5500/R5550 Real Time Spectrum Analyzer Programmer's Guide... -
Page 107: Document Revision History
Mar 31, 2017 - Enabled :SYSTem:DATE, :SYSTem:TIME, and :SYSTem:TIME:SYNC, and added :SYSTem:COMMunicate:NTP commands used for updating or correcting an R5500's date and/or time - Added PPS type to :TRIGger:TYPE v4.1.1 Apr 10, 2017 - Updated “Allowable Values” for... - Page 108 + Bit 9 Questionable Status Register (QSR) to be position indicator for GPS-equipped RTSAs v4.4.0 Jun 03, 2019 - Changed R5500 to R55x0 to refer to R5500 and R5550 products - Corrected & added new information to Table 2 - Updated :TRIGger:LEVel...
Need help?
Do you have a question about the R5500 and is the answer not in the manual?
Questions and answers