ThinkRF WSA5000 Series Programmer'S Manual Download Page 72

SCPI Command Set

:TRACe:SPPacket

 command.  The data within a single block capture trace is continuous 

from one packet to the other, but not necessary between successive block capture 
commands issued.

Syntax

:TRACe:BLOCk:DATA?

Parameter

None

Response

Control port 37001: empty string
Data port 37000: <NRr>

Output Data Type

Hexadecimal bytes

*RST State

N/A

Examples

:TRACE:BLOCK:DATA?

Note:

 The status of the query will be return through the control port 37001 as usual, 

however the data will be returned through the data port 37000.  Once the  
:TRACe:BLOCk:DATA? command is issued, a block of SPP * PACKets of data will be 
returned.  In other words, :TRACe:BLOCk:DATA? needs to be sent only once to get SPP 
* PACKets block of data. 

The returned data in each VRT packet is presented in continuous hexadecimal chunk, as 
shown here:

Response <NRr> ::= <VRT header bytes>{<data payload bytes>}

[<4 bytes VRT trailer>]

Further description on the VRT data output formats can be found in the VRT's 

IF Data 

Packet Class

 section, page 

37

.

 :TRACe:BLOCk:PACKets

This command sets or queries the total number of packets set in the WSA.  The 
maximum is limited by the storage capacity of a WSA5000 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 WSA and the data output format.  For example, the WSA5000 has 128 MBytes storage 
capacity, if SPP is 32768 with I

14

Q

14

 output format, then the maximum packet size is 1023

(or 128 MB / (4 bytes-per-sample * (32768 + 6))).  If I

14

 is the output format, then the 

maximum is 2047 (or 128 MB * / (2 bytes-per-sample * (32768 + 6))).

In single block capture mode, this command is used in conjunction with the

:TRACe:SPPacket

 command to set the total number of samples to capture.  In other 

words, the data from one packet to the next within a single block capture mode is 
continuous.

Syntax

:TRACe:BLOCk:PACKets <integer>
:TRACe:BLOCk:PACKets? [MAX | MIN]

Parameter

<input packet value>
[MAX | MIN] 

