Returns the maximum level.
SCPI COMMAND REFERENCE
The Tektronix AFG31252 is Tektronix's arbitrary function generator in the AFG31000 Series family. Its SCPI remote-control interface exposes 249 commands across 26 subsystems - 160 settable and 89 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.
249
Commands
160
Settable
89
Queries
26
Subsystems
SCPI
Verified
2026-07-16
All commands
Returns the minimum level.
Sets or returns the signal transmission delay in cable.
| Name | Type | Values | Description |
|---|---|---|---|
| delay | real | - | Transmission delay value, entered as a numeric value with optional units of s, ms, μs, or ns. |
INSTaview1:MEASUrement:DELay 2e-9
Returns the maximum level of output signal in DUT.
INSTaview1:MEASUrement:MAXimum?
Returns the minimum level of output signal in DUT.
INSTaview1:MEASUrement:MINimum? Get the CH1 InstaView waveform min level.
Sets or returns the InstaView state for channel 1 or 2. ON or a nonzero value enables InstaView; OFF or zero disables it.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Sets the InstaView function state. |
INSTaview:STATe ON
Sets or returns the InstaView state for the selected channel. ON or a nonzero numeric value enables InstaView; OFF or 0 disables it.
INSTaview:STATe ON
Disconnects this PI Interface.
ABORt
Copies setup parameters for one channel to another channel. It is not supported on single-channel models.
| Name | Type | Values | Description |
|---|---|---|---|
| source channel | enum | CH1 | CH2 | Channel whose setup parameters are copied. |
| destination channel | enum | CH1 | CH2 | Channel that receives the copied setup parameters. |
AFGControl:CSCopy CH1,CH2
Performs an internal calibration and returns 0 if the calibration completed without errors, or a nonzero calibration error code if an error was detected.
*CAL?
Clears all of the event registers and queues used in the AFG status and event reporting system.
*CLS
Sets or queries the bits in the Event Status Enable Register (ESER) used in the status and events reporting system of the arbitrary/function generator. The query returns the contents of the ESER.
| Name | Type | Values | Description |
|---|---|---|---|
| bit_value | integer | 0 - 255 | Binary value used to set the ESER bits according to the number entered. |
*ESE 177 *ESE?
Returns the contents of the Standard Event Status Register (SESR) as a decimal integer. Reading the SESR also clears it.
*ESR?
Returns identification information for the AFG.
*IDN?
Generates the operation complete message by setting bit 0 in the Standard Event Status Register (SESR) when all pending commands that generate an OPC message are complete. The query places the ASCII character 1 into the output queue when all such operations are complete.
*OPC? Return 1 to indicate that all pending OPC operations are finished.
Places the ASCII character 1 into the output queue when all pending operations that generate an OPC message are complete. It reports operation completion by indicating that all such pending operations are finished.
*OPC?
Returns a list of the options installed in the AFG. It is a query-only command and may return an empty string if no option is installed.
*OPT?
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 set to 0 at power-on; when false, the current SRER and ESER values are preserved in nonvolatile memory and restored at power-on.
| Name | Type | Values | Description |
|---|---|---|---|
| NR1 | integer | 0 | Sets the power-on status clear flag. 0 disables power-on clear; any nonzero value enables it. |
*PSC 0
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 set to 0 at power-on; when false, their current values are preserved in nonvolatile memory and restored at power-on.
Sets and queries the bits in the Service Request Enable Register (SRER). The setter writes the SRER bit value, and the query returns the current bit value.
| Name | Type | Values | Description |
|---|---|---|---|
| bit_value | integer | 0 - 255 | Value used to set the binary bits of the SRER. |
*SRE 48 *SRE?
Returns the contents of the Status Byte Register (SBR) using the Master Summary Status (MSS) bit.
Generates a trigger event.
*TRG
Performs a self-test and returns the result. A return value of 0 indicates the self-test completed without errors; nonzero indicates an error was detected.
*TST?
Prevents the instrument from executing further commands or queries until all pending commands that generate an OPC message are complete.
*WAI
Recalls a previously saved instrument setup. The example shows using `*RCL 1` to recall settings from Setup1.
| Name | Type | Values | Description |
|---|---|---|---|
| setup | integer | 1 - 4 | Setup number to recall. |
*RCL 1
Resets the instrument to its default state. The page shows it being used at device initialization in a programming example.
Tvc1.WriteString ("*RST")Saves the current instrument settings into a setup register. The example shows saving settings with a numeric storage location.
| Name | Type | Values | Description |
|---|---|---|---|
| setup register | integer | 1 - 1 | Setup location to save the current settings. |
*SAV 1
Performs an internal calibration. The query form performs the calibration and returns 0 for pass or a nonzero calibration error code.
CALibration CALibration?
Performs a self-test. The query form returns the test result after the self-test completes.
DIAGnostic DIAGnostic?
Sets or queries the brightness of the LCD display. For the setter, the brightness can be specified numerically or forced to the minimum or maximum level.
| Name | Type | Values | Description |
|---|---|---|---|
| brightness | real | 0.00 - 1.00 | Display brightness level; larger values increase screen brightness. |
| qualifieropt | enum | MINimum | MAXimum | Sets the display to the lowest or highest brightness level. |
DISPlay:BRIGhtness MAX
Sets the screen saver state to ON immediately, regardless of the current DISPlay:SAVer[:STATe]? setting. It enables the screen saver without waiting five minutes.
DISPlay:SAVer:IMMediate
Sets or queries the LCD screen saver setting. When enabled, the screen saver starts automatically if no front-panel operations are applied for five minutes.
| Name | Type | Values | Description |
|---|---|---|---|
| stateopt | enum | ON | OFF | <NR1> | Enables or disables the screen saver function; ON or nonzero enables, OFF or zero disables. |
DISPlay:SAVer:STATe OFF
Displays a text message on the instrument screen. The query form returns the text string currently displayed on the screen; displayable characters are ASCII 32 through 126, and the instrument can display approximately 64 characters.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Text message to display on the instrument screen. |
DISPlay:TEXT?
Clears the text message from the display screen.
DISPlay:TEXT:CLEar
Copies a screen image and saves the image file to the USB flash drive. The image is saved in a folder named TEK on the USB flash drive.
HCOPy:SDUMp:IMMediate
Returns the instrument HostID unique identifier.
LICense:HID?
Installs a license on the instrument from block data. Restarting the instrument may be necessary to activate the licensed capabilities.
| Name | Type | Values | Description |
|---|---|---|---|
| <block_data> | block | - | The license in block data format. |
LICense:INSTall <block_data> Install license file to unit.
Returns or uninstalls a specified license. The exit keyfile generated by the uninstall is returned as block data.
| Name | Type | Values | Description |
|---|---|---|---|
| transaction ID or nomenclature | string | - | Transaction ID or license nomenclature used to identify the license to return or uninstall. |
LICense:UNINstall?
Returns all license-related events and their messages as a comma-separated string.
LICense:ERRor? -3000, license error, 125, signature verification failed.
Returns the active license feature names as a comma-separated list of strings.
LICense:LIST?
Returns the local system date and time as known by the licensing system on the instrument. The value is returned in ISO 8601-compliant format including the time zone offset.
LICense:GMT? Might return 2016-05-23T18:46:34-08:00.
Returns the manufacturer, model, serial number, and firmware revision of the active host.
LICense:IDN? Might return TEKTRONIX, ABC1234, B010100, FV:1.2.3
Returns the count of active AFG31000 Series licenses.
LICense:COUNT?
Queries license details for a specific item in the instrument strongbox. The item number selects the order of the license item, which can change as licenses are installed, uninstalled, or expire.
| Name | Type | Values | Description |
|---|---|---|---|
| item number | integer | - | Specifies the order number of the item in the strongbox. |
LICense:ITEM? 3
Validates whether the instrument state can realize licensed features and whether the feature is active. A False result can indicate missing software, dependent licenses, or hardware problems.
LICense:VALidate?
Deletes the contents of a specified setup memory location. If the specified setup memory cannot be overwritten or deleted, the command returns an error.
| Name | Type | Values | Description |
|---|---|---|---|
| location | integer | 0 - 4 | Specifies the setup memory location to delete. |
MEMory:STATe:DELete 1
Sets or queries whether to lock a specified setup memory. Locking prevents overwriting or deleting the setup file; location 0 cannot be used.
| Name | Type | Values | Description |
|---|---|---|---|
| location | integer | 1 - 4 | Specifies the setup memory location to lock or query. |
| state | enum | ON | OFF | <NR1> | Locks or unlocks the specified setup memory location. |
MEMory:STATe:LOCK 1,ON
Sets or queries whether to lock a specified setup memory location. If locked, the setup file cannot be overwritten or deleted; location 0 cannot be used.
| Name | Type | Values | Description |
|---|---|---|---|
| location | integer | 1 - 4 | Specifies the setup memory to lock or query. |
| state | enum | ON | OFF | <NR1> | Locks or unlocks the specified setup memory location, or uses the numeric value to indicate the same. |
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 is selected, the default setups are recalled instead.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Enables or disables automatic recall of the last setup memory on power-up. |
MEMory:STATe:RECall:AUTo ON
Enables or disables automatic recall of the last setup memory when the instrument is powered on. If OFF, the default setups are recalled at power-up.
MEMory:STATe:RECall:AUTo ON
This query-only command returns the availability of a setup memory.
| Name | Type | Values | Description |
|---|---|---|---|
| location | integer | 0 - 4 | Specifies the location of setup memory. |
MEMory:STATe:VALid? 0
Returns the current state of the mass storage system (USB memory).
MMEMory:CATalog? 32751616,27970560,”SAMPLE1.TFS,,5412”
Changes the current working directory in the mass storage system. If no parameter is specified, the directory is not changed.
| Name | Type | Values | Description |
|---|---|---|---|
| directory_nameopt | string | - | Indicates the current working directory for the mass storage system. |
MMEMory:CDIRectory "U:/AFG/WORK0"
Changes the current working directory in the mass storage system. If no parameter is specified, the directory is not changed.
| Name | Type | Values | Description |
|---|---|---|---|
| directory_nameopt | string | - | Indicates the current working directory for the mass storage system. |
MMEMory:CDIRectory "U:/AFG/WORK0"
Deletes a file or directory from the mass storage system. If the specified file cannot be overwritten or deleted, the command causes an error; a directory can be deleted only if it is empty.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | Specifies the file to be deleted. |
MMEMory:DELete "M:/TEK001.tfwx"
Copies a setup file from the mass storage system to an internal setup memory. If the specified internal setup memory is locked, the command causes an error; on power-off, setup memory 0 is automatically overwritten with the last setup memory.
| Name | Type | Values | Description |
|---|---|---|---|
| location | integer | 0 - 4 | Specifies the location of the setup memory. |
| file_name | string | - | Specifies a setup file to be copied. |
MMEMory:LOAD:STATe 1,"U:/SETUP1.tfs"
Copies a waveform data file from the mass storage system to Edit Memory. If the file format is different, the command causes an error.
| Name | Type | Values | Description |
|---|---|---|---|
| EMEMory[1]|EMEMory2 | enum | EMEMory1 | EMEMory2 | Selects the Edit Memory destination. |
| file_name | string | - | Specifies the waveform data file to be copied. |
MMEMory:LOAD:TRACe EMEMory1,"U:/TEK001.tfwx"
Sets or queries whether a file or directory in mass storage is locked. A locked file or directory cannot be overwritten or deleted.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | File or directory name in the mass storage system. |
| state | enum | ON | OFF | <NR1> | ON or <NR1>≠0 locks the file or directory; OFF or <NR1>=0 allows overwrite or delete. |
MMEMory:LOCK:STATe "M:/setup1.tfs", ON
Sets or queries whether a file or directory is locked in the mass storage system. If locked, the file or directory cannot be overwritten or deleted.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | Specifies the file or directory to lock or unlock. |
| state | enum | ON | OFF | <NR1> | Locks the file or directory when ON or nonzero, and allows overwrite or delete when OFF or zero. |
MMEMory:LOCK:STATe "M:/setup1.tfs", ON
Creates a directory in the mass storage system. If the specified directory is locked, the command causes an error.
| Name | Type | Values | Description |
|---|---|---|---|
| directory_name | string | - | Specifies a directory name to be created. |
MMEMory:MDIRectory "M:/sample"
Copies a setup file in setup memory to a specified file in the mass storage system. It errors if the target file or directory is locked, or if the setup memory has been deleted.
| Name | Type | Values | Description |
|---|---|---|---|
| location | integer | 0 - 4 | Specifies the location of setup memory. |
| file_name | string | - | Specifies the file name in the mass storage system, including path; path separators are forward slashes (/). |
MMEMory:STORe:STATe 1,"M:/test1.tfs"
Copies a waveform data file in Edit Memory to a file in the mass storage system. If the destination file or directory is locked, the command causes an error.
| Name | Type | Values | Description |
|---|---|---|---|
| memory | enum | EMEMory1 | EMEMory2 | Selects the Edit Memory source to copy from. |
| file_name | string | - | File name in the mass storage system, including path; path separators are forward slashes (/). |
MMEMory:STORe:TRACe EMEMory1,"M:/sample1.tfwx"
Loads a single sequence file if a desired sequence is designated. If the sequence or any associated waveform name already exists, it is overwritten without warning.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | Relative path to the driver. |
MMEMory:OPEN:SEQuence "U:/AFGseq.seq"
Exports a sequence given a unique name to an eligible storage location as a .seq file. If a file already exists at the selected file path, it is overwritten without warning; if the save fails, the file is deleted.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | File path for the sequence to save, specified as a relative path to the driver. |
MMEMory:SAVE:SEQuence "U:/mySequence.seq"
Sets the output load impedance for the specified channel. The value is used for amplitude, offset, and high/low level settings; the query returns the current load impedance in ohms, or 9.9E+37 if the impedance is set to INFinity.
| Name | Type | Values | Description |
|---|---|---|---|
| ohms | real | 1 Ω - 10 kΩ | Sets the output load impedance. |
| qualifier | enum | INFinity | MINimum | MAXimum | Special keywords for setting the impedance to infinity, minimum, or maximum. |
OUTPut1:IMPedance MAXimum
Sets the output load impedance for the specified channel. The value is used for amplitude, offset, and high/low level settings; the query returns the current load impedance in ohms.
OUTPut1:IMPedance MAXimum
Inverts a specified output waveform relative to the offset level. The query returns the polarity for the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | NORMal | INVerted | Sets the specified output waveform polarity. |
OUTPut1:POLarity NORMal
Inverts a specified output waveform relative to the offset level. The query returns the polarity for the specified channel.
OUTPut1:POLarity NORMal
Sets or queries whether to enable the AFG output for the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Enables or disables the AFG output. |
| value | integer | - | Numeric value where nonzero enables the output and zero disables it. |
OUTPut1:STATe ON
Sets or queries whether to enable the AFG output for the specified channel.
OUTPut1:STATe ON
Sets or queries the trigger output mode for the Trigger Output signal. In burst Inf-Cycles mode, TRIGger outputs the infinite waveform cycles, while SYNC outputs one pulse when Inf-Cycles starts; in other run modes they have the same effect.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | TRIGger | SYNC | Selects the trigger output mode. |
OUTPut:TRIGger:MODE SYNC
Sets or queries the mode for the Trigger Output signal. In burst Inf-Cycles mode, TRIGger outputs the infinite waveform cycles and SYNC outputs one pulse when Inf-Cycles starts; otherwise the two modes have the same effect.
OUTPut:TRIGger:MODE SYNC
Restores the state of the instrument from a copy of the settings stored in mass memory. If the specified file is deleted, the command causes an error.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | Specifies the file name. |
RECALL:SETUp "U:/file1.tfs"
Stores the current settings of the arbitrary function generator to a specified file in mass memory.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | Specifies the file to save the current instrument settings to. |
SAVe:SETUp "U:/file1.tfs"
Sets or returns the run mode of the advanced mode. The setter accepts Continuous, Triggered, Gated, or Sequence; the query returns the current mode as a short keyword.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | CONTinuous | TRIGgered | GATed | SEQuence | Run mode to set. |
SEQControl:RMODe TRIGgered SEQControl:RMODe?
Sets or returns the run mode of the advanced mode.
SEQControl:RMODe TRIGgered SEQControl:RMODe?
Initiates the output of a waveform or sequence. It is equivalent to pushing the front-panel run button and validates the sequence before starting; if validation fails, the run does not occur and an error is returned.
| Name | Type | Values | Description |
|---|---|---|---|
| immediateopt | - | - | Optional node that may be included in the command syntax. |
SEQControl:RUN:IMMediate
Stops the output of a sequence.
SEQControl:STOP:IMMediate
Resets sequence to its default state, clearing the waveform list and sequence table. Sampling rate, skew time, and other parameters are set to their default values.
SEQControl:RESET
Takes the instrument to Sequence mode or returns it to AFG mode.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Selects Sequence mode on or off; <NR1> is 0 for OFF and nonzero for ON. |
SEQControl:STATe ON SEQControl:STATe?
Takes the instrument to Sequence mode or returns it to AFG mode.
SEQControl:STATe?
Returns the run state of the sequence.
SEQControl:RSTATe?
Sets and queries the sampling rate of the instrument.
| Name | Type | Values | Description |
|---|---|---|---|
| NR2 | real | - |
SEQControl:SRATe 1.5E9
Sets or queries the sampling rate of the instrument.
Sets or returns the time of trigger delay in sequence. This command is only valid on two-channel model instruments.
| Name | Type | Values | Description |
|---|---|---|---|
| skew_time | real | -320ns - 320ns | Trigger delay time in sequence. |
| qualifieropt | enum | MINimum | MAXimum | Selects the minimum or maximum delay value. |
SEQControl:DELay 100NS
Sets or returns the scale of sequence output. The value range is 0.0 to 1000, and at *RST the returned value is 100.
| Name | Type | Values | Description |
|---|---|---|---|
| scale_value | real | 0.0 - 1000 | Scale value for the sequence output. |
SEQControl:SOURce1:SCALe 50
Sets or returns the scale of sequence output.
SEQControl:SOURce1:SCALe 50
Sets or returns the offset of the sequence output for source 1 or 2. The offset value ranges from -1e6 to 1e6, and at *RST the returned value is 0.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | integer | 1 - 2 | Source index to apply the offset to. |
| offset_value | real | -1e6 - 1e6 | Offset value to set. |
| qualifieropt | enum | MINimum | MAXimum | Selects the minimum or maximum allowed offset value. |
SEQControl:SOURce1:OFFSet 0.1 SEQControl:SOURce1:OFFSet?
Sets or returns the offset of sequence output.
| Name | Type | Values | Description |
|---|---|---|---|
| offset_value | real | -1e6 - 1e6 | Offset value to set. |
SEQControl:SOURce1:OFFSet 0.1
Sets or queries the wait and jump trigger event timer. It takes effect when the event is TIMER and not in the off state.
| Name | Type | Values | Description |
|---|---|---|---|
| timer_value | real | 2 us - 3600 s | Timer value for the trigger event. |
| qualifieropt | enum | MINimum | MAXimum | Optional keyword to set the timer to its minimum or maximum value. |
SEQControl:TIMer 0.5
Returns or sets the wait-and-jump trigger event timer. The command takes effect when the event is TIMER and not in the off state.
SEQControl:TIMer 0.5
Sets or returns the target index for the GOTO command of the sequencer. The target applies after generating the waveform for a sequence element; if no GOTO target is specified, the sequencer moves to the next element.
| Name | Type | Values | Description |
|---|---|---|---|
| target | integer | 1 - 256 | Target element index for the sequencer GOTO jump. |
SEQuence:ELEM1:GOTO:INDEX 6 SEQuence:ELEM1:GOTO:INDEX?
Sets or returns the target index for the sequencer GOTO command for a sequence element. The sequencer jumps unconditionally to the specified element after generating the waveform; if no GOTO target is specified, it advances to the next element.
| Name | Type | Values | Description |
|---|---|---|---|
| target | integer | 1 - 256 | Target sequence element index to jump to. |
SEQuence:ELEM1:GOTO:INDEX 6 SEQuence:ELEM1:GOTO:INDEX?
Sets or returns the GOTO state of the sequencer. The SEQuence:ELEM[n]:GOTO:INDex command takes effect only when the GOTO state is ON.
| Name | Type | Values | Description |
|---|---|---|---|
| goto_state | boolean | - | Sets the GOTO state; 0 indicates OFF and 1 indicates ON. |
SEQuence:ELEM1:GOTO:STATe 1
Sets or returns the GOTO state of the sequencer element. The GOTO state must be ON for SEQuence:ELEM[n]:GOTO:INDex to take effect.
SEQuence:ELEM1:GOTO:STATe 1
Sets or queries the marker state for a sequence element. The sequence index n ranges from 1 to 256; 0 indicates OFF and 1 indicates ON.
| Name | Type | Values | Description |
|---|---|---|---|
| marker_state | boolean | - | Boolean marker state. |
SEQuence:ELEM1:MARKer:STATE 1
Returns or sets the marker state for a sequence element. The sequence index n ranges from 1 to 256.
SEQuence:ELEM1:MARKer:STATE 1
Sets or returns the target index for the sequencer’s event jump operation. It takes effect only when `SEQuence:ELEM[n]:JTARget:TYPE` is set to `INDex`.
| Name | Type | Values | Description |
|---|---|---|---|
| target | integer | 1 - 256 | Target index for the sequencer’s event jump operation. |
SEQuence:ELEM1:JTARGET:INDEX 10 SEQuence:ELEM1:JTARGET:INDEX?
Sets or returns the target index for the sequencer’s event jump operation. It takes effect only when `SEQuence:ELEM[n]:JTARget:TYPE` is set to `INDex`.
| Name | Type | Values | Description |
|---|---|---|---|
| target | integer | 1 - 256 | Target index for the jump operation; it must not be bigger than the current sequence table size. |
SEQuence:ELEM1:JTARGET:INDEX 10
Sets or returns the event jump target type for a sequence element. The index value for <n> ranges from 1 to 256.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | INDex | NEXT | OFF | Selects the event jump target type. |
SEQuence:ELEM1:JTARget:TYPE INDex
Sets or returns the event jump target type for the jump. The target can be set to index, next sequence element, or off.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | integer | 1 - 256 | Index number of the sequence element. |
SEQuence:ELEM1:JTARget:TYPE INDex
Sets or returns the jump trigger event type for a sequence element. If SEQuence:ELEM[n]:JTARget:TYPE is OFF, the sequencer ignores trigger signals.
| Name | Type | Values | Description |
|---|---|---|---|
| event | enum | EXT | BUS | MANual | TIMer | Trigger source for the jump event. |
SEQUENCE:ELEM1:JUMP:EVENt EXT
Sets or returns the jump trigger event type for a sequence element. If SEQuence:ELEM[n]:JTARget:TYPE is OFF, the sequencer ignores trigger signals.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | integer | 1 - 256 | Index number of the sequence element. |
| event | enum | EXT | BUS | MANual | TIMer | Jump trigger event type. |
SEQUENCE:ELEM1:JUMP:EVENt EXT
Sets or returns the slope of the external trigger for a jump trigger event. If SEQuence:ELEM[n]:JTARget:TYPE is OFF, the sequencer ignores trigger signals; if SEQuence:ELEM[n]:JUMP:EVENt is not Ext, the command has no effect.
| Name | Type | Values | Description |
|---|---|---|---|
| slope | enum | POSitive | NEGative | Indicates whether the event occurs on the rising or falling edge of the external trigger signal. |
SEQuence:ELEM1:JUMP:SLOPe POSitive
Sets or returns the slope of the external trigger for a jump trigger event. If SEQuence:ELEM[n]:JTARget:TYPE is OFF, trigger signals are ignored, and the command has no effect unless SEQUENCE:ELEM[n]:JUMP:EVENt is Ext.
| Name | Type | Values | Description |
|---|---|---|---|
| slope | enum | POSitive | NEGative | Slope of the external trigger signal for the jump trigger event. |
SEQuence:ELEM1:JUMP:SLOPe POSitive
Sets or returns the loop count for a sequence element. The loop count is ignored if `SEQuence:ELEM[n]:LOOP:INFinite` is set to ON.
| Name | Type | Values | Description |
|---|---|---|---|
| count | integer | 1 - 1E6 | Loop count value for the sequence element. |
SEQuence:ELEM1:LOOP:COUNt 100
Sets or returns the loop count for a sequence element. The loop count setting is ignored if `SEQuence:ELEM[n]:LOOP:INFinite` is set to ON.
SEQuence:ELEM1:LOOP:COUNt 100
Sets or returns the infinite looping state for a sequence element. When enabled, the sequencer continuously executes that element until stopped or the run mode is changed to Continuous.
| Name | Type | Values | Description |
|---|---|---|---|
| loop_state | boolean | - | Enables or disables infinite looping for the specified sequence element. |
SEQuence:ELEM1:LOOP:INFinite 1
Sets or returns the infinite looping state for a sequence element. When set ON, the sequencer continuously executes that element; to break the loop, stop the sequencer or change the run mode to Continuous.
SEQuence:ELEM1:LOOP:INFinite 1
Sets or returns the wait trigger state for a sequence element. The state can be triggered by an external trigger signal, the front-panel Force Trigger button, or the *TRG remote command.
| Name | Type | Values | Description |
|---|---|---|---|
| wait_trigger_state | boolean | - | Boolean wait trigger state; 0 indicates OFF and 1 indicates ON. |
| nopt | integer | 1 - 256 | Sequence element index. |
SEQuence:ELEM1:TWAit 1
Sets or returns the wait trigger state for an element. The state can be triggered by an external trigger signal, the front-panel Force Trigger button, or the *TRG remote command.
| Name | Type | Values | Description |
|---|---|---|---|
| wait_trigger_state | boolean | - | Boolean wait trigger state; 0 indicates OFF and 1 indicates ON. |
SEQuence:ELEM1:TWAit 1
Sets or returns the wait trigger event type for sequence element n. If SEQuence:ELEM[n]:TWAit is OFF, the sequencer ignores trigger signals.
| Name | Type | Values | Description |
|---|---|---|---|
| event | enum | EXT | BUS | MANual | TIMer | Selects the trigger signal source. |
SEQuence:ELEM1:TWAit:EVENt EXT
Sets or returns the wait trigger event type for a sequence element. If `SEQuence:ELEM[n]:TWAit` is OFF, the sequencer ignores trigger signals.
| Name | Type | Values | Description |
|---|---|---|---|
| event | enum | EXT | BUS | MANual | TIMer | Trigger event source for the wait trigger. |
SEQuence:ELEM1:TWAit:EVENt EXT
Sets or returns the slope of the external trigger for the wait trigger event. If :SEQuence:ELEM[n]:TWAit is OFF, the sequencer ignores trigger signals; if :SEQuence:ELEM[n]:TWAit:EVENt is not Ext, the command has no effect.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | integer | 1 - 256 | Index number of the sequence element. |
| slope | enum | POSitive | NEGative | Selects whether the event occurs on the rising or falling edge of the external trigger signal. |
SEQuence:ELEM1:TWAit:SLOPe POSitive
Sets or returns the slope of the external trigger for the wait trigger event. If the wait trigger is OFF, the sequencer ignores trigger signals; if :TWAit:EVENt is not Ext, the command has no effect.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | integer | 1 - 256 | Index number of the sequence element. |
| slope | enum | POSitive | NEGative | Sets the trigger slope to rising-edge positive or falling-edge negative. |
SEQuence:ELEM1:TWAit:SLOPe POSitive
Sets or returns the waveform for a sequence element. The suffix m = 1|2 indicates the channel that will output the waveform when the sequence is run, and defaults to 1 if omitted.
| Name | Type | Values | Description |
|---|---|---|---|
| wfm_name | string | - | Waveform path and name. |
SEQuence:ELEM1:WAVeform1 "P:/Pulse1000.tfwx"
Sets or returns the waveform for a sequence element. The suffix n selects the sequence index, and the optional channel suffix 1|2 selects which channel outputs the waveform when the sequence runs.
SEQuence:ELEM1:WAVeform1 "P:/Pulse1000.tfwx"
Sets or returns the sequence length. Passing 0 clears all sequence elements; reducing the value deletes elements at the end of the sequence.
| Name | Type | Values | Description |
|---|---|---|---|
| length | integer | 0 - 256 | Sequence length in number of elements. |
SEQuence:LENGth 10 SEQuence:LENGth?
Sets or returns the sequence length. Passing 0 clears all sequence elements; setting a value lower than the current length deletes elements from the end of the sequence.
SEQuence:LENGth?
Creates a new sequence with no name, empty steps, and no tracks. It clears the waveform list and sets the instrument settings to default; its function is the same as SEQC:RESET.
SEQuence:NEW
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.
| Name | Type | Values | Description |
|---|---|---|---|
| depth | real | 0.0 - 120.0 | AM modulation depth. |
| qualifier | enum | MINimum | MAXimum | Sets the modulation depth to the minimum or maximum value. |
SOURce1:AM:DEPth MAXimum
Sets or queries the internal modulation frequency of AM modulation for the specified channel. It is only valid when the internal modulation source is selected, and the frequency can be set from 1 mHz to 1 MHz with 1 mHz resolution.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | real | 1 mHz - 1 MHz | Internal modulation frequency. |
| qualifieropt | enum | MINimum | MAXimum | Use MINimum or MAXimum to set the minimum or maximum allowed internal modulation frequency. |
SOURce1:AM:INTernal:FREQuency 10kHz
Sets or queries the modulating waveform of AM modulation for the specified channel. It can be used only when the internal modulation source is selected.
| Name | Type | Values | Description |
|---|---|---|---|
| function | enum | SINusoid | SQUare | TRIangl | RAMP | NRAMp | PRNoise | EMEMory[1] | EMEMory2 | EFILe | Selects the AM internal modulating waveform. |
SOURce1:AM:INTernal:FUNCtion SQUare
Sets or queries the EFILe name used as the modulating waveform for AM modulation. The file must exist in the mass storage system; if no file is present, the command returns a blank value.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | Specifies a file name in the mass storage system, including path; path separators are forward slashes (/). |
SOURce1:AM:INTernal:FUNCtion:EFILe “U:\SAMPLE1.tfwx”
Sets or queries the source of the modulating signal used for AM modulation on the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | INTernal | EXTernal | Selects whether the carrier waveform is modulated with an internal or external source. |
SOURce1:AM:SOURce INTernal
Enables or disables AM modulation for the specified channel. The query returns the AM modulation state.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | <NR1> | Enables or disables AM modulation. |
SOURce1:AM:STATe ON
Sets or queries the idle state of burst. Idle state is the output level between two burst outputs.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | START | DC | END | Selects the burst idle state. |
SOURce1:BURSt:IDLE START
Sets or queries the burst mode for the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | TRIGgered | GATed | Selects the burst mode. |
SOURce1:BURSt:MODE TRIGgered
Sets or queries the burst count, in cycles, for the specified channel in burst mode. The query returns 9.9E+37 if the burst count is set to INFinity.
| Name | Type | Values | Description |
|---|---|---|---|
| cycles | integer | 1 - 1000000 | Burst count to output in burst mode. |
| qualifieropt | enum | INFinity | MINimum | MAXimum | Selects an infinite, minimum, or maximum burst count value. |
SOURce1:BURSt:NCYCles 2
Enables or disables burst mode for the specified channel. The query returns the burst mode state.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | <NR1> | Enables or disables burst mode. |
SOURce1:BURSt:STATe ON
Sets or queries the burst-mode delay time for the specified channel. It specifies the time delay between the trigger and the signal output and is available only in Triggered burst mode.
| Name | Type | Values | Description |
|---|---|---|---|
| delay | real | 0.0 ns - 85.000 s | Delay time between the trigger and the signal output. |
| qualifieropt | enum | MINimum | MAXimum | Selects the minimum or maximum delay time. |
SOURce1:BURSt:TDELay 20ms
Sets or queries whether to add internal noise, an external signal, or both to the output signal for the specified source channel. For internal noise, the noise level is controlled by SOURce<3|4>:POWer[:LEVel][:IMMediate][:AMPLitude].
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | NOISe | EXTernal | BOTH | " " | Selects internal noise, external signal, both, or disables the add function. |
SOURce1:COMBine:FEED "EXTernal"
Sets or queries the peak frequency deviation of FM modulation for the specified channel. The setting range depends on the selected carrier waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| deviation | real | Hz | Peak frequency deviation value. |
| qualifieropt | enum | MINimum | MAXimum | Returns or sets the minimum or maximum allowed deviation. |
SOURce1:FM:DEViation 1.0MHz
Sets or queries the internal modulation frequency of FM modulation for the specified channel. It can be used only when the internal modulation source is selected.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | real | 1 mHz - 1 MHz | Internal modulation frequency. |
| qualifieropt | enum | MINimum | MAXimum | Selects the minimum or maximum allowed internal modulation frequency. |
SOURce1:FM:INTernal:FREQuency 10kHz
Sets or queries the modulating waveform used for FM modulation on the specified channel. This command is only valid when the internal modulation source is selected.
| Name | Type | Values | Description |
|---|---|---|---|
| function | enum | SINusoid | SQUare | TRIangle | RAMP | NRAMp | PRNoise | EMEMory[1] | EMEMory2 | EFILe | Modulating waveform shape for FM internal modulation. |
SOURce1:FM:INTernal:FUNCtion SQUare
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 stored, the command returns a blank string.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | File name in the mass storage system, including path with forward slashes (/). |
SOURce1:FM:INTernal:FUNCtion:EFILe “SAMPLE1”
Sets or queries the FM modulation source for the specified channel. The internal source modulates the carrier waveform with the internal source, and the external source uses an external source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | INTernal | EXTernal | Source of the modulating signal. |
SOURce1:FM:SOURce INTernal
Enables or disables FM modulation. The query returns the state of FM modulation.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Enables or disables FM modulation. |
| value | nr1 | - | Numeric value used to enable (nonzero) or disable (zero) FM modulation. |
SOURce1:FM:STATe ON
Sets or queries the center frequency of sweep for the specified channel. It is used with [SOURce[1|2]]:FREQuency:SPAN, and the valid center-frequency range depends on the selected sweep waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | real | Hz | Center frequency. |
| qualifieropt | enum | MINimum | MAXimum | Use MINimum or MAXimum to set the center frequency to the minimum or maximum allowed value. |
SOURce1:FREQuency:CENTer 550kHz
Enables or disables copying the frequency (or period) of one channel to another channel. The header suffix selects the source channel; for example, with CH1 specified, the CH1 frequency is copied to CH2.
| Name | Type | Values | Description |
|---|---|---|---|
| stateopt | enum | ON | OFF | <NR1> | Enables or disables the concurrent copy function. |
SOURce1:FREQuency:CONCurrent ON
Sets or queries the output waveform frequency for the specified channel. It is available when Run Mode is set to other than Sweep.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | real | Hz | Output frequency to set. |
| qualifieropt | enum | MINimum | MAXimum | Use the minimum or maximum allowable frequency instead of a numeric value. |
SOURce1:FREQuency:FIXed 500kHz
Sets or queries the frequency sweep state. Select CW/FIXed for frequency control by the [SOURce[1|2]]:FREQuency[:CW|:FIXed] command, or SWEep for control by the sweep command set.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | CW | FIXed | SWEep | Selects whether frequency is controlled directly or by the sweep command set. |
SOURce1:FREQuency:MODE SWEep
Sets or queries the frequency span for the specified channel. It is used with [SOURce[1|2]]:FREQuency:CENTer, and the allowed setting range depends on the selected sweep waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | real | Hz | Frequency span to set. |
| qualifieropt | enum | MINimum | MAXimum | Sets the span to the minimum or maximum allowed value. |
SOURce1:FREQuency:SPAN 900kHz
Sets or queries the start frequency of sweep for the specified channel. It is used with the corresponding frequency STOP command, and the start frequency range depends on the selected sweep waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | real | Hz | Start frequency value. |
| qualifieropt | enum | MINimum | MAXimum | Allows setting the start frequency to the minimum or maximum allowed value. |
SOURce1:FREQuency:STARt 10kHz
Sets or queries the sweep stop frequency for the specified channel. It is always used with [SOURce[1|2]]:FREQuency:STARt and the valid range depends on the selected sweep waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | real | Hz | Stop frequency value. |
| qualifieropt | enum | MINimum | MAXimum | Allows setting the stop frequency to the minimum or maximum allowed value. |
SOURce1:FREQuency:STOP 100kHz
Sets or queries the hop frequency of FSK modulation for the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | real | Hz | Hop frequency value. The syntax allows an NRf value with optional units of Hz, kHz, or MHz. |
| qualifieropt | enum | MINimum | MAXimum | Use a keyword instead of a numeric frequency value. |
SOURce1:FSKey:FREQuency 1.0MHz
Sets or queries the internal modulation rate of FSK modulation for the specified channel. This command is valid only when the internal modulation source is selected.
| Name | Type | Values | Description |
|---|---|---|---|
| rate | real | Hz | The modulation rate. |
| qualifieropt | enum | MINimum | MAXimum | Alternative to a numeric rate value. |
SOURce1:FSKey:INTernal:RATE 50Hz
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.
Sets or queries the source of the FSK modulation signal for the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | INTernal | EXTernal | Selects whether the modulation source is internal or external. |
SOURce1:FSKey:SOURce INTernal
Sets or queries the source of the FSK modulation signal for the specified channel. Internal uses the carrier waveform's internal source; external uses an external source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | INTernal | EXTernal | Selects the modulation source. |
SOURce1:FSKey:SOURce INTernal
Enables or disables FSK modulation. The query returns the state of FSK modulation.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Enables or disables FSK modulation. |
| value | integer | - | Numeric value where nonzero enables FSK modulation and zero disables it. |
SOURce1:FSKey:STATe ON
Returns or sets the FSK modulation state. This command enables or disables FSK modulation; the query returns the state of FSK modulation.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Enables or disables 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 command returns a blank string if there is no file in the mass storage.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | File name in the mass storage system, including path; path separators are forward slashes (/). |
SOURce1:AM:INTernal:FUNCtion:EFILe “U:\SAMPLE1.tfwx”
Sets or queries the EFILe name used as an output waveform. A file name must be specified in the mass storage system; the command returns a blank string if there is no file in mass storage.
SOURce1:AM:INTernal:FUNCtion:EFILe “U:\SAMPLE1.tfwx”
Sets or queries the symmetry of the ramp waveform for the specified channel. The setting range is 0.0% to 100.0%.
| Name | Type | Values | Description |
|---|---|---|---|
| symmetry | real | 0.0 - 100.0 | Ramp waveform symmetry. |
| qualifieropt | enum | MINimum | MAXimum | Returns the minimum or maximum symmetry value. |
SOURce1:FUNCtion:RAMP:SYMMetry 80.5
Sets or queries the symmetry of the ramp waveform for the specified channel. The setting range is 0.0% to 100.0%.
SOURce1:FUNCtion:RAMP:SYMMetry 80.5
Sets or queries the output waveform shape. If a selected user memory has been deleted, selecting it causes an error.
| Name | Type | Values | Description |
|---|---|---|---|
| shape | enum | SINusoid | SQUare | PULSe | RAMP | PRNoise | DC | SINC | GAUSsian | LORentz | ERISe | EDECay | HAVersine | EMEMory[1] | EMEMory2 | EFILe | Selects the output waveform shape. |
SOURce1:FUNCtion:SHAPe SQUare
Sets or queries the shape of the output waveform. If a specified user memory has been deleted, selecting that memory causes an error.
SOURce1:FUNCtion:SHAPe SQUare
Sets or queries the phase of the output waveform for the specified channel. The value may be entered in radians or degrees; if no units are specified, RAD is assumed. The query returns the phase value in RAD.
| Name | Type | Values | Description |
|---|---|---|---|
| phase | real | -1 PI - +1 PI | Phase of the output frequency. |
SOURce1:PHASe:ADJust MAXimum
Sets or queries the phase of the specified output waveform channel. The phase may be entered in radians or degrees; if no units are specified, RAD is assumed. The query returns the phase value in RAD.
| Name | Type | Values | Description |
|---|---|---|---|
| phase | real | -1 PI - +1 PI | Phase of the output frequency. |
| qualifieropt | enum | MINimum | MAXimum | Allows setting the minimum or maximum phase value. |
SOURce1:PHASe:ADJust MAXimum
Enables or disables the concurrent copy function that copies the phase of one channel to another. For a dual-channel model, specifying CH1 copies the CH1 phase to CH2; the query returns 0 (OFF) or 1 (ON).
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | <NR1> | Turns the concurrent copy function on or off. |
SOURce1:PHASe:CONCurrent ON
Enables or disables the function that copies the phase of one channel to another channel. The query returns 0 (OFF) or 1 (ON).
SOURce1:PHASe:CONCurrent ON
Synchronizes the phase of CH1 and CH2 output waveforms. The same operation is performed whether SOURce1 or SOURce2 is specified.
SOURce1:PHASe:INITiate
Sets or queries the peak frequency deviation of PM modulation for the specified channel. The deviation is entered as an NR3 value with optional units RAD or DEG; if units are omitted, RAD is used automatically.
| Name | Type | Values | Description |
|---|---|---|---|
| deviation | real | 0 - +1 PI | Phase deviation value. For RAD, the range is 0 PI to +1 PI relative to phase value; for DEG, the range is 0 to +180 in 1 degree steps relative to phase value. |
| qualifieropt | enum | MINimum | MAXimum | Sets the deviation to the minimum or maximum allowed value. |
SOURce1:PM:DEViation MAXimum
Sets or queries the peak frequency deviation of PM modulation for the specified channel.
Sets or queries the internal modulation frequency of PM modulation for the specified channel. Can be used only when the internal modulation source is selected.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | real | 1 mHz - 1 MHz | Internal modulation frequency to set. |
| qualifieropt | enum | MINimum | MAXimum | Use MINimum or MAXimum to set the frequency to the minimum or maximum allowed value. |
SOURce1:PM:INTernal:FREQuency 10kHz
Sets or queries the internal modulation frequency of PM modulation for the specified channel. Use only when the internal modulation source is selected; the frequency can be set from 1 mHz to 1 MHz with 1 mHz resolution.
SOURce1:PM:INTernal:FREQuency 10kHz
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.
| Name | Type | Values | Description |
|---|---|---|---|
| function | enum | SINusoid | SQUare | TRIangle | RAMP | NRAMp | PRNoise | EMEMory[1] | EMEMory2 | EFILe | Modulating waveform to use as the PM internal source. |
SOURce1:PM:INTernal:FUNCtion SQUare
Sets or queries the modulating waveform of PM modulation for the specified channel. Use only when the internal modulation source is selected.
SOURce1:PM:INTernal:FUNCtion SQUare
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 no file is present.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | File name in the mass storage system, including path; path separators are forward slashes (/). |
SOURce1:PM:INTernal:FUNCtion:EFILe “M:/SAMPLE1.tfwx"
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 query returns a blank string if there is no file in mass storage.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | File name in the mass storage system, including path; path separators are forward slashes (/). |
SOURce1:PM:INTernal:FUNCtion:EFILe “M:/SAMPLE1.tfwx"
Sets or queries the modulation source for PM modulation on the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | INTernal | EXTernal | Selects whether the carrier waveform is modulated with an internal or external source. |
SOURce1:PM:SOURce INTernal
Sets or queries the source of the modulation signal for PM modulation on the specified channel.
SOURce1:PM:SOURce INTernal
Enables or disables PM modulation. The query returns the state of PM modulation.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | <NR1> | Enables or disables PM modulation. |
SOURce1:PM:STATe ON
Enables or disables PM modulation. The query returns the state of PM modulation.
SOURce1:PM:STATe ON
Sets or queries the duty cycle of the pulse waveform for the specified channel. The duty cycle range is 0.001% to 99.999% in 0.001% increments; the instrument holds leading and trailing edge settings when duty cycle is varied.
| Name | Type | Values | Description |
|---|---|---|---|
| percent | real | 0.001 - 99.999 | Duty cycle value to set, in percent. |
| qualifieropt | enum | MINimum | MAXimum | Use MINimum or MAXimum to set the duty cycle to the minimum or maximum allowed value. |
SOURce1:PULSe:DCYCle 80.5
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.
| Name | Type | Values | Description |
|---|---|---|---|
| percent | real | 0.001 - 99.999 | Duty cycle value. |
| qualifieropt | enum | MINimum | MAXimum | Optional keyword to set the duty cycle to the minimum or maximum value. |
SOURce1:PULSe:DCYCle 80.5
Sets or queries the lead delay of the pulse waveform for the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| delay | real | 0 ns - Pulse Period | Lead delay value for the pulse waveform. |
| qualifieropt | enum | MINimum | MAXimum | Selects the minimum or maximum allowed delay. |
SOURce1:PULSe:DELay 20ms
Sets or queries the lead delay of the pulse waveform for the specified channel.
Sets the instrument to hold either pulse width or pulse duty. The query returns whether width or duty is being held.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | WIDTh | DUTY | Selects whether the AFG holds the pulse width setting or the pulse duty setting. |
SOURce1:PULSe:HOLD WIDTh
Sets the instrument to hold either pulse width or pulse duty. The query returns the current hold mode as WIDTh or DUTY.
SOURce1:PULSe:HOLD WIDTh
Sets or queries the period for pulse waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| period | real | - | Pulse period value. |
| qualifieropt | enum | MINimum | MAXimum | Returns or sets the minimum or maximum period value. |
SOURce1:PULSe:PERiod 200ns
Sets or queries the pulse waveform period.
Sets or queries the leading edge time of the pulse waveform for the selected source. The value is given in seconds with optional time units.
| Name | Type | Values | Description |
|---|---|---|---|
| seconds | real | s | Leading edge time of the pulse waveform. |
| qualifieropt | enum | MINimum | MAXimum | Sets the value to the minimum or maximum allowed leading edge time. |
SOURce1:PULSe:TRANsition:LEADing 200ns
Sets or queries the leading edge time of the pulse waveform. The value is specified in seconds with optional units, or as MINimum/MAXimum.
| Name | Type | Values | Description |
|---|---|---|---|
| seconds | real | s | Leading edge time of the pulse waveform. |
| qualifieropt | enum | MINimum | MAXimum | Selects the minimum or maximum allowed value. |
SOURce1:PULSe:TRANsition:LEADing 200ns
Sets or queries the trailing edge time of the pulse waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| seconds | real | s | Trailing edge time of the pulse waveform. |
| qualifieropt | enum | MINimum | MAXimum | Selects the minimum or maximum trailing edge time. |
SOURce1:PULSe:TRANsition:TRAiling 200ns
Queries the trailing edge time of the pulse waveform for the selected source. The value is expressed as a time in seconds with optional units.
SOURce1:PULSe:TRANsition:TRAiling 200ns
Sets or queries the pulse width for the specified source channel. The pulse width must be less than the period and is constrained by the duty-cycle range and edge-time limits.
| Name | Type | Values | Description |
|---|---|---|---|
| seconds | real | 0.001% - 99.999% | Pulse width value expressed as a duty cycle percentage; the manual also gives channel-dependent absolute time ranges in nanoseconds to seconds. |
| qualifieropt | enum | MINimum | MAXimum | Selects the minimum or maximum pulse width. |
SOURce1:PULSe:WIDTh 200ns
Sets or queries the pulse width for the specified source channel. The pulse width is constrained by the duty-cycle range and must be less than the pulse period.
| Name | Type | Values | Description |
|---|---|---|---|
| seconds | real | 0.001% - 99.999% | Pulse width value. |
| qualifieropt | enum | MINimum | MAXimum | Selects the minimum or maximum pulse width. |
SOURce1:PULSe:WIDTh 200ns
Sets or queries the internal modulation frequency of PWM modulation for the specified channel. It can be used only when the internal modulation source is selected, and the frequency range is 1 mHz to 1 MHz with 1 mHz resolution.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | real | 1 mHz - 1 MHz | Internal modulation frequency to set. |
| qualifieropt | enum | MINimum | MAXimum | Selects the minimum or maximum internal modulation frequency. |
SOURce1:PWM:INTernal:FREQuency 10kHz
Sets or queries the internal modulation frequency of PWM modulation for the specified channel. This command is only valid when the internal modulation source is selected.
SOURce1:PWM:INTernal:FREQuency 10kHz
Sets or queries the modulating waveform used for PWM modulation on the specified channel. This command is valid only when the internal modulation source is selected.
| Name | Type | Values | Description |
|---|---|---|---|
| waveform | enum | SINusoid | SQUare | TRIangle | RAMP | NRAMp | PRNoise | EMEMory[1] | EMEMory2 | EFILe | Selects the PWM modulating waveform. |
SOURce1:PWM:INTernal:FUNCtion SQUare
Sets or queries the modulating waveform used for PWM modulation on the specified source channel. It can be used only when the internal modulation source is selected; specifying EFILe before defining the external file causes an error.
| Name | Type | Values | Description |
|---|---|---|---|
| waveform | enum | SINusoid | SQUare | TRIangle | RAMP | NRAMp | PRNoise | EMEMory[1] | EMEMory2 | EFILe | Modulating waveform selection for PWM internal function. |
SOURce1:PWM:INTernal:FUNCtion SQUare
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; if no file is present, the command returns a blank string.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | File name in the mass storage system to use as the PWM modulating waveform. |
SOURce1:PWM:INTernal:FUNCtion:EFILe "U:/SAMPLE1.tfwx"
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; the query returns an empty string if there is no file in mass storage.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | Name of the file in mass storage to use as the PWM modulating waveform. |
SOURce1:PWM:INTernal:FUNCtion:EFILe "U:/SAMPLE1.tfwx"
Sets or queries the source of the PWM modulating signal for the specified channel. Internal means the carrier waveform is modulated with the internal source; external means it is modulated with an external source.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | INTernal | EXTernal | Selects the source of the modulating signal. |
SOURce1:PWM:SOURce INTernal
Sets or queries the source of the PWM modulating signal for the specified channel. Internal source means the carrier waveform is modulated with the internal source; external source means it is modulated with an external source.
SOURce1:PWM:SOURce INTernal
Enables or disables PWM modulation. The query returns the state of PWM modulation.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Enables or disables PWM modulation. |
| value | integer | - | Numeric form of the state, where nonzero enables PWM modulation and zero disables it. |
SOURce1:PWM:STATe ON
Enables or disables PWM modulation. The query returns the state of PWM modulation.
SOURce1:PWM:STATe ON
Queries the run mode. The query returns the current run mode.
SOURce:RMOD?
Sets or queries the PWM deviation in percent for the specified channel. The setting range must satisfy pulse-width and edge-time constraints.
| Name | Type | Values | Description |
|---|---|---|---|
| percent | real | PCT | PWM deviation. |
| qualifieropt | enum | MINimum | MAXimum | Selects the minimum or maximum allowed deviation. |
SOURce1:PWM:DCYCle 5.0
Sets or queries the PWM deviation in percent for the specified channel. The setting range must satisfy the pulse-width, pulse-period, and edge-time constraints given in the manual.
SOURce1:PWM:DCYCle 5.0
Sets or queries the sweep hold time, which is the time the frequency must remain stable after reaching the stop frequency.
| Name | Type | Values | Description |
|---|---|---|---|
| seconds | real | s | Hold time value. |
| qualifieropt | enum | MINimum | MAXimum | Use a minimum or maximum hold time keyword instead of a numeric value. |
SOURce1:SWEep:HTIMe 1ms
Selects auto or manual sweep mode for the specified channel. The query returns the sweep mode for the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | AUTO | MANual | Sweep mode to set for the specified channel. |
SOURce1:SWEep:MODE AUTO
Sets or queries the sweep return time, which is the time from stop frequency through start frequency and does not include hold time.
| Name | Type | Values | Description |
|---|---|---|---|
| seconds | real | s | Return time in seconds. |
| qualifieropt | enum | MINimum | MAXimum | Selects the minimum or maximum return time. |
SOURce1:SWEep:RTIMe 1ms
Selects linear or logarithmic spacing for the sweep on the specified channel. The query returns the current sweep spacing type.
| Name | Type | Values | Description |
|---|---|---|---|
| spacing | enum | LINear | LOGarithmic | Sets the sweep spacing to linear or logarithmic. |
SOURce1:SWEep:SPACing LINear
Sets or queries the sweep time for the specified channel. The sweep time does not include hold time or return time, and the setting range is 1 ms to 500 s.
| Name | Type | Values | Description |
|---|---|---|---|
| seconds | real | 1 ms - 500 s | Sweep time value in seconds. |
| qualifieropt | enum | MINimum | MAXimum | Optional keyword to set the sweep time to the minimum or maximum allowed value. |
SOURce1:SWEep:TIME 100ms
Enables or disables the function that copies the voltage level of one channel to another. If CH1 is specified in the header, its voltage level is copied to CH2; the command is not supported on single-channel models.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Enables or disables the concurrent copy function. |
SOURce1:VOLTage:CONCurrent:STATe ON
Sets or queries the high level of output amplitude for the specified channel. On dual-channel models, if concurrent output is ON, the other channel is set to the same value.
| Name | Type | Values | Description |
|---|---|---|---|
| voltage | real | V | High level of output amplitude. |
| qualifieropt | enum | MINimum | MAXimum | Sets the level to the minimum or maximum allowed value. |
SOURce1:VOLTage:LEVel:IMMediate:HIGH 1V
Sets or queries the low level of output amplitude for the specified channel. On dual-channel models, if [SOURce[1|2]]:VOLTage:CONCurrent[:STATe] is ON, the other channel's low level is set to the same value.
| Name | Type | Values | Description |
|---|---|---|---|
| voltage | real | V | Low level of output amplitude. |
| qualifieropt | enum | MINimum | MAXimum | Optional setting keyword accepted in place of a numeric voltage. |
SOURce1:VOLTage:LEVel:IMMediate:LOW -1V
Sets or queries the offset level for the specified channel. On dual-channel models, if concurrent mode is ON, the other channel is set to the same value.
| Name | Type | Values | Description |
|---|---|---|---|
| voltage | real | mV|V | Offset voltage level. |
| qualifieropt | enum | MINimum | MAXimum | Allows setting the offset to the minimum or maximum allowed value. |
SOURce1:VOLTage:LEVel:IMMediate:OFFSet 500mV
Sets or queries the output amplitude for the specified channel. The amplitude value includes an optional unit of VPP, VRMS, or DBM.
| Name | Type | Values | Description |
|---|---|---|---|
| amplitude | real | VPP | Output amplitude value to set. |
| qualifieropt | enum | MINimum | MAXimum | Allows the command to set the minimum or maximum amplitude. |
SOURce1:VOLTage:LEVel:IMMediate:AMPLitude 1VPP
Sets or queries the higher limit of the output amplitude high level for the specified channel. If concurrent mode is ON on a dual-channel model, the other channel uses the same higher limit value.
| Name | Type | Values | Description |
|---|---|---|---|
| voltage | real | V | Higher limit of the output amplitude high level. |
| qualifieropt | enum | MINimum | MAXimum | Optional keyword to set the value to the minimum or maximum allowed limit. |
SOURce1:VOLTage:LIMit:HIGH 1V
Sets or queries the lower limit of the output amplitude low level for the specified channel. On dual-channel instruments with concurrent mode ON, the other channel uses the same low-level limit.
| Name | Type | Values | Description |
|---|---|---|---|
| voltage | real | mV|V | 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 offset, High level, or Low level output, and if concurrent channel units are enabled on a dual-channel model the other channel is set the same.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | VPP | VRMS | DBM | Units of the output voltage amplitude. |
SOURce1:VOLTage:UNIT VPP
Stops output, then sets the burst state to wait for the next trigger.
SOURce:BURSt:INFInite:REARm
Sets the reference clock to either internal or external.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | INTernal | EXTernal | Selects the reference clock source. |
SOURce:ROSCillator:SOURce INTernal
Sets or queries the internal noise level for the specified channel. The noise level is a percent of the current amplitude level and is available only in Continuous, Burst, or Sweep run modes.
| Name | Type | Values | Description |
|---|---|---|---|
| percent | real | 0 - 50 | Noise level as a percentage of the current amplitude level. |
| qualifieropt | enum | MINimum | MAXimum | Selects the minimum or maximum allowable noise level. |
SOURce3:POWer:LEVel:IMMediate:AMPLitude 50PCT
Returns the contents of the Operation Condition Register.
STATus:OPERation:CONDition? Might return 32 which indicates that the OCR contains the binary number 00000000 00100000 and the CH1 of the instrument is waiting for trigger.
Sets or queries the mask for the Operation Enable Register.
| Name | Type | Values | Description |
|---|---|---|---|
| bit_value | integer | - | Bit mask value for the Operation Enable Register. |
Returns the value in the Operation Event Register and clears the Operation Event Register.
STATus:OPERation?
Presets the SCPI status registers (OENR and QENR).
STATus:PRESet
Returns the contents of the Questionable Condition Register.
STATus:QUEStionable:CONDition?
Sets or queries the mask for the Questionable Enable Register.
| Name | Type | Values | Description |
|---|---|---|---|
| bit_value | integer | - | Bit value mask for the Questionable Enable Register. |
STATus:QUEStionable:ENABle 32
Returns the value in the Questionable Event Register and clears that register.
STATus:QUEStionable:EVENt?
Sets the beeper state to ON or OFF. The query form returns 0 for OFF or 1 for ON.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Enables or disables the beeper. |
SYSTem:BEEPer:STATe ON
Returns the contents of the Error/Event queue. If an error or event is present, the response includes the event number and event message.
SYSTem:ERRor? might return the following response: -410,”Query INTERRUPTED”
Causes the instrument to beep immediately.
SYSTem:BEEPer
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).
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Enables or disables the click sound. |
SYSTem:KCLick:STATe ON
Locks or unlocks the instrument front panel controls. The query returns 0 (OFF) or 1 (ON).
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Locks or unlocks the front panel controls. |
| value | integer | - | Numeric value where nonzero locks the front panel controls and zero unlocks them. |
SYSTem:KLOCk:STATe ON
Disables protected commands and activates the instrument security protection. On AFG31000 Series instruments, no remote commands are under the control of SYSTem:PASSword commands.
| Name | Type | Values | Description |
|---|---|---|---|
| password | string | - | Specifies the current password; the string is case sensitive. |
SYSTem:PASSword:CDISable "password"
Enables protected commands to function and deactivates the instrument security protection. The password string is case sensitive.
| Name | Type | Values | Description |
|---|---|---|---|
| password | string | - | Specifies the current password. |
SYSTem:PASSword:CENable "password"
Returns the security protection state.
SYSTem:PASSword:STATe?
Changes the password. The current and new password strings are case sensitive and must be 4 to 12 characters long.
| Name | Type | Values | Description |
|---|---|---|---|
| current_password | string | - | Specifies the current password. |
| new_password | string | - | Specifies a new password. |
SYSTem:PASSword:NEW “DEFAULT”,“abc123”
Restarts the instrument. It is equivalent to pushing the front-panel power switch.
SYSTem:RESTart
Erases current instrument setups, setup memory, last setup memory, user waveform memory, and log content, and recalls the factory default settings. Calibration data is not erased; the communication settings are initialized to factory defaults.
SYSTem:SECurity:IMMediate
Sets or queries the language the instrument uses to display information on the screen.
| Name | Type | Values | Description |
|---|---|---|---|
| language | enum | ENGLish | FRENch | GERMan | JAPanese | KORean | SCHinese | TCHinese | RUSSian | Specifies which language will be used to display instrument information on the screen. |
SYSTem:ULANguage FRENch
Returns the conformed SCPI version of the instrument.
SYSTem:VERSion?
Transfers waveform data from the external controller to the AFG edit memory. The query form returns the binary block data.
| Name | Type | Values | Description |
|---|---|---|---|
| memory | enum | EMEMory[1] | EMEMory2 | Target edit memory. |
| binary_block_data | block | - | Waveform data in binary format. |
DATA:DATA EMEMory1,#42000<DAB><DAB>...<DAB>
Sets or queries the slope of the trigger signal. Positive selects the rising edge of the external trigger signal; negative selects the falling edge.
| Name | Type | Values | Description |
|---|---|---|---|
| slope | enum | POSitive | NEGative | Selects the trigger edge polarity. |
TRIGger:SLOPe POSitive
Sets or queries the trigger source for an external trigger signal.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | TIMer | EXTernal | Specifies the trigger source. |
TRIGger:SEQuence:SOURce EXTernal
Sets or queries the period of the internal clock used as the trigger source when internal triggering is selected with TRIGger[:SEQuence]:SOURce. The setting range is 1 us to 500.0 s.
| Name | Type | Values | Description |
|---|---|---|---|
| seconds | real | 1 us - 500.0 s | Period of the internal clock. |
TRIGger:TIMer 5ms
Forces a trigger event to occur.
TRIGger:SEQuence:IMMediate
Returns the waveform name from the waveform list at the specified index. The returned string includes the waveform name with path.
| Name | Type | Values | Description |
|---|---|---|---|
| index | integer | 1 - 256 | Index of the waveform list entry to read. |
WLISt:NAME? 21
Returns the number of waveforms in the waveform list.
WLISt:SIZE?
Deletes a waveform from the waveform list. If the deleted waveform is currently loaded into waveform memory and the sequence table, it is unloaded.
| Name | Type | Values | Description |
|---|---|---|---|
| wfm_name | string | - | Indicates the waveform path and name. |
| ALL | enum | ALL | Deletes all waveforms in the list. |
WLISt:WAVeform:DELete ALL WLISt:WAVeform:DELete "M:/Test1.tfwx"
Imports a waveform from internal driver or USB driver into the waveform list.
| Name | Type | Values | Description |
|---|---|---|---|
| wfm_name | string | - | Indicates the waveform path and name. |
WLISt:WAVeform:IMPort “M:/Test1.tfwx"
Returns the size of the waveform in data points, not bytes.
| Name | Type | Values | Description |
|---|---|---|---|
| wfm_name | string | - | Indicates the waveform path and name. |
WLISt:WAVeform:LENGth? "M:/Sine360.tfwx"
Transfers arbitrary block waveform data to edit memory. The example shows sending the command with an edit-memory target and definite-length block header before writing the byte array data.
| Name | Type | Values | Description |
|---|---|---|---|
| memory | enum | EMEMORY1 | Edit memory destination for the waveform data. |
| block data | block | - | Arbitrary block data to transfer. |
TRACE:DATA EMEMORY1,#44000