Tektronix OFDM Programmer

Download

OFDM Signal Modulation

ZZZ

Application Plug-in

Programmer Manual

*P077134900*

077-1349-00

OFDM Signal Modulation

ZZZ

Application Plug-in

Programmer Manual

www.tek.com

077-1349-00

Copyright © Tektronix. All rights reserved. Licensed software products are owned by Tektronix or its subsidiaries or suppliers, and are protected by national copyright laws and international treaty provisions.

Tektronix products are covered by U.S. and foreign patents, issued and pending. Information in this publication supersedes that in all previously published material. Speciﬁcations and price change privileges reserved.

TEKTRONIX and TEK are registered trademarks of Tektronix, Inc.

SourceXpress

is a registered trademark of Tektronix, Inc.

Contacting Tektronix

Tektronix, Inc. 14150 SW Karl Braun Drive P.O. Box 5 0 0 Beaverto USA

For product information, sales, service, and technical support:

n, OR 97077

In North America, call 1-800-833-9200. Worldwide, visit www.tek.com to ﬁnd contacts in your area.

Table of Contents

Getting Started

Introducti

Documentation............. .................................. ................................ ..................... 1-2

on ........................ ................................ ................................ ............... 1-1

Syntax and Commands

Command Syntax.................................... ................................ ............................. 2-1

Command G

Control commands.................... ................................ ................................ ....... 2-3

Compile commands .................................... ................................ ..................... 2-3

Carrier setup commands .................................................................................... 2-4

Frame commands ........................... ................................ ................................. 2-4

Gated noise commands...................................................................................... 2-5

Heade

Hopping commands ......................................................................................... 2-6

Multipath commands ..... ..... . ..... . ..... . ..... . ..... . .... . . .... . ..... . ..... . ..... . ..... . ..... . ... . . ..... . . 2-7

Payload commands ..................... ................................ .................................. ... 2-8

Phase noise commands...................................................................................... 2-8

Preamble commands......................................................................................... 2-9

S-P

Symbols commands ....................................................................................... 2-12

Commands in alphabetical order......................... ................................ ..................... 2-17

roups ................................................................................................ 2-3

r commands ........................................................................................... 2-6

arameter commands .......................... ................................ ........................... 2-9

OFDM Signal Modulation Plug-in Programmer Manual i

Table of Contents

ii OFDM Signal Modulation Plug-in Programmer Manual

Getting Started

Introduction

This programmer manual provides information on how to use commands for remotely controlling the OFDM Signal Modulation plug-in application.

The OFDM Signal Modulation plug-in can be installed in the SourceXpress software application, AWG70000 series instruments, and AWG5200 series instruments.

Communication with the plug-in is through the programmatic interface of these products. Using a single VISA or raw socket session, it is possible to communicate with SourceXpress, AWG70000 series instruments, and AWG5200 series in

For information on the Remote Control, GPIB Parameters, LAN Parameters, Connecti refer to the AWG70000 series Arbitrary Waveform Generators Programmer

Manual or the AWG5200 series Arbitrary Waveform Generators Programmer Manual.

struments.

ng to the Instrument using GPIB, and Setting up GPIB Communication,

OFDM Signal Modulation Plug-in Programmer Manual 1-1

Documentation

In addition to this OFDM Signal Modulation Programmer Guide, the following documentation is included with this application:

OFDM Signal Modulation Help. The help provides in-depth operation and user interface help.

OFDM Signal Modulation User Manual (PDF). This is adapted from the OFDM Signal Modulation help system.

1-2 OFDM Signal Modulation Plug-in Programmer M anual

Syntax and Commands

Command Syntax

For information on the Syntax Overview, Command and Query Structure, Clearing the Instrument, Command Entry, Parameter Types, SCPI Commands and Queries,

Programmer Manual or the AWG5200 series Arbitrary Waveform Generators Programmer Manual.

refer to the AWG70000 series Arbitrary Waveform Generators

OFDM Signal Modulation Plug-in Programmer Manual 2-1

Command Syntax

2-2 OFDM Signal Modulation Plug-in Programmer M anual

Command Groups

Control comma

nds

Table 2-1: Control commands and their descriptions

Command Descriptio

WPLugin:AC

OFDM:RESe

Compile c

Tive

ommands

Sets or retu

Resets the module to their default values.

rns the active waveform plug-in.

OFDM plug-in by setting all the values within the

Table 2-2: Compile commands and their descriptions

Command D escrip

OFDM:CO

OFDM:COMPile:CANCel Cancels a compilation currently in progress.

OFDM:COMPile:CASSign Sets or returns the state (enabled or disabled) to compile the

OFDM

OFDM:COMPile:CHANnel:IQ Sets or returns the status (enabled or disabled) of using the

OFDM:COMPile:CHANnel:Q Sets or returns the playout channel intended for the compiled Q

OFDM:COMPile:CORRection:APPLy Sets or returns the Apply Corrections File state (enabled or

OFDM:COMPile:CORRection:PATH Sets or returns the R F Correction ﬁlename and ﬁlepath to use

OFDM:COMPile:CORRection:PATH:I Sets or returns the I Correction ﬁlename and ﬁlepath to use when

OFDM:COMPile:CORRection:PATH:IQ Sets or returns the IQ Correction ﬁlename and ﬁlepath to use

OFDM:COMPile:CORRection:PATH:Q Sets or returns the Q Correction ﬁlename and ﬁ lepath to use

OFDM:COMPile:CORRection:TYPE Sets or returns the type of IQ correction ﬁle (a single IQ ﬁle or

OFDM:COMPile:DUPConverter Sets or returns the Internal IQ Modulator state (enabled or

MPile

:COMPile:CHANnel:I

DM:COMPile:CHANnel:RF

Compile compile settings.

waveform and immediately assign it to a speciﬁed channel (enab

Sets signal when the signal format is set to IQ.

Internal IQ Modulator for the Compile Settings.

sig

Se waveform when the s ignal format is set to RF/IF.

disabled) for the Compile Settings.

compiling and IQ signal.

when compiling and IQ signal.

individual I and Q ﬁles) to apply when compiling.

disabled) when compiling.

tion

s and generates a waveform using the OFDM plug-in

led) or just compile the waveform (disabled).

or returns the playout channel intended for the compiled I

nal when the signal format is set to IQ.

ts or returns the playout channel intended for the compiled RF

hen compiling an RF signal.

OFDM Signal Modulation Plug-in Programmer Manual 2-3

Command Groups

Table 2-2: Compile commands and their descriptions (cont.)

Command D escription

OFDM:COMPile:MARKer:ENABle Sets or returns the Marker Data state (enabled or disabled) for

the Compile Settings.

OFDM:COMPile:MARKer[n]:CFRequency Sets or returns the Marker Data clock frequency when the Marker

Data type is set to Clock Frequency.

OFDM:COMPile:MARKer[n]:MDATa Sets or returns the Marker Data Type of the speciﬁed marker.

OFDM:COMPile:MODE Sets or r eturns the Create Sequence state (enabled or disabled)

of the compiler control. When enabled, a sequence of frames with waveforms is automatically created after compilation.

OFDM:COMPile:NAMe Sets or returns the name of the compiled waveform.

OFDM:COMPile:OSAMpling Sets or returns the over sampling rate used to determine the

sampling rate of the compiled signal.

OFDM:COMPile:OVERwrite Sets or returns the Overwrite existing waveform state (enabled

or disabled) when compiling.

OFDM:COMPile:PLAY Sets or returns the Play after assign state (enabled or disabled)

for the Compile Settings.

OFDM:SFORmat Sets or returns the signal format of the signal to be compiled.

OFDM:COMPile:SRATe Sets or returns the sampling rate for the compile settings.

OFDM:COMPile:SRATe:AUTO Sets or returns the value that indicates if the sampling rate will

be automatically calculated at compile time.

Carrier setup commands

Table 2-3: Carrier setup commands and their descriptions

Command D escription

OFDM:CARRier:AMPLitude Sets or returns the signal carrier amplitude (in volts) for the IQ

signal format.

OFDM:CARRier:BANDwidth Sets or returns the carrier bandwidth for the OFDM signal.

OFDM:CARRier:FREQuency Sets or returns the carrier Frequency for the RF/IF signal format.

OFDM:CARRier:POWer Sets or returns the signal carrier amplitude (in dBm) for the RF/IF

signal format.

Frame commands

Table 2-4: Frame commands and their descriptions

Command D escription

OFDM:FRAMe:ADD Adds a new frame to the existing list of frames within the Frame

List.

OFDM:FRAMe:DELete Deletes the speciﬁed frame from the Frame List.

2-4 OFDM Signal Modulation Plug-in Programmer M anual

Command Groups

Table 2-4: Frame commands and their descriptions (cont.)

Command Description

OFDM:FRAMe:FSPacing:ENABle Sets or returns the status (enabled or disabled) of Frame Spacing

for the selected frame.

OFDM:FRAMe:FSPacing:VALue Sets or returns the Frame Spacing (in seconds) for selected

frame.

OFDM:FRAMe:OTNoise:ENABle Sets or returns the status (enabled or disabled) of the SNR

Off-Time for the selected frame.

OFDM:FRAMe:OTNoise:VALue Sets or returns the Frame SNR Off-Time duration (in dB) for

selected frame.

OFDM:FRAMe:REName Renames an existing frame name to a new name. The frame

being renamed must exist in the Frames List.

OFDM:FRAMe:SELect Sets or returns the selected frame from the list of available

frames in the Frames List.

OFDM:FRAMe:WINDow:ENABle Sets or returns the status (enabled or disabled) of the overlap

Window type for the selected frame.

OFDM:FRAMe:WINDow:TYPE Sets or returns the overlap Window type for the selected frame.

Gated noise commands

Table 2-5: Gated noise commands and their descriptions

Command Description

OFDM:FRAMe:GNOise:ENABle Sets or returns the Gated Noise state (enabled or disabled) for

the selected frame in the Frame List.

OFDM:FRAMe:GNOise:FSNR:VALue Sets or returns the Gated Noise SNR for the Complete frame

for the selected frame.

OFDM:FRAMe:GNOise:HEADer:ENABle Sets or returns the frame’s Header state for Gated Noise

(enabled or disabled) when Gated Noise is set to Custom for the selected frame in the Frame List.

OFDM:FRAMe:GNOise:HEADer:VALue Sets or returns the Gated Noise value for the frame’s header for

the selected frame in the Frame List.

OFDM:FRAMe:GNOise:PAYLoad:ENABle Sets or returns the frame’s Payload state (enabled or disabled)

for G ated Noise when Gated Noise is set to Custom for the selected frame in the Frame List.

OFDM:FRAMe:GNOise:PAYLoad:VALue Sets or returns the Gated Noise value for the frame’s payload for

the selected frame in the Frame List.

OFDM:FRAMe:GNOise:PREamble:ENABle Sets or returns the frame’s Preamble state for Gated Noise

(enabled or disabled) when Gated Noise is set to Custom for the selected frame in the Frame List.

OFDM:FRAMe:GNOise:PREamble:VALue Sets or returns the Gated Noise value for the frame’s preamble

for the selected frame in the Frame List.

OFDM:FRAMe:GNOise:TYPE Sets or returns the Gated Noise type for the selected frame in

the Frame List.

OFDM Signal Modulation Plug-in Programmer Manual 2-5

Command Groups

Header commands

Table 2-6: Header commands and their descriptions

Command D escription

OFDM:FRAMe:HEADer:ADD Adds a row to the end of the Header custom Symbols table for

the selected (deﬁned in the Symbols tab).

OFDM:FRAMe:HEADer:DELete Deletes the speciﬁed row from the Header custom symbols table

OFDM:FRAMe:HEADer:DOMain Sets or returns the Domain for the user supplied header ﬁle for

the selected frame.

OFDM:FRAMe:HEADer:ENABle Sets or returns the status (enabled or disabled) of the frame

Header fo

OFDM:FRA

OFDM:FRAMe:HEADer:PATH Sets or returns the Header ﬁlename and ﬁlepath for the selected

OFDM:FRAMe:HEADer:REPeat Sets or returns the R epeat count for the user supplied header ﬁle

OFDM:

OFDM:FRAMe:HEADer:SNAMe Sets or returns the symbol name for the currently selected row in

OFDM

OFDM:FRAMe:HEADer:SREPeat Sets or returns the Repeat count for the currently selected row in

OFDM:FRAMe:HEADer:SSPacing Sets or returns the Header Subcarriers Spacing for the user

FDM:FRAMe:HENable

Me:HEADer:MODE

FRAMe:HEADer:SELect

