/

Tektronix

/

Tektronix AFG3151C

SCPI COMMAND REFERENCE

Tektronix AFG3151C

Tektronix AFG3151C

The Tektronix AFG3151C is Tektronix's arbitrary waveform generator in the AFG3000 / AFG3000B / AFG3000C Series family. Its SCPI remote-control interface exposes 248 commands across 18 subsystems - 130 settable and 118 queries - and every command is documented here with its parameters, accepted values, return format, and a copy-paste PyVISA example for automating test and measurement.

248

Commands

130

Settable

118

Queries

18

Subsystems

SCPI

Verified

2026-07-16

All commands

Performs an internal calibration. The related query form returns 0 (Pass) or a calibration error code.

Performs an internal calibration and returns the result of the calibration. The operation may take several minutes to complete.

integer - 0 indicates that the internal calibration completed without errors; nonzero indicates that the arbitrary function generator detected an error.
CALIBRATION[:ALL]?

Queries the calibration function. The table lists the command as supported in SCPI 1999.0.

NameTypeValuesDescription
ALLoptenum-Optional node shown in the syntax line.

Performs a self-test. The query form returns the test result after executing the self-test.

integer - 0 indicates the self-test completed without errors; a nonzero value indicates the arbitrary function generator detected an error.
DIAGNOSTIC[:ALL]
DIAGNOSTIC[:ALL]?

Performs a self-test. The query form returns the results after executing the test.

integer - Returns <NR1>, where 0 indicates the self-test completed without errors and nonzero indicates the arbitrary function generator detected an error.
DIAGNOSTIC[:ALL]
DIAGNOSTIC[:ALL]?

Returns the diagnostic state. The command supports the optional ALL node.

enum - Returns the diagnostic state.

Sets or queries the contrast of the LCD display. Available for AFG3000 series and AFG3000B series instruments.

NameTypeValuesDescription
contrastreal0.00 - 1.00Display contrast level; larger values increase screen contrast.
qualifieroptenumMINimum | MAXimumSets the contrast to the minimum or maximum level.
returns

Sets or queries the screen saver setting of the LCD display. When enabled, the screen saver function starts automatically if no operations are applied to the instrument front panel for five minutes.

NameTypeValuesDescription
stateenumON | OFFScreen saver enable state.
enum - Returns the current screen saver setting.
DISPlay:SAVer:STATe ON
DISPlay:SAVer:STATe?

Sets or queries the screen saver setting of the LCD display. When enabled, the screen saver function starts automatically if no operations are applied to the instrument front panel for five minutes.

enum - Returns the current screen saver setting.
DISPlay:SAVer[:STATe]?

Displays a text message on the instrument screen. The query form returns the text string currently displayed on the instrument screen.

NameTypeValuesDescription
stringstring-Text message to display.

Returns the text string currently displayed on the instrument screen. The displayable characters are ASCII codes 32 through 126, and the instrument can display approximately 64 characters.

string - The currently displayed text message.
DISPLAY[:WINDOW]:TEXT[:DATA]?

Sets or queries the display contrast.

real - Returns the present display contrast setting.

Immediately executes the display saver operation. The command is listed as supported in the SCPI conformance table.

Sets or queries the text displayed in the display window. The optional DATA node is shown in the conformance table for this command.

string - Returns the text displayed in the display window.

*ESEset / query

Sets or queries the bits in the Event Status Enable Register (ESER) used in the status and events reporting system. The query returns the contents of the ESER.

NameTypeValuesDescription
bit_valueinteger0 - 255Binary bits of the ESER are set according to this value.
integer - Contents of the ESER as a decimal integer.
*ESE 177
*ESE?
*PSCset / query

Sets and queries the power-on status clear flag that controls automatic power-on execution of SRER and ESER. When true, SRER and ESER are cleared to 0 at power-on; when false, their current values are preserved in nonvolatile memory and restored at power-on.

NameTypeValuesDescription
NR1integer00 disables the power-on clear and allows the instrument to possibly assert SRQ after power-on; any nonzero value enables the power-on status clear and prevents SRQ assertion after power-on.
integer - Returns the power-on status clear flag value.
*PSC 0
*OPCset / query

Sets the Operation Complete bit in the Standard Event Status Register when all pending operations have completed. The bit is set following the *OPC command.

*ESCset / query

Clears the instrument status structure. This command is part of the standard event/status system commands.

*SREset / query

Sets the bits of the Service Request Enable Register (SRER). Bit 6 must be 0.

NameTypeValuesDescription
bit valueinteger0 - 255Bit pattern to load into the SRER.
*CAL?query

Checks calibration status. This is listed as a SCPI conformance command with an optional ALL node in the manual table.

enum - Returns the calibration status.
*CLSset / query

Clears the status data structures. This command is defined in SCPI 1999.0.

*ESE?query

Sets or queries the Event Status Enable register.

integer - Returns the contents of the Event Status Enable register.
*ESR?query

Returns the event status register value.

integer - Returns the event status register value.
*IDN?query

Returns the instrument identification string.

string - Returns the identification string.
*OPC?query

Returns a synchronization message indicating that all previous commands have been received and processed.

enum - Returns the OPC status when all previous commands have been completed.
*OPT?query

Returns the instrument options information.

string - Returns the installed options information.
*RCLset / query

Recalls the instrument state from a previously saved setup register.

*RSTset / query

Resets the instrument to its default state.

*SAVset / query

Saves the current instrument state to nonvolatile memory.

*STB?query

Returns the status byte value.

integer - The status byte value.
*TRGset / query

Triggers the device. This command is listed as not defined in SCPI 1999.0.

*TST?query

Returns the self-test result.

integer - Returns the self-test result.
*WAIset / query

Waits until all previously received commands have been executed before processing further commands.

Sets or queries whether to lock the specified setup memory. Locked setup memories cannot be overwritten or deleted, and location 0 cannot be used.

NameTypeValuesDescription
locationinteger1 - 4Specifies the setup memory location to lock or query.
stateenumON | OFF | <NR1>Locks or unlocks the specified setup memory; ON or nonzero locks it, OFF or zero allows overwrite or delete.
integer - Returns the lock state of the specified setup memory as <NR1>.
MEMORY:STATE:LOCK 1,ON

Sets or queries whether automatic recall of the last setup memory is enabled when the instrument is powered on. If OFF, the default setups are recalled instead.

