Table of Contents
Advertisement
Quick Links
Download this manual
See also:
User Manual
ThinkRF WSA5000
Wireless Signal Analyzer
Version 3.6.3
Programmer's Guide
December 01, 2016
Document no. 75-0014-150216
Copyright © 2013, 2014, 2015, 2016 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 WSA5000 Series
Summary of Contents for ThinkRF WSA5000 Series
- Page 1 Version 3.6.3 Programmer's Guide December 01, 2016 Document no. 75-0014-150216 Copyright © 2013, 2014, 2015, 2016 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 (1) year from the date of shipment as identified by the Customer’s and is subject to change packing slip or carrier waybill. ThinkRF reserves the right to void the warranty on any without notice. ThinkRF...
-
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 WSA5000 Functional Overview .................... - Page 4 IQ Swapped Indicator ..................... 36 New Stream Start ID ....................... 36 New Sweep Start ID ....................... 36 IF Data Packet Class ......................37 Picosecond Timestamp Words Format ................38 Data Payload Format ...................... 38 Trailer Word Format ....................... 40 SCPI Command Set ........................
- Page 5 :INPut:ATTenuator ........................ 60 :INPut:ATTenuator:VARiable ....................60 :INPut:FILTer:PRESelect ...................... 60 :INPut:GAIN .......................... 61 :INPut:GAIN:IF ........................61 :INPut:GAIN:HDR ......................... 62 :INPut:MODE ........................62 SOURce Commands ....................... 63 :SOURce:REFerence:PLL ....................63 :SOURce:REFerence:PLL:RESET ..................63 SENSe Commands ........................64 [:SENSe]:CORRection:DCOFfset ..................64 [:SENSe]:DECimation ......................64 [:SENSe]:FREQuency:CENTer ....................
- Page 6 :SWEep:ENTRy:PPBlock ..................... 81 :SWEep:ENTRy:SPPacket ....................82 :SWEep:ENTRy:TRIGger:LEVel ................... 82 :SWEep:ENTRy:TRIGger:TYPE ................... 82 Appendix : Connecting to WSA ..................82 Appendix : Protocol for Discovering WSA ..............84 Appendix : SCPI Command Syntax .................. 85 Entering Commands ....................... 85 Notation ............................. 86 Parameter types ........................
-
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 External Local Oscillator 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... -
Page 8: List Of Figures
List of Figures Figure 1: WSA5000 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 ......................... 20 Figure 5: DDC Functional Block Diagram .................... -
Page 9: List Of Tables
Table 7: The Categories of VRT Packet Streams Supported by ThinkRF's WSA5000 ......28 Table 8: A List of Stream Identifiers As Used by ThinkRF for Different Packet Classes ......29 Table 9: Receiver Context Packet Class Structure ................. 30 Table 10: Receiver Context Indicator Field Positions ................ -
Page 10: Preface
Before you work on any equipment, be aware of the hazards involved with electrical circuitry and be familiar with the standard practices for preventing accidents. Obtaining Documentation and Releases You can access the most current ThinkRF documentation at http://www.thinkrf.com/resources and release bundles at http://www.thinkrf.com/releases. -
Page 11: Document Feedback
The ThinkRF Support website provides online documents for resolving technical issues with ThinkRF products at this URL: http://thinkrf.com/documentation/. 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 support@thinkrf.com or by calling +1.613.369.5104. -
Page 12: Wsa5000 Functional Overview
Xilinx FPGA with embedded MicroBlaze microprocessor, Gigabit Ethernet • interface and custom embedded digital signal processing (DSP) logic; 128 or 256 MB of DDR3 for real-time caching of digitized data; and • a general purpose input/output (GPIO) port. • ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 13: Figure 1: Wsa5000 Functional Block Diagram
WSA5000 Functional Overview Figure 1: WSA5000 Functional Block Diagram ThinkRF's products conform with standardized protocols for interoperability. ThinkRF provides application programming interfaces (APIs) designed for easy integration with third-party applications. Standard protocols include the Standard Commands for Programmable Instruments (SCPI) protocol for controlling and obtaining status from the WSA and the VITA-49 Radio Transport (VRT) protocol for digitized data and its associated context information. -
Page 14: Table 1: System Level Control/Status Commands
:OPERation Returns the standard Operation Status Register (OSR) for any event [:EVENt]? :CONDition? :ENABle[?] :PRESET Presets the WSA5000 (similar to *RST) :QUEStionable Returns the standard Questionable Status Register (QSR) for any event [:EVENt]? ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 15: The Architecture
Traces and sweeps are controlled by the capture controller as illustrated in the lower portion of Figure 2. A trace and a sweep are defined as a single (block or continuously streamed) capture and a series of captures, respectively, each with their associated hardware configurations. ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 16: Figure 2: Rf Receiver Front-End And Capture Controller Functional Block Diagram
Figure 2: RF Receiver Front-end and Capture Controller Functional Block Diagram The WSA5000 supports different RFE modes of operation and subsequent DSP capabilities as per Table 2 and as described in the following subsections. ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 17: Rf Receiver Front-End
12-bit WB ADC, hence, the subscript of 14 for IQ or I. The 40MHz SH is only available in WSA5000 product version 1.3 (hardware revision 3) and higher. Revision 2 hardware value varies between 30 or 35MHz, contact ThinkRF's Support for further details. See... -
Page 18: Direct-Conversion Receiver Technology
Several options such as calibration or dynamic offset compensation in software have been described in the open literature. Analog filter Offset Fc-50 MHz Fc+50 MHz 125 MHz Figure 3: DC Offset with Amplitude Roll-Off at +50MHz ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 19: Iq Offset Correction
= (qData/amplitude) * ratio .* (iData/amplitude); sinphi = 2 * sum(p) / numberOfSamples; phi_est = -asin(sinphi); calibratedQ = ((sin(phi_est) * iData) + (ratio * qData)) / cos(phi_est); Signal Image Frequency Fc+Fs Fc-Fs calibrateIQ Frequency ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 20: Digital Signal Processing
Digital Signal Processing The WSA5000 has embedded DSP blocks to provide further signal processing capabilities, such as DDC with up to 10 levels of decimation and FFT computation. ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 21: Digital Down Converter
The following describes the different types of triggers and their common controls. Selection of different types is mutually exclusive. ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 22: Frequency Domain Triggering
20dBm of the noisefloor, the threshold error increases as the signal gets closer to the noisefloor. Note: The threshold error is relative to the measured input signal level, which is dependent on the calibrated reference level. The reference levels could be custom ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 23: Periodic Triggering
WSA5000's GPIO. The trigger “signal” could be a single pulse or a sync-word. See Synchronized Sweep (page 26) for additional details. Caution: Contact ThinkRF's Support for details on how to use the GPIO port prior to connecting anything to the port. Table 4: Trigger Control/Status Commands SCPI Command... -
Page 24: Trace Capture Control
A sweep setup consists of defining a list or multiple lists and executing one of the defined lists, with each list consisting of one or more entries storing different capture engine configurations. A list may be edited, deleted and/or executed using the :SWEep:LIST command set. ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 25: Table 6: Sweep Capture Control/Status Interface
Defines the amount of frequency that the center frequency is stepped by :SHIFt[?] As defined in [:SENSe]:FREQuency:SHIFt, page :GAIN :IF[?] As defined in :INPut:GAIN:IF, page :HDR[?] As defined in :INPut:GAIN:HDR, page :MODE As defined in :INPut:MODE, page ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 26: Synchronized Sweep
8 nsec). This delay wait time accounts for the typical worst-case front-end setup time and for differences in the synchronization cable length. Master and slaves then begin the capture upon the expiration of the wait (or delay). ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 27: Figure 7: Synchronized Sweep Using Sync-Word
Figure 8: Synchronized Sweep with a Missed Capture SWEep Commands section (page 74) for further interface details. ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 28: Vita-49 Radio Transport Protocol
Extension Context Stream RECEIVER DIGITIZER IF Data Stream Figure 9: Connectivity and 4 Different Packet Streams Supported by WSA5000 Table 7: The Categories of VRT Packet Streams Supported by ThinkRF's WSA5000 Standard Formats Custom Formats Contents IF Context Packet Stream... -
Page 29: Packet Classes And Streams
Stream Identifiers used by ThinkRF for different Packet Class Stream. Each ID will be mentioned in the subsequent corresponding Packet Class sections. Table 8: A List of Stream Identifiers As Used by ThinkRF for Different Packet Classes Stream Identifier Packet Class... -
Page 30: Table 9: Receiver Context Packet Class Structure
Table 11: Receiver Context Field Definition and Values 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 WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 31: Context Field Change Indicator
31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16 15 14 13 12 11 10 Reserved Integer Temperature Fractional Temp. The valid range of the Temperature field is -273.15 °C to +511.984375 °C. The resolution of the Temperature field is 0.015625 °C (1/64 °C). ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 32: Digitizer Context Packet Class
31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16 15 14 13 12 11 10 13. The Digitizer Context Fields section shall contain a context field for every field that is indicated to be present in the Context Indicator Field. The fields shall be ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 33: Context Field Change Indicator
The absolute power level P (in dBm) is then computed using the following formula: P=R+20∗log( IQ measured with √ measured where: R = the reference level provided in the VRT context packet, dBm ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 34: 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 WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 35: Table 21: Extension Context Packet Class Structure
Context Indicator Field. The fields shall be ordered in the identical order of their occurrence in the Context Indicator Field. See Table 23 for the definition and associated value of each field. ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 36: Context Field Change Indicator
Further information on the algorithm and its usage will be provided in a future release. Contact ThinkRF's Support for more information if necessary. New Stream Start ID The New Stream Start ID indicator indicates a new stream capture has started, any packets following this Context Packet belong to this new stream capture. -
Page 37: If Data Packet Class
7. Pkt Size shall be the number of 32-bit words that are present in the packet, including all headers, data payload and trailer if included. 8. Stream Identifier shall have the values as shown in the following Table ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 38: Picosecond Timestamp Words Format
16-bit. Thus, each component is an integer ranging from -8192 to +8191 (or ±2 5. The I-component is in the upper 16-bit of each data word followed by the Q- component in the lower 16-bit, as seen in Table ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 39: Table 30: {I14Q14} Data Payload Arrangement With Upper 2-Bit Of Each Item Signed Extended To {I16 Q16
31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16 15 14 13 12 11 10 0bxxxxxxxx Item 1 (Sample 1 I 0bxxxxxxxx Item 2 (Sample 2 I 0bxxxxxxxx Item 3 (Sample 3 I Examples conversion: ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 40: Trailer Word Format
:OUTput:IQ:MODE CONNector with :INPut:MODE 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). ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 41: Figure 10: An Example Illustrating Uninverted And Inverted Spectrums
This condition occurs only in 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 WSA5000 Wireless Signal 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 WSA5000 Wireless Signal Analyzer. The WSA5000 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. Figure 13 for the ESE/ESR register bits mapping. Syntax *ESE <integer> *ESE? Parameter/Response <integer> Allowable Values 0 - 255 ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 44: Esr
Syntax *OPC *OPC? Parameter None Query Response *RST Resets the WSA5000 to its default settings. This includes stopping any running capture mode and trigger mode, and also performs :SYSTem:FLUSh. ThinkRF WSA5000 Wireless Signal 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 WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 46: Wai
Response <character> Example :SYST:CAP? :SYSTem:CAPTure:MODE? This command returns what the current WSA data capture mode is (i.e. sweeping, streaming or block mode). When stream or sweep mode is stopped, block mode will resume. ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 47: System:communicate:lan:apply
WSA 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 *RST State :SYST:COMM:LAN:CONF DHCP Examples :SYST:COMM:LAN:CONF? CURRENT ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 48: System:communicate:lan:dns
SYSTEM:COMMUNICATE:LAN:GATEWAY? SYST:COMM:LAN:GATE? CURRENT :SYSTem:COMMunicate:LAN:IP The set command will store the new LAN IP to be applied to the WSA. This command does not take effect until :SYSTem:COMMunicate:LAN:APPLy is sent (please refer to the ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 49: System:communicate:lan:netmask
Note: It is recommended to do this query command after each non-query command is sent to ensure that the non-query command is executed without error. Since each error message is queued into a buffer, if multiple commands have been sent follow by only one ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 50: System:error:all
With Streaming or Sweeping, the start ID in a VRT extension packet marks the beginning of packets belonging to the new stream or sweep. This helps to distinct old packets from new packets. Syntax :SYSTem:FLUSh Parameter/Response None *RST State :SYST:FLUSH Examples ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 51: System:lock:have
This application would then need to request the lock. Syntax :SYSTem:LOCK:REQuest? ACQuisition Parameter ACQuisition Input Data Type Character Response 1 | 0 1 – Successfully locked 0 – Failed to lock Output Data Type Boolean *RST State :SYST:LOCK:REQ? ACQ Example ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 52: System:options
ELO and/or WBIQ are special WSA5000 variants, not available on all WSA5000s. Contact ThinkRF for more details on the usage of these variants. :SYSTem:SYNC:MASTer This command sets the WSA 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 53: System:sync:wait
Parameters/Response <year>,<month>,<date> I/O Data Type String (comma separated integers) Allowable Values Year: YYYY - requires a four digit integer Month: 1 - 12 Date: 1 - 31 *RST State Examples :SYST:DATE 2012,12,2 :SYSTEM:DATE? ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 54: System:time
:SYSTem:DATE and/or :SYSTem:TIME commands are used to change the time, the source will automatically be changed to DISable. *RST does not affect this command. At factory install, the synchronization is defaulted to disabled. ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 55: System:time:sync:status
:SYSTEM:TIME:SYNC? :SYSTem:TIME:SYNC:STATus? This command returns the current status of the time synchronization. Further information will be provided in a future revision of this document. Syntax :SYSTem:TIME:SYNC:STATus? Parameter None Response Data Type Examples :SYST:TIME:SYNC:STAT? ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 56: Status Commands
The STATus commands control the SCPI-defined status-reporting structures as illustrated in Figure SCPI defines the QUEStionable, OPERation, Instrument SUMmary and INSTrument registers in addition to those in IEEE 488.2. These registers conform to the IEEE 488.2 ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 57: Status:operation[:Event]
The data in this register is continuously updated to reflect the most current conditions. 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 Example :STAT:OPER:COND? ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 58: Status:operation:enable
*RST State None :STAT:QUES? Example :STATus:QUEStionable:CONDition? This command queries the standard Questionable Condition Register (QCR) for any questionable event. The query returns the decimal sum of the bits set in the QCR. The ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 59: Status:questionable:enable
WSA model. The WSA5000 model, for instance, returns comma separated values for the sensors at the RF, Mixer and Digital sections. Syntax :STATus:TEMPerature? Parameter None Response <NRf>{,<NRf>} For WSA5000: <RF>,<Mixer>,<Digital> Output Data Type Float Unit degrees Celsius *RST State None ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 60: Input Commands
:INP:ATT:VAR 5 Examples :INPUT:ATT:VAR? This command is not available for sweep mode. The desired attenuation should be set before sweep mode starts. :INPut:FILTer:PRESelect This command sets or queries the RFE preselect filter selection. ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 61: Input:gain
This command sets or queries the input gain stage for a WSA. The number of gain stages is dependent on the models as listed below. Any out of range index will result in an Execution Error response. Contact ThinkRF's Support for further details and the gain ranges of each stage. -
Page 62: Input:gain:hdr
Table 2 for the IBW of each mode and the related notes. - If :OUTput:IQ:MODE CONNector is to be used with SH or SHN mode, see the Important Note listed under that command. ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 63: Source Commands
INT | EXT I/O Data Type Character *RST State :SOURCE:REF:PLL INT Examples :SOUR:REF:PLL? :SOURce:REFerence:PLL:RESET This command resets the 10MHz reference clock in to the internal source. Syntax :SOURce:REFerence:PLL:RESET Parameter/Response None *RST State :SOURCE:REF:PLL:RESET Examples ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 64: Sense Commands
55MHz in WBIQ model or 35MHz in all others to the zero IF before decimation is applied. This implies the VRT data output will be I and Q for SH/SHN with decimation. Syntax :SENSe:DECimation OFF | <integer> :SENSe:DECimation? [MAX | MIN] Parameter OFF | <decimation value> ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 65: [:Sense]:Frequency:center
[:SENSe]:FREQuency:CENTer <NRf [unit]> [:SENSe]:FREQuency:CENTer? [MAX | MIN] Parameters <center frequency [unit]> Input Data Type Double [character] Allowable Values Varies depending on the product model Query Response <integer> Default I/O Unit *RST State 2400000000 ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 66: [:Sense]:Frequency:if
RFE's IQIN mode will not be available. Issuing :INPut:MODE IQIN will result in a SCPI error being returned. Please see “The Use of ThinkRF Products with External Local Oscillators” AppNote for more important details. Syntax [:SENSe]:FREQuency:LOSCillator? <1 | 2 | 3>... -
Page 67: [:Sense]:Frequency:shift
This command queries the frequency resolution value. Syntax [:SENSe]:FREQuency:RESolution? Parameter None Query Response <integer> Default Output Unit Example :FREQ:RES? [:SENSe]:LOCK:REFerence? This command queries the lock status of the PLL reference clock in the digital card. ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 68: [:Sense]:Lock:rf
Table 35 is required depending on the frequency input. The spectral inversion indicator is available through the GPIO port. Contact ThinkRF's Support for further details. - The CONNector mode only works on certain WSA5000 model. Verify that your product supports this method. -
Page 69: Output:iq:connector:inversion
The LEVel trigger type is condition by the start and stop frequencies range and the amplitude level. See the :TRIGger:LEVel command. The PULSe and WORD trigger types belong to the external synchronization trigger through a GPIO port (see External Triggering, page 23). ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 70: Trigger:level
Further information will be provided in a future revision of this document. :TRIGger:STATus? This command returns the status of the current enabled trigger as to whether it is pending or It is cleared once the data buffer is cleared out. has occurred. ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 71: Trace Commands
Data Payload Format, page 38. ThinkRF's WSA5000 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 72: Trace:block:packets
– (WSA's max storage storage capacity ÷ (# bytes-per-sample * (SPP value + 6 Header and trailer words))) Input Data Type Integer | Character Allowable Values 1 – (WSA's max storage storage capacity ÷ (# bytes-per-sample * ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 73: Trace:sppacket
:TRAC:SPP? :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 WSA5000 whenever data is available. ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 74: Trace:stream:stop
:LIST. A sweep list can be thought of as being similar to a spreadsheet or table where the columns define the different specific capture engine configurations (such as :FREQuency ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 75: Sweep:list:iterations
The sweep will not be affected and keep on running. However, sweep related settings can still be changed while sweep is running. :SWEep:LIST:ITERations This command sets or queries the number of times the sweep list is repeated. ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 76: Sweep:list:start
:SWEEP:LIST:STAR Examples :SWE:LIST:START :SWEep:LIST:STATus? This query returns the current status of the sweep engine. Syntax :SWEep:LIST:STATus? Parameter None Query Response RUNNING | STOPPED Output Data Type Character *RST State STOPPED :SWEEP:LIST:STATUS? Examples :SWE:LIST:STAT? ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 77: Sweep:list:stop
*RST State Examples :SWEEP:ENTR:COPY :SWE:ENTRY:COPY :SWEep:ENTRy:COUNt? This query command returns the number of entries available in a list. Syntax :SWEep:ENTRy:COUNt? Parameter None Query Response <integer> Output Data Type Integer *RST State Examples :SWEEP:ENTR:COUNT? ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 78: Sweep:entry:delete
:SWEEP:ENTR:READ? 5 Examples :SWE:ENTR:READ? 1 :SWEep:ENTRy:SAVE This command saves a new entry into the current editing list with all the current capture engine configurations under :SWEep:ENTRy. The saving is done by inserting either the ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 79: Sweep:entry:attenuator
This command or query defines the center frequency or a range of center frequencies to sweep. When a range is provided, the sweep will step through the center frequencies with the value provided by :SWEep:ENTRy:FREQuency:STEP. ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 80: Sweep:entry:frequency:step
[:SENSe]:FREQuency:SHIFt section (page 67) for the definition of this command. :SWEEP:ENTR:FREQ:SHIFT 25 MHZ Examples :SWEEP:ENTRY:FREQ:SHIF? :SWEep:ENTRy:GAIN:HDR Refers to the :INPut:GAIN:HDR section (page 62) for the definition of this command. :SWEEP:ENTR:GAIN:HDR -10 Examples :SWEEP:ENTRY:GAIN:HDR? ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 81: Sweep:entry:gain:if
Refers to the :TRACe:BLOCk:PACKets section (page 72) for the definition of this command. Examples :SWEEP:ENTR:PPB 10 :SWEEP:ENTRY:PPB? ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 82: Sweep:entry:sppacket
:SWEEP:ENTRY:TRIG:TYPE? Appendix A: Connecting to WSA ThinkRF's WSAs are network ready devices conveying control commands and data using TCP/IP protocol. Each WSA receives SCPI commands and sends query responds over port 37001, and sends VRT context and data packets over port 37000, as illustrated in... - Page 83 Appendix A: Connecting to WSA In addition, refer to the “Connecting to the WSA5000” of the WSA5000 User Guide (v3.6 or later) for more information on how to connect to WSA5000 and to determine its IP address. ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide...
-
Page 84: Appendix : Protocol For Discovering Wsa
Appendix B: Protocol for Discovering WSA Appendix B: Protocol for Discovering WSA ThinkRF uses a simple broadcast UDP protocol for discovering any WSAs available on the same local network as the host computer. This protocol can not be used to find any WSAs on a different network. -
Page 85: Appendix : 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 WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 86: Notation
<NRr> 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 WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 87: 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 WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 88: Appendix : Scpi Status And Event Registers
WSA5000 is ready to accept another command, or that query results are available. Request Control (RQC) This bit is not used and is always 0. Query Error (QYE) Set to indicate that a query has been made for which no ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 89: Operational Status (Osr) Register
The WSA5000 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 WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 90: Appendix : Scpi Error Codes Used
Read trace command issued while there is no data available. -911 Please upgrade firmware The current firmware needs upgrading. -912 Invalid option license The option could not be installed because of invalid license. ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 91: Appendix : Scpi Commands Quick Reference
<index> Selects the variable IF gain stages <NR1 [unit]> :IF? :HDR Sets gain level for the narrow-band ADC of the v3.1 – :NB HDR signal path v3.2.1 – :HDR :HDR? [MAX | MIN] ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... - Page 92 Queries the lock status of the RFE's RF PLL v3.0 :SOURce Page :REFerence Selects the 10MHz reference clock source :PLL INT | EXT v3.0 :PLL? Resets the 10MHz reference selection to :RESET v3.0 INTernal source ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide...
- Page 93 As defined in :INPut:FILTer:PRESelect, page :PRESelect? :FREQuency :CENTer <NRf [unit]>[,<NRf [unit]>] Sets the center frequency or a range of center v3.0 frequencies that are stepped by the value ::= <start freq>[,<stop freq>] defined by :SWEep:ENTRy:FREQuency:STEP ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide...
- Page 94 This command should be applied only once all the required LAN settings have been set. :CONFigure DHCP | STATIC Set the WSA's LAN to use DHCP or STATIC v3.2.3 configuration type ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide...
- Page 95 Adjust the system time relative to it's current time :MODE Synchronize one time only or continuously :MODE? DISable | NTP,{ONCE | :SYNC Selects the synchronization source and mode CONTinuous} :SYNC? :STATus? Returns the status of the time synchronization :TIME? v3.2.1 ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide...
- Page 96 Returns the status of the active trigger as to whether it is pending or has occurred :TYPE LEVel | PERiodic | PULSe | Sets or disables the trigger type v3.1.2 – WORD | NONE PULSE | WORD | NONE :TYPE? ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide...
-
Page 97: 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 WSA5000 Wireless Signal Analyzer Programmer's Guide... -
Page 98: Document Revision History
SYSTem:FTUNe back to [:SENSe]:FREQuency:SHIFt :SWEep:ENTRy:FREQuency:SHIFt as it was originally. And corrected the allowable range to be -62.5MHz to 62.5MHz - Changed Figure 11 - Updated :TRACe:SPPacket definition and Table 37 (was Table 35) ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide... - Page 99 - Changed maximum SPP for all RFE modes to 65520 - Added a note to Table 36 :SYSTem:OPTions? regarding external local oscillator option only available to specific WSA5000 variant - Enabled RFE's DD mode available for package release v3.2.2 ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide...
- Page 100 - Added support for WSA5000-XXX-HIF model (code 002 for :SYSTem:OPTions? :INPut:MODE[?] HIF) - Added the new command [:SENSe]:FREQuency:IF? for determining the IF frequencies used for the current input mode and center frequency v3.5.1 Jun.10.2015 - Added :INPut:ATTenuator:VARiable[?] command for WSA5000-418 ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide...
- Page 101 - Some minor SCPI commands clean up and removed “Reference Point” from the Receiver Context section Document Version is not the same as the firmware Release Version as mentioned in Appendix F: SCPI Commands Quick Reference. ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide...
Need help?
Do you have a question about the WSA5000 Series and is the answer not in the manual?
Questions and answers