USER GUIDE Wireless Test System Instrument Software SCPI Command Reference This document provides an overview for using Wireless Test System Instrument Software (WTS Software) with the Wireless Test System (WTS), and command reference for supported Standard Commands for Programmable Instruments (SCPI) commands. WTS Software includes SCPI commands supported by the WTS instrument. WTS Software provides an interface between the client PC and the WTS instrument. WTS Software uses SCPI commands over a Virtual Instrument Software Architecture (VISA) connection to communicate with and control the WTS instrument. This document describes how the SCPI commands of WTS Software interact with the WTS instrument and describes each functional group of SCPI commands and queries. Each supported wireless standard has a corresponding functional group of SCPI commands and queries. Each of these functional groups is known as a personality. In addition to personality- specific commands, there are SCPI commands for general RF settings that apply to all supported personalities and the WTS instrument-supported common/mandatory commands defined in the SCPI-99 and IEEE 488.2 specifications, which are supported by all instrument types. The example sequences described in this document demonstrate how to use WTS Software to perform common measurements with the WTS instrument. Contents WTS Instrument ....................................................................................................................... 2 Instrument Communication...................................................................................................... 5 SCPI Syntax and Usage.................................................................................................... 5 Interacting with the WTS Instrument............................................................................... 9 Virtual Instruments..................................................................................................................14 Configuration Spaces...................................................................................................... 16 Results Spaces.................................................................................................................16 Physical Port Names....................................................................................................... 17 Logical Port Names........................................................................................................ 17 Attenuation Tables.......................................................................................................... 19 Troubleshooting.............................................................................................................. 22 Debugging....................................................................................................................... 22 Best Practices and Caveats............................................................................................. 23
1221
Embed
Wireless Test System Instrument Software · WTS Software includes SCPI commands supported by the WTS instrument. WTS Software provides an interface between the client PC and the WTS
This document is posted to help you gain knowledge. Please leave a comment to let me know what you think about it! Share it to your friends and learn new things together.
Transcript
USER GUIDE
Wireless Test SystemInstrument SoftwareSCPI Command Reference
This document provides an overview for using Wireless Test System Instrument Software(WTS Software) with the Wireless Test System (WTS), and command reference for supportedStandard Commands for Programmable Instruments (SCPI) commands.
WTS Software includes SCPI commands supported by the WTS instrument. WTS Softwareprovides an interface between the client PC and the WTS instrument. WTS Software usesSCPI commands over a Virtual Instrument Software Architecture (VISA) connection tocommunicate with and control the WTS instrument.
This document describes how the SCPI commands of WTS Software interact with the WTSinstrument and describes each functional group of SCPI commands and queries. Eachsupported wireless standard has a corresponding functional group of SCPI commands andqueries. Each of these functional groups is known as a personality. In addition to personality-specific commands, there are SCPI commands for general RF settings that apply to allsupported personalities and the WTS instrument-supported common/mandatory commandsdefined in the SCPI-99 and IEEE 488.2 specifications, which are supported by all instrumenttypes. The example sequences described in this document demonstrate how to use WTSSoftware to perform common measurements with the WTS instrument.
SCPI Syntax and Usage.................................................................................................... 5Interacting with the WTS Instrument............................................................................... 9
Virtual Instruments..................................................................................................................14Configuration Spaces......................................................................................................16Results Spaces.................................................................................................................16Physical Port Names....................................................................................................... 17Logical Port Names........................................................................................................ 17Attenuation Tables.......................................................................................................... 19Troubleshooting.............................................................................................................. 22Debugging.......................................................................................................................22Best Practices and Caveats............................................................................................. 23
RF General Settings................................................................................................................ 24Internal Self-Calibration................................................................................................. 24RF General Settings and Mandatory SCPI Command List............................................ 24RF General Settings SCPI Command Reference............................................................27
Worldwide Support and Services........................................................................................1220
WTS InstrumentThe WTS, manufacturing number NI-MCT001, is a communications test set with full duplexRF ports capable of both receiving and generating signals.
2 | ni.com | WTS Software User Guide
You can use each RF port with integrated signal analyzer (SA) and signal generator (SG)components, which have up to 200 MHz of instantaneous bandwidth. The number of availablesignal analyzers and signal generators depends on the system model. The following figureshows the block diagram for a WTS with two signal analyzers and two signal generators.
You can create virtual instances of the WTS instrument, called virtual instruments. Virtualinstruments separate the WTS instrument from the SCPI commands of the embedded WTSSoftware, which allows you to more efficiently share the WTS instrument hardware.
4 | ni.com | WTS Software User Guide
For more information about the WTS instrument, refer to the Wireless Test System GettingStarted Guide and Wireless Test System Specifications, available at ni.com/manuals.
Related Information
Virtual Instruments on page 14
Instrument Communication
SCPI Syntax and UsageThis section provides an overview of SCPI syntax and usage standards.
The SCPI-99 and IEEE Std 488.2-1992 standards define SCPI command syntax and usage.The main rules for using SCPI commands are included in this document. Refer to the SCPI-99and IEEE 488.2 standards for more information about using SCPI.
The following sections describe conventions for SCPI syntax.
SCPI Command Conventions
SCPI Command StructureSCPI commands use the conventions described in this section.
SCPI commands are made up of nodes each separated by colon (:). Each node can have a longand a short form. For example, the following long form command:CONFigure:RFSA:GPRF:FREQuencyhas the following short form:CONF:RFSA:GPRF:FREQThe instrument will identify only the exact short form or the exact long form of a node,however the form is not case sensitive. The only purpose of upper and lower case characters inSCPI commands is to allow you to distinguish between the long form and short form.
You can mix the usage of short form and long form nodes by using short form in some nodesand long form in others. For example, the following two commands are both valid andidentical to the instrument:CONF:RFSA:GPRF:FREQuency ConFigure:rfSA:GpRf:freqHowever, the following command is not valid because Config is neither the long form northe short form of CONFigure.
Config:RFSA:GPRF:FREQuency
Note SCPI commands are not abbreviations. According to SCPI-99 rules, they arecontractions of multiple words. For example, EATTenuation is a contraction ofexternal attenuation.
Items within angle brackets are variable parameters.
Vertical bar | Vertical bars separate alternative parameters. For example, INTERNAL |EXTERNAL indicates that either INTERAL or EXTERNAL can be used as aparameter.
SquareBrackets [ ]
Items within square brackets are optional. The representationCONFigure:RFSA:GPRF:FREQuency[:CENTer] indicates that thenode :CENTer may be omitted. A parameter within square bracketsindicates that the specific parameter may be omitted.
Braces {} Braces indicate parameters that may be repeated zero or more times. It isused especially for showing arrays. The notation <A>{,<B>} shows thatparameter A must be entered, while parameter B may be omitted or may beentered one or more times.
SCPI ParametersAll SCPI input parameters have a default value, which is the value used if you do not specify avalue.
The default value is also the value that the parameter takes when you issue a *RST commandor set the default value of a command, as in the following code:CONFigure:RFSA:GPRF:FREQuency DEFAULTIn addition to setting the instrument default value, you can configure a parameter to theminimum or maximum value defined for the instrument. For example, the following commandsets the parameter to the minimum legal value, 65E6.CONFigure:RFSA:GPRF:FREQuency MINIMUMAnd the following command sets the parameter to the maximum legal value, 6E9.CONFigure:RFSA:GPRF:FREQuency MAXIMUMParameters can also be embedded in the command node itself. An embedded parameter is asuffix. In the following command the third node, GPRF, contains the suffix <i>.CONFigure:RFSA:GPRF<i>:FREQuencyThe suffix is an integer value. According to SCPI-99 rules, if you omit a specified suffix, avalue of 1 is implied.
The following commands address the same parameter value in the same instrument personalityinstance:CONFigure:RFSA:GPRF:FREQuencyCONFigure:RFSA:GPRF1:FREQuency
6 | ni.com | WTS Software User Guide
Using SCPIThis section provides general information on using SCPI to program the WTS instrument.There are several ways to write SCPI commands. For example, if you want to configure boththe center frequency and level of the general purpose signal generator on the WTS, you canuse any of the following approaches:• Send separate commands:
• Send two commands using the relative to last used leaf:SOURce:RFSG:GPRF:FREQuency <CenterFrequency>LEVel <Level>In this case, LEVel and FREQuency are located in the same node system. When acommand follows another command that is in the same node system, you do not need torepeat the node information for the second command. Each time a command is executed,the node containing the function is saved as the current default node. Any functions underthe same default node are accessible directly without having to provide the full node path.
• Send a coupled command, also called a compound command:SOURce:RFSG:GPRF:FREQuency <CenterFrequency>;LEVel <Level>Coupled commands are more efficient because the commands are sent together. TheTCP/IP stack can send one message containing both commands, instead of two messagescontaining one command each.
There is no execution difference between single commands and coupled commands. If youinclude multiple queries in a single coupled command, the instrument honors the order ofrequests in any response it returns. If you send two queries where one takes longer to computethan the other, the resulting response is returned in the same order as requested. For example,if you query the center frequency and level from the instrument using the following compoundcommand:SOURce:RFSG:GPRF:FREQuency?;LEVel?the instrument returns the response values in the following order:<CenterFrequency>;<Level>The returned values are separated by a semicolon (;) to distinguish which query each is aresponse to.
Coupled commands need not belong to the same subgroup. If they do not belong to the samesubgroup, you must include a colon (:) which signals that the command originates from theroot. For example, a coupled command for multiple subgroups or nodes may be written asfollows:CONFigure:RFSA:GPRF:FREQuency?;:TRIGger:RFSA:GPRF:TOUT?
SCPI Command ExecutionSCPI-99 describes two ways a command can execute, sequential or overlapped. The SCPIcommand reference indicates how the instrument executes each command, for both thecommand and the query forms. A sequential command does not allow any commands that
follow it to execute until the sequential command has completed execution. An overlappedcommand allows other commands that follow it to execute at any time.
Sequential Execution: SequentialCommand A
SequentialCommand B
SequentialCommand C
Overlapped Execution:OverlappedCommand A
OverlappedCommand B
OverlappedCommand C
You can think of sequential commands as serial commands, and overlapped commands asparallel, however, it's not that simple. A sequential command will start while a previousoverlapped command is executing, which means that a sequential command can run in parallelwith other overlapped commands.
Mixed Execution:OverlappedCommand A
SequentialCommand B
OverlappedCommand C
Overlapped commands execute more efficiently due to their parallel nature, so most of thecommands implemented by the instrument are overlapped commands. In cases where it doesnot make sense to use overlapped commands, commands are implemented by the instrumentas sequential commands. For example, in cases where overlapped commands can lead tomisconfiguration or command parameter race conditions, sequential commands are used.
SCPI-99 includes synchronization methods to ensure that necessary commands havecompleted executing before the next set of commands begins. For example, if you want tochange the frequency and initiate a measurement, you could use the following coupledcommand:CONFigure:RFSA:GPRF:FREQuency <CenterFrequency>; :INITiate:RFSA:GPRFBecause both commands are overlapped, the execution would be similar to the followingfigure:
Execution:Overlapped
CONFigure:RFSA:GPRF:FREQ
OverlappedINITiate:RFSA:GPRF
Even though the configure command starts execution before the initiate command, initiationcan start before configure finishes executing, causing the initiate to occur on the old frequency.SCPI-99 defines the *WAI (wait), *OPC, and *OPC? (operation complete) commands to usefor synchronization. All three commands ensure that all prior execution has completed before
8 | ni.com | WTS Software User Guide
any subsequent commands begin to execute. The difference among them is whether the clientreceives notification of the synchronization.
*WAI pauses execution until all running commands have finalized. For the followingcompound command:CONFigure:RFSA:GPRF:FREQuency <CenterFrequency>; *WAI;:INITiate:RFSA:GPRF*WAI causes the initiate command to execute only after the configure command has finished,as shown in the following figure.
Execution:Overlapped
CONFigure:RFSA:GPRF:FREQ
*WAI OverlappedINITiate:RFSA:GPRF
Note It is not necessary to precede *WAI or other commands that begin with anasterisk (*) with a colon (:) because the instrument knows those commands alwaysstart from the root.
The Operation Complete command and query (*OPC and *OPC?) execute in the same way,but each also produces an output to the client.
*OPC? places a 1 on the output queue when operation is complete. *OPC raises bit 0 in theevent status register when operation is complete. Both outputs are used for clientsynchronization. For example, the client may wait until it receives 1 on the output queue from*OPC? before starting the DUT transmission, because Initiate has then completed executingand the instrument should be searching for a potential trigger.
Interacting with the WTS InstrumentYou can communicate with the WTS instrument using SCPI commands in the following ways:• VXI-11 RPC• Raw TCP socket• Virtual Instrument Software Architecture (VISA)
VISA is a standard for configuring, programming, and troubleshooting instrumentationsystems comprising GPIB, VXI, PXI, Serial, Ethernet, and/or USB interfaces. VISA providesthe programming interface between the hardware and development environments such asLabVIEW, LabWindows/CVI, and Measurement Studio for Microsoft Visual Studio. NI-VISAis the National Instruments implementation of the VISA I/O standard. NI-VISA includessoftware libraries, interactive utilities such as NI I/O Trace and the VISA Interactive Control,and configuration programs through Measurement & Automation Explorer (MAX) for all yourdevelopment needs. NI-VISA is standard across the National Instruments product line.
Although you can use any programming language to open a VISA session to the WTSinstrument, connect to a WTS virtual instrument resource, and send SCPI commands to thespecified resource, NI recommends using NI-VISA.
Synchronizing Instrument and Client EventsSynchronizing events on the DUT or client with instrument events is an important part ofcreating an efficient test plan.
The WTS implements the Status and Event Registers defined by SCPI-99. These registersallow you to monitor events of interest using the Status Register in order to respondappropriately when the events occur. The following figure illustrates interactions among theclient, instrument, and DUT.
Client
DUT Instrument
You can handle instrument registers in one of the following ways:• Message queries• VISA events
Note VISA events are not available in raw TCP socket connections.
VISA registers are useful for debugging and improving the speed and efficiency of anapplication. If you do not enable notifications from registers, you must send a query todetermine if an error occurred when you get unexpected behavior. The following figureillustrates the VISA registers implemented by the WTS.
10 | ni.com | WTS Software User Guide
01234567
01234567
Logi
cal O
R
Logi
cal A
ND
016
0123457
Logi
cal O
R
ServiceRequest
Generation
RQS
MSS
&&
&&
&&
&&
&
&&
&&
&&
OutputQueue
QueueNot-Empty
QueueNot-Empty
Standard Event StatusEnable Register*ESE[?]
Standard EventStatus Register
*ESR?
Status ByteRegister*STB?
Service RequestEnable Register
*SRE[?]
ESB MAV
Ope
ratio
nC
ompl
ete
Com
man
d
n...3210
Pow
er O
n
Use
r R
eque
st
Com
man
d E
rror
Exe
cutio
n E
rror
Dev
ice
depe
nden
t Err
or
Que
ry E
rror
Req
uest
Con
trol
EAV
Error/EventQueue
OSC QSR
Operation StatusConditionRegister
STAT:OPER?
Questionable StatusCondition RegisterSTAT:QUES?
SYST:ERR?
(1)
(2)
(4)
(8)
(16)
(64)
(128)
(32)
(1)
(2)
(4)
(8)
(16)
(64)
(32)
(128)
(1)
(4)
(8)
(16)
(32)
(128)
(2)
(1)
(4)
(8)
(16)
(32)
(128)
(2)
Related Information
Debugging on page 22
Status Byte RegisterThe Status Byte register provides a summary of all other instrument registers and messagequeues.
You can use the Status Byte Register in the following ways:• Use the *STB? command to manually read the Status Byte register.• Sign up for VISA events and use the Service Request Enable register to specify the
events for which to create a Service Request Event. Access the Service Request Enableregister using the *SRE command.
Event Status RegisterThe Event Status register handles command errors and command execution.
A bit is assigned to each of the different types of errors an instrument can encounter. TheEvent Status register also includes a bit that contains a summary of ongoing commandexecution. Set and read the Event Status register using the *ESR? command.
Operation Complete Message-Based ExampleThis example illustrates message-based notification of a completed operation.
The following pseudocode uses messaging to determine when the General Purpose RFanalyzer configuration is armed and ready to receive a signal from the DUT.//code to prepare the DUT for TX...//SCPI Command configuration of the RFSA GPRFVisaWrite("CONFigure:RFSA:GPRF:FREQuency")...//initiate configuration and arm triggerResponse = VisaQuery("INITiate:RFSA:GPRF;*OPC?")IF(response = '1'){//Start DUT TX}Else{ //Error case}When using this approach, be aware that the standard VISA timeout often is set to 2 seconds.However, the standard trigger timeout often is 5-10 seconds. This may cause the *OPC? queryto time out before the instrument times out. In this case, the resulting error from the step isVISA Timeout rather than Trigger Timeout. VISA Timeout indicates that the communicationfailed although the actual error is that the DUT did not transmit or the instrument did notcapture. Be careful when you use this approach to ensure you set the timeout of thecommunication appropriately relative to expected time of the operation you intend to performon the instrument.
Operation Complete Event-Based ExampleThis example illustrates event-based notification of a completed operation.
The following pseudocode uses register events to determine when the General Purpose RFanalyzer configuration is armed and ready to receive a signal from the DUT.//Enable the notification to the Status Byte Register when the operation is completeVisaWrite("*ESE #H01") //Set register bit0 (decimal 1)
//Enable Service Request events (SRQ) on standard event register eventsVisaWrite("*SRE #H20") //Set register bit0 (decimal 32)
//code to prepare the DUT for TX...
12 | ni.com | WTS Software User Guide
//SCPI Command configuration of the RFSA GPRFVisaWrite("CONFigure:RFSA:GPRF:FREQuency")...//initiate configuration and arm triggerVisaWrite("INITiate:RFSA:GPRF;*OPC")
// Event handler for SRQ eventsOnServiceRequest(){//Start DUT TX }
VISA Registers and WTS Virtual InstrumentsYou can use VISA registers to debug the WTS instrument because the registers will show anyerrors experienced by the instrument. VISA registers can indicate that a command was notunderstood by the instrument or that the instrument or its firmware did not execute correctly.Error information will be summarized by the registers and an error will be placed in the errorqueue.
Note Each virtual instrument has its own set of VISA registers.
You can display the VISA - Instrument Register Viewer on the instrument desktop by sendingthe command DEBug:VISA. This window displays the current state of the instrument registersfor the virtual instrument to which you sent the command. This window also provides liveupdates to the state of the registers.
Virtual InstrumentsYou can use multiple virtual instances of the WTS. All virtual instruments share the sameWTS physical hardware. Each virtual instrument can also have multiple personality instances,called configuration spaces, which perform generation or analysis for a wireless personality.The following figure shows the WTS instrument, virtual instruments, and configurationspaces.
14 | ni.com | WTS Software User Guide
TestStation
1
TestStation
2
Virtual Instrument 1
ConfigurationSpaces
ConfigurationSpaces
WTSFront Panel
Virtual Instrument 2
GPRFGPRF
GPRFGPRF
GPRF
In traditional instruments, if you have four test stations that each control a DUT, and want toshare a physical instrument among the test stations, only one test station at a time can accessthe physical instrument. Each test station must also be aware of when the other stations areusing the physical instrument, or use VISA locks while one station is accessing the instrumentto prevent access from other test stations. For example, in the following figure, Client B mustwait until Client A releases the physical instrument before it can access it.
Client A
Client B
Configure
LockInstrument
Acquire Calculate Fetch Results
Configure Acquire Calculate Fetch Results
UnlockInstrument
LockInstrument
UnlockInstrument
Using WTS, each test station can interact with its own virtual instrument, which it canprogram completely, as if it were the sole user of the WTS instrument. In the following figure,the virtual instrument attached to Client A is a different virtual instrument than the oneattached to Client B. In this way, you can share the same physical hardware among multipletest stations and concurrently run different test plans that traditionally would require exclusivecontrol of the physical hardware.
To further maximize efficiency by reducing communication overhead, each virtual instrumenthas multiple instances of personality configuration spaces. Each configuration space can beconfigured for a general measurement set, such as GPRF. Each configuration space likewisehas multiple results spaces, which allow for initiation of measurements even before the priormeasurement has completed.
If you are using multiple virtual instruments, each virtual instrument is identified by its ownVISA address in MAX, such as TCPIP:192.168.0.10:Instr0, where Instr0 is theVISA address assigned in MAX.
Configuration SpacesUse a personality configuration space to describe a specific measurement setup that you intendto reuse. For example, you may need to perform several 802.11b (SISO) and 802.11ac MIMOmeasurements on a DUT, both of which require several configuration setup commands. Youcan create one configuration space for 802.11b, called WLAN1, and another configuration spacefor 802.11ac MIMO, called WLAN2. Each WLAN1 and WLAN2 configuration space can then beconfigured individually with the appropriate parameters needed to perform the measurementsyou want. The amount of commands you must send when you switch from 802.11bmeasurements to 802.11ac measurements are minimized because each configuration space hasits own encapsulated configuration set.
In practice, all you need to do is initiate and fetch the measurements. For example, thefollowing code initiates and fetches results for the 802.11b measurement set:INITiate:RFSA:WLAN1FETCH:RFSA:WLAN1Similarly, the following code initiates and fetches measurements for 802.11ac:INITiate:RFSA:WLAN2FETCH:RFSA:WLAN2The configuration space protects your results, so you can execute configuration space WLAN2before you fetch the results from WLAN1.
Results SpacesYou can specify results spaces for INIT and FETCh commands to store results from differentexecutions in different spaces.
Using results spaces allows the client to initiate measurements as soon as configurationcompletes, which provides a speed advantage over traditional instruments. With traditionalinstruments, measurement results overwrite the previous measurement results, so all previousresults must be fetched before a new measurement is initiated, which incurs a delay. With theWTS, measurement results that are stored in results spaces are retained until the next time youuse the same results space.
16 | ni.com | WTS Software User Guide
In WTS Software, the <i> suffix of the RESults parameter denotes the results space, asfollows:
Physical Port NamesThe amount of RF ports on your WTS instrument depends on your specific model. If you areusing the WTS instrument, the ports are named in the software as they appear on the hardware.
For example, the available ports on the WTS-01 through WTS-04 models appear as PORT0 toPORT7, and ports on the WTS-05 model appear as PORT0 to PORT15. If you are using WTSSoftware with custom hardware, the port names appear as your VST instrument names inMAX. For example, the available port names for a VST instrument appear as RIO<n>. Theport names for the signal analyzer and signal generator are the same.
Broadcast PortsThe WTS supports generation on multiple ports simultaneously using a single generator. Thistype of generation is called broadcasting. To broadcast on the WTS, you must assign abroadcast port instead of a single port when you configure the generator.
Broadcast ports are named after the segment of ports to which they can physically broadcast.Broadcasting is available on ports within the same quadrant. For example, you can broadcastsimultaneously on PORT0 to PORT3, PORT4 to PORT7, PORT8 to PORT11, and PORT12 toPORT15, by using the port names PORT0-3, PORT4-7, PORT8-11, or PORT12-15,respectively. Broadcasting to only a subset of the ports in the quadrant is not possible.
Note Broadcast ports are typically not available on custom hardware.
Logical Port NamesA logical port name is a user-defined name for a physical port.
Logical port names support the use of virtual instruments with the WTS instrument and allowyou to specify different attenuation values for the same physical port. This is useful if youhave switches, splitters, or combiners that route a single port to several different RFconnections on your DUT. You can define a logical port name for a generator port, an analyzerport, or both a generator and analyzer port. Call the following command to define the logicalport name MYPORT for PORT0, which you can then use to refer to the port in other commands.
You can use the logical port name to set a port name in a personality or assign an attenuationtable to a port, as shown in the following examples:CONFigure:RFSG:GPRF:PORTname 'MYPORT'SYSTem:RFSG:CORRection:CSET:SELect'MYPORT','MYATTENUATIONTABLE'
Note Logical port name definitions are not stored permanently and are deletedwhen you restart the instrument.
Related Information
Assigning Attenuation Tables to Ports on page 21
Using Logical Port Names With Virtual InstrumentsYou can specify the same logical port name for two different physical ports used by differentvirtual instruments.
For example, Virtual instrument A can define MYPORT as the logical name of physical PORT2:
ROUTe:RF:PORT:DEFine 'MYPORT','PORT2'Virtual instrument B can also define MYPORT as the logical name for a different physical port,PORT4:
ROUTe:RF:PORT:DEFine 'MYPORT','PORT4'Test plans running on instrument A and instrument B can both refer to MYPORT, but thephysical port referenced will differ depending on the virtual instrument. This allows you tocreate test plans that are completely identical without having to know the actual physicalconnections from the instrument to the DUT. Physical connections from the DUT to theinstrument can be managed by the test executive.
Note You cannot assign broadcast ports a logical port name. The broadcast portsbreak the boundaries of the virtual instrument, as the intention with the broadcastport is to send the same signal to multiple DUTs in parallel.
Attenuation TablesFor the WTS instrument to accurately generate and measure signals across frequency andpower, you must compensate for any external path loss. You can measure the path loss andpower drop across frequencies and store those values in attenuation tables, which are thenassigned to ports on the WTS instrument.
Use the following order of operations to create an attenuation table:1. Define a table by giving it a name.2. Set the number of frequency and attenuation power value pairs.3. Store the table in the non-volatile memory of the WTS.4. Assign the table to a port.5. Apply additional external attenuation as needed.
Note The attenuation tables for broadcast ports must be defined with the samename as the physical port that the broadcast port consists of. For example, if youwant to broadcast on PORT4 through PORT7, then you must name the attenuationtables PORT4, PORT5, PORT6, andPORT7.
You can create and work with tables in the MEMory subsystem. For example, the followingcode creates a table in memory called MYATTENUATIONTABLE with 3 value pairs: initializedwith 0:MEMory:TABLe:DEFine 'MYATTENUATIONTABLE',3
By default, the table is initialized with zeros, similar to the following example:
MYATTENUATIONTABLE Frequency Attenuation Power
0 0 0
0 0 0
0 0 0
To resize an existing table, use the following command:MEMory:TABLe:POINts <TableName>,<Points> Because virtual instrument instances of the WTS instrument are actually different instances ofinstruments, you cannot share a table among different virtual instruments. Likewise, the storedfile may not be shared among different virtual instrument instances. However, because eachvirtual instrument has its own table memory and its own non-volatile memory, you can createtwo attenuation tables with the same name in two different virtual instruments and store themwith the same filename.
Populating Attenuation TablesUse separate commands to populate the values for frequency, attenuation, and power.
For example, use the following commands to set 1 GHz, 2 GHz, and 3 GHz as the frequencyrange; 6 dB, 7 dB, and 8 dB as the attenuation values; and -25 dBm as the power value for allvalue pairs:MEMory:TABLe:FREQuency 'MYATTENUATIONTABLE',1E9,2E9,3E9MEMory:TABLe:LOSS:MAGNitude 'MYATTENUATIONTABLE',6,7,8MEMory:TABLe:POWer:MAGNitude 'MYATTENUATIONTABLE',-25,-25,-25There must be an equal number of elements in all three value arrays, otherwise an errorresults.
The attenuation table changes after the execution of the previous commands, as shown in thefollowing example:
MYATTENUATIONTABLE Frequency Attenuation Power
1E9 6 -25
2E9 7 -25
3E9 8 -25
Storing Attenuation TablesStore attenuation tables in the instrument non-volatile memory so you can load them as neededfor later sessions or after restarting the instrument.
20 | ni.com | WTS Software User Guide
Store tables in and load tables from the MMEMory (mass memory) subsystem. For example, thefollowing code stores MYATTENUATIONTABLE to MyFile, then loadsMYATTENUATIONTABLE from MyFile:MMEMory:STORe:TABLe "MYATTENUATIONTABLE","MyFile"MMEMory:LOAD:TABLe "MYATTENUATIONTABLE","MyFile"
Note Stored attenuation tables do not reload automatically on the instrument atsystem startup. You must command the instrument to load the tables.
External AttenuationAll WTS configurations have a command that allows you to add external attenuation.
The command takes the following form:...:...:...:EATTenuation <ExternalAttenuation>For example:CONFigure:RFSA:WCDMa<i>:EATTenuation <ExternalAttenuation>Use external attenuation to adjust the entire spectrum up or down. External attenuation is ascalar value that is added to any value found in the attenuation tables. You can also useexternal attenuation for attenuation tables outside of your instrument if you want to set thecalculated attenuation for your setup during run time.
Assigning Attenuation Tables to PortsYou can assign a defined attenuation table to a user-defined port name. Logical port names donot inherit the attenuation tables that are assigned to their respective physical ports.
The following code assigns the previously created MyAttenuationTable to a previouslydefined port name, SgPort:SYSTem:RFSG:CORRection:CSET:SELect 'SgPort','MyAttenuationTable'MyAttenuationTable will then be used each time a client configures the port as SgPort,such as in the following code:CONFigure:RFSG:GPRF:PORTname 'SgPort'You can assign an attenuation table to a generator port (RFSG) or an analyzer port (RFSA)individually. You can also assign a table to both RFSA and RFSG ports simultaneously.
Note Attenuation tables for broadcast ports do not need to be assigned to a port, asthey are assigned to the physical port that the broadcast port consists of.
What Should I Do If the Device Amplitude Reading Does NotMatch the Source?1. Verify that you are using the correct attenuation table.2. Verify that the content of the attenuation table is correct.3. Verify that the external attenuation for the configuration you run is set as desired. For
example:CONFigure:RFSA:GPRF:<i>"EATTenuation?Where <i> is the number of your target configuration space, returns:<ExternalAttenuation>
4. Run *CAL.
Related Information
Attenuation Tables on page 19
What Should I Do If There's No RF Out Signal At A Port?1. Connect a loop cable directly from the desired port to another port.2. Run the Continuous Wave (CW) Loopback Example, specifying the ports you selected in
the previous step as the RFSA and RFSG ports.3. Check the error queue for errors using the SYSTem:ERRor:NEXT? query.
If the queue is empty, contact NI at ni.com/support. If there are errors in the queue,correct your example.
4. If the loop works but you still see no signal at the desired port, try and loop at the end ofyour external cable connection and repeat step 2.
Related Information
Continuous Wave (CW) Loopback Example on page 85
DebuggingUse I/O Trace and the VISA - Instrument Register Viewer to debug WTS applications thatreturn errors or unexpected results. You can use I/O Trace on the client PC or the virtualinstrument to observe the commands sent to and from the instrument.• I/O Trace (client)—I/O Trace on the client PC shows the commands sent to and from the
instrument, and the timestamps for when each command is received and returned. Youcan launch I/O Trace from the VISA Test Panel.
Note You must install NI-VISA on the client PC to use I/O Trace on the clientPC.
• I/O Trace (virtual instrument)—I/O Trace on the virtual instrument shows the instrumentactivity. Timestamps and tracing are slightly different on the instrument side, and may
provide more information than what is available through I/O Trace on the client PC. I/OTrace on the client PC can only show activity on that client. On the instrument side, I/OTrace can show activity on all clients.
The VISA - Instrument Register Viewer shows the 488.2 VISA registers and error queue. UseVISA registers to debug applications and to improve the speed and efficiency of applications.The Status Byte register (*STB) indicates there's an error in the error queue. The VISA -Instrument Register Viewer will show the error. Call the SYS:ERROR[:NEXT]? orSYS:ERROR:ALL queries to return error info.
Related Information
VISA Registers and WTS Virtual Instruments on page 13
Best Practices and CaveatsBest practices and caveats for programming the WTS using SCPI commands.
Keep the following best practices in mind when programming the WTS.• Turn the signal generator output off when your configuration space does not need to
access the hardware so that other virtual instruments operating concurrently are able toaccess the hardware.
• Where possible, use compound commands to reduce communication overhead.• Use synchronization commands (*WAI ¦ *OPC[?]) when you need to ensure that all
necessary overlap commands complete prior to executing a specific command. Forexample, you want the set list length command to complete before you populate values tothe list. Set list length is a sequential command. Initiate is an overlap command.
• If you are performing repeatable measurements among different wireless standards orvariants, use different configuration spaces for them.
Keep the following caveats in mind when programming the WTS.• Sequential commands do not run in serial order. A sequential command will start
executing while other overlap commands are executing, however no other commands willexecute until the sequential command completes.
• Make sure the timeout of your execution does not exceed the timeout of VISA. Thedefault VISA timeout is two seconds. If your execution timeout is greater than the VISAtimeout, adjust the VISA timeout to ensure proper functionality and, if errors occur,correct error messages.
RF General SettingsRF General Settings are SCPI commands supported by all RF instrument personalities. Thissection also includes mandatory SCPI-99 commands supported by the WTS.
Use RF General Settings SCPI commands to perform tasks common to all RF instrumentpersonalities, including the following:• Specify and manage port mapping and port assignments• Specify reference frequency• Calibrate the hardware/system• Query system information for the hardware• Specify and manage error compensation tables• Specify and store routing definitions• Create and store memory tables
Internal Self-CalibrationThe WTS instrument can perform internal self-calibration to maintain the specified accuracyover time and temperature drift of the RF components.
Because the virtual instruments share hardware, the execution of self-calibration called on onevirtual instrument from one client can impact all other virtual instruments used by otherclients. You must consider how a self-calibration call will affect other virtual instruments.Self-calibration takes time and in a running production environment, there may be a timeadvantage to performing self-calibration only when necessary.
Execution of self-calibration can be forced or conditional.• Forced self-calibration—Self-calibration executes when the client sends *CAL to the
WTS instrument. *CAL triggers execution of the internal self-calibration on all RF chainsin the instrument.
• Conditional self-calibration—Self-calibration executes only when necessary, based ontime and temperature drift. Conditional self-calibration initiates when the instrumentreceives the following command:CALibration:RF:INITiateSpecify the time and temperature values for which to initiate self-calibration using thefollowing commands:CALibration:RF:AUTOmatic:TEMPeratureCALibration:RF:AUTOmatic:TIME
RF General Settings and Mandatory SCPI CommandListComplete list of RF General Settings and mandatory SCPI commands.
RF General Settings SCPI Command ReferenceSCPI command reference for RF General Settings and Mandatory commands.
*CAL
Usage:*CAL?Query Response:<CalibrationResult>
Description Performs an internal partial self-calibration on all RF chains.Self-calibration may take up to 10 minutes per chain.Partial self-calibration results are saved in the Instrument sessionand therefore are lost upon reboot.During execution, the instrument is unresponsive in all virtualinstruments. Extend the Visa timeout before sending thiscommand to ensure receiving a response from the commandwhen it has completed.
Availability Query
Execution Mode Sequential
Parameter: <CalibrationResult>
Description Result of the performed self-calibration.0 : Self-calibration has completed without errors.-1: Self-calibration resulted in an error.
Description Exeute device selftest. This command has the functionality of*TST and will be renamed to that in a later release.
Availability Query
Execution Mode Sequential
Parameter: <SelfTestResult>
Description Number returned indicates which selftests failed. 0 is the result of apassed test.1 : Internal looptest failed.2 : Internal Broadcast looptest failed.
Datatype Integer32
*TST
Usage:*TST?Query Response:<TestResult>
32 | ni.com | WTS Software User Guide
Description Executes the internal Self-Test(s).WTS-IS uses in this instrument version the *TES commandinstead
Availability Query
Execution Mode Sequential
Parameter: <TestResult>
*WAI
Usage:*WAI
Description Wait-to-Continue Command
Makes Instrument wait until all pending operations are completedbefore executing commands following *WAI command.
Description Calibration executes only if the current instrument temperatureexceeds the temperature at previous calibration by a value greater orequal to the value specified by this parameter.
Description Maximum allowed time interval, in hours, between internal self-calibration executions. Self-calibration executes if the time since thelast self-calibration exceeds the value specified by this parameter.The value of this parameter does not change when *RST is called.
Datatype Integer32
Default Value 24
Range [0:2147483647]
CALibration:RF:FULL
Usage:CALibration:RF:FULL
Description Performs an internal self-calibration on all RF chains. Self-calibration may take up to 10 minutes per chain. The self-calibration data of each chain is stored on the nonvolatile memoryof the module. If the chain has External LO, an extra LOalignment is performed.After completion of this command a *RST is REQUIRED in allrunning Virtual Instruments.During execution, the instrument is unresponsive in all virtualinstruments. Send *OPC? to the instrument to query when it hasconcluded the calibration. The expected return is 1 or Visatimeout. Extend the Visa timeout to reduce the number of *OPC?sent.
Description Conditionally initiates internal partial self-calibration of hardwareassociated with the <TargetPortName>. Calibration only executes ifthe temperature drift or elapsed time since last calibration exceeds aspecified value. The same physical hardware may be used onseveral ports, so the actual hardware may have been calibrated byexecution of calibration on another port.To execute all ports, leave the parameter blank. Calibration can takeup to 10 minutes per chain.Partial self-calibration results are saved in the Instrument sessionand therefore are lost upon reboot.During execution, the instrument is unresponsive in all virtualinstruments. Send *OPC? to the instrument to query when it hasconcluded the calibration. The expected return is 1 or visa timeout.Extend the Visa timeout to reduce the number of *OPC? sent.
Availability Command
ExecutionMode
Sequential
Parameter: <TargetPortName>
Description Name of the port on which to initiate calibration.
Description List containing the frequency values. The size of the list must matchthe currently defined number of points for the table.The order of the list should follow the order of the correspondingloss and power magnitude lists.
Description List containing the loss magnitude (attenuation) values. The size ofthe list must match the currently defined number of points for thetable.The order of the list should follow the order of the correspondingfrequency and power magnitude lists.
Description Specifies or changes the number of points in a given table. Thecurrently defined values in the table are preserved for the lengthof the list. If the new list size is longer, new entries are createdand initialized with '0.00'. If the new list size is shorter, theexceeding values are discarded.
Description Assigns a user-specified logical port name to a given physicalport. Use logical port names to associate correction tables toports, which improves descriptions of system connections andsignal paths. Logical port definitions are not stored permanentlyand are deleted after an instrument restart.
Description Deletes a specified logical port name binding. This commanddeletes both RFSA and RFSG port names.
Availability Command
Execution Mode Overlapped
Parameter: <LogicalPortName>
Description Logical port name to delete.
Datatype String
Default Value ""
ROUTe:RF:PORT:DELete:ALL
Usage:ROUTe:RF:PORT:DELete:ALL
Description Deletes all user-defined port name bindings, and frees all namescreated by the PORT command. This command deletes bothRFSA and RFSG port names.
Description Assigns a user-specified logical port name to a given physicalRFSA port. Use logical port names to associate correction tablesto ports, which improves descriptions of system connections andsignal paths.
Description Assigns a user-specified logical port name to a given physicalRFSG port. Use logical port names to associate correction tablesto ports, which improves descriptions of system connections andsignal paths.
Description SYSTem:ERRor:CODE[:NEXT]? queries the error/event queuefor the next item andremoves it from the queue. The response returns only the error/event code number omittingthe string. Except for the shortened response, the query operatesidentically toSYSTem:ERRor[:NEXT]?
Description SYSTem:ERRor:CODE:ALL? queries the error/event queue forall the unread items andremoves them from the queue. The response returns a commaseparated list of only theerror/event code numbers in FIFO order. If the queue is empty,the response is 0.Note: If the queue is not empty, the 0 is not sent.
Availability Query
ExecutionMode
Sequential
Parameter: <AllErrorCodes[n]>
SYSTem:ERRor:COUNt
Usage:
60 | ni.com | WTS Software User Guide
SYSTem:ERRor:COUNt?Query Response:<ErrorCount>
Description SYSTem:ERRor:COUNt? queries the error/event queue for thenumber of unread items. Aserrors and events may occur at any time, more items may bepresent in the queue at the timeit is actually read.Note: If the queue is empty, the response is 0.
Description Returns the temperature for the device in the PXI<i> slot number.
Availability Query
Execution Mode Overlapped
Parameter: <HardwareProduct>
Description Hardware product name.
Datatype String
Parameter: <ResourceName>
Description System assigned resource name.
Datatype String
Parameter: <Temperature>
Description Current module temperature, if applicable.
Datatype Double
SYSTem:HARDware<i>:RESet
Usage:SYSTem:HARDware<i>:RESet
Description Forces the instrument to a full reset of its internal hardware. Thisaffects all ivirtual instrument sessions and requires a *RST of allused virtual insturment after this command completes.
Description Sets the type of connection for the given connection index. Changestake affect after the next instrument restart.If the session changes, the session parameters are set to their defaultvalues.VXI11: Sets the connetion to one of type VXI-11.SOCKET: Sets the connection to one of type Raw TCPIP socket.
Description Returns all the personalities that the instrument has and the statusof them.
Availability Query
Execution Mode Sequential
Parameter: <Personality>
Description Name of the instrument personality.
Datatype String
Parameter: <LoadStatus>
Description 0 : The specified personality is currently not loaded in the instrument.1 ::The specified personality is currently loaded in the instrument.
Description On systems that have external oscillator (PXIe-5653), this flagcan force to use the internal oscillator of the instrument. This ismostly used for debug purposes or for pathloss calibration andtasks where the external oscillator does not provide betteraccuracy.
Description INTERNAL: Selects the 'best' internal frequency reference in theinstrument. Includesa) OnboardClock : Locks the instrument to the LocalOscillatorSource onboard clock frequency reference.b) PXI_Clk : Locks the instrument to the PXI backplane Clockfrequency reference.If the WTS hardware has OCXO timing C\card, then this clock isselected. To the individual modules this is 'seen' as RefIn but to theuser, this is an internal component. These WTS hardwares do notsupport external reference.
EXTERNAL: Selects the external frequency reference connected tothe instrument.a) RefIn : Connects the external signal to Instruments REF IN/OUTconnector.b)ClkIn : Instrument locks to an external 10MHz signal.
Description On systems that have an external oscillator, this flag can force thesignal analyzer(s) to use the internal oscillator of the instrument.You can use this to decouple the SA center frequency and SGcenter frequency in shared LO systems.
Description Configures on which port the signal in this connection session isgenerated. This information is required for the concurrencymanagement to decide if it can be joined with other signalgenerations. For MIMO signal generations the port names have tobe given separated by a vertical bar, e.g. Port0|Port4. These portsmust be located on different switch banks.
Description Starts and ends broadcasting-enabled sections in the testplan.First configure a broadcasting context, then enable it using thiscommand. If in other connection sessions the same contextnameis configured, this command waits for this other client to join.
Availability Command
Execution Mode Sequential
Parameter: <Action>
Description Tells the concurrency management if a potential broadcastingsegment starts or ends. Possible values are START and END.
Datatype Enumeration
Default Value START
Range START | END
Parameter: <ContextName>
Description Tells the concurrency management which broadcasting context tostart or end.
Description This is an advanced command. Configures the RFSG lock selfrelease time. Increase this value if two clients want to use thesame RFSG hardware but one of them uses it for a long time. Ifthe release time value is too short, the instrument errors out forthe waiting client.
Description This is an advanced command. If a testplan turns ON SG anddoes not turn OFF, set this time to autorelease to share it withother sessions. By default, this number is very large to make itwork like a traditional SG.
Description RFSG ownership duration. This means that if turned ON, the SGturns OFF automatically with NO ERROR after this amount of time.The default value is 1.6 hours (=6000Sec).
Datatype Integer32
Default Value 6000
Range [1:2147484]
Unit Sec
SYSTem:VERSion
Usage:SYSTem:VERSion?Query Response:<ScpiVersion>
Description Version of SCPI supported
Availability Query
Execution Mode Sequential
84 | ni.com | WTS Software User Guide
Parameter: <ScpiVersion>
GPRF Instrument PersonalitiesUse the SCPI commands for the GPRF instrument personality to perform time-based I/Q andpower measurements that are not defined by a specific wireless standard.
GPRF measurements are used to calibrate devices under test (DUTs). You can also use GPRFcommands to store and load TDMS files.
Continuous Wave (CW) Loopback ExampleThis example demonstrates how to generate and measure a CW signal using the GPRFanalyzer and generator personalities. You can also use this example for debugging purposes orif you suspect that your instrument does not generate or receive signals correctly.
The example generates a -10 dBm CW signal at 1 GHz using the GPRF signal generator andperforms a transmit power (TXP) measurement using the GPRF signal analyzer.1. Ensure the state of your instrument by sending the following command to reset your
instrument and clear the status registers of any previous errors:*RST;*CLS
2. Configure the signal analyzer for a TXP measurement of a signal at 1 GHz with amaximum input of -10 dBm received at Port 0:CONFigure:RFSA:GPRF:MEASurement:TXPower:ENABle ONCONFigure:RFSA:GPRF:FREQuency:CENTer 1E9CONFigure:RFSA:GPRF:POWer:MAXimum -10 CONFigure:RFSA:GPRF:PORTname "Port0" TRIGger:RFSA:GPRF:SOURce 'RF 0'INITiate:RFSA:GPRF;*STB? The result of the *STB? query should be a response of 0, which indicates that no errorsoccurred for the commands sent.
3. Configure the generator to output a CW signal of -10 dBm on 1 GHz at Port 0 and startthe generator:SOURce:RFSG:GPRF:MODE CWSOURce:RFSG:GPRF:RFSettings:LEVel -10SOURce:RFSG:GPRF:FREQuency:CENTer 1E9SOURce:RFSG:GPRF:RFSettings:PORTname "Port0" SOURce:RFSG:GPRF:STATe ON;*STB?
4. Fetch the measured results:FETCh:RFSA:GPRF:RESults:TXPower:ALL?This should result in the response:<AveragePower>,<PeakToAverageRatio>,<MaxPower>,<MinPower>
Description Specifies the averaging type for the frequency countmeasurement. The averaged instantaneous signal phase differenceis used for the measurement.
Description MEAN: Uses the mean of the instantaneous signal phase differenceover multiple acquisitions for the frequency measurement.MAX: Uses the maximum instantaneous signal phase differenceover multiple acquisitions for the frequency measurement.MIN: Uses the minimum instantaneous signal phase difference overmultiple acquisitions for the frequency measurement.MAXMIN: Uses the maximum instantaneous signal phasedifference over multiple acquisitions for the frequencymeasurement. The sign of the phase difference is ignored to find themaximum instantaneous value.
Description Specifies the bandwidth of the resolution bandwidth (RBW) filterused for the frequency count measurement.FCOunt is computed from a zero span measurement oftransmitted power using the time-domain signal as seen through aresolution bandwidth filter for the specified measurement interfal.For this reason RBW = measurement BW
Description Specifies the shape of the digital resolution bandwidth (RBW)filter used for the frequency count measurement.FCOunt is computed from a zero span measurement oftransmitted power using the time-domain signal as seen through aresolution bandwidth filter for the specified measurement interfal.For this reason RBW = measurement BW
Description NONE: The measurement does not use any RBW filtering.GAUSSIAN: The RBW filter has a Gaussian response.FLAT: The RBW filter has a flat response.ST4: The RBW filter has a response of a 4-pole synchronously-tuned filter.ST5: The RBW filter has a response of a 5-pole synchronously-tuned filter.RRC: The RRC filter uses the roll-off factor specified by the alphavalue.
Description Specifies the roll-off factor of the root-raised cosine (RRC) filterused for the frequency count measurement.FCOunt is computed from a zero span measurement oftransmitted power using the time-domain signal as seen through aresolution bandwidth filter for the specified measurement interfal.For this reason RBW = measurement BW
Description Interval for the IQVT measurement. The measurement is performedfor the specified interval, which is recommended, but not required,to be less than the slot duration.
Datatype Double
Default Value 1.000000000000000E-003
Range [1.000000000000000E-006:1.000000000000000E+001]
Description Specifies the bandwidth of the resolution bandwidth (RBW) filterused for the I/Q versus time (IQVT) measurement.This measurement is a zero span measurement of transmittedpower using the time-domain signal as seen through a resolutionbandwidth filter for the specified measurement interfal. For thisreason RBW = measurement BW
Description Specifies the shape of the digital resolution bandwidth (RBW)filter used for the I/Q versus time (IQVT) measurement.This measurement is a zero span measurement of transmittedpower using the time-domain signal as seen through a resolutionbandwidth filter for the specified measurement interfal. For thisreason RBW = measurement BW
Description NONE: The measurement does not use any RBW filtering.GAUSSIAN: The RBW filter has a Gaussian response.FLAT: The RBW filter has a flat response.ST4: The RBW filter has a response of a 4-pole synchronously-tuned filter.ST5: The RBW filter has a response of a 5-pole synchronously-tuned filter.RRC: The RRC filter uses the roll-off factor specified by the alphavalue.
Description Specifies the roll-off factor of the root-raised cosine (RRC) filterused for the I/Q versus time (IQVT) measurement.This measurement is a zero span measurement of transmittedpower using the time-domain signal as seen through a resolutionbandwidth filter for the specified measurement interfal. For thisreason RBW = measurement BW
Description MEAN: Uses the mean of the instantaneous power in the powertrace over multiple acquisitions for the TXP measurement.MAX: Uses the maximum instantaneous power in the power traceover multiple acquisitions for the TXP measurement.MIN: Uses the minimum instantaneous power in the power traceover multiple acquisitions for the TXP measurement.MAXMIN: Uses the maximum instantaneous power in the powertrace over multiple acquisitions for the TXP measurement. The signof the power is ignored to find the maximum instantaneous value.(Not supported at this point)
Description Specifies the bandwidth of the transmit power (TXP) filter usedfor the frequency count measurement.TxP is a zero span measurement of transmitted power using thetime-domain signal as seen through a resolution bandwidth filterfor the specified measurement interfal. For this reason RBW =measurement BW
Description Specifies the shape of the digital resolution bandwidth (RBW)filter.TxP is a zero span measurement of transmitted power using thetime-domain signal as seen through a resolution bandwidth filterfor the specified measurement interfal. For this reason RBW =measurement BW
Description NONE: The measurement does not use any RBW filtering.GAUSSIAN: The RBW filter has a Gaussian response.FLAT: The RBW filter has a flat response.ST4: The RBW filter has a response of a 4-pole synchronously-tuned filter.ST5: The RBW filter has a response of a 5-pole synchronously-tuned filter.RRC: The RRC filter uses the roll-off factor specified by the alphavalue.
Description Specifies the roll-off factor of the root-raised cosine (RRC) filterused for the transmit power (TXP) measurement.TxP is a zero span measurement of transmitted power using thetime-domain signal as seen through a resolution bandwidth filterfor the specified measurement interfal. For this reason RBW =measurement BW
Description When initiated, the signal is acquired from the port specified byPORTname. The signal is adjusted for any attenuation tableassigned to that port.
Description Specifies the mode used to determine the level of the maximuminput power. Auto power takes additional time to execute becauseit requires additional signal acquisition for the instrument toevaluate the signal strength of the applied signal.
Description Enables or disables frequency count measurements for all segmentsof the sequence. The size of the array depends on the currentlydefined number of segments.0 | OFF: Disables the frequency count measurement.1 | ON: Enables the frequency count measurement.
Description Enables or disables IQVT measurements for all segments of thesequence. The size of the array depends on the currently definednumber of segments.0 | OFF: Disables the IQVT measurement.1 | ON: Enables the IQVT measurement.
Description Interval for the IQVT measurement. The measurement is performedfor the specified interval, which is recommended, but not required,to be less than slot duration. The size of the array depends on thecurrently defined number of segments.
Description Enables or disables TXP measurements for all segments of thesequence. The size of the array depends on the currently definednumber of segments.0 | OFF: Disables the TXP measurement.1 | ON: Enables the TXP measurement.
Description Duration of each segment of the sequence. The size of the arraydepends on the currently defined number of segments.Each <SegmentDuration> element must be greater than<SlotCount> x <SlotDuration> for the corresponding segments.
Description Specifies the external attenuation for all segments in thesequence. External attenuation is applied on top of anyattenuation provided for the specified port.
Description Specifies the number of segments in a sequence. You must setthis parameter before setting other sequence-based instrument ormeasurement parameters.
Description Offset from the start of the segment until the measurement intervalbegins. The size of the array depends on the currently definednumber of segments.
Description If disabled, no trace data is collected so no traces are fetched.0 | OFF: Disables collection of trace data.1 | ON: Enables collection of trace data.
Description Fetches the frequency counter frequency error results.
Availability Query
Execution Mode Overlapped
Parameter: <AverageMeanFrequencyError>
Description Average mean frequency error evaluated over the specified interval.The averaging is controlled by the configured type and number ofaverages.
Description Average frequency error for each slot in the segment. The frequencyerror is the mean frequency delta to the requested freqency valueevaluated over the specified interval.The averaging is controlled by the configured type and number ofaverages.
Description Fetches the I/Q versus time (IQVT) frequency error results for agiven segment.
Availability Query
Execution Mode Overlapped
Parameter: <MeanFrequencyError[n]>
Description Frequency error for each slot in the segment. The frequency error isthe mean frequency error evaluated over the specified interval andcompared to the expected center frequency.
Description Fetches the transmit power (TXP) power results for a givensegment.
Availability Query
Execution Mode Overlapped
Parameter: <AveragePower[n]>
Description Average power for each slot in the segment. The power is the meanpower evaluated over the specified interval.The averaging is controlled by the configured type and number ofaverages.
Description Fetches the transmit power (TXP) power results for a givensegment.
Availability Query
Execution Mode Overlapped
Parameter: <MaximumPower[n]>
Description Maximum power for each slot in the segment. The power is themaximum power evaluated over the specified interval.The averaging is controlled by the configured type and number ofaverages.
Description Fetches the transmit power (TXP) power results for a givensegment.
Availability Query
Execution Mode Overlapped
Parameter: <MinimumPower[n]>
Description Minimum power for each slot in the segment. The power is theminimum power evaluated over the specified interval.The averaging is controlled by the configured type and number ofaverages.
Description IDLE: Hardware is available.PENDING: Execution is waiting for hardware to release.ACTIVE: Hardware is actively acquiring data.
Datatype Enumeration
Parameter: <MeasurementState>
Description OFF: The measurement has not been initiated yet.READY: The measurement result is available to fetch.PENDING: The measurement is initiated but has not started receivingdata to process.PROCESSING: The measurement is processing the acquired data.
Description Fetches the transmission power (TXP) power results.
Availability Query
Execution Mode Overlapped
Parameter: <AverageMeanPower>
Description Average power is the mean power evaluated over the specifiedinterval.The averaging is controlled by the configured type and number ofaverages.
144 | ni.com | WTS Software User Guide
Datatype Double
Unit dBm
Parameter: <PeakToAverageRatio>
Description Peak to average TXP ratio.
Datatype Double
Unit dB
Parameter: <MaxPower>
Description Maximum power is the maximum power evaluated over the specifiedinterval.The averaging is controlled by the configured type and number ofaverages.
Datatype Double
Unit dBm
Parameter: <MinPower>
Description Minimum power is the minimum power evaluated over the specifiedinterval.The averaging is controlled by the configured type and number ofaverages.
Description Fetches the transmit power (TXP) power results.
Availability Query
Execution Mode Overlapped
Parameter: <AverageMeanPower>
Description Average power is the mean power evaluated over the specifiedinterval.The averaging is controlled by the configured type and number ofaverages.
Description Fetches the transmit power (TXP) power results.
Availability Query
Execution Mode Overlapped
146 | ni.com | WTS Software User Guide
Parameter: <MaxPower>
Description Maximum power is the maximum power evaluated over the specifiedinterval.The averaging is controlled by the configured type and number ofaverages.
Description Fetches the transmit power (TXP) power results.
Availability Query
Execution Mode Overlapped
Parameter: <MinPower>
Description Minimum power is the minimum power evaluated over the specifiedinterval.The averaging is controlled by the configured type and number ofaverages.
Description Fetches the I/Q samples from the measurement. The arrayconsists of interleaved I and Q samples. The size of the array isthe total size (twice the size of the I/Q samples as they areinterleaved).
Availability Query
Execution Mode Overlapped
Parameter: <Xo>
Description Origin point of the x-axis of trace data (start time).
Description Minimum quiet time. The signal is quiet when it is below the triggerlevel when you set the EDGE property to RISING, or above thetrigger level when you set the EDGE property to FALLING.
Description IMMEDIATE - Generates the signal to measure when the hardwareis ready.POWER - Uses RF power edge trigger.INTERNAL - Uses one of the multiple WTS internal triggers, whichmust be exported by any other personality configured to use thesame port. The port name must be defined before this command isexecuted.
Description Specifies the trigger threshold to use when power triggering. Thisvalue is referenced to the unit under test (UUT) port, accountingfor external attenuation.
Description When initiated, the signal generates on the port defined by<PortName>. The signal is adjusted for any attenuation tableassigned to that port.
Description Specifies the source of the advance trigger to move betweenwaveforms.NONE: No advance trigger is used. This mode does not allow thegeneration to seemlessly switch waveforms.SOFTWARE: A seemless transition between waveforms will betriggered when an software advance command is received.
Description CONTINUOUS: Repeats the waveform file continuously until youabort the generation.FINITE: Repeats the waveform file a finite number of times.
Description Catalogs the arbitrary waveform files available on the instrument.
Availability Query
Execution Mode Overlapped
Parameter: <WaveformFileName>
Description Optional name of the waveform file. If a waveform file exists, thereturn value is 1 or 0.
Datatype String
Parameter: <WaveformList>
Description List containing the waveform files on the instrument hard drive.If any parameter is passed to this command, the return value is 1(waveform file found), or 0 (waveform file not found).
Description CW: Generates an unmodulated continuous wave (CW) tone.MULTITONE: Generates a set of multiple tones at different powersand frequencies.ARB: Generates a signal determined by the specified waveform file.SEQUENCE: Generates an arbitrary waveform at certainfrequencies and levels for a specified segment.
Description Configures the source for the list trigger.TIMER: The list advances as soon as the segment duration iscomplete.SOFTWARE: The list trigger is tied to software advance trigger.Use TRIG:RFSG:GPRF:ADV:SOFT:NEXT to advance through thelist.
Description Duration of each segment of the sequence. The size of the arraydepends on the currently defined number of segments. To specifycontinous generation for a given segment, set the correspondingarray element to -1.
Datatype Double
Default Value 1.000000000000000E-002
Range [-1.100000000000000E+000:3.000000000000000E+001]
Description Specifies the external attenuation for all segments in thesequence. External attenuation is applied on top of anyattenuation provided for the specified port.
Description Specifies the output port for all segments in the sequence. Thefirst element of the sequence must either match the port assignedto the GPRF session or must be set to "SELF".
Description Port per segment. The size of the array depends on the currentdefined number of segments. Specify "SELF" to use the portcurrently assigned to the GPRF instance.
Datatype String
Default Value "SELF"
SOURce:RFSG:GPRF<i>:SEQuence:PORTname:RESet
Usage:SOURce:RFSG:GPRF<i>:SEQuence:PORTname:RESet
Description Clears the configured sequence of all port names. Until asequence of ports is configured again, all sequence elementsautomatically generate on the port assigned to the particularGPRF session.
Description Specifies the pre-trigger behavior when using sequence mode. Ifset to True, the instrument generates the waveform defined forthe first segment before the trigger event occurs.
Description Specifies the output port for all segments in the sequence. Thefirst element of the sequence must either match the port assignedto the GPRF session or must be set to "SELF".
Description Port per segment. The size of the array depends on the currentdefined number of segments. Specify "SELF" to use the portcurrently assigned to the GPRF instance.
Description Array of frequency offsets from the center frequency. The valuessupported depend on the number of tones and the separationbetween them. The array size is equal to the configured number oftones.
Datatype Double
Default Value 0.000000000000000E+000
Range [-1.000000000000000E+008:1.000000000000000E+008]
Description Sends a software trigger to advance the generation script. ForARB mode, this moves onto the next waveform if multiplewaveforms have been defined. For SEQ mode, this moves to thenext segment. This function is valid only if the Advance Triggersource is set to SOFTWARE and the mode is ARB or SEQ.
Description NONE: No signal is exported.INTERNAL: If marker0 is detected in the script, then SG exports atrigger signal through PXI Trigger Line 0 to the analyzer.
Description Immediate - Generates the signal to measure when the hardware isready.Internal - Uses an internal trigger route. Requires the user to exporta signal to the internal destination with another command.PFI 0 - Uses the front panel PFI 0 trigger if available.PFI 1 - Uses the front panel PFI 1 trigger if available.
Description Trigger timeout. The timeout watchdog does not start while thehardware configuration is pending. If the trigger timeout exceeds,the generator returns to OFF.
Datatype Double
Default Value 5.00
Range [0.00:10000.00]
Unit sec
WLAN Instrument PersonalitiesUse the SCPI commands for the WLAN instrument personalities to generate and performmeasurements on WLAN signals.
Supported WLAN measurements include spectral analysis, burst power, direct sequencespread spectrum (DSSS) power ramp-up and ramp-down, DSSS demodulation, and orthogonalfrequency division multiplexing (OFDM) demodulation on wireless local area network(WLAN) transceiver signals that conform to IEEE Standard 802.11a-1999, IEEE Standard802.11b-1999, IEEE Standard 802.11g-2003, IEEE Standard 802.11j-2004, IEEE Standard802.11n-2009, IEEE Standard 802.11p-2010, or IEEE Standard 802.11ac-2013. This manualassumes you are familiar with these IEEE standards.
WLAN Signal Analyzer SCPI Command ListComplete list of WLAN signal analyzer SCPI commands.
Description Specifies the external attenuation for all active chains. Externalattenuation is applied on top of any attenuation provided for thespecified port.
Description Specifies the center frequency for signal generation. Note: In caseof 802.11ac 80+80, the frequency of second segment should belarger than the first segment.
Description Calculates the carrier frequency of the WLAN signal to generate,according to the numbering scheme, by converting a set of inputparameters into the carrier frequency. The device computes thecarrier frequency according to sections 17.4.6, 18.3.8.3, 20.3.15of IEEE Standard 802.11-2012 and section 22.3.14 of IEEEStandard 802.11ac-2013.
Availability Command
Execution Mode Overlapped
Parameter: <Channel>
Description Center frequency offset, in 5 MHz increments, above the startingfrequency of the channel.When you set BWIDth to 40 MHz, FREQuency:CHANnel is theprimary channel number and the corresponding channel centerfrequency is the primary channel center frequency. Channel centerfrequency is calculated using the following formula:channel center frequency (Hz) = channel starting frequency (Hz) +(channel number * 5 MHz)
Datatype Integer32
Default Value 0
Range [0:200]
194 | ni.com | WTS Software User Guide
Parameter: <SecondaryFactor>
Description Specifies whether the secondary channel is above or below theprimary channel when you set BWIDth to 40 MHz.A 40 MHz channel is created by combining the primary channel andthe secondary channel, where each of the channels have a bandwidthof 20 MHz.The secondary channel number is given by the following formula:secondary channel number = primary channel number + (4 *secondary factor)The secondary channel center frequency is given by the followingformula:secondary channel center frequency (Hz) = channel startingfrequency (Hz) + (secondary channel number * 5 MHz)
Description Specifies the expected maximum power level of the incomingsignal at the input of the instrument, for the specified chain.Set this command to the maximum transmission power of thesignal burst after subtracting any cabling or fixture losses.
Description Specifies the expected average power level of the incomingsignal at the input of the instrument, for the specified chain.Set this command to the average transmission power of the signalburst after subtracting any cabling or fixture losses.
Description Specifies the number of iterations over which to average thedemodulation-based measurements.If you increase the number of averages, the device providessmoother values but takes longer to compute the values.
Description Specifies whether to enable equalization. The IEEE Standard802.11-2007 does not allow equalization before computing errorvector magnitude (EVM).If equalization is enabled, the device does not support measurementof I/Q impairments and decoding of bits.Equalization is not supported for signals with data rates of 22MBps and 33 MBps. Do not enable equalization when performingdemodulation measurements on signals with data rates of 22 MBpsand 33 MBps.If the DSSS Equalization is enabled, the actual number of chips thedevice uses to calculate EVM varies. For example, the device uses773 chips for EVM calculation if the DSSS Maximum Chips Usedis set to 1000. If you increase the value of Maximum Chips Used,the instrument uses up to a maximum of 991 more chips.
Availability Command/Query
ExecutionMode
Command: OverlappedQuery: Sequential
Parameter: <EqualizationEnabled>
Description 0 | OFF : Disables equalization.1 | ON : Enables equalization.
Description Specifies the pulse-shaping filter for the generation of matched-filter coefficients. In most cases, you must set this property to theoption that is used for the device under test (DUT).The instrument ignores this property if you set the DSSSEqualization Enabled property to True.
Description NONE : No pulse shaping filter is used.RCOSine : Uses a raised cosine filter.RRCOSINE :Uses a root-raised cosine filter.GAUSsian : Uses a Gaussian filter.
Description Specifies the Pulse Shaping Filter Coefficient value of alpha ifthe Pulse Shaping Filter type is set to Raised Cosine or Root-Raised Cosine. If the Pulse Shaping Filter type is set to Gaussianin non-equalization mode, the Reference Pulse Shaping FilterCoefficient property specifies the value of BT, where B is the 3dB filter bandwidth and T is symbol time.
Description When DSSS Phase Tracking Enable is set to TRUE, themeasurement will perform a measurement that ignores all sourcesof phase error, be it from phase noise, AWGN, or non linearity.The resultant EVM will represent the EVM due to amplitudeerror only. This setting should be used for diagnostic purposesonly and does not represent a realistically achievable EVM. Toperform the measurement per the IEEE specification, thisproperty should be FALSE.
Description PAMBLE: Estimates the CFO using only the L-LTF field in thepreamble. (Obsolete: Use IPAMBLE)PDATA: Estimates the CFO using the preamble and pilot subcarriersin the data portion.CPREFIX: Estimates the CFO using the cyclix prefix (CP) of thesymbols.PPDATA: Estimates the CFO using the preamble, pilots, and datasubcarriers.IPAMBLE: Estimates the CFO using only the L-LTF field in thepreamble.FPAMBLE: Estimates the CFO using the L-LTF and HE-SIG fieldsin the preamble (Only valid for 802.11ax)
Description Demodulates the combined MIMO signal. A dedicated scramblerseed can speed up the measurement. If setting the seed to -1, avariable seed is assumed which must be esimated by theinstrument. The defined reference data must support all possibleseeds.
Description Specifies whether to perform low-pass filtering, to remove out-of-band noise, after acquiring the baseband signal.
Note EVM measurement quality may be affected by out-of-bandspurious signals if the NI RF vector signal analyzer bandwidth(defined as 0.8 * I/Q rate) is significantly greater than the channelbandwidth. Enable the software low-pass filter to reject the out-of-channel noise.
Description Specifies the maximum number of symbols that the device usesto compute error vector magnitude (EVM). This value must beset correctly to optimize measurement speed. If the number ofavailable payload symbols is greater than the value specified, theinstrument ignores the additional symbols from the end of thepacket.Note: If you set this value to -1, the instrument uses all symbolsin the signal for the measurement.
Description Specifies whether to enable pilot-based mean amplitude tracking.Amplitude tracking is useful if the mean amplitude of the OFDMsymbol varies over time. However, enabling tracking maydegrade error vector magnitude (EVM) values by approximately1 dB to 2 dB because of attempts to track random amplitudedistortions caused by noise and residual intercarrier interferencefrom symbol to symbol.
Description 0 | OFF : The instrument uses only the long training sequence (LTS)to compute the channel frequency response. the instrument uses thisresponse as the channel frequency response estimate over the entirepacket.1 | ON : The instrument uses the entire packet to compute thechannel frequency response. The instrument estimates the channelresponse over preamble and data, and then uses this response as thechannel frequency response estimate.
Description When DSSS Phase Tracking Enable is set to TRUE, themeasurement will perform a measurement that ignores all sourcesof phase error, be it from phase noise, AWGN, or non linearity.The resultant EVM will represent the EVM due to amplitudeerror only. This setting should be used for diagnostic purposesonly and does not represent a realistically achievable EVM. Toperform the measurement per the IEEE specification, thisproperty should be FALSE.
Description NONE: Disables phase tracking.STANDARD: Enables symbol-by-symbol pilot-based commonphase error correction. The instrument performs pilot-basedcommon phase error correction over the orthogonal frequencydivision multiplexing (OFDM) symbol, as specified in section17.3.9.7 of IEEE Standard 802.11a-1999, section 20.3.21.7.4 ofIEEE Standard 802.11n-2009, and section 22.3.18.4.4 of IEEEStandard 802.11ac-2013.CSF: Performs a cubic spline fit on pilot-based common phase erroracross symbols and then does a symbol-by-symbol phase errorcorrection.INSTANT: Enables symbol-by-symbol pilot-based common phaseerror correction and compensates for instantaneous phase errors.The instrument performs pilot-based common phase error correctionover the OFDM symbol and also compensates for the phasedistortion in each modulation symbol. Such compensation is notdefined in the IEEE standard. However, the compensation is usefulfor determining the modulation distortion in the amplitude and thecontribution of phase errors. Using this method of phase tracking,the instrument computes only the magnitude portion of the errorvector magnitude (EVM), which is the error caused by the variationin magnitude of the complex modulation symbol over the length ofthe packet and different subcarriers.
Description Specifies whether to enable compensation for Sample Clockfrequency offset.Although the estimation of the Sample Clock offset occurs over amaximum of 100 orthogonal frequency division multiplexing(OFDM) symbols in the frequency domain, the instrumentcompensates for this offset in the time domain to ensure thatclock cycle slips can be adjusted.
Description Specifies the number of iterations over which to average thepower ramp up/down time measurements.If you increase the number of averages, the instrument providessmoother values but takes longer to compute the values.
Description Specifies whether to enable the measurement of the power ramp-up or ramp-down time for 802.11b and 802.11g direct sequencespread spectrum (DSSS) signals.
Description Specifies the number of iterations over which the instrumentaverages power ramp up/down time measurements.If the number of averages is increased, the instrument providessmoother values but takes longer to compute the values.
Description Specifies the number of iterations over which to average the STArelative frequency measurements.If you increase the number of averages, the device providessmoother values but takes longer to compute the values.
Description PDATA : Estimates the CFO using the preamble and pilotsubcarriers in the data portion.CPREFIX: Estimates the CFO using the cyclix prefix (CP) of thesymbols.PPIDATA: Estimates the CFO using the preamble, pilot subcarriers,and data. (Obsolete: Use PPDATA)PPDATA: Estimates the CFO using the preamble, pilot subcarriers,and data.
Description Specifies the maximum number of symbols that the device usesto compute STA relative frequency. This value must be setcorrectly to optimize measurement speed. If the number ofavailable payload symbols is greater than the value specified, theinstrument ignores the additional symbols from the end of thepacket.Note: If you set this value to -1, the instrument uses all symbolsin the signal for the measurement.
Description Specifies the number of iterations over which to average spectraldensity measurements.If you increase the number of averages, the instrument providessmoother values but takes longer to compute the values.
Description Specifies the number of iterations over which to average spectralemissions mask (SEM) measurements.If you increase the number of averages, the instrument providessmoother values but takes longer to compute the values.
Description RMS: Performs root mean square averaging of the gated spectrumdata over all iterations.LOG: Performs logarithmic averaging of the gated spectrum dataover all iterations.
Description NONE: No window is applied.HANNING: Applies a Hanning window to the waveform using thefollowing equation:y[i] = 0.5 * x[i] * [1 - cos(w)]where w = (2pi)i/nn = the waveform sizeThe Hanning window is useful for analyzing transients longer thanthe time duration of the window, as well as for general-purposeapplications.HAMMING: Applies a Hamming window to the waveform using thefollowing equation:y[i] = x[i] * [0.54 - 0.46cos(w)]where w = (2pi)i/nn = the waveform sizeNote Hanning and Hamming windows are somewhat similar.However, in the time domain, the Hamming window does notapproach zero at the edge of the window as fast as does the Hanningwindow.BHARRIS: Applies a Blackman-Harris window according to thefollowing equation:y[i] = x[i] * [0.42323 - 0.49755cos(w) + 0.07922cos(2w)]where w = (2pi)i/nn = the waveform sizeEBLACKMAN: Applies an Exact Blackman window according tothe following equation:y[i] = x[i] * [a_0 - a_1cos(w) + a_2cos(2w)]where w = (2pi)i/nn = the waveform sizea_0 = 7938/18608a_1 = 9240/18608a_2 = 1430/18608
BLACKMAN: Applies a Blackman window according to thefollowing equation:y_i = x_i[0.42 - 0.50cos(w) + 0.08cos(2w)].where w = (2pi)i/nn = the waveform sizeA Blackman window is useful for analyzing transient signals andprovides similar windowing to Hanning and Hamming windows butadds one additional cosine term to reduce ripple.FLATTOP: Applies a Flat Top window according to the followingequation:y[i] = x[i] * [a_0 - a_1cos(w) + a_2cos(2w) - a_3cos(3w) +a_4cos(4w)]where w = (2pi)i/nn = the waveform sizea_0 = 0.215578948a_1= 0.41663158a_2 = 0.277263158a_3 = 0.083578947a_4 = 0.006947368.The fifth-order Flat Top window has the best amplitude accuracy ofall the window functions. The increased amplitude accuracy (_0.02dB for signals exactly between integral cycles) is at the expense offrequency selectivity. The Flat Top window is most useful inaccurately measuring the amplitude of single frequency componentswith little nearby spectral energy in the signal.BHT4: Applies a 4-Term Blackman-Harris window according to thefollowing equation:y[i] = x[i] * [0.422323 - 0.49755cos(w) + 0.07922cos(2w)]where w = (2pi)i/nn = the waveform sizeThe 4-term Blackman-Harris window has a side-lobe rejection in theupper 90 dB, with a moderately wide side lobe.
236 | ni.com | WTS Software User Guide
BHT7: Applies a 7-Term Blackman-Harris window according to thefollowing equation:y[i] = x[i] * [a_0 - a_1cos(w) + a_2cos(2w) - a_3cos(3w) +a_4cos(4w) - a_5cos(5w) + a_6cos(6w)]where w = (2pi)i/nn = the waveform sizea_0 = 0.27105140069342a_1 = 0.43329793923448a_2 = 0.21812299954311a_3 = 0.06592544638803a_4 = 0.01081174209837a_5 = 0.00077658482522a_6 = 0.00001388721735.The 7-term Blackman-Harris window has the highest dynamic rangeof the available windowing types and is ideal for signal-to-noise ratioapplications.LSIDELOBE: The Low Sidelobe window further reduces the size ofthe main lobe. The following equation defines the Low Sidelobewindow:where N = the length of the windoww = (2pi n/N)a_0 = 0.323215218a_1 = 0.471492057a_2 = 0.17553428a_3 = 0.028497078a_4 = 0.001261367
Description Specifies the array of frequency offsets used to define the spectralmask. The instrument does not assume mask symmetry.Therefore, both positive and negative offsets from the centerfrequency must be defined in ascending order. Refer to section20.3.21.1 of IEEE Standard 802.11n-20012 for the unlicensedband spectral mask definitions for the 20 MHz and 40 MHzbands.
Description Specifies the array of power offsets used to define the spectralmask. You must specify the offsets, in dB, from the maskreference power level for each of the frequency offset points. Theorder of the power offsets in this array corresponds to the order ofthe frequency offsets specified in the FOFFset command. Refer tosection 20.3.21.1 of IEEE Standard 802.11n-2009 for theunlicensed band spectral mask definitions for the 20 MHz and 40MHz frequency bands.
Availability Command/Query
ExecutionMode
Command: OverlappedQuery: Sequential
Parameter: <MaskLevelOffsetArray[n]>
Default Value -45.00,-28.00,-20.00,0.00,0.00,-20.00,-28.00,-45.00
Description Specifies the user-defined reference level to use for spectral maskmeasurements. Configure this attribute if you set theREFerence:TYPE to UDEFINED.
Description PEAK: Uses the peak signal power as the reference for spectralmask measurements.UDEFINED: (User-defined) Uses the value that you specify in theREFerence[:LEVel] command as the reference for spectral maskmeasurements.
Description Specifies the measurement length over each burst over which tocompute the SEM. Note: If you set the value to -1, the instrumentuses auto length according to standard for the measurment.
Description STANDARD: Uses the 20.3.20.1 (2.4 GHz band) of IEEE Standard802.11-2012 if you set the WLAN STANdard to 80211NMIMOOFDM. Uses 18.3.9.3 of IEEE Standard 802.11-2012 if youset the WLAN STANdard to 80211A/G/J/P OFDM. Uses 17.4.7.4 ofIEEE Standard 802.11-2012 if you set the WLAN STANdard to80211B DSSS; Uses 22.3.18.1 of IEEE Standard 802.11ac-2013 ifyou set WLAN STANdard to 80211AC MIMOOFDM.LEGACY: TBDCUSTOM: Uses the spectral mask defined by FOFFset andLOFFset values.
Description Specifies the number of iterations over which to average burstpower measurements.If you increase the number of averages, the instrument providessmoother values but takes longer to compute the values.
Description Specifies how to determine acquisition length. When enabled, theinstrument calculates the acquisition length based on the setstandard, enabled measurements, and number of averages. Afterexecution, you can use the SCPI query function for acquisitionlength to retrieve the acquisition length that was used.
Description Specifies the bandwidth, in Megahertz (MHz), of the orthogonalfrequency division multiplexing (OFDM) signal to be analyzed.The instrument uses this value for demodulation purposes.Configure this property only when you configure the instrumentfor OFDM|HT|VHT measurements.
Description Specifies whether to enable the dual carrier modulation (DCM)for RU for all users in case MU procedure protocol data unit(PPDU) and trigger-based PPDU.
Description MANUAL: The instrument uses the manually set headerparameters.FIRST : The instrument uses the header parameters detected in thefirst packet.ALL : The instrument uses the header parameters from everypacket.
Description Specifies the legacy payload data rate, in MBps, of the expectedincoming signal. This command is used for the WLAN standards802.11 a/b/g exclusively. In other WLAN standards the data rateis set implicitly based on the given MCS index.
Description LONG: Uses the long guard interval (1/4).SHORT: Uses the short guard interval (1/8).G1F4: Guard interval length is equal to one-fourth of the IDFT/DFTperiod.G1F8: Guard interval length is equal to one-eighth of the IDFT/DFTperiodG1F16: Guard interval length is equal to one-sixteen of theIDFT/DFT period.
Description 4X: Specifies 4x as the HE-LTF symbol duration.2X: Specifies 2x as the HE-LTF symbol duration1X: Specifies 1x as the HE-LTF symbol duration
Description Specifies the presence of an extra OFDM symbol segment forLDPC in the 802.11ax Trigger-based PPDU, which is used fordecoding the PSDU bits. The property is ignored if you set theHeader detection mode to FIRST or ALL for the PPDU typesother than Trigger-Based PPDU.
Description Specifies the length field in the LSIG field of 802.11ax signals.The property is ignored if you set the Header detection mode toFIRST or ALL.
Description Specifies the value of the modulation and coding scheme (MCS)index. In 802.11n, the MCS index is a compact representation thatdetermines the modulation scheme, coding rate, and number ofspatial streams as specified in section 20.3.5 of IEEE Standard802.11n-2009.In 802.11ac, the MCS index represents only the modulation schemeand coding rate as described in section 22.5 of IEEE Standard802.11ac-2013.
802.11ac has the number of space time streams set through thecommand: CONFigure:RFSA:WLAN<i>:PACKet:NSTS
Note: The MCS index range depends on the 802.11 standard.
Description Specifies the shape of the incoming MIMO mapping matrix.Determines how the measurement interprets configurations wherethe number of enabled chains differs from the number of streams.
Description SQUARE:The channel matrix has an equal number of channels andstreams. When this mode is selected, configurations where thenumber of enabled chains is larger than the number of streams areinterpreted as multiple independent transmissions. When this modeis selected, the number of enabled chains must be an integralmultiple of the configured number of streams.
NONSQUARE: When this mode is selected, all enabled chains areconsidered part of a single MIMO transmission. In this mode, thenumber of enabled chains does not need to be an integral multiple ofthe configured number of streams.
Description Specifies the disambiguation in number of symbols used in802.11ax signal. This disambiguation is caused due to the packetextension. The property is ignored if you set the Header detectionmode to FIRST or ALL for the PPDU types other than Trigger-Based PPDU.
Description Specifies the Pre-FEC padding factor used in 802.11ax Trigger-Based PPDU, which is used for decoding the PSDU bits. Theproperty is ignored if you set the Header detection mode toFIRST or ALL for the PPDU types other than Trigger-BasedPPDU.
Description Specifies the physical layer convergence procedure (PLCP) frameformat used when PLCP frame detection is disabled. The PLCPframe format determines the sequence of preambles, header, andpayload in a frame.
Description MIXED: The PLCP frame format consists of a legacy preamble andheader followed by a high-throughput (HT) header, preambles, andpayload.GREENFIELD: (Greenfield) The PLCP frame structure does nothave legacy support. It starts with an HT preamble followed by anHT header and payload.
Description SUPPDU: Specifies a single-user (SU) PPDU.MUPPDU: Specifies a multi-user (MU) PPDU.ERSUPPDU: Specifies a Extended Range SU PPDU.TBPPDU: Specifies a trigger-based PPDU.
Description Specifies the size of resource unit (RU) for all users in terms ofthe number of subcarriers for the 802.11ax signal. This size isspecified when you set the PPDU type to multi-user (MU) PPDUor trigger-based PPDU.
Description Similar to OFDM, OFDMA employs multiple subcarriers, but thesubcarriers are divided into several groups of subcarriers where eachgroup is denoted as a resource unit (RU). The 802.11ax standardcalls the smallest subchannel a resouce unit (RU), with a minimumsize of 26 subcarriers. The size of the array depends on the currentdefined number of users.
Description Specifies the location of the resource unit (RU) for all users, interms of the index of 26-tone RU, assuming all the 26-tone RUsover the entire bandwidth of the 802.11ax signal.
Description Specifies the number of SIGB symbols size in the incoming802.11ax MUPPDU signal. The property is ignored if you set theHeader detection mode to FIRST or ALL.
Description Specifies whether space-time block coding (STBC) wasperformed at the transmitter for incoming 802.11ac signals.Whenever STBC is performed, the number of space-time streamsis equal to twice the number of spatial streams.
Description Specifies the difference between the number of space-time streamsand the number of spatial streams, as defined in section 20.3.9.4.3of the IEEE Standard 802.11n-2009.The number of spatial streams is derived from the MCS Indexproperty. Different space-time coding schemes are defined insection 20.3.11.8.1 of the IEEE Standard 802.11n-2009. If theHeader Detection Enabled property is set to False, the instrumentuses the value of the STBC Index property as the differencebetween the number of space-time streams and the number ofspatial streams for performing orthogonal frequency divisionmultiplexing (OFDM) demodulation.
Availability Command/Query
ExecutionMode
Command: OverlappedQuery: Sequential
Parameter: <StbcIndex>
Description The difference between the number of space-time streams and thenumber of spatial streams, as defined in section 20.3.9.4.3 of theIEEE Standard 802.11n-2009.
Description DSSS: Specifies a DSSS signal type (802.11 b/g-DSSS).OFDM: Specifies an OFDM signal type (802.11 a/g/j).HT: Specifies a high throughput signal type (802.11 n).VHT: Specifies a very high throughput signal type (802.11 ac).POFDM: Specifies and OFDM signal type (802.11 p)HE: Specifies a high efficiency signal type (802.11 ax).
Description Fetches the error vector magnitude (EVM) measurement results.For direct sequence spread spectrum (DSSS) demodulation, ifequalization is not enabled and the reference pulse-shaping filtertype and filter coefficients do not match the filter configuration ofthe DUT/generator, EVM degradation could be noticed. Ensure thepulse-shaping type and pulse-shaping coefficient settings match theinput signal settings.If the pulse-shaping filter coefficient is less than 0.2, DSSS EVMmay show degradation.The device broadly follows section 18.4.7.8 of IEEE Standard802.11b-1999 to compute the EVM. The standard calls for EVMcomputation on only the differential quadrature phase-shift keying(DQPSK) signal. However, the instrument computes EVM for allcompulsory and optional data rates and modulation schemesdefined for IEEE Standard 802.11b, as well as the extended ratephysical layer-packet binary convolutional coding (ERP-PBCC)modes defined in IEEE Standard 802.11g.
Availability Query
ExecutionMode
Sequential
Parameter: <AverageRmsEvm>
Description Root mean square (RMS) value of the chip EVM as a percentage ofthe mean amplitude of the signal envelope for 802.11b DSSS signals.
Description Fetches the root mean square (RMS) values of the chip error vectormagnitude (EVM) as a percentage of the mean amplitude of thesignal envelope for 802.11b DSSS signals.For direct sequence spread spectrum (DSSS) demodulation, ifequalization is not enabled and the reference pulse-shaping filtertype and filter coefficients do not match the filter configuration ofthe DUT/generator, EVM degradation could be noticed. Ensure thepulse-shaping type and pulse-shaping coefficient settings match theinput signal settings.If the pulse-shaping filter coefficient is less than 0.2, DSSS EVMmay show degradation.The instrument broadly follows section 18.4.7.8 of IEEE Standard802.11b-1999 to compute the EVM. The standard calls for EVMcomputation on only the differential quadrature phase-shift keying(DQPSK) signal. However, the instrument computes EVM for allcompulsory and optional data rates and modulation schemesdefined for IEEE Standard 802.11b, as well as the extended ratephysical layer-packet binary convolutional coding (ERP-PBCC)modes defined in IEEE Standard 802.11g.
Description pass/fail status of the header cyclic redundancy check (CRC), asdefined in section 18.2.3.6 of IEEE Standard 802.11b-1999.0 : Header checksum failed.1 : Header checksum passed.
Description Fetches the average modulation impairments measurementresults.
Availability Query
Execution Mode Sequential
280 | ni.com | WTS Software User Guide
Parameter: <AvgSampleClockOffset>
Description The estimated Sample clock offset, in parts per million (ppm).The estimated Sample Clock offset is the difference between theSample Clocks at the digital-to-analog converter (DAC) of thetransmitting device under test (DUT) and the digitizer. If the clockoffset is greater than 25 ppm, the estimated value may be inaccurate.Use the estimated offset to verify whether the DUT corresponds tosection 18.4.7.5 of IEEE Standard 802.11b-1999 and section 20.3.21.6of IEEE Standard 802.11n-2009.If the magnitude of the carrier or the Sample Clock frequency offset isgreater than 25 ppm, I/Q gain imbalance magnitude is greater than 3dB, and quadrature skew magnitude is greater than 15 degrees, theestimates of these impairments may be inaccurate.
Datatype Double
Unit PPM
Parameter: <AvgCarrierFrequencyOffset>
Description The average across iterations of carrier frequency offset estimate, ofthe transmitting device under test (DUT).
Datatype Double
Unit PPM
Parameter: <AvgQuadratureSkew>
Description The average of quadrature skew estimates across iterations.Quadrature skew is the deviation in angle from 90 degrees betweenthe in-phase (I) and quadrature-phase (Q) signals.
Description The average of carrier suppression estimates across iterations. Carriersuppression is calculated as the normalized DC offset and notaccording to section 18.4.7.7 of IEEE Standard 802.11b-1999, wherethe definition is valid only for unmodulated continuous wave (CW)signals.
Datatype Double
Unit DB
Parameter: <AvgGainImbalance>
Description Returns the average of I/Q gain imbalance estimates across iterations.I/Q gain imbalance is the ratio of the mean amplitude of the in-phase(I) signal to the mean amplitude of the quadrature-phase (Q) signal.
Description Fetches maximum modulation impairments measurement results.
Availability Query
Execution Mode Sequential
Parameter: <MaxSampleClockOffset>
Description Estimated Sample Clock offset.The estimated Sample Clock offset is the difference between theSample Clocks at the digital-to-analog converter (DAC) of thetransmitting device under test (DUT) and the digitizer. If the clockoffset is greater than 25 ppm, the estimated value may be inaccurate.Use the estimated offset to verify whether the DUT corresponds tosection 18.4.7.5 of IEEE Standard 802.11b-1999 and section 20.3.21.6of IEEE Standard 802.11n-2009.If the magnitude of the carrier or the Sample Clock frequency offset isgreater than 25 ppm, I/Q gain imbalance magnitude is greater than 3dB, and quadrature skew magnitude is greater than 15 degrees, theestimates of these impairments may be inaccurate.
Datatype Double
Unit PPM
Parameter: <MaxCarrierFrequencyOffset>
Description The average across iterations of carrier frequency offset estimates ofthe transmitting device under test (DUT).
Description The average of quadrature skew estimates across iterations.Quadrature skew is the deviation in angle from 90 degrees betweenthe in-phase (I) and quadrature-phase (Q) signals.
Datatype Double
Unit DEG
Parameter: <MaxRmsPhaseNoise>
Unit DEG
Parameter: <MaxCarrierSuppression>
Description The average of carrier suppression estimates across iterations. Carriersuppression is calculated as the normalized DC offset and notaccording to section 18.4.7.7 of IEEE Standard 802.11b-1999, wherethe definition is valid only for unmodulated continuous wave (CW)signals.
Datatype Double
Unit DB
Parameter: <MaxGainImbalance>
Description Returns the average of I/Q gain imbalance estimates across iterations.I/Q gain imbalance is the ratio, in dB, of the mean amplitude of the in-phase (I) signal to the mean amplitude of the quadrature-phase (Q)signal.
Description The estimated Sample clock offset.The estimated Sample Clock offset is the difference between theSample Clocks at the digital-to-analog converter (DAC) of thetransmitting device under test (DUT) and the digitizer. If the clockoffset is greater than 25 ppm, the estimated value may be inaccurate.Use the estimated offset to verify whether the DUT corresponds tosection 18.4.7.5 of IEEE Standard 802.11b-1999 and section 20.3.21.6of IEEE Standard 802.11n-2009.If the magnitude of the carrier or the Sample Clock frequency offset isgreater than 25 ppm, I/Q gain imbalance magnitude is greater than 3dB, and quadrature skew magnitude is greater than 15 degrees, theestimates of these impairments may be inaccurate.
Description The average across iterations of carrier frequency offset estimates ofthe transmitting device under test (DUT).
Datatype Double
Unit PPM
Parameter: <MinQuadratureSkew>
Description The average of quadrature skew estimates across iterations.Quadrature skew is the deviation in angle from 90 degrees betweenthe in-phase (I) and quadrature-phase (Q) signals.
Datatype Double
Unit DEG
Parameter: <MinRmsPhaseNoise>
Unit DEG
Parameter: <MinCarrierSuppression>
Description The average of carrier suppression estimates across iterations. Carriersuppression is calculated as the normalized DC offset and notaccording to section 18.4.7.7 of IEEE Standard 802.11b-1999, wherethe definition is valid only for unmodulated continuous wave (CW)signals.
Datatype Double
Unit DB
286 | ni.com | WTS Software User Guide
Parameter: <MinGainImbalance>
Description Returns the average of I/Q gain imbalance estimates across iterations.I/Q gain imbalance is the ratio, in dB, of the mean amplitude of the in-phase (I) signal to the mean amplitude of the quadrature-phase (Q)signal.
Description Fetches the cross power per stream for a related channel.
Availability Query
Execution Mode Sequential
Parameter: <ChainIndex>
Description For the non-802.11ac 80+80 MIMO case, indicates the chain fromwhich the results originate. For the 802.11ac 80+80 SISO case,indicates the 80 MHz segment from which the results originate.
Description Fetches the cross power per stream for a related channel.
Availability Query
Execution Mode Sequential
Parameter: <ChainIndex>
Description For the non-802.11ac 80+80 MIMO case, indicates the chain fromwhich the results originate. For the 802.11ac 80+80 SISO case,indicates the 80 MHz segment from which the results originate.
Datatype Integer32
288 | ni.com | WTS Software User Guide
Parameter: <StreamIndex>
Description The index of the stream from which the result originates.
Datatype Integer32
Parameter: <StreamCrossPow>
Description Result of cross power of the stream on the current channel.
Description Fetches the cross power per stream for a related channel.
Availability Query
Execution Mode Sequential
Parameter: <ChainIndex>
Description For the non-802.11ac 80+80 MIMO case, indicates the chain fromwhich the results originate. For the 802.11ac 80+80 SISO case,indicates the 80 MHz segment from which the results originate.s
Description Fetches the total cross power per channel.
Availability Query
Execution Mode Sequential
Parameter: <ChannelIndex>
Description For the non-802.11ac 80+80 MIMO case, indicates the channel fromwhich the results originate. For the 802.11ac 80+80 SISO case,indicates the 80 MHz segment from which the results originate.ss
Datatype Integer32
290 | ni.com | WTS Software User Guide
Parameter: <ChanCrossPow>
Description Result of total power across all streams with index different fromchannel index.
Description Fetches the total cross power per channel.
Availability Query
Execution Mode Sequential
Parameter: <ChannelIndex>
Description For the non-802.11ac 80+80 MIMO case, indicates the channel fromwhich the results originate. For the 802.11ac 80+80 SISO case,indicates the 80 MHz segment from which the results originate.
Datatype Integer32
Parameter: <ChanCrossPow>
Description Result of total power across all streams with index different fromchannel index.
Description Fetches the total cross power per channel.
Availability Query
Execution Mode Sequential
Parameter: <ChannelIndex>
Description For the non-802.11ac 80+80 MIMO case, indicates the channel fromwhich the results originate. For the 802.11ac 80+80 SISO case,indicates the 80 MHz segment from which the results originate.s
Datatype Integer32
Parameter: <ChanCrossPow>
Description Result of total power across all streams with index different fromchannel index.
Description Fetches the average error vector magnitude (EVM) root meansquare (RMS) results per stream.Acceptable RMS EVM limits are defined in section 17.3.9.6.3 ofIEEE Standard 802.11a-1999 and section 20.3.21.7.4 of IEEEStandard 802.11n-2009. The method of computation is discussedin section 17.3.9.7 of IEEE Standard 802.11a-1999 and section20.3.21.7.4 of IEEE Standard 802.11n-2009.
Availability Query
Execution Mode Sequential
Parameter: <StreamIndex>
Description For the non-802.11ac 80+80 MIMO case, indicates the stream fromwhich the results originate. For the 802.11ac 80+80 SISO case,indicates the 80 MHz segment from which the results originate.
Datatype Integer32
Parameter: <RmsStreamEvm>
Description Result across iterations of RMS EVM measurements per stream.
Description Fetches the maximum error vector magnitude (EVM) results perstream.Acceptable root mean square (RMS) EVM limits are defined insection 17.3.9.6.3 of IEEE Standard 802.11a-1999 and section20.3.21.7.4 of IEEE Standard 802.11n-2009. The method ofcomputation is discussed in section 17.3.9.7 of IEEE Standard802.11a-1999 and section 20.3.21.7.4 of IEEE Standard802.11n-2009.
Availability Query
Execution Mode Sequential
Parameter: <StreamIndex>
Description For the non-802.11ac 80+80 MIMO case, indicates the stream fromwhich the results originate. For the 802.11ac 80+80 SISO case,indicates the 80 MHz segment from which the results originate.
Datatype Integer32
Parameter: <RmsStreamEvm>
Description Result across iterations of RMS EVM measurements per stream.
Datatype Double
Unit dB
Parameter: <RmsStreamPilotEvm>
Description Result across iterations of RMS EVM measurements of pilotsubcarriers per stream.
Description Fetches the minimum error vector magnitude (EVM) results perstream.Acceptable root mean square (RMS) EVM limits are defined insection 17.3.9.6.3 of IEEE Standard 802.11a-1999 and section20.3.21.7.4 of IEEE Standard 802.11n-2009. The method ofcomputation is discussed in section 17.3.9.7 of IEEE Standard802.11a-1999 and section 20.3.21.7.4 of IEEE Standard802.11n-2009.
Availability Query
Execution Mode Sequential
296 | ni.com | WTS Software User Guide
Parameter: <StreamIndex>
Description For the non-802.11ac 80+80 MIMO case, indicates the stream fromwhich the results originate. For the 802.11ac 80+80 SISO case,indicates the 80 MHz segment from which the results originate.
Datatype Integer32
Parameter: <RmsStreamEvm>
Description Result across iterations of RMS EVM measurements per stream.
Datatype Double
Unit dB
Parameter: <RmsStreamPilotEvm>
Description Result across iterations of RMS EVM measurements of pilotsubcarriers per stream.
Datatype Double
Unit dB
Parameter: <RmsStreamDataEvm>
Description Result across iterations of RMS EVM measurements of datasubcarriers per stream.
Description Fetches the average error vector magnitude (EVM) results perchannel.Acceptable root mean square (RMS) EVM limits are defined insection 17.3.9.6.3 of IEEE Standard 802.11a-1999 and section20.3.21.7.4 of IEEE Standard 802.11n-2009. The method ofcomputation is discussed in section 17.3.9.7 of IEEE Standard802.11a-1999 and section 20.3.21.7.4 of IEEE Standard802.11n-2009.
Availability Query
Execution Mode Sequential
Parameter: <ChannelIndex>
Description For the non-802.11ac 80+80 MIMO case, indicates the channel fromwhich the results originate. For the 802.11ac 80+80 SISO case,indicates the 80 MHz segment from which the results originate.
Datatype Integer32
Parameter: <RmsEvm>
Description Result across iterations of RMS EVM measurements.
Datatype Double
Unit dB
298 | ni.com | WTS Software User Guide
Parameter: <RmsPilotEvm>
Description Result across iterations of RMS EVM measurements of pilotsubcarriers.
Datatype Double
Unit dB
Parameter: <RmsDataEvm>
Description Result across iterations of RMS EVM measurements of datasubcarriers.
Description Fetches the maximum error vector magnitude (EVM) results perchannel.Acceptable root mean square (RMS) EVM limits are defined insection 17.3.9.6.3 of IEEE Standard 802.11a-1999 and section20.3.21.7.4 of IEEE Standard 802.11n-2009. The method ofcomputation is discussed in section 17.3.9.7 of IEEE Standard802.11a-1999 and section 20.3.21.7.4 of IEEE Standard802.11n-2009.
Availability Query
Execution Mode Sequential
Parameter: <ChannelIndex>
Description For the non-802.11ac 80+80 MIMO case, indicates the channel fromwhich the results originate. For the 802.11ac 80+80 SISO case,indicates the 80 MHz segment from which the results originate.
Datatype Integer32
Parameter: <RmsEvm>
Description Result across iterations of RMS EVM measurements.
Datatype Double
Unit dB
Parameter: <RmsPilotEvm>
Description Result across iterations of RMS EVM measurements of pilotsubcarriers.
Datatype Double
Unit dB
300 | ni.com | WTS Software User Guide
Parameter: <RmsDataEvm>
Description Result across iterations of RMS EVM measurements of datasubcarriers.
Description Fetches the minimum error vector magnitude (EVM) results perchannel.Acceptable root mean square (RMS) EVM limits are defined insection 17.3.9.6.3 of IEEE Standard 802.11a-1999 and section20.3.21.7.4 of IEEE Standard 802.11n-2009. The method ofcomputation is discussed in section 17.3.9.7 of IEEE Standard802.11a-1999 and section 20.3.21.7.4 of IEEE Standard802.11n-2009.
Description For the non-802.11ac 80+80 MIMO case, indicates the channel fromwhich the results originate. For the 802.11ac 80+80 SISO case,indicates the 80 MHz segment from which the results originate.
Datatype Integer32
Parameter: <RmsEvm>
Description Result across iterations of RMS EVM measurements
Datatype Double
Unit dB
Parameter: <RmsPilotEvm>
Description Result across iterations of RMS EVM measurements of pilotsubcarriers.
Datatype Double
Unit dB
Parameter: <RmsDataEvm>
Description Result across iterations of RMS EVM measurements of datasubcarriers.
Description Fetches the constellation trace corresponding to demodulated I/Qdata
Availability Query
Execution Mode Sequential
Parameter: <ChainIndex>
Description For the non-802.11ac 80+80 MIMO case, indicates the chain fromwhich the results originate. For the 802.11ac 80+80 SISO case,indicates the 80 MHz segment from which the results originate.
Description Fetches the channel frequency response Magnitude trace data set.
Availability Query
Execution Mode Sequential
Parameter: <ChannelIndex>
Description For the non-802.11ac 80+80 MIMO case, indicates the channel fromwhich the results originate. For the 802.11ac 80+80 SISO case,indicates the 80 MHz segment from which the results originate.
Description Fetches the channel frequency response phase trace data set.
Availability Query
Execution Mode Sequential
Parameter: <ChannelIndex>
Description For the non-802.11ac 80+80 MIMO case, indicates the channel fromwhich the results originate. For the 802.11ac 80+80 SISO case,indicates the 80 MHz segment from which the results originate.
Description Fetches the trace data set corresponding to deviation from linearphase of the channel frequency response.
Availability Query
Execution Mode Sequential
Parameter: <ChannelIndex>
Description For the non-802.11ac 80+80 MIMO case, indicates the channel fromwhich the results originate. For the 802.11ac 80+80 SISO case,indicates the 80 MHz segment from which the results originate.
Description For the non-802.11ac 80+80 MIMO case, indicates the channel fromwhich the results originate. For the 802.11ac 80+80 SISO case,indicates the 80 MHz segment from which the results originate.
Description Fetches the maximum error vector magnitude (EVM) results perstream.Acceptable root mean square (RMS) EVM limits are defined insection 17.3.9.6.3 of IEEE Standard 802.11a-1999 and section20.3.21.7.4 of IEEE Standard 802.11n-2009. The method ofcomputation is discussed in section 17.3.9.7 of IEEE Standard802.11a-1999 and section 20.3.21.7.4 of IEEE Standard802.11n-2009.
Availability Query
Execution Mode Sequential
Parameter: <StreamIndex>
Description For the non-802.11ac 80+80 MIMO case, indicates the stream fromwhich the results originate. For the 802.11ac 80+80 SISO case,indicates the 80 MHz segment from which the results originate.
Datatype Integer32
Parameter: <RmsStreamEvm>
Description Result across iterations of RMS EVM measurements per stream.
Datatype Double
Unit dB
Parameter: <RmsStreamPilotEvm>
Description Result across iterations of RMS EVM measurements of pilotsubcarriers per stream.
Description Fetches the maximum error vector magnitude (EVM) results perstream.Acceptable root mean square (RMS) EVM limits are defined insection 17.3.9.6.3 of IEEE Standard 802.11a-1999 and section20.3.21.7.4 of IEEE Standard 802.11n-2009. The method ofcomputation is discussed in section 17.3.9.7 of IEEE Standard802.11a-1999 and section 20.3.21.7.4 of IEEE Standard802.11n-2009.
Availability Query
Execution Mode Sequential
310 | ni.com | WTS Software User Guide
Parameter: <StreamIndex>
Description For the non-802.11ac 80+80 MIMO case, indicates the stream fromwhich the results originate. For the 802.11ac 80+80 SISO case,indicates the 80 MHz segment from which the results originate.
Datatype Integer32
Parameter: <RmsStreamEvm>
Description Result across iterations of RMS EVM measurements per stream.
Datatype Double
Unit dB
Parameter: <RmsStreamPilotEvm>
Description Result across iterations of RMS EVM measurements of pilotsubcarriers per stream.
Datatype Double
Unit dB
Parameter: <RmsStreamDataEvm>
Description Result across iterations of RMS EVM measurements of datasubcarriers per stream.
Description Fetches the maximum error vector magnitude (EVM) results perstream.Acceptable root mean square (RMS) EVM limits are defined insection 17.3.9.6.3 of IEEE Standard 802.11a-1999 and section20.3.21.7.4 of IEEE Standard 802.11n-2009. The method ofcomputation is discussed in section 17.3.9.7 of IEEE Standard802.11a-1999 and section 20.3.21.7.4 of IEEE Standard802.11n-2009.
Availability Query
Execution Mode Sequential
Parameter: <StreamIndex>
Description For the non-802.11ac 80+80 MIMO case, indicates the stream fromwhich the results originate. For the 802.11ac 80+80 SISO case,indicates the 80 MHz segment from which the results originate.
Datatype Integer32
Parameter: <RmsStreamEvm>
Description Result across iterations of RMS EVM measurements per stream.
Datatype Double
Unit dB
312 | ni.com | WTS Software User Guide
Parameter: <RmsStreamPilotEvm>
Description Result across iterations of RMS EVM measurements of pilotsubcarriers per stream.
Datatype Double
Unit dB
Parameter: <RmsStreamDataEvm>
Description Result across iterations of RMS EVM measurements of datasubcarriers per stream.
Description For the non 80+80 MIMO case, indicates the channel from which theresults originate. For the 80+80 SISO case, indicates the 80 MHzsegment from which the results originate.
Description Fetches the maximum unused Tone Error results per channel.
Availability Query
Execution Mode Sequential
314 | ni.com | WTS Software User Guide
Parameter: <ChannelIndex>
Description For the non 80+80 MIMO case, indicates the channel from which theresults originate. For the 80+80 SISO case, indicates the 80 MHzsegment from which the results originate.
Description For the non 80+80 MIMO case, indicates the channel from which theresults originate. For the 80+80 SISO case, indicates the 80 MHzsegment from which the results originate.
Description Fetches the average unused tone margin results per channel.
Availability Query
Execution Mode Sequential
316 | ni.com | WTS Software User Guide
Parameter: <ChannelIndex>
Description For the non 80+80 MIMO case, indicates the channel from which theresults originate. For the 80+80 SISO case, indicates the 80 MHzsegment from which the results originate.
Description For the non 80+80 MIMO case, indicates the channel from which theresults originate. For the 80+80 SISO case, indicates the 80 MHzsegment from which the results originate.
Description Fetches the minimum unused tone margin results per channel.
Availability Query
Execution Mode Sequential
318 | ni.com | WTS Software User Guide
Parameter: <ChannelIndex>
Description For the non 80+80 MIMO case, indicates the channel from which theresults originate. For the 80+80 SISO case, indicates the 80 MHzsegment from which the results originate.
Description For the non-802.11ac 80+80 MIMO case, indicates the channel fromwhich the results originate. For the 802.11ac 80+80 SISO case,indicates the 80 MHz segment from which the results originate.
Datatype Integer32
Parameter: <LLtfPower>
Description Result across iterations of power measured in the legacy long trainingfield.
Datatype Double
Unit dBm
Parameter: <PayloadPower>
Description Result across iterations of power measured in the packet payload.
Description Fetches the gated power results per channel.
Availability Query
Execution Mode Sequential
Parameter: <ChannelIndex>
Description For the non-802.11ac 80+80 MIMO case, indicates the channel fromwhich the results originate. For the 802.11ac 80+80 SISO case,indicates the 80 MHz segment from which the results originate.
Datatype Integer32
Parameter: <LLtfPower>
Description Result across iterations of power measured in the legacy long trainingfield.
Datatype Double
Unit dBm
Parameter: <PayloadPower>
Description Result across iterations of power measured in the packet payload.
Description Fetches the gated power results per channel.
Availability Query
Execution Mode Sequential
Parameter: <ChannelIndex>
Description For the non-802.11ac 80+80 MIMO case, indicates the channel fromwhich the results originate. For the 802.11ac 80+80 SISO case,indicates the 80 MHz segment from which the results originate.
Datatype Integer32
Parameter: <LLtfPower>
Description Result across iterations of power measured in the legacy long trainingfield.
Datatype Double
Unit dBm
Parameter: <PayloadPower>
Description Result across iterations of power measured in the packet payload.
Description Fetches detected header parameters for 802.11 a/g signalorthogonal frequency division multiplexing (OFDM).
Availability Query
Execution Mode Sequential
Parameter: <DataRate>
Description The data rate, in MBps, used to transmit the SERVICE field and thephysical layer convergence procedure protocol data unit (PPDU). Ifyou enable automatic header detection, the data rate is extracted fromthe demodulated SIGNAL field of the frame. The SIGNAL field isdefined in section 17.3.4 of IEEE Standard 802.11-2007.
Datatype Integer32
324 | ni.com | WTS Software User Guide
Parameter: <PayloadLength>
Description The length of the physical-layer payload, in bytes. If you enableautomatic header detection, the instrument extracts the payload lengthfrom the demodulated SIGNAL field of the frame. The SIGNAL fieldis defined in section 17.3.4 of IEEE Standard 802.11a-1999.
Datatype Integer32
Parameter: <LSigLength>
Description The value of the length field as decoded from the L-SIG field.
Datatype Integer32
Parameter: <LsigHeaderParityPassed>
Description Indicates whether the parity check has passed for the signal field of theOFDM waveforms conforming to the IEEE Standard 802.11-2007
Description The length of the physical-layer payload, in bytes. If you enableautomatic header detection, the instrument extracts the payload lengthfrom the demodulated SIGNAL field of the frame. The SIGNAL fieldis defined in section 17.3.4 of IEEE Standard 802.11a-1999.
Datatype Integer32
Parameter: <LSigLength>
Description The value of the length field as decoded from the L-SIG field in802.11ax signals.
Datatype Integer32
326 | ni.com | WTS Software User Guide
Parameter: <LsigHeaderParityPassed>
Description Indicates whether the parity check has passed for the SIGNAL field ofthe orthogonal frequency division multiplexing (OFDM) waveformsconforming to the IEEE standard 802.11-2007 or the non-HTSIGNAL (L-SIG) field of the MIMO OFDM waveforms conformingto the IEEE Standard 802.11n-2009 or the non-VHT SIGNAL (L-SIG)field of the MIMO OFDM waveforms conforming to the IEEEStandard 802.11ac-2013.
Datatype Boolean
Parameter: <FecCodingType>
Description The type of forward error correction (FEC) coding detected from thevery high-throughput SIGNAL (VHT-SIG-A field), for 802.11axsignals.
Datatype Enumeration
Parameter: <StbcIndex>
Description The detected value of the space-time block coding (STBC) field.
Datatype Integer32
Parameter: <GuardInterval>
Description The guard interval, in seconds, detected from the very high-throughputSIGNAL (VHT-SIG-A field), for 802.11ax signals.
Description The number of space-time streams for 802.11ax signal. This value isderived by adding 1 to the value of NSTS field, as decoded from theVHT-SIG-A field.
Datatype Integer32
Parameter: <LdpcExtraSymbol>
Description Detected value of the LDPC extra bit field.
Description Detected the type of physical layer convergence procedure (PLCP)protocol data unit (PPDU).SUPPDU: Single user (SU) PPDU.MUPPDU: Multi-user (MU) PPDU.ERSUPPDU: Extended Range SU PPDU.TBPPDU: Trigger-based PPDU.
Description The length of the physical-layer payload, in bytes. If you enableautomatic header detection, the device extracts the payload lengthfrom the demodulated SIGNAL field of the frame. The SIGNAL fieldis defined in section 17.3.4 of IEEE Standard 802.11a-1999.
Datatype Integer32
Parameter: <LSigLength>
Description The value of the length field as decoded from the L-SIG field.
Datatype Integer32
Parameter: <LsigHeaderParityPassed>
Description Indicates whether the parity check has passed for the signal field of theorthogonal frequency division multiplexing (OFDM) waveformsconforming to the IEEE Standard 802.11-2007 of the MIMO OFDMwaveforms conforming to the IEEE Standard 802.11n-2009.
Description Type of forward error correction (FEC) coding detected from the high-throughput SIGNAL (HT-SIG) field, for 802.11n signals, as defined insection 20.3.9.4.3 of the IEEE Standard 802.11n-2009.
Datatype Enumeration
332 | ni.com | WTS Software User Guide
Parameter: <GuardInterval>
Description The guard interval, in seconds, detected from the high-throughputSIGNAL (HT-SIG) field, for 802.11n signals, as defined in section20.3.9.4.3 of the IEEE Standard 802.11n-2009
Datatype Integer32
Parameter: <StbcIndex>
Description The value of space-time block coding (STBC) field detected from thehigh-throughput SIGNAL (HT-SIG) field, of 802.11n signal, asdefined in section 20.3.9.4.3 of the IEEE Standard 802.11n-2009.
Datatype Integer32
Parameter: <HtSigCrcPassed>
Description Indicates whether the CRC has passed for the high-throughputSIGNAL (HT-SIG) field as defined in section 20.3.9.4.3 of the IEEEStandard 802.11n-2009.
Datatype Boolean
Parameter: <NESS>
Description The number of extension spatial streams detected from the high-throughput SIGNAL (HT-SIG) field as defined in section 20.3.9.4.3 ofthe IEEE Standard 802.11n-2009.
Datatype Integer32
Parameter: <AggregationBit>
Description The value of the aggregation field as decoded from the high-throughput signal (HT-SIG) field of 802.11n signal.
Description Fetches detected header parameters 802.11 ac (VHT)
Availability Query
Execution Mode Sequential
Parameter: <McsRate>
Description The detected MCS index.
Datatype Integer32
Parameter: <PayloadLength>
Description The length of the physical-layer payload, in bytes. If you enableautomatic header detection, the instrument extracts the payload lengthfrom the demodulated SIGNAL field of the frame. The SIGNAL fieldis defined in section 17.3.4 of IEEE Standard 802.11a-1999.
Datatype Integer32
Parameter: <LSigLength>
Description The value of the length field as decoded from the L-SIG field in802.11ac signals.
Datatype Integer32
334 | ni.com | WTS Software User Guide
Parameter: <LsigHeaderParityPassed>
Description Indicates whether the parity check has passed for the SIGNAL field ofthe orthogonal frequency division multiplexing (OFDM) waveformsconforming to the IEEE standard 802.11-2007 or the non-HTSIGNAL (L-SIG) field of the MIMO OFDM waveforms conformingto the IEEE Standard 802.11n-2009 or the non-VHT SIGNAL (L-SIG)field of the MIMO OFDM waveforms conforming to the IEEEStandard 802.11ac-2013.
Datatype Boolean
Parameter: <FecCodingType>
Description The type of forward error correction (FEC) coding detected from thevery high-throughput SIGNAL (VHT-SIG-A field), for 802.11acsignals.
Datatype Enumeration
Parameter: <StbcIndex>
Description The detected value of the space-time block coding (STBC) field.
Datatype Integer32
Parameter: <GuardInterval>
Description The guard interval, in seconds, detected from the very high-throughputSIGNAL (VHT-SIG-A field), for 802.11ac signals.
Description The number of space-time streams for 802.11ac signal. This value isderived by adding 1 to the value of NSTS field, as decoded from theVHT-SIG-A field.
Datatype Integer32
Parameter: <LdpcExtraSymbol>
Description Detected value of the LDPC extra bit field.
Description Fetches average measured impairments.If the magnitude of the carrier or the Sample Clock frequency offsetis greater than 25 ppm, I/Q gain imbalance magnitude is greater than3 dB, and quadrature skew magnitude is greater than 15 degrees, theestimates of these impairments may be inaccurate.Note: In case of 802.11ac 80+80, refer to''FETCh:RFSA:WLAN<i>[:RESults<i>]:MODulation:OFDM:IMPairments:SEGMent<i>[:AVERage]'', to fetch the impairmentresults for each segment.
Availability Query
ExecutionMode
Sequential
Parameter: <SampleClockOffset>
Description The result across iterations of Sample Clock offset estimates. TheSample Clock offset is the difference between the Sample Clocks atthe digital-to-analog converter (DAC) of the transmitting DUT and thedigitizer.If the clock offset value is greater than 25 ppm, the estimated valuemay be inaccurate. The clock offset measurement follows section17.3.9.5 of IEEE Standard 802.11a-1999 and section 20.3.21.6 ofIEEE Standard 802.11n-2009.
Datatype Double
Unit PPM
Parameter: <CarrierFrequencyOffset>
Description The result across iterations of carrier frequency offset estimates of thetransmitting device under test (DUT). This measurement followssection 17.3.9.4 of IEEE Standard 802.11a-1999 and section 20.3.21.4of IEEE Standard 802.11n-2009.
Description The result across iterations of common pilot error root mean square(RMS) measurements, as a percentage of ideal pilot subcarrier values.
Datatype Double
Unit PCT
Parameter: <RmsPhaseNoise>
Description The result across iterations of phase noise.
Datatype Double
Unit deg
Parameter: <ChannelIndex>
Description The index of the channel from which the result originates.
Datatype Integer32
Unit DB
Parameter: <ChannelIqImbalance>
Description The result across iterations of I/Q gain imbalance estimates. I/Q gainimbalance is the ratio, in dB, of the mean amplitude of the in-phase (I)signal to the mean amplitude of the quadrature-phase (Q) signal.
338 | ni.com | WTS Software User Guide
Datatype Double
Unit DB
Parameter: <ChannelQuadratureSkew>
Description The result across iterations of quadrature skew estimates. Quadratureskew is the deviation in angle from 90 degrees between the in-phase(I) and quadrature-phase (Q) signals.
Datatype Double
Unit DEG
Parameter: <ChannelCarrierFreqLeakage>
Description The result of carrier frequency leakage. Carrier frequency leakage isthe ratio, in dB, of the energy in the DC subcarrier to the total energyof all the subcarriers.
Datatype Double
Unit DB
Parameter: <ChannelTimingSkew>
Description The result across iterations of timing skew estimates. Timing skew isthe difference between the sampling instants of in-phase (I) andquadrature (Q) components of the complex baseband signal.
Description Fetches maximum measured impairments.If the magnitude of the carrier or the Sample Clock frequency offsetis greater than 25 ppm, I/Q gain imbalance magnitude is greater than3 dB, and quadrature skew magnitude is greater than 15 degrees, theestimates of these impairments may be inaccurate.Note: In case of 802.11ac 80+80, refer to''FETCh:RFSA:WLAN<i>[:RESults<i>]:MODulation:OFDM:IMPairments:SEGMent<i>[:MAXimum]'', to fetch the impairmentresults for each segment.
Availability Query
ExecutionMode
Sequential
Parameter: <SampleClockOffset>
Description The result across iterations of Sample Clock offset estimates. TheSample Clock offset is the difference between the Sample Clocks atthe digital-to-analog converter (DAC) of the transmitting DUT and thedigitizer.If the clock offset value is greater than 25 ppm, the estimated valuemay be inaccurate. The clock offset measurement follows section17.3.9.5 of IEEE Standard 802.11a-1999 and section 20.3.21.6 ofIEEE Standard 802.11n-2009.
Datatype Double
Unit PPM
340 | ni.com | WTS Software User Guide
Parameter: <CarrierFrequencyOffset>
Description The result across iterations of carrier frequency offset estimates of thetransmitting device under test (DUT). This measurement followssection 17.3.9.4 of IEEE Standard 802.11a-1999 and section 20.3.21.4of IEEE Standard 802.11n-2009.
Datatype Double
Unit PPM
Parameter: <AvgRmsComPilotErr>
Description The result across iterations of common pilot error root mean square(RMS) measurements, as a percentage of ideal pilot subcarrier values.
Datatype Double
Unit PCT
Parameter: <RmsPhaseNoise>
Description The result across iterations of phase noise.
Datatype Double
Unit deg
Parameter: <ChannelIndex>
Description The index of the channel from which the result originates.
Description The result across iterations of I/Q gain imbalance estimates. I/Q gainimbalance is the ratio, in dB, of the mean amplitude of the in-phase (I)signal to the mean amplitude of the quadrature-phase (Q) signal.
Datatype Double
Unit DB
Parameter: <ChannelQuadratureSkew>
Description The result across iterations of quadrature skew estimates. Quadratureskew is the deviation in angle from 90 degrees between the in-phase(I) and quadrature-phase (Q) signals.
Datatype Double
Unit DEG
Parameter: <ChannelCarrierFreqLeakage>
Description The result of carrier frequency leakage. Carrier frequency leakage isthe ratio, in dB, of the energy in the DC subcarrier to the total energyof all the subcarriers.
Datatype Double
Unit DB
Parameter: <ChannelTimingSkew>
Description The result across iterations of timing skew estimates. Timing skew isthe difference between the sampling instants of in-phase (I) andquadrature (Q) components of the complex baseband signal.
Description Fetches minimum measured impairments.If the magnitude of the carrier or the Sample Clock frequency offsetis greater than 25 ppm, I/Q gain imbalance magnitude is greater than3 dB, and quadrature skew magnitude is greater than 15 degrees, theestimates of these impairments may be inaccurate.Note: In case of 802.11ac 80+80, refer to''FETCh:RFSA:WLAN<i>[:RESults<i>]:MODulation:OFDM:IMPairments:SEGMent<i>[:MINimum]'', to fetch theimpairment results for each segment.
Description The result across iterations of Sample Clock offset estimates. TheSample Clock offset is the difference between the Sample Clocks atthe digital-to-analog converter (DAC) of the transmitting DUT and thedigitizer.If the clock offset value is greater than 25 ppm, the estimated valuemay be inaccurate. The clock offset measurement follows section17.3.9.5 of IEEE Standard 802.11a-1999 and section 20.3.21.6 ofIEEE Standard 802.11n-2009.
Datatype Double
Unit PPM
Parameter: <CarrierFrequencyOffset>
Description The result across iterations of carrier frequency offset estimates of thetransmitting device under test (DUT). This measurement followssection 17.3.9.4 of IEEE Standard 802.11a-1999 and section 20.3.21.4of IEEE Standard 802.11n-2009.
Datatype Double
Unit PPM
Parameter: <AvgRmsComPilotErr>
Description The result across iterations of common pilot error root mean square(RMS) measurements, as a percentage of ideal pilot subcarrier values.
Datatype Double
Unit PCT
Parameter: <RmsPhaseNoise>
Description The result across iterations of phase noise.
344 | ni.com | WTS Software User Guide
Datatype Double
Unit deg
Parameter: <ChannelIndex>
Description The index of the channel from which the result originates.
Datatype Integer32
Parameter: <ChannelIqImbalance>
Description The result across iterations of I/Q gain imbalance estimates. I/Q gainimbalance is the ratio, in dB, of the mean amplitude of the in-phase (I)signal to the mean amplitude of the quadrature-phase (Q) signal.
Datatype Double
Unit DB
Parameter: <ChannelQuadratureSkew>
Description The result across iterations of quadrature skew estimates. Quadratureskew is the deviation in angle from 90 degrees between the in-phase(I) and quadrature-phase (Q) signals.
Datatype Double
Unit DEG
Parameter: <ChannelCarrierFreqLeakage>
Description The result of carrier frequency leakage. Carrier frequency leakage isthe ratio, in dB, of the energy in the DC subcarrier to the total energyof all the subcarriers.
Description The result across iterations of timing skew estimates. Timing skew isthe difference between the sampling instants of in-phase (I) andquadrature (Q) components of the complex baseband signal.
Description Fetches average measured impairments for each segment in case802.11ac 80+80.If the magnitude of the carrier or the Sample Clock frequencyoffset is greater than 25 ppm, I/Q gain imbalance magnitude isgreater than 3 dB, and quadrature skew magnitude is greater than15 degrees, the estimates of these impairments may be inaccurate.
Availability Query
Execution Mode Sequential
346 | ni.com | WTS Software User Guide
Parameter: <SampleClockOffset>
Description The result across iterations of Sample Clock offset estimates. TheSample Clock offset is the difference between the Sample Clocks atthe digital-to-analog converter (DAC) of the transmitting DUT and thedigitizer.If the clock offset value is greater than 25 ppm, the estimated valuemay be inaccurate. The clock offset measurement follows section17.3.9.5 of IEEE Standard 802.11a-1999 and section 20.3.21.6 ofIEEE Standard 802.11n-2009.
Datatype Double
Unit PPM
Parameter: <CarrierFrequencyOffset>
Description The result across iterations of carrier frequency offset estimates of thetransmitting device under test (DUT). This measurement followssection 17.3.9.4 of IEEE Standard 802.11a-1999 and section 20.3.21.4of IEEE Standard 802.11n-2009.
Datatype Double
Unit PPM
Parameter: <AvgRmsComPilotErr>
Description The result across iterations of common pilot error root mean square(RMS) measurements, as a percentage of ideal pilot subcarrier values.
Datatype Double
Unit PCT
Parameter: <RmsPhaseNoise>
Description The result across iterations of phase noise.
Description The index of the channel from which the result originates.
Datatype Integer32
Parameter: <ChannelIqImbalance>
Description The result across iterations of I/Q gain imbalance estimates. I/Q gainimbalance is the ratio, in dB, of the mean amplitude of the in-phase (I)signal to the mean amplitude of the quadrature-phase (Q) signal.
Datatype Double
Unit DB
Parameter: <ChannelQuadratureSkew>
Description The result across iterations of quadrature skew estimates. Quadratureskew is the deviation in angle from 90 degrees between the in-phase(I) and quadrature-phase (Q) signals.
Datatype Double
Unit DEG
Parameter: <ChannelCarrierFreqLeakage>
Description The result of carrier frequency leakage. Carrier frequency leakage isthe ratio, in dB, of the energy in the DC subcarrier to the total energyof all the subcarriers.
348 | ni.com | WTS Software User Guide
Datatype Double
Unit DB
Parameter: <ChannelTimingSkew>
Description The result across iterations of timing skew estimates. Timing skew isthe difference between the sampling instants of in-phase (I) andquadrature (Q) components of the complex baseband signal.
Description Fetches maximum measured impairments for each segment incase 802.11ac 80+80.If the magnitude of the carrier or the Sample Clock frequencyoffset is greater than 25 ppm, I/Q gain imbalance magnitude isgreater than 3 dB, and quadrature skew magnitude is greater than15 degrees, the estimates of these impairments may be inaccurate.
Description The result across iterations of Sample Clock offset estimates. TheSample Clock offset is the difference between the Sample Clocks atthe digital-to-analog converter (DAC) of the transmitting DUT and thedigitizer.If the clock offset value is greater than 25 ppm, the estimated valuemay be inaccurate. The clock offset measurement follows section17.3.9.5 of IEEE Standard 802.11a-1999 and section 20.3.21.6 ofIEEE Standard 802.11n-2009.
Datatype Double
Unit PPM
Parameter: <CarrierFrequencyOffset>
Description The result across iterations of carrier frequency offset estimates of thetransmitting device under test (DUT). This measurement followssection 17.3.9.4 of IEEE Standard 802.11a-1999 and section 20.3.21.4of IEEE Standard 802.11n-2009.
Datatype Double
Unit PPM
Parameter: <AvgRmsComPilotErr>
Description The result across iterations of common pilot error root mean square(RMS) measurements, as a percentage of ideal pilot subcarrier values.
Datatype Double
Unit PCT
Parameter: <RmsPhaseNoise>
Description The result across iterations of phase noise.
350 | ni.com | WTS Software User Guide
Datatype Double
Unit deg
Parameter: <ChannelIndex>
Description The index of the channel from which the result originates.
Datatype Integer32
Parameter: <ChannelIqImbalance>
Description The result across iterations of I/Q gain imbalance estimates. I/Q gainimbalance is the ratio, in dB, of the mean amplitude of the in-phase (I)signal to the mean amplitude of the quadrature-phase (Q) signal.
Datatype Double
Unit DB
Parameter: <ChannelQuadratureSkew>
Description The result across iterations of quadrature skew estimates. Quadratureskew is the deviation in angle from 90 degrees between the in-phase(I) and quadrature-phase (Q) signals.
Datatype Double
Unit DEG
Parameter: <ChannelCarrierFreqLeakage>
Description The result of carrier frequency leakage. Carrier frequency leakage isthe ratio, in dB, of the energy in the DC subcarrier to the total energyof all the subcarriers.
Description The result across iterations of timing skew estimates. Timing skew isthe difference between the sampling instants of in-phase (I) andquadrature (Q) components of the complex baseband signal.
Description Fetches minimum measured impairments for each segment incase 802.11ac 80+80.If the magnitude of the carrier or the Sample Clock frequencyoffset is greater than 25 ppm, I/Q gain imbalance magnitude isgreater than 3 dB, and quadrature skew magnitude is greater than15 degrees, the estimates of these impairments may be inaccurate.
Availability Query
Execution Mode Sequential
352 | ni.com | WTS Software User Guide
Parameter: <SampleClockOffset>
Description The result across iterations of Sample Clock offset estimates. TheSample Clock offset is the difference between the Sample Clocks atthe digital-to-analog converter (DAC) of the transmitting DUT and thedigitizer.If the clock offset value is greater than 25 ppm, the estimated valuemay be inaccurate. The clock offset measurement follows section17.3.9.5 of IEEE Standard 802.11a-1999 and section 20.3.21.6 ofIEEE Standard 802.11n-2009.
Datatype Double
Unit PPM
Parameter: <CarrierFrequencyOffset>
Description The result across iterations of carrier frequency offset estimates of thetransmitting device under test (DUT). This measurement followssection 17.3.9.4 of IEEE Standard 802.11a-1999 and section 20.3.21.4of IEEE Standard 802.11n-2009.
Datatype Double
Unit PPM
Parameter: <AvgRmsComPilotErr>
Description The result across iterations of common pilot error root mean square(RMS) measurements, as a percentage of ideal pilot subcarrier values.
Datatype Double
Unit PCT
Parameter: <RmsPhaseNoise>
Description The result across iterations of phase noise.
Description The index of the channel from which the result originates.
Datatype Integer32
Parameter: <ChannelIqImbalance>
Description The result across iterations of I/Q gain imbalance estimates. I/Q gainimbalance is the ratio, in dB, of the mean amplitude of the in-phase (I)signal to the mean amplitude of the quadrature-phase (Q) signal.
Datatype Double
Unit DB
Parameter: <ChannelQuadratureSkew>
Description The result across iterations of quadrature skew estimates. Quadratureskew is the deviation in angle from 90 degrees between the in-phase(I) and quadrature-phase (Q) signals.
Datatype Double
Unit DEG
Parameter: <ChannelCarrierFreqLeakage>
Description The result of carrier frequency leakage. Carrier frequency leakage isthe ratio, in dB, of the energy in the DC subcarrier to the total energyof all the subcarriers.
354 | ni.com | WTS Software User Guide
Datatype Double
Unit DB
Parameter: <ChannelTimingSkew>
Description The result across iterations of timing skew estimates. Timing skew isthe difference between the sampling instants of in-phase (I) andquadrature (Q) components of the complex baseband signal.
Description Fetches the average transmit power result per stream.
Availability Query
Execution Mode Sequential
Parameter: <StreamIndex>
Description For the non-802.11ac 80+80 MIMO case, indicates the stream fromwhich the results originate. For the 802.11ac 80+80 SISO case,indicates the 80 MHz segment from which the results originate.
Description Fetches the maximum transmit power result per stream.
Availability Query
Execution Mode Sequential
Parameter: <StreamIndex>
Description For the non-802.11ac 80+80 MIMO case, indicates the stream fromwhich the results originate. For the 802.11ac 80+80 SISO case,indicates the 80 MHz segment from which the results originate.
Datatype Integer32
Parameter: <MaxStreamPwr>
Description Result across iterations of stream power measurements.
Description Fetches the minimum transmit power result per stream.
Availability Query
Execution Mode Sequential
Parameter: <StreamIndex>
Description For the non-802.11ac 80+80 MIMO case, indicates the stream fromwhich the results originate. For the 802.11ac 80+80 SISO case,indicates the 80 MHz segment from which the results originate.
Datatype Integer32
Parameter: <MinStreamPwr>
Description Result across iterations of stream power measurements.
Description The upper margin is the difference between the upper spectralflatness mask and the relative magnitude of the channel frequencyresponse. The lower margin is the difference between the relativemagnitude of the channel frequency response and the lowerspectral flatness mask. The relative magnitude of the channelfrequency response is relative to the mean power of a fewsubcarriers around the DC subcarrier. The spectral flatness maskis as defined in section 17.4.7.4, section 18.3.9.7.3, and section20.3.20.2 of IEEE Standard 802.11-2012, and section 22.3.18.2 ofIEEE Standard 802.11ac-2013.
Availability Query
ExecutionMode
Sequential
Parameter: <ChainIndex>
Description For the non-802.11ac 80+80 MIMO case, indicates the chain fromwhich the results originate. For the 802.11ac 80+80 SISO case,indicates the 80 MHz segment from which the results originate.
Datatype Integer32
358 | ni.com | WTS Software User Guide
Parameter: <StreamIndex>
Description The index of the stream from which the result originates.
Datatype Integer32
Parameter: <AvgSfMargin>
Description The result across iterations of spectral flatness margin. Spectralflatness margin is the minimum margin, in dB, of the upper and lowerspectral flatness margins.
Datatype Double
Unit dB
Parameter: <MinSfIndex>
Description The index across iterations of the subcarrier for which the minimumspectral flatness margin was observed.
Description The upper margin is the difference between the upper spectralflatness mask and the relative magnitude of the channel frequencyresponse. The lower margin is the difference between the relativemagnitude of the channel frequency response and the lowerspectral flatness mask. The relative magnitude of the channelfrequency response is relative to the mean power of a fewsubcarriers around the DC subcarrier. The spectral flatness maskis as defined in section 17.4.7.4, section 18.3.9.7.3, and section20.3.20.2 of IEEE Standard 802.11-2012, and section 22.3.18.2 ofIEEE Standard 802.11ac-2013.
Availability Query
ExecutionMode
Sequential
Parameter: <ChainIndex>
Description For the non-802.11ac 80+80 MIMO case, indicates the chain fromwhich the results originate. For the 802.11ac 80+80 SISO case,indicates the 80 MHz segment from which the results originate.
Datatype Integer32
Parameter: <StreamIndex>
Description The index of the stream from which the result originates.
Datatype Integer32
Parameter: <AvgSfMargin>
Description The result across iterations of spectral flatness margin. Spectralflatness margin is the minimum margin, in dB, of the upper and lowerspectral flatness margins.
360 | ni.com | WTS Software User Guide
Datatype Double
Unit dB
Parameter: <MinSfIndex>
Description The index across iterations of the subcarrier for which the minimumspectral flatness margin was observed.
Description The upper margin is the difference between the upper spectralflatness mask and the relative magnitude of the channel frequencyresponse. The lower margin is the difference between the relativemagnitude of the channel frequency response and the lowerspectral flatness mask. The relative magnitude of the channelfrequency response is relative to the mean power of a fewsubcarriers around the DC subcarrier. The spectral flatness maskis as defined in section 17.4.7.4, section 18.3.9.7.3, and section20.3.20.2 of IEEE Standard 802.11-2012, and section 22.3.18.2 ofIEEE Standard 802.11ac-2013.
Description For the non-802.11ac 80+80 MIMO case, indicates the chain fromwhich the results originate. For the 802.11ac 80+80 SISO case,indicates the 80 MHz segment from which the results originate.
Datatype Integer32
Parameter: <StreamIndex>
Description The index of the stream from which the result originates.
Datatype Integer32
Parameter: <AvgSfMargin>
Description The result across iterations of spectral flatness margin. Spectralflatness margin is the minimum margin, in dB, of the upper and lowerspectral flatness margins.
Datatype Double
Unit dB
Parameter: <MinSfIndex>
Description The index across iterations of the subcarrier for which the minimumspectral flatness margin was observed.
Description Fetches the spectral flatness trace data set.
Availability Query
Execution Mode Sequential
Parameter: <ChannelIndex>
Description For the non-802.11ac 80+80 MIMO case, indicates the channel fromwhich the results originate. For the 802.11ac 80+80 SISO case,indicates the 80 MHz segment from which the results originate.
Datatype Integer32
Parameter: <StreamIndex>
Description Stream index value.
Datatype Integer32
Parameter: #xyy<SubCarrierIndexes[]>
Description Subcarriers in the trace dataset.
Datatype I32 Blockdata
Parameter: #xyy<TraceValue[]>
Description Trace value per subcarrier index. Subcarrier energy normalized to theaverage energy of the reference subcarriers as described in IEEE802.11-2012 sections 18.3.9.7.3, 20.3.20.2, and in IEEE802.11ac-2013 section 22.3.18.2
Description Returns the occupied bandwidth (OBW) results.
Availability Query
Execution Mode Sequential
364 | ni.com | WTS Software User Guide
Parameter: <ChainIndex>
Description For the non-802.11ac 80+80 MIMO case, indicates the chain fromwhich the results originate. For the 802.11ac 80+80 SISO case,indicates the 80 MHz segment from which the results originate.
Datatype Integer32
Parameter: <OccupiedBandwidth>
Description The OBW of the measured signal. This value is the frequency rangecontaining 99% of the power of the entire signal spectrum.
Datatype Double
Unit Hz
Parameter: <StartFrequency>
Description The lowest frequency component of the frequency range containing99% of the entire signal spectrum.
Datatype Double
Unit Hz
Parameter: <StopFrequency>
Description The highest frequency component of the frequency range containing99% of the entire signal spectrum.
Description Fetches the measurement of the maximum spectral density,
Availability Query
Execution Mode Sequential
Parameter: <ChainIndex>
Description For the non-802.11ac 80+80 MIMO case, indicates the chain fromwhich the results originate. For the 802.11ac 80+80 SISO case,indicates the 80 MHz segment from which the results originate.
Datatype Integer32
Parameter: <MaxSpectralDensity>
Description The measurement of the maximum spectral density of the acquiredpower spectrum.
Description The spectral emission mask margin is as defined in section17.3.9.2 of IEEE Standard 802.11a-1999, section 18.4.7.3 ofIEEE Standard 802.11b-1999, section 20.3.21.1 of IEEE Standard802.11n-2009, and section 22.3.18.1 of IEEE Standard802.11ac-2013
Availability Query
Execution Mode Sequential
Parameter: <ChainIndex>
Description For the non-802.11ac 80+80 MIMO case, indicates the chainfromwhich the results originate. For the 802.11ac 80+80 SISO case with >240 MHz separation, indicates the 80 MHz segment from which theresults originate.
Datatype Integer32
370 | ni.com | WTS Software User Guide
Parameter: <WorstCaseOutOfBandMargin>
Description Worst margin across all segments of the SEM, as defined in section17.3.9.2 of IEEE Standard 802.11a-1999, section 18.4.7.3 of IEEEStandard 802.11b-1999, and section 20.3.21.1 of IEEE Standard802.11n-2009. The resulting worst margin indicates the minimumdifference between the acquired power spectral density (PSD)spectrum and the spectral mask.
Datatype Double
Unit dB
Parameter: <WorstCaseOutOfBandFrequency>
Description The frequency at which the worst margins across all segment ofthe SEM are observed.
Datatype Double
Unit Hz
Parameter: <Violation>
Description Ratio of the number of points of the signal power spectral density thatare above the applied spectral emission mask to the total number ofpoints in the signal power spectral density.
Description Fetches the results of all the SEM segments for each of the activechains and/or 802.11ac 80 MHz segments. Note 1: "SEM segment"refers to a section of the spectral emission mask and is differentfrom the notion of an 80 MHz segment in the 802.11ac 80+80(MHz) channel configuration. Note 2: In the case of an 802.11ac80+80 configuration with carrier frequency separation at mostequal to 240 MHz, a combined mask is applied to the combinedspectrum of both 80 MHz segments, resulting in a single set ofmeasurement data. For larger separations, standalone masks areapplied individually to each of the 80 MHz segments, resulting intwo sets of data.
Availability Query
ExecutionMode
Sequential
Parameter: <ChainIndex>
Description For the non-802.11ac 80+80 MIMO case, indicates the chain fromwhich the results originate. For the 802.11ac 80+80 SISO case with >240 MHz separation, indicates the 80 MHz segment from which theresults originate.
Datatype Integer32
Parameter: <NumberOfSegments>
Description Number of SEM segments.
Datatype Integer32
372 | ni.com | WTS Software User Guide
Parameter: <SegmentIndex>
Description Index of the SEM segment from which the next results originate.
Datatype Integer32
Parameter: <SegmentWorstMargin>
Description Worst margin per SEM segment, as defined in section 17.3.9.2 ofIEEE Standard 802.11a-1999, section 18.4.7.3 of IEEE Standard802.11b-1999, and section 20.3.21.1 of IEEE Standard 802.11n-2009.The resulting worst margin indicates the minimum difference betweenthe acquired power spectral density (PSD) spectrum and the spectralmask..
Datatype Double
Unit dB
Parameter: <SegmentWorstMarginFrequency>
Description The frequency, per SEM segment, at which the worst marginwithin the SEM segment is observed.
Datatype Double
Unit Hz
Parameter: <SegmentMarginReferenceLevel>
Description The power spectral density at the worst-margin frequency withinthe SEM segment.
Description Fetches the spectral emissions mask (SEM) mask data in dBm/Hz.Note: In case of 802.11ac 80+80, when the frequency differencebetween two segments is less than 240MHz, the mask of twosegments is combined into a single transmit spectral maskmeasurement.
Availability Query
Execution Mode Sequential
Parameter: <ChannelIndex>
Description For the non-802.11ac 80+80 MIMO case, indicates the channel fromwhich the results originate. For the 802.11ac 80+80 SISO case with >240 MHz separation, indicates the 80 MHz segment from which theresults originate.
Description Fetches the spectral emissions mask (SEM) power spectrum tracedata in dBm/Hz.Note: In case of 802.11ac 80+80, when the frequency differencebetween two segments is less than 240MHz, the spectral of twosegments is combined into a single transmit spectralmeasurement.
Description For the non-802.11ac 80+80 MIMO case, indicates the channel fromwhich the results originate. For the 802.11ac 80+80 SISO case with >240 MHz separation, indicates the 80 MHz segment from which theresults originate.
Datatype Integer32
Parameter: <OriginFrequency>
Description Origin point for the trace.
Datatype Double
Unit Hz
Parameter: <DeltaFrequency>
Description Delta frequency per point.
Datatype Double
Unit Hz
Parameter: #xyy<TraceDataPoints[]>
Description Trace data points
Datatype Real Blockdata (8 Byte Doubles)
Unit dBm
FETCh:RFSA:WLAN<i>[:RESults<i>]:STATe
Usage:FETCh:RFSA:WLAN<i>[:RESults<i>]:STATe?
376 | ni.com | WTS Software User Guide
Query Response:<HardwareState>,<MeasurementState>
Description Fetches the state of the instrument.
Availability Query
Execution Mode Sequential
Parameter: <HardwareState>
Description IDLE: Hardware is availablePEND: Execution is waiting for hardware to be released.ACT: Hardware is actively acquiring data.
Datatype Enumeration
Parameter: <MeasurementState>
Description OFF: The measurement has not been initiated yet.RDY: The measurement result is available to fetch.PEND: The measurement is initiated but has not started receiving datato process.PROC: The measurement is processing the acquired data.
Description Returns the maximum TXP measurement results.
Availability Query
Execution Mode Sequential
Parameter: <ChannelIndex>
Description For the non-802.11ac 80+80 MIMO case, indicates the channel fromwhich the results originate. For the 802.11ac 80+80 SISO case,indicates the 80 MHz segment from which the results originate.
Datatype Integer32
Parameter: <TransmitPower>
Description The results of the average TXP measurements.
Datatype Double
Unit dBm
Parameter: <PeakPower>
Description The results of the peak TXP measurements.
Datatype Double
Unit dBm
Parameter: <TransmitPowerWGap>
Description The results of the average TXP with gap measurements.
Description Returns the maximum transmit power (TXP) measurementresults.
Availability Query
Execution Mode Sequential
Parameter: <ChannelIndex>
Description For the non-802.11ac 80+80 MIMO case, indicates the channel fromwhich the results originate. For the 802.11ac 80+80 SISO case,indicates the 80 MHz segment from which the results originate.
Datatype Integer32
Parameter: <TransmitPower>
Description The results of the average TXP measurements.
Description Returns the maximum transmit power (TXP) power measurementresults.
Availability Query
Execution Mode Sequential
380 | ni.com | WTS Software User Guide
Parameter: <ChannelIndex>
Description For the non-802.11ac 80+80 MIMO case, indicates the channel fromwhich the results originate. For the 802.11ac 80+80 SISO case,indicates the 80 MHz segment from which the results originate.
Datatype Integer32
Parameter: <TransmitPower>
Description The results of the average TXP measurements.
Datatype Double
Unit dBm
Parameter: <PeakPower>
Description The results of the peak TXP measurements.
Datatype Double
Unit dBm
Parameter: <TransmitPowerWGap>
Description The results of the average TXP with gap measurements.
Description Fetches all trace data points for all active chains.
Availability Query
Execution Mode Sequential
Parameter: <ChannelIndex>
Description For the non-802.11ac 80+80 MIMO case, indicates the channel fromwhich the results originate. For the 802.11ac 80+80 SISO case,indicates the 80 MHz segment from which the results originate.
Description For the non-802.11ac 80+80 MIMO case, indicates the stream fromwhich the results originate. For the 802.11ac 80+80 SISO case,indicates the 80 MHz segment from which the results originate.
Datatype Integer32
Parameter: <StreamPower>
Description Result across iterations of RMS Power measurements per stream.
Description For the non-802.11ac 80+80 MIMO case, indicates the stream fromwhich the results originate. For the 802.11ac 80+80 SISO case,indicates the 80 MHz segment from which the results originate.
Datatype Integer32
Parameter: <StreamPower>
Description Result across iterations of RMS Power measurements per stream.
Description For the non-802.11ac 80+80 MIMO case, indicates the stream fromwhich the results originate. For the 802.11ac 80+80 SISO case,indicates the 80 MHz segment from which the results originate.
Datatype Integer32
Parameter: <StreamPower>
Description Result across iterations of RMS Power measurements per stream.
Datatype Double
Unit dB
INITiate:RFSA:WLAN<i>[:RESults<i>]
Usage:INITiate:RFSA:WLAN<i>[:RESults<i>]
Description Executes the current configuration reserves and uses the resultsspace indicated by the optional Results<i>.
Description Change this to delay the measurement by an integer number ofpackets. Each packet is detected by the trigger time selected untilthis count is reached.This is used in case the first packets of the DUT are expected tobe an unreliable source of the test and the measurement is neededin later packets.This applies to all measurements.
Description NONE: The reference trigger is not exported.ISELF: The reference trigger is exported to the generator of thesame module.IBROADCAST: The reference trigger is exported to all modules inthe tester.
Description Minimum quiet time. The signal is quiet when it is below the triggerlevel when you set the EDGE property to RISING, or above thetrigger level when you set the EDGE property to FALLING.
Description IMMEDIATE - Generates the signal to measure as soon as thehardware is ready.POWER - Uses RF power edge trigger.INTERNAL - Uses one of the multiple WTS internal triggers, whichmust be exported by any other personality configured to use thesame Port. Portname must be defined before this command isexecuted.ISELF - Uses one of the multiple WTS internal triggers, which mustbe exported by any other personality configured to use the samemodule. Portname must be defined before this command isexecuted.IBROADCAST - Uses one of the multiple WTS internal triggers,which must be exported by any other personality configured on thesame connection session.
Description Specifies the trigger threshold to use when power triggering. Thisvalue is referenced to the unit under test (UUT) port, accountingfor external attenuation
Description Specifies the maximum time from when the execution has beencommitted to hardware until the specified trigger event must occur.Time during which the execution is pending hardware is notincluded in the timout counter.
Description Specifies the external attenuation for all active chains. Externalattenuation is applied on top of any attenuation provided for thespecified port.
Description Calculates the carrier frequency of the WLAN signal to generate,according to the numbering scheme, by converting a set of inputparameters into the carrier frequency. The device computes thecarrier frequency according to sections 17.4.6, 18.3.8.3, 20.3.15of IEEE Standard 802.11-2012 and section 22.3.14 of IEEEStandard 802.11ac-2013.
Availability Command
Execution Mode Overlapped
398 | ni.com | WTS Software User Guide
Parameter: <Channel>
Description Specifies the offset of the center frequency, in increments of 5 MHz,above the starting frequency of the channel.When you set BWIDth to 40 MHz, FREQuency:CHANnel is theprimary channel number and the corresponding channel centerfrequency is the primary channel center frequency. Channel centerfrequency is calculated using the following formula:channel center frequency (Hz) = channel starting frequency (Hz) +(channel number * 5 MHz)
Datatype Integer32
Default Value 0
Range [0:200]
Parameter: <SecondaryFactor>
Description Specifies whether the secondary channel is above or below theprimary channel when you set BWIDth to 40 MHz.A 40 MHz channel is created by combining the primary channel andthe secondary channel, where each of the channels have a bandwidthof 20 MHz.The secondary channel number is given by the following formula:secondary channel number = primary channel number + (4 *secondary factor)The secondary channel center frequency is given by the followingformula:secondary channel center frequency (Hz) = channel startingfrequency (Hz) + (secondary channel number * 5 MHz)
Description Specifies the average power level of the active portion of theburst for signal generation. The active portion of the burst is theWLAN packet excluding the interframe spacing.
Description MIMO configurations are supported by enabling multiple chains.The array size depends on the current defined number of chains.0 | OFF: Disables a chain.1 | ON Enables a chain.
Description Specifies the bandwidth of the orthogonal frequency divisionmultiplexing (OFDM) signal to be generated. Configure thisproperty only when you configure the device for OFDM|HT|VHTgeneration.
Description 5: Specifies a 5 MHz channel bandwidth.10: Specifies a 10 MHz channel bandwidth.20: Specifies a 20 MHz channel bandwidth.40: Specifies a 40 MHz channel bandwidth .80: Specifies an 80 MHz channel bandwidth.160: Specifies a 160 MHz channel bandwidth.
If you set PHY to OFDM (80211A/G/J/P OFDM), you must setBWIDth to 5 MHz, 10 MHz, or 20 MHz, as defined in section18.2.2 of IEEE Standard 802.11-2012. If you set PHY to HT(80211N MIMOOFDM), you must set BWIDth to 20 MHz or 40MHz, as defined in section 20.2.3 of IEEE Standard 802.11n-2009.If you set PHY to VHT (80211AC MIMOOFDM), you must setBWIDth to 20 MHz, 40 MHz, 80 MHz, or 160 MHz, as defined insection 22.2.2 of IEEE Standard 802.11ac-2013. For OFDM signals,channel bandwidth determines the number of pilot and datasubcarriers used.
Description The amount of Gaussian white noise added to the signal. If adigitally modulated signal, this will be Eb/No. If an analogmodulated signal, this will be the SNR value.
Description Specifies the position of the marker relative to WLAN packet.This is relevant to the trigger export settings in theTRIG:RFSG:WLAN:EXPort command.
Description DYNAMIC: Use the configured properties in the PACKetsubsystem to dynamic configure a WLAN generation.ARB: Use a waveform file to generate a WLAN signal.
Description Specifies whether to enable dual carrier modulation (DCM). DCMmodulates the same information on a pair of sub-carriers. DCM is anoptional modulation scheme for the HE-SIG-B and data fields. DCMis only applied to BPSK, QPSK and 16-QAM modulations. Note:With this command, DCM is only applied to HE SU PPDU and HEextended range SU PPDU. For OFDMA multi-users, refer toSOURce:RFSG:WLAN<i>:PACKet:USER<i>:DCM:[ENABle] andSOURce:RFSG:WLAN<i>:PACKet:DCM:ALL[:ENABle]
Availability Command/Query
ExecutionMode
Command: SequentialQuery: Sequential
Parameter: <DCMEnabled>
Description 0 | OFF: Disables DCM.1 | ON: Enables DCM.
Description Specifies whether to enable the dual carrier modulation (DCM)for all users in a multi-user (MU) protocol data unit (PPDU) andtrigger-based PPDU.
Description R1M: Specifies a data rate of 1 MBps, as defined in sections18.4.6.3 and 18.4.6.4 of IEEE Standard 802.11b-1999.R2M: Specifies a data rate of 2 MBps, as defined in sections18.4.6.3 and 18.4.6.4 of IEEE Standard 802.11b-1999.R5M5: Specifies a data rate of 5.5 MBps.R6M: Specifies a data rate of 1.5 MBps, 3 MBps, and 6 MBps forrespective channel bandwidths of 5 MHz, 10 MHz, and 20 MHz.R9M: Specifies a data rate of 2.25 MBps, 4.5 MBps, and 9 MBpsfor respective channel bandwidths of 5 MHz, 10 MHz, and 20 MHz.R11M: Specifies a data rate of 11 MBps.R12M: Specifies a data rate of 3 MBps, 6 MBps, and 12 MBps forrespective channel bandwidths of 5 MHz, 10 MHz, and 20 MHz.R18M: Specifies a data rate of 4.5 MBps, 9 MBps, and 18 MBps forrespective channel bandwidths of 5 MHz, 10 MHz, and 20 MHz.R24M: Specifies a data rate of 6 MBps, 12 MBps, and 24 MBps forrespective channel bandwidths of 5 MHz, 10 MHz, and 20 MHz.R36M: Specifies a data rate of 9 MBps, 18 MBps, and 36 MBps forrespective channel bandwidths of 5 MHz, 10 MHz, and 20 MHz.R48M: Specifies a data rate of 12 MBps, 24 MBps, and 48 MBpsfor respective channel bandwidths of 5 MHz, 10 MHz, and 20 MHz.R54M: Specifies a data rate of 13.5 MBps, 27 MBps, and 54 MBpsfor respective channel bandwidths of 5 MHz, 10 MHz, and 20 MHz.
Description LONG: Uses the long guard interval (1/4).SHORT: Uses the short guard interval (1/8).G1F4: Guard interval length is equal to one-fourth of the IDFT/DFTperiod.G1F8: Guard interval length is equal to one-eighth of the IDFT/DFTperiodG1F16: Guard interval length is equal to one-sixteen of theIDFT/DFT period.
Description Specifies the HE-LTF symbol size in the 802.11ax signals. TheIEEE Standard 802.11ax specifies the following combinations of theHE-LTF symbol size and the GUARD INTERVAL.If you set the PPDU TYPE to SU_PPDU, MU_PPDU orEXTENDED_RANGE_SU_PPDU, the HE_LTF_SIZE is 4X, andthe GUARD_INTERVAL value is 1/4.If you set thePPDU_TYPE to SU_PPDU, MU_PPDU orEXTENDED_RANGE_SU_PPDU, HE_LTF_SIZE value is 2X, andthe GUARD_INTERVAL value is 1/8.If you set the PPDU_TYPEto SU_PPDU, MU_PPDU orEXTENDED_RANGE_SU_PPDU, the HE_LTF_SIZE value is 2Xor 4X, and the GUARD_INTERVAL value is 1/16.If you set the PPDU_TYPE to TRIGGER_BASED_PPDU, theHE_LTF_SIZE value is 4X and theGUARD_INTERVAL Value is1/4.If you set the PPDU_TYPE to TRIGGER_BASED_PPDU, theHE_LTF_SIZE value is 2X and the GUARD_INTERVAL value is1/8.
Availability Command/Query
ExecutionMode
Command: SequentialQuery: Sequential
418 | ni.com | WTS Software User Guide
Parameter: <HE-LTFSize>
Description AUTO: Specifies 4x as HE-LTF symbol duration for the guardinterval type value of 1/4; or 2x otherwise.4X: Specifies 4x as the HE-LTF symbol duration.2X: Specifies 2x as the HE-LTF symbol duration1X: Specifies 1x as the HE-LTF symbol duration
Description Specifies the value of the modulation and coding scheme (MCS)index in 802.11n. The MCS index is a compact representation thatdetermines the modulation scheme, coding rate, and number ofspatial streams as specified in section 20.3.5 of IEEE Standard802.11n-2009.in 802.11ac the MCS index represent only the the modulationscheme and coding tate as described in section 22.5 of IEEEStandard 802.11ac-2013.
802.11ac has the number of space time streams set thru thecommand: CONFigure:RFSA:WLAN<i>:PACKet:NSTS
Availability Command/Query
ExecutionMode
Command: OverlappedQuery: Sequential
Parameter: <McsIndex>
Description Modulation and coding scheme (MCS) index.
Description DIRECT: Use a direct mapping where every channel has only onestream. In the case where the number of transmit chains exceeds thenumber of streams, streams are repeated as nessesary.
Description BCC: Uses binary convolutional code (BCC) FEC coding.LDPC: Uses low-density parity check (LDPC) FEC coding.The size of the array depends on the current defined number ofusers.
Description Specifies the six-byte Address1 field as defined in section 7.1.3of IEEE Standard 802.11-2007 and IEEE Standard 802.11n-2009.This field is represented with the least significant byte in theleftmost position and each byte is represented with the leastsignificant bit in the rightmost position.For example, the medium access control (MAC) address12-34-56-78-9A-BC is represented by the number 0 x123456789ABC.Configure all devices with the same address.
Description Specifies the six-byte Address1 field as defined in section 7.1.3of IEEE Standard 802.11-2007 and IEEE Standard 802.11n-2009.This field is represented with the least significant byte in theleftmost position and each byte is represented with the leastsignificant bit in the rightmost position.For example, the medium access control (MAC) address12-34-56-78-9A-BC is represented by the number 0 x123456789ABC.Configure each device address individually.
Description The size of the array depends on the current defined number ofusers. Note: For multi-user (MU) protocol data unit (PPDU), therange is between -20 dB and 20 dB. For trigger-based PPDU therange is between -100 dB and 100 dB.
Description Specifies the power boost for specific users. Note: For multi-user(MU) protocol data unit (PPDU), the range is between -20 dB and20 dB. For trigger-based PPDU the range is between -100 dB and100 dB.
Description SUPPDU: Specifies a single user (SU) PPDU.MUPPDU: Specifies a multi-user (MU) PPDU.ERSUPPDU: Specifies a Extended Range SU PPDU.TBPPDU: Specifies a trigger-based PPDU.
Description Specifies the RU size for extended range SU PPDU. The PPDU typemust be set to extended range SU PPDU only for single spatialstream, channel bandwidth set to 20 MHz with RU Size of 242 withMCS index of 0,1 and 2 or with RU Size of 106 with MCS index of0 only.
Description Specifies the size of resource unit (RU) for all users in terms ofthe number of subcarriers for the 802.11ax signal. This size isspecified when you set the PPDU Type to MU PPDU or trigger-based PPDU.
Description Similar to OFDM, OFDMA employs multiple subcarriers, but thesubcarriers are divided into several groups of subcarriers where eachgroup is denoted as a resource unit (RU). The 802.11ax standardcalls the smallest subchannel a Resouce Unit (RU), with a minimumsize of 26 subcarriers. The size of the array depends on the currentdefined number of users.
Description Specifies the location of the resource unit (RU) for all users, interms of the index of 26-tone RU assuming all the 26-tone RUsover entire bandwidth, of 802.11ax signal.
Description Refer to Draft P802.11ax_D1.1 Table 28-21-RU allocationsignaling: Arrangement and number of MU-MIMO allocations.To be mentioned, please configure the PPDU type to MUPPDU,Number of Users and multi user parameters such as DCM, MCSindex, NSTS, STAid, FEC Type, Power Boost before you selectthe Tone Map. After the Tone map is selected the RU size andRU offset for all users will be configured.
Description DSSS: Generates a DSSS signal type (802.11 b/g-DSSS).OFDM: Generates an OFDM signal type (802.11 a/g/j).HT: Generates a high throughput (HT) signal type (802.11 n).VHT: Generates a very high throughput (VHT) signal type (802.11ac).POFDM: Generates an OFDM signal type (802.11 p).HE: Generates a high efficiency (HE) signal type (802.11 ax).
Description OFF: The generator is OFF for this personality.PENDING: The generator is transitioning states.ON: The generator is ON. There is RF power on the specified portfrom this personality.
Description NONE: No signal is exported.ISELF: At the marker event in the script, the master VSG exports atrigger signal to the analyzer on the same module.IBROADCAST: At the marker event in the script, the master VSGexports a trigger signal to all analyzers on the same connectionsession.
Description Specifies the frame trigger source. If a frame trigger is defined,the WLAN generation generates a single frame every time aframe trigger is received.
Description NONE: No frame trigger is used. WLAN packet spacing isdetermined by the idle time setting.ISELF: Uses an internal trigger sent by the analyzer of the samemodule.IBROADCAST: Uses an internal broadcast trigger from anyanalyzer in the tester.
Description Immediate - Generates the signal to measure when the hardware isready.Internal - Uses an internal trigger route. Requires you to export asignal to the internal destination with another command.PFI 0 - Uses the front panel PFI 0 trigger if available.PFI 1 - Uses the front panel PFI 1 trigger if available.
Description Trigger timeout. The timeout watchdog does not start while thehardware configuration is pending. If the trigger timeout exceeds,the generator returns to OFF.
Datatype Double
Default Value 5.00
Range [0.00:10000.00]
Unit sec
Bluetooth Instrument PersonalitiesUse the SCPI commands for the Bluetooth instrument personalities to perform measurementson Bluetooth signals that conform to Bluetooth Test Specification version 1.2/2.0/2.0+EDR/2.1/2.1+EDR/3.0/3.0+HS/4.0.
This manual assumes that you are familiar with the Bluetooth specifications.
Bluetooth Signal Analyzer SCPI Command ListComplete list of Bluetooth signal analyzer SCPI commands.
The instrument will execute adjacent channel power (ACP)measurements for signals containing BDR packets, EDR IBEmeasurements for signals containing EDR packets, and LE IBEmeasurements for signals containing LE-TP packets.
Description 0 | OFF: Disables ModAcc measurements.1 | ON: Enables ModAcc measurements.Enables DEVM for EDR packets and DF1/DF2 for BDR and LE-TPpackets.
Description Measurement interval in symbols. -1 uses the maximum value forthe selected packet type. This value is used for DF1, DF2, andDEVM measurements.
Description Measurement offset in symbols.This value is used for DF1 and DF2 measurements. Themeasurement must begin from start (0 offset) for DEVM and CFOmeasurements.
Description RMS - The power is averaged using root mean square.LOG - The log of the power is averaged.SCALAR - The voltage is averaged.MAX - The maximum values are retained.MIN - The minimum values are retained.
Description BDADdress consists of 3-parts:LAP: Lower address part consisting of 24 bits.UAP: Upper address part consisting of 8 bits.NAP: Non-significant address part consisting of 16 bits.The 3 parts are concatenated into a single hexadecimalrepresentation in the following order: 0x<LAP><UAP><NAP>.For example if LAP=0x000080,UAP=0x48,NAP=0xACDE theresulting SCPI command would be #H00008048ACDE.
Description PREamble: The instrument uses the packet preamble to synchronizethe packet.If the current configure packet type is EDR/BDR, it uses packetPREamble.If the current configure packet type is LE-TP, it uses packetAccessAddress or Syncword.NONE: The instrument does not perform synchronization tosynchronize the packet.
Description Computes the center frequency of the Bluetooth signal transmittedby the WTS based on the value that you specify in the channelnumber parameter. The center frequency is computed according tosection 2, Volume 2 of the Bluetooth Specification v2.1+EDR.
Description DH1: Uses the DH1 packet type.DH3: Uses the DH3 packet type.DH5: Uses the DH5 packet type.LETP: Uses the LE-TP packet type.LETP_EXT: Uses the LE-TP-EXT packet type. This packet issimilar to the LE-TP packet, except that the payload length isextended up to 255 bytes. Refer to Section 2.1, Part B, Volume 6 ofthe Bluetooth Specification v4.2 for more information about thispacket.LE_ENHANCED: Uses the LE-Enhanced packet type. This is anLE packet type with a symbol rate of 2 Msps. Refer to the 2 MbpsLE Bluetooth Draft Improvement Proposal, Revision D05r20 topicat the www.bluetooth.org website for more information about thispacket.LE_LR125K: Uses the LE-LR-125k packet type. This is an LEpacket type, which supports long range communication at a data rateof 125 kbps. Refer to the LE Long Range Bluetooth DraftImprovement Proposal, Revision D05r13 topic at thewww.bluetooth.org website for more information about this packet.LE_LR500K: Uses the LE-LR-500k packet type. This is an LEpacket type, which supports long range communication at a data rateof 500 kbps. Refer to the LE Long Range Bluetooth DraftImprovement Proposal, Revision D05r13 topic at thewww.bluetooth.org website for more information about this packet.
Description If disabled, no trace data is collected so no traces can be fetched.0 | OFF: Disables collection of trace data.1 | ON: Enables collection of trace data.
Description Fetches the status for the InBandEmission measurement based onthe measurement limits specified in section 5.1.15 of theBluetooth Test Specification v1.2/2.0/2.0+EDR/2.1/2.1+EDR/3.0/3.0+HS/4.0.
Availability Query
Execution Mode Sequential
Parameter: <MeasurementStatus>
Description FAIL: Measurement results do not satisfy the limits.TRUE: Measurement results satisfy the limits.
Datatype Enumeration
Parameter: <ReferenceChannelPower>
Description Peak power of the center channel.
Datatype Double
Unit dBm
Parameter: <UpperChannelTotalPower>
Description Peak power of the upper channel adjacent to the center frequency.
480 | ni.com | WTS Software User Guide
Datatype Double
Unit dBm
Parameter: <LowerChannelTotalPower>
Description Peak power of the lower channel adjacent to the center frequency.
Description Returns the number of symbols below the 99% DEVM. This ishelpful to know by how many symbols are (or are not) measuredby the standard defined 99% DEVM (defined as the DEVM valuefor which 99% of measured symbolshave a lower DEVM).
Description Fetches impairments measurement results. Results are valid forenhanced data rate (EDR) packets.
Availability Query
Execution Mode Sequential
Parameter: <AverageIqImbalance>
Description The result across iterations of I/Q gain imbalance estimates. I/Q gainimbalance is the ratio of the mean amplitude of the in-phase (I) signalto the mean amplitude of the quadrature-phase (Q) signal.
486 | ni.com | WTS Software User Guide
Datatype Double
Unit dB
Parameter: <AvgQuadratureSkew>
Description The result across iterations of quadrature skew estimates. Quadratureskew is the deviation in angle from 90 degrees between the in-phase(I) and quadrature-phase (Q) signals.
Datatype Double
Unit deg
Parameter: <AvgIOffset>
Description The result across iterations of the in-phase (I) offset.
Datatype Double
Unit %
Parameter: <AvgQOffset>
Description The result across iterations of the quadrature-phase (Q) offset.
Description Fetches carrier frequency offset results. ICFTMax ,MaxCarrierDrift and MaxCarrierDrift/50us results are valid forbasic data rate (BDR) packets and LE-TP packets.MaxPayloadBlockFreqOffset and MaxCarrierDrift/55us are validfor only LE-TP packets.For BDR refer to 5.1.10 TRM/CA/08/C (Initial Carrier FrequencyTolerance) and 5.1.11 TRM/CA/09/C (Carrier Frequency Drift)
Description Fetches DF1 and DF2 measurement results. Results are valid forbasic data rate (BDR) packets and LE-TP packets. Note: Youmust first perform both DF1 and DF2 measurements to receivevalid values for the DF2/DF1 result.
Description Fetches DF trace. The trace represents the frequency deviationversus symbol. These traces help ensure that the pattern is thatneeded for DF1 or DF2. Traces are valid for basic data rate(BDR) packets and LE-TP packets.
Description OFF: The measurement has not been initiated yet.READY: The measurement result is available to fetch.PENDING: The measurement is initiated but has not started receiveddata to process.PROCESSING: The measurement is processing the acquired data.
Description Change this to delay the measurement by an integer number ofpackets. Each packet is detected by the trigger time selected untilthis count is reached.This is used in case the first packets of the DUT are expected tobe on-reliable source of the test and the measurement is needed inlater packets.This applies to all measurements.
Description Minimum quiet time. The signal is quiet when it is below the triggerlevel when you set the EDGE property to RISING, or above thetrigger level when you set the EDGE property to FALLING.
Datatype Double
Default Value 1.000000000000000E-004
Range [0.000000000000000E+000:5.000000000000000E-003]
Description IMMEDIATE - Generates the signal to measure as soon as thehardware is ready.POWER - Uses RF power edge trigger.INTERNAL - Uses one of the multiple WTS internal triggers, whichmust be exported by any other personality configured to use thesame Port. Portname must be defined before this command isexecuted.
Description Specifies the trigger threshold to use when power triggering. Thisvalue is referenced to the unit under test (UUT) port, accountingfor external attenuation.
Description BDADdress consists of 3-parts:LAP: Lower address part consisting of 24 bits.UAP: Upper address part consisting of 8 bits.NAP: Non-significant address part consisting of 16 bits.The 3 parts are concatenated into a single hexadecimalrepresentation in the following order: 0x<LAP><UAP><NAP>.For example if LAP=0x000080,UAP=0x48,NAP=0xACDE theresulting SCPI command would be #H00008048ACDE.
Description Computes the center frequency of the Bluetooth signal transmittedby the WTS based on the value that you specify in the channelnumber parameter. The center frequency is computed according tosection 2, Volume 2 of the Bluetooth Specification v2.1+EDR.
Description NULL: NULL packet type. This packet has no payload and consistsof the channel access code and packet header only. Refer to section6.5.1.2, Part B, Volume 2 of the Bluetooth Specification v2.1+EDRfor more information about this packet.POLL: POLL packet type. This packet does not have a payload.Refer to Section 6.5.1.3, Part B, Volume 2 of the BluetoothSpecification v2.1+EDR for more information about this packet.FHS: Frequency hop synchronization (FHS) packet type. This packetis a special control packet containing the Bluetooth device addressand the sender's clock. Refer to Section 6.5.1.4, Part B, Volume 2 ofthe Bluetooth Specification v2.1+EDR for more information aboutthis packet.DH1: DH1 packet type. This packet is similar to the DM1 packet,except that the information in the payload is not forward errorcorrection (FEC) encoded. The DH1 packet occupies a single timeslot. Refer to Sections 6.5.1.5 and 6.5.4.2, Part B, Volume 2 of theBluetooth Specification v2.1+EDR for more information about thispacket.DH3: DH3 packet type. This packet is similar to the DM3 packet,except that the information in the payload is not FEC encoded. Referto Section 6.5.4.4, Part B, Volume 2 of the Bluetooth Specificationv2.1+EDR for more information about this packet.DH5: DH5 packet type. This packet is similar to the DM5 packet,except that the information in the payload is not FEC encoded. Referto Section 6.5.4.6, Part B, Volume 2 of the Bluetooth Specificationv2.1+EDR for more information about this packet.DM1: DM1 packet type. This packet carries only data information.The information and cyclic redundancy check (CRC) bits are codedwith a rate 2/3 FEC. The DM1 packet occupies a single time slot.Refer to sections 6.5.1.5 and 6.5.4.1, Part B, Volume 2 of theBluetooth Specification v2.1+EDR for more information about thispacket.DM3: DM3 packet type. This packet may occupy up to three timeslots. The payload has 2 to 123 information bytes, (including the 2-byte payload header), inclusive, and a 16-bit CRC code. Refer toSection 6.5.4.3, Part B, Volume 2 of the Bluetooth Specificationv2.1+EDR for more information about this packet.
DM5: DM5 packet type. The payload has 2 to 226 information bytes(including the 2-byte payload header), inclusive, and a 16-bit CRCcode. Refer to Section 6.5.4.6, Part B, Volume 2 of the BluetoothSpecification v2.1+EDR for more information about this packet.HV1: HV1 packet type. This packet has 10 information bytes. Referto Section 6.5.2.1, Part B, Volume 2 of the Bluetooth Specificationv2.1+EDR for more information about this packet.HV2: HV2 packet type. This packet has 20 information bytes. Referto Section 6.5.2.3, Part B, Volume 2 of the Bluetooth Specificationv2.1+EDR for more information about this packet.HV3: HV3 packet type. This packet has 30 information bytes. Theinformation bytes are not protected by FEC. Refer to Section 6.5.2.3,Part B, Volume 2 of the Bluetooth Specification v2.1+EDR for moreinformation about this packet.EV3: EV3 packet type. This packet has 1 to 30 information bytes,inclusive, and a 16-bit CRC code. Refer to Section 6.5.3.1, Part B,Volume 2 of the Bluetooth Specification v2.1+EDR for moreinformation about this packet.EV4: EV4 packet type. The EV4 packet has 1 to 120 informationbytes, inclusive, and a 16-bit CRC code. Refer to Section 6.5.3.2,Part B, Volume 2 of the Bluetooth Specification v2.1+EDR for moreinformation about this packet.EV5: EV5 packet type. The EV5 packet has 1 to 180 informationbytes, inclusive, and a 16-bit CRC code. Refer to Section 6.5.3.3,Part B, Volume 2 of the Bluetooth Specification v2.1+EDR for moreinformation about this packet.DV: DV packet type. This packet is a combined data-voice packet.Refer to Section 6.5.2.4, Part B, Volume 2 of the BluetoothSpecification v2.1+EDR for more information about this packet.AUX1: AUX1 packet type. This packet resembles a DH1 packet buthas no CRC code. Refer to Section 6.5.4.7, Part B, Volume 2 of theBluetooth Specification v2.1+EDR for more information about thispacket.
516 | ni.com | WTS Software User Guide
LETP: LE-TP packet type. Specifies that the packet type is LE-TP.Refer to Section 2.1, Part B, Volume 6 of the Bluetooth Specificationv4.0 for more information about this packet.LETP_EXT: Specifies that the packet type is LE-TP-EXT. Thispacket is similar to the LE-TP packet, except that the payload lengthis extended upto 255 bytes. Refer to Section 2.1, Part B, Volume 6 ofthe Bluetooth Specification v4.2 for more information about thispacket.LE_ENHANCED: Specifies that the packet type is LE-Enhanced.This is an LE packet type with a symbol rate of 2 Msps. For moreinformation about this packet, refer to 2 Mbps LE Bluetooth DraftImprovement Proposal, Revision D05r20 topic at thewww.bluetooth.org website.LE_LR125K: Specifies that the packet type is LE-LR-125k. This isan LE packet type which supports long range communication at adata rate of 125 kbps. Refer to the LE Long Range Bluetooth DraftImprovement Proposal Document, Revision D05r13 topic at thewww.bluetooth.org website for more information about this packet.LE_LR500K: Specifies that the packet type is LE-LR-500k. This isan LE packet type which supports long range communication at adata rate of 500 kbps. Refer to the LE Long Range Bluetooth DraftImprovement Proposal Document, Revision D05r13 topic at thewww.bluetooth.org website for more information about this packet.
Description Number of packets to generate. The PN data is driven byPACKet:UNIQue:COUNt. The instrument resets the PN generatorafter it reaches the number of unique packets that you specify inPACKet:UNIQue:COUNt.For example, if PACKet:UNIQue:COUNt = 10, and you setPACKet:COUNt to 1, the same payload is used for each packet, andif you set PACKet:COUNt:NUMBer to 2, the same payload is usedafter every 2 packets. If you set PACKet:COUNt to 100, only 10 ofthem will be unique and the PN sequence will repeat after every 10.-1 means infinite number of packets.
Configure PACKet:COUNt only if you setPACKet:PAYLoad:DV:MODe or PACKet:PAYLoad:MODE to PN.
Description The 3-bit logical transport (LT) address of the packet. The LTaddress field indicates the destination slave for a packet in a master-to-slave transmission slot and indicates the source slave for a slave-to-master transmission slot. Refer to sections 6.4.1 and 6.4.2, Part B,Volume 2 of the Bluetooth Specification v2.1+EDR for moreinformation about the LT address of a packet.
Description The value for the flow control field in the packet header. This fieldcontrols the 1-bit flow control parameter in the packet. Refer toSection 6.4.3, Part B, Volume 2 of the Bluetooth Specificationv2.1+EDR for more information about the flow control field.0 indicates a Stop condition.1 indicates a Go condition.
Datatype Boolean
Default Value 0
Range 0 | 1 | OFF | ON
Parameter: <ArqnBit>
Description The value for the automatic repeat request number (ARQN) field inthe packet header. This command controls the value for the 1-bitacknowledgement indicator, which indicates whether the data packettransfer is successful. Refer to sections 6.4.4 and 7.6, Part B,Volume 2 of the Bluetooth Specification v2.1+EDR for moreinformation about the ARQN field.NAK: Negative acknowledgement.ACK: Positive acknowledgement.
Datatype Enumeration
Default Value NAK
Range NAK | ACK
520 | ni.com | WTS Software User Guide
Parameter: <SeqnBit>
Description Value for the sequential numbering scheme (SEQN) field in thepacket header. This command controls the value for the 1-bitsequence bit, which allows you to provide a sequential numberingscheme to order the data packet scheme. Refer to sections 6.4.5,7.6.2, and 7.6.5, Part B, Volume 2 of the Bluetooth Specificationv2.1+EDR for more information about the SEQN field.
Description PN: The instrument uses a Galois pseudonoise (PN) bit sequencewith a payload order and seed, which you specify in thePACKet:PAYLoad:DV:PN:ORDer andPACKet:PAYLoad:DV:PN:SEED commands respectively, to createthe payload for generation.PATTERN: The instrument repeats the bit pattern, which you selectin the PACKet:PAYLoad:DV:PATTern command, to achieve thenecessary payload length.USER: The instrument repeats the bit pattern, which you specify inthe PACKet:PAYLoad:DV:USER command, to achieve thenecessary payload length.
Description Order (length of memory) of the PRBS generator. This value is usedfor generating the payload data if you set thePACKet:PAYLoad:DV:MODE to PN.
Description Initialization seed used for the PRBS generator. This value is usedfor generating the payload data if you set thePACKet:PAYLoad:DV:MODE to PN.
Description Bit pattern used for packet payload if you setPACKet:PAYLoad:DV:MODE to USER.If the array length is greater than the required payload length, theinstrument uses a subset of the required length from the beginningof the array for waveform generation. If the array length is less thanthe required payload length, the instrument repeats the bit patternuntil the required length is achieved.
Description The 3-bit logical transport (LT) address of the FHS packet. Refer toSection 6.5.1.4, Part B, Volume 2 of the Bluetooth Specificationv2.1+EDR for more information about the LT address of the FHSpacket.
Datatype Integer32
Default Value 0
Range [0:7]
526 | ni.com | WTS Software User Guide
Parameter: <FhsDeviceClass>
Description The 24-bit field in the FHS packet payload. This field indicates thedevice class of the device that sends the FHS packet. Refer toSection 6.5.1.4, Part B, Volume 2 of the Bluetooth Specificationv2.1+EDR for more information about the device class field in theFHS packet payload.
Datatype Integer32
Default Value 0
Range [-128:127]
Parameter: <FhsScanPeriod>
Default Value 0
Range [-128:127]
Parameter: <FhsScanRepitition>
Description The 2-bit field in the FHS packet payload. This field indicates theinterval between two consecutive page scan windows. Refer toSection 6.5.1.4, Part B, Volume 2 of the Bluetooth Specificationv2.1+EDR for more information about the payload scan repetitionfield of the FHS packet payload.
Description The 3-bit field in the FHS packet payload. This field indicates thedefault scan mode used by the sender of the FHS packet. Refer toSection 6.5.1.4, Part B, Volume 2 of the Bluetooth Specificationv2.1+EDR for more information about the page scan mode field ofthe FHS packet payload.
Datatype Integer32
Default Value 0
Range [-128:127]
Parameter: <DeviceClock>
Description Specifies the 26-bit field in the frequency hop synchronization(FHS) packet payload. This field contains the value of the nativeclock of the device that sends the FHS packet. Refer to Section6.5.1.4, Part B, Volume 2 of the Bluetooth Specification v2.1+EDRfor more information about the device clock field of the FHS packetpayload.
Description Specifies whether the payload is the start or continuation fragmentof a logical link control and adaptation protocol (L2CAP) or linkmanagement protocol (LMP) message.
Description The value for the flow control bit in the payload header. This fieldcontrols the 1-bit flow control parameter in the packet.0 indicates a Stop condition.1 indicates a Go condition.
Datatype Boolean
Default Value 0
Range 0 | 1 | OFF | ON
Parameter: <Length>
Description The payload length, in bytes. If the length exceeds the maximumpermissible length mentioned in the Bluetooth specification, theMCT uses this maximum permissible length as the payload length.
Description PN: the instrument uses a Galois pseudonoise (PN) bit sequencewith a payload order and seed, which you specify in thePACKet:PAYLoad:PN:ORDer and PACKet:PAYLoad:PN:SEEDcommands respectively, to create the payload for generation.PATTERN: The instrument repeats the bit pattern, which you selectin the PACKet:PAYLoad:PATTern command, to achieve thenecessary payload length.USER: Specifies that the instrument repeats the bit pattern, whichyou specify in the PACKet:PAYLoad:USER command, to achievethe necessary payload length.
Description Bit pattern used for packet payload if PACKet:PAYLoad:MODE isset to USER.If the array length is greater than the required payload length, theinstrument uses a subset of the required length from the beginningof the array for waveform generation. If the array length is less thanthe required payload length, the instrument repeats the bit patternuntil the required length is achieved.
Description Specifies the number of unique packets for which the pseudonoise(PN) generator must run continuously. The algorithm resets thePN generator after it generates the number of packets that youspecify in this property. For example, if you set this property to 1,the same payload is used in every packet; and if you set thisproperty to 2, the same payload is used after every 2 packets.Configure this property only if you set the Payload Data Typeproperty to PN Sequence.
Availability Command/Query
ExecutionMode
Command: OverlappedQuery: Sequential
Parameter: <UniqueNumberOfPackets>
Description Number of unique packets for which the pseudonoise (PN)generator must run continuously. The instrument resets the PNgenerator after it reaches the number of unique packets that youspecify in PACKet:UNIQue.For example, if PACKet:UNIQue:COUNt = 10, and you setPACKet:UNIQue:COUNt to 1, the same payload is used for eachpacket, and if you set PACKet:COUNt to 2, the same payload isused after every 2 packets. If you set PACKet:COUNt to 100, only10 of them will be unique and the PN sequence will repeat afterevery 10.
Description Immediate - Generates the signal to measure as soon as thehardware is ready.Internal - Uses an internal trigger route. Requires you to export asignal to the internal destination with another command.PFI 0 - Uses the front panel PFI 0 trigger if available.PFI 1 - Uses the front panel PFI 1 trigger if available.
Description Trigger timeout. The timeout watchdog does not start while thehardware configuration is pending. If the trigger timeout hasexceeded the generator returns to off again.
Datatype Double
Default Value 10.00
540 | ni.com | WTS Software User Guide
Range [0.00:10000.00]
Unit sec
GSM Instrument PersonalityUse the GSM instrument personality to analyze error vector magnitude (EVM), output radiofrequency spectrum (ORFS), modulation accuracy (ModAcc), power versus time (PVT), andtransmit power (TXP) measurements on GSM and EDGE signals that conform to the 3GPPspecifications.
This manual assumes that you are familiar with the 3GPP specifications.
GSM Signal Analyzer SCPI Command ListComplete list of GSM signal analyzer SCPI commands.
Description PN: The instrument uses a Galois pseudonoise (PN) bit sequencewith a payload order and seed, which you specify in thePAYLoad:PN:ORDer and PAYLoad:PN:SEED commandsrespectively, to create the payload for generation.PATTERN: The instrument repeats the bit pattern, which you selectin the PAYLoad:PATTern command, to achieve the necessarypayload length.USER: The instrument repeats the bit pattern, which you specify inthe PAYLoad:USER command, to achieve the necessary payloadlength.
Description RMS - The power is averaged using Root-Mean-Square.LOG - Averages the log of the measured power.SCALAR - Averages the measured voltage.MAX - Averages the maximum measured values.MIN - Averages the minimum measured values.VECTOR - Averages the I/Q values.
Description STANDARD: Uses the complete list of offset frequencies, asdefined in Annex A of the 3GPP TS 45.005 v8.0.0 specifications.The standard offset frequencies, in Hz, for modulation are -100000,100000, -200000, 200000, -250000, 250000, -400000, 400000,-600000, 600000, -800000, 800000, -1000000, 1000000, -1200000,1200000, -1400000, 1400000, -1600000, 1600000, -1800000,1800000, -3000000, 3000000, -6000000, 6000000.SHORT: Uses a shortened list of offset frequencies. These offsetfrequencies, in Hz, for modulation are -200000, 200000, -250000,250000, -400000, 400000, -600000, 600000, -1200000, 1200000,-1800000, 1800000.CUSTOM: Uses a list of offset frequencies defined by the user.NOTE: ORFS Switching Standard and Short are the same.
Description Specifies whether to perform output radio frequency spectrum(ORFS) measurements on the modulated part of the waveform,the switching part of the waveform, or both.
Description BOTH - Performs measurements on the modulated and switchingparts of the waveform.MODULATION - Performs measurements on the modulated part ofthe waveform.SWITCHING - Performs measurements on the switching part of thewaveform.
Description Specifies the offset frequencies for performing modulationmeasurements for output radio frequency spectrum (ORFS).Configure this parameter only when you set Frequency List Modeto CUSTOM.
Description Array containing the offset frequencies used for modulationspectrum measurements.
Datatype Double
Default Value -1.000000E+005,1.000000E+005,-2.000000E+005,2.000000E+005,-2.500000E+005,2.500000E+005,-4.000000E+005,4.000000E+005,-6.000000E+005,6.000000E+005,-8.000000E+005,8.000000E+005,-1.000000E+006,1.000000E+006,-1.200000E+006,1.200000E+006,-1.400000E+006,1.400000E+006,-1.600000E+006,1.600000E+006,-1.800000E+006,1.800000E+006,-3.000000E+006,3.000000E+006,-6.000000E+006,6.000000E+006
Description Specifies the offset frequencies for performing switchingmeasurements for output radio frequency spectrum (ORFS).Configure this parameter only when you set Frequency List Modeto CUSTOM.
Description RMS - Averages the measured power.LOG - Averages the log of the measured power.SCALAR - Averages the measured voltage.MAX - Averages the maximum measured values.MIN - Averages the minimum measured values.VECTOR - Averages the I/Q values.
Description Specifies the carrier frequency of the received GSM/EDGEsignal. The FREQuency:CENTer value is also implicitlycalculated based on the settings for FREQuency:CHANnel andFREQuency:BAND if both values are set.
Description Specifies the GSM band for the uplink. The FREQuency:CENTervalue is calculated based on the settings forFREQuency:CHANnel and FREQuency:BAND.
Description Band as defined in section 2 of the 3GPP TS 45.005 v8.0.0specification.PGSM - Specifies a primary GSM (PGSM) band in the 900 MHzband.EGSM - Specifies an extended GSM (EGSM) band in the 900 MHzband.RGSM - Specifies a railway GSM (RGSM) band in the 900 MHzband.DCS1800 - Specifies a digital cellular system 1800 (DCS 1800)band. This band is also known as GSM 1800.PCS1900 - Specifies a personal communications service 1900 (PCS1900) band. This band is also known as GSM 1900.GSM450 - Specifies a GSM 450 band.GSM480 - Specifies a GSM 480 band.GSM850 - Specifies a GSM 850 band.GSM750 - Specifies a GSM 750 band.T-GSM810 - Specifies a terrestrial GSM 810 (T GSM 810) band.
Description Specifies the frequency channel for the uplink. TheFREQuency:CENTer value is calculated based on the settings forFREQuency:CHANnel and FREQuency:BAND.
Description Specifies whether to enable modulation accuracy (ModAcc)measurements for specified segments. The size of the arraydepends on the currently defined number of segments.
Description Interval, in slots, for the modulation accuracy (ModAcc)measurement. The size of the array depends on the currently definednumber of segments.
Description Specifies whether to enable output radio frequency spectrum(ORFS) measurements for specified segments. The size of thearray depends on the currently defined number of segments.
Description Specifies whether to enable power versus time (PVT)measurements for specified segments. The size of the arraydepends on the currently defined number of segments.
Description Band as defined in section 2 of the 3GPP TS 45.005 v8.0.0specification. for all segments. The size of the array depends on thecurrently defined number of segments.PGSM - Specifies a primary GSM (PGSM) band in the 900 MHzband.EGSM - Specifies an extended GSM (EGSM) band in the 900 MHzband.RGSM - Specifies a railway GSM (RGSM) band in the 900 MHzband.DCS1800 - Specifies a digital cellular system 1800 (DCS 1800)band. This band is also known as GSM 1800.PCS1900 - Specifies a personal communications service 1900 (PCS1900) band. This band is also known as GSM 1900.GSM450 - Specifies a GSM 450 band.GSM480 - Specifies a GSM 480 band.GSM850 - Specifies a GSM 850 band.GSM750 - Specifies a GSM 750 band.T-GSM810 - Specifies a terrestrial GSM 810 (T GSM 810) band.
Description Specifies whether to enable measurement on exception (MOEX).MOEX enables measurements on low quality data. By default,this value is enabled. Disabling MOEX currently applies only tosequenced measurements.
Description Specifies the number of segments in a sequence. You must setthis parameter before setting other sequence-based instrument ormeasurement parameters.
Description Band as defined in section 2 of the 3GPP TS 45.005 v8.0.0specification.PGSM - Primary GSM (PGSM) band in the 900 MHz band.EGSM - Extended GSM (EGSM) band in the 900 MHz band.RGSM - Railway GSM (RGSM) band in the 900 MHz band.DCS1800 - Digital cellular system 1800 (DCS 1800) band. Thisband is also known as GSM 1800.PCS1900 - Personal communications service 1900 (PCS 1900)band. This band is also known as GSM 1900.GSM450 - GSM 450 band.GSM480 - GSM 480 band.GSM850 - GSM 850 band.GSM750 - GSM 750 band.T-GSM810 - Terrestrial GSM 810 (T GSM 810) band.
Description Type of modulation of the signal transmitted by the device.GMSK - Gaussian modulation-shift keying (GMSK) modulationtype. Supported by GSM and EDGE.EPSK - 8 phase-shift keying (PSK) modulation type. This value isvalid only when you set BurstType to NB (normal burst).QPSK - Quadrature-phase shift keying (QPSK) modulation type.This value is valid only when you set BurstType to HB (highersymbol rate burst).Q16 - 16 quadrature-amplitude modulation (QAM) type.Q32 - 32-QAM type.
Datatype Enumeration
Default Value GMSK
Range GMSK | EPSK | QPSK | Q16 | Q32
Parameter: <BurstType>
Description Burst type.NB - Normal burst (NB). Supported by GSM and EDGE.HB - Higher symbol rate burst (HB). Supported by EDGEEvolution.
Datatype Enumeration
Default Value NB
Range NB | HB
Parameter: <FilterWidth>
Description Filter width for the burst.NARR - Narrow filter width.WIDE - Wide filter width.
Description TSC - Applies the training sequence synchronization method toalign the timing of the burst.AMP - Uses the center of the RF envelope to align the timing of theburst. The start and stop of the burst is derived based on the value-20 dB points from the peak of the burst.NONE - Does not perform synchronization. Burst is assumed tooccur at the trigger point.
Description GMSK - Gaussian modulation-shift keying (MSK) modulation type.Supported by GSM and EDGE.EPSK - 8 phase-shift keying (PSK) modulation type. This value isvalid only when you set Burst Type to Normal Burst. Supported byEDGE.QPSK - Quadrature-phase shift keying (QPSK) modulation type.This value is valid only when you set Burst Type to Higher SymbolRate Burst. Supported by EGPRS.Q16 - 16 quadrature-amplitude modulation (QAM) type. Supportedby EGPRS.Q32 - 32-QAM type. Supported by EGPRS.
Description Specifies the training sequence code (TSC) to use for burstsynchronization. Use this command when you set thesynchronization mode to BURST.
Description Fetches average error vector magnitude (EVM) results forEDGE/EGPRS signals. These results are available whenmodulation accuracy (ModAcc) measurements are enabled andmodulation scheme is an EDGE type (8PSK, QPSK, Q16, orQ32).
Description Fetches maximum error vector magnitude (EVM) results forEDGE/EGPRS signals. These results are available whenmodulation accuracy (ModAcc) measurements are enabled andthe modulation scheme is an EDGE type (8PSK, QPSK, Q16, orQ32).
Availability Query
Execution Mode Sequential
Parameter: <RmsEvm>
Description Maximum root mean square (RMS) EVM.
Datatype Double
Unit %
Parameter: <PeakEvm>
Description Maximum peak EVM.
Datatype Double
Unit %
600 | ni.com | WTS Software User Guide
Parameter: <95thPercentileEvm>
Description Maximum EVM value at which no more than 5 percent of the symbolshave an EVM exceeding this value.
Datatype Double
Unit %
Parameter: <PeakEvmSymbol>
Description Number of the symbol that has the peak EVM.
Description Fetches average phase and frequency error results (PFER) forGSM signals. These results are available when modulationaccuracy (ModAcc) measurements are enabled and modulationscheme is GMSK.
Availability Query
Execution Mode Sequential
Parameter: <RmsPhaseError>
Description Average root mean square (RMS) phase error.
Description Fetches maximum phase and frequency error results (PFER) forGSM signals. These results are available when modulationaccuracy (ModAcc) measurements are enabled and modulationscheme is GMSK.
Availability Query
Execution Mode Sequential
604 | ni.com | WTS Software User Guide
Parameter: <RmsPhaseError>
Description Maximum root mean square (RMS) phase error.
Description Fetches maximum error vector magnitude (EVM) results forEDGE/EGPRS signals. These results are available whenmodulation accuracy (ModAcc) measurements are enabled andmodulation scheme is an EDGE type (8PSK, QPSK, Q16, orQ32), for a given segment.
Availability Query
Execution Mode Sequential
Parameter: <RmsEvm>
Description Average root mean square (RMS) EVM.
Datatype Double
Unit %
Parameter: <PeakEvm>
Description Average peak EVM.
Datatype Double
616 | ni.com | WTS Software User Guide
Parameter: <95thPercentileEvm>
Description Average EVM value at which no more than 5 percent of the symbolshave an EVM exceeding this value.
Datatype Double
Unit %
Parameter: <PeakEvmSymbol>
Description Number of the symbol that has the peak EVM.
Description Fetches maximum error vector magnitude (EVM) results forEDGE/EGPRS signals. These results are available whenmodulation accuracy (ModAcc) measurements are enabled andmodulation scheme is an EDGE type (8PSK, QPSK, Q16, orQ32), for a given segment.
Availability Query
Execution Mode Sequential
Parameter: <RmsEvm>
Description Maximum root mean square (RMS) EVM.
Datatype Double
Unit %
Parameter: <PeakEvm>
Description Maximum peak EVM.
Datatype Double
Unit %
Parameter: <95thPercentileEvm>
Description Maximum EVM value at which no more than 5 percent of the symbolshave an EVM exceeding this value.
Description Fetches minimum error vector magnitude (EVM) results forEDGE/EGPRS signals. These results are available whenmodulation accuracy measurements (ModAcc) are enabled andmodulation scheme is an EDGE type (8PSK, QPSK, Q16, orQ32), for a given segment.
Availability Query
Execution Mode Sequential
Parameter: <RmsEvm>
Description Minimum root mean square (RMS) EVM.
Datatype Double
Unit %
Parameter: <PeakEvm>
Description Minimum peak EVM.
Datatype Double
Parameter: <95thPercentileEvm>
Description Minimum EVM value at which no more than 5 percent of the symbolshave an EVM exceeding this value.
Datatype Double
Unit %
622 | ni.com | WTS Software User Guide
Parameter: <PeakEvmSymbol>
Description Number of the symbol that has the peak EVM.
Description Fetches average phase and frequency error results (PFER) forGSM signals. These results are available when modulationaccuracy (ModAcc) measurements are enabled and modulationscheme is GMSK, for a given segment.
Availability Query
Execution Mode Sequential
624 | ni.com | WTS Software User Guide
Parameter: <RmsPhaseError>
Description Average root mean square (RMS) phase error.
Description Fetches maximum phase and frequency error results (PFER) forGSM signals. These results are available when modulationaccuracy (ModAcc) measurements are enabled and modulationscheme is GMSK, for a given segment.
Availability Query
Execution Mode Sequential
Parameter: <RmsPhaseError>
Description Maximum root mean square (RMS) phase error.
Description Fetches maximum phase and frequency error results (PFER) forGSM signals. These results are available when modulationaccuracy (ModAcc) measurements are enabled and modulationscheme is GMSK, for a given segment.
Availability Query
Execution Mode Sequential
Parameter: <RmsPhaseError>
Description Minimum root mean square (RMS) phase error.
Datatype Double
Unit deg
Parameter: <PeakPhaseError>
Description Minimum peak phase error.
628 | ni.com | WTS Software User Guide
Datatype Double
Unit deg
Parameter: <FrequencyError>
Description Minimum frequency error.
Datatype Double
Unit Hz
Parameter: <OriginOffset>
Description Minimum origin offset.
Datatype Double
Unit dB
Parameter: <IqGainImbalance>
Description Minimum I/Q imbalance.
Datatype Double
Unit dB
Parameter: <DetectedTsc>
Description Training sequence (TSC) detected while performing ModAccmeasurements.
Description OFF: The measurement has not been initiated yet.
READY: The measurement result is available to fetch.
PENDING: The measurement is initiated but has not started receivingdata to process.
PROCESSING: The measurement is processing the acquired data.
Datatype Enumeration
Parameter: <MeasurementState>
Description OFF: The measurement has not been initiated yet.READY: The measurement result is available to fetch.PENDING: The measurement is initiated but has not started receivingdata to process.PROCESSING: The measurement is processing the acquired data.
Datatype Enumeration
INITiate:RFSA:GSM<i>[:RESults<i>]
Usage:INITiate:RFSA:GSM<i>[:RESults<i>]
644 | ni.com | WTS Software User Guide
Description Initiates composite GSM/EDGE measurement and stores theresults in the result space provided in [:Result<i>].
Availability Command
Execution Mode Sequential
INITiate:RFSA:GSM<i>:ALEVel
Usage:INITiate:RFSA:GSM<i>:ALEVel
Description This command blocks the instrument until the AutoLevel taskcompletes.
Description Minimum quiet time. The signal is quiet when it is below the triggerlevel when you set the EDGE property to RISING, or above thetrigger level when you set the EDGE property to FALLING.
Description IMMEDIATE - Generates the signal to measure as soon as thehardware is ready.POWER - Uses the RF power edge trigger.INTERNAL - Uses one of the multiple WTS internal triggers, whichmust be exported by any other personality configured to use thesame Port. Portname must be defined before this command isexecuted.
Description Specifies the trigger threshold to use when power triggering. Thisvalue is referenced to the unit under test (UUT) port, accountingfor external attenuation.
Description RMS - Averages the measured power.LOG - Averages the log of the measured power.SCALAR - Averages the measured voltage.MAX - Averages the maximum measured values.MIN - Averages the minimum measured values.VECTOR - Averages the I/Q values.
Description FRAME: Measures a specific slot on an acquired frame, dependenton the offset and duration in slots.SLOT: Measures a random selection of slots, dependent on themeasurement duration in slots.ARBITRARY: Measures a given number of chips, dependent on themeasurement duration in slots.AUTO: Selects the above Measurement Modes automatically basedon Trigger Settings.
Radio Configuration Associated Spreading Rate Data Rates,Forward Error Correction, and General Characteristics1 1 1200, 2400, 4800, and 9600 bps data rates with R = 1=3, 64-aryorthogonal modulation2 1 1800, 3600, 7200, and 14400 bps data rates with R = 1=2, 64-ary orthogonal modulation3 1 1200, 1350, 1500, 2400, 2700, 4800, 9600, 19200, 38400,76800, and 153600 bps data rates with R = 1/4, 307200 bps data ratewith R = 1/2, BPSK modulation with a pilot4 1 1800, 3600, 7200, 14400, 28800, 57600, 115200, and 230400bps data rates with R = 1/4, BPSK modulation with a pilot5 3 1200, 1350, 1500, 2400, 2700, 4800, 9600, 19200, 38400,76800, and 153600 bps data rates with R = 1/4, 307200 and 614400bps data rate with R = 1/3, BPSK modulation with a pilot6 3 1800, 3600, 7200, 14400, 28800, 57600, 115200, 230400, and460800 bps data rates with R = 1/4, 1036800 bps data rate with R =1/2, BPSK modulation with a pilot
Description RMS - The power is averaged using Root-Mean-Square.LOG - Averages the log of the measured power.SCALAR - Averages the measured voltage.MAX - Averages the maximum measured values.MIN - Averages the minimum measured values.VECTOR - Averages the I/Q values.
Description RMS - The power is averaged using Root-Mean-Square.LOG - Averages the log of the measured power.SCALAR - Averages the measured voltage.MAX - Averages the maximum measured values.MIN - Averages the minimum measured values.VECTOR - Averages the I/Q values.
Description RMS - The power is averaged using Root-Mean-Square.LOG - Averages the log of the measured power.SCALAR - Averages the measured voltage.MAX - Averages the maximum measured values.MIN - Averages the minimum measured values.VECTOR - Averages the I/Q values.
Description Band class 0 / 800Block Mobile Station Base Station Bandwidth UL / DLA0 824.025 835.005 869.025 880.005 11A0+ 844.995 846.495 889.995 891.495 2A1 824.025 835.005 869.025 880.005 11A1+ 844.995 848.985 889.995 893.985 4A2 824.025 829.995 869.025 874.995 6A3 815.025 829.995 860.025 874.995 15B0 835.005 844.995 880.005 889.995 10B0+ 846.495 848.985 891.495 893.985 2B1 835.005 844.995 880.005 889.995 10
Band class 1 / 1900 PCSBlock Mobile Station Base Station Bandwidth UL / DLA 1850 1865 1930 1945 15D 1865 1870 1945 1950 5B 1870 1885 1950 1965 15E 1885 1890 1965 1970 5F 1890 1895 1970 1975 5C 1895 1910 1975 1990 15
Band class 2 / TACSBlock Mobile Station Base Station Bandwidth UL / DLA 872.0125 879.9875 917.0125 924.9875 8A+ 890.0125 897.4875 935.0125 942.4875 7A++ 905.0125 908.9875 950.0125 953.9875 4B 880.0125 887.9875 925.0125 932.9875 8B+ 897.5125 904.9875 942.5125 949.9875 7B++ 909.0125 914.9875 954.0125 959.9875 6ATG 894 895.5 849 850.5 2
Band class 3 / JTACSBlock Mobile Station Base Station Bandwidth UL / DLA 887.0125 888.9875 832.0125 833.9875 2A+ 893.0125 898 838.0125 843 5A++ 898.0125 900.9875 843.0125 845.9875 3A+++ 915.0125 924.9875 860.0125 869.9875 10
Band class 4 / Korean PCSBlock Mobile Station Base Station Bandwidth UL / DLA 1750 1760 1840 1850 10B 1760 1770 1850 1860 10C 1770 1780 1860 1870 10
Band class 5 / 450Block Mobile Station Base Station Bandwidth UL / DLA 452.5 457.475 462.5 467.475 5B 452 456.475 462 466.475 4C 450 454.8 460 464.8 5D 411.675 415.85 421.675 425.85 4E 415.5 419.975 425.5 429.975 4F 479 483.48 489 493.48 4G 455.23 459.99 465.23 469.99 5H 451.31 455.73 461.31 465.73 4I 451.325 455.725 461.325 465.725 4J 455.25 459.975 465.25 469.975 5K 479 483.475 489 493.475 4L 410 414.975 420 424.975 5M 450 457.475 461.25 469.975 7 / 9N 450 457.475 460 469.975 7 / 10
Band class 6 / 2 GHzBlock Mobile Station Base Station Bandwidth UL / DLLow, not valid 1920 1922.45 2110 2112.45 2SR1 1922.5 1977.5 2112.5 2167.5 55High, not valid 1977.55 1979.95 2167.55 2169.95 2
Band class 7 / 700 MHz UpperBlock Mobile Station Base Station Bandwidth UL / DLC 776 787 746 757 11A 787 788 757 758 1
Band class 8 / 1800Block Mobile Station Base Station Bandwidth UL / DLLow, not valid 1710 1711.2 1805 1806.2 1SR1 1711.25 1783.75 1806.25 1878.75 73High, not valid 1783.8 1784.95 1878.8 1879.95 1
Band class 9 / 900Block Mobile Station Base Station Bandwidth UL / DLLow, not valid 880 881.2 925 926.2 1SR1 881.25 913.75 926.25 958.75 33High, not valid 913.8 914.95 958.8 959.95 1
Band class 10 / Secondary 800 MHzBlock Mobile Station Base Station Bandwidth UL / DLA 806 810.975 851 855.975 5B 811 815.975 856 860.975 5C 816 820.975 861 865.975 5D 821 823.975 866 868.975 3E 896 900.975 935 939.975 5
Band class 11 / 400 MHz European PAMRBlock Mobile Station Base Station Bandwidth UL / DLA 452.5 457.475 462.5 467.475 5B 452 456.475 462 466.475 4C 450 454.8 460 464.8 5D 411.675 415.85 421.675 425.85 4E 415.5 419.975 425.5 429.975 4I 451.325 455.725 461.325 465.725 4J 455.25 459.975 465.25 469.975 5K 479 483.475 489 493.475 4L 410 414.975 420 424.975 5
Band class 12 / 800 MHz PAMRBlock Mobile Station Base Station Bandwidth UL / DLA,C 870.0125 875.9875 915.0125 920.9875 6B 871.5125 874.4875 916.5125 919.4875 3
Band class 14 / US PCS 1.9 GHzBlock Mobile Station Base Station Bandwidth UL / DLA 1850 1865 1930 1945 15D 1865 1870 1945 1950 5B 1870 1885 1950 1965 15E 1885 1890 1965 1970 5F 1890 1895 1970 1975 5C 1895 1910 1975 1990 15G 1910 1915 1990 1995 5
Band class 15 / AWSBlock Mobile Station Base Station Bandwidth UL / DLA 1710 1720 2110 2120 10B 1720 1730 2120 2130 10C 1730 1735 2130 2135 5D 1735 1740 2135 2140 5E 1740 1745 2140 2145 5F 1745 1755 2145 2155 10
Description Enable or disable ACP measurements per segment of the sequence.The size of the array depends on the currently defined number ofsegments.0 | OFF: Disables the ACP measurement.1 | ON: Enables the ACP measurement.
Description Enable or disable ModAcc measurements per segment of thesequence. The size of the array depends on the currently definednumber of segments.0 | OFF: Disables the ModAcc measurement.1 | ON: Enables the ModAcc measurement.
Description Enable or disable OBW measurements per segment of the sequence.The size of the array depends on the currently defined number ofsegments.0 | OFF: Disables the OBW measurement.1 | ON: Enables the OBW measurement.
Description Enable or disable SEM measurements per segment of the sequence.The size of the array depends on the currently defined number ofsegments.0 | OFF: Disables the SEM measurement.1 | ON: Enables the SEM measurement.
Description Enable or disable TXP measurements per segment of the sequence.The size of the array depends on the currently defined number ofsegments.0 | OFF: Disables the TXP measurement.1 | ON: Enables the TXP measurement.
Description The sequence duration array contains the duration of each segmentof the sequence. The size of the array depends on the currentlydefined number of segments.
Description Specifies the external attenuation for all segments in thesequence. External attenuation is applied on top of anyattenuation provided for the specified port.
Description Channel value per segment. The size of the array depends on thecurrently defined number of segments.
Band class 0 / 800Block Mobile Station Base Station Bandwidth UL / DLA0 824.025 835.005 869.025 880.005 11A0+ 844.995 846.495 889.995 891.495 2A1 824.025 835.005 869.025 880.005 11A1+ 844.995 848.985 889.995 893.985 4A2 824.025 829.995 869.025 874.995 6A3 815.025 829.995 860.025 874.995 15B0 835.005 844.995 880.005 889.995 10B0+ 846.495 848.985 891.495 893.985 2B1 835.005 844.995 880.005 889.995 10
Band class 1 / 1900 PCSBlock Mobile Station Base Station Bandwidth UL / DLA 1850 1865 1930 1945 15D 1865 1870 1945 1950 5B 1870 1885 1950 1965 15E 1885 1890 1965 1970 5F 1890 1895 1970 1975 5C 1895 1910 1975 1990 15
Band class 2 / TACSBlock Mobile Station Base Station Bandwidth UL / DLA 872.0125 879.9875 917.0125 924.9875 8A+ 890.0125 897.4875 935.0125 942.4875 7A++ 905.0125 908.9875 950.0125 953.9875 4B 880.0125 887.9875 925.0125 932.9875 8B+ 897.5125 904.9875 942.5125 949.9875 7B++ 909.0125 914.9875 954.0125 959.9875 6ATG 894 895.5 849 850.5 2
Band class 3 / JTACSBlock Mobile Station Base Station Bandwidth UL / DLA 887.0125 888.9875 832.0125 833.9875 2A+ 893.0125 898 838.0125 843 5A++ 898.0125 900.9875 843.0125 845.9875 3A+++ 915.0125 924.9875 860.0125 869.9875 10
Band class 4 / Korean PCSBlock Mobile Station Base Station Bandwidth UL / DLA 1750 1760 1840 1850 10B 1760 1770 1850 1860 10C 1770 1780 1860 1870 10
Band class 5 / 450Block Mobile Station Base Station Bandwidth UL / DLA 452.5 457.475 462.5 467.475 5B 452 456.475 462 466.475 4C 450 454.8 460 464.8 5D 411.675 415.85 421.675 425.85 4E 415.5 419.975 425.5 429.975 4F 479 483.48 489 493.48 4G 455.23 459.99 465.23 469.99 5H 451.31 455.73 461.31 465.73 4I 451.325 455.725 461.325 465.725 4J 455.25 459.975 465.25 469.975 5K 479 483.475 489 493.475 4L 410 414.975 420 424.975 5M 450 457.475 461.25 469.975 7 / 9N 450 457.475 460 469.975 7 / 10
Band class 6 / 2 GHzBlock Mobile Station Base Station Bandwidth UL / DLLow, not valid 1920 1922.45 2110 2112.45 2SR1 1922.5 1977.5 2112.5 2167.5 55High, not valid 1977.55 1979.95 2167.55 2169.95 2
Band class 7 / 700 MHz UpperBlock Mobile Station Base Station Bandwidth UL / DLC 776 787 746 757 11A 787 788 757 758 1
Band class 8 / 1800Block Mobile Station Base Station Bandwidth UL / DLLow, not valid 1710 1711.2 1805 1806.2 1SR1 1711.25 1783.75 1806.25 1878.75 73High, not valid 1783.8 1784.95 1878.8 1879.95 1
Band class 9 / 900Block Mobile Station Base Station Bandwidth UL / DLLow, not valid 880 881.2 925 926.2 1SR1 881.25 913.75 926.25 958.75 33High, not valid 913.8 914.95 958.8 959.95 1
Band class 10 / Secondary 800 MHzBlock Mobile Station Base Station Bandwidth UL / DLA 806 810.975 851 855.975 5B 811 815.975 856 860.975 5C 816 820.975 861 865.975 5D 821 823.975 866 868.975 3E 896 900.975 935 939.975 5
Band class 11 / 400 MHz European PAMRBlock Mobile Station Base Station Bandwidth UL / DLA 452.5 457.475 462.5 467.475 5B 452 456.475 462 466.475 4C 450 454.8 460 464.8 5D 411.675 415.85 421.675 425.85 4E 415.5 419.975 425.5 429.975 4I 451.325 455.725 461.325 465.725 4J 455.25 459.975 465.25 469.975 5K 479 483.475 489 493.475 4L 410 414.975 420 424.975 5
Band class 12 / 800 MHz PAMRBlock Mobile Station Base Station Bandwidth UL / DLA,C 870.0125 875.9875 915.0125 920.9875 6B 871.5125 874.4875 916.5125 919.4875 3
Band class 14 / US PCS 1.9 GHzBlock Mobile Station Base Station Bandwidth UL / DLA 1850 1865 1930 1945 15D 1865 1870 1945 1950 5B 1870 1885 1950 1965 15E 1885 1890 1965 1970 5F 1890 1895 1970 1975 5C 1895 1910 1975 1990 15G 1910 1915 1990 1995 5
Band class 15 / AWSBlock Mobile Station Base Station Bandwidth UL / DLA 1710 1720 2110 2120 10B 1720 1730 2120 2130 10C 1730 1735 2130 2135 5D 1735 1740 2135 2140 5E 1740 1745 2140 2145 5F 1745 1755 2145 2155 10
Description Specifies whether to enable the measurement on exception(MOEX). MOEX enables measurements on low quality data. Bydefault, MOEX is enabled. Disabling MOEX currently appliesonly to sequenced measurements.
Description Specifies the number of segments in a sequence. You must setthis parameter before setting other sequence-based instrument ormeasurement parameters.
Description Band class 0 / 800Block Mobile Station Base Station Bandwidth UL / DLA0 824.025 835.005 869.025 880.005 11A0+ 844.995 846.495 889.995 891.495 2A1 824.025 835.005 869.025 880.005 11A1+ 844.995 848.985 889.995 893.985 4A2 824.025 829.995 869.025 874.995 6A3 815.025 829.995 860.025 874.995 15B0 835.005 844.995 880.005 889.995 10B0+ 846.495 848.985 891.495 893.985 2B1 835.005 844.995 880.005 889.995 10
Band class 1 / 1900 PCSBlock Mobile Station Base Station Bandwidth UL / DLA 1850 1865 1930 1945 15D 1865 1870 1945 1950 5B 1870 1885 1950 1965 15E 1885 1890 1965 1970 5F 1890 1895 1970 1975 5C 1895 1910 1975 1990 15
Band class 2 / TACSBlock Mobile Station Base Station Bandwidth UL / DLA 872.0125 879.9875 917.0125 924.9875 8A+ 890.0125 897.4875 935.0125 942.4875 7A++ 905.0125 908.9875 950.0125 953.9875 4B 880.0125 887.9875 925.0125 932.9875 8B+ 897.5125 904.9875 942.5125 949.9875 7B++ 909.0125 914.9875 954.0125 959.9875 6ATG 894 895.5 849 850.5 2
Band class 3 / JTACSBlock Mobile Station Base Station Bandwidth UL / DLA 887.0125 888.9875 832.0125 833.9875 2A+ 893.0125 898 838.0125 843 5A++ 898.0125 900.9875 843.0125 845.9875 3A+++ 915.0125 924.9875 860.0125 869.9875 10
Band class 4 / Korean PCSBlock Mobile Station Base Station Bandwidth UL / DLA 1750 1760 1840 1850 10B 1760 1770 1850 1860 10C 1770 1780 1860 1870 10
Band class 5 / 450Block Mobile Station Base Station Bandwidth UL / DLA 452.5 457.475 462.5 467.475 5B 452 456.475 462 466.475 4C 450 454.8 460 464.8 5D 411.675 415.85 421.675 425.85 4E 415.5 419.975 425.5 429.975 4F 479 483.48 489 493.48 4G 455.23 459.99 465.23 469.99 5H 451.31 455.73 461.31 465.73 4I 451.325 455.725 461.325 465.725 4J 455.25 459.975 465.25 469.975 5K 479 483.475 489 493.475 4L 410 414.975 420 424.975 5M 450 457.475 461.25 469.975 7 / 9N 450 457.475 460 469.975 7 / 10
Band class 6 / 2 GHzBlock Mobile Station Base Station Bandwidth UL / DLLow, not valid 1920 1922.45 2110 2112.45 2SR1 1922.5 1977.5 2112.5 2167.5 55High, not valid 1977.55 1979.95 2167.55 2169.95 2
Band class 7 / 700 MHz UpperBlock Mobile Station Base Station Bandwidth UL / DLC 776 787 746 757 11A 787 788 757 758 1
Band class 8 / 1800Block Mobile Station Base Station Bandwidth UL / DLLow, not valid 1710 1711.2 1805 1806.2 1SR1 1711.25 1783.75 1806.25 1878.75 73High, not valid 1783.8 1784.95 1878.8 1879.95 1
Band class 9 / 900Block Mobile Station Base Station Bandwidth UL / DLLow, not valid 880 881.2 925 926.2 1SR1 881.25 913.75 926.25 958.75 33High, not valid 913.8 914.95 958.8 959.95 1
Band class 10 / Secondary 800 MHzBlock Mobile Station Base Station Bandwidth UL / DLA 806 810.975 851 855.975 5B 811 815.975 856 860.975 5C 816 820.975 861 865.975 5D 821 823.975 866 868.975 3E 896 900.975 935 939.975 5
Band class 11 / 400 MHz European PAMRBlock Mobile Station Base Station Bandwidth UL / DLA 452.5 457.475 462.5 467.475 5B 452 456.475 462 466.475 4C 450 454.8 460 464.8 5D 411.675 415.85 421.675 425.85 4E 415.5 419.975 425.5 429.975 4I 451.325 455.725 461.325 465.725 4J 455.25 459.975 465.25 469.975 5K 479 483.475 489 493.475 4L 410 414.975 420 424.975 5
Band class 12 / 800 MHz PAMRBlock Mobile Station Base Station Bandwidth UL / DLA,C 870.0125 875.9875 915.0125 920.9875 6B 871.5125 874.4875 916.5125 919.4875 3
Band class 14 / US PCS 1.9 GHzBlock Mobile Station Base Station Bandwidth UL / DLA 1850 1865 1930 1945 15D 1865 1870 1945 1950 5B 1870 1885 1950 1965 15E 1885 1890 1965 1970 5F 1890 1895 1970 1975 5C 1895 1910 1975 1990 15G 1910 1915 1990 1995 5
Band class 15 / AWSBlock Mobile Station Base Station Bandwidth UL / DLA 1710 1720 2110 2120 10B 1720 1730 2120 2130 10C 1730 1735 2130 2135 5D 1735 1740 2135 2140 5E 1740 1745 2140 2145 5F 1745 1755 2145 2155 10
Description If disabled, no trace data is collected so no traces can be fetched.0 | OFF: Disables collection of trace data.1 | ON: Enables collection of trace data.
Description Specifies the minimum time for which the signal must be quietbefore the device arms the trigger. The signal is quiet when it isbelow the trigger level when you set the EDGE property toRISING, or above the trigger level when you set the EDGEproperty to FALLING.
Description IMMEDIATE - Generates the signal to measure as soon as thehardware is ready.POWER - Uses the RF power edge trigger.INTERNAL - Uses one of the multiple WTS internal triggers, whichmust be exported by any other personality configured to use thesame Port. Portname must be defined before this command isexecuted.
Description Specifies the trigger threshold to use when power triggering. Thisvalue is referenced to the unit under test (UUT) port, accountingfor external attenuation.
Description RMS - Averages the measured power.LOG - Averages the log of the measured power.SCALAR - Averages the measured voltage.MAX - Averages the maximum measured values.MIN - Averages the minimum measured values.VECTOR - Averages the I/Q values.
Description Length in percentage points of the cyclix prefix (CP). Onecorresponds to the smallest CP window, while 100 corresponds touse the entire window.The offset plus length should not surpass 100.
Description Offset in percentage points of the cyclix prefix (CP). Zerocorresponds to the beginning of the CP, while 100 corresponds tothe end.The offset plus length should not surpass 100.
Description 3GPP: Computes two EVM numbers with high offset and low offsetand returns the maximum EVM found.CUSTOM: Based on the offset and length values, computes onlyone EVM number.
Description FRAME: Measures a specific slot on an acquired frame, dependenton the offset and duration in slots.SLOT: Measures a random selection of slots, dependent on themeasurement duration in slots.ARBITRARY: Measures a given number of chips, dependent on themeasurement duration in slots.AUTO: Automatically selects a measurement mode based on triggersettings.
Description 0 | OFF: Disables auto detection of channel configuration, allocatedresource blocks, and modulation scheme.1 | ON: Enables auto detection of channel configuration, allocatedresource blocks, and modulation scheme.
Description Specifies whether to enable the measurement on exception(MOEX). MOEX enables measurements on low quality data. Bydefault, MOEX is enabled. Disabling MOEX currently appliesonly to sequenced measurements.
Description RMS - Averages the measured power.LOG - Averages the log of the measured power.SCALAR - Averages the measured voltage.MAX - Averages the maximum measured values.MIN - Averages the minimum measured values.VECTOR - Averages the I/Q values.
Description RMS - Averages the measured power.LOG - Averages the log of the measured power.SCALAR - Averages the measured voltage.MAX - Averages the maximum measured values.MIN - Averages the minimum measured values.MAXMIN - Averages the maximum and minimum measuredvalues.
Description RMS - Averages the measured power.LOG - Averages the log of the measured power.SCALAR - Averages the measured voltage.MAX - Averages the maximum measured values.MIN - Averages the minimum measured values.VECTOR - Averages the I/Q values.
Description RMS - Averages the measured power.LOG - Averages the log of the measured power.SCALAR - Averages the measured voltage.MAX - Averages the maximum measured values.MIN - Averages the minimum measured values.
Description FDD: Direction is uplink (UL) and the duplexing technique isfrequency-division duplexing (FDD) for the analyzed signal.TDD: Direction is UL and the duplexing technique is time-divisionduplexing (TDD) for the analyzed signal.
Description Specifies the external attenuation for all segments in thesequence. External attenuation is applied on top of anyattenuation provided for the specified port.
Description Duration of each segment of the sequence, in slots. The size of thearray depends on the currently defined number of segments. Themaximum number of slots for the entire sequence is 60,000 (30s).
Description The size of the array depends on the currently defined number ofsegments.0 | OFF: Disables ACP measurements.1 | ON: Enables ACP measurements.
Description The size of the array depends on the currently defined number ofsegments.0 | OFF: Disables ModAcc measurements.1 | ON: Enables ModAcc measurements.
Description The size of the array depends on the currently defined number ofsegments.0 | OFF: Disables OBW measurements.1 | ON: Enables OBW measurements.
Description The size of the array depends on the currently defined number ofsegments.0 | OFF: Disables power dynamics measurements.1 | ON: Enables power dynamics measurements.
Description The size of the array depends on the currently defined number ofsegments.0 | OFF: Disables SEM measurements.1 | ON: Enables SEM measurements.
Description The size of the array depends on the currently defined number ofsegments.0 | OFF: Disables TXP measurements.1 | ON: Enables TXP measurements.
Description Specifies the number of segments in a sequence. You must setthis parameter before setting other sequence-based instrument ormeasurement parameters.
Description Fetches the average of spectral emission mask (SEM) results formeasurements that satisfy the specified mask limits.
Availability Query
Execution Mode Sequential
Parameter: <SemCompositeMaskStatus>
Description Indicates the status of the SEM based on the specified mask limits.0: Measurement results do not satisfy the specified mask limits (fail).1: Measurement results satisfy the specified mask limits (pass).
Datatype Boolean
Parameter: <WorstMargin>
Description Average power at the frequency where the worst margin occurs.
Datatype Double
Unit dB
890 | ni.com | WTS Software User Guide
Parameter: <WorstMarginFrequency>
Description Frequency where the worst margin occurs.
Datatype Double
Unit Hz
Parameter: <SemTotalCarrierPower>
Description Average total carrier power of the reference channel for the specifiedintegration bandwidth.
Description Status of the SEM measurement based on the specified mask limits.0: Measurement results do not satisfy the specified mask limits (fail).1: Measurement results satisfy the specified mask limits (pass).
Datatype Boolean
Parameter: <WorstMargin>
Description Maximum power at the frequency where the worst margin occurs.
Datatype Double
Unit dB
Parameter: <WorstMarginFrequency>
Description Frequency where the worst margin occurs.
Datatype Double
Unit Hz
Parameter: <SemTotalCarrierPower>
Description Maximum total carrier power of the reference channel for thespecified integration bandwidth.
Description Fetches the minimum of spectral emission mask (SEM) resultsfor measurements that satisfy the specified mask limits.
Availability Query
Execution Mode Sequential
Parameter: <SemCompositeMaskStatus>
Description Indicates the status of the SEM measurement based on the specifiedmask limits.0: Measurement results do not satisfy the specified mask limits (fail).1: Measurement results satisfy the specified mask limits (pass).
Datatype Boolean
Parameter: <WorstMargin>
Description Minimum power at the frequency where the worst margin occurs.
Datatype Double
Unit dB
Parameter: <WorstMarginFrequency>
Description Frequency where the worst margin occurs.
Description IDLE: Hardware is available.PENDING: Execution is waiting for hardware to be released.ACTIVE: Hardware is actively acquiring data.
Datatype Enumeration
Parameter: <MeasurementState>
Description OFF: The measurement has not been initiated yet.READY: The measurement result is available to fetch.PENDING: The measurement is initiated but has not started receiveddata to process.PROCESSING: The measurement is processing the acquired data.
Description Minimum quiet time. The signal is quiet when it is below the triggerlevel if you set the EDGE property to RISING, or above the triggerlevel if you set the EDGE property to FALLING.
Description IMMEDIATE - Generates the signal to measure as soon as thehardware is ready.POWER - Uses the RF power edge trigger.INTERNAL - Uses one of the multiple WTS internal triggers, whichmust be exported by any other personality configured to use thesame Port. Portname must be defined before this command isexecuted.
Description Specifies the trigger threshold to use when power triggering. Thisvalue is referenced to the unit under test (UUT) port, accountingfor external attenuation.
Description RMS - The power is averaged using root mean square (RMS).LOG - The log of the power is averaged.SCALAR - The voltage is averaged.MAX - The maximum values are retained.MIN - The minimum values are retained.VECTOR - I/Q values are averaged.
Description RMS - The power is averaged using root mean square (RMS).LOG - The log of the power is averaged.SCALAR - The voltage is averaged.MAX - The maximum values are retained.MIN - The minimum values are retained.VECTOR - I/Q values are averaged.
Description RMS - Averages the measured power.LOG - Averages the log of the measured power.SCALAR - Averages the measured voltage.MAX - Averages the maximum measured values.MIN - Averages the minimum measured values.MAXMIN - Averages the maximum and minimum measuredvalues.
Description RMS - The power is averaged using root mean square (RMS).LOG - The log of the power is averaged.SCALAR - The voltage is averaged.MAX - The maximum values are retained.MIN - The minimum values are retained.VECTOR - I/Q values are averaged.
Description RMS - Averages the measured power.LOG - Averages the log of the measured power.SCALAR - Averages the measured voltage.MAX - Averages the maximum measured values.MIN - Averages the minimum measured values.
Description Specifies whether to enable adjacent channel power (ACP)measurements for all segments of the sequence. The size of thearray depends on the currently defined number of segments.
Description Specifies whether to enable modulation accuracy (ModAcc)measurements for all segments of the sequence. The size of thearray depends on the currently defined number of segments.
Description Specifies whether to enable occupied bandwidth (OBW)measurements for all segments of the sequence. The size of thearray depends on the currently defined number of segments.
Description Specifies whether to enable spectral emissions mask (SEM)measurements for all segments of the sequence. The size of thearray depends on the currently defined number of segments
Description Specifies whether to enable transmit power (TXP) measurementsfor all segments of the sequence. The size of the array depends onthe currently defined number of segments.
Description Segment duration in TD-SCDMA subframes (5 ms) for all definedsegments. The size of the array depends on the currently definednumber of segments.
Description Specifies the external attenuation for all segments in thesequence. External attenuation is applied on top of anyattenuation provided for the specified port.
Description Specifies the number of segments in a sequence. You must setthis parameter before setting other sequence-based instrument ormeasurement parameters.
Description Number of slots by which to offset the start of the measurementinterval for each measurement in a segment. The size of the arraydepends on the currently defined number of segments.
Description Average of I/Q origin offset measurements.
Datatype Double
Unit dB
Parameter: <FrequencyOffset>
Description Average of frequency error measurements.
Datatype Double
Unit Hz
Parameter: <TimingOffset>
Description Timing offset of the configured EVM measurement channel withrespect to the start of frame. You can query this parameter only if theUUT Type is set to BS and the channel type is DPCH. WTS returns -1for other channels.
Description Average of I/Q origin offset measurements.
Datatype Double
Unit dB
Parameter: <FrequencyOffset>
Description Average of frequency error measurements.
Datatype Double
Unit Hz
Parameter: <TimingOffset>
Description Timing offset of the configured EVM measurement channel withrespect to the start of frame. You can query this parameter only if theUUT Type is set to BS and the channel type is DPCH. WTS returns -1for other channels.
Datatype Double
Unit chips
996 | ni.com | WTS Software User Guide
Parameter: <DataPowerField1>
Description Average power measured in Data field 1.
Datatype Double
Unit dBm
Parameter: <DataPowerField2>
Description Average power measured in Data field 2.
Datatype Double
Unit dBm
Parameter: <MidamblePower>
Description Average power measured in the midamble field.
Description Maximum of I/Q origin offset measurements.
Datatype Double
Unit dB
Parameter: <FrequencyOffset>
Description Maximum of frequency error measurements.
Datatype Double
Unit Hz
Parameter: <TimingOffset>
Description Timing offset of the configured EVM measurement channel withrespect to the start of frame. You can query this parameter only if theUUT Type is set to BS and the channel type is DPCH. WTS returns -1for other channels.
Datatype Double
Unit chips
Parameter: <DataPowerField1>
Description Maximum power measured in Data field 1.
998 | ni.com | WTS Software User Guide
Datatype Double
Unit dBm
Parameter: <DataPowerField2>
Description Maximum power measured in Data field 2.
Datatype Double
Unit dBm
Parameter: <MidamblePower>
Description Maximum power measured in the midamble field.
Description Minimum of I/Q origin offset measurements.
Datatype Double
Unit dB
Parameter: <FrequencyOffset>
Description Minimum of frequency error measurements.
Datatype Double
Unit Hz
Parameter: <TimingOffset>
Description Timing offset of the configured EVM measurement channel withrespect to the start of frame. You can query this parameter only if theUUT Type is set to BS and the channel type is DPCH. WTS returns -1for other channels.
Datatype Double
Unit chips
Parameter: <DataPowerField1>
Description Minimum power measured in Data field 1.
Datatype Double
Unit dBm
1000 | ni.com | WTS Software User Guide
Parameter: <DataPowerField2>
Description Minimum power measured in Data field 2.
Datatype Double
Unit dBm
Parameter: <MidamblePower>
Description Minimum power measured in the midamble field.
Description Slot power returns the power of each slot measured in thissegment. This helps to debug any issues related to any specificslot within the segment. This is also used for any slot powermeasurement specific.
Description IDLE: Hardware is available.PENDING: Execution is waiting for hardware to be released.ACTIVE: Hardware is actively acquiring data.
Datatype Enumeration
Parameter: <MeasurementState>
Description OFF: The measurement has not been initiated yet.READY: The measurement result is available to fetch.PENDING: The measurement is initiated but has not started receivingdata to process.PROCESSING: The measurement is processing the acquired data.
Description Minimum quiet time. The signal is quiet when it is below the triggerlevel when you set the EDGE property to RISING, or above thetrigger level when you set the EDGE property to FALLING.
Description IMMEDIATE - Generates the signal to measure as soon as thehardware is ready.POWER - Uses RF power edge trigger.INTERNAL - Uses one of the multiple WTS internal triggers, whichmust be exported by any other personality configured to use thesame Port. Portname must be defined before this command isexecuted.
Description Specifies the trigger threshold to use when power triggering. Thisvalue is referenced to the unit under test (UUT) port, accountingfor external attenuation.
Description Maximum time from when the execution has been committed tohardware until the specified trigger event must occur.Time during which the execution is pending hardware is notincluded in the timeout counter.
Datatype Double
Default Value 5.000E+000
Range [0.000E+000:1.000E+003]
Unit sec
WCDMA Instrument PersonalityUse the WCDMA instrument personality to analyze WCDMA/HSPA+ signals that conform tothe 3GPP specifications.
This manual assumes that you are familiar with the 3GPP specifications.
WCDMA Signal Analyzer SCPI Command ListComplete list of WCDMA signal analyzer SCPI commands.
Description RMS - Averages the measured power.LOG - Averages the log of the measured power.SCALAR - Averages the measured voltage.MAX - Averages the maximum measured values.MIN - Averages the minimum measured values.VECTOR - Averages the I/Q values.
Description FRAME: Measures a specific slot on an acquired frame, dependenton the offset and duration in slots.SLOT: Measures a random selection of slots, dependent on themeasurement duration in slots.ARBITRARY: Measures a given number of chips, dependent on themeasurement duration in slots.MARKER: Bases analysis on a marker on the generated waveform.You must also configure the signal generator for marker mode to usethis setting.AUTO: Automatically selects the appropriate measurement modebased on trigger settings.
Description RMS - Averages the measured power.LOG - Averages the log of the measured power.SCALAR - Averages the measured voltage.MAX - Averages the maximum measured values.MIN - Averages the minimum measured values.VECTOR - Averages the I/Q values.
Description RMS - Averages the measured power.LOG - Averages the log of the measured power.SCALAR - Averages the measured voltage.MAX - Averages the maximum measured values.MIN - Averages the minimum measured values.VECTOR - Averages the I/Q values.
Description RMS - Averages the measured power.LOG - Averages the log of the measured power.SCALAR - Averages the measured voltage.MAX - Averages the maximum measured values.MIN - Averages the minimum measured values.
Description Specifies the signal interval, in WCDMA slots (666.667 us), onwhich the adjacent channel power (ACP) measurement executesfor all segments in the sequence.
Description Specifies whether to enable modulation accuracy (ModAcc)measurements for all segments of the sequence. The size of thearray depends on the currently defined number of segments.
Description Specifies the signal interval, in WCDMA slots (666.667 us), onwhich the modulation accuracy (ModAcc) measurement executesfor all segments in the sequence.
Description Specifies whether to enable occupied bandwidth (OBW)measurements for all segments of the sequence. The size of thearray depends on the currently defined number of segments.
Description Specifies the signal interval, in WCDMA slots (666.667 us), onwhich the occupied bandwidth (OBW) measurement executes forall segments in the sequence.
Description Specifies whether to enable spectral emissions mask (SEM)measurements for all segments of the sequence. The size of thearray depends on the currently defined number of segments.
Description Specifies the signal interval, in WCDMA slots (666.667 us), onwhich the spectral emissions mask (SEM) measurement executes,for all segments in the sequence.
Description Specifies whether to enable transmit power (TXP) measurementsfor all segments of the sequence. The size of the array depends onthe currently defined number of segments.
Description Specifies the signal interval, in WCDMA slots (666.667 us), onwhich the transmit power (TXP) measurement executes for allsegments in the sequence.
Description Segment duration in WCDMA slots (666.667 us) for all definedsegments. The size of the array depends on the currently definednumber of segments.
Description Specifies the external attenuation for all segments in thesequence. External attenuation is applied on top of anyattenuation provided for the specified port.
Description Specifies the UTRA absolute radio-frequency channel number(UARFCN) for the specified sequence. The size of the arraydepends on the currently defined number of segments.
Description Specifies whether to enable measurement on exception (MOEX).MOEX enables measurements on low quality data. By default,this value is enabled. Disabling MOEX currently applies only tosequenced measurements.
Description Specifies the number of segments in a sequence. You must setthis parameter before setting other sequence-based instrument ormeasurement parameters.
Description Average of I/Q origin offset measurements.
1080 | ni.com | WTS Software User Guide
Datatype Double
Unit dB
Parameter: <FrequencyError>
Description Average of frequency error measurements.
Datatype Double
Unit Hz
Parameter: <TimingOffset>
Description Timing offset of the configured EVM measurement channel withrespect to the start of frame. You can query this parameter only if theUUT Type is set to BS and the channel type is DPCH. WTS returns -1for other channels.
Description Average of I/Q origin offset measurements.
Datatype Double
Unit dB
Parameter: <FrequencyOffset>
Description Average of frequency offset measurements.
Datatype Double
Unit Hz
Parameter: <TimingOffset>
Description Returns the timing offset of the configured EVM measurementchannel with respect to the start of the frame. You can query thisparameter only if the UUT Type is set to BS and the channel type isDPCH. WTS returns -1 for other channels.
Description Timing offset of the configured EVM measurement channel withrespect to the start of frame. You can query this parameter only if theUUT Type is set to BS and the channel type is DPCH. WTS returns -1for other channels.
Description Minimum of I/Q origin offset measurements.
Datatype Double
Unit dB
Parameter: <FrequencyOffset>
Description Minimum of frequency offset measurements.
Datatype Double
Unit Hz
Parameter: <TimingOffset>
Description Returns the timing offset of the configured EVM measurementchannel with respect to the start of the frame. You can query thisparameter only if the UUT Type is set to BS and the channel type isDPCH. WTS returns -1 for other channels.
Description Slot power returns the power of each slot measured in thissegment. Debugs issues related to any specific slot within thesegment. This command is also used for any specific slot powermeasurement.
Description IDLE: Hardware is available.PENDING: Execution is waiting for hardware to be released.ACTIVE: Hardware is actively acquiring data.
Datatype Enumeration
Parameter: <MeasurementState>
Description OFF: The measurement has not been initiated yet.READY: The measurement result is available to fetch.PENDING: The measurement is initiated but has not started receivingdata to process.PROCESSING: The measurement is processing the acquired data.
Description Minimum quiet time. The signal is quiet when it is below the triggerlevel when you set the EDGE property to RISING, or above thetrigger level when you set the EDGE property to FALLING.
Description IMMEDIATE - Generates the signal to measure when the hardwareis ready.POWER - Uses RF power edge trigger.INTERNAL - Uses one of the multiple WTS internal triggers, whichmust be exported by any other personality configured to use thesame port. The port name must be defined before this command isexecuted.
Description Specifies the trigger threshold to use when power triggering. Thisvalue is referenced to the unit under test (UUT) port, accountingfor external attenuation.
LR-WPAN Instrument PersonalityThe LR-WPAN instrument personality contains measurements according to IEEE Standard802.15.4, specifically the 868 MHz/915 MHz and 2.4 GHz physical interfaces used byZigBee. Use the LR-WPAN SCPI commands to perform measurements for ZigBee compliantdevices.
LRWPAN Signal Analyzer SCPI Command ListComplete list of LRWPAN signal analyzer SCPI commands.
Description when SPS= Auto1. FSK, MSK: Auto SPS is 8.2. OQPSK & Pulse shaping filter=Half Sine: Auto SPS is 163. Others: Auto SPS is 4.Note: SPS is 8 when Pulse shaping filter=Rectangular.
Description RMS - The power is averaged using root mean square (RMS).LOG - The log of the power is averaged.SCALAR - The voltage is averaged.MAX - The maximum values are retained.MIN - The minimum values are retained.
Description RMS - The power is averaged using root mean square (RMS).LOG - The log of the power is averaged.SCALAR - The voltage is averaged.MAX - The maximum values are retained.MIN - The minimum values are retained.VECTOR - I/Q values are averaged.
Description RMS - The power is averaged using root mean square (RMS).LOG - The log of the power is averaged.SCALAR - The voltage is averaged.MAX - The maximum values are retained.MIN - The minimum values are retained.
Description Computes the center frequency of the LR-WPAN signal transmittedby the WTS based on the value that you specify in the channelnumber parameter.
Description 780 MHz: support Modulation O-QPSK868 MHz: support Modulation BPSK and O-QPSK915 MHz: support Modulation BPSK and O-QPSK950 MHz: support Modulation BPSK2450 MHz: support Modulation O-QPSK2380 MHz: support Modulation O-QPSK
Description If disabled, no trace data is collected so no traces can be fetched.0 | OFF: Disables collection of trace data.1 | ON: Enables collection of trace data.
Description Fetches occupied bandwidth (OBW) results. OccupiedBandwidth (OBW) is the bandwidth containing 99% of the totalintegrated power of the transmitted spectrum, centered on theassigned channel frequency.'
Availability Query
Execution Mode Sequential
Parameter: <OccupiedBandwidth>
Description Average OBW of the signal.
Datatype Double
Unit Hz
Parameter: <AveragePower>
Description Average Power of the OBW measurements.
Description IDLE: Hardware is available.PENDING: Execution is waiting for hardware to be released.ACTIVE: Hardware is actively acquiring data.
Datatype Enumeration
Parameter: <MeasurementState>
Description OFF: The measurement has not been initiated yet.READY: The measurement result is available to fetch.PENDING: The measurement is initiated but has not started receiveddata to process.PROCESSING: The measurement is processing the acquired data.
Description Minimum quiet time. The signal is quiet when it is below the triggerlevel when you set the EDGE property to RISING, or above thetrigger level when you set the EDGE property to FALLING.
Datatype Double
Default Value 1.000000000000000E-004
Range [0.000000000000000E+000:5.000000000000000E-003]
Description IMMEDIATE - Generates the signal to measure as soon as thehardware is ready.POWER - Uses RF power edge trigger.INTERNAL - Uses one of the multiple WTS internal triggers, whichmust be exported by any other personality configured to use thesame Port. Portname must be defined before this command isexecuted.
Description Specifies the trigger threshold to use when power triggering. Thisvalue is referenced to the unit under test (UUT) port, accountingfor external attenuation.
Range [0.000000000000000E+000:1.000000000000000E+002]
Unit sec
Z-Wave Instrument PersonalityThe Z-Wave instrument personality contains measurements according to the ITU-TRecommendation G.9959, 2015 specifications for short-range narrowband digitalradiocommunication transceivers. Use the Z-Wave SCPI commands to perform measurementsfor Z-Wave compliant devices.
Z-Wave Signal Analyzer SCPI Command ListComplete list of Z-Wave signal analyzer SCPI commands.
Description When SPS is Auto:1. FSK, MSK: Auto SPS is 8.2. OQPS and pulse shaping filter = half sine: Auto SPS is 16.3. Others: Auto SPS is 4.Note: SPS is 8 when pulse shaping filter = rectangular.
Description RMS - The power is averaged using root mean square.LOG - The log of the power is averaged.SCALAR - The voltage is averaged.MAX - The maximum values are retained.MIN - The minimum values are retained.VECTOR - I/Q values are averaged.
Description RMS - The power is averaged using root mean square.LOG - The log of the power is averaged.SCALAR - The voltage is averaged.MAX - The maximum values are retained.MIN - The minimum values are retained.
Description Specifies the RF profile. The RF profile given by ITU-T G.9959refers to a center frequency as specified in the Z-Wave AllianceRecommendation document, ZAD12837-1.
As per standard G.9959, the RF profile also fixes the data rate.However, this command sets only the center frequency and does notset the rate, which must be set manually.
1194 | ni.com | WTS Software User Guide
Availability Command/Query
ExecutionMode
Command: SequentialQuery: Sequential
Parameter: <Profile>
Description Computes the center frequency of the Z-Wave signal based on thethe value specified in RF Profile parameter.
Description If disabled, no trace data is collected so no trace can be fetched.0 | OFF: Disables collection of trace data.1 | ON: Enables collection of trace data.
Description Gives the maximum peak FSK deviation error, in percentage, of thedemodulated Z-Wave signal.Max FSK deviation error/expected FSK deviation, in percentage.
Datatype Double
Unit %
Parameter: <MaxFreqDeviationErrorSymbolIndex>
Description Returns the symbol index at which maximum frequencydeviation error occurs.
Description Fetches occupied bandwidth (OBW) results. OBW is thebandwidth containing 99% of the total integrated power of thetransmitted spectrum, centered on the assigned channelfrequency.'
Availability Query
Execution Mode Sequential
1204 | ni.com | WTS Software User Guide
Parameter: <OccupiedBandwidth>
Description Average OBW of the signal.
Datatype Double
Unit Hz
Parameter: <AveragePower>
Description Average power of the OBW measurements.
Datatype Double
Unit dBm
Parameter: <StartFrequency>
Description Average of the lower-bound frequency of the OBW measurements.
Datatype Double
Unit Hz
Parameter: <StopFrequency>
Description Average of the upper-bound frequency of the OBW measurements.
Description OFF: The measurement has not been initiated yet.READY: The measurement result is available to fetch.PENDING: The measurement is initiated but has not started receiveddata to process.PROCESSING: The measurement is processing the acquired data.
Description Minimum quiet time. The signal is quiet when it is below the triggerlevel when you set the EDGE property to RISING, or above thetrigger level when you set the EDGE property to FALLING.
Description IMMEDIATE - Generates the signal to measure as soon as thehardware is ready.POWER - Uses the RF power edge trigger.INTERNAL - Uses one of the multiple WTS internal triggers, whichmust be exported by any other personality configured to use thesame Port. Portname must be defined before this command isexecuted.
Description Specifies the trigger threshold to use when power triggering. Thisvalue is referenced to the unit under test (UUT) port, accountingfor external attenuation.
Worldwide Support and ServicesThe National Instruments website is your complete resource for technical support. At ni.com/support, you have access to everything from troubleshooting and application developmentself-help resources to email and phone assistance.
Visit ni.com/services for information about repairs, extended warranty, calibration, and otherservices.
Visit ni.com/register to register your NI product. Product registration facilitates technicalsupport and ensures that you receive important information updates from NI.
NI corporate headquarters is located at 11500 North Mopac Expressway, Austin, Texas,78759-3504. NI also has offices located around the world. For support in the United States,create your service request at ni.com/support or dial 1 866 ASK MYNI (275 6964). Forsupport outside the United States, visit the Worldwide Offices section of ni.com/niglobal toaccess the branch office websites, which provide up-to-date contact information.
Information is subject to change without notice. Refer to the NI Trademarks and Logo Guidelines at ni.com/trademarks for information on NI trademarks. Other product and company names mentioned herein are trademarks ortrade names of their respective companies. For patents covering NI products/technology, refer to the appropriatelocation: Help»Patents in your software, the patents.txt file on your media, or the National Instruments Patent Noticeat ni.com/patents. You can find information about end-user license agreements (EULAs) and third-party legal noticesin the readme file for your NI product. Refer to the Export Compliance Information at ni.com/legal/export-compliance for the NI global trade compliance policy and how to obtain relevant HTS codes, ECCNs, and other import/export data. NI MAKES NO EXPRESS OR IMPLIED WARRANTIES AS TO THE ACCURACY OF THE INFORMATIONCONTAINED HEREIN AND SHALL NOT BE LIABLE FOR ANY ERRORS. U.S. Government Customers: The datacontained in this manual was developed at private expense and is subject to the applicable limited rights and restricteddata rights as set forth in FAR 52.227-14, DFAR 252.227-7014, and DFAR 252.227-7015.