NameTypeValuesDescription
stateenumON | OFF | <NR1>Enables or disables last-setup recall; <NR1>≠0 enables and <NR1>=0 disables.
enum - Returns the present state of automatic setup recall.
MEMORY:STATE:RECALL:AUTO ON

Deletes a stored memory state. The command is listed in the SCPI conformance table as supported by the instrument.

Locks or unlocks the memory state. The command is listed in the SCPI conformance table with an optional state parameter and a query form.

NameTypeValuesDescription
stateoptenumLOCK | UNLockState of the memory-state lock.
enum - Returns the current memory-state lock status.

Recalls a saved memory state automatically. The command is listed under the MEMORY:STATE subsystem and accepts the optional AUTO node.

Checks whether a stored memory state name is valid.

boolean - Returns whether the memory state is valid.

Sets or queries whether to lock a file or directory in mass storage. If locked, the file or directory cannot be overwritten or deleted.

NameTypeValuesDescription
file_namestring-File or directory name in mass storage to lock or unlock.
stateenumON | OFF | <NR1>Locks when ON or nonzero, and allows overwrite or delete when OFF or zero.
integer - Returns <NR1>, where 1 indicates locked and 0 indicates unlocked.
MMEMORY:LOCK[:STATE] ”SETUP1.TFS”,ON

Returns the names of files and directories in the current MMEMory directory. The command is listed as supported in the SCPI conformance table.

string - Returns a catalog listing for the current MMEMory directory.

Changes or queries the current working directory used by MMEMory file operations. The syntax list marks this command with optional query form "(?)", but this slice does not document any return value or parameters.

Loads a state file from external memory. The command is listed as a supported MMEMory load operation.

Loads a file from mass memory into the specified memory area. The command supports loading either a state file or a trace file.

NameTypeValuesDescription
traceenumTRACeSelects trace loading.

Returns the current lock state of the MMEMory subsystem. The state can be queried with an optional STATe node.

enum - Returns the current memory lock state.

Stores the current state into a mass memory state location.

NameTypeValuesDescription
stateinteger-State location to store the current state to.

Stores a trace file in mass memory. The command is listed as a supported MMEMory store operation.

Sets the output load impedance for the specified channel. The value is used for amplitude, offset, and high/low level settings; the current impedance can be queried with the corresponding '?' form.

NameTypeValuesDescription
channeloptenum1 | 2Specifies output channel 1 or 2.
ohmsreal1 - 10 kΩSets the load impedance in ohms.
qualifieroptenumINFinity | MINimum | MAXimumSpecial impedance setting keywords.
OUTPut[1|2]:IMPedance {<ohms>|INFinity|MINimum|MAXimum}
OUTPut[1|2]:IMPedance?

Inverts a specified output waveform relative to the offset level. The query returns the polarity for the specified channel.

NameTypeValuesDescription
polarityenumNORMal | INVertedSets the specified output waveform polarity.
enum - Returns the polarity for the specified channel.
OUTPut1:POLarity NORMal

Sets or queries the mode for the Trigger Output signal. TRIGger and SYNC differ when burst count is set to Inf-Cycles; otherwise they have the same effect.

enum - Returns the current Trigger Output mode.
OUTPUT:TRIGGER:MODE SYNC

Sets or queries the output state for output 1 or 2. ON or a nonzero numeric value enables the arbitrary function generator output; OFF or zero disables it.

NameTypeValuesDescription
stateenumON | OFFTurns the arbitrary function generator output on or off.
integer - Returns the output state as an NR1 value.
OUTPUT1:STATE ON sets the arbitrary function generator CH 1 output to ON.

Sets or queries the trigger mode for the selected output. The output trigger mode is documented in the SCPI conformance table as a supported command.

enum - Returns the current output trigger mode.

Returns the output impedance setting for output 1 or 2.

enum - Returns the present output impedance setting.

Returns the output polarity for the selected output channel.

enum - Returns the current output polarity setting for output 1 or 2.

Sets or queries the output state of output 1 or 2. The command applies to the selected output channel.

NameTypeValuesDescription
stateoptenumON | OFFTurns the output on or off.
enum - Returns the current output state of the selected output channel.

Sets or queries the AM modulation depth for the specified channel. The depth can be set from 0.0% to 120.0% with 0.1% resolution.

NameTypeValuesDescription
depthreal0.0 - 120.0Modulation depth in percent.
qualifieroptenumMINimum | MAXimumSets the modulation depth to the minimum or maximum value.
real (%) - Returns the modulation depth.
SOURce1:AM:DEPth MAXimum

Sets or queries the internal AM modulation frequency for the specified source channel. The frequency can be given as a value with units, or as MINimum/MAXimum.

NameTypeValuesDescription
frequencyrealHzModulation frequency to set.
qualifieroptenumMINimum | MAXimumSelects the minimum or maximum allowed frequency.
real (Hz) - Returns the modulation frequency.
SOURce1:AM:INTernal:FREQuency 10kHz

Sets or queries the modulating waveform used for AM internal modulation on the specified channel. It can be used only when the internal modulation source is selected; specifying EFILe without a defined file causes an error.

NameTypeValuesDescription
functionenumSINusoid | SQUare | TRIangle | RAMP | NRAMp | PRNoise | USER[1] | USER2 | USER3 | USER4 | EMEMory[1] | EMEMory2 | EFILeModulating waveform to use for AM internal modulation.
SOURce1:AM:INTernal:FUNCtion SINusoid

Sets or queries the EFILe name used as the modulating waveform for AM modulation. The file name must exist in the mass storage system; the command returns a blank string if no file is stored.

NameTypeValuesDescription
file_namestring-File name in the mass storage system, including path with forward slashes (/).
string - Returns the current file name, or a blank string if there is no file in mass storage.
SOURce1:AM:INTernal:FUNCtion:EFILe “SAMPLE1”

Sets or queries the AM modulation source for the specified channel. The internal source modulates the carrier with an internal source; the external source modulates it with an external source.

NameTypeValuesDescription
sourceenumINTernal | EXTernalSelects the AM modulation source.
enum - Returns the current AM modulation source.
SOURce1:AM:SOURce INTernal

Enables or disables AM modulation for the specified channel. The query command returns the state of AM modulation.

NameTypeValuesDescription
stateenumON | OFFON enables AM modulation; OFF disables AM modulation.
valueinteger0<NR1> where nonzero enables AM modulation and 0 disables it.
integer - Returns the AM modulation state as <NR1>.
SOURce1:AM:STATe ON