for query1 –  (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 * 

72

ThinkRF WSA5000 Wireless Signal Analyzer Programmer's Guide

Summary of Contents for WSA5000 Series

Page 1: ...r 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...

Page 2: ...ranty policy all costs of repairs and shipping will be charged directly to the Customer ThinkRF will warrant repaired units for a period of 90 days from date of shipment from ThinkRF to the Customer I...

Page 3: ...gital Down Converter 21 Triggers 21 Frequency Domain Triggering 22 Periodic Triggering 23 External Triggering 23 Capture Controller 23 Trace Capture Control 24 Sweep Capture Control 24 Synchronized Sw...

Page 4: ...CONFigure 47 SYSTem COMMunicate LAN DNS 48 SYSTem COMMunicate LAN GATEway 48 SYSTem COMMunicate LAN IP 48 SYSTem COMMunicate LAN NETMask 49 SYSTem ERRor NEXT 49 SYSTem ERRor ALL 50 SYSTem FLUSh 50 SY...

Page 5: ...Version 69 TRIGger Commands 69 TRIGger TYPE 69 TRIGger LEVel 70 TRIGger PERiodic 70 TRIGger STATus 70 TRACe Commands 71 TRACe BLOCk DATA 71 TRACe BLOCk PACKets 72 TRACe SPPacket 73 TRACe STReam STARt...

Page 6: ...ommand Syntax 85 Entering Commands 85 Notation 86 Parameter types 86 Default Units 87 Appendix SCPI Status and Event Registers 88 Status Byte Register SBR 88 Standard Event Status Register ESR 88 Oper...

Page 7: ...onics Engineers IF Intermediate Frequency IQ In phase and Quadrature IQIN External I and Q Input LAN Local Area Network MB Mega Bytes MSB Most Significant Byte NB Narrowband NCO Numerically Controlled...

Page 8: ...6 Association between Time and Frequency Domain 22 Figure 7 Synchronized Sweep using Sync Word 27 Figure 8 Synchronized Sweep with a Missed Capture 27 Figure 9 Connectivity and 4 Different Packet Stre...

Page 9: ...evel Field Format 34 Table 20 RF Frequency Offset Word Format 34 Table 21 Extension Context Packet Class Structure 35 Table 22 Extension Context Indicator Field Positions 35 Table 23 Receiver Context...

Page 10: ...ink to the referenced source that can be clicked on Normal Bold Font When used within a sentence or a paragraph it emphasizes an idea to be paid attention to particularly Red Font Conveys special info...

Page 11: ...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 Before conta...

Page 12: ...and or distributed wireless signal analysis It is ideal for monitoring management and surveillance of transmitters whether they are in building or spread across a geographic area Applications include...

Page 13: ...applications The Python API is built within the PyRF development framework and is open source under BSD licensing PyRF handles the low level details of real time acquisition signal processing and visu...

Page 14: ...tion that has the lock can perform the task OPTions Returns comma separated 3 digit values to represent the hardware option s or features available with a particular WSA model SYNC MASTer Sets a WSA u...

Page 15: ...are connecting to the unit it is advised that only one of those is controlling the unit at any time The Architecture The WSA5000 is an integrated wireless radio receiver and digitizer analyzer It has...

Page 16: ...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 Thin...

Page 17: ...Hz for non WBIQ models and 55MHz for WBIQ models will be applied automatically to bring the WSA5000 s center frequency back to the zero IF Thus the data output will be I and Q 5 IQIN mode is not avail...

Page 18: ...m the external RF IN or I and Q IN ports respectively Hence neither of these modes support frequency tuning of the radio although the DSP s frequency shift mode may be applied Direct Conversion Receiv...

Page 19: ...Q data must be processed according to the following calibrateIQ routine illustrated using the following MATLAB code When an FFT is performed on the output of calibrateIQ the image will disappear This...

Page 20: ...of the RFE IF Queries the IF frequencies that are used for the current input mode and center frequency LOSCillator Gets the frequency to be set for the external LO 1 or 2 in corresponding to current...

Page 21: ...CIC filters with a FIR filter combined The CIC filter has a droop associated with it in the passband In order to compensate for this droop the CIC filter is followed by a compensating FIR filter Each...

Page 22: ...sociation of the time domain and the frequency domain The internal frequency domain data lags the time domain data by 1024 samples at the rate of 125 MSa s After a trigger event is detected the subseq...

Page 23: ...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 Description TRIGger Page 69 TYPE Sets o...

Page 24: ...riggering and continuously on best effort basis in other words data might not be continuous from one packet to the next once the internal buffer is full The execution of the trace capture could be con...

Page 25: ...s the list is repeated during execution STARt Begins execution of the current sweep list from the first entry STATus Get the current sweep status STOP Stops execution of the current sweep list ENTRy A...

Page 26: ...YNC MASTer ON and the other WSA5000s are configured as slaves SYSTem SYNC MASTer OFF The master and slaves are configured with a sweep list in which each sweep entry has a synchronization trigger type...

Page 27: ...slave s delay then the slave will miss the beginning of the capture The host side application that is collating the capture data may recognize the missed capture by noting the timestamps and or freque...

Page 28: ...re 9 Connectivity and 4 Different Packet Streams Supported by WSA5000 Table 7 The Categories of VRT Packet Streams Supported by ThinkRF s WSA5000 Contents Standard Formats Custom Formats Context IF Co...

Page 29: ...the list of 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...

Page 30: ...words in the entire context packet including all headers the context indicator field and context sections 9 Stream Identifier shall be the 32 bit word 0x90000001 10 Timestamp Integer Seconds shall be...

Page 31: ...presenting the Stage 1 and Stage 2 gain values The Stage 1 gain represents the amount of gain in the front end system the RF gain The Stage 2 gain represents the amount of gain in the back end system...

Page 32: ...stamps are in UTC 6 TSF field shall be set to 10 indicating that the fractional part of the timestamp measures real time picosecond resolution 7 Pkt Count shall start at 0000 and increment once for ea...

Page 33: ...cimation settings that have been enabled The Bandwidth field shall use the 64 bit two s complement format as shown in Table 18 This field has an integer and a fractional part with the radix point to t...

Page 34: ...of the Reference Level field has a range of nearly 256dBm with a resolution of 1 128dBm 0 0078125dBm For examples a Reference Level field value of 0x0080 represents a reference level of 1dBm 0xFF80 re...

Page 35: ...t shall rollover to 0000 on the next count 8 Pkt Size indicates the total number of 32 bit words in the entire context packet including all headers the context indicator field and context sections 9 S...

Page 36: ...o 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 This information however matters only when operating in the Z...

Page 37: ...fields in an IF Data packet is organized as shown in Table 27 Packets is transmitted in big endian byte order Table 27 IF Data Class Field Values 31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16 15 14...

Page 38: ...data payload of an IF Data packet contains a contiguous sequence of the Data Samples from an IF Data Sample stream The number of words in the data payload is variable from packet to packet and can be...

Page 39: ...ord follows by the second I sample in the lower 16 bit as seen in Table 31 Table 31 I14 Data Payload Arrangement with Upper 2 bit Signed Extended to I16 31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16...

Page 40: ...tor and Enable Bits Enable Bit Position Indicator Bit Position Indicator Name 30 18 Valid Data Indicator 29 17 Reference Lock Indicator 26 14 Spectral Inversion Indicator 25 13 Over range Indicator 24...

Page 41: ...the settle time is within hundred of nanoseconds Reference Lock 0 One or more PLLs failed to lock Same as 1 above Spectral Inversion 1 Spectral inversion occurs when the frequency of the local oscill...

Page 42: ...e command structure and syntax using ASCII characters to provide some basic standardization and consistency to the control commands SCPI commands hence lend themselves to communications with equipment...

Page 43: ...atus register and the error event queue Syntax CLS Parameter Response None ESE ESE ESE command enables bits in the ESE register The decimal integer value entered is the binary equivalent of the desire...

Page 44: ...Note The model string returned will not include the options ie ELO HIF WBIQ etc To find out which options a model has use SYSTem OPTions command Syntax IDN Parameter None Response Manufacturer Model...

Page 45: ...the SRE STB register bits mapping Syntax SRE integer SRE Parameter Response integer STB STB Status Byte query returns the decimal sum of the bits set in the STB register without erasing its content T...

Page 46: ...be stopped The capturing process does not wait until the end of a packet to stop it will stop immediately upon receiving the command Syntax SYSTem ABORt Parameter Response None RST State N A Example...

Page 47: ...new LAN configuration type to be applied to the WSA This command does not take effect until SYSTem COMMunicate LAN APPLy is sent please refer to the Caution note of the APPLy command Once the option...

Page 48: ...COMM LAN DNS CURRENT SYSTem COMMunicate LAN GATEway The set command will store the new LAN gateway to be applied to the WSA This command does not take effect until SYSTem COMMunicate LAN APPLy is sent...

Page 49: ...it is not affected by power on STATus PRESET or RST 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 cur...

Page 50: ...uffer 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 packet within the W...

Page 51: ...omatically have the lock The next application will need to perform this query request to attain the lock When there is only one application connected or the last one remained that application will aut...

Page 52: ...put1 SENSe FREQuency LOSCillator 002 WSA5000 XXX HIF Model INPut MODE HIF SENSe FREQuency IF 003 WSA5000 4XX WBIQ1 Model None OUTput IQ MODE is defaulted to DIGitizer 004 WSA5000 4XX P Model None 1 EL...

Page 53: ...Tem VERSion Parameter None Response NR2 Output Data Type String decimal number YYYY V Example SYST VERS SYSTem DATE This command set or queries the current date of the WSA5000 When the date is set the...

Page 54: ...tive to its current time Further information will be provided in a future revision of this document Syntax SYSTem TIME ADJust integer unit SYSTem TIME ADJust Parameters second or sub second unit Allow...

Page 55: ...ST State DISable Examples SYST TIME SYNC NTP ONCE SYST TIME SYNC DISABLE SYSTEM TIME SYNC SYSTem TIME SYNC STATus This command returns the current status of the time synchronization Further informatio...

Page 56: ...ecution Error EXE Command Error CME Not Used Power ON PON 0 1 2 3 4 5 6 7 ESR ESE Standard Event Status Register 0 1 2 3 4 5 6 7 N A N A Error Event Queue EAV Questionable Register Message Available M...

Page 57: ...d refer to Appendix D SCPI Status and Event Registers Caution This query clears all bits in the register to 0 See Figure 13 for the Operation Status register bits mapping Syntax STATus OPERation EVENt...

Page 58: ...ter Response None STATus QUEStionable EVENt This command queries the standard Questionable Status Register QSR for any event The query returns the decimal sum of the bits set in the QSR The decimal su...

Page 59: ...desired 16 bit mask to be enabled Bits enabled in this register allow accessing the equivalent bits status in the QSR and QCR registers Bits enabled in QER and set in QSR QCR register will result in t...

Page 60: ...e This command sets or queries the variable attenuation of the WSA5000 s RFE Note This command applies to WSA5000 408P 418 427 and their variants only For WSA5000 2XX 3XX 408 and their variants see IN...

Page 61: ...each stage Syntax INPut GAIN Index Boolean INPut GAIN Index Parameter Integer ON OFF 1 0 Input Data Type Integer Character Integer Allowable Values Index Varies depending on the product model For exam...

Page 62: ...NPUT GAIN HDR 5 INP GAIN HDR 20 dB INP GAIN HDR INPut MODE This command sets or queries the WSA5000 s RFE mode of operation Notes The RFE modes affect the data packing method due to the different outp...

Page 63: ...the response code 002 When this model is used the INPut MODE command will only take response with the DD and HIF parameters SOURce Commands SOURce REFerence PLL This command selects and queries the 1...

Page 64: ...ters each type of filters with its own decimator The decimator captures one sample at every integer number of samples The filters are arranged in the following manner For the decimation rate of 4 only...

Page 65: ...e for HDR receiver mode the frequency resolution is 10Hz without further frequency shifting capability Refer to RF Receiver Front End page 17 for more details For example the system is in ZIF mode to...

Page 66: ...ntax SENSe FREQuency IF non zero integer Parameters IF index Input Data Type Non zero Integer Allowable Values Varies depending on RFE input mode frequency product model and options Query Response IF...

Page 67: ...age 17 Syntax SENSe FREQuency SHIFt NRf unit SENSe FREQuency SHIFt MAX MIN Parameters Frequency unit Input Data Type Float character Allowable Values 62 5 62 5MHz Query Response integer Default I O Un...

Page 68: ...otes When the CONNector option is selected all commands affecting the digitizer data path of the WSA5000 will not apply these include TRACe Commands level triggering TRIGger LEVel and digital signal p...

Page 69: ...UTput IQ CONNector INVersion NRf unit Parameters Optional center frequency unit Input Data Type Double character Default Input Unit Hz Allowable Values Varies depending on the product model Query Resp...

Page 70: ...around the SENSe FREQuency CENTer value Refer to the Frequency Domain Triggering section for more information Syntax TRIGger LEVel NRf unit NRf unit NR1 unit TRIGger LEVel Parameters Response start s...

Page 71: ...Ck DATA is issued the WSA5000 will capture and store the total number of samples into a buffer Hence the samples within a single block capture is continuous from one packet to the other but not necess...

Page 72: ...d sets or queries the total number of packets set in the WSA The maximum is limited by the storage capacity of a WSA5000 and the samples per packet SPP size set through TRACe SPPacket Therefore when T...

Page 73: ...SPP is therefore simplified to 65504 or 216 32 for all data format The lower bound of the SPP is limited by the capture engine s minimal transfer requirement of 256 samples Table 37 summarizes the SPP...

Page 74: ...e command the WSA system will stop when the current capturing VRT packet is completed with the required samples as opposed to SYSTem ABORt Note After this command is issued SYSTem FLUSh command should...

Page 75: ...cuted During sweeping the WSA internal buffer might be overflown at which point the sweep engine will pause The engine will resume sweeping once there are enough space for the next block of data or mo...

Page 76: ...ta packets belonging to a new sweep start Even though the start ID value is optional a VRT Extension Context Packet with the New Sweep Start ID page 36 value will always be sent out after this command...

Page 77: ...figurations under SWEep ENTRy with values from the sweep entry of the specified index No new entry is created until SWEep ENTRy SAVE command is issued and any changes will not affect the existing entr...

Page 78: ...Examples SWEEP ENTRY NEW SWEep ENTRy READ This query command returns the current configuration settings of a sweep entry Syntax SWEep ENTRy READ integer Parameter Entry index value Input Data Type Int...

Page 79: ...SAVE integer Parameter Entry index value Input Data Type Integer Allowable Values COUNt value 1 RST State N A Examples SWEEP ENTR SAVE SWE ENTR SAVE 5 SWEep ENTRy ATTenuator Refers to the INPut ATTenu...

Page 80: ...y CENTer command 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 V...

Page 81: ...infinite dwell time In this case the sweep engine will move on as soon as the current data capture amount has been met as explained in the previous paragraph When the trigger type is NONE dwell time i...

Page 82: ...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 da...

Page 83: ...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 Signa...

Page 84: ...to determine how to parse the response message Note that the bracket is for clarity of the explanation purpose only not to be included in the message A WSA with the discovery version 2 would respond...

Page 85: ...ersion but will not respond to variations of either version The interface does not differentiate between upper case and lower case letters but only the long or short form of a command An example corre...

Page 86: ...used to separate alternative parameter options Means is defined as Parameter types This section defines different SCPI parameter data type Parameter Type Description boolean ON OFF 1 0 Boolean paramet...

Page 87: ...efault may be specified If units are not specified then the default units apply Note the following examples which are all equivalent Example FREQ CENTer 2441 5 MHz is equivalent to FREQ CENTer 2441500...

Page 88: ...r query 3 Questionable Register Summary This bit is not used and is always 0 4 Message Available MAV This bit is set if there is any unread data in the Output queue 5 Standard Event Status Bit ESB Thi...

Page 89: ...register that is used to determine the state of operation It is read by issuing a STATus OPERation EVENt command Bit Name Description 0 3 not used These bits are not used and is always 0 4 Measuring M...

Page 90: ...ceived that is NOT allowed for the particular command 230 Data corrupt or stale Possibly invalid data new reading started but not completed since last access 240 Hardware error Indicates that a legal...

Page 91: ...nt Status Register v1 0 IDN Query device identification v1 0 OPC Operation Complete TBD OPC Query OC TBD RST Reset to factory default v1 0 SRE integer Service Request Enable bits v1 0 SRE Query SRE re...

Page 92: ...ENTer NRf unit Sets the center frequency of the RFE v3 0 CENTer MAX MIN IF non zero integer Queries the IF frequencies that are used for the current input mode and center frequency v4 3 2 LOSCillator...

Page 93: ...he settings of an existing sweep entry into the current settings for quick editing v3 1 COUNt Gets the number of entries available in the list v3 1 DELETE integer ALL Deletes a specified entry or all...

Page 94: ...k PACKets page 72 v3 0 PPBlock SPPacket As defined in TRACe SPPacket page 73 v3 0 SPPacket TRIGger LEVel As defined in TRIGger LEVel page 70 v4 1 0 LEVel TYPE As defined in TRIGger TYPE page 69 v3 1 2...

Page 95: ...the application that has the lock can perform the task v3 0 OPTions Returns comma separated 3 digit values to represent the hardware option s or features available with a particular WSA model v3 2 1 S...

Page 96: ...am STARt integer Initiates the capture storage and streaming of IQ data v3 1 STOP Stops streaming v3 1 TRIGger Page 69 LEVel NRf unit NRf unit NRf unit start stop level Sets the frequency range and am...

Page 97: ...ansport 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 1...

Page 98: ...3 2013 Updated this document to correspond with the capabilities of WSA5000 Contact Support for list of changes from WSA4000 to WSA5000 v3 1 October 01 2013 Added OUTput IQ MODE command Table 8 to lis...

Page 99: ...mands Added New commands SYSTem OPTions and SENSe FREQuency LOSCillator to support WSAs with the external local oscillator mode HDR gain field to SWEep ENTRy READ returned string right after IF gain S...

Page 100: ...asing on the attenuation setting and removed the mentioning of the dependency on the gain settings v3 3 2 Oct 15 2014 Corrected TRIGger STATus to be unavailable Corrected the absolute power level form...

Page 101: ...OSCillator information on WBIQ model to Table 2 SENSe DECimation and SYSTem OPTions support or not note on 408P model in INPut ATTenuator VARiable and INPut ATTenuator respectively INPut GAIN command...

Reviews: