Table of Contents
Advertisement
Quick Links
ThinkRF R5700/R5750
Real-Time Spectrum Analyzer
with GNSS
Programmer's Guide
Version 1.2.5
Oct 22, 2021
Document no. 75-0033-211022
Copyright © 2018-present 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 R5700
Summary of Contents for ThinkRF R5700
- Page 1 Real-Time Spectrum Analyzer with GNSS Programmer's Guide Version 1.2.5 Oct 22, 2021 Document no. 75-0033-211022 Copyright © 2018-present 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
Table of Contents Abbreviations ........................... 7 List of Figures ..........................8 List of Tables ............................ 9 Preface ............................... 10 Audience ........................... 10 Conventions ..........................10 Obtaining Documentation and Releases ................10 Document Feedback ......................11 Obtaining Technical Assistance ..................11 R57x0 Functional Overview .................... - Page 4 Picosecond Timestamp Words Format ................39 Data Payload Format ..................... 39 Trailer Word Format ...................... 40 SCPI Command Set ........................43 SCPI Language Overview ..................... 43 IEEE Mandated SCPI Commands ..................44 *CLS ............................ 44 *ESE/*ESE? ........................44 *ESR? ..........................45 *IDN? ...........................
- Page 5 :STATus:QUEStionable:NTRansition .................. 63 :STATus:QUEStionable:PTRansition ................... 63 :STATus:TEMPerature? ...................... 64 INPut Commands ........................64 :INPut:ATTenuator ....................... 64 :INPut:ATTenuator:VARiable ....................65 :INPut:GAIN ......................... 65 :INPut:GAIN:HDR ........................ 66 :INPut:MODE ........................66 SOURce Commands ......................67 :SOURce:REFerence:PLL ....................67 :SOURce:REFerence:PPS ....................68 SENSe Commands .........................
- Page 6 :SWEep:ENTRy:GAIN:HDR ....................88 :SWEep:ENTRy:MODE ....................... 88 :SWEep:ENTRy:DWELl ....................... 88 :SWEep:ENTRy:PPBlock ....................89 :SWEep:ENTRy:SPPacket ....................89 :SWEep:ENTRy:TRIGger:LEVel ..................89 :SWEep:ENTRy:TRIGger:TYPE ..................89 Appendix A: Connecting to RTSA ..................90 Simple 2-port TCP/IP Connection ..................90 Connection Using HiSLIP ..................... 91 Appendix B: Protocols for Discovering RTSA .............
-
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 GNSS Global Navigation Satellite System GPIO General Purpose Input/Output Global Positioning System Graphical User Interface High Dynamic Range... -
Page 8: List Of Figures
List of Figures Figure 1: R57x0 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 R57x0 ........27 Table 8: A List of Stream Identifiers as Used by ThinkRF for Different Packet Classes ......28 Table 9: Receiver Context Packet Class Structure .................. 29 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 R5700/R5750 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: R57X0 Functional Overview
(unless specified though unlikely). System Overview The R5700/R5750 (or R57x0 for short) Real Time Spectrum Analyzer (RTSA) with GNSS (Global Navigation Satellite System) provides the benefits of a high-performance software-defined RF receiver, digitizer and analyzer along with integrated GNSS technology offering location and time information in one package. -
Page 13: Figure 1: R57X0 Functional Block Diagram
(GPIO) port. • Figure 1: R57x0 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... - Page 14 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 :NTRansition[?] Enables or queries bits in the Questionable Negative Transition Register ThinkRF R5700/R5750 Real Time Spectrum Analyzer Programmer's Guide...
-
Page 15: The Architecture
Besides two existing internal and external 10 MHz reference clock sources, the GNSS module also provides a third 10MHz reference clock source option to provide synchronized time-stamp for VRT packets (see SOURce Commands). ThinkRF R57x0 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 included in R57x0, but no I/Q Out and HIF) The R57x0 supports different RFE modes of operation and subsequent DSP capabilities as per Table 2 and as described in the following subsections. ThinkRF R5700/R5750 Real Time Spectrum Analyzer Programmer's Guide... -
Page 17: Rf Receiver Front-End
(ex. 8GHz, 18GHz, and 27GHz for R57x0-408, -418, and - 427, respectively). The ZIF, SH and SHN radio modes support a tuning resolution of 10Hz. Digital frequency shifting is then used to enhance the tuning resolution to the nearest 1Hz ThinkRF R57x0 Real Time Spectrum Analyzer Programmer’s Guide... -
Page 18: Direct-Conversion Receiver Technology
‘image’ at the same frequency offset from the center frequency as the tone itself. This is illustrated in Figure 4. ThinkRF R5700/R5750 Real Time Spectrum Analyzer Programmer's Guide... -
Page 19: Figure 4: 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
Note: The use of the NCO converts the in-phase signal (I data) input of the receiver's DD, SH and SHN processing paths to complex I and Q data output. See Table ThinkRF R5700/R5750 Real Time Spectrum Analyzer Programmer's Guide... -
Page 21: Triggers
The threshold level error is approximately ±3 dBm or less when the trigger level is set within the range mentioned in the :TRIGger:LEVel command. ThinkRF R57x0 Real Time Spectrum Analyzer Programmer’s Guide... -
Page 22: Periodic Triggering
A :TRACe command uses the configurations of the capture engine based on the root :INPut, :SENSe and :TRIGger commands. It does not use the configurations based on the :SWEep command subset. ThinkRF R5700/R5750 Real Time Spectrum Analyzer Programmer's Guide... -
Page 23: Trace Capture Control
A list may be edited, deleted and/or executed using the :SWEep:LIST command set. The :SWEep:ENTRy commands (see page onward) provide the ability to define the capture engine configurations equivalent to most of :INPut, :SENSe, :TRACe ThinkRF R57x0 Real Time Spectrum Analyzer Programmer’s Guide... -
Page 24: Table 6: Sweep Capture Control/Status Interface
Sets the maximum amount of time waited for a trigger to occur after which the trigger is aborted :PPBlock[?] Same as :TRACe:BLOCk:PACKets, page :SPPacket[?] As defined in :TRACe:SPPacket, page :TRIGger :TYPE[?] As defined in :TRIGger:TYPE, page :LEVel[?] As defined in :TRIGger:LEVel, page ThinkRF R5700/R5750 Real Time Spectrum Analyzer Programmer's Guide... -
Page 25: Synchronized Sweep
The host-side application that is collating the capture data may recognize the missed capture by noting the timestamps and/or frequency of the capture data within the ThinkRF R57x0 Real Time Spectrum Analyzer Programmer’s Guide... -
Page 26: Figure 8: Synchronized Sweep With A Missed Capture
Figure 8: Synchronized Sweep with a Missed Capture SWEep Commands section (page 82) for further interface details or contact ThinkRF's Support for more information. ThinkRF R5700/R5750 Real Time Spectrum Analyzer Programmer's Guide... -
Page 27: Vita-49 Radio Transport Protocol
Extension Context Stream RECEIVER DIGITIZER IF Data Stream Figure 9: Connectivity and 4 Different Packet Streams Supported by R57x0 Table 7: The Categories of VRT Packet Streams Supported by ThinkRF's R57x0 Standard Formats Custom Formats Contents IF Context Packet Stream... -
Page 28: 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 29: 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 R57x0 Real Time Spectrum Analyzer Programmer’s Guide... -
Page 30: 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 R57x0's IF digitizer. ThinkRF R5700/R5750 Real Time Spectrum Analyzer Programmer's Guide... -
Page 31: Table 14: Digitizer Context Packet Class Structure
Context Indicator Field. The fields are arranged in the identical order of their occurrence in the Context Indicator Field. See Table 16 for the definition and associated value of each field. ThinkRF R57x0 Real Time Spectrum Analyzer Programmer’s Guide... -
Page 32: Context Field Change Indicator
Fractional RF Frequency Offset (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 R5700/R5750 Real Time Spectrum Analyzer Programmer's Guide... -
Page 33: Formatted Gps Geolocation
GNSS, is used in this section to refer generically to Global Navigation Satellite Systems. The Formatted GPS Geolocation fields communicate the location and time of the RTSA. The fields use eleven 32-bit words format as shown in Table ThinkRF R57x0 Real Time Spectrum Analyzer Programmer’s Guide... -
Page 34: Table 20: Formatted Gps Geolocation Fields
-90.0 (South) to +90.0 (North) degrees. 7. The Longitude subfield uses the Geolocation Angle Format shown in Table 21 with value ranging from -180.0 (West) to +180.0 (East) degrees. ThinkRF R5700/R5750 Real Time Spectrum Analyzer Programmer's Guide... -
Page 35: Extension Context Packet Class
Context Indicator Field (1 word) Context Fields (Variable Size) 1. Pkt Type is 0101 to indicate this is an extension packet. 2. C is 0 to indicate there is no Class Identifier in the packet. ThinkRF R57x0 Real Time Spectrum Analyzer Programmer’s Guide... -
Page 36: Context Field Change Indicator
The Field value occupies 1-bit location as shown in Table 27. When the indicator’s Field value is 1, the channels are swapped and 0 if not. ThinkRF R5700/R5750 Real Time Spectrum Analyzer Programmer's Guide... -
Page 37: New Stream Start Id
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 38: Table 30: Output Data Width And Packing Method For Different Data Formats
Table 11. Data Payload contains the IF data from the R57x0, arranged in the format indicated in Table 34 Table 12. Trailer is included and arranged in the format described in Table ThinkRF R5700/R5750 Real Time Spectrum Analyzer Programmer's Guide... -
Page 39: Picosecond Timestamp Words Format
16-bit. Thus, each component is an integer ranging from -8192 to +8191 (or ±2 7. The first I sample is in the upper 16-bit of each data word follows by the second I sample in the lower 16-bit, as seen in Table ThinkRF R57x0 Real Time Spectrum Analyzer Programmer’s Guide... -
Page 40: Trailer Word Format
4. The E field is set to 0 to specify the Associated Context Packet Count field as undefined. 5. The Associated Context Packet Count field is unused and is set to 0. ThinkRF R5700/R5750 Real Time Spectrum Analyzer Programmer's Guide... -
Page 41: Table 38: Trailer Indicator And Enable Bits
The data between those two packets are not continuous and contiguous. Table 39 lists the conditions in which an indicator would signal an abnormal state and the suggested resolutions. ThinkRF R57x0 Real Time Spectrum Analyzer Programmer’s Guide... -
Page 42: Figure 10: An Example Illustrating Uninverted And Inverted Spectrums
Use a decimation value such that Loss Stream mode when the the transfer rate matches that of internal buffer is full. the capture rate. Figure 10: An Example Illustrating Uninverted and Inverted Spectrums ThinkRF R5700/R5750 Real Time Spectrum Analyzer Programmer's Guide... -
Page 43: Scpi Command Set
SCPI Command Set SCPI Command Set This section is a SCPI reference guide for controlling the ThinkRF R57x0 Real Time Spectrum Analyzer. The R57x0 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 R5700/R5750 Real Time Spectrum Analyzer Programmer's Guide... -
Page 45: Esr
Syntax *OPC *OPC? Parameter None Query Response *RST Resets the R57x0 to its default settings. This includes stopping any running capture mode and trigger mode, and also performs :SYSTem:FLUSh. ThinkRF R57x0 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 R5700/R5750 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 Example :SYST:CAPTURE:MODE? ThinkRF R57x0 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. ThinkRF R5700/R5750 Real Time Spectrum Analyzer Programmer's Guide... -
Page 49: System:communicate:lan:default
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 Comma separated IPs <string> *RST State ThinkRF R57x0 Real Time Spectrum Analyzer Programmer’s Guide... -
Page 50: System:communicate:lan:gateway
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 R5700/R5750 Real Time Spectrum Analyzer Programmer's Guide... -
Page 51: System:communicate:lan:mtu
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 SYST:COMM:LAN:NETMASK 255.255.255.0 Examples SYSTEM:COMMUNICATE:LAN:NETM? SYST:COMM:LAN:NETM? CURRENT ThinkRF R57x0 Real Time Spectrum Analyzer Programmer’s Guide... -
Page 52: System:communicate:ntp
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 R5700/R5750 Real Time Spectrum Analyzer Programmer's Guide... -
Page 53: System:error:code[:Next]
Output Data Type Comma separated <NR1> Description Refer to the Appendix E: SCPI Error Codes Used section *RST State Example :SYST:ERR:CODE:ALL? :SYSTem:ERRor:COUNt? This query returns the number of errors/events in the error/event queue. ThinkRF R57x0 Real Time Spectrum Analyzer Programmer’s Guide... -
Page 54: System:flush
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 :SYST:LOCK:HAVE? ACQ Examples ThinkRF R5700/R5750 Real Time Spectrum Analyzer Programmer's Guide... -
Page 55: System:lock:request
This command queries the hardware option(s) or features that a particular RTSA model supported. The response string contains comma separated 3-digit values to represent the options. See Table 40 for the translated list of available codes (when available). ThinkRF R57x0 Real Time Spectrum Analyzer Programmer’s Guide... -
Page 56: System:sync:master
:SYSTem:SYNC:WAIT <integer> :SYSTem:SYNC:WAIT? Parameter/Response 0 – 4294967295 (or 2 I/O Data Type <integer> *RST State :SYSTem:SYNC:WAIT 120 Examples :SYSTem:SYNC:WAIT? :SYSTem:VERSion? This query returns the SCPI version number that the instrument software complies with. ThinkRF R5700/R5750 Real Time Spectrum Analyzer Programmer's Guide... -
Page 57: System:date
<hour>,<minute>,<second>[,<millisecond>] in UTC I/O Data Type Comma separated <integers> Allowable Values Hour: 0 - 23 Minute: 0 - 59 Second: 0 – 59 Millisecond: 0 - 999 *RST State :SYST:TIME 10,30,15 Examples :SYSTEM:TIME? ThinkRF R57x0 Real Time Spectrum Analyzer Programmer’s Guide... -
Page 58: System:time:adjust
: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 :SYST:TIME:SYNC NTP,ONCE Examples :SYST:TIME:SYNC DISABLE :SYSTEM:TIME:SYNC? ThinkRF R5700/R5750 Real Time Spectrum Analyzer Programmer's Guide... -
Page 59: Status Commands
Figure 13: Status Reporting Structure with Status & Enable Registers The STATus commands control the SCPI-defined status-reporting structures as illustrated in Figure 13. Only the bolded bits are currently supported by R57x0 products. ThinkRF R57x0 Real Time Spectrum Analyzer Programmer’s Guide... -
Page 60: Status:operation[:Event]
16-bit mask. The last bit is unused. The content of the OCR remains unchanged after it is read. The data in this register is continuously updated to reflect the most current conditions. ThinkRF R5700/R5750 Real Time Spectrum Analyzer Programmer's Guide... -
Page 61: Status:operation:enable
(OPTR). The decimal integer value entered is the binary equivalent of the desired 16-bit mask to be enabled. Bits enabled in OPTR will allow a positive transition in the corresponding condition to set the bit in the OSR (see page 100). ThinkRF R57x0 Real Time Spectrum Analyzer Programmer’s Guide... -
Page 62: Status:preset
:STATus:QUEStionable:CONDition? could be used instead. :STATus:QUEStionable:CONDition? This command queries the standard Questionable Condition Register (QCR) for any questionable condition. The query returns the decimal sum of the bits set in the QCR. ThinkRF R5700/R5750 Real Time Spectrum Analyzer Programmer's Guide... -
Page 63: Status:questionable:enable
*RST State :STAT:QUES:NTR 256 Examples :STAT:QUES:NTR? :STATus:QUEStionable:PTRansition This command enables or queries bits in the Operation Positive Transition Register (QPTR). The decimal integer value entered is the binary equivalent of the desired 16-bit ThinkRF R57x0 Real Time Spectrum Analyzer Programmer’s Guide... -
Page 64: Status:temperature
The attenuation amount: 0 | 10 | 20 | 30 [dB] Input Data Type <integer>, optional <character> unit Query Response 0 | 10 | 20 | 30 Output Data Type <integer> *RST State Examples :INP:ATT 20 :INPUT:ATT? ThinkRF R5700/R5750 Real Time Spectrum Analyzer Programmer's Guide... -
Page 65: Input:attenuator:variable
Table 41 for the gain settings' performance Query Response 1 | 0 Output Data Type <boolean> *RST State 1 for all available stages :INPUT:GAIN 2 ON Examples :INP:GAIN? 1 :INP:GAIN 1 0 ThinkRF R57x0 Real Time Spectrum Analyzer Programmer’s Guide... -
Page 66: Input:gain:hdr
Query Response -10 – 34 Output Data Type <NR1> Default I/O unit *RST State :INPUT:GAIN:HDR -5 Examples :INP:GAIN:HDR 20 dB :INP:GAIN:HDR? :INPut:MODE This command sets or queries the R57x0's RFE mode of operation. ThinkRF R5700/R5750 Real Time Spectrum Analyzer Programmer's Guide... -
Page 67: Source Commands
INT is for the device’s internal 10 MHz source EXT is for the external 10 MHz source coming from the device’s 10 MHz IN port GNSS is for using the device’s 10 MHzGNSS reference source I/O Data Type <character> ThinkRF R57x0 Real Time Spectrum Analyzer Programmer’s Guide... -
Page 68: Source:reference:pps
The filters are arranged in the following manner: For the decimation rate of 4, only a FIR filter with a fixed decimation by 4 is used, • CIC filter is bypassed. ThinkRF R5700/R5750 Real Time Spectrum Analyzer Programmer's Guide... -
Page 69: [:Sense]:Frequency:center
60kHz. The set values can be verified by querying. If a valid frequency with an inappropriate resolution is set, the frequency value will be rounded down to the nearest valid resolution, no error is set. ThinkRF R57x0 Real Time Spectrum Analyzer Programmer’s Guide... -
Page 70: [:Sense]:Frequency:if
Default Output Unit *RST State SENSE:FREQ:IF? -1 Examples [:SENSe]:FREQuency:LOSCillator? This command queries the frequency of the local oscillator (LO) 1, 2 or 3 in corresponding to current the RTSA's center frequency set. ThinkRF R5700/R5750 Real Time Spectrum Analyzer Programmer's Guide... -
Page 71: [:Sense]:Frequency:shift
:GNSS[:ENABle] is disabled and :SOURce:REFerence:PLL set to GNSS then this query would return 0. Syntax [:SENSe]:LOCK:REFerence? Parameter None Query Response 0 | 1 Reference PLL is locked Reference PLL is not locked Output Data Type <boolean> *RST State ThinkRF R57x0 Real Time Spectrum Analyzer Programmer’s Guide... -
Page 72: [:Sense]:Lock:rf
“GNSS” response or :STATus:QUEStionable:CONDition? returning a value that contains the bit position 9 with a ‘1’ (or 512) could be used as a detection method. The module is defaulted to ON at powered up. ThinkRF R5700/R5750 Real Time Spectrum Analyzer Programmer's Guide... -
Page 73: Gnss:adelay
“GPS,GLONASS”. The R57x0 will retain the user’s last entered value through power cycles. Caution: This command requires the GNSS module enabled to work, for both set and query. Otherwise, a 200,”Execution error” will be resulted. ThinkRF R57x0 Real Time Spectrum Analyzer Programmer’s Guide... -
Page 74: Gnss:dynamic:mode
Suitable for most situations. Stationary Used in timing applications (antenna must be stationary) or other stationary applications. Velocity restricted to 0 m/s. Zero dynamics assumed. Pedestrian Applications with low acceleration and speed, e.g. how a ThinkRF R5700/R5750 Real Time Spectrum Analyzer Programmer's Guide... -
Page 75: Gnss:position
In the absence of GNSS fix, the command returns invalid data, corresponding to all “1” values in the GPS VRT context packet definition, or: 512.000000,512.000000,67108863.968750 Syntax :GNSS:POSition? Query Response latitude (degrees),longitude (degrees),altitude (meters) Output Data Type Comma separated <NR2> *RST State ThinkRF R57x0 Real Time Spectrum Analyzer Programmer’s Guide... -
Page 76: Gnss:reference
Therefore, it is important that the total data capture size should be less than one second. This external trigger type uses the PPS pin of the GPIO port. ThinkRF R5700/R5750 Real Time Spectrum Analyzer Programmer's Guide... -
Page 77: Trigger:level
Table 44: Maximum Threshold Level Where +/-3 dBm Error or Less Still Hold For A Given Attenuation Level Attenuation (dB) Maximum Threshold (dBm) Refer to the Frequency Domain Triggering section for more information. Syntax :TRIGger:LEVel <NRf [unit]>,<NRf [unit]>,<NR1 [unit]> :TRIGger:LEVel? Parameters/Response <start>,<stop>,<level> ThinkRF R57x0 Real Time Spectrum Analyzer Programmer’s Guide... -
Page 78: Trigger:periodic
Data Payload Format, page 39. ThinkRF's R57x0 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 79: Trace:block:data
In other words, the data from one packet to the next within a single block capture mode is continuous. Syntax :TRACe:BLOCk:PACKets <integer> :TRACe:BLOCk:PACKets? [{MAX | MIN}] ThinkRF R57x0 Real Time Spectrum Analyzer Programmer’s Guide... -
Page 80: Trace:sppacket
Input: Number of samples Query: [{MAX | MIN}] Input Data Type <integer> | <character> Allowable Values 256 – 65504, must be a multiple of 32 Query Response <integer> *RST State 1024 Examples :TRACE:SPP 4096 :TRAC:SPP? ThinkRF R5700/R5750 Real Time Spectrum Analyzer Programmer's Guide... -
Page 81: Trace:stream:start
+ 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 82: Sweep Commands
The engine will resume sweeping once the buffer is freed up. The engine will stop when the iterations have been reached or either a :SYSTem:ABORt :SWEep:LIST:STOP command has been issued. ThinkRF R5700/R5750 Real Time Spectrum Analyzer Programmer's Guide... -
Page 83: Sweep:list:iterations
(page 37) value will always be sent out after this command is received and before data packets of the new sweep become available. When no ID value is provided, the default ID value 0 is returned in the Context Packet. ThinkRF R57x0 Real Time Spectrum Analyzer Programmer’s Guide... -
Page 84: Sweep:list:status
This commands will copy and populate all the capture engine configurations under :SWEep:ENTRy with values from the sweep entry of the specified index. No new entry is created until :SWEep:ENTRy:SAVE command is issued and any changes will not affect the existing entry. ThinkRF R5700/R5750 Real Time Spectrum Analyzer Programmer's Guide... -
Page 85: Sweep:entry:count
No new entry is created until :SWEep:ENTRy:SAVE command is issued. Syntax :SWEep:ENTRy:NEW Parameter/Response None *RST State :SWEEP:ENTRY:NEW Examples :SWEep:ENTRy:READ? This query command returns the current configuration settings of a sweep entry. ThinkRF R57x0 Real Time Spectrum Analyzer Programmer’s Guide... -
Page 86: Sweep:entry:save
[<integer>] Allowable Values :SWEep:ENTRy:COUNt? query value + 1 *RST State :SWEEP:ENTR:SAVE Examples :SWE:ENTR:SAVE 5 :SWEep:ENTRy:ATTenuator Refers to the :INPut:ATTenuator section (page 64) for the definition of this command. :SWEEP:ENTRY:ATTENUATOR 20 Examples :SWEEP:ENTR:ATT? ThinkRF R5700/R5750 Real Time Spectrum Analyzer Programmer's Guide... -
Page 87: Sweep:entry:attenuator:variable
:SWEep:ENTRy:FREQuency:STEP <NRf [unit]> :SWEep:ENTRy:FREQuency:STEP? Parameter <freq [unit]> Input Data Type <NRf> [<character>] Allowable Values 0 – Maximum frequency of the R57x0 model used Query Response <integer> Default I/O Units *RST State 100000000 ThinkRF R57x0 Real Time Spectrum Analyzer Programmer’s Guide... -
Page 88: Sweep:entry:frequency:shift
0 – 4294967295 (or 2 – 1) 0,0 := infinity Query Response <second>,<microseconds> I/O Data Type <integer> | Comma separated <integers> *RST State 0,0 (infinite dwell time) Examples :SWEEP:ENTR:DWEL 5,30 :SWEEP:ENTR:DWELL 2 ThinkRF R5700/R5750 Real Time Spectrum Analyzer Programmer's Guide... -
Page 89: Sweep:entry:ppblock
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. :SWEEP:ENTR:TRIG:TYPE LEVEL Examples :SWEEP:ENTRY:TRIG:TYPE? ThinkRF R57x0 Real Time Spectrum Analyzer Programmer’s Guide... -
Page 90: 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 to be mentioned in this Appendix will behave differently. -
Page 91: Connection Using Hislip
Refer to the HiSLIP documentation, IVI-6.1 (www.ivifoundation.org/specifications/default.aspx), for further details. ThinkRF RTSA acts as a HiSLIP server, listening on a TCP port 4880. Two TCP connections to the same port are established in a single HiSLIP connection using the initialization sequence described in the standard. The two connections are linked together with a common Session ID, with one connection serves as a synchronous channel and the other an asynchronous channel. -
Page 92: Figure 15: Hislip And Tcp Connections To Rtsa
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 47: ThinkRF Vendor Specific Message Type Value Definitions Designation Channel Numerical Value... - Page 93 Once the transaction completes successfully, the TCP connection is ready to transmit the VRT stream from the server to the client. Once the data connection is associated, it is free to carry the VRT stream. ThinkRF R57x0 Real Time Spectrum Analyzer Programmer’s Guide...
-
Page 94: Appendix B: Protocols For Discovering Rtsa
• Discovery Using Broadcast UDP ThinkRF also provides a simple broadcast UDP protocol for discovering RTSA devices. The remote host computer would first send out a UDP message of broadcast type to port 18331. The message contains a query request code followed by query discovery version in big-endian order as follows: <request code><discovery version>... - Page 95 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 R57x0 Real Time Spectrum Analyzer Programmer’s Guide...
-
Page 96: Appendix C: Scpi Command Syntax
1. Separate messages. Commands are sent as 1 message at a time. SENSE:FREQ:CENTER 3 GHZ SENSE:FREQ:SHIFT 1000 INPUT:GAIN 1 0 ThinkRF R57x0 Real Time Spectrum Analyzer Programmer’s Guide... -
Page 97: Notation
Uses to enclose required parameter descriptions Indicates query command, use where applicable Indicates “or” and is used to separate alternative parameter options Means “is defined as” Parameter types This section defines different SCPI parameter data type. ThinkRF R5700/R5750 Real Time Spectrum Analyzer Programmer's Guide... -
Page 98: Default Units
Note the following examples, which are all equivalent. :FREQ:CENTer 2441.5 MHz Example :FREQ:CENTer 2441500000 is equivalent to is equivalent to :FREQ:CENTer 2441500000 Hz is equivalent to :FREQ:CENTer 2441500 kHz :FREQ:CENTer 2441.5e6 is equivalent to ThinkRF R57x0 Real Time Spectrum Analyzer Programmer’s Guide... -
Page 99: Appendix D: Scpi Status And Event Registers
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. Query errors have SCPI error codes from -499 to - 400. ThinkRF R57x0 Real Time Spectrum Analyzer Programmer’s Guide... -
Page 100: 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 R5700/R5750 Real Time Spectrum Analyzer Programmer's Guide... -
Page 101: Output Queue
The R57x0 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 R57x0 Real Time Spectrum Analyzer Programmer’s Guide... -
Page 102: 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 R57x0 Real Time Spectrum Analyzer Programmer’s Guide... -
Page 103: Appendix F: Scpi Commands Quick Reference
Queries which timing reference source used to v1.0 discipline the 10 MHz GNSS reference oscillator Page :INPut :ATTenuator {0 | 10 | 20 | 30} Set the fix attenuation for R57x0-408 models and v1.0 their variants ThinkRF R5700/R5750 Real Time Spectrum Analyzer Programmer's Guide... - Page 104 :CONDition? Queries the Operation Condition Register for v1.0 any operation event :ENABle <integer> Enables bits in the Operation Enable Register v1.0 :ENABle? :NTRansition Enables bits in the Operation Negative v1.0 Transition Register ThinkRF R57x0 Real Time Spectrum Analyzer Programmer’s Guide...
- Page 105 As defined in [:SENSe]:DECimation, page v1.0 :DECimation? :FREQuency :CENTer <NRf [unit]>[,<NRf [unit]>] Set the center frequency or a range of center v1.0 frequencies that are stepped by the value ::= <start freq>[,<stop freq>] defined by :SWEep:ENTRy:FREQuency:STEP ThinkRF R5700/R5750 Real Time Spectrum Analyzer Programmer's Guide...
-
Page 106: Level
Put the RTSA into DHCP mode, effective v1.0 immediately :DNS <main DNS>[,alt DNS] Set the RTSA's LAN DNS address(es) v1.0 :DNS? [CURRENT] :GATEway <IPv4 address> Set the RTSA's LAN Gateway address v1.0 ThinkRF R57x0 Real Time Spectrum Analyzer Programmer’s Guide... - Page 107 Adjust the system time relative to its current time {DISable | NTP,{ONCE | :SYNC Select the synchronization source and mode v1.0 CONTinuous}} :SYNC? v1.0 :STATus? Return the status of the time synchronization ThinkRF R5700/R5750 Real Time Spectrum Analyzer Programmer's Guide...
- Page 108 :PERiodic <integer [unit]> Set the time period of a periodic trigger :PERiodic? :TYPE {LEVel | PERiodic | PPS | Set or disables the trigger type v1.0 PULSe | WORD | NONE} :TYPE? ThinkRF R57x0 Real Time Spectrum Analyzer Programmer’s Guide...
-
Page 109: R55X0 Vs. R57X0 List Of Changes
Removed WBIQ option mentioning from :SYSTem:OPTions? and across the document as this option is not available with the R57x0 products VRT Protocol - Added section Formatted GPS Geolocation section for GNSS VRT context packets ThinkRF R5700/R5750 Real Time Spectrum Analyzer Programmer's Guide... -
Page 110: 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/ 3. "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 R57x0 Real Time Spectrum Analyzer Programmer’s Guide... -
Page 111: Document Revision History
R55x0 vs. R57x0 List of Changes for a summary of main changes. v1.1.0 June 1, 2019 - Changed R5700 to R57x0 to refer to R5700 and R5750 products - Corrected & added new information to Table 2 - Added: + New GNSS SCPI commands are added:... - Page 112 Oct 22, 2021 Corrected the reference offset error 15.7168 (in Reference Level section of VRT Digitizer context) to 15.7678 Document Version is not the same as the firmware Release Version as mentioned in Appendix F: SCPI Commands Quick Reference. ThinkRF R5700/R5750 Real Time Spectrum Analyzer Programmer's Guide...
Need help?
Do you have a question about the R5700 and is the answer not in the manual?
Questions and answers