Sets or queries the burst mode for the specified source channel. Triggered mode is selected with TRIGgered and gated mode with GATed.

NameTypeValuesDescription
modeenumTRIGgered | GATedSelects the burst mode.
enum - Returns the current burst mode as TRIG or GAT.
SOURce1:BURSt:MODE TRIGgered

Sets or queries the number of cycles (burst count) to be output in burst mode for the specified channel. The query returns 9.9E+37 if the burst count is set to INFinity.

NameTypeValuesDescription
cyclesinteger1 - 1000000Burst count to output in burst mode.
qualifieroptenumINFinity | MINimum | MAXimumAllows setting the burst count to infinite, minimum, or maximum count.
integer - Returns the burst count. If the burst count is set to INFinity, the query returns 9.9E+37.
SOURce1:BURSt:NCYCles 2

Sets or queries the delay time in burst mode for the specified channel. The delay is the time between the trigger and the signal output and is available only in Triggered burst mode.

NameTypeValuesDescription
delayreal0.0 ns - 85.000 sDelay time value, expressed as <NRf> with units s, ms, μs, or ns.
qualifieroptenumMINimum | MAXimumSets the delay time to the minimum or maximum value.

Enables or disables burst mode for the specified channel. The query returns the burst mode state.

NameTypeValuesDescription
stateenumON | OFFEnables or disables burst mode.
integer - Returns the burst mode state.
SOURce1:BURSt:STATe ON

Sets or queries whether to add internal noise or an external signal to the specified channel output signal. Internal noise level is set or queried with the related SOURce<3|4>:POWer[:LEVel][:IMMediate][:AMPLitude] command.

NameTypeValuesDescription
stateoptenumNOISe | EXTernal | BOTH | Selects internal noise, an external signal, both, or disables the add function.
enum - Returns the current feed setting: “NOIS”, “EXT”, “BOTH”, or “” (disabled).
SOURce1:COMBine:FEED EXTernal

Sets the internal modulation frequency of FM modulation for the specified channel. This command is only valid when the internal modulation source is selected.

NameTypeValuesDescription
frequencyreal2 mHz - 50.00 kHzInternal FM modulation frequency.
qualifieroptenumMINimum | MAXimumSelects the minimum or maximum allowed frequency.

Sets or queries the peak frequency deviation of FM modulation for the specified channel. The setting range depends on the selected carrier waveform.

NameTypeValuesDescription
deviationrealHzPeak frequency deviation.
qualifieroptenumMINimum | MAXimumUse MINimum or MAXimum to set or query the extreme deviation value.
real (Hz) - Returns the peak frequency deviation.
SOURce1:FM:DEViation 1.0MHz

Sets or queries the modulating waveform used for internal FM modulation on the specified channel. This command can only be used when the internal modulation source is selected; specifying EFILe without a defined EFILe causes an error.

NameTypeValuesDescription
waveformenumSINusoid | SQUare | TRIangle | RAMP | NRAMp | PRNoise | USER[1] | USER2 | USER3 | USER4 | EMEMory[1] | EMEMory2 | EFILeModulating waveform to select for FM internal modulation.

Sets or queries the EFILe name used as a modulating waveform for FM modulation. The file name must exist in the mass storage system; if no file is present, the command returns a blank string.

NameTypeValuesDescription
file_namestring-Specifies a file name in the mass storage system, including path.
string - Returns the file name of the EFILe used as the modulating waveform, or a blank string if there is no file in mass storage.
SOURce1:FM:INTernal:FUNCtion:EFILe “SAMPLE1”

Sets or queries the source of the FM modulating signal for the specified channel.

NameTypeValuesDescription
sourceoptenumINTernal | EXTernalSelects the FM modulating source.
enum - Returns the current FM modulating source.

Enables or disables FM modulation for the specified source channel. The query returns the state of FM modulation.

NameTypeValuesDescription
stateenumON | OFF | <NR1>ON or <NR1>≠0 enables FM modulation; OFF or <NR1>=0 disables FM modulation.
<NR1> - Returns the state of FM modulation.
SOURce1:FM:STATe ON

Sets or queries the center frequency of sweep for the specified channel. It is always used with the [SOURce[1|2]]:FREQuency:SPAN command, and the valid range depends on the selected sweep waveform.

NameTypeValuesDescription
frequencyreal-Center frequency value.
qualifieroptenumMINimum | MAXimumUse MINimum or MAXimum instead of an explicit frequency value.

Enables or disables the concurrent copy function for frequency (or period) between channels. For the query form, returns "0" for off or "1" for on.

NameTypeValuesDescription
stateoptenumON | OFF | <NR1>Enables or disables the concurrent copy function.
integer - Returns "0" when the concurrent copy function is off and "1" when it is on.
SOURce1:FREQuency:CONCurrent ON

Sets or queries the frequency sweep state for the specified source channel. The sweep state is associated with selecting sine, square, ramp, or arbitrary waveform for sweep.

Sets or queries the frequency of the output waveform for the specified channel. Available when Run Mode is set to other than Sweep; the frequency range depends on waveform type.

NameTypeValuesDescription
frequencyrealHzOutput frequency value, optionally followed by units.
qualifieroptenumMINimum | MAXimumSelects the minimum or maximum allowable frequency value.
real (Hz) - Returns the output frequency.
SOURce1:FREQuency:FIXed 500kHz

Sets or queries the span of frequency sweep for the specified channel. It is always used with the frequency center command, and the allowable span depends on the selected sweep waveform.

NameTypeValuesDescription
frequencyrealHzThe frequency span.
qualifieroptenumMINimum | MAXimumSelects the minimum or maximum span value.
real (Hz) - The frequency span.

Sets or queries the start frequency of sweep for the specified channel. The start frequency setting depends on the selected sweep waveform and is used with the corresponding stop frequency command.

NameTypeValuesDescription
frequencyrealHzStart frequency.
qualifieroptenumMINimum | MAXimumSelects the minimum or maximum allowable start frequency.
real (Hz) - Returns the start frequency.
SOURce1:FREQuency:STARt 10kHz

Sets or queries the stop frequency for the specified source channel. The value may be entered directly or as MINimum or MAXimum.

