*CLSset / query
Clears the status and event registers. This is a common SCPI common command and does not take any parameters.
SCPI COMMAND REFERENCE
The Tektronix AFG1022 is Tektronix's function generator in the AFG1000 Series family. Its SCPI remote-control interface exposes 138 commands across 7 subsystems - 72 settable and 66 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.
138
Commands
72
Settable
66
Queries
7
Subsystems
SCPI
Verified
2026-07-16
All commands
138 of 138 commands
*IDN?query
Returns the instrument identification string.
string - The identification string.
*OPT?query
Returns a list of the options installed in the instrument.
string - A list of the installed options.
*RCLset / query
Restores the instrument state from a copy of the settings stored in setup memory. The settings are stored using *SAV; if the specified setup memory is deleted, the command causes an error.
| Name | Type | Values | Description |
|---|---|---|---|
| memory location | integer | 0 - 31 | Specifies the location of setup memory to restore. |
*RCL 3
*RSTset / query
Resets the instrument to the factory default settings.
*RST
*SAVset / query
Stores the current settings of the arbitrary function generator to a specified setup memory location.
| Name | Type | Values | Description |
|---|---|---|---|
| location | integer | 0 - 31 | Specifies the setup memory location to save into. |
*SAV 2
*TRGset / query
This command generates a trigger event.
*TRG
*WAIset / query
Prevents the instrument from executing further commands or queries until all pending commands that generate an OPC message are complete.
*WAI
:AFGControl:CSCopyset / query
:MMEMory:CATalog?query
:MMEMory:CDIRectoryset / query
Changes the current directory in the mass storage system.
| Name | Type | Values | Description |
|---|---|---|---|
| directory_name | string | - | Directory name to change to. |
MMEMory:CDIRectory "/AFG/WORK0"
:MMEMory:DELeteset / query
Deletes a file or directory from the mass storage system. If the specified file is not allowed to 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 and should include the full path. |
MMEMory:DELete "/AFG/WORK0/TEK001.tfw"
:OUTPut[1|2]:IMPedanceset / query
Sets the output load impedance for the specified channel. The query returns the current load impedance in ohms, or 9.9E+37 if the load impedance is set to INFinity.
| Name | Type | Values | Description |
|---|---|---|---|
| ohms | real | 1 - 10 kΩ | Output load impedance value. |
| qualifieropt | enum | MINimum | MAXimum | Keyword alternative to the numeric impedance value. |
real (ohm) - Current load impedance setting in ohms; returns 9.9E+37 when the impedance is set to INFinity.
OUTPut1:IMPedance MAXimum
Returns the current load impedance setting in ohms for the specified output channel. If the load impedance is set to INFinity, the query returns 9.9E+37.
| Name | Type | Values | Description |
|---|---|---|---|
| qualifier | enum | MINimum | MAXimum | Selects the minimum or maximum impedance value. |
real (ohms) - The current load impedance setting in ohms.
OUTPut1:IMPedance MAXimum
:OUTPut[1|2][:STATe]set / query
Sets or queries the instrument output state for the specified channel.
Returns the present output state of the selected output channel. ON or a nonzero numeric value indicates the output is enabled; OFF or 0 indicates it is disabled.
integer - Present output state of the selected instrument output channel.
OUTPut1:STATe ON
[SOURce[1|2]]:AM:INTernal:FREQuencyset / query
Sets or queries the internal modulation frequency of AM modulation for the specified channel. Use this command when the internal modulation source is selected; the allowed range is 2 mHz to 20.00 kHz with 1 mHz resolution.
[SOURce[1|2]]:AM[:DEPTh]set / query
Sets or queries the modulation depth of AM modulation for the specified channel. The depth can be set from 0% to 100% with 1% resolution.
| Name | Type | Values | Description |
|---|---|---|---|
| depthopt | real | 0 - 100 | Modulation depth value. |
| qualifieropt | enum | MINimum | MAXimum | Sets the modulation depth to the minimum or maximum value. |
real (PCT) - Returns the modulation depth.
SOURce1:AM:DEPth MAXimum
Sets or queries the AM modulation depth for the specified channel. The depth can be set from 0% to 100% with 1% resolution.
| Name | Type | Values | Description |
|---|---|---|---|
| depth | real | 0 - 100 | Modulation depth value. |
| qualifieropt | enum | MINimum | MAXimum | Returns the minimum or maximum modulation depth value. |
real (PCT) - The modulation depth.
SOURce1:AM:DEPth MAXimum
Sets or queries the internal AM modulation frequency for the specified source channel. The query returns the current frequency, and can also return the minimum or maximum value when qualified.
| Name | Type | Values | Description |
|---|---|---|---|
| qualifieropt | enum | MINimum | MAXimum | Optional query qualifier to return the minimum or maximum frequency. |
real (Hz) - The internal AM modulation frequency. With the MINimum or MAXimum qualifier, returns the minimum or maximum supported frequency.
SOURce1:AM:INTernal:FREQuency 10kHz
[SOURce[1|2]]:AM:INTernal:FUNCtionset / query
Sets or queries the modulating waveform of AM modulation for the specified channel when the internal modulation source is selected. Specifying EFILe when no EFILe exists or is not yet defined causes an error.
| Name | Type | Values | Description |
|---|---|---|---|
| waveform | enum | SINusoid | SQUare | RAMP | PRNoise | USER<NR1> | EMEMory | EFILe | Modulating waveform for AM internal modulation. |
Sets or queries the modulating waveform of AM modulation for the specified channel. Use this command when the internal modulation source is selected; if EFILe is selected when no EFILe exists or is not yet defined, the command causes an error.
enum - Returns the selected internal AM modulation waveform.
[SOURce[1|2]]:AM:INTernal:FUNCtion:EFILeset / query
Sets or queries the EFILe name used as a modulating waveform for AM modulation. The file name must specify a file in the mass storage system; if no file exists in mass storage, the command returns a blank string.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | File name in the mass storage system, including path; path separators are forward slashes (/). |
string - The EFILe name used as the modulating waveform, or a blank string if there is no file in mass storage.
SOURce1:AM:INTernal:FUNCtion:EFILe “SAMPLE1”
Sets or queries the EFILe name used as a modulating waveform for AM modulation. The file name must be specified 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. |
string - The EFILe name used as a modulating waveform.
SOURce1:AM:INTernal:FUNCtion:EFILe “SAMPLE1”
[SOURce[1|2]]:AM:SOURceset / query
Sets or queries the source of the AM modulating signal for the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | INTernal | EXTernal | Selects whether the carrier waveform is modulated with an internal or external source. |
enum - Returns the current AM source as internal or external.
SOURce1:AM:SOURce INTernal
Sets or queries the source of the AM modulating signal for the specified channel. For the AFG1022, use [SOURce1].
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | INTernal | EXTernal | Selects whether the carrier waveform is modulated with an internal or external source. |
enum - Returns the current AM source as INT or EXT.
SOURce1:AM:SOURce INTernal
[SOURce[1|2]]:AM:STATeset / query
Enables or disables AM modulation for the specified channel. The query returns the state of AM modulation.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | <NR1> | AM modulation state. |
enum - Returns the state of AM modulation.
Enables or disables AM modulation for the specified channel. The query returns the AM modulation state.
enum - Returns the AM modulation state.
[SOURce[1|2]]:ASKey[:AMPLitude]set / query
Sets or queries the modulation amplitude of ASK modulation for the specified channel. The amplitude can be set from 0 Vpp to the current carrier amplitude; MINimum sets it to the minimum value.
| Name | Type | Values | Description |
|---|---|---|---|
| amplitude | real | 0 - current amplitude of the carrier waveform | Modulation amplitude for ASK modulation. |
| qualifieropt | enum | MINimum | MAXimum | Selects the minimum or maximum allowed modulation amplitude. |
real (Vpp) - Returns the current modulation amplitude. If queried with MINimum or MAXimum, returns the minimum or maximum modulation amplitude.
Sets or queries the modulation amplitude of ASK modulation for the specified channel. The amplitude can be set from 0 Vpp to the current carrier amplitude.
| Name | Type | Values | Description |
|---|---|---|---|
| amplitude | real | 0 - current amplitude of the carrier waveform | Modulation amplitude. |
| qualifieropt | enum | MINimum | MAXimum | Sets or queries the minimum or maximum modulation amplitude. |
real (Vpp) - Returns the modulation amplitude.
[SOURce[1|2]]:ASKey:INTernal:RATEset / query
Sets or queries the internal modulation rate of ASK modulation for the specified channel when the internal modulation source is selected.
| Name | Type | Values | Description |
|---|---|---|---|
| rate | real | Hz | Internal modulation rate. |
| qualifieropt | enum | MINimum | MAXimum | Returns the minimum or maximum internal modulation rate. |
real (Hz) - Returns the internal modulation rate.
SOURce1:ASKey:INTernal:RATE 50Hz
Queries the internal modulation rate of ASK modulation for the specified channel. Use this command when the internal modulation source is selected.
| Name | Type | Values | Description |
|---|---|---|---|
| qualifier | enum | MINimum | MAXimum | Selects the minimum or maximum internal modulation rate to query. |
real (Hz) - Returns the internal modulation rate.
[SOURce[1|2]]:ASKey:SOURceset / query
Sets or queries the source of the ASK modulation signal for the specified channel. The query returns whether the source is internal or external.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | INTernal | EXTernal | Selects the source of the modulation signal. |
enum - Returns the ASK modulation source as internal or external.
SOURce1:ASKey:SOURce INTernal
Sets or queries the source of the ASK modulation signal for the specified channel. For the query, returns INT or EXT.
| Name | Type | Values | Description |
|---|---|---|---|
| modeopt | enum | INTernal | EXTernal | Selects whether the carrier waveform is modulated with an internal or external source. |
enum - Returns the ASK modulation source as INT or EXT.
SOURce1:ASKey:SOURce INTernal
[SOURce[1|2]]:ASKey:STATeset / query
Enables or disables ASK modulation for the specified channel. The query returns the current ASK modulation state.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | <NR1> | Enables ASK modulation when ON or any nonzero numeric value is sent; OFF disables it. |
enum - Returns the state of ASK modulation.
Enables or disables ASK modulation. The query returns the state of ASK modulation.
enum - Returns the ASK modulation state.
[SOURce[1|2]]:BURSt:MODEset / query
Sets or queries the burst mode for the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | TRIGgered | GATed | Selects triggered or gated burst mode. |
enum - Returns the current burst mode.
SOURce1:BURSt:MODE TRIGgered
Sets or queries the burst mode for the specified channel. For the AFG1022, use Source1; modulation, sweep, and burst conditions do not apply to CH2.
enum - Returns the current burst mode.
SOURce1:BURSt:MODE TRIGgered
[SOURce[1|2]]:BURSt:NCYClesset / query
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.
real - Returns the burst count; returns 9.9E+37 if the burst count is set to INFinity.
Queries the burst cycle count for the specified source channel. The query returns the current burst count, or the minimum or maximum burst count when qualified with MINimum or MAXimum.
| Name | Type | Values | Description |
|---|---|---|---|
| qualifieropt | enum | MINimum | MAXimum | Selects which burst count value to return. |
integer - Burst count for the selected source channel, or the selected minimum/maximum value when queried with a qualifier.
SOURce1:BURSt:NCYCles 2
[SOURce[1|2]]:BURSt:SOURceset / query
Sets or queries the trigger source in burst mode for the specified channel. This command is available only in Triggered burst mode.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | TIMer | MANual | EXTernal | Specifies the burst trigger source. |
SOURce1:BURSt:NCYCles 2
Sets or queries the trigger source in burst mode for the specified channel. This command is available only in the Triggered burst mode.
enum - Returns the current burst trigger source.
[SOURce[1|2]]:BURSt:STATeset / query
Enables or disables burst mode for the specified channel. The query returns the state of burst mode.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Enables or disables burst mode. |
| value | integer | - | Numeric form where nonzero enables burst mode and zero disables it. |
integer - State of burst mode.
SOURce1:BURSt:STATe ON
Enables or disables burst mode for the specified channel. The query returns the burst mode state.
integer - Returns the burst mode state as an NR1 value.
[SOURce[1|2]]:FM[:DEViation]set / query
Sets or queries the peak frequency deviation of FM modulation for the specified channel. The setting range depends on the selected carrier waveform.
Sets or queries the peak frequency deviation of FM modulation for the specified channel. The allowed deviation range depends on the waveform selected as the carrier.
[SOURce[1|2]]:FM:INTernal:FREQuencyset / query
Sets or queries the internal modulation frequency of FM modulation for the specified channel. Use this command when the internal modulation source is selected.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | real | 2 mHz - 20.00 kHz | Internal modulation frequency. |
| qualifieropt | enum | MINimum | MAXimum | Requests the minimum or maximum frequency value. |
real (Hz) - Returns the internal modulation frequency.
Sets or queries the internal modulation frequency of FM modulation for the specified channel when the internal modulation source is selected. The frequency can be set from 2 mHz to 20.00 kHz with 1 mHz resolution.
real (Hz) - Returns the internal FM modulation frequency. With the optional qualifier, returns the minimum or maximum allowed frequency.
[SOURce[1|2]]:FM:INTernal:FUNCtionset / query
Sets or queries the modulating waveform of FM modulation for the specified channel. Use this command when the internal modulation source is selected.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | SINusoid | SQUare | RAMP | PRNoise | USER<NR1> | EMEMory | EFILe | Modulating waveform for FM internal modulation. |
enum - Returns the modulating waveform of FM modulation for the specified channel.
SOURce1:FM:INTernal:FREQuency 10kHz
Sets or queries the modulating waveform of FM modulation for the specified channel when the internal modulation source is selected. If EFILe is specified when no EFILe exists or it is not yet defined, the command causes an error.
enum - Returns the current modulating waveform selection.
SOURce1:FM:INTernal:FREQuency 10kHz
[SOURce[1|2]]:FM:INTernal:FUNCtion:EFILeset / query
Sets or queries an EFILe name used as a modulating waveform for FM modulation. The file name must exist in the mass storage system; if no file exists in mass storage, the command returns a blank string.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | File name in the mass storage system, including path; path separators are forward slashes (/). |
string - Returns the EFILe name used as the modulating waveform, or a blank string if there is no file in mass storage.
SOURce1:FM:INTernal:FUNCtion:EFILe “SAMPLE1”
Sets or queries the 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 | - | File name in the mass storage system, including path with forward slashes. |
string - Returns the current EFILe name used as the modulating waveform, or a blank string if there is no file in mass storage.
SOURce1:FM:INTernal:FUNCtion:EFILe “SAMPLE1”
[SOURce[1|2]]:FM:SOURceset / query
Sets the FM source for the selected channel to internal or external. The query returns the current FM source state as INT or EXT.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | INTernal | EXTernal | Selects whether the carrier waveform is modulated with the internal or external source. |
enum - Returns the current FM source selection.
SOURce1:FM:SOURce INTernal
Returns the FM source selection for the specified source channel. INTernal means the carrier waveform is modulated with the internal source, and EXTernal means it is modulated with an external source.
enum - Returns the FM source as INT or EXT.
SOURce1:FM:SOURce INTernal
[SOURce[1|2]]:FM:STATeset / query
Enables or disables FM modulation. The query returns the state of FM modulation.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | ON or <NR1>≠0 enables FM modulation; OFF or <NR1>=0 disables FM modulation. |
integer - Returns the FM modulation state as <NR1>.
SOURce1:FM:STATe ON
Enables or disables FM modulation. The query returns the state of FM modulation.
integer - Returns the state of FM modulation as <NR1>.
SOURce1:FM:STATe ON
[SOURce[1|2]]:FREQuency:CENTerset / query
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 allowable range depends on the selected waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | real | Hz | Center frequency value. |
| qualifieropt | enum | MINimum | MAXimum | Selects the minimum or maximum allowed center frequency. |
real (Hz) - Returns the center frequency.
SOURce1:FREQuency:CENTer 550kHz
Sets or queries the center frequency of sweep for the specified channel. It is always used with [SOURce[1|2]]:FREQuency:SPAN.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | real | Hz | Center frequency value. |
| qualifieropt | enum | MINimum | MAXimum | Qualifier to set or query the minimum or maximum center frequency. |
real (Hz) - Returns the center frequency.
SOURce1:FREQuency:CENTer 550kHz
[SOURce[1|2]]:FREQuency:CONCurrentset / query
Enables or disables copying the frequency (or period) of one channel to another channel. The channel specified by the header suffix is copied to the other channel.
Enables or disables the concurrent copy function for the selected source channel. When enabled, FreqLock is also enabled automatically and the two channels are adjusted synchronously with the general knob.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | <NR1> | ON or a nonzero numeric value enables concurrent copy; OFF or 0 disables it. |
enum - Returns the concurrent copy state as 0 for off or 1 for on.
SOURce1:FREQuency:CONCurrent ON
[SOURce[1|2]]:FREQuency[:CW|:FIXed]set / query
Sets or queries the output waveform frequency for the specified channel. The command is available when Run Mode is set to other than Sweep; frequency range depends on waveform type, and resolution is 1 μHz or 12 digits.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | real | - | Output frequency value. |
| qualifieropt | enum | MINimum | MAXimum | Selects the minimum or maximum allowed frequency. |
Sets or queries the output waveform frequency for the specified channel. The command is available when Run Mode is other than Sweep; the resolution is 1 μHz or 12 digits.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | real | - | Output frequency value. |
| qualifieropt | enum | MINimum | MAXimum | Uses the minimum or maximum allowed frequency. |
real - Returns the output waveform frequency for the specified channel; with a query qualifier of MINimum or MAXimum, returns the corresponding limit.
[SOURce[1|2]]:FREQuency:MODEset / query
Sets or queries the frequency sweep state. Select sine, square, or ramp waveform for sweep.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | CW | FIXed | SWEep | Selects whether the output frequency is controlled by the fixed-frequency command or by the sweep command set. |
enum - Returns the present frequency sweep state.
Sets or queries the frequency sweep state. Select sine, square or ramp waveform for sweep.
enum - Returns the current frequency sweep state.
[SOURce[1|2]]:FREQuency:SPANset / query
Sets or queries the span of frequency sweep for the specified channel. It is used with [SOURce[1|2]]:FREQuency:CENTer, and the allowed span depends on the selected waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| frequencyopt | real | Hz | Frequency span value. |
| qualifieropt | enum | MINimum | MAXimum | Selects the minimum or maximum frequency span. |
real (Hz) - Returns the frequency span.
SOURce1:FREQuency:SPAN 900 kHz
Sets or queries the frequency sweep span for the specified channel. It is always used with the corresponding frequency center command, and the allowed range depends on the selected waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | real | Hz | Frequency span value. |
real (Hz) - Returns the frequency span.
SOURce1:FREQuency:SPAN 900 kHz
[SOURce[1|2]]:FREQuency:STARtset / query
Sets or queries the start frequency of sweep for the specified channel. It is always used with [SOURce[1|2]]:FREQuency:STOP, and the valid range depends on the selected sweep waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | real | Hz | Start frequency value. |
real (Hz) - The start frequency.
SOURce1:FREQuency:STARt 10kHz
Sets or queries the start frequency of sweep for the specified channel. It is always used with [SOURce[1|2]]:FREQuency:STOP and the allowed range depends on the selected sweep waveform.
real (Hz) - The sweep start frequency.
SOURce1:FREQuency:STARt 10kHz
[SOURce[1|2]]:FREQuency:STOPset / query
Sets or queries the stop frequency of sweep for the specified channel. This command is always used with the corresponding start frequency command; the allowable stop frequency depends on the waveform selected for sweep.
Returns the stop frequency of the specified source channel. On the AFG1022, use [SOURce1].
real (Hz) - The stop frequency.
SOURce1:FREQuency:STOP 100KHz
[SOURce[1|2]]:FSKey[:FREQuency]set / query
Sets or queries the hop frequency of FSK modulation for the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | real | Hz | Hop frequency for FSK modulation. |
| qualifieropt | enum | MINimum | MAXimum | Selects the minimum or maximum hop frequency. |
Sets or queries the hop frequency of FSK modulation for the specified channel.
real (Hz) - The hop frequency of FSK modulation.
[SOURce[1|2]]:FSKey:INTernal:RATEset / query
Sets or queries the internal modulation rate of FSK modulation for the specified channel. Use this command when the internal modulation source is selected.
| Name | Type | Values | Description |
|---|---|---|---|
| rate | real | Hz | Modulation rate. |
| qualifieropt | enum | MINimum | MAXimum | Selects the minimum or maximum rate. |
real (Hz) - The current modulation rate.
SOURce1:FSKey:INTernal:RATE 50Hz
Sets or queries the internal modulation rate of FSK modulation for the specified channel. Use this command when the internal modulation source is selected.
| Name | Type | Values | Description |
|---|---|---|---|
| rate | real | Hz | Modulation rate value with optional units Hz, kHz, or MHz. |
| qualifieropt | enum | MINimum | MAXimum | Selects the minimum or maximum modulation rate. |
real (Hz) - Returns the internal modulation rate.
SOURce1:FSKey:INTernal:RATE 50Hz
[SOURce[1|2]]:FSKey:SOURceset / query
Sets or queries the source of the modulation signal used for FSK modulation on the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | INTernal | EXTernal | Selects whether the carrier waveform is modulated with an internal or external source. |
enum - Returns the current FSK modulation source.
SOURce1:FSKey:SOURce INTernal
Sets or queries the source of the modulation signal used for FSK modulation on the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | INTernal | EXTernal | Selects whether the carrier waveform is modulated with an internal or external source. |
enum - Returns the current FSK modulation source.
SOURce1:FSKey:SOURce INTernal
[SOURce[1|2]]:FSKey:STATeset / query
Enables or disables FSK modulation for the specified channel. The query form returns the FSK modulation state.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | <NR1> | Sets the FSK modulation state. |
enum - Returns the state of FSK modulation.
Returns whether FSK modulation is enabled or disabled for the selected source. ON or nonzero enables FSK modulation; OFF or zero disables it.
enum - Returns the current FSK modulation state for the selected source.
SOURce1:FSKey:STATe ON
[SOURce[1|2]]:FUNCtion:EFILeset / query
Sets or queries the EFILe name used as an output waveform. The file name must exist in the mass storage system, and 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; path separators are forward slashes (/). |
string - Returns the current EFILe name as <file_name>; returns a blank string if there is no file in mass storage.
SOURce1:FUNCtion:EFILe “SAMPLE1”
Sets or queries the EFILe name used as an output waveform. The file name must exist 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 | - | File name in the mass storage system, including path with forward slashes (/); case sensitive. |
string - Returns the EFILe file name currently set, or an empty string if no file is in mass storage.
SOURce1:FUNCtion:EFILe “SAMPLE1”
[SOURce[1|2]]:FUNCtion[:SHAPe]set / query
Sets or queries the shape of the output waveform. If the specified user memory is deleted, selecting the user memory causes an error.
Returns the current output waveform function shape for the selected source. The shape can be one of the standard waveforms or a built-in arbitrary shape name.
enum - The present function shape of the selected source.
[SOURce[1|2]]:PHASe[:ADJust]set / query
Sets or queries the phase of the output waveform for the specified channel. The value may be set in radians or degrees; if no units are specified, RAD is assumed. The command is supported only when a waveform other than DC and Noise is selected.
| Name | Type | Values | Description |
|---|---|---|---|
| phase | real | rad | Phase value to set, in radians or degrees. |
| qualifieropt | enum | MINimum | MAXimum | Optional keyword to set the phase to the minimum or maximum allowed value. |
real (rad) - Returns the phase value in RAD.
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, the default is RAD. This command is supported only when a waveform other than DC and Noise is selected.
| Name | Type | Values | Description |
|---|---|---|---|
| phase | real | - | Phase value in radians or degrees. |
| qualifieropt | enum | MINimum | MAXimum | Selects the minimum or maximum phase value. |
real (RAD) - Returns the phase value in RAD.
[SOURce[1|2]]:PHASe:INITiateset / query
Synchronizes the phase of CH 1 and CH 2 output waveforms. The arbitrary/function generator performs the same operation if you specify either SOURce1 or SOURce2.
SOURce1:PHASe:INITiate
[SOURce[1|2]]:PM[:DEViation]set / query
Sets or queries the peak frequency deviation of PM modulation for the specified channel.
[SOURce[1|2]]:PM:INTernal:FREQuencyset / query
Sets or queries the internal modulation frequency of PM modulation for the specified channel. Use this command when the internal modulation source is selected.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | real | 2 mHz - 20.00 kHz | Internal modulation frequency. |
| qualifieropt | enum | MINimum | MAXimum | Returns or sets the minimum or maximum value. |
real (Hz) - The internal modulation frequency.
Sets or queries the internal modulation frequency of PM modulation for the specified channel. Use this command when the internal modulation source is selected.
real (Hz) - Returns the internal modulation frequency.
Queries the phase modulation deviation for the specified source. If a qualifier is supplied, it can return the minimum or maximum deviation.
| Name | Type | Values | Description |
|---|---|---|---|
| qualifieropt | enum | MINimum | MAXimum | Selects the minimum or maximum phase deviation value. |
real (RAD) - Returns the phase deviation value.
SOURce1:PM:DEViation MAXimum
[SOURce[1|2]]:PM:INTernal:FUNCtionset / query
Sets or queries the modulating waveform of PM modulation for the specified channel. Use this command when the internal modulation source is selected; selecting EFILe when no file is defined causes an error.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | SINusoid | SQUare | RAMP | PRNoise | USER<NR1> | EMEMory | EFILe | Modulating waveform to use for PM internal modulation. |
enum - Returns the current modulating waveform of PM modulation for the specified channel.
Sets or queries the modulating waveform of PM modulation for the specified channel. Use this command when the internal modulation source is selected.
enum - Returns the selected internal PM modulating waveform.
[SOURce[1|2]]:PM:INTernal:FUNCtion:EFILeset / query
Sets or queries the EFILe name used as a modulating waveform for PM modulation. The file name must be specified 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 (/). |
string - Returns the file name used as the modulating waveform, or a blank string if there is no file in mass storage.
SOURce1:PM:INTernal:FUNCtion:EFILe “SAMPLE1”
Sets or queries the EFILe name used as a modulating waveform for PM modulation. A file name must be specified in the mass storage system; the command returns an empty string if no file is in mass storage.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | File name in the mass storage system, including path with forward slashes. |
string - The file name currently used as the modulating waveform, or an empty string if there is no file in mass storage.
SOURce1:PM:INTernal:FUNCtion:EFILe “SAMPLE1”
[SOURce[1|2]]:PM:SOURceset / query
Sets or queries the source of the PM modulation signal for the specified channel.
Selects whether phase modulation uses an internal or external source. The query returns INT or EXT.
enum - Returns the current PM source selection.
[SOURce[1|2]]:PM:STATeset / query
Enables or disables PM modulation. The query returns the state of PM modulation.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | <NR1> | ON or <NR1>≠0 enables PM modulation; OFF or <NR1>=0 disables PM modulation. |
integer - Returns the state of PM modulation.
SOURce1:PM:STATe ON
Enables or disables PM modulation. The query returns the state of PM modulation.
integer - Returns the PM modulation state.
SOURce1:PM:STATe ON
[SOURce[1|2]]:PSKey:INTernal:RATEset / query
Sets or queries the internal modulation rate of PSK modulation for the specified channel. Use this command when the internal modulation source is selected.
SOURce1:PSKey:DEViation MAXimum
[SOURce[1|2]]:PSKey[:DEViation]set / query
Sets or queries the peak frequency deviation of PSK modulation for the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| deviation | real | 0 PI - +1 PI | Phase deviation in radians. |
| deviation | real | 0 - +180 | Phase deviation in degrees. |
| qualifieropt | enum | MINimum | MAXimum | Requests the minimum or maximum allowed deviation. |
real - The current deviation value.
SOURce1:PSKey:DEViation MAXimum
Sets or queries the peak frequency deviation of PSK modulation for the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| deviation | real | 0 PI - +1 PI | Phase deviation in radians when units are omitted; RAD is selected automatically. |
| deviation | real | 0 - +180 | Phase deviation in degrees. |
| qualifier | enum | MINimum | MAXimum | Selects the minimum or maximum allowed deviation when used with the setter or query syntax. |
real - Returns the peak frequency deviation.
SOURce1:PSKey:DEViation MAXimum
Sets or queries the internal PSK modulation rate for the specified source channel. The rate is specified as a numeric value with optional units.
| Name | Type | Values | Description |
|---|---|---|---|
| rate | real | Hz | Modulation rate. |
real (Hz) - Returns the internal PSK modulation rate.
SOURce1:PSKey:INTernal:RATE 50Hz
[SOURce[1|2]]:PSKey:SOURceset / query
Sets or queries the source of modulation signal for PSK modulation on the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| modeopt | enum | INTernal | EXTernal | Selects internal or external modulation source. |
enum - Returns the current modulation source.
SOURce1:PSKey:SOURce INTernal SOURce1:PSKey:SOURce?
Sets or queries the source of modulation signal for PSK modulation on the specified channel. Internal uses the carrier waveform as the modulation source; external uses an external source.
enum - Returns the current modulation source.
[SOURce[1|2]]:PSKey:STATeset / query
Sets or queries the source of modulation signal for PSK modulation on the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| stateopt | enum | INTernal | EXTernal | Selects whether the carrier waveform is modulated with an internal or external source. |
enum - Returns the current modulation source setting.
Enables or disables PSK modulation for the specified source channel. The query returns the state of PSK modulation.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Enables or disables PSK modulation. |
integer - Returns the state of PSK modulation as <NR1>.
SOURce1:PSKey:STATe ON
[SOURce[1|2]]:PULSe:DCYCleset / query
Sets or queries the duty cycle of the pulse waveform for the specified channel. For frequencies less than 1 MHz, the duty cycle is adjustable from 0.1% to 99.9% in 0.1% steps; above 1 MHz it is fixed at 50%.
Sets or queries the duty cycle of the pulse waveform for the specified source channel. The value is expressed in percent.
| Name | Type | Values | Description |
|---|---|---|---|
| percent | real | PCT | Duty cycle value. |
real (PCT) - Duty cycle in percent.
SOURce1:PULSe:DCYCle 80.5
[SOURce[1|2]]:PWM:INTernal:FREQuencyset / query
Sets or queries the internal modulation frequency of PWM modulation for the specified channel. Use this command when the internal modulation source is selected.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | real | 2 mHz - 20.00 kHz | Internal modulation frequency. |
| qualifieropt | enum | MINimum | MAXimum | Returns or sets the minimum or maximum frequency keyword. |
Sets or queries the internal modulation frequency of PWM modulation for the specified channel when the internal modulation source is selected. The frequency range is 2 mHz to 20.00 kHz with 1 mHz resolution.
real (Hz) - Returns the internal modulation frequency of PWM modulation for the specified channel.
[SOURce[1|2]]:PWM:INTernal:FUNCtionset / query
Sets or queries the modulating waveform used for PWM internal modulation on the specified channel. Use this command only when the internal modulation source is selected; specifying EFILe when no EFILe is defined causes an error.
| Name | Type | Values | Description |
|---|---|---|---|
| function | enum | SINusoid | SQUare | RAMP | PRNoise | USER<NR1> | EMEMory | EFILe | Selects the PWM internal modulation waveform. |
enum - Returns the currently selected modulating waveform.
Sets or queries the modulating waveform of PWM modulation for the specified channel. Use it when the internal modulation source is selected; specifying EFILe without a defined file causes an error.
| Name | Type | Values | Description |
|---|---|---|---|
| function | enum | SINusoid | SQUare | RAMP | PRNoise | USER<NR1> | EMEMory | EFILe | Modulating waveform to use for PWM modulation. |
enum - Returns the modulating waveform setting.
[SOURce[1|2]]:PWM:INTernal:FUNCtion:EFILeset / query
Sets or queries the EFILe name used as a modulating waveform for PWM 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 | - | File name in the mass storage system, including path with forward slashes (/). |
string - The selected EFILe file name, or a blank string if there is no file in mass storage.
SOURce1:PWM:INTernal:FUNCtion:EFILe “SAMPLE1”
Sets or queries the EFIle name used as a modulating waveform for PWM modulation. The file name must exist in the mass storage system; if there is no file in mass storage, 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 (/). |
string - The EFIle name currently used as the modulating waveform, or a blank string if there is no file in mass storage.
SOURce1:PWM:INTernal:FUNCtion:EFILe “SAMPLE1”
[SOURce[1|2]]:PWM:SOURceset / query
Sets or queries the source of the modulating signal for PWM modulation on the specified channel.
Selects the PWM modulation source for the specified channel. The query returns whether the modulating source is internal or external.
enum - Returns the PWM source as internal or external.
SOURce1:PWM:SOURce INTernal
[SOURce[1|2]]:PWM:STATeset / query
Enables or disables PWM modulation. The query returns the state of PWM modulation; only a pulse waveform should be selected as the carrier waveform for PWM.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | <NR1> | ON or <NR1>≠0 enables PWM modulation; OFF or <NR1>=0 disables PWM modulation. |
Enables or disables PWM modulation. The query returns the state of PWM modulation.
integer - Returns the state of PWM modulation as an NR1 value.
[SOURce[1|2]]:PWM[:DEViation]:DCYCleset / query
Sets or queries the PWM deviation in percent for the specified channel. The setting range must satisfy limits based on pulse width, pulse period, and edge times.
| Name | Type | Values | Description |
|---|---|---|---|
| percent | real | PCT | PWM deviation percentage. |
| qualifieropt | enum | MINimum | MAXimum | Selects the minimum or maximum allowable deviation. |
real (PCT) - The PWM deviation in percent.
SOURce1:PWM[:DEViation]:DCYCle 5.0
Sets or queries the PWM deviation in percent for the specified channel.
real (PCT) - The PWM deviation in percent.
SOURce1:PWM[:DEViation]:DCYCle 5.0
[SOURce[1|2]]:SWEep:SOURceset / query
Sets or queries the trigger source in sweep mode for the specified channel. The query returns the current trigger source as TIM, MAN, or EXT.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | TIMer | MANual | EXTernal | Selects the trigger source for sweep mode. |
enum - Returns the current sweep trigger source.
SOURce1:SWEep:SOURce EXTernal
Sets or queries the trigger source in sweep mode for the specified channel.
enum - Returns the sweep trigger source as TIM, MAN, or EXT.
SOURce1:SWEep:SOURce EXTernal
[SOURce[1|2]]:SWEep:SPACingset / query
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 | Selects the sweep spacing type. |
enum - Returns the sweep spacing type for the specified channel.
Selects linear or logarithmic sweep spacing for the specified channel. The query returns the current sweep spacing type.
enum - Returns the sweep spacing type for the specified channel.
[SOURce[1|2]]:SWEep:TIMEset / query
Sets or queries the sweep time for the specified channel. The sweep time does not include hold time and return time; the valid range is 1 ms to 500 s.
| Name | Type | Values | Description |
|---|---|---|---|
| seconds | real | 1 ms - 500 s | Sweep time in seconds. |
| qualifieropt | enum | MINimum | MAXimum | Use MINimum or MAXimum to set the sweep time to the minimum or maximum allowed value. |
real (s) - Sweep time in seconds.
SOURce1:SWEep:TIME 100ms
Returns the sweep time for the specified channel. The sweep time does not include hold time or return time.
real (s) - The sweep time in seconds.
SOURce1:SWEep:TIME 100ms
Sets or queries the offset level for the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| voltage | real | mV|V | Offset voltage level. |
| qualifieropt | enum | MINimum | MAXimum | Use MINimum or MAXimum in place of a numeric offset value. |
real (mV|V) - Offset voltage level.
SOURce1:VOLTage:LEVel:IMMediate:OFFSet 500mV
Sets or queries the offset level for the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| voltage | real | mV|V | Offset voltage level. |
| qualifieropt | enum | MINimum | MAXimum | Selects the minimum or maximum offset value. |
real - Returns the offset voltage level.
SOURce1:VOLTage:LEVel:IMMediate:OFFSet 500mV
Sets or queries the output amplitude for the specified channel. The output amplitude units are set using the bezel menu selection.
| Name | Type | Values | Description |
|---|---|---|---|
| amplitude | real | Vpp | Output amplitude value. |
| qualifieropt | enum | MINimum | MAXimum | Selects the minimum or maximum amplitude. |
real (Vpp) - Returns the amplitude setting.
Sets or queries the output amplitude for the specified channel. The output amplitude units are set by the bezel menu selection.
returns
Returns the contents of the Error/Event queue. If an error or event is present, the response includes the event number and event message.
string - Error/event number and error/event description from the Error/Event queue.
SYSTEM:ERROR:NEXT?
:TRACe|DATA:CATalog?query
Returns the names of user waveform memory and edit memory.
string - A series of comma-separated strings, each enclosed in quotation marks, naming user waveform memory and edit memory.
TRACE|DATA:CATALOG? might return “USER0”,”USER4”,”EMEM”
:TRACe|DATA:COPYset / query
Copies the contents of edit memory to a specified user waveform memory, or copies a user waveform memory to edit memory.
| Name | Type | Values | Description |
|---|---|---|---|
| trace_name | integer | 0 - 255 | Specifies the user waveform memory location to copy from when used with EMEMory as the destination. |
DATA:COPY USER0,EMEMory
:TRACe|DATA[:DATA]set / query
Transfers waveform data from the external controller to the edit memory in the instrument. The query returns the binary block data.
| Name | Type | Values | Description |
|---|---|---|---|
| memory | enum | EMEMory | Edit memory destination for the waveform data. |
| binary_block_data | block | - | Waveform data in binary format. |
block - Binary block data.
DATA:DATA EMEMory,#42000<DAB><DAB>...<DAB>
:TRACe|DATA[:DATA]:VALueset / query
Sets or queries the data value at a specified point in the edit memory.
| Name | Type | Values | Description |
|---|---|---|---|
| EMEMory | enum | EMEMory | Edit memory target. |
| point | integer | - | Specified point in the edit memory. |
binary_block_data - Returns the binary block data.
Sets or queries the data value at a specified point in the edit memory.
| Name | Type | Values | Description |
|---|---|---|---|
| EMEMory | enum | EMEMory | Edit memory target. |
| point | integer | - | Point in edit memory to access. |
binary_block_data - Binary block data returned by the query.
:TRACe|DATA[:DATA]?query
Transfers waveform data from the external controller to the edit memory in the instrument. The query returns the binary block data.
| Name | Type | Values | Description |
|---|---|---|---|
| EMEMory | - | - | Edit memory destination for the waveform data. |
| binary_block_data | block | - | Waveform data in binary format. |
block - Binary block data.
TRACe|DATA[:DATA] EMEMory,#42000<DAB><DAB>...<DAB>
:TRACe|DATA:POINtsset / query
Sets or queries the number of data points for the waveform created in the edit memory.
| Name | Type | Values | Description |
|---|---|---|---|
| pointsopt | integer | 2 - 8192 | Number of points for the waveform created in the edit memory. |
integer - Returns the number of data points for the waveform created in the edit memory.
:TRACe|DATA:POINts?query
Sets or queries the number of data points for the waveform created in the edit memory.
| Name | Type | Values | Description |
|---|---|---|---|
| EMEMory | enum | - | Edit memory location identifier. |
| pointsopt | integer | 2 - 8192 | Number of points for the waveform created in the edit memory. |
| qualifieropt | enum | MINimum | MAXimum | Returns or sets the minimum or maximum number of points. |
integer - Returns the number of data points for the waveform created in the edit memory, or the minimum/maximum value when queried with MIN or MAX.