1. Manuals
  2. Brands
  3. ThinkRF Manuals
  4. Measuring Instruments
  5. R5700
  6. Programmer's manual

ThinkRF R5700 Programmer's Manual

Real-time spectrum analyzer with gnss with gnss
Hide thumbs Also See for R5700:
Table of Contents

Advertisement

Quick Links

Download this manual See also: User Manual
ThinkRF R5700
Real-Time Spectrum Analyzer
with GNSS
Programmer's Guide
Version 1.0.0
October 20, 2018
Document no. 75-0033-181020
Copyright © 2018 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
loading
Need help?

Need help?

Do you have a question about the R5700 and is the answer not in the manual?

Questions and answers

Related Manuals for ThinkRF R5700

Summary of Contents for ThinkRF R5700

  • Page 1 Real-Time Spectrum Analyzer with GNSS Programmer's Guide Version 1.0.0 October 20, 2018 Document no. 75-0033-181020 Copyright © 2018 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 R5700 Functional Overview ....................12 System Overview ........................12 The Architecture ........................15 RF Receiver Front-End ......................17 Direct-Conversion Receiver Technology ................17 DC Offset Correction .....................
  • Page 4 Context Field Change Indicator ..................35 IQ Swapped Indicator ....................35 New Stream Start ID ...................... 36 New Sweep Start ID ...................... 36 IF Data Packet Class ......................36 Picosecond Timestamp Words Format ................37 Data Payload Format ..................... 37 Trailer Word Format ......................
  • Page 5 :STATus:PRESET ....................... 61 :STATus:QUEStionable[:EVENt]? ..................61 :STATus:QUEStionable:CONDition? ................... 61 :STATus:QUEStionable:ENABle ..................62 :STATus:QUEStionable:NTRansition .................. 62 :STATus:QUEStionable:PTRansition ................... 62 :STATus:TEMPerature? ...................... 63 INPut Commands ........................63 :INPut:ATTenuator ....................... 63 :INPut:ATTenuator:VARiable ....................63 :INPut:GAIN ......................... 64 :INPut:GAIN:HDR ........................ 65 :INPut:MODE ........................65 SOURce Commands ......................
  • Page 6 .......................... 97 Error and Event Queue ......................97 Appendix E: SCPI Error Codes Used ................98 Appendix F: SCPI Commands Quick Reference ............99 R5500 vs. R5700 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 GNSS Global Navigation Satellite System GPIO General Purpose Input/Output Global Positioning System Graphical User Interface High Dynamic Range...

  • Page 8: List Of Figures

    Figure 7: Synchronized Sweep using Sync-Word ..................25 Figure 8: Synchronized Sweep with a Missed Capture ................25 Figure 9: Connectivity and 4 Different Packet Streams Supported by R5700 .......... 26 Figure 10: An Example Illustrating Uninverted and Inverted Spectrums ..........41 Figure 11: SCPI Language Hierarchical or Tree Structure Example ............

  • Page 9: List Of Tables

    Table 7: The Categories of VRT Packet Streams Supported by ThinkRF's R5700 ......... 26 Table 8: A List of Stream Identifiers As Used by ThinkRF for Different Packet Classes ......27 Table 9: Receiver Context Packet Class Structure .................. 28 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 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

    +1.613.369.5104. Before contacting Support, please have the following information available: • R5700's serial number and product version, which are located on the identification label on the R5700's underside. • The firmware version running on the R5700.

  • Page 12: R5700 Functional Overview

    The R5700 is designed for stand-alone, remote and/or distributed wireless signal analysis. Whether using as a single unit or a network of radio sensors, R5700 is ideal for monitoring, management and surveillance of transmitters, whether they are in-building or spread across a geographic area.

  • Page 13: Figure 1: R5700 Functional Block Diagram

    RTSAs available on the local network. The source code provided for the aforementioned APIs and GUIs/applications would serve as examples. The R5700 provides system level control and status commands as defined in Table ThinkRF R5700 Real Time Spectrum Analyzer Programmer’s Guide...

  • Page 14: Table 1: System Level Control/Status Commands With Gnss

    :HAVE? Returns the current lock state of the task specified :REQuest? Requests the R5700 to provide a lock on a specific task such that only the application that has the lock can perform the task :OPTions? Returns comma separated 3-digit values to represent the hardware...

  • Page 15: The Architecture

    The Architecture The R5700 is an integrated wireless radio receiver, digitizer/analyzer and GNSS technology. It has an embedded capture controller that enables users to: • define and execute real-time and sophisticated triggers, traces and sweeps;...

  • Page 16: Figure 2: Rf Receiver Front-End And Capture Controller Functional Block Diagram

    Receiver For SH and SHN modes, when the decimation is used, a frequency shift of 35MHz will be applied automatically to bring the R5700's center frequency back to the zero IF. Thus, the data output will be I and Q.

  • Page 17: Rf Receiver Front-End

    DC offsets which are inherent to direct-conversion technology. DC Offset Correction The R5700's WB ADC sampling rate is 125 MSa/s, intermediate frequency (IF) is 0 and the entire IF bandwidth is 125MHz. The analog filter results in an amplitude roll-off at approximately +50MHz around the center frequency Fc, as illustrated in Figure 3.

  • Page 18: 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 19: Digital Signal Processing

    Digital Signal Processing The R5700 has embedded DSP blocks to provide further signal processing capabilities, such as DDC with up to 10 levels of decimation and FFT computation. Digital Down Converter...

  • Page 20: Triggers

    Frequency domain triggering relies on the embedded real-time FFT mechanism to transform the sampled signal from the time domain to the frequency domain. The R5700 uses a 1024 point real-time FFT core embedded within the FPGA to transform 1024 time domain IQ samples to 1024 frequency domain FFT bins.

  • Page 21: Periodic Triggering

    External Triggering External triggering provides a means of synchronized triggering based on the receiving of a trigger signal provided via the R5700's GPIO. The trigger “signal” could be a single pulse, PPS or a sync-word. See Synchronized Sweep (page 24) for additional details.

  • Page 22: Capture Controller

    The :TRACe:BLOCk (page 75) command initiates a block capture of continuous IQ data (available to be "pulled" from the R5700 per command issued). Once it is issued, data will be stored instantly (conditional on triggering), contiguously and reliably and are available to be read.

  • Page 23: Sweep Capture Control

    Copies the settings of an existing sweep entry into the current settings for quick editing :COUNt? Gets the number of entries available in the list :DELETE Deletes the specified entry or all entries ThinkRF R5700 Real Time Spectrum Analyzer Programmer’s Guide...

  • Page 24: Synchronized Sweep

    (page 78) for further details. Synchronized Sweep The R5700 supports a synchronized sweep function for the purposes of comparing the same signal received via multiple R5700s. Synchronized sweep is an extension of the external trigger capability. One of the R5700s...

  • Page 25: Figure 7: Synchronized Sweep Using Sync-Word

    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 R5700 Real Time Spectrum Analyzer Programmer’s Guide...

  • Page 26: Vita-49 Radio Transport Protocol

    The section describes the R5700's VRT Information Class as per the "VITA Radio Transport (VRT) Draft Standard" Specification VITA-49.0 – 2007 Draft 0.21. Purpose Convey an arbitrary 100MHz of IF data and associated information from the R5700 to another equipment using an industrial standard. R5700's VRT Overview...

  • Page 27: Packet Classes And Streams

    VITA-49 Radio Transport Protocol The Receiver Context Packet Class Stream is used to convey informational messages about changes in the configuration and status of the RF receiver in the R5700. Digitizer Context Packet Class Stream The Digitizer Context Class Stream is used to convey information messages about changes in the configuration and status of the IF digitizer in the R5700.

  • Page 28: 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 Reference Point Persistent RF Reference Frequency Persistent Gain Persistent Temperature Persistent ThinkRF R5700 Real Time Spectrum Analyzer Programmer’s Guide...

  • Page 29: Context Field Change Indicator

    Temperature This field is not yet available. The R5700 has a temperature sensor and will report changes in temperature to the system. The value of the Temperature field is expressed in units of degrees Celsius (°C). The Temperature field uses the 32-bit format shown in Table 14 with the upper 16 bits reserved and is set to zero.

  • Page 30: Digitizer Context Packet Class

    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 R5700's IF digitizer. Table 15: Digitizer Context Packet Class Structure 31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16 15 14 13 12 11 10 9...

  • Page 31: Context Field Change Indicator

    19. This field has an integer and a fractional part, with the radix point to the right of bit 20 in the second 32-bit word. This gives the RF Reference Frequency a range of ±8.79THz with a resolution of 0.95μHz. ThinkRF R5700 Real Time Spectrum Analyzer Programmer's Guide...

  • Page 32: Reference Level

    0xFFFF represents -0.0078125dBm. Formatted GPS Geolocation Note: For legacy specification reasons, such as with ANSI/VITA 49, the term GPS, instead of GNSS, is used in this section to refer generically to Global Navigation Systems. ThinkRF R5700 Real Time Spectrum Analyzer Programmer’s Guide...

  • Page 33: Table 21: Formatted Gps Geolocation Fields

    31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16 15 14 13 12 11 10 9 Integer Angle, degrees Fractional Angle, degrees 6. The Latitude subfield uses the Geolocation Angle Format shown in Table 22 with value ranging from -90.0 (South) to +90.0 (North) degrees. ThinkRF R5700 Real Time Spectrum Analyzer Programmer's Guide...

  • Page 34: Extension Context Packet Class

    2. C is 0 to indicate there is no Class Identifier in the packet. 3. R is 00 because they are reserved bits. 4. TSM is 0, indicating that context packet timestamps are precise. ThinkRF R5700 Real Time Spectrum Analyzer Programmer’s Guide...

  • Page 35: Context Field Change Indicator

    When the value is 1, the channels are swapped and 0 if not. This swapping is necessary to maintain the data output format to always be {I,Q} such that the spectral inversion is not required at the user-end during data processing. ThinkRF R5700 Real Time Spectrum Analyzer Programmer's Guide...

  • Page 36: New Stream Start Id

    New Sweep Start ID IF Data Packet Class The IF Data Packet Class conveys digitized IF Data from the digitizer to devices external to the R5700. The payload data and its output format is dependent on the RFE modes of operation (:INPut:MODE or :SWEep:ENTRy:MODE).

  • Page 37: Picosecond Timestamp Words Format

    10. Timestamp - Integer Picoseconds counts the number of picoseconds past since the last increment of the Timestamp seconds field. See Table 11. Data Payload contains the IF data from the R5700, arranged in the format indicated in Table 34 Table 12.

  • Page 38: Table 34: {I } Data Payload Arrangement With Upper 2-Bit Signed Extended To {I

    0bxx 0bxx Item 5 (Sample 5 I Item 6 (Sample 6 I Same conversion example as {I } Data Payload Format 8. Each data word is one I-component as seen in Table ThinkRF R5700 Real Time Spectrum Analyzer Programmer’s Guide...

  • Page 39: Trailer Word Format

    6. The Valid Data Indicator, when set to 1, indicates that the data in the packet is valid. When set to zero, it indicates that some condition exists that may invalidate the data. ThinkRF R5700 Real Time Spectrum Analyzer Programmer's Guide...

  • Page 40: Table 39: Conditions Causing Abnormal Indicator State And Suggested Resolution

    Table 39 to properly display the spectrum. Note: The Spectral Inversion Indicator does not apply to R5700 models as the I/Q output connectors are not available. Information is listed here for general knowledge only. 9. The Over-range Indicator isset to 1 if any data value in the packet has reached full scale at the input of the digitizer.

  • Page 41: 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 Real Time Spectrum Analyzer Programmer's Guide...

  • Page 42: Scpi Command Set

    SCPI Command Set SCPI Command Set This section is a SCPI reference guide for controlling the ThinkRF R5700 Real Time Spectrum Analyzer. The R5700 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 43: 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 <integer> Allowable Values 0 - 255 ThinkRF R5700 Real Time Spectrum Analyzer Programmer's Guide...

  • Page 44: Esr

    Syntax *OPC *OPC? Parameter None Query Response *RST Resets the R5700 to its default settings. This includes stopping any running capture mode and trigger mode, and also performs :SYSTem:FLUSh. ThinkRF R5700 Real Time Spectrum Analyzer Programmer’s Guide...

  • Page 45: Sre/*Sre

    *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. Syntax *TST? Parameter None Response 0 | 1 Output Data Type Integer ThinkRF R5700 Real Time Spectrum Analyzer Programmer's Guide...

  • Page 46: Wai

    :SYSTem sets required in all SCPI instruments. :SYSTem:ABORt This command will cause the R5700 to stop the data capturing, whether in the manual trace block capture, triggering or sweeping mode. The R5700 will be put into the manual mode; in other words, process such as streaming, trigger and sweep will be stopped.

  • Page 47: System:communicate:lan:apply

    RTSA User's Guide. Syntax SYSTem:COMMunicate:LAN:CONFigure DHCP | STATIC SYSTem:COMMunicate:LAN:CONFigure? [CURRENT] Parameter Set: DHCP | STATIC Query: [CURRENT] Response DHCP | STATIC I/O Data Type Character ThinkRF R5700 Real Time Spectrum Analyzer Programmer's Guide...

  • Page 48: System:communicate:lan:dns

    RTSA's LAN interface. Syntax SYSTem:COMMunicate:LAN:GATEway <IPv4 address> SYSTem:COMMunicate:LAN:GATEway? [CURRENT] Parameter Set: D.D.D.D where D = 0 – 255 Query: [CURRENT] Response D.D.D.D I/O Data Type String *RST State SYST:COMM:LAN:GATEWAY 102.101.0.13 Examples SYSTEM:COMMUNICATE:LAN:GATEWAY? SYST:COMM:LAN:GATE? CURRENT ThinkRF R5700 Real Time Spectrum Analyzer Programmer’s Guide...

  • Page 49: System:communicate:lan:ip

    Syntax SYSTem:COMMunicate:LAN:MTU <valid MTU value in bytes> SYSTem:COMMunicate:LAN:IP? [CURRENT] Parameter Set: 576 – 1500 bytes Query: [CURRENT] Response Integer I/O Data Type Integer *RST State Examples SYST:COMM:LAN:MTU 1400 SYSTEM:COMM:LAN:MTU? SYST:COMM:LAN:MTU? CURRENT ThinkRF R5700 Real Time Spectrum Analyzer Programmer's Guide...

  • Page 50: System:communicate:lan:netmask

    *RST State SYSTEM:COMMUNICATE:NTP 132.163.96.4 Examples SYST:COMM:NTP? Note: This feature could also be set through R5700's administrative web page, with up to 3 domain/IP addresses can be entered. :SYSTem:ERRor[:NEXT]? This query returns the oldest uncleared error code and message from the SCPI error/event queue.

  • Page 51: System:error:all

    Syntax :SYSTem:ERRor:CODE[:NEXT]? Parameter None Response <error code> Output Data Type <integer> Description Refer to the Appendix E: SCPI Error Codes Used section *RST State Example :SYST:ERR:CODE? ThinkRF R5700 Real Time Spectrum Analyzer Programmer's Guide...

  • Page 52: System:error:code:all

    Example :SYST:ERR:CODE:ALL? :SYSTem:FLUSh This command clears the R5700's internal data storage buffer of any data that is waiting to be sent. IMPORTANT Note: It is highly recommended that the flush command (after issuing :SYSTem:ABORt) should be used before start of any data capture or when switching between different capture modes to clear up the remnants of data in the RTSA.

  • Page 53: System:lock:have

    :SYST:LOCK:HAVE? ACQ :SYSTem:LOCK:REQuest? This query attempts to attain the lock on the R5700 for a specific task, such as data acquisition. The query returns 1 when lock is successful or 0 if it fails. Attaining a lock is equivalent to having the sole ownership for that task. This prevents multiple connected applications from doing the same task that would result in an erroneous operation or feedback from the R5700.

  • Page 54: System:options

    The master RTSA itself will has an internal loop-back of the synchronization signal it sent out. Syntax :SYSTem:SYNC:MASTer <Boolean> :SYSTem:SYNC:MASTer? Parameter ON | OFF | 1 | 0 Input Data Type Integer | Character ThinkRF R5700 Real Time Spectrum Analyzer Programmer’s Guide...

  • Page 55: System:sync:wait

    Example :SYST:VERS :SYSTem:DATE This command sets or queries the current date of the R5700. When the date is set, the change is applied to the real time clock (RTC) of the R5700 system, and the :SYSTem:TIME:SYNC field is changed to DISable automatically. The date returned is representative of the current time mode that is UTC.

  • Page 56: System:time

    :SYST:DATE 2017,12,2 Examples :SYSTEM:DATE? :SYSTem:TIME This command sets or queries the current time of the R5700. When the time is set, the change is applied to the RTC of the R5700 system, and the :SYSTem:TIME:SYNC field is changed to DISable automatically. The time returned is representative of the current time mode that is UTC.
  • Page 57 Parameter DISable | NTP,{ONCE | CONTinuous} Response DISabled | NTP,{ONCE | CONTinuous} I/O Data Type Character | String (comma separated characters) *RST State DISable Examples :SYST:TIME:SYNC NTP,ONCE :SYST:TIME:SYNC DISABLE :SYSTEM:TIME:SYNC? STATus Commands ThinkRF R5700 Real Time Spectrum Analyzer Programmer's Guide...

  • Page 58: Status Commands

    SCPI also defines an IEEE 488.2 queue for status. The queue provides a human readable record of instrument events. The application programmer may individually ThinkRF R5700 Real Time Spectrum Analyzer Programmer’s Guide...

  • Page 59: 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 Response <integer> Output Values 0 – 32767 (2 *RST State None :STAT:OPER:COND? Example ThinkRF R5700 Real Time Spectrum Analyzer Programmer's Guide...

  • Page 60: 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 <integer> Allowable Values 0 – 32767 (2 *RST State Examples :STAT:OPER:PTR 256 :STAT:OPER:PTR? ThinkRF R5700 Real Time Spectrum Analyzer Programmer’s Guide...

  • Page 61: Status:preset

    See Figure for the QCR bits mapping. Syntax :STATus:QUEStionable:CONDition? Parameter None Response <integer> Output Values 0 – 32767 (2 *RST State None :STAT:QUES:COND? Example ThinkRF R5700 Real Time Spectrum Analyzer Programmer's Guide...

  • Page 62: 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 <integer> Allowable Values 0 – 32767 (2 *RST State Examples :STAT:QUES:PTR 256 :STAT:QUES:PTR? ThinkRF R5700 Real Time Spectrum Analyzer Programmer’s Guide...

  • Page 63: Status:temperature

    INPut Commands :INPut:ATTenuator This command sets or queries the fix attenuation of the R5700's RFE. Note: This command applies to R5700-308, -408 and their variants only. It is not applicable for -418 and -427 and their variants, see :INPut:ATTenuator:VARiable command instead.

  • Page 64: Input:gain

    Note: The reference level context information (see page 32) is only valid when all the gain stages are enabled for R5700-418, 427 and their variants. Table 41: Performance of The Gain Settings of R5700-418, 427 and Their Variants Stage 1 Stage 2...

  • Page 65: Input:gain:hdr

    Since the IP3 measurement relies on the relative signal-to-3rd order product ratio and not on the absolute signal value nor the SNR, the R5700 product is not calibrated for the different HDR gain levels. The only HDR gain value that is calibrated and optimized is the default 25 dB gain.

  • Page 66: Source Commands

    VRT timestamp system, whether it be via the external GPIO source, or through the GNSS’s module. Note: :GNSS[:ENABle] must be set to ON before selecting the GNSS option for this command; otherwise, an error of “-221 Settings Conflict” will be returned. ThinkRF R5700 Real Time Spectrum Analyzer Programmer’s Guide...

  • Page 67: Sense Commands

    1, 2 and 4. In the remaining RFE modes, R5700 uses DDC to provide 10 levels of decimation of values 4, 8, 16, 32, 64, 128, 256, 512, 1024 (i.e. decimation rate = 2 level where level = 2 –...

  • 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, R5700-408 has a range of 0.1 to 8GHz, while R5700-427 has 0.1 to 27GHz.

  • Page 69: [:Sense]:Frequency:if

    This command queries the IF frequencies that are used for the current input mode and center frequency. This command works in all R5700 models but the number and significance of the IF frequencies will vary depending on the model and configured options (see :SYSTem:OPTions? command).

  • Page 70: [:Sense]:Frequency:shift

    This command queries the lock status of the PLL reference clock in the digital card. Syntax [:SENSe]:LOCK:REFerence? Parameter None Query Response 0 | 1 Reference PLL is locked Reference PLL is not locked Output Data Type Integer *RST State LOCK:REF? Example ThinkRF R5700 Real Time Spectrum Analyzer Programmer’s Guide...

  • Page 71: [:Sense]:Lock:rf

    :GNSS[:ENABle] ON | OFF | 1 | 0 :GNSS[:ENABle]? Parameter ON | OFF | 1 | 0 Input Data Type Integer | Character Query Response 0 | 1 Output Data Type Integer *RST State :GNSS ON Examples :GNSS:ENABLE? ThinkRF R5700 Real Time Spectrum Analyzer Programmer's Guide...

  • Page 72: Gnss:position

    (QSR), with a 1 indicating absence of a GNSS fix. Syntax :GNSS:REFerence? Query Response GNSS | INT Output Data Type character *RST State GNSS :GNSS:REF? Examples TRIGger Commands Note: Trigger is not supported with HDR input mode. ThinkRF R5700 Real Time Spectrum Analyzer Programmer’s Guide...

  • Page 73: Trigger:type

    Recommend adjusting the attenuation level (using :INPut:ATTenuator:VARiable or :INPut:ATTenuator) accordingly to achieve detection at the desired level with error within ±3 dBm range. ThinkRF R5700 Real Time Spectrum Analyzer Programmer's Guide...

  • Page 74: Trigger:periodic

    Data Payload Format, page 37. ThinkRF's R5700 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:data

    The R5700 can stored up to 32 MSa of ZIF or 64 MSa of SH continuous data. :TRACe:BLOCk:DATA? This command will start the single block capture and the return of all trace packets set by...

  • Page 76: Trace:block:packets

    :TRACe:BLOCk:PACKets This command sets or queries the total number of packets set in the RTSA. The maximum is limited by the storage capacity of a R5700 and the samples per packet (SPP) size set through :TRACe:SPPacket. Therefore, when :TRACe:BLOCk:PACKets? MAX query command is sent, the returned value will vary depending on the SPP value of an RTSA and the data output format.

  • Page 77: Trace:stream:start

    :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 R5700 whenever data is available. Through the sending of a VRT Extension Context Packet carrying the ID value, the use of an ID in this command is to indicate the beginning of new data packets belonging to a new stream start.

  • Page 78: Trace:stream:stop

    If trigger is defined for an entry, captured data is returned only if a trigger event occurred. Otherwise, when the :DWEll time is reached, the trigger is aborted and the next sweep entry will be executed. ThinkRF R5700 Real Time Spectrum Analyzer Programmer’s Guide...

  • Page 79: Sweep:list:iterations

    :SWEep:LIST:STARt command is issued, this will initiate also the data capturing and data packets will be “pushed” from the R5700 when available. - When sweep is stopped, the RTSA will retain the settings of the last performed sweep entry when :STOP command is received and executed. Any non-sweep commands can then be operated on the RTSA.

  • Page 80: Sweep:list:status

    Examples :SWEEP:LIST:STOP :SWE:LIST:STOP Note: This command should be issued to clear the R5700's data buffer of any data that has not been sent from the R5700 prior to setting up the next capturing process. :SWEep:ENTRy:COPY This commands will copy and populate all the capture engine configurations under :SWEep:ENTRy with values from the sweep entry of the specified index.

  • Page 81: Sweep:entry:count

    This commands will populate all the capture engine configurations under :SWEep:ENTRy with default values. No new entry is created until :SWEep:ENTRy:SAVE command is issued. Syntax :SWEep:ENTRy:NEW Parameter/Response None *RST State Examples :SWEEP:ENTRY:NEW ThinkRF R5700 Real Time Spectrum Analyzer Programmer's Guide...

  • Page 82: Sweep:entry:read

    Input Data Type Integer Allowable Values :COUNt? value + 1 *RST State :SWEEP:ENTR:SAVE Examples :SWE:ENTR:SAVE 5 :SWEep:ENTRy:ATTenuator Refers to the :INPut:ATTenuator section (page 63) for the definition of this command. :SWEEP:ENTRY:ATTENUATOR 20 Examples :SWEEP:ENTR:ATT? ThinkRF R5700 Real Time Spectrum Analyzer Programmer’s Guide...

  • Page 83: Sweep:entry:attenuator:variable

    :SWEep:ENTRy:FREQuency:STEP <NRf [unit]> :SWEep:ENTRy:FREQuency:STEP? Parameter <freq [unit]> Input Data Type Double [character] Allowable Values 0 – Maximum frequency of the R5700 model used Query Response <integer> Default I/O Units *RST State 100000000 ThinkRF R5700 Real Time Spectrum Analyzer Programmer's Guide...

  • Page 84: Sweep:entry:frequency:shift

    0 – 4294967295 (or 2 – 1) 0,0 := infinity Query Response <integer>,<integer> I/O Data Type Integer | Comma separated integers *RST State 0,0 (infinite dwell time) :SWEEP:ENTR:DWEL 5,30 Examples :SWEEP:ENTR:DWELL 2 :SWEEP:ENTR:DWELL? ThinkRF R5700 Real Time Spectrum Analyzer Programmer’s Guide...

  • Page 85: 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. Examples :SWEEP:ENTR:TRIG:TYPE LEVEL :SWEEP:ENTRY:TRIG:TYPE? ThinkRF R5700 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 to be mentioned in this Appendix will behave differently.

  • Page 87: Connection Using Hislip

    RTSA, both <IP>:37000 and <IP>:37001 sockets must be created one right after the other. The order is not important. In addition, refer to the “Connecting to the R5700” of the R5700 User Guide (v4.0 or higher) for more information on how to connect to R5700 and to determine its IP address.

  • Page 88: Figure 15: Hislip And Tcp Connections To Rtsa

    <IP>:4881 Figure 15: HiSLIP and TCP connections to RTSA HiSLIP port 4880 only addresses the control channel of the R5700, similar to the role that TCP socket 37001 plays in the 2-port TCP/IP connection mentioned in the previous section. A third TCP connection at port 4881 to RTSA is required to carry the VRT data stream.

  • Page 89: Table 45: 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 45: ThinkRF Vendor Specific Message Type Value Definitions Designation Channel Numerical Value...

  • Page 90: Appendix B: Protocols For Discovering Rtsa

    Conforming with the industry standard, R5700 supports device discovery using the mDNS/DNS-SD protocols. Industry standard tools and applications supporting these protocols are now able to discover the R5700 with the said firmware version. Refer to the following resources for more information about mDNS/DNS-SD protocols: •...
  • 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 R5700 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 R5700 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 R5700 Real Time Spectrum Analyzer Programmer's Guide...
  • Page 94 Note the following examples, which are all equivalent. :FREQ:CENTer 2441.5 MHz Example is equivalent to :FREQ:CENTer 2441500000 is equivalent to :FREQ:CENTer 2441500000 Hz :FREQ:CENTer 2441500 kHz is equivalent to :FREQ:CENTer 2441.5e6 is equivalent to ThinkRF R5700 Real Time Spectrum Analyzer Programmer’s Guide...

  • Page 95: 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 R5700 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 R5700 Real Time Spectrum Analyzer Programmer's Guide...

  • Page 97: Output Queue

    The unread results of a previous command are cleared from the queue when a new command or query is received. Error and Event Queue The R5700 has an Error and Event FIFO Queue that holds up to 16 errors and events. It is queried using the :SYSTem:ERRor[:NEXT]? command.

  • 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 R5700 Real Time Spectrum Analyzer Programmer’s Guide...

  • Page 99: Appendix F: Scpi Commands Quick Reference

    Appendix F: SCPI Commands Quick Reference Appendix F: SCPI Commands Quick Reference This section summarizes the SCPI commands available for interfacing with R5700. The commands are listed alphabetically based on the main node, then sub-nodes, so on. The sub-nodes are grouped and listed alphabetically based on functionality.
  • Page 100 :ENABle? :NTRansition Enables bits in the Operation Negative v1.0 Transition Register :NTRansition? :QTRansition Enables bits in the Operation Positive Transition v1.0 Register :QTRansition? :PRESET Presets the R5700 (similar to *RST) v1.0 :QUEStionable ThinkRF R5700 Real Time Spectrum Analyzer Programmer’s Guide...
  • Page 101 ::= <start freq>[,<stop freq>] defined by :SWEep:ENTRy:FREQuency:STEP :CENTer? :SHIFt 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? ThinkRF R5700 Real Time Spectrum Analyzer Programmer's Guide...
  • Page 102 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.0 inclusive :MTU? [CURRENT] :NETMask <IPv4 address> Set the RTSA's LAN netmask address v1.0 :NETMask? [CURRENT] ThinkRF R5700 Real Time Spectrum Analyzer Programmer’s Guide...
  • Page 103 Return the current lock state of the task v1.0 specified :REQuest? ACQuisition Request the R5700 to provide a lock on a v1.0 specific task such that only the application that has the lock can perform the task. :OPTions? Returns comma separated 3-digit values to v1.0...
  • Page 104 :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 R5700 Real Time Spectrum Analyzer Programmer’s Guide...

  • Page 105: R5500 Vs. R5700 List Of Changes

    R5500 vs. R5700 List of Changes R5500 vs. R5700 List of Changes This section provides a list of changes in the R5700's Programmer's Guide as compare to that of the R5500. Sections R5700 Functional Updated the Architecture and RF Receiver Front-end sections to reflect the...

  • 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/ 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 R5700 Real Time Spectrum Analyzer Programmer’s Guide...

  • Page 107: Document Revision History

    R5500 vs. R5700 List of Changes for a summary of main changes. Document Version is not the same as the firmware Release Version as mentioned in Appendix F: SCPI Commands Quick Reference. ThinkRF R5700 Real Time Spectrum Analyzer Programmer’s Guide...

This manual is also suitable for:

R5500R5750

Table of Contents