:FRAMe:HEADer:SRATe

Sets or re table) for the selected frame.

frame.

for the

Sets o symbols table. Other commands act on the selected row.

the Header custom symbol table. The new name must already

t in the Symbol List.

exis

Sets ﬁle for the selected frame.

the Header custom symbols table.

pplied header ﬁle for the selected frame.

ets or returns the status (enabled or disabled) of including a

S Header for the selected frame.

frame. Symbols are added from the Symbol List

r the selected frame.

turns the Header input method (ﬁle or custom sym bols

selected frame.

r returns the selected (active) row from the Header custom

or returns the Sampling Rate for the user supplied header

opping commands

Table 2-7: Hopping commands and their descriptions

Command D escription

OFDM:FRAMe:HOPPing:ENABle Sets or returns the Hopping state (enabled or disabled) for the

selected frame in the Frame List.

OFDM:FRAMe:HOPPing:HTIMe Sets or returns the Hop Time type for the selected frame in the

Frame List.

OFDM:FRAMe:HOPPing[:LIST]:ADD Adds a single entry to the end of the Frequency Hop List for the

selected frame in the Frame List

2-6 OFDM Signal Modulation Plug-in Programmer M anual

Command Groups

Table 2-7: Hopping commands and their descriptions (cont.)

Command Description

OFDM:FRAMe:HOPPing[:LIST]:AOFFset Sets or returns the Amplitude Offset of the currently selected hop

of the currently selected hop in the Frequency Hop List for the selected frame in the Frame List.

OFDM:FRAMe:HOPPing[:LIST]:COUNt? Returns the number of hops in the Hop List for the selected

frame in the Frame List.

OFDM:FRAMe:HOPPing[:LIST]:DELete Removes all entries within the Frequency Hop List for the

selected frame in the Frame List.

OFDM:FRAMe:HOPPing[:LIST]:FREQuency Sets or returns the Frequency of the currently selected hop in the

Frequency Hop List for the selected frame in the Frame List.

OFDM:FRAMe:HOPPing[:LIST]:INSert

OFDM:FRAMe:HOPPing[:LIST]:RFRequency Sets or returns the Frequency Offset (Relative Frequency) of the

OFDM:FRAMe:HOPPing[:LIST]:SELect Sets or returns the selected Hop number in the Frequency Hop

OFDM:FRAMe:HOPPing[:LIST]:SSINdex Sets or returns the Symbol Start Index (Symbol Index) for the

OFDM:FRAMe:HOPPing:RLISt Sets or returns the Repeat List state (enabled or disabled) for the

OFDM:FRAMe:HOPPing:SPHop Sets or returns the Symbols per Hop for the selected frame in

Inserts a single entry into the Frequency Hop List above the speciﬁed index for the selected frame in the Frames List.

currently selected hop in the Frequency Hop List for the selected frame in the Frame List.

List for the selected frame in the Frame List.

selected frame in the Frame List.

Frequency Hop List for the selected frame in the Frame List.

the Frame List.

Multipath commands

Table 2-8: Multipath commands and their descriptions

Command Description

OFDM:FRAMe:MULTipath:ADD Adds a new path in the Multipath table for the selected frame

in the Frame List.

OFDM:FRAMe:MULTipath:AMPLitude Sets or returns the Multipath Amplitude of the currently selected

path for the s elected frame in the Frame List.

OFDM:FRAMe:MULTipath:DELay Sets or returns the Multipath Delay in seconds of the currently

selected path for the selected frame in the Frame List.

OFDM:FRAMe:MULTipath:ENABle Sets or returns the Multipath state (enabled or disabled) for the

selected frame in the Frame List.

OFDM:FRAMe:MULTipath:PHASe Sets or returns the Multipath Phase of the currently selected path

for the selected frame in the Frame List.

OFDM:FRAMe:MULTipath:REMove This command deletes the speciﬁed path from the Multipath

table for the s elected frame in the Frame List.

OFDM:FRAMe:MULTipath:SELect Sets or returns the active M ultiP ath table index (row) for the

selected frame in the Frame List.

OFDM Signal Modulation Plug-in Programmer Manual 2-7

Command Groups

Payload commands

Table 2-9: Payload commands and their descriptions

Command D escription

OFDM:FRAMe:PAYLoad:ADD Adds a row to the end of the Payload symbols table for the

selected fra

OFDM:FRAMe

OFDM:FRAMe:PAYLoad:SELect Sets or returns the selected (active) row from the Payload

OFDM:FRAMe:PAYLoad:SNAMe Sets or returns the symbol name for the currently selected row

OFDM:FR

OFDM:FRAMe:PLENable Sets or returns the status (enabled or disabled) of including a

:PAYLoad:DELete

:PAYLoad:ENABle

AMe:PAYLoad:SREPeat

Deletes the

Sets or retu Payload for the selected frame.

symbols table. Other commands act on the selected row.

in the Pay

Sets or r in the Payload symbols table.

Preamble for the selected frame.

me.

speciﬁed row from the Payload symbols table

rns the status (enabled or disabled) of the frame

load symbol table.

eturns the Repeat count for the currently selected row

Phase noise commands

2-10: Phase noise commands and their descriptions

Table

Command D escription

OFDM:FRAMe:PNOise:ADD Adds a single row to the end of the Phase Noise Frequency

Model table.

OFDM:FRAMe:PNOise:BFRequency Sets or returns the Bandwidth Frequency value (to considered

he bandwidth for phase noise power spectral density) for

as t the Phase Noise Frequency Model when the Bandwidth Type is set to Frequency.

OFDM:FRAMe:PNOise:BLEVel Sets or returns the Bandwidth cutoff level (in dBc/Hz) for the

ase Noise Frequency Model when the Bandwidth Type is set

Ph to Level.

OFDM:FRAMe:PNOise:BTYPe Sets or returns the Bandwidth Type for the Phase Noise

Frequency M odel.

OFDM:FRAMe:PNOise:DELete Deletes the speciﬁed row (index) from the Phase Noise

Frequency Model table.

OFDM:FRAMe:PNOise:ENABle Sets or returns the Phase Noise state (enabled or disabled) for

the selected frame in the Fram e List.

OFDM:FRAMe:PNOise:FREQuency Sets or returns the Frequency Offset for the currently selected

row in the Phase Noise Frequency Model table.

OFDM:FRAMe:PNOise:MODE Sets or returns the Model used for Phase N oise.

OFDM:FRAMe:PNOise:PNOise Sets or gets the Phase Noise value for the Phase Noise Time

Model.

OFDM:FRAMe:PNOise:PROFile Sets or returns the Proﬁle for the Phase Noise Time Model.

2-8 OFDM Signal Modulation Plug-in Programmer M anual

Command Groups

Table 2-10: Phase noise commands and their descriptions (cont.)

Command Description

OFDM:FRAMe:PNOise:PSD Sets or returns the PSD (Power Spectral Density) dBc/Hz value

for the currently selected row in the Phase N oise Frequency Model table.

OFDM:FRAMe:PNOise:SELect Sets or returns the selected (active) row of the Phase Noise

Frequency Model table. Other commands act on the selected row.

OFDM:FRAMe:PNOise:VCOBandwidth Sets or gets the VCO Bandwidth (VCO cutoff) value for the

Phase Noise Time Model.

Preamble comm ands

Table 2-11: Preamble commands and their descriptions

Command Description

OFDM:FRAMe:PENable Sets or returns the status (enabled or disabled) of including a

Preamble for the selected frame.

OFDM:FRAMe:PREamble[n]:DOMain Sets or returns the Domain type of the speciﬁed Preamble for

the selected frame.

OFDM:FRAMe:PREamble[n]:ENABle Sets or returns the status of the speciﬁed Preamble (enabled or

disabled) for the selected frame.

OFDM:FRAMe:PREamble[n]:PATH Sets or returns the speciﬁed Preamble ﬁlename and ﬁ lepath for

the selected frame.

OFDM:FRAMe:PREamble[n]:REPeat Sets or returns the Repeat count of the speciﬁed Preamble for

the selected frame.

OFDM:FRAMe:PREamble[n]:SRATe Sets or returns the Sampling Rate of the speciﬁed Preamble

for the selected frame.

OFDM:FRAMe:PREamble[n]:SSPacing Sets or returns the Subcarrier Spacing of the speciﬁed Preamble

for the selected frame.

S-Parameter commands

Table 2-12: S-Parameter commands and their descriptions

Command Description

OFDM:SPARameter:BANDwidth Sets or returns the S-Parameter bandwidth when setting

manually.

OFDM:SPARameter:BANDwidth:AUTO Sets or returns the S-Parameter automatic bandwidth calculation

setting.

OFDM:SPARameter:CASCading:AGGRessor2[:ENABle] Sets or returns the aggressor 2 signal type state (enabled or

disabled) in Cascading mode. Aggressor2 signals are available when the number of ports is set to 12.

OFDM Signal Modulation Plug-in Programmer Manual 2-9

Command Groups

Table 2-12: S-Parameter commands and their descriptions (cont.)

Command D escription

OFDM:SPARameter:CASCading:AGGRessor[n]:AMPLitude Sets or returns the speciﬁed Aggressor's amplitude, in Cascading

mode.

OFDM:SPARameter:CASCading:AGGRessor[n]:CTALk Sets or returns the speciﬁed Aggressor's crosstalk type, in

Cascading mode.

OFDM:SPARameter:CASCading:AGGRessor[n]:DRATe Sets or returns the speciﬁed Aggressor's data rate, in Cascading

mode.

OFDM:SPARameter:CASCading:AGGRessor[n]:SIGNal Sets or returns speciﬁed Aggressor's signal type, in Cascading

mode.

OFDM:SPARameter:CASCading:AGGRessor[n]:SIGNal:FILE Sets or returns the ﬁlename and ﬁlepath to the aggressor ﬁle for

the speciﬁed Aggressor, in Cascading mode.

OFDM:SPARameter:CASCading:AGGRessor[n]:SIGNal:PRBS Sets or returns the speciﬁed Aggressor's PRBS s ignal type, in

Cascading mode.

OFDM:SPARameter:CASCading:DEEMbed Sets or returns whether the Cascading S-Parameters is to

de-embed (invert) the S-Parameters, in Cascading mode.

OFDM:SPARameter:CASCading:STAGe[m]:DRX[n] Sets or returns the S-Parameter port assignment of the speciﬁed

Stage and the channel’s speciﬁed receiver port number (Rx-Port) in Cascading mode and Differential Signalling Scheme (where applicable).

OFDM:SPARameter:CASCading:STAGe[m]:DTX[n] Sets or returns the S-Parameter port assignment of the speciﬁed

Stage and the channel’s speciﬁed transmission port number (Tx-Port) in Cascading mode and Differential Signalling Scheme (where applicable).

OFDM:SPARameter:CASCading:STAGe[m]:ENABle Sets or returns the state (enabled or disabled) of the speciﬁed

Cascaded S-Parameter stage.

OFDM:SPARameter:CASCading:STAGe[m]:FILE Sets or returns the ﬁlename and ﬁlepath for the speciﬁed

S-Parameters Cascading Stage, in Cascading mode.

OFDM:SPARameter:CASCading:STAGe[m]:RX[n] Sets or returns the S-Parameter port assignment of the speciﬁed

Stage and the channel’s speciﬁed receiver port number (Rx-Port) in Cascading mode and Single-Ended Signalling Scheme (where applicable).

OFDM:SPARameter:CASCading:STAGe[m]:SSCHeme Sets or returns the S-Parameter Signalling Scheme, in

Cascading mode. Signalling Scheme is only available when the Number of Ports is set to 4, 8, or 12.

OFDM:SPARameter:CASCading:STAGe[m]:TX[n] Sets or returns the S-Parameter port assignment of the speciﬁed

Stage and the channel’s speciﬁed transmission port number (Tx-Port) in Cascading mode and Single-Ended Signalling Scheme (where applicable).

OFDM:SPARameter:CASCading:STYPe Sets or returns S-Parameter signal type (victim or aggressor), in

Cascading mode. The number of ports must be either 8 or 12.

OFDM:SPARameter:CASCading:TYPE Sets or returns the S-Parameter number of ports, in Cascading

mode.

OFDM:SPARameter:MODE Sets or returns the S-Parameter mode (Cascading or

Non-Cascading).

2-10 OFDM Signal Modulation Plug-in Programmer Manual

Command Groups

Table 2-12: S-Parameter commands and their descriptions (cont.)

Command Description

OFDM:SPARameter:NCAScading:AGGRessor2[:ENABle] Sets or returns the aggressor 2 signal type state (enabled or

disabled) in Non-Cascading mode. Aggressor2 signals are available when the number of ports is set to 12.

OFDM:SPARameter:NCAScading:AGGRessor[n]:AMPLitude Sets or returns the speciﬁed Aggressor's amplitude, in

Non-Cascading mode.

OFDM:SPARameter:NCAScading:AGGRessor[n]:CTALk Sets or returns the speciﬁed Aggressor's crosstalk type, in

Non-Cascading mode.

OFDM:SPARameter:NCAScading:AGGRessor[n]:DRATe Sets or returns the speciﬁed Aggressor's data rate, in

Non-Cascading mode.

OFDM:SPARameter:NCAScading:AGGRessor[n]:SIGNal Sets or returns speciﬁed Aggressor's signal type, in

Non-Cascading mode.

OFDM:SPARameter:NCAScading:AGGRessor[n]:SIGNal:FILE Sets or returns the ﬁlepath to the aggressor ﬁle for the speciﬁed

Aggressor, in Non-Cascading mode.

OFDM:SPARameter:NCAScading:AGGRessor[n]:SIGNal:PRBS Sets or returns the speciﬁed Aggressor's PRBS signal type, in

Non-Cascading mode.

OFDM:SPARameter:NCAScading:DEEMbed Sets or returns whether the Non-Cascading S-Parameters is to

de-embed (invert) the S-Parameters, in Non-Cascading mode.

OFDM:SPARameter:NCAScading:DRX[n] Sets or returns the S-Parameter port assignment of the channel’s

speciﬁed receiver port number (Rx-Port) in Non-Cascading mode and Differential Signalling Scheme (where applicable).

OFDM:SPARameter:NCAScading:DTX[n] Sets or returns the S-Parameter port assignment of the channel’s

speciﬁed transmission port number (Tx-Port) in Non-Cascading mode and Differential Signalling Scheme (where applicable).

OFDM:SPARameter:NCAScading:FILE Sets or returns the ﬁlename and ﬁlepath of the S-Parameter ﬁle,

in Non-Cascading mode.

OFDM:SPARameter:NCAScading:LAYout Sets or returns the 4 port S-Parameter Matrix Conﬁguration, in

Non-Cascading mode.

OFDM:SPARameter:NCAScading:RX[n] Sets or returns the S-Parameter port assignment of the channel’s

speciﬁed receiver port number (Rx-Port) in Non-Cascading mode and Single-Ended Signalling Scheme (where applicable).

OFDM:SPARameter:NCAScading:SSCHeme Sets or returns the S-Parameter Signalling Scheme, in

Non-Cascading mode. Signalling Scheme is only available when the Number of Ports is set to 4, 8, or 12.

OFDM:SPARameter:NCAScading:STYPe Sets or returns S-Parameter signal type (victim or aggressor),

in Non-Cascading mode. The number of ports must be either 8 or 12.

OFDM:SPARameter:NCAScading:TX[n] Sets or returns the S-Parameter port assignment of the channel’s

speciﬁed transmission port number (Tx-Port) in Non-Cascading mode and S ingle-Ended Signalling Scheme (where applicable).

OFDM:SPARameter:NCAScading:TYPE Sets or returns the S-Parameter number of ports, in

Non-Cascading mode.

OFDM:SPARameter:SFORmat Sets or returns the currently used signal format for all

S-Parameter values.

OFDM Signal Modulation Plug-in Programmer Manual 2-11

Command Groups

Table 2-12: S-Parameter commands and their descriptions (cont.)

Command D escription

OFDM:SPARameter:SFORmat:LIQ Sets o r returns the Couple Settings (I,Q) state. When enabled,

all I and Q S-Parameters are linked together (chained) so that all parameters match between I and Q.

OFDM:SPARameter:TON Sets or returns the S-Parameter state (enabled or disabled).

Symbols commands

Table 2-13: Symbols commands and their descriptions

Command D escription

OFDM:SYMBol:ADD Adds a new symbol to the existing list of symbols within the

Symbols List. The new symbol is created using the plug-in default settings.

OFDM:SYMBol:APPRoﬁle:CUSTom:ADD Adds a single row to the custom Amplitude/Phase Proﬁle table

for the selected symbol in the Symbol List.

OFDM:SYMBol:APPRoﬁle:CUSTom:AMPLitude Sets or returns the amplitude of the subcarrier positions of the

selected row in the Custom Amplitude/Phase Proﬁle table for the selected symbol in the Symbol List.

OFDM:SYMBol:APPRoﬁle:CUSTom:PHASe Sets or returns the phase of the subcarrier positions of the

selected row in the Custom Amplitude/Phase Proﬁle table for the selected symbol in the Symbol List.

OFDM:SYMBol:APPRoﬁle:CUSTom:REMove Removes the speciﬁed row from the custom Amplitude/Phase

Proﬁle table for the selected symbol in the Symbol List.

OFDM:SYMBol:APPRoﬁle:CUSTom:SELect Sets or returns the selected (active) row of the Custom

Amplitude/Phase Proﬁ le table. Other commands act on the selected row.

OFDM:SYMBol:APPRoﬁle:CUSTom:SPOS Sets or returns the subcarrier positions for the currently selected

row in the custom Amplitude/Phase Proﬁle table for the selected symbol in the Symbol List.

OFDM:SYMBol:APPRoﬁle:DATA:AMPLitude Sets or returns the amplitude of the Data s ubcarriers when

conﬁguring the Amplitude/Phase Proﬁle for the selected symbol in the Symbol List.

OFDM:SYMBol:APPRoﬁle:DATA:ENABle This command sets or returns the Data state (enabled or

disabled) of the Amplitude/Phase Proﬁle for the selected symbol in the Symbol List.

OFDM:SYMBol:APPRoﬁle:DATA:PHASe Sets or returns the phase of the Data subcarriers w hen

conﬁguring the Amplitude/Phase Proﬁle for the selected symbol in the Symbol List.

OFDM:SYMBol:APPRoﬁle:ENABle Sets or returns the Amplitude Phase Proﬁle state (enabled or

disabled) for the selected symbol in the Symbol List.

OFDM:SYMBol:APPRoﬁle:PILot:AMPLitude This command sets or returns the amplitude of the Pilot

subcarriers when conﬁguring the Amplitude/Phase Proﬁle for the selected symbol in the Symbol List.

2-12 OFDM Signal Modulation Plug-in Programmer Manual

Command Groups

Table 2-13: Symbols commands and their descriptions (cont.)

Command Description

OFDM:SYMBol:APPRoﬁle:PILot:ENABle This command sets or returns the Pilot state (enabled or

disabled) of the Amplitude/Phase Proﬁle for the selected symbol in the Symbol List.

OFDM:SYMBol:APPRoﬁle:PILot:PHASe Sets or returns the Phase of the Pilot subcarriers when

conﬁguring the Amplitude/Phase Proﬁle for the selected symbol in the Symbol List.

OFDM:SYMBol:APPRoﬁle:TYPE Sets or returns the Amplitude Phase Proﬁle type for selected

symbol.

OFDM:SYMBol:CRATio:ENABle Sets or returns the Clipping Ratio state (enabled or disabled) for

the selected symbol in the Symbol List.

OFDM:SYMBol:CRATio:VALue Sets or r eturns the Clipping Ratio value for the selected symbol

in the Symbol List.

OFDM:SYMBol:DATA Sets or returns the Data subcarriers pattern type for the selected

symbol in the Symbol List.

OFDM:SYMBol:DATA:ENABle Sets or returns the Data subcarriers state (enabled or disabled)

for the selected symbol in the Symbol List.

OFDM:SYMBol:DATA:FILE Sets or returns the Data Pattern ﬁle and ﬁlepath for the s elected

symbol in the Symbol List.

OFDM:SYMBol:DATA:MODulation:PSK Sets or returns the Data subcarriers PSK data modulation type

for the selected symbol in the Symbol Table.

OFDM:SYMBol:DATA:MODulation:QAM This command sets or returns the Data subcarriers QAM

modulation type for the selected symbol in the Symbol Table.

OFDM:SYMBol:DATA:MODulation:TYPe Sets or returns the Data subcarriers modulation type for the

selected symbol in the Symbol List.

OFDM:SYMBol:DATA:PATTern Sets or returns the user deﬁned Data subcarriers pattern for the

selected symbol in the Symbol Table.

OFDM:SYMBol:DATA:POSition Sets or returns the Data subcarrier positions of the selected

symbol in the Symbol List.

OFDM:SYMBol:DATA:PRBS Sets or returns the PRBS pattern type when the Data subcarriers

pattern type is set to PRBS for the selected symbol in the Symbol List.

OFDM:SYMBol:DATA:PRBS:UDEFined:POLYnomial Sets or returns the PRBS Polynomial Expression for the User

Deﬁned PRBS when the Data subcarriers pattern is set to User Deﬁned PRBS for the selected symbol in the Symbol List.

OFDM:SYMBol:DATA:PRBS:UDEFined:SREGister Sets or returns the PRBS Shift register initial value for the User

Deﬁned PRBS when the Data subcarriers pattern is set to User Deﬁned PRBS for the selected symbol in the Symbol List.

OFDM:SYMBol:DELete This command deletes the speciﬁed symbol from the Symbol List.

OFDM:SYMBol:FOFFset:ENABle Sets or returns the Frequency Offset state (enabled or disabled)

for the selected symbol in the Symbol List.

OFDM:SYMBol:FOFFset:VALue Sets or returns the Frequency Offset value for the selected

symbol in the Symbol List.

OFDM Signal Modulation Plug-in Programmer Manual 2-13

Command Groups

Table 2-13: Symbols commands and their descriptions (cont.)

Command D escription

OFDM:SYMBol:GINTerval:ENABle Sets or returns the Symbols Guard Interval state (enabled or

disabled) for the selected symbol in the Symbol List.

OFDM:SYMBol:GINTerval:TYPE This command sets or returns the Guard Interval type for the

selected symbol in the Symbol List.

OFDM:SYMBol:GINTerval:VALue Sets or returns the value of the guard interval for the selected

symbol in the Symbol List.

OFDM:SYMBol:GPOSitions Sets or returns the Subcarrier Guard positions of the selected

symbol in the Symbol List.

OFDM:SYMBol:GPOSitions:ENABle Sets or returns the subcarriers guard position state (enabled or

disabled) for the selected symbol in the Symbol List.

OFDM:SYMBol:NPOSitions Sets or returns the Subcarrier Null positions of the selected

symbol in the Symbol List.

OFDM:SYMBol:NPOSitions:ENABle Sets or returns the Subcarrier Null positions state (enabled or

disabled) for the selected symbol in the Symbol List.

OFDM:SYMBol:PILot Sets or returns the Pilot subcarriers pattern type for the selected

symbol in the Symbol List.

OFDM:SYMBol:PILot:ENABle This command sets or returns the Pilot subcarriers state (enabled

or disabled) for the selected symbol in the Symbol List.

OFDM:SYMBol:PILot:FILE Sets or returns the Pilot subcarriers pattern ﬁle and ﬁlepath for

the selected symbol in the Symbol List.

OFDM:SYMBol:PILot:MODulation:PSK Sets or returns the Pilot subcarriers PSK modulation type for the

selected symbol in the Symbol List.

OFDM:SYMBol:PILot:MODulation:QAM This command sets or returns the Pilot subcarriers QAM

modulation type for the selected symbol in the Symbol List.

OFDM:SYMBol:PILot:MODulation:TYPe Sets or returns the Pilot subcarriers modulation type for the

selected symbol in the Symbol List.

OFDM:SYMBol:PILot:PATTern Sets or returns the user deﬁned Pilot subcarriers pattern for the

selected symbol in the Symbol Table.

OFDM:SYMBol:PILot:POSition This command sets or returns the Pilot subcarrier positions of the

selected symbol in the Symbol List.

OFDM:SYMBol:PILot:PRBS Sets or returns the PRBS pattern type when the Pilot subcarriers

pattern type is set to PRBS for the selected symbol in the Symbol List.

OFDM:SYMBol:PILot:PRBS:UDEFined:POLYnomial Sets or returns the PRBS Polynomial Expression for the User

Deﬁned PRBS when the Pilot subcarriers pattern is set to User Deﬁned PRBS for the selected symbol in the Symbol List.

OFDM:SYMBol:PILot:PRBS:UDEFined:SREGister Sets or returns the PRBS Shift register initial value for the User

Deﬁned PRBS when the Pilot subcarriers pattern is set to User Deﬁned PRBS for the selected symbol in the Symbol List.

OFDM:SYMBol:POFFset:ENABle Sets or returns the Phase Offset state (enabled or disabled) for

the selected symbol in the Symbol List.

2-14 OFDM Signal Modulation Plug-in Programmer Manual

Command Groups

Table 2-13: Symbols commands and their descriptions (cont.)

Command Description

OFDM:SYMBol:POFFset:VALue Sets or returns the Phase O ffset value for the selected symbol

in the Symbol List.

OFDM:SYMBol:REName

OFDM:SYMBol:SELect Sets or returns the selected symbol from the list of a vailable

OFDM:SYMBol:SSPacing Sets or returns the Symbols Subcarriers Spacing for the selected

OFDM:SYMBol:TSUBcarriers Sets or returns the total number of subcarriers for the selected

OFDM:SYMBol:TSUBcarriers:POSitions Sets or returns if the subcarriers show only the positive

OFDM:SYMBol:UDEFined:ENABle Sets or returns the User-deﬁned frequency weight (enabled

OFDM:SYMBol:UDEFined:PATH Sets or returns the ﬁlename and ﬁlepath of the User Deﬁned

Renames an existing symbol name to a new name. The symbol being renamed must exist in the Symbol List.

symbols in the Symbol List. Other commands act on the selected symbol.

symbol in the Symbol List.

subcarriers or all subcarriers for the selected symbol in the Symbol List.

or disabled) of the selected symbol in the Symbol List. When enabled, a user supplied frequency weight ﬁle is used to de ﬁne the subcarriers.

Weights F ile.

OFDM Signal Modulation Plug-in Programmer Manual 2-15

Command Groups

2-16 OFDM Signal Modulation Plug-in Programmer Manual

Commands in alphabetical order

This section contains all available commands. They are presented in alphabetical order.

Use the Command Groups section to simplify navigating to speciﬁc groups of commands.

OFDM Signal Modulation Plug-in Programmer Manual 2-17

Commands in alphabetical order

OFDM:CARRier

Conditions

Related Commands

Arguments

:AMPLitude

This command sets or returns the signal carrier amplitude (in volts) for the IQ signal format.

Signal format must be set to IQ.

Group

Syntax

Returns

Carrier setup

OFDM:CARRier:AMPLitude <amplitude> OFDM:CARRier:AMPLitude?

OFDM:SFORmat

<amplitude>::=<NRf> value.

A single <NR3> value.

Examples

OFDM:CARRIER:AMPLITUDE 250E-3 sets the carrier Amplitude to 250 mV

OFDM:CARRIER:AMPLITUDE? might return

the carrier Amplitude is set to 25 mV

OFDM:CARRier:BANDwidth

This command sets or returns the carrier bandwidth for the OFDM signal.

Group

Syntax

Arguments

Returns

Carrier setup

OFDM:CARRier:BANDwidth <bandwidth> OFDM:CARRier:BANDwidth?

A single <NR3> value.

::= <NRf> value.

25.0000000000E-3, indicating that

2-18 OFDM Signal Modulation Plug-in Programmer Manual

Commands in alphabetical order

Examples

OFDM:CARRIER:

OFDM:CARRIER:BANDWIDTH? might return 1.5000000000E+6, indicating that

the carrier ba

BANDWIDTH2.5E6

ndwidth is set to 1.5 MHz.

sets the carrier bandwidth to 2.5 MHz.

OFDM Signal Modulation Plug-in Programmer Manual 2-19

Commands in alphabetical order

OFDM:CARRier

Conditions

Arguments

Examples

:FREQuency

This command sets or returns the carrier Frequency for the RF/IF signal format.

SignalformatmustbesettoRF/IF.

Group

Syntax

Returns

Carrier setup

OFDM:CARRier:FREQuency <carrier_frequency> OFDM:CARRier:FREQuency?

<carrier_frequency>::=<NRf> value.

<carrier_frequency>::=<NR3> value.

OFDM:CARRIER:FREQUENCY1E9 sets the carrier frequency to 1 GHz.

OFDM:CARRIER:FREQUENCY? might return 1.0000000000E+9, indicating that

the carrier frequency is set to 1 GHz.

2-20 OFDM Signal Modulation Plug-in Programmer Manual

Commands in alphabetical order

OFDM:CARRier

Conditions

Related Commands

Arguments

:POWer

Group

Syntax

Returns

This command sets or returns the signal carrier amplitude (in dBm) for the RF/IF signal format.

SignalformatmustbesettoRF/IF.

Carrier setup

OFDM:CARRier:POWer <power> OFDM:CARRier:POWer?

OFDM:SFORmat

<power>::=<NR3> value.

A single <NR3> value.

Examples

OFDM:CARRIER:POWER —2 sets the carrier power to –2 dBm.

OFDM:CARRIER:POWER? might return 5.0000000000, indicating that the carrier

power is set to 5 dBm.

OFDM Signal Modulation Plug-in Programmer Manual 2-21

Commands in alphabetical order

OFDM:COMPile

Conditions

Examples

(No Query Form)

This command compiles and generates a waveform using the OFDM plug-in compile settings.

The active plug-in must be OFDM.

This is an overlapping command. Overlapping commands run concurrently with other commands, allowing additional commands to start before the overlapping command has ﬁnished.

Group

Syntax

Compile

OFDM:COMPile

OFDM:COMPILE compiles and generates the waveform.

2-22 OFDM Signal Modulation Plug-in Programmer Manual

Commands in alphabetical order

OFDM:COMPile

Conditions

Examples

:CANCel (No Query Form)

This command cancels a compilation currently in progress.

The active plug-in must be OFDM.

Group

Syntax

Compile

OFDM:COMPile:CANCel

OFDM:CO

MPILE:CANCEL

immediately ends the current compile process.

OFDM Signal Modulation Plug-in Programmer Manual 2-23

Commands in alphabetical order

OFDM:COMPile

Related Commands

Arguments

:CASSign

Group

Syntax

Returns

This command sets or returns the state (enabled or disabled) to compile the waveform and immediately assign it to a speciﬁed channel (enabled) or just compile the w

Compile

OFDM:COMPile:CASSign {0|1|OFF|ON} OFDM:COMPile:CASSign?

OFDM:COMPile:CHANnel:RF, OFDM:COMPile:CHANnel:I, OFDM:COMPile:CHANnel:Q, OFDM:COMPile:PLAYOFDM:COMPile:PLAY

0 or OFF will only compile the waveform. OFF or 0 is the default value. 1 or ON will compile and assign the waveform to a channel.

A single <Boolean> value.

aveform (disabled).

Examples

OFDM:COMPILE:CASSIGN 1 enables the compile and assign function.

OFDM:COMPILE:CASSIGN? might return 0, indicating that the compile and

assign function is disabled.

2-24 OFDM Signal Modulation Plug-in Programmer Manual

Commands in alphabetical order

OFDM:COMPile

Arguments

Examples

:CHANnel:I

Group

Syntax

Returns

This command sets or returns the playout channel intended for the compiled I signal when the signal format is set to IQ. The selected channel is also used to deﬁne the amp

If OFDM:COMPile:CASSign is enabled, the waveform is assigned to the speciﬁed ch

Compile

OFDM:COMPile:CHANnel:I <channel> OFDM:COMPile:CHANnel:I?

<channel>::= <NR1> is a valid channel number.

Channel 1 is the default channel.

A single <NR1> value.

OFDM:COMPILE:CHANNEL:I 2 compiles the I signals for channel 2.

litude ranges.

annel.

OFDM:COMPILE:CHANNEL:I? might return 1, indicating that I signals are

compiled for channel 1.

OFDM Signal Modulation Plug-in Programmer Manual 2-25

Commands in alphabetical order

OFDM:COMPile

Conditions

Related Commands

Arguments

:CHANnel:IQ

This command sets or returns the playout channel intended for the compiled IQ signal after up-conversion using the internal IQ modulator.

The selected channel is also used to deﬁne the amplitude ranges.

The Signal Format must be set to IQ and the instrument must have an internal IQ modulator and be enabled.

Group

Syntax

Compile

OFDM:COMPile:CHANnel:IQ <channel> OFDM:COMPile:CHANnel:IQ?

OFDM:COMPile:DUPConverter

<channel>::= <NR1> is a valid channel number.

Channel 1 is the default channel.

Returns

Examples

A single <NR1> value.

OFDM:COMPILE:CHANNEL:IQ 2 compiles the IQ signals for channel 2.

OFDM:COMPILE:CHANNEL:IQ? might return 1, indicating that IQ signals are

compiled for channel 1.

2-26 OFDM Signal Modulation Plug-in Programmer Manual

Commands in alphabetical order

OFDM:COMPile

Arguments

Examples

:CHANnel:Q

This command sets or returns the playout channel intended for the compiled Q signal when the signal format is set to IQ. The selected channel is also used to deﬁne the amp

If OFDM:COMPile:CASSign is enabled, the waveform is assigned to the speciﬁed ch

Group

Syntax

Returns

Compile

OFDM:COMPile:CHANnel:Q <channel> OFDM:COMPile:CHANnel:Q?

<channel>::= <NR1> is a valid channel number.

Channel 1 is the default channel.

A single <NR1> value.

OFDM:COMPILE:CHANNEL:Q 2 compiles the Q signals for channel 2.

litude ranges.

annel.

OFDM:COMPILE:CHANNEL:Q? might return 1, indicating that Q signals are

compiled for channel 1.

OFDM Signal Modulation Plug-in Programmer Manual 2-27

Commands in alphabetical order

OFDM:COMPile

Arguments

Examples

:CHANnel:RF

This command sets or returns the playout channel intended for the compiled RF waveform when the signal format is set to RF/IF. The selected channel is also used to deﬁne

If OFDM:COMPile:CASSign is enabled, the waveform is assigned to the speciﬁed ch

Group

Syntax

Returns

Compile

OFDM:COMPile:CHANnel:RF <channel> OFDM:COMPile:CHANnel:RF?

<channel>::=<NR1> is a valid channel number.

Channel 1 is the default channel.

A single <NR1> value.

OFDM:COMPILE:CHANNEL:RF 2 compiles RF waveforms for channel 2.

the amplitude ranges.

annel.

OFDM:COMPILE:CHANNEL:RF? might return 1, indicating that RF waveforms are

compiled for channel 1.

2-28 OFDM Signal Modulation Plug-in Programmer Manual

Commands in alphabetical order

OFDM:COMPile

Conditions

:CORRection:APPLy

This command sets or returns the Apply Corrections File state (enabled or disabled) for the Compile Settings.

When applying correction ﬁles, you have the capability adjust the frequency response.

When applying an RF correction ﬁle, you can apply a Gaussian ﬁlter/bandwidth or remove Sin(x)/x distortions.

When applying an I/Q correction ﬁle, you can apply a skew.

These settings are global settings controlled by the host instrument. The PI commands to access these settings are provided in the host instrument’s programmer manual.

The Precompensation plug-in is required.

Group

Syntax

Compile

OFDM:COMPile:CORRection:APPLy {1|0|ON|OFF} OFDM:COMPile:CORRection:APPLy?

Related Commands

Arguments

Returns

Examples

OFDM:COMPile:CORRection:PATH

OFF or 0 disables Apply Corrections File. OFF or 0 is the default value.

ON or 1 enables Apply Corrections File.

A single <Boolean> value.

OFDM:COMPILE:CORRECTION:APPLY ON enables Apply Corrections File.

OFDM:COMPILE:CORRECTION:APPLY? might return 0, indicating that Apply

Corrections File is disabled.

OFDM Signal Modulation Plug-in Programmer Manual 2-29

Commands in alphabetical order

OFDM:COMPile

Conditions

Arguments

Examples

:CORRection:PATH

This command sets or returns the RF Correction ﬁlename and ﬁlepath to use when compiling an RF signal.

The signal format must be set to RF.

The Precompensation plug-in is required.

Group

Syntax

Returns

Compile

OFDM:COMPile:CORRection:PATH <filepath> OFDM:COMPile:CORRection:PATH?

<ﬁlepath>::=<string> deﬁnes path to the correction ﬁle.

Asingle<ﬁlepath> string.

OFDM:COMPILE:CORRECTION:PATH "C:\temp\CorrectionFile.corr"

sets the RF Correction ﬁlename and ﬁlepath.

OFDM:COMPILE:CORRECTION:PATH? might return "C:\temp\CorrectionFile.corr" as the RF Correction ﬁlename and

ﬁlepath.

2-30 OFDM Signal Modulation Plug-in Programmer Manual

Commands in alphabetical order

OFDM:COMPile

Conditions

Related Commands

Arguments

:CORRection:PATH:I

This command sets or returns the I Correction ﬁlename and ﬁlepath to use when compiling and IQ signal.

The signal format must be set to IQ.

Apply corrections must be enabled.

Group

Syntax

Returns

Compile

OFDM:COMPile:CORRection:PATH:I <filepath>

OFDM:CO OFDM:COMPile:CORRection:APPLy

<ﬁlep

Asingle<ﬁlepath> string.

MPile:CORRection:TYPE,

ath>::=<string> deﬁnes path to the I correction ﬁle.

Examples

OFDM:COMPILE:CORRECTION:PATH:I "C:\temp\ICorrectionFile.corr"

ﬁlepath.

OFDM:COMPILE:CORRECTION:PATH:I? might return "C:\temp\ICorrectionFile.corr" as the I Correction ﬁlename and ﬁlepath.

sets the I Correction ﬁlename and

OFDM Signal Modulation Plug-in Programmer Manual 2-31

Commands in alphabetical order

OFDM:COMPile

Conditions

Related Commands

Arguments

:CORRection:PATH:IQ

This command sets or returns the IQ Correction ﬁlename and ﬁlepath to use when compiling and IQ signal.

ThesignalformatmustbesettoIQ.

Apply corrections must be enabled.

Group

Syntax

Returns

Compile

OFDM:COMPile:CORRection:PATH:IQ <filepath>

OFDM:CO OFDM:COMPile:CORRection:APPLy

<ﬁlep

Asingle<ﬁlepath> string.

MPile:CORRection:TYPE,

ath>::=<string> deﬁnes path to the IQ correction ﬁle.

Examples

OFDM:COMPILE:CORRECTION:PATH:IQ "C:\temp\ICorrectionFile.corr"

and ﬁlepath.

OFDM:COMPILE:CORRECTION:PATH:IQ? might return "C:\temp\ICorrectionFile.corr" as the IQ Correction ﬁlename

and ﬁlepath.

sets the IQ Correction ﬁlename

2-32 OFDM Signal Modulation Plug-in Programmer Manual

Commands in alphabetical order

OFDM:COMPile

Conditions

Related Commands

Arguments

:CORRection:PATH:Q

This command sets or returns the Q correction ﬁlename and ﬁlepath to use when compiling and IQ signal.

The signal format must be set to IQ.

Apply corrections must be enabled.

Group

Syntax

Returns

Compile

OFDM:COMPile:CORRection:PATH:Q <filepath>

OFDM:CO OFDM:COMPile:CORRection:APPLy

<ﬁlep

Asingle<ﬁlepath> string.

MPile:CORRection:TYPE,

ath>::=<string> deﬁnes path to the Q correction ﬁle.

Examples

OFDM:COMPILE:CORRECTION:PATH:Q "C:\temp\QCorrectionFile.corr"

ﬁlepath.

OFDM:COMPILE:CORRECTION:PATH:Q? might return "C:\temp\QCorrectionFile.corr" as the Q Correction ﬁlename and

ﬁlepath.

sets the Q Correction ﬁlename and

OFDM Signal Modulation Plug-in Programmer Manual 2-33

Commands in alphabetical order

OFDM:COMPile

Conditions

Arguments

Examples

:CORRection:TYPE

This command sets or returns the type of IQ correction ﬁle (a single IQ ﬁle or individual I and Q ﬁles) to apply when compiling.

ThesignalformatmustbesettoIQ.

Group

Syntax

Returns

Compile

OFDM:COMPile:CORRection:TYPE {IQ|BOTH} OFDM:COMPile:CORRection:TYPE?

IQ: The compile process uses a single IQ correction ﬁle.

BOTH: The compile process uses both an I correction ﬁle and a Q correction ﬁle.

IQ|BOTH

OFDM:COMPILE:CORRECTION:TYPE IQ sets the compiler to apply a single IQ

correction ﬁle when compiling.

OFDM:COMPILE:CORRECTION:TYPE? might return BOTH, indicating that the

compiler will apply both an I and Q correction ﬁle to the I and Q signals.

2-34 OFDM Signal Modulation Plug-in Programmer Manual

Commands in alphabetical order

OFDM:COMPile

Conditions

Arguments

:DUPConverter

This command sets or returns the Internal IQ Modulator state (enabled or disabled) when compiling.

When enabled, a complex IQ Waveform is cre ate d which can be used with the internal IQ modulator. Sampling Rate and interpolation rates will be calculated basedonthe

When disabled, a separate I and Q signals are created.

The instrument must have an internal IQ Modulator and the Signal Format set to IQ.

Group

Syntax

Compile

OFDM:COMPile:DUPConverter {0|1|OFF|ON} OFDM:COMPile:DUPConverter?

OFF or 0 disables the internal IQ Modulator. OFF or 0 is the default value.

ON or 1 enables the internal IQ Modulator.

Baseband parameters.

Returns

Examples

A single <Boolean> value.

OFDM:COMPILE:DUPCONVERTER ON enables the internal IQ Modulator.

OFDM:COMPILE:DUPCONVERTER? might return 0, indicating the internal IQ

Modulator is disabled.

OFDM Signal Modulation Plug-in Programmer Manual 2-35

Commands in alphabetical order

OFDM:COMPile

Related Commands

Arguments

Examples

:MARKer:ENABle

This command sets or returns the Marker Data state (enabled or dis abled) for the Compile Settings.

Group

Syntax

Returns

Compile

OFDM:COMPile:MARKer:ENABle {1|0|ON|OFF} OFDM:COMPile:MARKer:ENABle?

OFDM:COMPile:MARKer[n]:MDATa OFDM:COMPile:MARKer[n]:CFRequency

OFF or 0 disables Marker Data. OFF or 0 is the default value.

ON or 1 enables Marker Data.

A single <Boolean> value.

OFDM:COMPILE:MARKER:ENABLE ON enables the Marker Data.

OFDM:COMPILE:MARKER:ENABLE? might return 0, indicating that Marker Data

is disabled.

2-36 OFDM Signal Modulation Plug-in Programmer Manual

Commands in alphabetical order

OFDM:COMPile

Arguments

Examples

:MARKer[n]:CFRequency

This command sets or returns the Marker Data clock frequency when the Marker Data type is set to Clock Frequency.

Group

Syntax

Returns

Compile

OFDM:COMPile:MARKer[n]:CFRequency <frequency> OFDM:COMPile:MARKer[n]:CFRequency?

<frequency>::=<NR3> value.

A single <NR3> value.

OFDM:COMPILE:MARKER1:CFREQUENCY 1E9 sets the Marker 2 Data clock

frequency to 1 GHz.

OFDM:COMPILE:MARKER2:CFREQUENCY? might return 10.0000000000E+6,

indicating the Marker 2 clock frequency is set to 10 MHz.

OFDM Signal Modulation Plug-in Programmer Manual 2-37

Commands in alphabetical order

OFDM:COMPile

Related Commands

Arguments

:MARKer[n]:MDATa

This command sets or returns the Marker Data Type of the speciﬁed marker.

Group

Syntax

Compile

OFDM:COMPile:MARKer[n]:MDATa {SRATe|BRATe|CFRequency} OFDM:COMPile:MARKer[n]:MDATa?

OFDM:COMPile:MARKer:ENABle

[n] ::= speciﬁes the Marker. The number of markers available for the channel is dependent on the instrument model.

If omitted, n is interpreted as 1.

SRATe sets the marker data type sample rate.

BRATe sets the marker data type bit rate.

CFRequency sets the marker data type to clock frequency.

Returns

Examples

SRAT BRAT CFR

OFDM:COMPILE:MARKER1:MDATA BRATE sets the Marker 1 Data type to Bit

Rate.

OFDM:COMPILE:MARKER2:MDATA? might return CFR, indicating that the Marker

2 Data type is based on the clock frequency provided.

2-38 OFDM Signal Modulation Plug-in Programmer Manual

Commands in alphabetical order

OFDM:COMPile

Arguments

Examples

:MODE

Group

Syntax

Returns

This command sets or returns the Create Sequence state (enabled or disabled) of the compiler control. When enabled, a sequence of frames with waveforms is automatical

Compile

OFDM:COMPile:MODE {0|1|ON|OFF} OFDM:COMPile:MODE?

0 or OFF disables creating a sequence. 1 or ON enables disables creating a sequence.

A single <Boolean> value.

OFDM:COMPILE:MODE 1 enables the compiler to automatically create a sequence

with waveforms.

OFDM:COMPILE:MODE? might return 0, indicating that the automatic creation of a

sequence is disabled.

ly created after compilation.

OFDM Signal Modulation Plug-in Programmer Manual 2-39

Commands in alphabetical order

OFDM:COMPile

Arguments

Examples

:NAMe

Group

Syntax

Returns

This commands sets or returns the name of the compiled waveform.

Compile

OFDM:COMPile:NAMe <signal_name> OFDM:COMPile:NAMe?

<signal_name>::=<string> deﬁnes the signal n ame to be created.

A single <signal_name> string.

OFDM:COMPILE:NAME "OFDM_Wfm" sets the waveform name to OFDM_Wfm.

OFDM:COMPILE:NAME? might return "OFDM_Wfm".

2-40 OFDM Signal Modulation Plug-in Programmer Manual

Commands in alphabetical order

OFDM:COMPile

Arguments

Examples

:OSAMpling

This command sets or returns the over sampling rate used to determine the sampling rate of the compiled signal.

The Sampling Rate is calculated by multiplying the Over sampling value with the maximum frequency of the signal to be generated.

Group

Syntax

Returns

Compile

OFDM:COMPile:OSAMpling <Oversampling> OFDM:COMPile:OSAMpling?

Oversampling>::=<NR1> value. Range: 1 to 1000

A single <NR1> value.

OFDM:COMPILE:OSAMPLING 6 sets the over sampling rate to 6.

OFDM:COMPILE:OSAMPLING? might return 4, indicating that the over sampling

rate is set to 4.

OFDM Signal Modulation Plug-in Programmer Manual 2-41

Commands in alphabetical order

OFDM:COMPile

Arguments

Examples

:OVERwrite

This command sets or returns the Overwrite existing waveform state (enabled or disabled) when compiling. When enabled, new waveforms overwrite existing waveforms li numeric sufﬁx added at the end of the waveform name.

Group

Syntax

Returns

Compile

OFDM:COMPile:OVERwrite {1|0|ON|OFF} OFDM:COMPile:OVERwrite?

OFF or 0 disables Overwriting waveforms. OFF or 0 is the default value. ON or 1 enables Overwriting waveforms.

A single <Boolean> value.

OFDM:COMPILE:OVERWRITE 1 enables Overwriting waveforms.

OFDM:COMPILE:OVERWRITE? might return 0, indicating that Overwriting

waveforms is disabled.

st. When disabled, new waveforms are generated with an additional

2-42 OFDM Signal Modulation Plug-in Programmer Manual

Commands in alphabetical order

OFDM:COMPile

Related Commands

Arguments

:PLAY

Group

Syntax

Returns

This command sets or returns the Play after assign state (enabled or disabled) for the Compile Settings.

Play after assign is active only when Compile and assign is enabled.

Compile

OFDM:COMPile:PLAY {0|1|OFF|ON} OFDM:COMPile:PLAY?

OFDM:COMPile:CASSign

OFF or 0 disables Play after assign. OFF or 0 is the default value.

ON or 1 enables Play after assign.

A single <Boolean> value.

Examples

OFDM:COMPILE:PLAY 1 enables Play after assign.

OFDM:COMPILE:PLAY? might return 0, indicating that Play after assign is

disabled.

OFDM Signal Modulation Plug-in Programmer Manual 2-43

Commands in alphabetical order

OFDM:COMPile

Arguments

Examples

:SRATe

Group

Syntax

Returns

This command sets or returns the manual Sampling Rate for the compile settings.

Compile

OFDM:COMPile:SRATe <rate> OFDM:COMPile:SRATe?

<rate>::= <NRf> value.

The maximum sampling rate is dependent on the instrument and instrument options.

A single <NR3> value.

OFDM:COMPILE:SRATE 1E9 sets the Sampling Rate to 1 GS/s in the Compile

settings.

OFDM:COMPILE:SRATE? might return 2.0000000000E+9, indicating that the

sampling rate is 2 GS/s

2-44 OFDM Signal Modulation Plug-in Programmer Manual

Commands in alphabetical order

OFDM:COMPile

Arguments

Examples

:SRATe:AUTO

This command sets or returns the value that indicates if the sampling rate will be automatically calculated at compile time.

Group

Syntax

Returns

Compile

OFDM:COMPile:SRATe:AUTO {0|1|OFF|ON} OFDM:COMPile:SRATe:AUTO?

OFF or 0 disables the sampling rate auto calculation and the manual setting is used.

ON or 1 enables the auto calculation. ON or 1 is the default value.

A single <Boolean> value.

OFDM:COMPILE:SRATE:AUTO ON sets the signal's sampling rate to be

automatically calculated at compile time.

OFDM:COMPILE:SRATE:AUTO? might return 0, indicating that the sampling rate

will not be automatically calculated at compile time.

OFDM Signal Modulation Plug-in Programmer Manual 2-45

Commands in alphabetical order

OFDM:FRAMe:A

Syntax

Arguments

Examples

DD (No Query Form)

This command adds a new frame to the existing list of frames within the Frame List. The new frame is created using the plug-in default settings.

If the name already exists, an error message is displayed.

Group

Frame

OFDM:FRAMe:ADD <frame_name>

<frame_name>::=<string> deﬁnes the frame name to be created.

If no name is given, the name defaults to “Frame_x” where “x” is the next sequential number available.

OFDM:FRAME:ADD "Samp_Frame" adds a frame named Samp_Frame to the

end of the Frame List.

2-46 OFDM Signal Modulation Plug-in Programmer Manual

Commands in alphabetical order

OFDM:FRAMe:D

Conditions

Arguments

Examples

ELete (No Query Form)

This command deletes the speciﬁed frame from the Frame List.

The named frame must exist in the Frames List.

Group

Syntax

Frame

OFDM:FRAMe:DELete <frame_name>

<frame_

OFDM:FRAME:DELETE "Samp_Frame" deletes the frame named Samp_Frame

from the Frame List.

name>::=<string> deﬁnes the frame name to be deleted.

OFDM Signal Modulation Plug-in Programmer Manual 2-47

Commands in alphabetical order

OFDM:FRAMe:F

Arguments

Returns

Examples

SPacing:ENABle

This command sets or returns the status (enabled or disabled) of Frame Spacing for the selected frame.

Group

Syntax

Frame

OFDM:FRAMe:FSPacing:ENABle {0|1|OFF|ON} OFDM:FRAMe:FSPacing:ENABle?

OFF or 0 disables Frame Spacing. ON or 1 enables Frame Spacing. OFF or 0 is the default value.

A single <Boolean> value.

OFDM:FRAME:FSPACING:ENABLE 1 enables Frame Spacing for the selected

frame.

OFDM:FRAME:FSPACING:ENABLE? might return 0, indicating that Frame

Spacing is disabled for the selected frame.

2-48 OFDM Signal Modulation Plug-in Programmer Manual

Commands in alphabetical order

OFDM:FRAMe:F

Arguments

Returns

Examples

SPacing:VALue

This command sets or returns the Frame Spacing (in seconds) for selected fra me.

Group

Syntax

Frame

OFDM:FRAMe:FSPacing:VALue <frame_spacing> OFDM:FRAMe:FSPacing:VALue?

<frame_spacing>::= <NR3> value.

Range: 40 ps to 1 s.

Defaults to 100 μs.

A single <NR3> value.

OFDM:FRAME:FSPACING:VALUE 42E-12 sets the frame spacing to 4 ps for

selected frame.

OFDM:FRAME:FSPACING:VALUE? might return 100.000000000 0E-6,

indicating that the frame spacing is set to 100 μs for selected frame.

OFDM Signal Modulation Plug-in Programmer Manual 2-49

Commands in alphabetical order

OFDM:FRAMe:G

Syntax

Arguments

Returns

Examples

NOise:ENABle

This command sets or returns the Gated Noise state (enabled or disabled) for the selected frame in the Frame List.

Group

Gated noise

OFDM:FRAMe:GNOise:ENABle {0|1|OFF|ON} OFDM:FRAMe:GNOise:ENABle?

OFF or 0 disables Gated Noise. OFF or 0 is the default value. ON or 1 enables adding Gated Noise.

A single <Boolean> value.

OFDM:FRAME:GNOISE:ENABLE ON enables adding Gated Noise.

OFDM:FRAME:GNOISE:ENABLE? might return 0, indicating that Gated Noise is

disabled.

2-50 OFDM Signal Modulation Plug-in Programmer Manual

Commands in alphabetical order

OFDM:FRAMe:G

Syntax

Arguments

Returns

Examples

NOise:FSNR:VALue

This command sets or returns the Gated Noise SNR for the Complete frame for the selected frame.

Group

Gated noise

OFDM:FRAMe:GNOise:FSNR:VALue <snr> OFDM:FRAMe:GNOise:FSNR:VALue?

<snr>::= <NR3> value.

Range: –40 dB to 20 dB.

Defaults to 0 dB.

A single <NR3> value.

OFDM:FRAME:GNOISE:FSNR:VALUE 10 setsGatedNoiseSNRto10dBforthe

Complete Frame for selected frame.

OFDM:FRAME:GNOISE:FSNR:VALUE? might return 5.0000000000, indicating

that the complete frame SNR value is set to 5 dB for selected frame.

OFDM Signal Modulation Plug-in Programmer Manual 2-51

Commands in alphabetical order

OFDM:FRAMe:G

Conditions

Syntax

Related Commands

Arguments

NOise:HEADer:ENABle

This command sets or returns the frame’s Header state for Gated Noise (e nabled or disabled) when Gated Noise is set to Custom for the selected frame in the Frame List.

Gated Noise must be set to Custom.

Group

Gated noise

OFDM:FRAMe:GNOise:HEADer:ENABle {0|1|OFF|ON} OFDM:FRAMe:GNOise:HEADer:ENABle?

OFDM:FRAMe:GNOise:TYPE, OFDM:FRAMe:GNOise:HEADer:VALue

OFF or 0 disables Gated Noise from the frame’s header. ON or 1 enables adding Gated Noise to the frame’s header. ON or 1 is the default value.

Returns

Examples

A single <Boolean> value.

OFDM:FRAME:GNOISE:HEADER:ENABLE ON enables adding Gated Noise to

the frame ’s header.

OFDM:FRAME:GNOISE:HEADER:ENABLE? might return 0, indicating that Gated

Noise is disabled for the frame’s header.

2-52 OFDM Signal Modulation Plug-in Programmer Manual

Commands in alphabetical order

OFDM:FRAMe:G

Conditions

Syntax

Related Commands

Arguments

NOise:HEADer:VALue

This command sets or returns the Gated Noise value for the frame’s header for the selected frame in the Frame List.

Gated Noise must be set to Custom.

Group

Gated nois

OFDM:FRAMe:GNOise:HEADer:VALue <noise_value> OFDM:FRAMe:GNOise:HEADer:VALue?

OFDM:FRAMe:GNOise:TYPE, OFDM:FRAMe:GNOise:HEADer:ENABle

<noise_value>::=<NRf> value. Range: –40 dB to 20 dB.

Default: 0 dB.

Returns

Examples

A single <NR3> value.

OFDM:FRAME:GNOISE:HEADER:VALUE 10 sets the Gated Noise for the frame’s

header to 10 dB.

OFDM:FRAME:GNOISE:HEADER:VALUE? might return 1.0000000000,

indicating that the Gated Noise for the frame’s header is set to 1 dB.

OFDM Signal Modulation Plug-in Programmer Manual 2-53

Commands in alphabetical order

OFDM:FRAMe:G

Conditions

Syntax

Related Commands

Arguments

NOise:PAYLoad:ENABle

This command sets or returns the frame’s Payload state (enabled or disabled) for Gated Noise when Gated Noise is set to Custom for the selected frame in

Group

the Frame Lis

Gated Noise must be set to Custom.

Gated noise

OFDM:FRAMe:GNOise:PAYLoad:ENABle {0|1|OFF|ON} OFDM:FRAMe:GNOise:PAYLoad:ENABle?

OFDM:FRAMe:GNOise:TYPE, OFDM:FRAMe:GNOise:PAYLoad:VALue

OFF or 0 disables Gated Noise from the frame’s payload. ON or 1 enables adding Gated Noise to the frame’s payload. ON or 1 is the default value.

Returns

Examples

A single <Boolean> value.

OFDM:FRAME:GNOISE:PAYLOAD:ENABLE ON enables adding Gated Noise to the

frame’s payload.

OFDM:FRAME:GNOISE:PAYLOAD:ENABLE? might return 0, indicating that Gated

Noise is disabled for the frame’s payload.

2-54 OFDM Signal Modulation Plug-in Programmer Manual

Commands in alphabetical order

OFDM:FRAMe:G

Conditions

Syntax

Related Commands

Arguments

NOise:PAYLoad:VALue

This command sets or returns the Gated Noise value for the frame’s payload for the selected frame in the Frame List.

Gated Noise must be set to Custom.

Group

Gated nois

OFDM:FRAMe:GNOise:PAYLoad:VALue <noise_value> OFDM:FRAMe:GNOise:PAYLoad:VALue?

OFDM:FRAMe:GNOise:TYPE, OFDM:FRAMe:GNOise:PAYLoad:ENABle

<noise_value>::=<NRf> value. Range: –40 dB to 20 dB.

Default: 0 dB.

Returns

Examples

A single <NR3> value.

OFDM:FRAME:GNOISE:PAYLOAD:VALUE 10 sets the Gated Noise for the frame’s

payload to 10 dB.

OFDM:FRAME:GNOISE:PAYLOAD:VALUE? might return 1.0000000000,

indicating that the Gated Noise for the frame’s payload is set to 1 dB.

OFDM Signal Modulation Plug-in Programmer Manual 2-55

Commands in alphabetical order

OFDM:FRAMe:G

Conditions

Syntax

Related Commands

Arguments

NOise:PREamble:ENABle

This command sets or returns the frame’s Preamble state for Gated Noise (enabled or disabled) when Gated Noise is set to Custom for the selected frame in the Frame List.

Gated Noise must be set to Custom.

Group

Gated noise

OFDM:FRAMe:GNOise:PREamble:ENABle {0|1|OFF|ON} OFDM:FRAMe:GNOise:PREamble:ENABle?

OFDM:FRAMe:GNOise:TYPE, OFDM:FRAMe:GNOise:PREamble:VALue

OFF or 0 disables Gated Noise from the frame’s preamble. ON or 1 enables adding Gated Noise to the frame’s preamble. ON or 1 is the default value.

Returns

Examples

A single <Boolean> value.

OFDM:FRAME:GNOISE:PREAMBLE:ENABLE ON enables adding Gated Noise to

the frame’s preamble.

OFDM:FRAME:GNOISE:PREAMBLE:ENABLE? might return 0, indicating that

Gated Noise is disabled for the frame’s preamble.

2-56 OFDM Signal Modulation Plug-in Programmer Manual

Commands in alphabetical order

OFDM:FRAMe:G

Conditions

Syntax

Related Commands

Arguments

NOise:PREamble:VALue

This command sets or returns the Gated Noise value for the frame’s preamble for the selected frame in the Frame List.

Gated Noise must be set to Custom.

Group

Gated nois

OFDM:FRAMe:GNOise:PREamble:VALue <noise_value> OFDM:FRAMe:GNOise:PREamble:VALue?

OFDM:FRAMe:GNOise:TYPE, OFDM:FRAMe:GNOise:PREamble:ENABle

<noise_value>::=<NRf> value. Range: –40 dB to 20 dB.

Default: 0 dB.

Returns

Examples

A single <NR3> value.

OFDM:FRAME:GNOISE:PREAMBLE:VALUE 10 sets the Gated Noise for the

frame’s preamble to 10 dB.

OFDM:FRAME:GNOISE:PREAMBLE:VALUE? might return 1.0000000000,

indicating that the Gated N oise for the frame’s preamble is set to 1 dB.

OFDM Signal Modulation Plug-in Programmer Manual 2-57

Commands in alphabetical order

OFDM:FRAMe:G

Syntax

Related Commands

Arguments

Returns

Examples

NOise:TYPE

This command sets or returns the Gated Noise type for the selected frame in the Frame List.

Group

Gated noise

OFDM:FRAMe:GNOise:TYPE {CFRame|CUSTom} OFDM:FRAMe:GNOise:TYPE?

CFRame: The Gated Noise is applied over the complete frame. CUSTom: The Gated Noise is applied to speciﬁed portions of the frame.

CFR: Complete Frame CUST: Custom

OFDM:FRAME:GNOISE:TYPE CFRame applies the Gated Noise over the entire

frame.

OFDM:FRAME:GNOISE:TYPE? might return CUST, indicating that the Gated

Noise is applied to only speciﬁed portions of the frame.

2-58 OFDM Signal Modulation Plug-in Programmer Manual

Commands in alphabetical order

OFDM:FRAMe:H

Conditions

Arguments

Examples

EADer:ADD (No Query Form)

This command adds a row to the end of the Header custom Symbols table for the selected frame. Symbols are added from the Symbol List (deﬁned in the Symbols

bol name is not provided, a row is added using the ﬁrst deﬁned

Group

Syntax

tab). If a sym symbol in the Symbol List. The Symbol name must be a valid name available in the Symbol List.

When naming a Symbol, the Symbol must exist in the Symbols List. A maximum of 100 rows is allowed.

Header

OFDM:FRAMe:HEADer:ADD <symbol_name>

<symbol_name>::= <string>.

OFDM:FRAME:HEADER:ADD adds the ﬁrst symbol from the Symbol List to the end

of the Header custom symbols table for the selected frame.

OFDM:FRAME:HEADER:ADD "MySymbol23" adds the symbol named

MySymbol23 to the end of the Header custom symbol table for the selected frame.

OFDM Signal Modulation Plug-in Programmer Manual 2-59

Commands in alphabetical order

OFDM:FRAMe:H

Syntax

Arguments

Examples

EADer:DELete (No Query Form)

This command deletes the speciﬁed row from the Header custom symbols table for the selected frame.

Group

Header

OFDM:FRAMe:HEADer:DELete <index>

<index>::= <NR3> value.

OFDM:FRAME:HEADER:DELETE 3 deletes the third row from the Header custom

symbols table for the selected frame.

2-60 OFDM Signal Modulation Plug-in Programmer Manual

Commands in alphabetical order

OFDM:FRAMe:H

Arguments

Returns

Examples

EADer:DOMain

This command sets or returns the Domain for the user supplied header ﬁle for the selected frame.

Group

Syntax

Header

OFDM:FRAMe:HEADer:DOMain {FREquency|TIMe} OFDM:FRAMe:HEADer:DOMain?

FREquency: Sets the domain to Frequency for the user supplied header ﬁle.

TIMe: Sets the domain to Time for the user supplied header ﬁle.

FRE TIM

OFDM:FRAME:HEADER:DOMAIN FREQUENCY sets the Domain for the user

supplied header ﬁle to Frequency for the selected frame.

OFDM:FRAME:HEADER:DOMAIN? might return TIM, indicating that the Domain

for the user supplied header ﬁle is set to Time for the selected frame.

OFDM Signal Modulation Plug-in Programmer Manual 2-61

Commands in alphabetical order

OFDM:FRAMe:H

Syntax

Arguments

Returns

Examples

EADer:ENABle

This command sets or returns the status (enabled or disabled) of the frame Header for the selected frame.

Group

Header

OFDM:FRAMe:HEADer:ENABle {0|1|OFF|ON} OFDM:FRAMe:HEADer:ENABle?

OFF or 0 disables the Header. ON or 1 enables the Header. OFF or 0 is the default value.

A single <Boolean> value.

OFDM:FRAME:HEADER:ENABLE 1 enables the Header f or the selecte d frame.

OFDM:FRAME:HEADER:ENABLE? might return 0, indicating that the Header is

disabled for the selected frame.

2-62 OFDM Signal Modulation Plug-in Programmer Manual

Commands in alphabetical order

OFDM:FRAMe:H

Related Commands

Arguments

Returns

Examples

EADer:MODE

This command sets or returns the Header input method (ﬁle or custom symbols table) for the selected frame.

Group

Syntax

Header

OFDM:FRAMe:HEADer:MODE {FILE|CUSTom} OFDM:FRAMe:HEADer:MODE?

OFDM:FRAMe:HEADer:PATH

FILE: Sets the header input mode to File.

CUSTom: Sets the header input mode to Custom.

FILE CUST

OFDM:FRAME:HEADER:MODE FILE sets the Header input method to use a user

supplied ﬁle for the selected frame.

OFDM:FRAME:HEADER:MODE? might return CUST, indicating that the Header

input method is set to use t he custom symbols table for the selected frame.

OFDM Signal Modulation Plug-in Programmer Manual 2-63

Commands in alphabetical order

OFDM:FRAMe:H

Conditions

Syntax

Related Commands

Arguments

Returns

EADer:PATH

This command se ts or returns the Header ﬁlename and ﬁlepath for the selected frame.

Header input mode must be set to use a ﬁle.

Group

Header

OFDM:FRAMe:HEADer:PATH <filepath> OFDM:FRAMe:HEADer:PATH?

OFDM:FRAMe:HEADer:SELectOFDM:FRAMe:HEADer:MODE

ﬁlepath>::=<string> deﬁnes ﬁlename and ﬁlepath of the Header ﬁle.

Asingle<ﬁlepath> string.

Examples

OFDM:FRAME:HEADER:PATH"C:\HeaderFile.txt" sets the ﬁlename and

ﬁlepath of the header for the selected frame.

OFDM:FRAME:HEADER:PATH? might return "C:\HeaderFile.txt" as the

ﬁlename and ﬁlepath for the header for the selected frame.

2-64 OFDM Signal Modulation Plug-in Programmer Manual

Commands in alphabetical order

OFDM:FRAMe:H

Arguments

Returns

Examples

EADer:REPeat

This command sets or returns the R epeat count for the user supplied header ﬁle for the selected frame.

Group

Syntax

Header

OFDM:FRAMe:HEADer:REPeat <repeat> OFDM:FRAMe:HEADer:REPeat?

Range: 1 to 4096.

Defaults to 1.

A single <NR2> value.

OFDM:FRAME:HEADER:REPEAT 5 sets the repeat count for the header ﬁle to 5

for the selected frame.

OFDM:FRAME:HEADER:REPEAT? might return 12.000 0000000, indicating that

the Repeat count for the header ﬁle is set to 12 for the selected frame.

OFDM Signal Modulation Plug-in Programmer Manual 2-65

Commands in alphabetical order

OFDM:FRAMe:H

Syntax

Arguments

Returns

Examples

EADer:SELect

This command sets or returns the selected (active) row from the Header custom symbols table for the selected frame. Other commands act on the selected row.

Group

Header

OFDM:FRAMe:HEADer:SELect <index> OFDM:FRAMe:HEADer:SELect?

<index>::= <NR3> value.

A single <NR1> value.

OFDM:FRAME:HEADER:SELECT 4 sets the 4

table as the active row for the selected frame.

OFDM:FRAME:HEADER:SELECT? might return 3, indicating that the 3

the Header custom symbols table is selected for the selected frame.

row in the Header custom symbols

row from

2-66 OFDM Signal Modulation Plug-in Programmer Manual

Commands in alphabetical order

OFDM:FRAMe:H

Arguments

Returns

Examples

EADer:SNAMe

This command sets or returns the symbol name for the currently selected row in the Header custom symbol table for the selected frame. The new name must already exis

Group

Syntax

Header

OFDM:FRAMe:HEADer:SNAMe <new_name> OFDM:FRAMe:HEADer:SNAMe?

<new_name>::= <string>. The name must exist in the Symbol List

A single <string> value.

OFDM:FRAME:HEADER:SNAME "Symbol_23" sets t he currently selected row’s

symbol name to "Symbol_23" for the selected frame if it exists in the Symbol List.

OFDM:FRAME:HEADER:SNAME? might return "Symbol_2", indicating that the

currently selected row’s symbol name is Symbol_2 for the selected frame.

t in the Symbol List.

OFDM Signal Modulation Plug-in Programmer Manual 2-67

Commands in alphabetical order

OFDM:FRAMe:H

Conditions

Syntax

Related Commands

Arguments

EADer:SRATe

This command sets or returns the Sampling Rate for the user supplied header ﬁle for the selected frame.

The domain for the u ser supplied header ﬁle must be set to Time.

Group

Header

OFDM:FRAMe:HEADer:SRATe <sample_rate> OFDM:FRAMe:HEADer:SRATe?

OFDM:FRAMe:HEADer:DOMain

<sample_rate>::= <NR3> value.

Range: 10 kHz to 100 GHz.

Defaults to 500 MHz.

Returns

Examples

A single <NR3> value.

OFDM:FRAME:HEADER:SRATE 500E3 sets the Sampling Rate for the header ﬁle

to 500 kHz for selected frame.

OFDM:FRAME:HEADER:SRATE? might return 1.0000000000E+9, indicating that

the Sampling Rate for the header ﬁle is set to 1 GHz for selected frame.

2-68 OFDM Signal Modulation Plug-in Programmer Manual

Commands in alphabetical order

OFDM:FRAMe:H

Arguments

Returns

Examples

EADer:SREPeat

This command sets or returns the Repeat count for the currently selected row in the Header custom symbols table.

Group

Syntax

Header

OFDM:FRAMe:HEADer:SREPeat <repeat_count> OFDM:FRAMe:HEADer:SREPeat?

<repeat_count>::= <NR3> value.

Range: 1 to 4096.

Defaults to 1.

A single <NR3> value.

OFDM:FRAME:HEADER:SREPEAT 3 sets repeat count to 3 for the currently

selected row in t he Header custom symbols table for the selected frame.

OFDM:FRAME:HEADER:SREPEAT? might return 2.0000000000, indicating that

the repeat count value of the selected row in Header custom symbols table is 2 for the selected frame.

OFDM Signal Modulation Plug-in Programmer Manual 2-69

Commands in alphabetical order

OFDM:FRAMe:H

Conditions

Syntax

Related Commands

Arguments

EADer:SSPacing

This command sets or returns the Header Subcarriers Spacing for the user supplied header ﬁle for the selected frame.

The domain for the user supplied header ﬁle must be set to Frequency.

Group

Header

OFDM:FRAMe:HEADer:SSPacing <spacing> OFDM:FRAMe:HEADer:SSPacing?

OFDM:FRAMe:HEADer:DOMain

<spacing>::= <NR3> value.

Range: 1 Hz to 40 MHz.

Defaults to 100 kHz.

Returns

Examples

A single <NR3> value.

OFDM:FRAME:HEADER:SSPACING 5E6 sets the Header Subcarriers Spacing

to 5 MHz for selected frame.

OFDM:FRAME:HEADER:SSPACING? might return 100.0000000000E+3,

indicating that the Subcarrier spacing of the header is 100 kHz for the selected frame.

2-70 OFDM Signal Modulation Plug-in Programmer Manual

Commands in alphabetical order

OFDM:FRAMe:H

Arguments

Returns

Examples

ENable

Group

Syntax

This command sets or returns the status (enabled or disabled) of including a Header for the selected frame.

Header

OFDM:FRAMe:HENable {0|1|OFF|ON} OFDM:FRAMe:HENable?

OFF or 0 disables the Header. ON or 1 enables the Header. OFF or 0 is the default value.

A single <Boolean> value.

OFDM:FRAME:HENABLE 1 enables the Header for the selected frame.

OFDM:FRAME:HENABLE? might return 0, indicating that the Header is disabled

for the selected frame.

OFDM Signal Modulation Plug-in Programmer Manual 2-71

Commands in alphabetical order

OFDM:FRAMe:H

Syntax

Arguments

Returns

Examples

OPPing:ENABle

This command sets or returns the Hopping state (enabled or disabled) for the selected frame in the Frame List.

Group

Hopping

OFDM:FRAMe:HOPPing:ENABle {1|0|ON|OFF} OFDM:FRAMe:HOPPing:ENABle?

OFF or 0 disables Hopping. OFF or 0 is the default value.

ON or 1 enables Hopping.

A single <Boolean> value.

OFDM:FRAME:HOPPING:ENABLE ON enables H opping.

OFDM:FRAME:HOPPING:ENABLE? might return 0, indicating that Hopping is

disabled.

2-72 OFDM Signal Modulation Plug-in Programmer Manual

Commands in alphabetical order

OFDM:FRAMe:H

Arguments

Returns

Examples

OPPing:HTIMe

This command sets or returns the Hop Time type for the selected frame in the Frame List.

Group

Syntax

Hopping

OFDM:FRAMe:HOPPing:HTIMe {SPHop|SSINdex} OFDM:FRAMe:HOPPing:HTIMe?

SPHop sets Hop Time to Symbols Per Hop.

SSINdex sets Hop Time to Symbol Start Index.

SPH SSIN

OFDM:FRAME:HOPPING:HTIME SPH setstheHopTimetoSymbolsPerHop.

OFDM:FRAME:HOPPING:HTIME? might return SSIN, indicating that the Hop

Time is set to Symbol Start Index.

OFDM Signal Modulation Plug-in Programmer Manual 2-73

Commands in alphabetical order

OFDM:FRAMe:H

Syntax

Related Commands

Examples

OPPing[:LIST]:ADD (No Query Form)

This command adds a single entry to the end of the Frequency Hop List for the selected frame in the Frame List

Group

Hopping

OFDM:FRAMe:HOPPing[:LIST]:ADD

OFDM:FRAMe:HOPPing[:LIST]:DELete, OFDM:FRAMe:HOPPing[:LIST]:INSert

OFDM:FRAME:HOPPING:LIST:ADD creates a single entry to the end of the Hop

List table.

2-74 OFDM Signal Modulation Plug-in Programmer Manual

Commands in alphabetical order

OFDM:FRAMe:H

Arguments

Returns

Examples

OPPing[:LIST]:AOFFset

This command sets or returns the Amplitude Offset of the currently selected hop of the currently selected hop in the Frequency Hop List for the selected frame

ist.

Group

Syntax

in the Frame L

Hopping

OFDM:FRAMe:HOPPing[:LIST]:AOFFset <offset> OFDM:FRAMe:HOPPing[:LIST]:AOFFset?

<offset>::= <NR3> value. Range: –100 dBm to 0 dBm. Default: 0 dBm.

A single <NR2> value.

OFDM:FRAME:HOPPING:LIST:AOFFSET –10 sets t he Amplitude Offset of the

currently selected hop index to –10 dB.

OFDM:FRAME:HOPPING:LIST:AOFFSET? might return -15.0000000000,

indicating that the Amplitude Offset of the currently selected hop is set to –15 dB.

OFDM Signal Modulation Plug-in Programmer Manual 2-75

Commands in alphabetical order

OFDM:FRAMe:H

Syntax

Returns

Examples

OPPing[:LIST]:COUNt? (Query Only)

This command returns the number of hops in the Hop List for the selected frame in the Frame List.

Group

Hopping

OFDM:FRAMe:HOPPing[:LIST]:COUNt?

A single <NR1> value.

OFDM:FRAME:HOPPING:LIST:COUNT? might return 15, indicating that there

are 15 entries in the Hop list.

2-76 OFDM Signal Modulation Plug-in Programmer Manual

Commands in alphabetical order

OFDM:FRAMe:H

Related Commands

Arguments

Examples

OPPing[:LIST]:DELete (No Query Form)

This command removes entries from the Frequency Hop List for the selected frame in the Frame List.

Group

Syntax

Hopping

OFDM:FRAMe:HOPPing[:LIST]:DELete {ALL|<index>}

OFDM:FRAMe:HOPPing[:LIST]:COUNt?,OFDM:FRAMe:HOPPing[:LIST]: INSert, OFDM:FRAMe:HOPPing[:LIST]:ADD

ALL – Deletes all entries in the Hop List table.

<index>::= <NR1> value. Speciﬁes the index number to delete from the Hop List table.

OFDM:FRAME:HOPPING:LIST:DELETE ALL removes all entries from the Hop

List table.

OFDM Signal Modulation Plug-in Programmer Manual 2-77

Commands in alphabetical order

OFDM:FRAMe:H

Syntax

Arguments

Returns

Examples

OPPing[:LIST]:FREQuency

This command sets or returns the Frequency of the currently selected hop in the Frequency Hop List for the selected frame in the Frame List.

Group

Hopping

OFDM:FRAMe:HOPPing[:LIST]:FREQuency <frequency> OFDM:FRAMe:HOPPing[:LIST]:FREQuency?

<frequency>::= <NRf> value. Range: 1 Hz to 2.5 GHz. Default: 1 GHz.

A single <NR2> value.

OFDM:FRAME:HOPPING:LIST:FREQUENCY 1E9 sets the Frequency to 1 GHz of

the currently selected hop index.

OFDM:FRAME:HOPPING:LIST:FREQUENCY? might r eturn 1000000000,

indicating that the Frequency of the currently selected hop index is set to 100 MHz.

2-78 OFDM Signal Modulation Plug-in Programmer Manual

Commands in alphabetical order

OFDM:FRAMe:H

Related C

ommands

Arguments

Examples

OPPing[:LIST]:INSert (No Query Form)

This command inserts a single entry into the Frequency Hop List above the speciﬁed index for the selected frame in the Frames List. The selected entry point

existintheHopListtable.

FRAME:HOPPING:LIST:INSERT 10

Group

Syntax

must already

Hopping

OFDM:FRAMe:HOPPing[:LIST]:INSert <insertion>

OFDM:FRAMe:HOPPing[:LIST]:COUNt?, OFDM:FRAMe:HOPPing[:LIST]:DELete, OFDM:FRAMe:HOPPing[:LIST]:ADD

<insertion>::= <NR1> value.

OFDM:

indexintheHopListtable.

inserts a single entry above the 10th

OFDM Signal Modulation Plug-in Programmer Manual 2-79

Commands in alphabetical order

OFDM:FRAMe:H

Syntax

Arguments

Returns

Examples

OPPing[:LIST]:RFRequency

This command sets or returns the Frequency Offset (Relative Frequency) of the currently selected hop in the Frequency Hop List for the selected frame in the Frame List.

Group

Hopping

OFDM:FRAMe:HOPPing[:LIST]:RFRequency <frequency> OFDM:FRAMe:HOPPing[:LIST]:RFRequency?

<frequency>::= <NRf> value. Range: -999.999999 MHz to 1.5 GHz. Default: 0 Hz.

A single <NR2> value.

OFDM:FRAME:HOPPING:LIST:RFREQUENCY 1E9 sets the Relative Frequency to

1 GHz of the currently selected hop index.

OFDM:FRAME:HOPPING:LIST:RFREQUENCY? might return 1000000, indicating

that the Relative Frequency of the currently selected hop index is set to 10 MHz.

2-80 OFDM Signal Modulation Plug-in Programmer Manual

Commands in alphabetical order

OFDM:FRAMe:H

Arguments

Returns

Examples

OPPing[:LIST]:SELect

This command sets or returns the selected Hop number in the Frequency Hop List for the selected frame in the Frame List.

Group

Syntax

Hopping

OFDM:FRAMe:HOPPing[:LIST]:SELect <index> OFDM:FRAMe:HOPPing[:LIST]:SELect?

<index>::= <NR1> value.

A single <NR1> value.

OFDM:FRAME:HOPPING:LIST:SELECT 3 selects index 3 in the hopping table

(Hop list).

OFDM:FRAME:HOPPING:LIST:SELECT? might return 1, indicating that index 1

is currently selected in the hopping table (Hop list).

OFDM Signal Modulation Plug-in Programmer Manual 2-81

Commands in alphabetical order

OFDM:FRAMe:H

Conditions

Syntax

Related Commands

Arguments

Returns

Examples

OPPing[:LIST]:SSINdex

This command sets or returns the Symbol Start Index (Symbol Index) for the selected frame in the Frame List.

The Hop Time must be set to Symbol Start Index.

Group

Hopping

OFDM:FRAMe:HOPPing[:LIST]:SSINdex <start_index> OFDM:FRAMe:HOPPing[:LIST]:SSINdex?

OFDM:FRAMe:HOPPing:HTIMe

<start_index>::= <NR1> value.

A single <NR1> value.

OFDM:FRAME:HOPPING:LIST:SSINDEX 10 sets the Symbol Start Index to

symbol 10.

OFDM:FRAME:HOPPING:LIST:SSINDEX? might return 6, indicating that the

Symbol Start Index is set to 6.

2-82 OFDM Signal Modulation Plug-in Programmer Manual

Commands in alphabetical order

OFDM:FRAMe:H

Conditions

Arguments

Returns

Examples

OPPing:RLISt

This command sets or returns the Repeat List state (enabled or disabled) for the Frequency Hop List for the selected frame in the Frame List. When enabled, the Frequency Ho

The Hop Time must be set to Symbols Per Hop.

Group

Syntax

Hopping

OFDM:FRAMe:HOPPing:RLISt {1|0|ON|OFF} OFDM:FRAMe:HOPPing:RLISt?

OFF or 0 disables Repeat List. OFF or 0 is the default v alue.

ON or 1 enables Repeat List.

A single <Boolean> value.

OFDM:FRAME:HOPPING:RLIST 1 enables the Repeat List so that the Frequency

Hop List repeats when the Hop List has been completed.

p List repeats when the Hop List has been completed.

OFDM:FRAME:HOPPING:RLIST? might return 0, indicating that the Repeat List

is disabled so that the Frequency Hop List is not repeated.

OFDM Signal Modulation Plug-in Programmer Manual 2-83

Commands in alphabetical order

OFDM:FRAMe:H

Conditions

Syntax

Related Commands

Arguments

Returns

OPPing:SPHop

This command sets or returns the Symbols per Hop for the selected frame in the Frame List.

The Hop Time must be set to Symbols Per Hop.

Group

Hopping

OFDM:FRAMe:HOPPing:SPHop <symbols> OFDM:FRAMe:HOPPing:SPHop?

OFDM:FRAMe:HOPPing:HTIMe

<symbols>::= <NRf> value. Range: 1 to 5000000. Default: 1.

A single <NR1> value.

Examples

OFDM:FRAME:HOPPING:SPHOP 50 sets the Symbols Per Hop to 50 symbols.

OFDM:FRAME:HOPPING:SPHOP? might return 1200, indicating that the Symbols

per Hop is set to 1200.

2-84 OFDM Signal Modulation Plug-in Programmer Manual

Commands in alphabetical order

OFDM:FRAMe:M

Syntax

Related Commands

Arguments

Example

ULTipath:ADD (No Query Form)

This command adds a new path in the Multipath table for the selected frame in the Frame List.

Group

Multipath

OFDM:FRAMe:MULTipath:ADD <path>

OFDM:FRAMe:MULTipath:REMove

<path>::= <NR1> value.

OFDM:FRAME:MULTIPATH:ADD 2 adds a new path to the end of the Multipath

table.

OFDM Signal Modulation Plug-in Programmer Manual 2-85

Commands in alphabetical order

OFDM:FRAMe:M

Syntax

Related Commands

Arguments

Returns

Examples

ULTipath:AMPLitude

This command sets or returns the Multipath Amplitude of the currently selected path for the selected frame in the Frame List.

Group

Multipath

OFDM:FRAMe:MULTipath:AMPLitude <amplitude> OFDM:FRAMe:MULTipath:AMPLitude?

OFDM:FRAMe:MULTipath:SELect

<amplitude>::= <NR3> value. Range: –100 dB to 0 dB. Default: 0 dB.

A single <NR3> value.

OFDM:FRAME:MULTIPATH:AMPLITUDE –10 sets the M ultipath Amplitude of

theselectedpathto–10dB.

OFDM:FRAME:MULTIPATH:AMPLITUDE? might return -2 00.0000000000E-3,

indicating that the Amplitude of the s elected path is –0.2 dB.

2-86 OFDM Signal Modulation Plug-in Programmer Manual

Commands in alphabetical order

OFDM:FRAMe:M

Syntax

Related Commands

Arguments

Returns

Examples

ULTipath:DELay

This command sets or returns the Multipath Delay in seconds of the currently selected path for the selected frame in the Frame List.

Group

Multipath

OFDM:FRAMe:MULTipath:DELay <delay> OFDM:FRAMe:MULTipath:DELay?

OFDM:FRAMe:MULTipath:SELect

<delay>::= <NR3> value. Range:0sto1s. Default: 0 s.

A single <NR3> value.

OFDM:FRAME:MULTIPATH:DELAY 1 sets the Multipath symbol Delay of the

currently selected path to 1 second.

OFDM:FRAME:MULTIPATH:DELAY? might return 200.0000000000E–3,

indicating that the Multipath Delay of the currently selected path is 200 ms.

OFDM Signal Modulation Plug-in Programmer Manual 2-87

Commands in alphabetical order

OFDM:FRAMe:M

Syntax

Arguments

Returns

Examples

ULTipath:ENABle

This command sets or returns the Multipath state (enabled or disabled) for the selected frame in the Frame List.

Group

Multipath

OFDM:FRAMe:MULTipath:ENABle {1|0|ON|OFF} OFDM:FRAMe:MULTipath:ENABle?

OFF or 0 disables Multipath. OFF or 0 is the default value.

ON or 1 enables Multipath.

A single <Boolean> value.

OFDM:FRAME:MULTIPATH:ENABLE 1 enables Multipath.

OFDM:FRAME:MULTIPATH:ENABLE? might return 0 , indicating that Hopping is

disabled.

2-88 OFDM Signal Modulation Plug-in Programmer Manual

Tektronix OFDM Programmer

Specifications and Main Features

Frequently Asked Questions

User Manual