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

ThinkRF R5500 Programmer's Manual

Real time spectrum analyzer
Hide thumbs Also See for R5500:
Table of Contents

Advertisement

Quick Links

Download this manual
ThinkRF R5500
Real Time Spectrum Analyzer
Programmer's Guide
Version 4.2.0
August 28 2017
Document no. 75-0025-170828
Copyright © 2013, 2014, 2015, 2016, 2017 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 R5500 and is the answer not in the manual?

Questions and answers

Related Manuals for ThinkRF R5500

Summary of Contents for ThinkRF R5500

  • Page 1 Programmer's Guide Version 4.2.0 August 28 2017 Document no. 75-0025-170828 Copyright © 2013, 2014, 2015, 2016, 2017 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 Functional Overview ....................12 System Overview ........................12 The Architecture ........................15 RF Receiver Front-End ......................16 Direct-Conversion Receiver Technology ................17 DC Offset Correction ......................
  • Page 4 IQ Swapped Indicator ..................... 34 New Stream Start ID ....................... 34 New Sweep Start ID ....................... 34 IF Data Packet Class ......................34 Picosecond Timestamp Words Format ................36 Data Payload Format ...................... 36 Trailer Word Format ....................... 37 SCPI Command Set ........................
  • Page 5 :INPut:ATTenuator ........................ 58 :INPut:ATTenuator:VARiable ....................58 :INPut:GAIN .......................... 58 :INPut:GAIN:HDR ......................... 59 :INPut:MODE ........................60 SOURce Commands ....................... 60 :SOURce:REFerence:PLL ....................60 :SOURce:REFerence:PLL:RESET ..................61 SENSe Commands ........................61 [:SENSe]:DECimation ......................61 [:SENSe]:FREQuency:CENTer .................... 62 [:SENSe]:FREQuency:IF? ....................62 [:SENSe]:FREQuency:INVersion? ..................63 [:SENSe]:FREQuency:LOSCillator? ..................
  • Page 6 ........................... 85 Error and Event Queue ......................85 Appendix E: SCPI Error Codes Used ................86 Appendix F: SCPI Commands Quick Reference ............87 WSA5000 vs. R5500 List of Changes ................92 References ............................93 Document Revision History ....................94...

  • 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 High Dynamic Range High Intermediate Frequency Instantaneous Bandwidth IEEE Institute of Electrical and Electronics Engineers...

  • 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 R5500 ......... 26 Figure 10: An Example Illustrating Uninverted and Inverted Spectrums ..........39 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 R5500 ........ 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 R5500 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

    9 AM to 5 PM Eastern Time, Monday to Friday. Contact us at support@thinkrf.com or by calling +1.613.369.5104. Before contacting Support, please have the following information available: R5500's serial number and product version, which are located on the identification • label on the R5500's underside. The firmware version running on the R5500.

  • Page 12: R5500 Functional Overview

    R5500 Functional Overview R5500 Functional Overview This section overviews the R5500's 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. The features and functionality described in this section may exist in the current product firmware release or are scheduled for a future product firmware release (grayed out commands and/or text).

  • Page 13: Figure 1: R5500 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 R5500 provides system level control and status commands as defined in Table Table 1: System Level Control/Status Commands...
  • Page 14 :HAVE? Returns the current lock state of the task specified :REQuest? Requests the R5500 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 R5500 is an integrated wireless radio receiver and digitizer/analyzer. It has an embedded capture controller that enables users to: define and execute real-time and sophisticated triggers, traces and sweeps;...

  • Page 16: Rf Receiver Front-End

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

  • Page 17: Direct-Conversion Receiver Technology

    DC offsets which are inherent to direct-conversion technology. DC Offset Correction The R5500'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...

  • Page 18: Figure 4: Iq Offset Correction

    Frequency 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 R5500 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 R5500 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 R5500'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 69) command initiates a block capture of continuous IQ data (available to be "pulled" from the R5500 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

    Saves the current editing entry to the end of the list or before the specified ID location in the list when the integer value is given :ATTenuator As defined in :INPut:ATTenuator, page :VAR[?] As defined in :INPut:ATTenuator:VARiable, page :DECimation[?] As defined in [:SENSe]:DECimation, page ThinkRF R5500 Real Time Spectrum Analyzer Programmer's Guide...

  • Page 24: Synchronized Sweep

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

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

    Figure 8: Synchronized Sweep with a Missed Capture SWEep Commands section (page 72) for further interface details or contact ThinkRF's Support for more information. ThinkRF R5500 Real Time Spectrum Analyzer Programmer's Guide...

  • Page 26: Vita-49 Radio Transport Protocol

    The section describes the R5500'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 R5500 to another equipment using an industrial standard. R5500's VRT Overview...

  • Page 27: Packet Classes And Streams

    Receiver Context Packet Class Stream 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 R5500. 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 R5500.

  • Page 28: Table 9: Receiver Context Packet Class Structure

    Table 11: Receiver Context Field Definition and Values Bit Name Context Field # of Words in Field Period of Validity Context Field Change Indicator Reference Point Persistent RF Reference Frequency Persistent Gain Persistent Temperature Persistent ThinkRF R5500 Real Time Spectrum Analyzer Programmer's Guide...

  • Page 29: Context Field Change Indicator

    Temperature This field is not yet available. The R5500 has a temperature sensor and will report changes in temperature to the system. The value of the Temperature field shall be expressed in units of degrees Celsius (°C). The Temperature field shall use the 32-bit format shown in Table 14 with the upper 16 bits reserved and shall be 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 R5500'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...

  • Page 31: Context Field Change Indicator

    (the Reference Point) and to any other conditions. The absolute power level P (in dBm) is then computed using the following formula: P=R+20∗log( IQ measured with √ measured ThinkRF R5500 Real Time Spectrum Analyzer Programmer's Guide...

  • Page 32: Rf Frequency Offset

    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 21 for the organization of this context packet class. ThinkRF R5500 Real Time Spectrum Analyzer Programmer's Guide...

  • Page 33: Table 21: Extension Context Packet Class Structure

    Table 23: Receiver Context Field Definition and Values Bit Name Context Field # of Words in Period of Position Field Validity Context Field Change Indicator IQ Swapped Indicator Persistent New Stream Start ID Persistent New Sweep Start ID Persistent ThinkRF R5500 Real Time Spectrum Analyzer Programmer's Guide...

  • Page 34: Context Field Change Indicator

    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 R5500. The payload data and its output format is dependent on the RFE modes of operation (:INPut:MODE or :SWEep:ENTRy:MODE).

  • Page 35: Table 26: Output Data Width And Packing Method For Different Data Formats

    Data Output Format Stream Identifier 0x90000003 0x90000005 0x90000006 9. Timestamp - Integer Seconds shall be in UTC format and will represent the number of seconds occurred since Midnight, January 1st, 1970, GMT. ThinkRF R5500 Real Time Spectrum Analyzer Programmer's Guide...

  • Page 36: Picosecond Timestamp Words Format

    10. Timestamp - Integer Picoseconds shall count the number of picoseconds past since the last increment of the Timestamp seconds field. See Table 11. Data Payload shall contain the IF data from the R5500, arranged in the format indicated in Table 30 Table 12.

  • Page 37: Trailer Word Format

    State and Event Indicators and the associated Enable bits shall be positions as indicated Table 1. For each Indicator bit in the State and Event Indicators field, there is a corresponding Enable bit at the same position in the Enables field. ThinkRF R5500 Real Time Spectrum Analyzer Programmer's Guide...

  • Page 38: Table 34: Trailer Indicator And Enable Bits

    SH or SHN, the spectral inversion indicator is available through the GPIO port. Contact ThinkRF's Support for further details (or see “Synchronized Sweep with IQout” AppNote for important information). 9. The Over-range Indicator shall be set to 1 if any data value in the packet has reached full scale at the input of the digitizer.

  • Page 39: Figure 10: An Example Illustrating Uninverted And Inverted Spectrums

    Use a decimation value such that Stream mode when the the transfer rate matches that of the internal buffer is full. capture rate. Figure 10: An Example Illustrating Uninverted and Inverted Spectrums ThinkRF R5500 Real Time Spectrum Analyzer Programmer's Guide...

  • Page 40: Scpi Command Set

    SCPI Command Set SCPI Command Set This section is a SCPI reference guide for controlling the ThinkRF R5500 Real Time Spectrum Analyzer. The R5500 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 41: 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. Figure 13 for the ESE/ESR register bits mapping. Syntax *ESE <integer> *ESE? Parameter/Response <integer> Allowable Values 0 - 255 ThinkRF R5500 Real Time Spectrum Analyzer Programmer's Guide...

  • Page 42: Esr

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

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

  • Page 44: Wai

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

  • Page 45: System:communicate:lan:configure

    The query will return the LAN DNS address(es) set or that of the actual current configuration if one is not issued. The CURRENT query will return what is currently and actually used by the RTSA's LAN interface. Syntax SYSTem:COMMunicate:LAN:DNS <main DNS>[,alternative DNS] SYSTem:COMMunicate:LAN:DNS? [CURRENT] ThinkRF R5500 Real Time Spectrum Analyzer Programmer's Guide...

  • Page 46: System:communicate:lan:gateway

    The CURRENT query will return what is currently and actually used by the RTSA's LAN interface. Syntax SYSTem:COMMunicate:LAN:IP <IPv4 address> SYSTem:COMMunicate:LAN:IP? [CURRENT] Parameter Set: D.D.D.D where D = 0 – 255 Query: [CURRENT] Response D.D.D.D I/O Data Type String ThinkRF R5500 Real Time Spectrum Analyzer Programmer's Guide...

  • Page 47: System:communicate:lan:netmask

    The query will return the maskaddress set or that of the actual current configuration if one is not issued. The CURRENT query will return what is currently and actually used by the RTSA's LAN interface. ThinkRF R5500 Real Time Spectrum Analyzer Programmer's Guide...

  • Page 48: System:communicate:ntp

    *RST State SYSTEM:COMMUNICATE:NTP 129.6.15.28 Examples SYST:COMM:NTP? Note: This feature could also be set through R5500'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 49: System:error:all

    Example :SYSTem:FLUSh This command clears the R5500's internal data storage buffer of any data that is waiting to be sent. Thus, it is recommended that the flush command should be used when switching between different capture modes to clear up the remnants of data in the RTSA.

  • Page 50: System:lock:request

    :SYST:LOCK:HAVE? ACQ :SYSTem:LOCK:REQuest? This query attempts to attain the lock on the R5500 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 R5500.

  • Page 51: System:sync:master

    :OUTput:MODE is defaulted to DIGitizer WBIQ are special R5500 variants, not available on all R5500s. Contact ThinkRF for more details on the usage of these variants. :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 52: System:version

    Example :SYST:VERS :SYSTem:DATE This command sets or queries the current date of the R5500. When the date is set, the change is applied to the real time clock (RTC) of the R5500 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 53: System:time:adjust

    :SYSTEM:TIME:ADJUST? :SYSTem:TIME:SYNC This command selects the time synchronization source for R5500 and the query returns the source selected. Choosing NTP (Network Time Protocol) as the synchronization source will impact the system real time clock (RTC), causing it to update either at a continuous interval or one time only.
  • Page 54 SCPI Command Set Syntax :SYSTem:TIME:SYNC:STATus? Parameter None Response Data Type :SYST:TIME:SYNC:STAT? Examples ThinkRF R5500 Real Time Spectrum Analyzer Programmer's Guide...

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

  • Page 56: Status:operation[:Event]

    The data in this register is continuously updated to reflect the most current conditions. See Figure 13 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 R5500 Real Time Spectrum Analyzer Programmer's Guide...

  • Page 57: Status:operation:enable

    0 – 32767 (2 *RST State :STAT:OPER:ENAB 256 Examples :STAT:OPER:ENAB? :STATus:PRESET This command presets the R5500 (similar to *RST), and OSE and QSE to zero. Syntax :STATus:PRESET Parameter/Response None :STATus:QUEStionable[:EVENt]? This command queries the standard Questionable Status Register (QSR) for any event.

  • Page 58: Status:questionable:enable

    This command queries the RTSA's internal temperature provided by one or more temperature sensors. The response field varies depending on how many sensors are available in a RTSA model. The R5500 model, for instance, returns comma separated values for the sensors at the RF, Mixer and Digital sections.

  • Page 59: Input Commands

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

  • Page 60: Input:gain:hdr

    :INP:GAIN 1 0 Note: The reference level context information (see page 31) is only valid when all the gain stages are enabled for R5500-418, 427 and their variants. Table 37: Performance of The Gain Settings of R5500-418, 427 and Their Variants...

  • Page 61: Input:mode

    SCPI Command Set :INPut:MODE This command sets or queries the R5500's RFE mode of operation. Notes: The RFE modes affect the data packing method due to the different output data width. The type of DSP applied would also change the data output of some of the modes as well.

  • Page 62: Source:reference:pll:reset

    1, 2 and 4. In the remaining RFE modes, R5500 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 63: [: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, R5500-408 has a range of 0.1 to 8GHz, while R5500-427 has 0.1 to 27GHz.

  • Page 64: [:Sense]:Frequency:inversion

    SCPI Command Set This command works in all R5500 models but the number and significance of the IF frequencies will vary depending on the model and configured options (see :SYSTem:OPTions? command). The IF index can be specified either as a positive...

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

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

    Example OUTput Commands :OUTput:MODE This command sets or queries the R5500's IQ output path to use the digitizer section for data output or the direct output to the IQ connector port of the RTSA. Important Notes: - When the CONNector option is selected:...

  • Page 67: Trigger Commands

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

  • Page 68: Trigger:periodic

    Data Payload Format, page 36. ThinkRF's R5500 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 69: Trace:block:data

    The R5500 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 70: 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 R5500 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 a RTSA and the data output format.

  • Page 71: 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 R5500 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 72: Trace:stream:stop

    A sweep entry is created by using either :NEW or :COPY and :SAVE command. The entry will not be part of a list until :SAVE is issued. ThinkRF R5500 Real Time Spectrum Analyzer Programmer's Guide...

  • Page 73: Sweep:list:iterations

    :SWEep:LIST:STARt command is issued, this will initiate also the data capturing and data packets will be “pushed” from the R5500 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 74: Sweep:list:status

    Examples :SWEEP:LIST:STOP :SWE:LIST:STOP Note: This command should be issued to clear the R5500's data buffer of any data that has not been sent from the R5500 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 75: 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 :SWEEP:ENTRY:NEW Examples ThinkRF R5500 Real Time Spectrum Analyzer Programmer's Guide...

  • Page 76: Sweep:entry:read

    [Entry index value] 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 59) for the definition of this command. ThinkRF R5500 Real Time Spectrum Analyzer Programmer's Guide...

  • Page 77: Sweep:entry:attenuator:variable

    If a range is not given, the step size is ignored. Syntax :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 R5500 model used ThinkRF R5500 Real Time Spectrum Analyzer Programmer's Guide...

  • Page 78: Sweep:entry:frequency:shift

    (as explained in the previous paragraph). When the trigger type is NONE, dwell time is ignored. Syntax :SWEep:ENTRy:DWELl <integer>[,<integer>] :SWEep:ENTRy:DWELl? Parameter <second>[,<microsecond>] Allowable Values 0 – 4294967295 (or 2 – 1) 0,0 := infinity Query Response <integer>,<integer> ThinkRF R5500 Real Time Spectrum Analyzer Programmer's Guide...

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

  • Page 80: Appendix A: Connecting To Rtsa

    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 R5500” of the R5500 User Guide (v4.0 or later) for more information on how to connect to R5500 and to determine its IP address.

  • Page 81: Appendix B: Protocol For Discovering Rtsa

    Appendix B: Protocol for Discovering RTSA Appendix B: Protocol for Discovering RTSA ThinkRF uses a simple broadcast UDP protocol for discovering any RTSAs available on the same local network as the host computer. This protocol can not be used to find any RTSAs on a different network.

  • Page 82: 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:ANT 1\n”. ThinkRF R5500 Real Time Spectrum Analyzer Programmer's Guide...

  • Page 83: Notation

    Non-decimal numeric value such as hexadecimal, octal or binary <char> Character program data <character> Ex: MAXimum or MEDium <string> ASCII string surrounded by single or double quotes Ex: “This is an example” ThinkRF R5500 Real Time Spectrum Analyzer Programmer's Guide...

  • Page 84: Default Units

    Note the following examples, which are all equivalent. :FREQ:CENTer 2441.5 MHz Example :FREQ:CENTer 2441500000 is equivalent to :FREQ:CENTer 2441500000 Hz is equivalent to is equivalent to :FREQ:CENTer 244150 kHz is equivalent to :FREQ:CENTer 2441.5e6 ThinkRF R5500 Real Time Spectrum Analyzer Programmer's Guide...

  • Page 85: Appendix D: Scpi Status And Event Registers

    Description Operation Complete Set to indicate that all pending operations are complete and (OPC) the R5500 is ready to accept another command, or that query results are available. Request Control (RQC) This bit is not used and is always 0.

  • Page 86: Operational Status (Osr) Register

    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 R5500 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 87: 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 Real Time Spectrum Analyzer Programmer's Guide...

  • Page 88: 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 R5500. 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 89 Register (QSR) for any event [:EVENt]? :CONDition? :ENABle <integer> v1.0 :ENABle? :TEMPerature? Return the R5500's internal ambient v1.0 temperature :SWEep Page :LIST :ITERations <integer> Define the number of times the list is repeated v1.0 during execution ThinkRF R5500 Real Time Spectrum Analyzer Programmer's Guide...

  • Page 90: Level

    Default 0.0 sec. :DWELl? :PPBlock Same as :TRACe:BLOCk:PACKets, page v1.0 :PPBlock? :SPPacket As defined in :TRACe:SPPacket, page v1.0 :SPPacket? :TRIGger :LEVel As defined in :TRIGger:LEVel, page v1.4 :LEVel? ThinkRF R5500 Real Time Spectrum Analyzer Programmer's Guide...
  • Page 91 Return the current lock state of the task v1.0 specified :REQuest? ACQuisition Request the R5500 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 92 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 Real Time Spectrum Analyzer Programmer's Guide...

  • Page 93: Wsa5000 Vs. R5500 List Of Changes

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

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

  • Page 95: 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 April 10, 2017 - Updated “Allowable Values” for :INPut:GAIN...

Table of Contents