Performs an internal calibration. The related query form returns 0 (Pass) or a calibration error code.
SCPI COMMAND REFERENCE
The Tektronix AFG3021 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 and returns the result of the calibration. The operation may take several minutes to complete.
CALIBRATION[:ALL]?
Queries the calibration function. The table lists the command as supported in SCPI 1999.0.
| Name | Type | Values | Description |
|---|---|---|---|
| ALLopt | enum | - | Optional node shown in the syntax line. |
Performs a self-test. The query form returns the test result after executing the self-test.
DIAGNOSTIC[:ALL] DIAGNOSTIC[:ALL]?
Performs a self-test. The query form returns the results after executing the test.
DIAGNOSTIC[:ALL] DIAGNOSTIC[:ALL]?
Returns the diagnostic state. The command supports the optional ALL node.
Sets or queries the brightness of the LCD display.
Sets or queries the brightness of the LCD display.
Sets or queries the contrast of the LCD display. Available for AFG3000 series and AFG3000B series instruments.
| Name | Type | Values | Description |
|---|---|---|---|
| contrast | real | 0.00 - 1.00 | Display contrast level; larger values increase screen contrast. |
| qualifieropt | enum | MINimum | MAXimum | Sets the contrast to the minimum or maximum level. |
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.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Screen saver enable state. |
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.
DISPlay:SAVer[:STATe]?
Clears the text message from the display screen.
Displays a text message on the instrument screen. The query form returns the text string currently displayed on the instrument screen.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | 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.
DISPLAY[:WINDOW]:TEXT[:DATA]?
Sets or queries the display contrast.
Immediately executes the display saver operation. The command is listed as supported in the SCPI conformance table.
Returns the current display saver state.
Clears the text displayed in the selected display window.
Sets or queries the text displayed in the display window. The optional DATA node is shown in the conformance table for this command.
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.
| Name | Type | Values | Description |
|---|---|---|---|
| bit_value | integer | 0 - 255 | Binary bits of the ESER are set according to this value. |
*ESE 177 *ESE?
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.
| Name | Type | Values | Description |
|---|---|---|---|
| NR1 | integer | 0 | 0 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. |
*PSC 0
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.
Clears the instrument status structure. This command is part of the standard event/status system commands.
Sets the bits of the Service Request Enable Register (SRER). Bit 6 must be 0.
| Name | Type | Values | Description |
|---|---|---|---|
| bit value | integer | 0 - 255 | Bit pattern to load into the SRER. |
Checks calibration status. This is listed as a SCPI conformance command with an optional ALL node in the manual table.
Clears the status data structures. This command is defined in SCPI 1999.0.
Sets or queries the Event Status Enable register.
Returns the event status register value.
Returns the instrument identification string.
Returns a synchronization message indicating that all previous commands have been received and processed.
Returns the instrument options information.
Recalls the instrument state from a previously saved setup register.
Resets the instrument to its default state.
Saves the current instrument state to nonvolatile memory.
Returns the status byte value.
Triggers the device. This command is listed as not defined in SCPI 1999.0.
Returns the self-test result.
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.
| 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; ON or nonzero locks it, OFF or zero allows overwrite or delete. |
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.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | <NR1> | Enables or disables last-setup recall; <NR1>≠0 enables and <NR1>=0 disables. |
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.
| Name | Type | Values | Description |
|---|---|---|---|
| stateopt | enum | LOCK | UNLock | State of the memory-state lock. |
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.
Sets or queries whether to lock a file or directory in mass storage. If locked, the file or directory cannot be overwritten or deleted.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | File or directory name in mass storage to lock or unlock. |
| state | enum | ON | OFF | <NR1> | Locks when ON or nonzero, and allows overwrite or delete when OFF or zero. |
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.
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.
Deletes a file or directory from mass memory.
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.
| Name | Type | Values | Description |
|---|---|---|---|
| trace | enum | TRACe | Selects trace loading. |
Returns the current lock state of the MMEMory subsystem. The state can be queried with an optional STATe node.
Sets the current working directory used by MMEMory commands.
Stores the current state into a mass memory state location.
| Name | Type | Values | Description |
|---|---|---|---|
| state | integer | - | 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.
| Name | Type | Values | Description |
|---|---|---|---|
| channelopt | enum | 1 | 2 | Specifies output channel 1 or 2. |
| ohms | real | 1 - 10 kΩ | Sets the load impedance in ohms. |
| qualifieropt | enum | INFinity | MINimum | MAXimum | Special 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.
| Name | Type | Values | Description |
|---|---|---|---|
| polarity | enum | NORMal | INVerted | Sets the specified output waveform polarity. |
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.
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.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Turns the arbitrary function generator output on or off. |
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.
Returns the output impedance setting for output 1 or 2.
Returns the output polarity for the selected output channel.
Sets or queries the output state of output 1 or 2. The command applies to the selected output channel.
| Name | Type | Values | Description |
|---|---|---|---|
| stateopt | enum | ON | OFF | Turns the output on or off. |
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 | Modulation depth in percent. |
| qualifieropt | enum | MINimum | MAXimum | Sets the modulation depth to the minimum or maximum value. |
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.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | real | Hz | Modulation frequency to set. |
| qualifieropt | enum | MINimum | MAXimum | Selects the minimum or maximum allowed 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.
| Name | Type | Values | Description |
|---|---|---|---|
| function | enum | SINusoid | SQUare | TRIangle | RAMP | NRAMp | PRNoise | USER[1] | USER2 | USER3 | USER4 | EMEMory[1] | EMEMory2 | EFILe | Modulating 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.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | File name in the mass storage system, including path with forward slashes (/). |
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.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | INTernal | EXTernal | Selects the 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.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | ON enables AM modulation; OFF disables AM modulation. |
| value | integer | 0 | <NR1> where nonzero enables AM modulation and 0 disables it. |
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.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | TRIGgered | GATed | Selects the burst mode. |
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.
| Name | Type | Values | Description |
|---|---|---|---|
| cycles | integer | 1 - 1000000 | Burst count to output in burst mode. |
| qualifieropt | enum | INFinity | MINimum | MAXimum | Allows setting the burst count to infinite, minimum, or maximum count. |
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.
| Name | Type | Values | Description |
|---|---|---|---|
| delay | real | 0.0 ns - 85.000 s | Delay time value, expressed as <NRf> with units s, ms, μs, or ns. |
| qualifieropt | enum | MINimum | MAXimum | Sets 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.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Enables or disables burst mode. |
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.
| Name | Type | Values | Description |
|---|---|---|---|
| stateopt | enum | NOISe | EXTernal | BOTH | | Selects internal noise, an external signal, both, or disables the add function. |
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.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | real | 2 mHz - 50.00 kHz | Internal FM modulation frequency. |
| qualifieropt | enum | MINimum | MAXimum | Selects 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.
| Name | Type | Values | Description |
|---|---|---|---|
| deviation | real | Hz | Peak frequency deviation. |
| qualifieropt | enum | MINimum | MAXimum | Use MINimum or MAXimum to set or query the extreme deviation value. |
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.
| Name | Type | Values | Description |
|---|---|---|---|
| waveform | enum | SINusoid | SQUare | TRIangle | RAMP | NRAMp | PRNoise | USER[1] | USER2 | USER3 | USER4 | EMEMory[1] | EMEMory2 | EFILe | Modulating 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.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | Specifies a file name in the mass storage system, including path. |
SOURce1:FM:INTernal:FUNCtion:EFILe “SAMPLE1”
Sets or queries the source of the FM modulating signal for the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | INTernal | EXTernal | Selects the FM modulating source. |
Enables or disables FM modulation for the specified source channel. The query returns the state of FM modulation.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | <NR1> | ON or <NR1>≠0 enables FM modulation; OFF or <NR1>=0 disables 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.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | real | - | Center frequency value. |
| qualifieropt | enum | MINimum | MAXimum | Use 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.
| Name | Type | Values | Description |
|---|---|---|---|
| stateopt | enum | ON | OFF | <NR1> | Enables or disables the concurrent copy function. |
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.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | real | Hz | Output frequency value, optionally followed by units. |
| qualifieropt | enum | MINimum | MAXimum | Selects the minimum or maximum allowable frequency value. |
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.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | real | Hz | The frequency span. |
| qualifieropt | enum | MINimum | MAXimum | Selects the minimum or maximum span value. |
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.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | real | Hz | Start frequency. |
| qualifieropt | enum | MINimum | MAXimum | Selects the minimum or maximum allowable 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.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | real | Hz | Stop frequency to set. |
| qualifieropt | enum | MINimum | MAXimum | Use a boundary value instead of an explicit frequency. |
SOURce1:FREQuency:STOP 100KHz 100KHz
Sets or queries the hop frequency of FSK modulation for the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | real | Hz | Hop frequency value. |
| qualifieropt | enum | MINimum | MAXimum | Selects the minimum or maximum 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.
| Name | Type | Values | Description |
|---|---|---|---|
| rate | real | Hz | The modulation rate. |
| qualifieropt | enum | MINimum | MAXimum | Selects the minimum or maximum allowed rate. |
SOURce1:FSKey:INTernal:RATE 50Hz
Sets or queries the source of modulation signal of FSK modulation for the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | INTernal | EXTernal | Selects the modulation source: internal or external. |
Enables or disables FSK modulation for the selected source. The query returns the current FSK modulation state.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | <NR1> | Enables or disables FSK modulation; ON or a nonzero numeric value enables it, OFF or zero disables it. |
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.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | File name in the mass storage system, including path; path separators are forward slashes (/). |
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 | Symmetry of the ramp waveform. |
| qualifieropt | enum | MINimum | MAXimum | Uses the minimum or maximum symmetry value. |
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.
| Name | Type | Values | Description |
|---|---|---|---|
| shape | enum | SINusoid | SQUare | PULSe | RAMP | PRNoise | DC | SINC | GAUSsian | LORentz | ERISe | EDECay | HAVersine | USER[1] | USER2 | USER3 | USER4 | EMEMory[1] | EMEMory2 | EFILe | Output 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.
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.
| Name | Type | Values | Description |
|---|---|---|---|
| phase | real | rad | Phase value for the output waveform. |
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.
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.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | real | 2 mHz - 50.00 kHz | Internal 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.
| Name | Type | Values | Description |
|---|---|---|---|
| deviation | real | 0 PI - +1 PI | Phase deviation value in radians when no units are specified. |
| unitsopt | enum | RAD | DEG | Units for the deviation 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.
| Name | Type | Values | Description |
|---|---|---|---|
| deviation | real | 0 PI - +1 PI | Peak phase deviation value; if units are omitted, RAD is assumed automatically. |
| qualifieropt | enum | MINimum | MAXimum | Keyword alternative to a numeric 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.
| Name | Type | Values | Description |
|---|---|---|---|
| function | enum | SINusoid | SQUare | TRIangle | RAMP | NRAMp | PRNoise | USER[1] | USER2 | USER3 | USER4 | EMEMory[1] | EMEMory2 | EFILe | Selects 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.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | File name in the mass storage system, including path with forward slashes (/). |
SOURce1:PM:INTernal:FUNCtion:EFILe “SAMPLE1”
Sets or queries the source of the modulation signal for PM modulation on the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | INTernal | EXTernal | Selects the PM modulation source. |
Enables or disables PM modulation. The query returns the state of PM modulation.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | <NR1> | Turns PM modulation on or off; ON or <NR1>≠0 enables it, OFF or <NR1>=0 disables it. |
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.
| Name | Type | Values | Description |
|---|---|---|---|
| percent | real | 0.001 - 99.999 | Duty cycle value. |
| qualifieropt | enum | MINimum | MAXimum | Selects 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.
| Name | Type | Values | Description |
|---|---|---|---|
| percent | real | 0.001 - 99.999 | Duty cycle value. |
| qualifieropt | enum | MINimum | MAXimum | Selects the minimum or maximum duty cycle value. |
Sets the lead delay of the pulse waveform for the specified channel. It can also be queried to return the lead delay.
| Name | Type | Values | Description |
|---|---|---|---|
| delay | real | 0 ns - Pulse Period (Continuous mode) | Lead delay value to set. |
| qualifieropt | enum | MINimum | MAXimum | Use MINimum or MAXimum instead of a numeric 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.
| Name | Type | Values | Description |
|---|---|---|---|
| period | real | ns|μs|ms|s | Pulse period value to set. |
| qualifieropt | enum | MINimum | MAXimum | Selects the minimum or maximum allowable period. |
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
Sets or queries the leading edge time of the pulse waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| seconds | real | s | Leading edge time of the pulse waveform. |
| qualifieropt | enum | MINimum | MAXimum | Keyword alternative to the numeric leading edge time. |
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.
| Name | Type | Values | Description |
|---|---|---|---|
| seconds | real | 0.001% - 99.999% | Pulse width value. |
| qualifieropt | enum | MINimum | MAXimum | Literal 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.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | real | 2 mHz - 50.00 kHz | Modulation frequency to set. |
| qualifieropt | enum | MINimum | MAXimum | Use MINimum or MAXimum in place of a numeric 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.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | 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.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | 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.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | <NR1> | Sets the PWM modulation state; ON or nonzero enables modulation, OFF or zero disables it. |
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.
| Name | Type | Values | Description |
|---|---|---|---|
| percent | real | PCT | PWM deviation value in percent. |
| qualifieropt | enum | MINimum | MAXimum | Selects the minimum or maximum allowable deviation. |
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.
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.
| Name | Type | Values | Description |
|---|---|---|---|
| seconds | real | s | Hold time in seconds. |
| qualifieropt | enum | MINimum | MAXimum | Allows setting the hold time to the minimum or maximum value. |
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.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | AUTO | MANual | Sweep mode setting. |
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.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | LINear | LOGarithmic | Sets the sweep spacing type. |
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.
| Name | Type | Values | Description |
|---|---|---|---|
| seconds | real | s | Return time for the sweep. |
| qualifieropt | enum | MINimum | MAXimum | Use MINimum or MAXimum instead of a numeric return time. |
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).
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | <NR1> | Turns voltage concurrency on or off, or accepts the numeric code <NR1> as documented. |
Enables or disables copying the voltage level from one channel to another. For a single-channel model, this command is not supported.
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.
| Name | Type | Values | Description |
|---|---|---|---|
| voltage | real | V | High level of output amplitude. |
| qualifieropt | enum | MINimum | MAXimum | Keyword alternative to the numeric voltage value. |
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.
| Name | Type | Values | Description |
|---|---|---|---|
| voltage | real | mV|V | Low level of output amplitude. |
| qualifieropt | enum | MINimum | MAXimum | Selects the minimum or maximum allowed voltage value. |
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.
| Name | Type | Values | Description |
|---|---|---|---|
| voltage | real | V | Offset level for the specified channel. |
| qualifieropt | enum | MINimum | MAXimum | Allows setting the offset to the minimum or maximum value. |
Sets or queries the internal AM modulation frequency for source 1 or 2.
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.
Selects the AM source. The command is available under channel 1 or 2.
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.
Returns the current AM depth setting.
Sets or queries the burst mode. This command is part of the burst subsystem for source 1 or 2.
Queries the number of cycles used by 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.
Selects the feed source for a combine operation.
Sets or queries the internal FM frequency for the selected source. This command is part of the FM subsystem under the source selection hierarchy.
Selects an external function file for internal FM modulation. This command is part of the FM:INTernal:FUNCtion hierarchy for source 1 or 2.
Selects the internal FM modulation function. This command is part of the FM:INTernal subtree.
Selects the source for FM modulation. The command is part of the FM subsystem under the selected source.
Enables or disables FM for the selected source. The command is available for source 1 or 2.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Turns FM on or off. |
Sets or queries the FM deviation. This command is part of the source FM subsystem.
Sets or queries the center frequency of the frequency sweep. This command is part of the frequency subsystem.
Turns concurrent frequency state on or off for the frequency subsystem. This command is listed as defined in SCPI 1999.0.
| Name | Type | Values | Description |
|---|---|---|---|
| stateopt | enum | ON | OFF | Enables or disables concurrent frequency mode. |
Sets or queries the frequency mode. This command is part of the source frequency subsystem.
Sets or queries the concurrent state of the voltage source. This command is part of the source 1/2 voltage concurrent state subtree.
| Name | Type | Values | Description |
|---|---|---|---|
| stateopt | enum | ON | OFF | Enables or disables concurrent operation. |
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.
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.
Returns the current source state for one of the two sources. The source is selected with the optional source node [1|2].
Returns the source frequency key setting for the selected source. The command is available for source 1 or 2.
Sets the function shape for source 1 or 2. The shape is selected as part of the source/function subsystem.
Initiates phase adjustment for the selected source channel(s).
Sets or queries the internal modulation frequency for PM. The command is defined under the PM :INTernal branch.
Returns the internal function selection for the PM source. This query is part of the PM:INTernal subsystem for source 1 or 2.
Selects the source for phase modulation. The command is documented for PM as a query on channels 1 and 2.
Returns the source used by the pulse-width modulation subsystem for the selected channel.
Sets or queries the phase modulation deviation for the selected source. This command is available as a query form in the SCPI conformance table.
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.
Sets or queries the pulse delay value for the selected source channel. The command is defined for source 1 or 2.
Sets or queries the pulse hold state. This command is part of the PULSE subsystem.
Sets or queries the pulse period. The command is part of the PULSE command group.
Returns the trailing transition time for pulse transition 1 or 2.
Returns the leading edge transition setting for pulse output. This is the query form of the PULSE:TRANSITION[:LEADING] command.
Sets or queries the pulse width for the selected source. The command is listed as part of the PULSE subsystem conformance table.
Sets or queries the external file used by the PWM internal function. This command is listed as a query in the SCPI conformance table.
Returns the internal PWM function setting.
Selects the source for PWM generation.
Returns the PWM source state. The command is listed as part of the PWM subsystem in the SCPI conformance table.
Sets or queries the sweep hold time for the source. The command is defined for source 1 or 2.
Sets or queries the sweep mode used for the frequency sweep function.
Sets or queries the sweep spacing mode for the selected source. This command is defined for sources 1 and 2.
Sets or queries the sweep time. This command is part of the sweep configuration subsystem.
Sets or queries the high voltage limit. This command belongs to the voltage limit subsystem.
Sets or queries the lower voltage limit. It is part of the voltage limit subsystem under the selected source.
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.
Sets the high level of the source voltage. This command is part of the voltage level subtree under the selected source.
Sets the low level of the output voltage. The command is listed under the voltage level immediate subsystem for source 1 or 2.
Sets the output voltage offset for the selected source and immediate level path. The command is listed under the VOLTage [LEVel] [IMMediate] branch in the SCPI conformance table.
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.
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.
| Name | Type | Values | Description |
|---|---|---|---|
| amplitude | real | 0 - 50 | Internal noise level as a percentage of the current amplitude level. |
This command 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 reference oscillator source for the instrument. This command is documented as part of the source subsystem and is listed with an optional [SOURce] node.
Sets or queries the output amplitude for the specified channel. The amplitude value uses an NRf number with units of VPP, VRMS, or DBM.
| Name | Type | Values | Description |
|---|---|---|---|
| amplitude | real | - | Output amplitude. |
| qualifieropt | enum | MINimum | MAXimum | Qualifier used to request the minimum or maximum 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.
| Name | Type | Values | Description |
|---|---|---|---|
| voltage | real | V | Higher limit of output amplitude. |
| qualifieropt | enum | MINimum | MAXimum | Selects the minimum or maximum limit value. |
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.
| Name | Type | Values | Description |
|---|---|---|---|
| voltage | real | mV|V | Lower limit of output amplitude. |
| qualifieropt | enum | MINimum | MAXimum | Optional keyword alternative to a voltage value. |
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.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | VPP | VRMS | DBM | Selects the output voltage units. |
SOURce1:VOLTage:UNIT VPP
Returns the contents of the Operation Condition Register.
STATUS:OPERATION:CONDITION?
Sets or queries the mask for the Operation Enable Register.
| Name | Type | Values | Description |
|---|---|---|---|
| bit_value | integer | - | Mask value for the Operation Enable Register. |
STATUS:OPERATION:ENABLE 1
Sets or queries the mask for the Operation Enable Register.
STATUS:OPERATION:ENABLE 1
Returns the value in the Operation Event Register and clears the Operation Event Register.
STATUS:OPERATION[:EVENT]?
Presets the SCPI status registers (OENR and QENR).
STATUS:PRESET
Returns the contents of the Questionable Condition Register.
Sets or queries the mask for the Questionable Enable Register.
| Name | Type | Values | Description |
|---|---|---|---|
| bit_value | integer | - |
STATUS:QUESTIONABLE:ENABLE 32
Sets or queries the mask for the Questionable Enable Register.
| Name | Type | Values | Description |
|---|---|---|---|
| bit_value | integer | - | Bit mask value for the Questionable Enable Register. |
STATUS:QUESTIONABLE:ENABLE 32
Returns the value in the Questionable Event Register and clears the Questionable Event Register.
Causes the instrument to beep immediately.
SYSTEM:BEEPER[:IMMEDIATE]
Sets the beeper on or off. The corresponding query returns 0 for OFF or 1 for ON.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Turns the beeper on or off. |
| value | integer | - | 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.
SYSTEM:BEEPER:STATE ON
Returns the contents of the Error/Event 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).
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Enables or disables the click sound. |
| value | integer | - | 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).
SYSTEM:KCLICK[:STATE] ON
Locks or unlocks the instrument front panel controls. The query returns 0 (OFF) or 1 (ON).
| Name | Type | Values | Description |
|---|---|---|---|
| stateopt | enum | ON | OFF | Enables or disables the front panel controls. |
SYSTEM:KLOCK[:STATE] ON
Locks or unlocks the instrument front panel controls. The query returns 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.
| Name | Type | Values | Description |
|---|---|---|---|
| password | string | - | 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.
Changes the password.
| Name | Type | Values | Description |
|---|---|---|---|
| current_password | string | - | Current password. |
| new_password | string | - | 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.
| 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
Sets or queries the language used to display instrument information on the screen.
SYSTEM:ULANGUAGE FRENch
Returns the conformed SCPI version of the instrument.
Returns the names of user waveform memory and edit memory. The response is a comma-separated series of quoted strings.
TRACE|DATA:CATALOG?
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.
| Name | Type | Values | Description |
|---|---|---|---|
| trace_name | string | - | Source trace name to copy. |
| memory | enum | EMEMory[1] | EMEMory2 | USER[1] | USER2 | USER3 | USER4 | Destination 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.
| Name | Type | Values | Description |
|---|---|---|---|
| memory | enum | EMEMory | EMEMory1 | EMEMory2 | Selects the edit memory destination for the waveform data. |
| binary_block_data | block | - | Waveform data in binary format to be transferred. |
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.
| Name | Type | Values | Description |
|---|---|---|---|
| memory | enum | EMEMory | EMEMory1 | EMEMory2 | Edit memory target. |
| start_point | integer | - | First point from which the data is interpolated linearly. |
| point_data1 | integer | - | Data value at the start point. |
| end_point | integer | - | Last point from which the data is interpolated linearly. |
| point_data2 | integer | - | 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.
| Name | Type | Values | Description |
|---|---|---|---|
| memory | enum | EMEMory | EMEMory1 | EMEMory2 | Selects 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.
| Name | Type | Values | Description |
|---|---|---|---|
| memory | enum | EMEMory | EMEMory1 | EMEMory2 | Edit memory selection. |
| point | integer | - | Point number in the edit memory. |
| data | integer | - | Data value for the specified point number. |
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.
| Name | Type | Values | Description |
|---|---|---|---|
| memory | enum | EMEMory | EMEMory1 | EMEMory2 | Selects the edit memory to access. |
| points | integer | - | Specifies the 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.
| Name | Type | Values | Description |
|---|---|---|---|
| trace_name | enum | USER[1] | USER2 | USER3 | USER4 | Specifies 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.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | EMEMory[1] | EMEMory2 | Selects the edit memory to copy from. |
| destination | enum | EMEMory[1] | EMEMory2 | Selects the edit memory to copy to. |
TRACe|DATA:EMEMCOPY EMEMory1,EMEMory2
Sets or queries whether the specified user waveform memory is locked or unlocked.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Locks or unlocks the specified user waveform memory. |
DATA:LOCK:STATe USER1,ON
Sets or queries whether the specified user waveform memory is locked or unlocked.
| Name | Type | Values | Description |
|---|---|---|---|
| user | enum | USER[1] | USER2 | USER3 | USER4 | Specifies the user waveform memory to lock or unlock. |
| state | enum | ON | OFF | <NR1> | Locks or unlocks the selected user waveform memory. |
DATA:LOCK:STATe USER1,ON
Sets or queries the number of data points for the waveform created in the edit memory.
| Name | Type | Values | Description |
|---|---|---|---|
| memory | enum | EMEMory | EMEMory1 | EMEMory2 | Edit memory selection for the command. |
| pointsopt | integer | 2 - 131072 | Number of points for the waveform created in the edit memory. |
| qualifieropt | enum | MINimum | MAXimum | Requests the minimum or maximum allowed number of points in the query form. |
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.
| Name | Type | Values | Description |
|---|---|---|---|
| NAMEopt | string | - | Name of the trace data object to delete. |
Locks or unlocks the trace/data memory. The optional [STATe] parameter selects the lock state.
| Name | Type | Values | Description |
|---|---|---|---|
| stateopt | enum | ON | OFF | Selects whether trace/data memory is locked or unlocked. |
Sets or queries the slope of the trigger signal.
| Name | Type | Values | Description |
|---|---|---|---|
| slope | enum | POSitive | NEGative | Selects whether the trigger event occurs on the rising or falling edge of the external trigger signal. |
TRIGGER[:SEQUENCE]:SLOPE POSitive
Sets or queries the slope of the trigger signal.
TRIGGER[:SEQUENCE]:SLOPE POSitive
Sets or queries the trigger source for an external trigger signal.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | TIMer | EXTernal | Selects the trigger source. |
TRIGger[:SEQuence]:SOURce TIMer TRIGger[:SEQuence]:SOURce?
Sets or queries the trigger source for an external trigger signal.
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.
| Name | Type | Values | Description |
|---|---|---|---|
| seconds | real | 1 μs - 500.0 s | Period of the internal clock. |
TRIGGER[:SEQUENCE]:TIMER 5ms
Forces a trigger event to occur. The command has no query form.
TRIGger:SEQuence:IMMediate
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.
| Name | Type | Values | Description |
|---|---|---|---|
| immediateopt | enum | IMMediate | Execute the hardcopy dump immediately. |
Sets or queries the power level amplitude for source 3 or 4. The command supports the optional LEVel, IMMediate, and AMPLitude nodes in the path.