NameTypeValuesDescription
frequencyrealHzStop frequency to set.
qualifieroptenumMINimum | MAXimumUse a boundary value instead of an explicit frequency.
real (Hz) - Returns the stop frequency.
SOURce1:FREQuency:STOP 100KHz 100KHz

Sets or queries the hop frequency of FSK modulation for the specified channel.

NameTypeValuesDescription
frequencyrealHzHop frequency value.
qualifieroptenumMINimum | MAXimumSelects the minimum or maximum hop frequency.
real (Hz) - Returns the hop frequency.
SOURce1:FSKey:FREQuency 1.0MHz

Sets or queries the internal modulation rate of FSK modulation for the specified channel. This command can be used only when the internal modulation source is selected.

NameTypeValuesDescription
raterealHzThe modulation rate.
qualifieroptenumMINimum | MAXimumSelects the minimum or maximum allowed rate.
real (Hz) - The modulation rate.
SOURce1:FSKey:INTernal:RATE 50Hz

Sets or queries the source of modulation signal of FSK modulation for the specified channel.

NameTypeValuesDescription
sourceoptenumINTernal | EXTernalSelects the modulation source: internal or external.
enum - Returns the current modulation source.

Enables or disables FSK modulation for the selected source. The query returns the current FSK modulation state.

NameTypeValuesDescription
stateenumON | OFF | <NR1>Enables or disables FSK modulation; ON or a nonzero numeric value enables it, OFF or zero disables it.
enum - Returns the state of FSK modulation.
SOURce1:FSKey:STATe ON

Sets or queries the EFIle name used as an output waveform. A file name must be specified in the mass storage system; the query returns a file name, or a blank string if no file is in mass storage.

NameTypeValuesDescription
file_namestring-File name in the mass storage system, including path; path separators are forward slashes (/).
string - The EFIle name currently set as the output waveform, or blank if there is no file in mass storage.

Sets or queries the symmetry of the ramp waveform for the specified channel. The setting range is 0.0% to 100.0%.

NameTypeValuesDescription
symmetryreal0.0 - 100.0Symmetry of the ramp waveform.
qualifieroptenumMINimum | MAXimumUses the minimum or maximum symmetry value.
real (PCT) - Returns the symmetry of the ramp waveform.
SOURce1:FUNCtion:RAMP:SYMMetry 80.5

Sets or queries the output waveform shape for the specified source channel. If the selected user memory is deleted, selecting the user memory causes an error.

NameTypeValuesDescription
shapeenumSINusoid | SQUare | PULSe | RAMP | PRNoise | DC | SINC | GAUSsian | LORentz | ERISe | EDECay | HAVersine | USER[1] | USER2 | USER3 | USER4 | EMEMory[1] | EMEMory2 | EFILeOutput waveform shape to select.

Sets or queries the shape of the output waveform for the specified source channel. If the selected user memory is deleted, selecting the user memory causes an error.

enum - Returns the current waveform shape.

Sets or queries the phase of the output waveform for the specified channel. The value may be entered in radians or degrees; if no unit is specified, the default is RAD.

NameTypeValuesDescription
phaserealradPhase value for the output waveform.
real (RAD) - Returns the phase value in RAD.

Sets or queries the phase of the output waveform for the specified channel. The value can be entered in radians or degrees; if no units are specified, RAD is assumed, and the query returns the value in RAD.

real (RAD) - Returns the phase value in radians.
SOURce1:PHASe:ADJust MAXimum

Sets or queries the internal modulation frequency of PM modulation for the specified channel. It can be used only when the internal modulation source is selected.

NameTypeValuesDescription
frequencyreal2 mHz - 50.00 kHzInternal PM modulation frequency.

Sets or queries the peak frequency deviation of PM modulation for the specified channel. If omitted, the units default to radians; the value can also be set to the minimum or maximum allowed deviation.

NameTypeValuesDescription
deviationreal0 PI - +1 PIPhase deviation value in radians when no units are specified.
unitsoptenumRAD | DEGUnits for the deviation value.
qualifieroptenumMINimum | MAXimumSets the deviation to the minimum or maximum allowed value.
real (RAD) - Returns the peak frequency deviation.
SOURce1:PM:DEViation MAXimum

Sets or queries the peak frequency deviation of PM modulation for the specified channel.

NameTypeValuesDescription
deviationreal0 PI - +1 PIPeak phase deviation value; if units are omitted, RAD is assumed automatically.
qualifieroptenumMINimum | MAXimumKeyword alternative to a numeric deviation value.
real (RAD) - The peak frequency deviation value.
SOURce1:PM:DEViation MAXimum

Sets or queries the modulating waveform of PM modulation for the specified channel. This command can be used only when the internal modulation source is selected.

NameTypeValuesDescription
functionenumSINusoid | SQUare | TRIangle | RAMP | NRAMp | PRNoise | USER[1] | USER2 | USER3 | USER4 | EMEMory[1] | EMEMory2 | EFILeSelects the PM internal modulation waveform.

Sets or queries the EFILe name used as a modulating waveform for PM modulation. The file name must exist in the mass storage system; the command returns a blank string if there is no file in mass storage.

NameTypeValuesDescription
file_namestring-File name in the mass storage system, including path with forward slashes (/).
string - Returns the configured file name.
SOURce1:PM:INTernal:FUNCtion:EFILe “SAMPLE1”

Sets or queries the source of the modulation signal for PM modulation on the specified channel.

NameTypeValuesDescription
sourceoptenumINTernal | EXTernalSelects the PM modulation source.

Enables or disables PM modulation. The query returns the state of PM modulation.

NameTypeValuesDescription
stateenumON | OFF | <NR1>Turns PM modulation on or off; ON or <NR1>≠0 enables it, OFF or <NR1>=0 disables it.
integer - Returns the state of PM modulation as <NR1>.
SOURce1:PM:STATe ON

Sets or queries the duty cycle of the pulse waveform for the specified channel. The setting range is 0.001% to 99.999% in increments of 0.001; leading and trailing edge settings are held when the duty cycle is varied.

NameTypeValuesDescription
percentreal0.001 - 99.999Duty cycle value.
qualifieroptenumMINimum | MAXimumSelects the minimum or maximum duty cycle value.

Sets or queries the duty cycle of the pulse waveform for the specified channel. The setting range is 0.001% to 99.999% in increments of 0.001.

NameTypeValuesDescription
percentreal0.001 - 99.999Duty cycle value.
qualifieroptenumMINimum | MAXimumSelects the minimum or maximum duty cycle value.
real (%) - Returns the duty cycle percentage.

Sets the lead delay of the pulse waveform for the specified channel. It can also be queried to return the lead delay.

NameTypeValuesDescription
delayreal0 ns - Pulse Period (Continuous mode)Lead delay value to set.
qualifieroptenumMINimum | MAXimumUse MINimum or MAXimum instead of a numeric delay.
real - Returns the lead delay.
SOURce1:PULSe:DELay 20ms

Sets or queries the period for the pulse waveform. The period value accepts a numeric value with optional units, or the keywords MINimum and MAXimum.

NameTypeValuesDescription
periodrealns|μs|ms|sPulse period value to set.
qualifieroptenumMINimum | MAXimumSelects the minimum or maximum allowable period.
real (ns|μs|ms|s) - Returns the pulse period.

Sets or queries the trailing edge time of the pulse waveform.

NameTypeValuesDescription
secondsrealsTrailing edge time of the pulse waveform.
qualifieroptenumMINimum | MAXimumSelects the minimum or maximum trailing edge time.
SOURce1:PULSe:TRANsition:TRAiling 200ns

Sets or queries the leading edge time of the pulse waveform.

NameTypeValuesDescription
secondsrealsLeading edge time of the pulse waveform.
qualifieroptenumMINimum | MAXimumKeyword alternative to the numeric leading edge time.
real (s) - Leading edge time of the pulse waveform.
SOURce1:PULSe:TRANsition:LEADing 200ns

Sets or queries the pulse width for the specified channel. The width must be less than the period and can be set in seconds or using MINimum/MAXimum; allowable ranges vary by model.

NameTypeValuesDescription
secondsreal0.001% - 99.999%Pulse width value.
qualifieroptenumMINimum | MAXimumLiteral keyword alternative to a numeric pulse width value.

Sets or queries the internal modulation frequency of PWM modulation for the specified channel. This command is valid only when the internal modulation source is selected.

NameTypeValuesDescription
frequencyreal2 mHz - 50.00 kHzModulation frequency to set.
qualifieroptenumMINimum | MAXimumUse MINimum or MAXimum in place of a numeric frequency.
real (Hz) - Returns the internal modulation frequency.
SOURce1:PWM:INTernal:FREQuency 10kHz

Sets or queries the modulating waveform of PWM modulation for the specified channel. This command can be used only when the internal modulation source is selected.

Sets or queries the EFILe name used as a modulating waveform for PWM modulation. The file name must be specified in the mass storage system, including path with forward slashes.

NameTypeValuesDescription
file_namestring-File name in the mass storage system, including path.
SOURce1:PWM:INTernal:FUNCtion SQUare

Sets or queries the EFILe source used as a modulating waveform for PWM modulation. The file name must exist in the mass storage system and includes the path using forward slashes.

NameTypeValuesDescription
file_namestring-File name in the mass storage system, including path.
SOURce1:PWM:INTernal:FUNCtion SQUare

Enables or disables PWM modulation for the specified source channel. The query returns the current PWM modulation state.

NameTypeValuesDescription
stateenumON | OFF | <NR1>Sets the PWM modulation state; ON or nonzero enables modulation, OFF or zero disables it.
enum - Returns the current PWM modulation state.

Sets or queries the PWM deviation in percent for the specified channel. The setting range is constrained by pulse width, pulse period, and edge time limits.

NameTypeValuesDescription
percentrealPCTPWM deviation value in percent.
qualifieroptenumMINimum | MAXimumSelects the minimum or maximum allowable deviation.
real (PCT) - Returns the PWM deviation in percent.
SOURce1:PWM[:DEViation]:DCYCle 5.0

Sets or queries the PWM deviation in percent for the specified channel. The deviation setting must satisfy several constraints relative to pulse width, pulse period, and edge times.

real (PCT) - Returns the PWM deviation as a percent value.
SOURce1:PWM[:DEViation]:DCYCle 5.0

Sets or queries the sweep hold time, which is the time the frequency must remain stable after reaching the stop frequency.

NameTypeValuesDescription
secondsrealsHold time in seconds.
qualifieroptenumMINimum | MAXimumAllows setting the hold time to the minimum or maximum value.
real (s) - Returns the hold time in seconds.
SOURce:ROSCillator:SOURce INTernal

Selects auto or manual sweep mode for the specified channel. The query returns the current sweep mode for the specified channel.

NameTypeValuesDescription
modeenumAUTO | MANualSweep mode setting.
enum - Current sweep mode for the specified channel.
SOURce1:SWEep:MODE AUTO

Sets or queries the sweep return time. Return time represents the amount of time from stop frequency through start frequency and does not include hold time.

SOURce1:SWEep:RTIMe

Selects linear or logarithmic spacing for the sweep on the specified source channel. The query returns the current sweep spacing type for that channel.

NameTypeValuesDescription
modeenumLINear | LOGarithmicSets the sweep spacing type.
enum - Returns the sweep spacing type for the specified channel.
SOURce1:SWEep:SPACing LINear

Sets or queries the sweep return time for the specified source channel. The setter accepts a time value in seconds with units, or MINimum/MAXimum.

NameTypeValuesDescription
secondsrealsReturn time for the sweep.
qualifieroptenumMINimum | MAXimumUse MINimum or MAXimum instead of a numeric return time.
real (s) - Return time in seconds.
SOURce1:SWEep:RTIMe 1ms

Enables or disables copying the voltage level from one channel to another. If CH 1 is specified in the header, its voltage level is copied to CH 2; the query returns 0 (off) or 1 (on).

NameTypeValuesDescription
stateenumON | OFF | <NR1>Turns voltage concurrency on or off, or accepts the numeric code <NR1> as documented.
enum - Returns 0 for off or 1 for on.

Enables or disables copying the voltage level from one channel to another. For a single-channel model, this command is not supported.

enum - Returns the current state of voltage concurrence as 0 (off) or 1 (on).

Sets or queries the high level of output amplitude for the specified channel. On dual-channel models, if concurrent copy is ON, the other channel is set to the same value.

NameTypeValuesDescription
voltagerealVHigh level of output amplitude.
qualifieroptenumMINimum | MAXimumKeyword alternative to the numeric voltage value.
real (V) - Returns the high level of output amplitude.
SOURce1:VOLTage:LEVel:IMMediate:HIGH 1V

Sets or queries the low level of output amplitude for the specified channel. On dual-channel models with voltage concurrency turned on, the other channel is set to the same low level.

NameTypeValuesDescription
voltagerealmV|VLow level of output amplitude.
qualifieroptenumMINimum | MAXimumSelects the minimum or maximum allowed voltage value.
real (mV|V) - Returns the low level of output amplitude.
SOURce1:VOLTage:LEVel:IMMediate:LOW -1V

Sets or queries the offset level for the specified channel. On dual-channel models with source concurrency enabled, the other channel's offset is set to the same value.

NameTypeValuesDescription
voltagerealVOffset level for the specified channel.
qualifieroptenumMINimum | MAXimumAllows setting the offset to the minimum or maximum value.
real (V) - Returns the offset level.

Selects the external function file used by internal AM modulation. This command is documented under the AM internal function path in the SCPI conformance table.

Selects the internal AM modulation function. This query form returns the currently selected function.

enum - Returns the current internal AM function selection.

Selects the AM source. The command is available under channel 1 or 2.

enum - Returns the AM source setting.

Sets or queries the AM modulation state for the selected source. The command is listed under the source 1/2 command group and applies to AM state control.

enum - Returns the AM modulation state.

Sets or queries the burst mode. This command is part of the burst subsystem for source 1 or 2.

enum - Returns the current burst mode.

Sets the burst trigger delay. The command is listed as part of the BURSt subsystem conformance information.

Sets or returns the burst state for source 1 or 2. The command is listed as a SCPI conformance item with optional state argument; the slice does not document the returned value details.

returns

Sets or queries the internal FM frequency for the selected source. This command is part of the FM subsystem under the source selection hierarchy.

real - Returns the internal FM frequency for the selected source.

Selects the internal FM modulation function. This command is part of the FM:INTernal subtree.

enum - Returns the current FM internal function setting.

Selects the source for FM modulation. The command is part of the FM subsystem under the selected source.

enum - Returns the FM source setting.

Enables or disables FM for the selected source. The command is available for source 1 or 2.

NameTypeValuesDescription
stateenumON | OFFTurns FM on or off.
enum - Returns the current FM state.

Sets or queries the FM deviation. This command is part of the source FM subsystem.

real - Returns the FM deviation.

Sets or queries the center frequency of the frequency sweep. This command is part of the frequency subsystem.

real - Returns the center frequency.

Turns concurrent frequency state on or off for the frequency subsystem. This command is listed as defined in SCPI 1999.0.

NameTypeValuesDescription
stateoptenumON | OFFEnables or disables concurrent frequency mode.

Sets or queries the concurrent state of the voltage source. This command is part of the source 1/2 voltage concurrent state subtree.

NameTypeValuesDescription
stateoptenumON | OFFEnables or disables concurrent operation.
enum - Returns the concurrent state.

Sets or queries the source frequency span. This entry is listed under source 1 or 2 in the SCPI conformance table, but the page slice does not provide further syntax or behavior details.

returns

Sets or queries the current frequency in continuous-wave or fixed mode for source 1 or 2. The command is listed for source selection and frequency control in the SCPI conformance table.

real (Hz) - Returns the current frequency value.

Returns the current source state for one of the two sources. The source is selected with the optional source node [1|2].

enum - Returns the source state.

Returns the source frequency key setting for the selected source. The command is available for source 1 or 2.

enum - Returns the frequency key state for the selected source.

Sets the function shape for source 1 or 2. The shape is selected as part of the source/function subsystem.

enum - Returns the current function shape.

Returns the internal function selection for the PM source. This query is part of the PM:INTernal subsystem for source 1 or 2.

enum - Returns the internal function setting.

Selects the source for phase modulation. The command is documented for PM as a query on channels 1 and 2.

enum - Returns the current phase-modulation source setting.

Returns the source used by the pulse-width modulation subsystem for the selected channel.

enum - Returns the PM source setting.

Sets or queries the phase modulation deviation for the selected source. This command is available as a query form in the SCPI conformance table.

returns

Sets or queries the pulse duty cycle. The command is part of the Pulse subsystem and is defined as a query in the conformance table.

real - Returns the pulse duty cycle.

Sets or queries the pulse delay value for the selected source channel. The command is defined for source 1 or 2.

real - Returns the pulse delay value for the selected source channel.

Sets or queries the pulse hold state. This command is part of the PULSE subsystem.

enum - Returns the current pulse hold state.

Sets or queries the pulse period. The command is part of the PULSE command group.

real - Returns the pulse period.

Returns the leading edge transition setting for pulse output. This is the query form of the PULSE:TRANSITION[:LEADING] command.

real - Returns the leading transition value for the pulse waveform.

Sets or queries the pulse width for the selected source. The command is listed as part of the PULSE subsystem conformance table.

returns - No return value is documented in the provided slice.

Sets or queries the external file used by the PWM internal function. This command is listed as a query in the SCPI conformance table.

string - Returns the selected external function file name or path.

Returns the PWM source state. The command is listed as part of the PWM subsystem in the SCPI conformance table.

enum - Returns the PWM source state.

Sets or queries the sweep hold time for the source. The command is defined for source 1 or 2.

real - The sweep hold time.

Sets or queries the sweep mode used for the frequency sweep function.

enum - Returns the current sweep mode.

Sets or queries the sweep spacing mode for the selected source. This command is defined for sources 1 and 2.

enum - Returns the current sweep spacing setting.

Sets or queries the lower voltage limit. It is part of the voltage limit subsystem under the selected source.

real - Returns the lower voltage limit.

Sets or queries the voltage unit used for the source. The slice only lists the command in the SCPI conformance table and does not document the unit choices or behavior.

enum - Returns the current voltage unit.

Returns the present immediate level settings for voltage amplitude. The command is listed under the Voltage > Level > Immediate subtree and applies to source 1 or 2.

enum - Returns the present immediate voltage level mode/value. The slice does not provide a detailed return format.

Sets or queries the internal noise level for the specified channel. The value is expressed as a percent of the current amplitude level and is available only in Continuous, Burst, or Sweep run modes.

NameTypeValuesDescription
amplitudereal0 - 50Internal noise level as a percentage of the current amplitude level.

This command sets the reference clock to either internal or external.

NameTypeValuesDescription
sourceenumINTernal | EXTernalSelects the reference clock source.
SOURce:ROSCillator:SOURce INTernal

Sets or queries the reference oscillator source for the instrument. This command is documented as part of the source subsystem and is listed with an optional [SOURce] node.

enum - Returns the reference oscillator source setting.

Sets or queries the output amplitude for the specified channel. The amplitude value uses an NRf number with units of VPP, VRMS, or DBM.

NameTypeValuesDescription
amplitudereal-Output amplitude.
qualifieroptenumMINimum | MAXimumQualifier used to request the minimum or maximum amplitude.
real - Returns the output amplitude.
SOURce1:VOLTage:LEVel:IMMediate:OFFSet 500mV

Sets or queries the higher limit of the output amplitude high level for the specified channel. If concurrent output is ON on a dual-channel model, the other channel uses the same value.

NameTypeValuesDescription
voltagerealVHigher limit of output amplitude.
qualifieroptenumMINimum | MAXimumSelects the minimum or maximum limit value.
real (V) - Returns the higher limit of output amplitude.
SOURce1:VOLTage:LIMit:HIGH 1V

Sets or queries the lower limit of output amplitude for the specified source channel. The lower limit may be entered as a voltage value or as the keywords MINimum or MAXimum.

NameTypeValuesDescription
voltagerealmV|VLower limit of output amplitude.
qualifieroptenumMINimum | MAXimumOptional keyword alternative to a voltage value.
real (mV|V) - Returns the lower limit of output amplitude.
SOURce1:VOLTage:LIMit:LOW 10mV

Sets or queries the units of output amplitude for the specified channel. It does not affect the offset, High level, or Low level of output.

NameTypeValuesDescription
modeenumVPP | VRMS | DBMSelects the output voltage units.
enum - Returns the current output voltage units.
SOURce1:VOLTage:UNIT VPP

Returns the contents of the Operation Condition Register.

integer - The current contents of the Operation Condition Register.
STATUS:OPERATION:CONDITION?

Sets or queries the mask for the Operation Enable Register.

NameTypeValuesDescription
bit_valueinteger-Mask value for the Operation Enable Register.
STATUS:OPERATION:ENABLE 1

Sets or queries the mask for the Operation Enable Register.

integer - Returns the contents of the Operation Enable Register as a bit value.
STATUS:OPERATION:ENABLE 1

Returns the value in the Operation Event Register and clears the Operation Event Register.

integer - The contents of the Operation Event Register.
STATUS:OPERATION[:EVENT]?
:STATus:PRESetset / query

Presets the SCPI status registers (OENR and QENR).

STATUS:PRESET

Sets or queries the mask for the Questionable Enable Register.

NameTypeValuesDescription
bit_valueinteger-
integer - Returns the questionable enable register mask value.
STATUS:QUESTIONABLE:ENABLE 32

Sets or queries the mask for the Questionable Enable Register.

NameTypeValuesDescription
bit_valueinteger-Bit mask value for the Questionable Enable Register.
integer - Returns the Questionable Enable Register mask value.
STATUS:QUESTIONABLE:ENABLE 32

Returns the value in the Questionable Event Register and clears the Questionable Event Register.

integer - The value in the Questionable Event Register.

Sets the beeper on or off. The corresponding query returns 0 for OFF or 1 for ON.

NameTypeValuesDescription
stateenumON | OFFTurns the beeper on or off.
valueinteger-Numeric form of the beeper state, where nonzero enables and zero disables the beeper.
SYSTEM:BEEPER:STATE ON

Returns the current beeper state. The instrument returns "0" for OFF and "1" for ON.

integer - Returns "0" (OFF) or "1" (ON).
SYSTEM:BEEPER:STATE ON

Returns the contents of the Error/Event queue.

string - Returns the error/event number and the error/event description from the queue.

Enables or disables the click sound when the front-panel buttons are pressed or the general-purpose knob is turned. The query returns 0 (OFF) or 1 (ON).

NameTypeValuesDescription
stateenumON | OFFEnables or disables the click sound.
valueinteger-Numeric form of the state: nonzero enables click sound, 0 disables it.
SYSTEM:KCLICK[:STATE] ON

Enables or disables the click sound when you push the front panel buttons or turn the general purpose knob. The query returns 0 (OFF) or 1 (ON).

enum - Returns 0 for OFF and 1 for ON.
SYSTEM:KCLICK[:STATE] ON

Locks or unlocks the instrument front panel controls. The query returns 0 (OFF) or 1 (ON).

NameTypeValuesDescription
stateoptenumON | OFFEnables or disables the front panel controls.
enum - Returns 0 for OFF or 1 for ON.
SYSTEM:KLOCK[:STATE] ON

Locks or unlocks the instrument front panel controls. The query returns 0 (OFF) or 1 (ON).

enum - Returns the front-panel lock state as 0 (OFF) or 1 (ON).

Disables protected commands and activates instrument security protection. On the AFG3000 Series, remote commands are not controlled by SYSTem:PASSword commands.

NameTypeValuesDescription
passwordstring-Current password; the string is case sensitive.
SYSTEM:PASSWORD:CDISABLE <password>

Enables protected commands to function and deactivates instrument security protection. In the AFG3000 Series Arbitrary Function Generators, no remote commands are under the control of SYSTem:PASSword commands.

Returns the security protection state. <NR1>=0 indicates the security protection is in the on state; <NR1>≠0 indicates the security protection is in the off state.

integer - <NR1>=0 indicates that the security protection is in the on state. <NR1>≠0 indicates that the security protection is in the off state.

Changes the password.

NameTypeValuesDescription
current_passwordstring-Current password.
new_passwordstring-New password.
SYSTEM:PASSWORD:NEW “DEFAULT”,“abc123”

Erases all current instrument setups, setup memory, last setup memory, user waveform memory, and log content, then recalls the factory default settings. Calibration data is not erased, and communication settings are reset to factory defaults.

Sets or queries the language used to display instrument information on the screen.

NameTypeValuesDescription
languageenumENGLish | FRENch | GERMan | JAPanese | KORean | SCHinese | TCHinese | RUSSianSpecifies which language will be used to display instrument information on the screen.
enum - Returns the current display language.
SYSTEM:ULANGUAGE FRENch

Sets or queries the language used to display instrument information on the screen.

enum - Returns the current display language.
SYSTEM:ULANGUAGE FRENch

Returns the conformed SCPI version of the instrument.

string - The conformed SCPI version in the form YYYY.V, where YYYY indicates the year.

Returns the names of user waveform memory and edit memory. The response is a comma-separated series of quoted strings.

string - A series of strings separated by commas; each string is enclosed within quotation marks.
TRACE|DATA:CATALOG?
:TRACe|DATA:COPYset / query

Copies the contents of edit memory or user waveform memory to a specified destination memory. The source must be a trace name or edit memory, and the destination must be edit memory or a user waveform memory.

NameTypeValuesDescription
trace_namestring-Source trace name to copy.
memoryenumEMEMory[1] | EMEMory2 | USER[1] | USER2 | USER3 | USER4Destination memory for the copy operation.

Transfers waveform data from the external controller to the edit memory in the arbitrary function generator. The query returns the binary block data.

NameTypeValuesDescription
memoryenumEMEMory | EMEMory1 | EMEMory2Selects the edit memory destination for the waveform data.
binary_block_datablock-Waveform data in binary format to be transferred.
block - Binary block data from the edit memory.
DATA:DATA EMEMory1,#42000<DAB><DAB>...<DAB>

This command writes line data to the edit memory. The data between the specified points is interpolated linearly.

NameTypeValuesDescription
memoryenumEMEMory | EMEMory1 | EMEMory2Edit memory target.
start_pointinteger-First point from which the data is interpolated linearly.
point_data1integer-Data value at the start point.
end_pointinteger-Last point from which the data is interpolated linearly.
point_data2integer-Data value at the end point.
DATA:DATA:LINE EMEMory1,1,2047,250,4094

Resets the contents of edit memory. It has no query form.

NameTypeValuesDescription
memoryenumEMEMory | EMEMory1 | EMEMory2Selects the edit memory to reset.
points_or_trace_nameopt--Optional points or trace name argument.

Sets the data value for a specified point in edit memory, or queries the data value for a specified point. The query returns an NR1 value.

NameTypeValuesDescription
memoryenumEMEMory | EMEMory1 | EMEMory2Edit memory selection.
pointinteger-Point number in the edit memory.
datainteger-Data value for the specified point number.
integer - NR1 value for the specified point's data value.
DATA:DATA:VALue EMEMory1,500,2047
DATA:DATA:VALue? EMEMory1,500

Returns the data value for the specified point in the edit memory. The query syntax takes an edit-memory selector and point count.

NameTypeValuesDescription
memoryenumEMEMory | EMEMory1 | EMEMory2Selects the edit memory to access.
pointsinteger-Specifies the point number in the edit memory.
integer - Returns the data value for the specified point number in the edit memory.
DATA:DATA:VALue? EMEMory1,500

Deletes the contents of the specified user waveform memory. The command is invalid when the selected trace is being output or is locked.

NameTypeValuesDescription
trace_nameenumUSER[1] | USER2 | USER3 | USER4Specifies which user waveform memory to delete.
DATA:DELete:NAME USER1

Copies the contents of edit memory1 to edit memory2, or edit memory2 to edit memory1. The command is not supported on single-channel models.

NameTypeValuesDescription
sourceenumEMEMory[1] | EMEMory2Selects the edit memory to copy from.
destinationenumEMEMory[1] | EMEMory2Selects the edit memory to copy to.
TRACe|DATA:EMEMCOPY EMEMory1,EMEMory2

Sets or queries whether the specified user waveform memory is locked or unlocked.

NameTypeValuesDescription
stateenumON | OFFLocks or unlocks the specified user waveform memory.
integer - Returns the lock state of the specified user waveform memory as an NR1 value.
DATA:LOCK:STATe USER1,ON

Sets or queries whether the specified user waveform memory is locked or unlocked.

NameTypeValuesDescription
userenumUSER[1] | USER2 | USER3 | USER4Specifies the user waveform memory to lock or unlock.
stateenumON | OFF | <NR1>Locks or unlocks the selected user waveform memory.
<NR1> - Returns the lock state of the specified user waveform memory.
DATA:LOCK:STATe USER1,ON

Sets or queries the number of data points for the waveform created in the edit memory.

NameTypeValuesDescription
memoryenumEMEMory | EMEMory1 | EMEMory2Edit memory selection for the command.
pointsoptinteger2 - 131072Number of points for the waveform created in the edit memory.
qualifieroptenumMINimum | MAXimumRequests the minimum or maximum allowed number of points in the query form.
integer - Returns the number of data points for the waveform created in the edit memory.
DATA:POINts EMEMory1, 500 sets the waveform data points to 500 in the edit memory1.

Deletes a trace data object. The optional NAME argument specifies the named trace to delete.

NameTypeValuesDescription
NAMEoptstring-Name of the trace data object to delete.

Locks or unlocks the trace/data memory. The optional [STATe] parameter selects the lock state.

NameTypeValuesDescription
stateoptenumON | OFFSelects whether trace/data memory is locked or unlocked.
enum - Returns the current lock state.

Sets or queries the slope of the trigger signal.

NameTypeValuesDescription
slopeenumPOSitive | NEGativeSelects whether the trigger event occurs on the rising or falling edge of the external trigger signal.
enum - Returns the current trigger slope as POS or NEG.
TRIGGER[:SEQUENCE]:SLOPE POSitive

Sets or queries the slope of the trigger signal.

enum - Returns the trigger slope as POS or NEG.
TRIGGER[:SEQUENCE]:SLOPE POSitive

Sets or queries the trigger source for an external trigger signal.

NameTypeValuesDescription
sourceenumTIMer | EXTernalSelects the trigger source.
enum - Returns the current trigger source.
TRIGger[:SEQuence]:SOURce TIMer
TRIGger[:SEQuence]:SOURce?

Sets or queries the trigger source for an external trigger signal.

enum - Returns the current trigger source.

Sets or queries the period of the internal clock used as the trigger source when the internal clock is selected with TRIGger[:SEQuence]:SOURce. The setting range is 1 μs to 500.0 s.

NameTypeValuesDescription
secondsreal1 μs - 500.0 sPeriod of the internal clock.
real (s) - Returns the internal clock period.
TRIGGER[:SEQUENCE]:TIMER 5ms

Copies the CS configuration. This command is listed as supported by the instrument in the SCPI conformance table.

Creates a hardcopy dump to the system printer or file using the current display contents. The optional immediate form executes the dump immediately.

NameTypeValuesDescription
immediateoptenumIMMediateExecute the hardcopy dump immediately.