The Signals block sets up the instrument’s vector modulation. This includes enabling vector modulation, selecting a waveform file for playback, or selecting optional signal modes, such as Multitone. See also, Vector Modulation Bandwidth Limitations.
Unless specified as "Bonded," this topic primarily describes capabilities for use when the Configuration is Independent, 2 Tx Coherent, or MIMO. For bonded configurations, do not use SCPI commands described in this topic unless they are specified as "Bonded."
For bonded configurations, be sure to use bonding-supported SCPI commands only. Using unsupported SCPI commands in a bonded configuration will impair the fidelity of the waveform. In these cases, the unsupported SCPI commands are still accepted, but no error or warning is generated.
The vector modulation bandwidth is based on the instrument’s optional capabilities and operating settings. The bandwidth is as follows:
Table: M9383B/M9384BVector Modulation BW
Operating Settings |
Bandwidth Options |
|||
---|---|---|---|---|
D20/D21 |
D10/D11 |
D05/D06 |
||
Max Sample Rate (MHz) |
2560 |
1280 |
625 |
|
Max Bandwidth (MHz) |
2048 |
1024 |
500 |
|
Modulation Bandwidth (MHz) |
Frequency < 375 MHz |
20% of Frequency (For example, when Frequency is 100 MHz, Modulation BW is 20 MHz.) |
||
375 MHz ≤ Frequency < 550 MHz |
200 |
200 |
200 |
|
550 MHz ≤ Frequency < 750 MHz |
300 |
300 |
300 |
|
750 MHz ≤ Frequency < 1.0 GHz |
400 |
400 |
400 |
|
1.0 GHz ≤ Frequency < 1.5 GHz |
750 |
750 |
500 |
|
For CAL VERSION < 10: 1.5 GHz ≤ Frequency < 3.2 GHz |
1000 |
1000 |
500 |
|
For CAL VERSION > 9: 1.5 GHz ≤ Frequency < 2.2 GHz |
1000 |
1000 |
500 |
|
For CAL VERSION > 9: 2.2 GHz ≤ Frequency < 3.2 GHz |
1200 |
1024 |
500 |
|
3.2 GHz ≤ Frequency |
2048 |
1024 |
500 |
Table: M9484C Vector Modulation BW
Operating Settings |
Bandwidth Options |
|||||||
---|---|---|---|---|---|---|---|---|
R25 |
R2E |
R10 |
R1E |
B5X |
B2X |
B1X |
||
Max Sample Rate (MHz) |
3000 |
3000 |
1228.8 |
1228.8 |
600 |
200 |
300 |
|
Max Bandwidth (MHz) |
2500 |
2500 |
1024 |
1024 |
500 |
250 |
160* |
|
Modulation Bandwidth (MHz) |
9 kHz ≤ f ≤ 5.75 GHz |
2500 |
2500 |
1024 |
1024 |
500 |
250 |
160 |
5.75 GHz < f ≤ 31.25 GHz |
2500 |
2200 |
1024 |
1024 |
500 |
250 |
160 |
|
31.25 GHz < f ≤ 31.838 GHz |
2500 |
1024 |
1024 |
1024 |
500 |
250 |
160 |
|
31.838 GHz < f < 36.962 GHz |
2500 |
550 |
1024 |
550 |
500 |
250 |
160 |
|
36.962 GHz ≤ f < 37.55 GHz |
2500 |
1024 |
1024 |
1024 |
500 |
250 |
160 |
|
37.55 GHz ≤ f < 89.05 GHz |
2500 |
2200 |
1024 |
1024 |
500 |
250 |
160 |
|
89.05 GHz ≤ f |
2500 |
2500 |
1024 |
1024 |
500 |
250 |
160 |
* Actually 166.66666
If your configuration exceeds the available bandwidth, the following message appears in the Notifications Area:
Modulation BW is greater than instrument’s BW (<bandwidth>) at this frequency
In this scenario, you may operate the instrument with the resulting performance, or reduce the modulation setting to resume operation within the available bandwidth, as determined by the Mode in use.
Turns vector modulation signal on and off.
When I/Q Modulation Source is Internal, toggling this setting also toggles I/Q Modulation On to the same state.
GUI Location |
Signals > Enable Signal |
SCPI Command |
[:SOURce]:GROup<group>:SIGNal<signal>[:STATe] ON|OFF|1|0 [:SOURce]:GROup<group>:SIGNal<signal>[:STATe]? |
SCPI Example |
GRO:SIGN ON GRO:SIGN? |
Notes |
If using floating licenses, be sure to query "SYST:ERR?" after attempting to set "SIGN ON"; if the license was not obtained from the server the error -310,"System error; feature not licensed" is returned. If the M9484APPC or M9484AP1C license is not installed, when attempting to set state to ON an Application error message is generated. |
Preset |
OFF When the mode is real-time, the state is Off since real-time internal settings are not ready after recall/preset. |
Coupling |
When vector modulation is turned ON while Enable Amplitude Control is OFF and I/Q Modulation Source is Internal, I/Q Modulation On is set to ON. When vector modulation is turned OFF while Enable Amplitude Control is ON or I/Q Modulation Source is External, no coupling occurs; meaning the current state of I/Q Modulation On and I/Q Modulation Source is unchanged. When Vector Modulation Signal Mode is Real-Time and Real-Time application internal settings are not set, Enable Vector Modulation is set to Off and is unchangeable. |
State Saved |
Yes |
Dependencies |
For instruments with Option 8SG, if the sample rate of the signal exceeds the channel’s available sample rate, attempting to set Enable Vector Modulation ON raises a Settings Conflict error. |
Backwards Compatibility SCPI |
The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. [:SOURce]:RADio[1]:ARB[:STATe] Alias [:SOURce]:SIGNal[1][:STATe] to :SOURce:GROup1:SIGNal1[:STATe] Alias [:SOURce]:SIGNal2[:STATe] to :SOURce:GROup2:SIGNal1[:STATe] |
Initial S/W Revision |
A.01.00 |
Modified S/W Revision |
A.09.00 Added :GROup keyword, M9484APPC or M9484AP1C A.10.00 Updated the behavior for the real-time mode |
Turns vector modulation signal on and off. The control is grayed-out until a .bnd file has been selected, either manually or as the result of a successful bonded calibration.
GUI Location |
System Menu > Configure Channels > Bonded > Signals > Enable |
SCPI Command |
[:SOURce]:GROup<group>:CBONded[:STATe] ON|OFF|1|0 [:SOURce]:GROup<group>:CBONded[:STATe]? |
SCPI Example |
GRO:CBON ON GRO:CBON? |
Couplings |
Cannot be turned ON if the Bonded Waveform File is not a .bnd file. If Enabled is ON and the Bonded Waveform File is set to a file that is not a .bnd, Enabled is set to OFF. |
Preset |
OFF |
State Saved |
Yes |
Range |
OFF | ON |
SCPI Change |
[:SOURce]:CBONded<bondingset>[:STATe] ON|OFF|1|0 has been changed to [:SOURce]:GROup<group>:CBONded[:STATe] ON|OFF|1|0. Prior use of :SOUR:CBON or :SOUR:CBON1 is now :SOUR:GRO1:CBON. |
Initial S/W Revision |
A.07.00 |
Modified S/W Revision |
A.10.00 Changed SCPI: Added :GROup<group> and removed <bondingset> from :CBONded |
Selects the vector modulation signal mode. Some signal modes are optional capabilities and require a license to enable.
For M9383B/M9384B, if AWGN is On in the Adjustment Block, when Signal Mode of AWGN is selected, the AWGN in the Adjustment Block is disabled.
When using floating licenses with automatic check out, all available signal modes are displayed in the GUI. The license is checked out from the server when the signal mode is selected. The license is checked in (returned to the server) when preset is performed.
Capability |
SCPI Syntax |
License |
---|---|---|
AMOD |
N7642APPC |
|
MTON |
N7621APPC |
|
SSB |
N7621APPC |
|
WAV |
NA | |
AWGN |
NA | |
RTIM |
N7631APPC |
GUI Location |
Signals > Mode |
SCPI Command |
[:SOURce]:GROup<group>:SIGNal<signal>:MODE AMODulation|MTONe|SSB|WAVeform|AWGN|RTIMe [:SOURce]:GROup<group>:SIGNal<signal>:MODE? |
SCPI Example |
GRO:SIGN:MODE AMOD GRO:SIGN:MODE? |
Dependencies |
AWGN is not available when in Tx Coherent configurations. AWGN is available when Option 403 is installed. |
Preset |
WAVeform |
Notes |
The following licenses are required. MTONe and SSB: N7621APPC AMOD: N7642APPC RTIMe: N7631APPC on M9484C When floating licenses are used, licenses are returned to the server when a preset is performed. Beginning with version A.09.00 5G NR and Custom Modulation have been moved from Signal Modes to Applications. See 5G NR Help. The command [:SOURce]:RADio:SELect NR5G is used to load the 5G NR Application SCPI. |
State Saved |
Yes |
Choices |
Analog Modulation | Multitone | Single Tone | Waveform File | AWGN | Real-Time |
Backwards Compatibility SCPI |
The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. Alias [:SOURce]:SIGNal[1]:MODE to :SOURce:GROup1:SIGNal1:MODE Alias [:SOURce]:SIGNal2:MODE to :SOURce:GROup2:SIGNal1:MODE |
Initial S/W Revision |
A.01.00 |
Modified S/W Revision |
A.03.00 added AWGN A.06.00 Changed Single Side-band to Single Tone, and added CMODulation A.09.00 Added :GROup keyword. Removed CMODulation and NR5G A.10.00 Added RTIMe A.11.50 Updated for M9484C |
Applies to the M9383B VXG-m and M9384B VXG only.
Option PCH only.
Sets synchronization role of the channel in the Independent configuration. When the channels are configured to synchronize, one as Primary and the other as Secondary, the system will be set up to start both baseband channels synchronously, using Primary’s trigger. This feature is available with Option PCH only.
When configuring a channel as the Primary, the phase relationship of baseband signal and reference are repeatable between turning on and turning off the signal or by triggering playback (with trigger being re-clocked to the internal 10-MHz reference).
This control doesn’t appear in the Tx Coherent configurations, in which two channels are always configured to be synchronized with Ch1 Primary and Ch2 Secondary.
The Tx Coherent configuration is only available with Option PCH.
Sync Off – The channels are not synchronized. Each signal plays based on its trigger settings.
Primary – The channel participates in synchronization as the Primary. Even selection of Primary alone may be useful as the relationship of start play and system clock is repeatable from start to start.
Secondary – The channel participates in synchronization as the Secondary. Trigger settings of this channel are ignored (and the Trigger GUI tile disappears) since the signal starts to play with the Primary.
GUI Location |
Signals > Synchronization Role |
SCPI Command |
[:SOURce]:GROup<group>:SIGNal<signal>:SROLe OFF|PRIMary|SECondary [:SOURce]:GROup<group>:SIGNal<signal>:SROLe? |
SCPI Example |
GRO:SIGN:SROL SEC GRO:SIGN:SROL? |
Notes |
For instruments without Option PCH, attempting to set SROLe raises error -221, Settings Conflict; option PCH is required. The SCPI enumerations of MASTer and SLAVe have been deprecated and replaced with PRIMary and SECondary, respectively. Ensure your test software uses the PRIMary and SECondary enumerations. For M9484C: Synchronization Role is Off and not changeable. Sending the SCPI command does not generate an error if Option PCH is present. |
Choices |
Sync Off | Primary | Secondary |
Preset |
Sync Off |
Dependencies |
Available only with Option PCH and Configuration is set to Independent. |
State Saved |
Yes |
Backwards Compatibility SCPI |
The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. Alias [:SOURce]:SIGNal[1]:SROLe to :SOURce:GROup1:SIGNal1:SROLe Alias [:SOURce]:SIGNal2:SROLe to :SOURce:GROup2:SIGNal1:SROLe |
Initial S/W Revision |
A.01.00 |
Modified S/W Revision |
A.06.00 A.09.00 Added :GROup keyword A.11.50 Updated for M9484C |
Allows scaling the signal down without disrupting the output. The dynamic range is not adjusted (optimized) when this value is adjusted. This signal’s power relationship with other signals, including noise, is not adjusted when this value is changed. When the signal’s power is adjusted using other features, then this value is reset to 0 dB.
GUI Location |
Signals > Signal Attenuation |
SCPI Command |
[:SOURce]:GROup<group>:SIGNal<signal>:POWer:SATTenuation <rel_ampl> [:SOURce]:GROup<group>:SIGNal<signal>:POWer:SATTenuation? |
SCPI Example |
GRO:SIGN:POW:SATT -3 GRO:SIGN:POW:SATT? |
Dependencies |
When Mode is AWGN, this setting is disabled. |
Preset |
0 dB |
State Saved |
Yes |
Min |
For M9383B/M9384B: -50 dB For M9484C: -100 dB |
Max |
0 dB |
Resolution |
0.01dB |
Backwards Compatibility SCPI |
The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. Alias [:SOURce]:SIGNal[1]:POWer:SATTenuation to :SOURce:GROup1:SIGNal1:POWer:SATTenuation Alias [:SOURce]:SIGNal2:POWer:SATTenuation to :SOURce:GROup2:SIGNal1:POWer:SATTenuation |
Initial S/W Revision |
A.01.00 |
Modified S/W Revision |
A.04.00: Changed the title/label from Baseband Power to Signal Attenuation and moved its location out of the Waveform Playback Setup area. A.09.00: Added :GROup keyword. A.10.00: Changed minimum value for M9484C. |
Available with Option 8SG. This feature disables or enables the I/Q component of a signal without adjusting any power relationships between any signals, including noise. The channel will behave as if the signal is not muted, but the signal will not contribute any power to the outputs of the channel. Turning the signal off and on with this feature means that there is no other disruption to the outputs besides this signal having no power or the requested power. For instance, triggering of the signal is not disabled when muting occurs. Markers also continue to be output. This feature is independent of the Signal Attenuation feature.
GUI Location |
Signals > Mute |
SCPI Command |
[:SOURce]:GROup<group>:SIGNal<signal>:POWer:MUTE[:STATe] ON|OFF|1|0 [:SOURce]:GROup<group>:SIGNal<signal>:POWer:MUTE[:STATe]? |
SCPI Example |
GRO:SIGN:POW:MUTE 1 GRO:SIGN:POW:MUTE? |
Notes |
On instruments without Option 8SG, sending the SCPI command does not generate an error |
Preset |
OFF |
State Saved |
Yes |
Initial S/W Revision |
A.09.00 |
The sample rate used by the signal is reported on screen and available via a SCPI query. This value is available regardless of the signal’s enabled or disabled state.
GUI Location |
Signals > Sample Rate (read-only) |
SCPI Command |
[:SOURce]:GROup<group>:SIGNal<signal>:SCLock:RATE? |
SCPI Example |
GRO:SIGN:SCL:RATE? |
State Saved |
No |
Min |
0 Hz |
Max |
For M9383B or M9384B: Option D20 or D21 = 2.56 GHz Option D05 or D06= 625 MHz Option D10 or D11 = 1.28 GHz For M9484C: Option R25 or R2E = 3.0 GHz When Fading is On, sample rate maximum is 2.4 GHz Option R10 or R1E = 1228.8 MHz Option B5X = 600 MHz Option B2X = 300 MHz Option B1X = 200 MHz |
Initial S/W Revision |
A.10.00 |
For channel bonding configurations, note the following:
The trigger configuration can be adjusted after the bonding process has completed.
Use Signal 1 for SCPI commands when configuring the triggering.
Sets the trigger mode (or type), determining how the waveform plays when triggered. These mode selections are described in the table below.
Triggers control the playback by telling the signal generator when to play the modulating signal (waveform). Depending on the trigger settings, the waveform playback can occur once or continuously.
A trigger signal comprises both positive and negative signal transitions (states), which are also called high and low periods. You can configure the signal generator to trigger on either state of the trigger signal. It is common to have multiple trigger signals, also referred to as trigger occurrences or events, occur when the signal generator requires only a single trigger. In this situation, the signal generator’s action is based on the setting within the trigger mode.
When you select a trigger mode, you may lose the signal (carrier plus modulation) from the RF output until you trigger the waveform. This is because the signal generator sets the I and Q signals to zero volts prior to the first trigger event, which suppresses the carrier. After the first trigger event, the waveform’s final I and Q levels determine whether you will see the carrier signal or not (zero = no carrier, other values = carrier visible). At the end of most files, the final I and Q points are set to a value other than zero.
Continuous: The framed data sequence repeats continuously until you turn the signal off or select a different waveform, or trigger mode. The sequence restarts every time the previous playback is completed.
Single: The framed data sequence plays once for every trigger received.
Segment Advance: For M9484C. The trigger controls the segment advance within a waveform sequence. To use this choice, a waveform sequence must be the active waveform.
GUI Location |
Signals > Trigger > Trigger Mode |
SCPI Command |
[:SOURce]:GROup<group>:SIGNal<signal>:TRIGger:TYPE CONTinuous|SINGle|SADVance [:SOURce]:GROup<group>:SIGNal<signal>:TRIGger:TYPE? |
SCPI Example |
GRO:SIGN:TRIG:TYPE SING GRO:SIGN:TRIG:TYPE? |
Choices |
Continuous | Single |
Notes |
For M9484C, SADVance is available when the Signal Mode is Waveform File, and the selected waveform file is a sequence. Attempting to set SADVance without these requirements raises the error -221, "Settings conflict; SADVance not allowed until waveform sequence is selected". This occurs when the indicated signal is already enabled, or when the signal is transitioned to the enabled state. For M9383B and M9384B, attempting to set SADVance raises the error 703,"Feature not supported; SADVance not supported on {model}" |
Preset |
CONT |
State Saved |
Yes |
Backwards Compatibility SCPI |
The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. [:SOURce]:RADio[1]:ARB:TRIGger:TYPE Alias [:SOURce]:SIGNal[1]:CMODulation:TRIGger:TYPE to :SOURce:GROup1:SIGNal1:TRIGger:TYPE Alias [:SOURce]:SIGNal2:CMODulation:TRIGger:TYPE to :SOURce:GROup2:SIGNal1:TRIGger:TYPE Alias [:SOURce]:SIGNal[1]:MTONe:TRIGger:TYPE to :SOURce:GROup1:SIGNal1:TRIGger:TYPE Alias [:SOURce]:SIGNal2:MTONe:TRIGger:TYPE to :SOURce:GROup2:SIGNal1:TRIGger:TYPE Alias [:SOURce]:SIGNal[1]:NR5G:TRIGger:TYPE to :SOURce:GROup1:SIGNal1:TRIGger:TYPE Alias [:SOURce]:SIGNal2:NR5G:TRIGger:TYPE to :SOURce:GROup2:SIGNal1:TRIGger:TYPE Alias [:SOURce]:SIGNal[1]:WAVeform:TRIGger:TYPE to :SOURce:GROup1:SIGNal1:TRIGger:TYPE Alias [:SOURce]:SIGNal2:WAVeform:TRIGger:TYPE to :SOURce:GROup2:SIGNal1:TRIGger:TYPE |
Initial S/W Revision |
A.01.00 |
Modified S/W Revision |
A.09.00 Added :GROup keyword, moved subsystem up so as not to be specific to Signal Mode A.11.50 Added segment advance for M9484C |
Selects the waveform’s response to a trigger signal while using the continuous trigger mode.
Free Run: The waveform is immediately triggered and played when Enable Vector Modulation Signal is turned on and a valid waveform file is selected. The waveform repeats until you turn off Enable Vector Modulation Signal, select another trigger, or choose another waveform file. Triggers received while the waveform is playing are ignored. For M9484C. Free Run is not available when Trigger Source is Global Trigger.
Trigger & Run: The waveform waits for a trigger before it starts playing. When the waveform receives the trigger, it plays continuously until you turn off Enable Vector Modulation Signal, select another trigger, or choose another waveform file. Subsequent triggers are ignored.
Reset & Run: The waveform waits for a trigger before it starts playing. When the waveform receives the trigger, it plays continuously. Subsequent triggers reset the waveform to the beginning. For a waveform sequence, it means the beginning of the first segment in the sequence. For M9484C, Reset & Run is not available when Trigger Source is Global Trigger and the Global Trigger Source is Immediate.
SCPI Command |
[:SOURce]:GROup<group>:SIGNal<signal>:TRIGger:TYPE:CONTinuous[:TYPE] FREE|TRIGger|RESet [:SOURce]:GROup<group>:SIGNal<signal>:TRIGger:TYPE:CONTinuous[:TYPE]? |
SCPI Example |
GRO:SIGN:TRIG:TYPE:CONT TRIG GRO:SIGN:TRIG:TYPE:CONT? |
Preset |
FREE |
Couplings |
When Trigger Source is changed to IMMediate, Continuous Mode changes to Free Run. For M9484C, when Trigger Source is Global Trigger, Free Run is not available. If Continuous Mode is Free Run, when changing Trigger Source to Global Trigger, Continuous Mode changes to Trigger & Run. For M9484C, when Trigger Source is Global Trigger and Global Trigger Source is Immediate, Continuous Mode of Reset & Run is not available. |
State Saved |
Yes |
Choices |
Free Run | Trigger & Run | Reset & Run |
Backwards Compatibility SCPI |
The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. [:SOURce]:RADio:ARB:TRIGger:TYPE:CONTinuous[:TYPE] Alias [:SOURce]:SIGNal[1]:CMODulation:TRIGger:TYPE:CONTinuous[:TYPE] to :SOURce:GROup1:SIGNal1:TRIGger:TYPE:CONTinuous[:TYPE] Alias [:SOURce]:SIGNal2:CMODulation:TRIGger:TYPE:CONTinuous[:TYPE] to :SOURce:GROup2:SIGNal1:TRIGger:TYPE:CONTinuous[:TYPE] Alias [:SOURce]:SIGNal[1]:MTONe:TRIGger:TYPE:CONTinuous[:TYPE] to :SOURce:GROup1:SIGNal1:TRIGger:TYPE:CONTinuous[:TYPE] Alias [:SOURce]:SIGNal2:MTONe:TRIGger:TYPE:CONTinuous[:TYPE] to :SOURce:GROup2:SIGNal1:TRIGger:TYPE:CONTinuous[:TYPE] Alias [:SOURce]:SIGNal[1]:NR5G:TRIGger:TYPE:CONTinuous[:TYPE] to :SOURce:GROup1:SIGNal1:TRIGger:TYPE:CONTinuous[:TYPE] Alias [:SOURce]:SIGNal2:NR5G:TRIGger:TYPE:CONTinuous[:TYPE] to :SOURce:GROup2:SIGNal1:TRIGger:TYPE:CONTinuous[:TYPE] Alias [:SOURce]:SIGNal[1]:WAVeform:TRIGger:TYPE:CONTinuous[:TYPE] to :SOURce:GROup1:SIGNal1:TRIGger:TYPE:CONTinuous[:TYPE] Alias [:SOURce]:SIGNal2:WAVeform:TRIGger:TYPE:CONTinuous[:TYPE] to :SOURce:GROup2:SIGNal1:TRIGger:TYPE:CONTinuous[:TYPE] |
Initial S/W Revision |
A.03.00 |
Modified S/W Revision |
A.09.00 Added :GROup keyword, moved subsystem up so as not to be specific to Signal Mode A.10.00 Added coupling with Global Trigger |
Enables or disables the retriggering mode that controls how the retriggering function performs while a waveform is playing.
OFF (0)/No Retrigger: If a trigger is received early, while a waveform is playing, it will be ignored.
IMMediate/Restart on Trigger: If a trigger occurs while a waveform is playing, the ARB will reset and replay the waveform from the start, but there will be a gap in the playback while this is occurring. It will reset itself for every trigger it receives. For the M9484C, when the Trigger Source is Global Trigger, and Global Trigger Source is Immediate, Restart on Trigger is not available.
ON (1)/Buffered Trigger (M9484C only): If an early trigger occurs while a waveform is playing, the waveform will be retriggered at the end of the current waveform sequence and play once more. The RF will not be aligned with this early trigger. If the trigger occurs during the Trigger Delay period it will be ignored. When the Trigger Source is Global Trigger, and Global Trigger Source is Immediate, Buffered Trigger is not available.
SCPI Command |
[:SOURce]:GROup<group>:SIGNal<signal>:TRIGger:TYPE:SINGle:RETRigger ON|OFF|1|0|IMMediate [:SOURce]:GROup<group>:SIGNal<signal>:TRIGger:TYPE:SINGle:RETRigger? |
SCPI Example |
GRO:SIGN:TRIG:TYPE:SING:RETR 0 GRO:SIGN:TRIG:TYPE:SING:RETR? |
Dependencies |
Available only when Trigger Mode is Single |
Couplings |
When Trigger Source is changed to IMMediate, Single Mode changes to OFF For M9484C, when Trigger Source is Global Trigger, and Global Trigger Source is IMMediate, Single Mode becomes OFF and is not changeable. |
Notes |
For M9383B/M9384B, setting ON|1 generates the Invalid Parameter error. |
Preset |
ON |
State Saved |
Yes |
Choices |
Buffered Trigger | No Retrigger | Restart on Trigger |
Backwards Compatibility SCPI |
The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. [:SOURce]:RADio:ARB:RETRigger Alias [:SOURce]:SIGNal[1]:CMODulation:TRIGger:TYPE:SINGle:RETRigger to :SOURce:GROup1:SIGNal1:TRIGger:TYPE:SINGle:RETRigger Alias [:SOURce]:SIGNal2:CMODulation:TRIGger:TYPE:SINGle:RETRigger to :SOURce:GROup2:SIGNal1:TRIGger:TYPE:SINGle:RETRigger Alias [:SOURce]:SIGNal[1]:MTONe:TRIGger:TYPE:SINGle:RETRigger to :SOURce:GROup1:SIGNal1:TRIGger:TYPE:SINGle:RETRigger Alias [:SOURce]:SIGNal2:MTONe:TRIGger:TYPE:SINGle:RETRigger to :SOURce:GROup2:SIGNal1:TRIGger:TYPE:SINGle:RETRigger Alias [:SOURce]:SIGNal[1]:NR5G:TRIGger:TYPE:SINGle:RETRigger to :SOURce:GROup1:SIGNal1:TRIGger:TYPE:SINGle:RETRigger Alias [:SOURce]:SIGNal2:NR5G:TRIGger:TYPE:SINGle:RETRigger to :SOURce:GROup2:SIGNal1:TRIGger:TYPE:SINGle:RETRigger Alias [:SOURce]:SIGNal[1]:WAVeform:TRIGger:TYPE:SINGle:RETRigger to :SOURce:GROup1:SIGNal1:TRIGger:TYPE:SINGle:RETRigger Alias [:SOURce]:SIGNal2:WAVeform:TRIGger:TYPE:SINGle:RETRigger to :SOURce:GROup2:SIGNal1:TRIGger:TYPE:SINGle:RETRigger |
Initial S/W Revision |
A.03.00 |
Modified S/W Revision |
A.09.00 Added :GROup keyword, moved subsystem up so as not to be specific to Signal Mode A.10.00 Added coupling with Global Trigger |
For M9484C with Signal Mode set to Waveform File. When the waveform file selected is a waveform sequence, the trigger mode of segment advance (SADVance) controls the execution of the sequence.
Remote command only.
Segment advance can be configured for single or continuous execution. When the instrument receives multiple trigger occurrences when only one is required, the signal generator uses the first trigger and ignores the rest.
Single: Each segment in the sequence requires a trigger to play, and a segment plays only once, ignoring a segment’s repetition value. The following list describes a sequence’s playback behavior with this choice:
After receiving the first trigger, the first segment plays to completion.
When the waveform receives a trigger after a segment completes, the sequence advances to the next segment and plays that segment to completion.
When the waveform receives a trigger during play, the current segment plays to completion. Then the sequence advances to the next segment, and it plays to completion.
When the waveform receives a trigger either during or after the last segment in a sequence, the sequence resets and the first segment plays to completion.
Continuous: Each segment in the sequence requires a trigger to play. After receiving a trigger, a segment plays continuously until the waveform receives another trigger. The following list describes a sequence’s playback behavior with this choice:
After receiving the first trigger, the first segment plays continuously.
A trigger during the current segment play causes the segment to play to the end of the segment file, then the sequence advances to the next segment, which plays continuously.
When last segment in the sequence receives a trigger, the sequence resets and the first segment plays continuously.
SCPI Command |
[:SOURce]:GROup<group>:SIGNal<signal>:TRIGger:TYPE:SADVance[:TYPE] SINGle|CONTinuous [:SOURce]:GROup<group>:SIGNal<signal>:TRIGger:TYPE:SADVance[:TYPE]? |
SCPI Example |
GRO:SIGN:TRIG:TYPE:SADV SING GRO:SIGN:TRIG:TYPE:SADV? |
Preset |
CONT |
State Saved |
Yes |
Backwards Compatibility SCPI |
[:SOURce]:RADio[1]:ARB:TRIGger:TYPE:SADVance[:TYPE] |
Initial S/W Revision |
A.11.50 |
Remote command only.
The advancing of segments in a sequence can be automatic or manual. In automatic, the advancement occurs sequentially from one segment to the next. In manual, the advancement is controlled by the Manual Next Segment.
SCPI Command |
[:SOURce]:GROup<group>:SIGNal<signal>:TRIGger:TYPE:SADVance:AUTO ON|OFF|1|0 [:SOURce]:GROup<group>:SIGNal<signal>:TRIGger:TYPE:SADVance:AUTO? |
SCPI Example |
GRO:SIGN:TRIG:TYPE:SADV:AUTO OFF GRO:SIGN:TRIG:TYPE:SADV:AUTO? |
Preset |
ON |
State Saved |
Yes |
Initial S/W Revision |
A.11.50 |
Remote command only.
When segment advance is in manual mode, this command is used to indicate the segment to be played once the trigger condition is met. If the value provided is more than the number of segments in the sequence, the last segment will be selected.
Sending the Next Segment command stops any existing playback and readies the playback for the subsequent trigger event for the next segment.
SCPI Command |
[:SOURce]:GROup<group>:SIGNal<signal>:TRIGger:TYPE:SADVance:NEXT <integer> [:SOURce]:GROup<group>:SIGNal<signal>:TRIGger:TYPE:SADVance:NEXT? |
SCPI Example |
GRO:SIGN:TRIG:TYPE:SADV:NEXT 2 |
Preset |
1 |
State Saved |
Yes |
Initial S/W Revision |
A.11.50 |
Sets the trigger source.
Bus: The trigger is initiated programmatically in the software. Use the *TRG command to initiate the trigger for all groups (channels), and in the case of M9484C with Option 8SG for all signals. Use *TRG to initiate synchronous programmatic triggering of the instrument. To initiate a trigger programmatically for an individual group (channel), and individual signal, use the [:SOURce]:GROup<group>:SIGNal<signal>:TRIGger:IMMediate command.
Key: The trigger is initiated manually in the software, using the Trigger button. Because there is one trigger button for the instrument, if you have multiple groups (channels) and, in the case of M9484C with Option 8SG, multiple signals, all groups and signals are triggered together.
External: Enables the triggering of the waveform playing by an externally applied signal at the following connector.
On an M9383B, Ext1 of M9343A at slot 15 (CH1) or slot 7 (CH2)
On an M9384B, Ch 1 Ext 1 or Ch 2 Ext 1 on the rear panel.
On an M9484C, the connector must be configured via the External Trigger Source setting.
Immediate: Enables immediate triggering of the waveform playing.
Global Trigger Available on the M9484C, this trigger source must be used when synchronized playback is needed across channels in instruments with multiple channels. There is one global trigger for the instrument; all signals and groups (channels) utilizing Global Trigger will be affected by changes to the Global Trigger settings.
Both KEY and BUS are software triggers and are not intended to be configured on the instrument at the same time. Even though the Trigger Source is configured on a group and signal basis, thus one signal could be configured for KEY and another for BUS, it is intended you will be either using the instrument in manual operation (via front-panel interface) or programmatically (via remote SCPI commands). You can encounter unexpected triggering if you intermix KEY and BUS triggering at the same time. They both trigger the hardware in the same way.
GUI Location |
Signals > Trigger > Trigger Source |
SCPI Command |
[:SOURce]:GROup<group>:SIGNal<signal>:TRIGger[:SOURce] KEY|BUS|EXTernal|IMMediate|GTRigger [:SOURce]:GROup<group>:SIGNal<signal>:TRIGger[:SOURce]? |
SCPI Example |
GRO:SIGN:TRIG KEY GRO:SIGN:TRIG? |
Couplings |
When Trigger Mode is Continuous:
When Trigger Mode is Single:
|
Preset |
IMMediate |
Choices |
Immediate | Key | Bus | External |
State Saved |
Yes |
Backwards Compatibility SCPI |
The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. [:SOURce]:RADio:ARB:TRIGger[:SOURce] Alias [:SOURce]:SIGNal[1]:CMODulation:TRIGger[:SOURce] to :SOURce:GROup1:SIGNal1:TRIGger[:SOURce] Alias [:SOURce]:SIGNal2:CMODulation:TRIGger[:SOURce] to :SOURce:GROup2:SIGNal1:TRIGger[:SOURce] Alias [:SOURce]:SIGNal[1]:MTONe:TRIGger[:SOURce] to :SOURce:GROup1:SIGNal1:TRIGger[:SOURce] Alias [:SOURce]:SIGNal2:MTONe:TRIGger[:SOURce] to :SOURce:GROup2:SIGNal1:TRIGger[:SOURce] Alias [:SOURce]:SIGNal[1]:NR5G:TRIGger[:SOURce] to :SOURce:GROup1:SIGNal1:TRIGger[:SOURce] Alias [:SOURce]:SIGNal2:NR5G:TRIGger[:SOURce] to :SOURce:GROup2:SIGNal1:TRIGger[:SOURce] Alias [:SOURce]:SIGNal[1]:WAVeform:TRIGger[:SOURce] to :SOURce:GROup1:SIGNal1:TRIGger[:SOURce] Alias [:SOURce]:SIGNal2:WAVeform:TRIGger[:SOURce] to :SOURce:GROup2:SIGNal1:TRIGger[:SOURce] |
Initial S/W Revision |
A.01.00 |
Modified S/W Revision |
A.09.00 Added :GROup keyword, moved subsystem up so as not to be specific to Signal Mode |
On MXG-B, the Trigger Source command (:RAD:ARB:TRIG) doesn’t have the IMMediate selection. Due to this difference, SCPIs related to Trigger don’t behave in exactly the same way as MXG-B. The following table shows returned values of Trigger Source and Continuous Mode in N5182B MXG and VXG when the SCPI commands are sent in the following order. The user from N5182B MXG should understand the behavior difference.
# |
SCPI |
Setting Values |
|||
---|---|---|---|---|---|
Trigger Source |
Continuous Mode |
||||
MXG |
VXG |
MXG |
VXG |
||
1 |
*RST |
EXTernal |
IMMediate |
FREE |
FREE |
2 |
:RADio:ARB:TRIGger EXTernal |
EXTernal |
EXTernal |
RESet |
RESet |
3 |
:RADio:ARB:TRIGger:TYPE:CONTinuous:TYPE FREE |
EXTernal |
IMMediate |
FREE |
FREE |
4 |
:RADio:ARB:TRIGger BUS |
BUS |
BUS |
FREE |
TRIGger |
5 |
:RADio:ARB:TRIGger:TYPE:CONTinuous:TYPE FREE |
BUS |
IMMediate |
FREE |
FREE |
Signal Trigger Delay applies to the M9484C only. It delays the vector modulation (I/Q) of a signal with respect to any trigger event, including the initial trigger for immediate trigger.
For instruments with Option 8SG, this allows delaying one signal versus other signals regardless of trigger type. When using more than one signal, each signal’s delay should be offset from other signals if the waveform being played on each signal is too correlated. If signals are too correlated, the baseband DAC overrange error may occur.
GUI Location |
Signals > Trigger > Trigger Delay |
SCPI Command |
[:SOURce]:GROup<group>:SIGNal<signal>:TRIGger:DELay <time> [:SOURce]:GROup<group>:SIGNal<signal>:TRIGger:DELay? |
SCPI Example |
GRO:SIGN:TRIG:DEL 500 ms GRO:SIGN:TRIG:DEL? |
Preset |
0 s |
State Saved |
Yes |
Min |
0 s |
Max |
41 s |
Resolution |
333.333… ps |
Initial S/W Revision |
A.10.00 |
External Trigger Source applies to the M9484C only. Selects the external trigger source connector. To configure available trigger connectors, see the Connectors topic.
GUI Location |
Signals > Trigger > Trigger Source set to External > External Trigger Source |
SCPI Command |
[:SOURce]:GROup<group>:SIGNal<signal>:TRIGger:EXTernal[:SOURce] <integer> [:SOURce]:GROUP<group>:SIGNal<signal>:TRIGger:EXTernal[:SOURce]? |
SCPI Example |
GRO:SIGN:TRIG:EXT:SOUR 1 GRO:SIGN:TRIG:EXT:SOUR? |
Notes |
For the selected Group, the External Trigger Source is composed of the common set of available selections for that group. For example, in Nx2 MIMO for instruments with AN1 the available GROup1 selection is 1, for instruments without AN1 the available GROup1 selection are 1, or 2, or 3. (For any configuration Groups 2 and above the available selections are always 1, or 2, or 3.) |
Dependencies |
Values 4 through 18 are only available when Option AN1 is present. Attempting to send these selections without Option AN1 will generate an Illegal Parameter error. Attempting to set a selection unavailable for a Group’s configuration will generate an Illegal Parameter error. |
Couplings |
If the specified connector was being used (not None) as an output, then the Trigger Output Routing of that connector is set to None and a Settings Conflict error message is generated. |
Preset |
1 |
Range |
1 to 18 |
State Saved |
Yes |
Initial S/W Revision |
A.09.00 |
External Trigger Termination applies to the M9383B/M9384B only.
Sets how the trigger line should be terminated in the hardware.
HIGH: High impedance
NORMal: 50 Ohm
GUI Location |
Signals > Trigger > Trigger Termination |
SCPI Command |
[:SOURce]:GROup<group>:SIGNal<signal>:TRIGger[:SOURce]:EXTernal:TERMination NORMal|HIGH [:SOURce]:GROup<group>:SIGNal<signal>:TRIGger[:SOURce]:EXTernal:TERMination? |
SCPI Example |
GRO:SIGN:TRIG:EXT:TERM NORM GRO:SIGN:TRIG:EXT:TERM? |
Couplings |
Enabled when Trigger Source is set to EXTernal. |
Notes |
For the M9484C, Trigger Termination is HIGH and not changeable, sending the SCPI command does not generate an error. |
Preset |
HIGH |
Choices |
50 Ohm | High Impedance |
State Saved |
Yes |
Backwards Compatibility SCPI |
The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. Alias [:SOURce]:SIGNal[1]:CMODulation:TRIGger[:SOURce]:EXTernal:TERMination to :SOURce:GROup1:SIGNal1:TRIGger[:SOURce]:EXTernal:TERMination Alias [:SOURce]:SIGNal2:CMODulation:TRIGger[:SOURce]:EXTernal:TERMination to :SOURce:GROup2:SIGNal1:TRIGger[:SOURce]:EXTernal:TERMination Alias [:SOURce]:SIGNal[1]:MTONe:TRIGger[:SOURce]:EXTernal:TERMination to :SOURce:GROup1:SIGNal1:TRIGger[:SOURce]:EXTernal:TERMination Alias [:SOURce]:SIGNal2:MTONe:TRIGger[:SOURce]:EXTernal:TERMination to :SOURce:GROup2:SIGNal1:TRIGger[:SOURce]:EXTernal:TERMination Alias [:SOURce]:SIGNal[1]:NR5G:TRIGger[:SOURce]:EXTernal:TERMination to :SOURce:GROup1:SIGNal1:TRIGger[:SOURce]:EXTernal:TERMination Alias [:SOURce]:SIGNal2:NR5G:TRIGger[:SOURce]:EXTernal:TERMination to :SOURce:GROup2:SIGNal1:TRIGger[:SOURce]:EXTernal:TERMination Alias [:SOURce]:SIGNal[1]:WAVeform:TRIGger[:SOURce]:EXTernal:TERMination to :SOURce:GROup1:SIGNal1:TRIGger[:SOURce]:EXTernal:TERMination Alias [:SOURce]:SIGNal2:WAVeform:TRIGger[:SOURce]:EXTernal:TERMination to :SOURce:GROup2:SIGNal1:TRIGger[:SOURce]:EXTernal:TERMination |
Initial S/W Revision |
A.01.00 |
Modified S/W Revision |
A.09.00 Added :GROup keyword, moved subsystem up so as not to be specific to Signal Mode |
External Trigger Level applies to the M9383B/M9384B only.
Specifies the threshold level in volts at which the trigger transitions states.
GUI Location |
Signals > Trigger > Trigger Level |
SCPI Command |
[:SOURce]:GROup<group>:SIGNal<signal>:TRIGger[:SOURce]:EXTernal:LEVel <voltage> [:SOURce]:GROup<group>:SIGNal<signal>:TRIGger[:SOURce]:EXTernal:LEVel? |
SCPI Example |
GRO:SIGN:TRIG:EXT:LEV 1.5v GRO:SIGN:TRIG:EXT:LEV? |
Couplings |
Enabled when Trigger Source is set to EXTernal. |
Notes |
For the M9484C, Trigger Level is 0.5 V and not changeable, sending the SCPI command does not generate an error. |
Preset |
0.5 |
State Saved |
Yes |
Min |
-3.5 V |
Max |
3.5 V |
Resolution |
0.1 V |
Backwards Compatibility SCPI |
The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. Alias [:SOURce]:SIGNal[1]:CMODulation:TRIGger[:SOURce]:EXTernal:LEVel to :SOURce:GROup1:SIGNal1:TRIGger[:SOURce]:EXTernal:LEVel Alias [:SOURce]:SIGNal2:CMODulation:TRIGger[:SOURce]:EXTernal:LEVel to :SOURce:GROup2:SIGNal1:TRIGger[:SOURce]:EXTernal:LEVel Alias [:SOURce]:SIGNal[1]:MTONe:TRIGger[:SOURce]:EXTernal:LEVel to :SOURce:GROup1:SIGNal1:TRIGger[:SOURce]:EXTernal:LEVel Alias [:SOURce]:SIGNal2:MTONe:TRIGger[:SOURce]:EXTernal:LEVel to :SOURce:GROup2:SIGNal1:TRIGger[:SOURce]:EXTernal:LEVel Alias [:SOURce]:SIGNal[1]:NR5G:TRIGger[:SOURce]:EXTernal:LEVel to :SOURce:GROup1:SIGNal1:TRIGger[:SOURce]:EXTernal:LEVel Alias [:SOURce]:SIGNal2:NR5G:TRIGger[:SOURce]:EXTernal:LEVel to :SOURce:GROup2:SIGNal1:TRIGger[:SOURce]:EXTernal:LEVel Alias [:SOURce]:SIGNal[1]:WAVeform:TRIGger[:SOURce]:EXTernal:LEVel to :SOURce:GROup1:SIGNal1:TRIGger[:SOURce]:EXTernal:LEVel Alias [:SOURce]:SIGNal2:WAVeform:TRIGger[:SOURce]:EXTernal:LEVel to :SOURce:GROup2:SIGNal1:TRIGger[:SOURce]:EXTernal:LEVel |
Initial S/W Revision |
A.01.00 |
Modified S/W Revision |
A.09.00 Added :GROup keyword, moved subsystem up so as not to be specific to Signal Mode |
External Trigger Slope applies to the M9383B/M9384B only.
Sets the polarity for an external trigger signal while using continuous or single triggering mode.
GUI Location |
Signals > Trigger > Trigger Slope |
SCPI Command |
[:SOURce]:GROup<group>:SIGNal<signal>:TRIGger[:SOURce]:EXTernal:SLOPe POSitive|NEGative [:SOURce]:GROup<group>:SIGNal<signal>:TRIGger[:SOURce]:EXTernal:SLOPe? |
SCPI Example |
GRO:SIGN:TRIG:EXT:SLOP POS GRO:SIGN:TRIG:EXT:SLOP? |
Couplings |
Enabled when Trigger Source is set to EXTernal. |
Notes |
For the M9484C, Trigger Slope is NEGative and not changeable, sending the SCPI command does not generate an error. |
Preset |
NEGative |
Choices |
Negative | Positive |
State Saved |
Yes |
Backwards Compatibility SCPI |
The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. [:SOURce]:RADio:ARB:TRIGger[:SOURce]:EXTernal:SLOPe Alias [:SOURce]:SIGNal[1]:CMODulation:TRIGger[:SOURce]:EXTernal:SLOPe to :SOURce:GROup1:SIGNal1:TRIGger[:SOURce]:EXTernal:SLOPe Alias [:SOURce]:SIGNal2:CMODulation:TRIGger[:SOURce]:EXTernal:SLOPe to :SOURce:GROup2:SIGNal1:TRIGger[:SOURce]:EXTernal:SLOPe Alias [:SOURce]:SIGNal[1]:MTONe:TRIGger[:SOURce]:EXTernal:SLOPe to :SOURce:GROup1:SIGNal1:TRIGger[:SOURce]:EXTernal:SLOPe Alias [:SOURce]:SIGNal2:MTONe:TRIGger[:SOURce]:EXTernal:SLOPe to :SOURce:GROup2:SIGNal1:TRIGger[:SOURce]:EXTernal:SLOPe Alias [:SOURce]:SIGNal[1]:NR5G:TRIGger[:SOURce]:EXTernal:SLOPe to :SOURce:GROup1:SIGNal1:TRIGger[:SOURce]:EXTernal:SLOPe Alias [:SOURce]:SIGNal2:NR5G:TRIGger[:SOURce]:EXTernal:SLOPe to :SOURce:GROup2:SIGNal1:TRIGger[:SOURce]:EXTernal:SLOPe Alias [:SOURce]:SIGNal[1]:WAVeform:TRIGger[:SOURce]:EXTernal:SLOPe to :SOURce:GROup1:SIGNal1:TRIGger[:SOURce]:EXTernal:SLOPe Alias [:SOURce]:SIGNal2:WAVeform:TRIGger[:SOURce]:EXTernal:SLOPe to :SOURce:GROup2:SIGNal1:TRIGger[:SOURce]:EXTernal:SLOPe |
Initial S/W Revision |
A.01.00 |
Modified S/W Revision |
A.09.00 Added :GROup keyword, moved subsystem up so as not to be specific to Signal Mode |
External Trigger Delay applies to the M9383B/M9384B only.
Sets the amount of time to delay the signal generator’s response to an external trigger.
GUI Location |
Signals > Trigger > Trigger Source set to External > Trigger Delay |
SCPI Command |
[:SOURce]:GROup<group>:SIGNal<signal>:TRIGger[:SOURce]:EXTernal:DELay <time> [:SOURce]:GROup<group>:SIGNal<signal>:TRIGger[:SOURce]:EXTernal:DELay? |
SCPI Example |
GRO:SIGN:TRIG:EXT:DEL 500 ms GRO:SIGN:TRIG:EXT:DEL? |
Notes |
The SCPI command is accepted for the M9484C and coupled to the Signal Trigger Delay. |
Couplings |
Enabled when Trigger Source is set to EXTernal. |
Preset |
0 s |
State Saved |
Yes |
Min |
0 s |
Max |
For the M9383B/M9384B: In general, max = 10 s. When Playback Synchronization is enabled, max = 2 s |
Resolution |
For the M9383B/M9384B: 3.125 ns For the M9484C: 333.33333… ps |
Backwards Compatibility SCPI |
The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. [:SOURce]:RADio:ARB:TRIGger[:SOURce]:EXTernal:DELay Alias [:SOURce]:SIGNal[1]:CMODulation:TRIGger[:SOURce]:EXTernal:DELay to :SOURce:GROup1:SIGNal1:TRIGger[:SOURce]:EXTernal:DELay Alias [:SOURce]:SIGNal2:CMODulation:TRIGger[:SOURce]:EXTernal:DELay to :SOURce:GROup2:SIGNal1:TRIGger[:SOURce]:EXTernal:DELay Alias [:SOURce]:SIGNal[1]:MTONe:TRIGger[:SOURce]:EXTernal:DELay to :SOURce:GROup1:SIGNal1:TRIGger[:SOURce]:EXTernal:DELay Alias [:SOURce]:SIGNal2:MTONe:TRIGger[:SOURce]:EXTernal:DELay to :SOURce:GROup2:SIGNal1:TRIGger[:SOURce]:EXTernal:DELay Alias [:SOURce]:SIGNal[1]:NR5G:TRIGger[:SOURce]:EXTernal:DELay to :SOURce:GROup1:SIGNal1:TRIGger[:SOURce]:EXTernal:DELay Alias [:SOURce]:SIGNal2:NR5G:TRIGger[:SOURce]:EXTernal:DELay to :SOURce:GROup2:SIGNal1:TRIGger[:SOURce]:EXTernal:DELay Alias [:SOURce]:SIGNal[1]:WAVeform:TRIGger[:SOURce]:EXTernal:DELay to :SOURce:GROup1:SIGNal1:TRIGger[:SOURce]:EXTernal:DELay Alias [:SOURce]:SIGNal2:WAVeform:TRIGger[:SOURce]:EXTernal:DELay to :SOURce:GROup2:SIGNal1:TRIGger[:SOURce]:EXTernal:DELay |
Initial S/W Revision |
A.01.00 |
Modified S/W Revision |
A.09.00 Added :GROup keyword, moved subsystem up so as not to be specific to Signal Mode A.10.00 changed M9484C Resolution to 333.33333… ps |
Remote command only.
This SCPI command is provided for compatibility with other Keysight signal generators. The command is accepted without producing an error, and the value is retained, however it performs no action in the VXG signal generator.
GUI Location |
Signals > Trigger > Hold Off |
SCPI Command |
[:SOURce]:GROup<group>:SIGNal<signal>:TRIGger[:SOURce]:EXTernal:HOLDoff <time> [:SOURce]:GROup<group>:SIGNal<signal>:TRIGger[:SOURce]:EXTernal:HOLDoff? |
SCPI Example |
GRO:SIGN:TRIG:EXT:HOLD 500ms GRO:SIGN:TRIG:EXT:HOLD? |
Preset |
1 ms |
State Saved |
Yes |
Min |
4 ns |
Max |
10 s |
Resolution |
1 ns |
Backwards Compatibility SCPI |
The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. Alias [:SOURce]:SIGNal[1]:CMODulation:TRIGger[:SOURce]:EXTernal:HOLDoff to :SOURce:GROup1:SIGNal1:TRIGger[:SOURce]:EXTernal:HOLDoff Alias [:SOURce]:SIGNal2:CMODulation:TRIGger[:SOURce]:EXTernal:HOLDoff to :SOURce:GROup2:SIGNal1:TRIGger[:SOURce]:EXTernal:HOLDoff Alias [:SOURce]:SIGNal[1]:MTONe:TRIGger[:SOURce]:EXTernal:HOLDoff to :SOURce:GROup1:SIGNal1:TRIGger[:SOURce]:EXTernal:HOLDoff Alias [:SOURce]:SIGNal2:MTONe:TRIGger[:SOURce]:EXTernal:HOLDoff to :SOURce:GROup2:SIGNal1:TRIGger[:SOURce]:EXTernal:HOLDoff Alias [:SOURce]:SIGNal[1]:NR5G:TRIGger[:SOURce]:EXTernal:HOLDoff to :SOURce:GROup1:SIGNal1:TRIGger[:SOURce]:EXTernal:HOLDoff Alias [:SOURce]:SIGNal2:NR5G:TRIGger[:SOURce]:EXTernal:HOLDoff to :SOURce:GROup2:SIGNal1:TRIGger[:SOURce]:EXTernal:HOLDoff Alias [:SOURce]:SIGNal[1]:WAVeform:TRIGger[:SOURce]:EXTernal:HOLDoff to :SOURce:GROup1:SIGNal1:TRIGger[:SOURce]:EXTernal:HOLDoff Alias [:SOURce]:SIGNal2:WAVeform:TRIGger[:SOURce]:EXTernal:HOLDoff to :SOURce:GROup2:SIGNal1:TRIGger[:SOURce]:EXTernal:HOLDoff |
Initial S/W Revision |
A.01.00 |
Modified S/W Revision |
A.09.00 Added :GROup keyword, moved subsystem up so as not to be specific to Signal Mode |
Remote command only.
Triggers the signal when Trigger Source is set to BUS.
This command generates errors with the following cases:
:SOURce:SIGNal2:WAVeform:TRIGger:IMMediate is used in 2 Tx Coherent Configuration
When Trigger Source is not BUS
Synchronization Role is set to Secondary
A different Signal Mode is selected
SCPI Command |
[:SOURce]:GROup<group>:SIGNal<signal>:TRIGger:IMMediate |
SCPI Example |
GRO:SIGN:TRIG:IMM |
Backwards Compatibility SCPI |
The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. Alias [:SOURce]:SIGNal[1]:CMODulation:TRIGger:IMMediate to :SOURce:GROup1:SIGNal1:TRIGger:IMMediate Alias [:SOURce]:SIGNal2:CMODulation:TRIGger:IMMediate to :SOURce:GROup2:SIGNal1:TRIGger:IMMediate Alias [:SOURce]:SIGNal[1]:MTONe:TRIGger:IMMediate to :SOURce:GROup1:SIGNal1:TRIGger:IMMediate Alias [:SOURce]:SIGNal2:MTONe:TRIGger:IMMediate to :SOURce:GROup2:SIGNal1:TRIGger:IMMediate Alias [:SOURce]:SIGNal[1]:NR5G:TRIGger:IMMediate to :SOURce:GROup1:SIGNal1:TRIGger:IMMediate Alias [:SOURce]:SIGNal2:NR5G:TRIGger:IMMediate to :SOURce:GROup2:SIGNal1:TRIGger:IMMediate Alias [:SOURce]:SIGNal[1]:WAVeform:TRIGger:IMMediate to :SOURce:GROup1:SIGNal1:TRIGger:IMMediate Alias [:SOURce]:SIGNal2:WAVeform:TRIGger:IMMediate to :SOURce:GROup2:SIGNal1:TRIGger:IMMediate |
Initial S/W Revision |
A.02.00 |
Modified S/W Revision |
A.09.00 Added :GROup keyword, moved subsystem up so as not to be specific to Signal Mode |
When using trigger Continuous Mode of Reset & Run, or Single Mode of Restart on Trigger, if an External Trigger signal is received during the waveform playback, the playback continues during the trigger delay. Set Trigger Delay Blanking On to suppress playback during the delay period.
For the M9484C, the external trigger delay blanking is on and not changeable.
GUI Location |
Signals > Trigger > Trigger Delay Blanking |
SCPI Command |
[:SOURce]:GROup<group>:SIGNal<signal>:TRIGger[:SOURce]:EXTernal:DELay:RBLanking[:STATe] ON|OFF|1|0 [:SOURce]:GROup<group>:SIGNal<signal>:TRIGger[:SOURce]:EXTernal:DELay:RBLanking[:STATe]? |
SCPI Example |
GRO:SIGN:TRIG:EXT:DEL:RBL ON |
Notes |
For the M9484C, Trigger Delay Blanking is ON and not changeable. Standard SCPI error is generated when OFF is attempted. |
Preset |
For the M9383B/M9384B: OFF For the M9484C: ON |
State Saved |
Yes |
Choices |
OFF | ON |
Backwards Compatibility SCPI |
The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. Alias [:SOURce]:SIGNal[1]:CMODulation:TRIGger[:SOURce]:EXTernal:DELay:RBLanking[:STATe] to :SOURce:GROup1:SIGNal1:TRIGger[:SOURce]:EXTernal:DELay:RBLanking[:STATe] Alias [:SOURce]:SIGNal2:CMODulation:TRIGger[:SOURce]:EXTernal:DELay:RBLanking[:STATe] to :SOURce:GROup2:SIGNal1:TRIGger[:SOURce]:EXTernal:DELay:RBLanking[:STATe] Alias [:SOURce]:SIGNal[1]:MTONe:TRIGger[:SOURce]:EXTernal:DELay:RBLanking[:STATe] to :SOURce:GROup1:SIGNal1:TRIGger[:SOURce]:EXTernal:DELay:RBLanking[:STATe] Alias [:SOURce]:SIGNal2:MTONe:TRIGger[:SOURce]:EXTernal:DELay:RBLanking[:STATe] to :SOURce:GROup2:SIGNal1:TRIGger[:SOURce]:EXTernal:DELay:RBLanking[:STATe] Alias [:SOURce]:SIGNal[1]:NR5G:TRIGger[:SOURce]:EXTernal:DELay:RBLanking[:STATe] to :SOURce:GROup1:SIGNal1:TRIGger[:SOURce]:EXTernal:DELay:RBLanking[:STATe] Alias [:SOURce]:SIGNal2:NR5G:TRIGger[:SOURce]:EXTernal:DELay:RBLanking[:STATe] to :SOURce:GROup2:SIGNal1:TRIGger[:SOURce]:EXTernal:DELay:RBLanking[:STATe] Alias [:SOURce]:SIGNal[1]:WAVeform:TRIGger[:SOURce]:EXTernal:DELay:RBLanking[:STATe] to :SOURce:GROup1:SIGNal1:TRIGger[:SOURce]:EXTernal:DELay:RBLanking[:STATe] Alias [:SOURce]:SIGNal2:WAVeform:TRIGger[:SOURce]:EXTernal:DELay:RBLanking[:STATe] to :SOURce:GROup2:SIGNal1:TRIGger[:SOURce]:EXTernal:DELay:RBLanking[:STATe] |
Initial S/W Revision |
A.04.00 |
Modified S/W Revision |
A.09.00 Added :GROup keyword, moved subsystem up so as not to be specific to Signal Mode |
In cases where playback synchronization with another instrument or device under test is desired, enable external-trigger Playback Synchronization to ensure that the output signal is synchronous to the trigger event. Waveform samples will be skipped until internal processing is complete and playback commences. Playback Synchronization applies when Trigger Source is External, or the Global Trigger Source is External, Trigger Mode is set to Continuous and Continuous Mode is set to Trigger & Run.
GUI Location |
Signal > Trigger > Trigger Source set to External > Playback Synchronization |
SCPI Command |
[:SOURce]:GROup<group>:SIGNal<signal>:TRIGger[:SOURce]:EXTernal:SYNChronize:OUTPut ON|OFF|1|0 [:SOURce]:GROup<group>:SIGNal<signal>:TRIGger[:SOURce]:EXTernal:SYNChronize:OUTPut? |
SCPI Example |
GRO:SIGNal:TRIG:EXT:SYNC:OUTP ON GRO:SIGNal:TRIG:EXT:SYNC:OUTP? |
Couplings |
Only applied when Trigger Source is set to External, or Global Trigger Source is set to External, Trigger Mode is set to Continuous, and Continuous Mode is set to Trigger & Run. |
Preset |
OFF |
State Saved |
Yes |
Choices |
OFF | ON |
Notes |
|
Backwards Compatibility SCPI |
The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. Alias [:SOURce]:SIGNal[1]:CMODulation:TRIGger[:SOURce]:EXTernal:SYNChronize:OUTPut to :SOURce:GROup1:SIGNal1:TRIGger[:SOURce]:EXTernal:SYNChronize:OUTPut Alias [:SOURce]:SIGNal2:CMODulation:TRIGger[:SOURce]:EXTernal:SYNChronize:OUTPut to :SOURce:GROup2:SIGNal1:TRIGger[:SOURce]:EXTernal:SYNChronize:OUTPut Alias [:SOURce]:SIGNal[1]:MTONe:TRIGger[:SOURce]:EXTernal:SYNChronize:OUTPut to :SOURce:GROup1:SIGNal1:TRIGger[:SOURce]:EXTernal:SYNChronize:OUTPut Alias [:SOURce]:SIGNal2:MTONe:TRIGger[:SOURce]:EXTernal:SYNChronize:OUTPut to :SOURce:GROup2:SIGNal1:TRIGger[:SOURce]:EXTernal:SYNChronize:OUTPut Alias [:SOURce]:SIGNal[1]:NR5G:TRIGger[:SOURce]:EXTernal:SYNChronize:OUTPut to :SOURce:GROup1:SIGNal1:TRIGger[:SOURce]:EXTernal:SYNChronize:OUTPut Alias [:SOURce]:SIGNal2:NR5G:TRIGger[:SOURce]:EXTernal:SYNChronize:OUTPut to :SOURce:GROup2:SIGNal1:TRIGger[:SOURce]:EXTernal:SYNChronize:OUTPut Alias [:SOURce]:SIGNal[1]:WAVeform:TRIGger[:SOURce]:EXTernal:SYNChronize:OUTPut to :SOURce:GROup1:SIGNal1:TRIGger[:SOURce]:EXTernal:SYNChronize:OUTPut Alias [:SOURce]:SIGNal2:WAVeform:TRIGger[:SOURce]:EXTernal:SYNChronize:OUTPut to :SOURce:GROup2:SIGNal1:TRIGger[:SOURce]:EXTernal:SYNChronize:OUTPut |
Initial S/W Revision |
A.05.00 |
Modified S/W Revision |
A.09.00 Added :GROup keyword, moved subsystem up so as not to be specific to Signal Mode A.10.00 Added operation with Global Trigger |
See also, How Playback Synchronization Works.
Clears the phase accumulation resulting from a non-zero frequency offset.
When using frequency offset, dynamic range is managed by the instrument to reduce DAC overrange. Phase Accumulator Reset restores the dynamic range when the frequency offset is set to zero.
When the baseband Frequency Offset is non-zero, the hardware rotator accumulates phase shift of the baseband signal. This residual phase remains even after the offset value is returned to zero. While there is a non-zero residual phase present in the signal, the instrument will automatically prevent DAC overrange errors from occurring by scaling the signal down by 1/square root of 2.
GUI Location |
Signals > Phase Accumulator Reset |
SCPI Command |
[:SOURce]:GROup<group>:SIGNal<signal>:FREQuency:OFFSet:PHASe:RESet |
SCPI Example |
GRO:SIGN:FREQ:OFFS:PHAS:RES |
Backwards Compatibility SCPI |
The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. [:SOURce]:RADio[1]:ARB:BASeband:FREQuency:OFFSet:PHASe:RESet Alias [:SOURce]:SIGNal[1]:FREQuency:OFFSet:PHASe:RESet to :SOURce:GROup1:SIGNal1:FREQuency:OFFSet:PHASe:RESet Alias [:SOURce]:SIGNal2:FREQuency:OFFSet:PHASe:RESet to :SOURce:GROup2:SIGNal1:FREQuency:OFFSet:PHASe:RESet |
Notes |
This command clears the phase accumulation and thus zeros the phase shift. For M9484Cwith Option 8SG: This command only performs a reset if the signal’s frequency offset is 0 Hz. If more than one signal is active at the same time and any have a non-zero frequency offset, all of the signals will still be scaled down by 1/square root of 2. |
Initial S/W Revision |
A.08.00 |
Modified S/W Revision |
A.09.00 Added :GROup keyword |
Sets the frequency offset for the vector modulation on the indicated Signal. The offset is the distance from the channel’s RF center frequency to the center of the modulation bandwidth. If you set frequency offset to a non-zero value, and then return the offset to zero hertz, it is recommended you perform Reset Phase Accumulator.
GUI Location |
Signals > Frequency Offset |
SCPI Command |
[:SOURce]:GROup<group>:SIGNal<signal>:FREQuency:OFFSet <frequency> [:SOURce]:GROup<group>:SIGNal<signal>:FREQuency:OFFSet? |
SCPI Example |
GRO:SIGN:FREQ:OFFS 25 MHz GRO:SIGN:FREQ:OFFS? |
Preset |
0 |
Couplings |
For M9383B VXG-m and M9384B VXG only: If CW Interferer is ON and the Frequency Offset is set to a non-zero value, CW Interferer is set to OFF and a Settings Conflict error message is generated. |
Notes |
Attempting to set Frequency Offset to non-zero Hz while CW interferer is ON raises the error -221, "Settings conflict; Baseband Frequency Offset cannot be used when CW Interferer is ON." |
State Saved |
Yes |
Min |
For M9383B/M9384B: Options D20, D21, D2E = -1000 MHz Options D10, D11, D1E = -512 MHz Options D05, D06 = -250 MHz For M9484C: Options R25, R2E = -1250 MHz Options R10, R1E = -512 MHz Options B5X = -250 MHz Options B2X = -125 MHz Options B1X = -80 MHz |
Max |
For M9383B/M9384B: Options D20, D21, D2E = 1000 MHz Options D10, D11, D1E = 512 MHz Options D05, D06 = 250 MHz For M9484C: Options R25, R2E = 1250 MHz Options R10, R1E = 512 MHz Options B5X = 250 MHz Options B2X = 125 MHz Options B1X = 80 MHz |
Resolution |
0.00001 Hz |
Backwards Compatibility SCPI |
The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. [:SOURce]:RADio[1]:ARB:BASeband:FREQuency:OFFSet Alias [:SOURce]:SIGNal[1]:FREQuency:OFFSet to :SOURce:GROup1:SIGNal1:FREQuency:OFFSet Alias [:SOURce]:SIGNal2:FREQuency:OFFSet to :SOURce:GROup2:SIGNal1:FREQuency:OFFSet |
Initial S/W Revision |
A.08.00 |
Modified S/W Revision |
A.09.00 Added :GROup keyword |
In this mode, the signal generator modulates the RF carrier with three types of analog modulation: amplitude, frequency and phase.
Sets the analog modulation type to Amplitude, Frequency, or Phase modulation.
GUI Location |
Signals > Mode set to Analog Modulation > Modulation Type |
SCPI Command |
[:SOURce]:GROup<group>:SIGNal<signal>:AMODulation:TYPE AM|FM|PM [:SOURce]:GROup<group>:SIGNal<signal>:AMODulation:TYPE? |
SCPI Example |
GRO:SIGN:AMOD:TYPE AM GRO:SIGN:AMOD:TYPE? |
Preset |
AM |
Choices |
AM | FM | PM |
State Saved |
Yes |
Backwards Compatibility SCPI |
The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. Alias [:SOURce]:SIGNal[1]:AMODulation:TYPE to :SOURce:GROup1:SIGNal1:AMODulation:TYPE Alias [:SOURce]:SIGNal2:AMODulation:TYPE to :SOURce:GROup2:SIGNal1:AMODulation:TYPE |
Initial S/W Revision |
A.01.00 |
Modified S/W Revision |
A.09.00 Added :GROup keyword |
Sets the AM waveform type.
GUI Location |
Signals > Mode set to Analog Modulation > Modulation Type > AM > Waveform |
SCPI Command |
[:SOURce]:GROup<group>:SIGNal<signal>:AM:SHAPe SINE|DUAL|TRIangle|RUP|RDOWn|SQUare [:SOURce]:GROup<group>:SIGNal<signal>:AM:SHAPe? |
SCPI Example |
GRO:SIGN:AM:SHAP TRI GRO:SIGN:AM:SHAP? |
Preset |
SINE |
State Saved |
Yes |
Choices |
Sine | Dual-sine | Triangle | Ramp Up | Ramp Down | Square |
Backwards Compatibility SCPI |
The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. Alias [:SOURce]:SIGNal[1]:AM:SHAPe to :SOURce:GROup1:SIGNal1:AM:SHAPe Alias [:SOURce]:SIGNal2:AM:SHAPe to :SOURce:GROup2:SIGNal1:AM:SHAPe |
Initial S/W Revision |
A.01.00 |
Modified S/W Revision |
A.09.00 Added :GROup keyword |
Sets the rate of modulation for the AM mode.
GUI Location |
Signals > Mode set to Analog Modulation > Modulation Type set to AM > Rate |
SCPI Command |
[:SOURce]:GROup<group>:SIGNal<signal>:AM:FREQuency <freq> [:SOURce]:GROup<group>:SIGNal<signal>:AM:FREQuency? |
SCPI Example |
GRO:SIGN:AM:FREQ 10.5 kHz GRO:SIGN:AM:FREQ? |
Preset |
10 kHz |
State Saved |
Yes |
Min |
1 Hz |
Max |
Sine: Bandwidth/2 Others: Bandwidth/16 For bandwidth, see Vector Modulation Bandwidth Limitations. |
Backwards Compatibility SCPI |
The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. Alias [:SOURce]:SIGNal[1]:AM:FREQuency to :SOURce:GROup1:SIGNal1:AM:FREQuency Alias [:SOURce]:SIGNal2:AM:FREQuency to :SOURce:GROup2:SIGNal1:AM:FREQuency |
Initial S/W Revision |
A.01.00 |
Modified S/W Revision |
A.09.00 Added :GROup keyword |
Sets rate (frequency) for the second sine of Dual-Sine.
GUI Location |
Signals > Mode set to Analog Modulation > Modulation Type set to AM > Waveform set to Dual-Sine > Rate 2 |
SCPI Command |
[:SOURce]:GROup<group>:SIGNal<signal>:AM:DSINe:FREQuency <freq> [:SOURce]:GROup<group>:SIGNal<signal>:AM:DSINe:FREQuency? |
SCPI Example |
GRO:SIGN:AM:DSIN:FREQ 10.5 kHz GRO:SIGN:AM:DSIN:FREQ? |
Preset |
10 kHz |
State Saved |
Yes |
Min |
1 Hz |
Max |
Bandwidth/16 For bandwidth, see Vector Modulation Bandwidth Limitations. |
Backwards Compatibility SCPI |
The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. Alias [:SOURce]:SIGNal[1]:AM:DSINe:FREQuency to :SOURce:GROup1:SIGNal1:AM:DSINe:FREQuency Alias [:SOURce]:SIGNal2:AM:DSINe:FREQuency to :SOURce:GROup2:SIGNal1:AM:DSINe:FREQuency |
Initial S/W Revision |
A.01.00 |
Modified S/W Revision |
A.09.00 Added :GROup keyword |
Sets the modulation depth for the AM mode in percent.
GUI Location |
Signals > Mode set to Analog Modulation > Modulation Type set to AM > Depth |
SCPI Command |
[:SOURce]:GROup<group>:SIGNal<signal>:AM[:DEPTh] <real> [:SOURce]:GROup<group>:SIGNal<signal>:AM[:DEPTh]? |
SCPI Example |
GRO:SIGN:AM 30 GRO:SIGN:AM? |
Preset |
50 |
State Saved |
Yes |
Min |
0 |
Max |
100 |
Backwards Compatibility SCPI |
The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. Alias [:SOURce]:SIGNal[1]:AM[:DEPTh] to :SOURce:GROup1:SIGNal1:AM[:DEPTh] Alias [:SOURce]:SIGNal2:AM[:DEPTh] to :SOURce:GROup2:SIGNal1:AM[:DEPTh] |
Initial S/W Revision |
A.01.00 |
Modified S/W Revision |
A.09.00 Added :GROup keyword |
Sets relative amplitude for the second sine of a Dual-Sine waveform.
GUI Location |
Signals > Mode set to Analog Modulation > Modulation Type > AM > Waveform set to Dual-Sine > Amplitude 2 |
SCPI Command |
[:SOURce]:GROup<group>:SIGNal<signal>:AM:DSINe:AMPLitude:PERCent <real> [:SOURce]:GROup<group>:SIGNal<signal>:AM:DSINe:AMPLitude:PERCent? |
SCPI Example |
GRO:SIGN:AM:DSIN:AMPL:PERC 5 GRO:SIGN:AM:DSIN:AMPL:PERC? |
Preset |
50 |
State Saved |
Yes |
Min |
0 |
Max |
100 |
Initial S/W Revision |
A.01.00 |
Backwards Compatibility SCPI |
The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. Alias [:SOURce]:SIGNal[1]:AM:DSINe:AMPLitude:PERCent to :SOURce:GROup1:SIGNal1:AM:DSINe:AMPLitude:PERCent Alias [:SOURce]:SIGNal2:AM:DSINe:AMPLitude:PERCent to :SOURce:GROup2:SIGNal1:AM:DSINe:AMPLitude:PERCent |
Initial S/W Revision |
A.01.00 |
Modified S/W Revision |
A.09.00 Added :GROup keyword |
Sets the FM waveform type.
GUI Location |
Signals > Mode set to Analog Modulation > Modulation Type FM > Waveform |
SCPI Command |
[:SOURce]:GROup<group>:SIGNal<signal>:FM:SHAPe SINE|DUAL|TRIangle|RUP|RDOWn|SQUare [:SOURce]:GROup<group>:SIGNal<signal>:FM:SHAPe? |
SCPI Example |
GRO:SIGN:FM:SHAP TRI GRO:SIGN:FM:SHAP? |
Preset |
SINE |
State Saved |
Yes |
Choices |
Sine | Dual-sine | Triangle | Ramp Up | Ramp Down | Square |
Backwards Compatibility SCPI |
The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. Alias [:SOURce]:SIGNal[1]:FM:SHAPe to :SOURce:GROup1:SIGNal1:FM:SHAPe Alias [:SOURce]:SIGNal2:FM:SHAPe to :SOURce:GROup2:SIGNal1:FM:SHAPe |
Initial S/W Revision |
A.01.00 |
Modified S/W Revision |
A.09.00 Added :GROup keyword |
Sets the rate of modulation for the FM mode.
GUI Location |
Signals > Mode set to Analog Modulation > Modulation Type set to FM > Rate |
SCPI Command |
[:SOURce]:GROup<group>:SIGNal<signal>:FM:FREQuency <freq> [:SOURce]:GROup<group>:SIGNal<signal>:FM:FREQuency? |
SCPI Example |
GRO:SIGN:FM:FREQ 10.5 kHz GRO:SIGN:FM:FREQ? |
Preset |
10 kHz |
State Saved |
Yes |
Min |
1 Hz |
Max |
Sine: Bandwidth/4 Others: Bandwidth/16 For bandwidth, see Vector Modulation Bandwidth Limitations. |
Backwards Compatibility SCPI |
The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. Alias [:SOURce]:SIGNal[1]:FM:FREQuency to :SOURce:GROup1:SIGNal1:FM:FREQuency Alias [:SOURce]:SIGNal2:FM:FREQuency to :SOURce:GROup2:SIGNal1:FM:FREQuency |
Initial S/W Revision |
A.01.00 |
Modified S/W Revision |
A.09.00 Added :GROup keyword |
Sets the FM Rate for a the second sine of a Dual-Sine waveform.
GUI Location |
Signals > Mode set to Analog Modulation > Modulation Type set to FM > Waveform set to Dual-Sine > Rate 2 |
SCPI Command |
[:SOURce]:GROup<group>:SIGNal<signal>:FM:DSINe:FREQuency <freq> [:SOURce]:GROup<group>:SIGNal<signal>:FM:DSINe:FREQuency? |
SCPI Example |
GRO:SIGN:FM:DSIN:FREQ 10.5 kHz GRO:SIGN:FM:DSIN:FREQ? |
Preset |
10 kHz |
State Saved |
Yes |
Min |
1 Hz |
Max |
Bandwidth/16 For bandwidth, see Vector Modulation Bandwidth Limitations. |
Backwards Compatibility SCPI |
The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. Alias [:SOURce]:SIGNal[1]:FM:DSINe:FREQuency to :SOURce:GROup1:SIGNal1:FM:DSINe:FREQuency Alias [:SOURce]:SIGNal2:FM:DSINe:FREQuency to :SOURce:GROup2:SIGNal1:FM:DSINe:FREQuency |
Initial S/W Revision |
A.01.00 |
Modified S/W Revision |
A.09.00 Added :GROup keyword |
Sets the frequency modulation deviation.
GUI Location |
Signals > Mode set to Analog Modulation > Modulation Type set to FM > Deviation |
SCPI Command |
[:SOURce]:GROup<group>:SIGNal<signal>:FM[:DEViation] <freq> [:SOURce]:GROup<group>:SIGNal<signal>:FM[:DEViation]? |
SCPI Example |
GRO:SIGN:FM 20 GRO:SIGN:FM? |
Preset |
0.5 Hz |
State Saved |
Yes |
Min |
0 Hz |
Max |
50 MHz |
Backwards Compatibility SCPI |
The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. Alias [:SOURce]:SIGNal[1]:FM[:DEViation] to :SOURce:GROup1:SIGNal1:FM[:DEViation] Alias [:SOURce]:SIGNal2:FM[:DEViation] to :SOURce:GROup2:SIGNal1:FM[:DEViation] |
Initial S/W Revision |
A.01.00 |
Modified S/W Revision |
A.09.00 Added :GROup keyword |
Sets relative amplitude for the second sine of a Dual-Sine waveform.
GUI Location |
Signals > Mode set to Analog Modulation > Modulation Type set to FM > Waveform set to Dual-Sine > Amplitude 2 |
SCPI Command |
[:SOURce]:GROup<group>:SIGNal<signal>:FM:DSINe:AMPLitude:PERCent <real> [:SOURce]:GROup<group>:SIGNal<signal>:FM:DSINe:AMPLitude:PERCent? |
SCPI Example |
GRO:SIGN:FM:DSIN:AMPL:PERC 5 GRO:SIGN:FM:DSIN:AMPL:PERC? |
Preset |
50 |
State Saved |
Yes |
Min |
0 |
Max |
100 |
Backwards Compatibility SCPI |
The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. Alias [:SOURce]:SIGNal[1]:FM:DSINe:AMPLitude:PERCent to :SOURce:GROup1:SIGNal1:FM:DSINe:AMPLitude:PERCent Alias [:SOURce]:SIGNal2:FM:DSINe:AMPLitude:PERCent to :SOURce:GROup2:SIGNal1:FM:DSINe:AMPLitude:PERCent |
Initial S/W Revision |
A.01.00 |
Modified S/W Revision |
A.09.00 Added :GROup keyword |
Sets the PM waveform type .
GUI Location |
Signals > Mode set to Analog Modulation > Modulation Type > PM > Waveform |
SCPI Command |
[:SOURce]:GROup<group>:SIGNal<signal>:PM:SHAPe SINE|DUAL|TRIangle|RUP|RDOWn|SQUare [:SOURce]:GROup<group>:SIGNal<signal>:PM:SHAPe? |
SCPI Example |
GRO:SIGN:PM:SHAP TRI GRO:SIGN:PM:SHAP? |
Preset |
SINE |
State Saved |
Yes |
Choices |
Sine | Dual-sine | Triangle | Ramp Up | Ramp Down | Square |
Backwards Compatibility SCPI |
The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. Alias [:SOURce]:SIGNal[1]:PM:SHAPe to :SOURce:GROup1:SIGNal1:PM:SHAPe Alias [:SOURce]:SIGNal2:PM:SHAPe to :SOURce:GROup2:SIGNal1:PM:SHAPe |
Initial S/W Revision |
A.01.00 |
Modified S/W Revision |
A.09.00 Added :GROup keyword |
Sets the rate of modulation for the PM mode.
GUI Location |
Signals > Mode set to Analog Modulation > Modulation Type set to PM > Rate |
SCPI Command |
[:SOURce]:GROup<group>:SIGNal<signal>:PM:FREQuency <freq> [:SOURce]:GROup<group>:SIGNal<signal>:PM:FREQuency? |
SCPI Example |
GRO:SIGN:PM:FREQ 10.5 kHz GRO:SIGN:PM:FREQ? |
Preset |
10 kHz |
State Saved |
Yes |
Min |
1 Hz |
Max |
Sine: Bandwidth/4 Others: Bandwidth/16 For bandwidth, see Vector Modulation Bandwidth Limitations. |
Backwards Compatibility SCPI |
The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. Alias [:SOURce]:SIGNal[1]:PM:FREQuency to :SOURce:GROup1:SIGNal1:PM:FREQuency Alias [:SOURce]:SIGNal2:PM:FREQuency to :SOURce:GROup2:SIGNal1:PM:FREQuency |
Initial S/W Revision |
A.01.00 |
Modified S/W Revision |
A.09.00 Added :GROup keyword |
Sets the PM Rate for a the second sine of a Dual-Sine waveform.
GUI Location |
Signals > Mode set to Analog Modulation > Modulation Type set to PM > Waveform set to Dual-Sine > Rate 2 |
SCPI Command |
[:SOURce]:GROup<group>:SIGNal<signal>:PM:DSINe:FREQuency <freq> [:SOURce]:GROup<group>:SIGNal<signal>:PM:DSINe:FREQuency? |
SCPI Example |
GRO:SIGN:PM:DSIN:FREQ 10.5 kHz GRO:SIGN:PM:DSIN:FREQ? |
Preset |
10 kHz |
State Saved |
Yes |
Min |
1 Hz |
Max |
Bandwidth/16 For bandwidth, see Vector Modulation Bandwidth Limitations. |
Initial S/W Revision |
A.01.00 |
Backwards Compatibility SCPI |
The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. Alias [:SOURce]:SIGNal[1]:PM:DSINe:FREQuency to :SOURce:GROup1:SIGNal1:PM:DSINe:FREQuency Alias [:SOURce]:SIGNal2:PM:DSINe:FREQuency to :SOURce:GROup2:SIGNal1:PM:DSINe:FREQuency |
Initial S/W Revision |
A.01.00 |
Modified S/W Revision |
A.09.00 Added :GROup keyword |
Sets the phase modulation deviation in radian.
GUI Location |
Signals > Mode set to Analog Modulation > Modulation Type set to PM > Deviation |
SCPI Command |
[:SOURce]:GROup<group>:SIGNal<signal>:PM[:DEViation] <real> [:SOURce]:GROup<group>:SIGNal<signal>:PM[:DEViation]? |
SCPI Example |
GRO:SIGN:PM 7 GRO:SIGN:PM? |
Preset |
0.5 |
State Saved |
Yes |
Min |
0 |
Max |
10 |
Backwards Compatibility SCPI |
The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. Alias [:SOURce]:SIGNal[1]:PM[:DEViation] to :SOURce:GROup1:SIGNal1:PM[:DEViation] Alias [:SOURce]:SIGNal2:PM[:DEViation] to :SOURce:GROup2:SIGNal1:PM[:DEViation] |
Initial S/W Revision |
A.01.00 |
Modified S/W Revision |
A.09.00 Added :GROup keyword |
Sets relative amplitude for the second sine of a Dual-Sine waveform.
GUI Location |
Signals > Mode set to Analog Modulation > Modulation Type set to PM > Waveform set to Dual-Sine > Amplitude 2 |
SCPI Command |
[:SOURce]:GROup<group>:SIGNal<signal>:PM:DSINe:AMPLitude:PERCent <real> [:SOURce]:GROup<group>:SIGNal<signal>:PM:DSINe:AMPLitude:PERCent? |
SCPI Example |
GRO:SIGN:PM:DSIN:AMPL:PERC 5 GRO:SIGN:PM:DSIN:AMPL:PERC? |
Preset |
50 |
State Saved |
Yes |
Min |
0 |
Max |
100 |
Backwards Compatibility SCPI |
The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. Alias [:SOURce]:SIGNal[1]:PM:DSINe:AMPLitude:PERCent to :SOURce:GROup1:SIGNal1:PM:DSINe:AMPLitude:PERCent Alias [:SOURce]:SIGNal2:PM:DSINe:AMPLitude:PERCent to :SOURce:GROup2:SIGNal1:PM:DSINe:AMPLitude:PERCent |
Initial S/W Revision |
A.01.00 |
Modified S/W Revision |
A.09.00 Added :GROup keyword |
This capability requires license model N7621APPC.
The number of samples of a Multitone signal is determined by Tones and Tone Spacing when the required BW is much smaller than the maximum sample rate. However, when the required BW becomes larger and the max Sample Rate needs to be used, the number of samples of Multitone signal is determined mainly by the greatest common divisor (GCD) of the max Sample Rate and Tone Spacing.
For example, assuming the max Sample Rate is 2.56 GHz, if Tones and Tone Spacing are set to 201 and 12,111,111 Hz respectively, the GCD is 1 Hz, which requires the signal to be 1 sec long in time. Therefore 2.56 G samples are required, which is far larger points than the size of internal buffer array (64 M samples). In this case, an error is issued, and Multitone signal is not generated.
If the tone spacing is changed to 12,111,100 Hz, the GCD becomes 100 Hz and the signal length will reduce to 0.01 sec. It is 25.6 M samples and small enough to fit in the buffer.
Remote command only.
This is an action command that imports the tone table data from the multitone file. The multitone file is a text file that consists of four columns separated by spaces, tabs, or commas. The four columns are status, frequency (Hz), relative amplitude (dB) and phase (degree). Only UTF-8 encoding with and without BOM is supported
The following is the example of the multitone file in which five tones are defined with 1.0 MHz spacing. The relative amplitude of tones are all zero.
1 -2000000 0 40.11
1 -1000000 0 167.88
1 0 0 277.88
1 1000000 0 236.63
1 2000000 0 155.84
The multitone file needs to satisfy the following conditions, otherwise it’s rejected with an error message.
The tone frequencies in the file need to be equally spaced. The tone frequencies are rounded to the resolution of Tone Spacing before the check.
The bandwidth of tones, the maximum - the minimum tone frequencies, is less than or equal to the vector modulation bandwidth that varies based on the channel frequency. See Vector Modulation Bandwidth Limitations.
The number of Tones and Tone Spacing need to be within their specified ranges.
The center of tones is at frequency zero.
The tone frequencies are in the ascending order.
The values are separate with a single space. Consecutive multiple spaces are not allowed.
The RMS of generated waveform is not too small. For example, when many tones have the same phase, an error message appears.
The MTONE MSUS can be used to specify the multitone file. See File Location and Default Folders for more details about MTONE MSUS. With MTONE, you can send or select a multitone file as shown below.
:MMEMory:DATA “MTONE:myTones”, ...
:SIGNal:MTONe:ARB:SETup “MTONE:myTones”
SCPI Command |
[:SOURce]:GROup<group>:SIGNal<signal>:MTONe:ARB:SETup "<filename>" |
SCPI Example |
GRO:SIGN:MTON:ARB:SET "MTONE:myTones" |
State Saved |
No |
Backwards Compatibility SCPI |
The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. Alias [:SOURce]:SIGNal[1]:MTONe:ARB:SETup to :SOURce:GROup1:SIGNal1:MTONe:ARB:SETup Alias [:SOURce]:SIGNal2:MTONe:ARB:SETup to :SOURce:GROup2:SIGNal1:MTONe:ARB:SETup |
Initial S/W Revision |
A.08.00 |
Modified S/W Revision |
A.09.00 Added :GROup keyword |
Remote command only.
Query only. Returns values of all tones included in the internal tone table. Values returned for a tone are frequency (Hz), relative amplitude (dB) phase (degree) and state. For example, if the tone table includes 10 tones, 10 x 4 = 40 values are returned.
SCPI Command |
[:SOURce]:GROup<group>:SIGNal<signal>:MTONe:ARB:SETup:TABLe? |
SCPI Example |
MTON:ARB:SET:TABL? |
State Saved |
No |
Backwards Compatibility SCPI |
The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. Alias [:SOURce]:SIGNal[1]:MTONe:ARB:SETup:TABLe? to :SOURce:GROup1:SIGNal1:MTONe:ARB:SETup:TABLe? Alias [:SOURce]:SIGNal2:MTONe:ARB:SETup:TABLe? to :SOURce:GROup2:SIGNal1:MTONe:ARB:SETup:TABLe? |
Initial S/W Revision |
A.08.00 |
Modified S/W Revision |
A.09.00 Added :GROup keyword |
Sets the number of tones. Setting this value regenerates tones with 0 dB amplitude and randomly calculated phases.
Values set with Setup Command are discarded.
GUI Location |
Signals > Mode set to Multitone > Tones |
SCPI Command |
[:SOURce]:GROup<group>:SIGNal<signal>:MTONe:ARB:SETup:TABLe:NTONes <integer> [:SOURce]:GROup<group>:SIGNal<signal>:MTONe:ARB:SETup:TABLe:NTONes? |
SCPI Example |
GRO:SIGN:MTON:ARB:SET:TABL:NTON 2 GRO:SIGN:MTON:ARB:SET:TABL:NTON? |
Preset |
4 |
State Saved |
Yes |
Min |
2 |
Max |
200001 |
Resolution |
1 |
Backwards Compatibility SCPI |
The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. [:SOURce ]:SIGNal<signal>:MTONe:ARB:NTONes [:SOURce]:SIGNal<signal>:MTONe:ARB:NTONes? Alias [:SOURce]:SIGNal[1]:MTONe:ARB:SETup:TABLe:NTONes to :SOURce:GROup1:SIGNal1:MTONe:ARB:SETup:TABLe:NTONes Alias [:SOURce]:SIGNal2:MTONe:ARB:SETup:TABLe:NTONes to :SOURce:GROup2:SIGNal1:MTONe:ARB:SETup:TABLe:NTONes Alias [:SOURce]:SIGNal[1]:MTONe:ARB:NTONes to :SOURce:GROup1:SIGNal1:MTONe:ARB:NTONes Alias [:SOURce]:SIGNal2:MTONe:ARB:NTONes to :SOURce:GROup2:SIGNal1:MTONe:ARB:NTONes |
Initial S/W Revision |
A.01.00 |
Modified S/W Revision |
A.08.00 Changed the SCPI command from [:SOURce]:SIGNal<signal>:MTONe:ARB:NTONes, changed max from 1000 A.09.00 Added :GROup keyword |
Sets the frequency spacing between the tones. Setting this value regenerates tones with 0 dB amplitude and randomly calculated phases.
Values set with Setup Command are discarded.
GUI Location |
Signals > Mode set to Multitone > Tone Spacing |
SCPI Command |
[:SOURce]:GROup<group>:SIGNal<signal>:MTONe:ARB:SETup:TABLe:FSPacing <freq> [:SOURce]:GROup<group>:SIGNal<signal>:MTONe:ARB:SETup:TABLe:FSPacing? |
SCPI Example |
GRO:SIGN:MTON:ARB:SET:TABL:FSP 128 GRO:SIGN:MTON:ARB:SET:TABL? |
Preset |
10 kHz |
State Saved |
Yes |
Min |
100 Hz |
Max |
Floor((Bandwidth in Vector Modulation Bandwidth Limitations)/((Number of Tones) - 1)/100) * 100 |
Resolution |
0.00001 Hz |
Backwards Compatibility SCPI |
[:SOURce]:SIGNal<signal>:MTONe:ARB:FSPacing <freq> [:SOURce]:SIGNal<signal>:MTONe:ARB:FSPacing? |
History |
Changed the SCPI command from [:SOURce]:SIGNal<signal>:MTONe:ARB:FSPacing at A.08.00 |
Backwards Compatibility SCPI |
The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. Alias [:SOURce]:SIGNal[1]:MTONe:ARB:SETup:TABLe:FSPacing to :SOURce:GROup1:SIGNal1:MTONe:ARB:SETup:TABLe:FSPacing Alias [:SOURce]:SIGNal2:MTONe:ARB:SETup:TABLe:FSPacing to :SOURce:GROup2:SIGNal1:MTONe:ARB:SETup:TABLe:FSPacing Alias [:SOURce]:SIGNal[1]:MTONe:ARB:FSPacing to :SOURce:GROup1:SIGNal1:MTONe:ARB:FSPacing Alias [:SOURce]:SIGNal2:MTONe:ARB:FSPacing to :SOURce:GROup2:SIGNal1:MTONe:ARB:FSPacing |
Initial S/W Revision |
A.01.00 |
Modified S/W Revision |
A.08.00 Changed the SCPI command from [:SOURce]:SIGNal<signal>:MTONe:ARB:FSPacing A.09.00 Added :GROup keyword |
Single Tone generates a single CW tone at a specified offset to the channel’s RF Frequency. This capability requires license model N7621APPC.
Sets the frequency of a single CW tone with respect to the channel’s RF Frequency.
GUI Location |
Signals > Mode set to Single Tone |
SCPI Command |
[:SOURce]:GROup<group>:SIGNal<signal>:SSB:FREQuency <freq> [:SOURce]:GROup<group>:SIGNal<signal>:SSB:FREQuency? |
SCPI Example |
GRO:SIGN:SSB:FREQ 10.5 kHz GRO:SIGN:SSB:FREQ? |
Preset |
10 kHz |
State Saved |
Yes |
Min |
-(Bandwidth/2) For bandwidth, see Vector Modulation Bandwidth Limitations. |
Max |
Bandwidth/2 For bandwidth, see Vector Modulation Bandwidth Limitations. |
Backwards Compatibility SCPI |
The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. Alias [:SOURce]:SIGNal[1]:SSB:FREQuency to :SOURce:GROup1:SIGNal1:SSB:FREQuency Alias [:SOURce]:SIGNal2:SSB:FREQuency to :SOURce:GROup2:SIGNal1:SSB:FREQuency |
Initial S/W Revision |
A.01.00 |
Modified S/W Revision |
A.09.00 Added :GROup keyword |
Launches the selected Signal Studio application. All available Signal Studio applications are listed for the instrument.
Signal Studio applications, such as Custom Modulation (N7608C) support auto configuration. If Signal Studio supports auto configuration, it is automatically connected to the specified Signal of localhost VXG when launched from this control. For example, when it’s launched from the Signal block of Ch2, it is connected to Ch2. For Signal Studio applications that do not support auto configuration the VXG is not automatically connected and must be done manually.
For 2-channel instruments:
If the selected Signal Studio application is already running on one of the channels, the existing Signal Studio is used instead of starting a new instance.
If the instance of Signal Studio is already running on a channel (for example, channel 1), and you wish to use the other channel (channel 2), close the existing instance and relaunch a new instance from the other channel (channel 2).
GUI Location |
Signals > Signal Studio > Launch |
Notes |
There is no equivalent SCPI command, this is a GUI function only. |
Initial S/W Revision |
A.02.00 |
Modified S/W Revision |
A.11.50 - Updated for M9484C |
Allows you to select waveform data to play. Both waveform data in ARB memory and non-volatile memory can be selected.
If you have Option 8SG, waveform files assigned to the same signal group must have unique file names. The ARB waveform memory references the file name alone and does not distinguish between different directories. For more information, refer to ARB Waveform Memory.
When waveform data in non-volatile memory is selected, it first uploads the data to the ARB memory and the uploaded data is played. The data in non-volatile memory can be specified either with a path to the file or MSUS for non-volatile waveform data. i.e. "SNVWFM" and "NVWFM."
Waveform on the arb memory can be selected either with "SWFMn" or "WFMn." See also ARB Waveform Memory.
Even when the file with the same name on the non-volatile memory is selected, the waveform is uploaded to the arb memory.
When a filename that does not exist is given to this command, the value is not updated and -257, "File name error" is issued. Setting an empty string, e.g. GRO:SIGN:WAV "", ends up with the same result. The value isn’t changed, and the error is issued.
File names and file paths must comprise ASCII characters only. Otherwise, a "File name not found" error occurs. In addition, a file name cannot contain a comma or a semicolon.
See Supported File Formats below.
GUI Location |
Signals > Mode set to Waveform File > File |
SCPI Command |
[:SOURce]:GROup<group>:SIGNal<signal>:WAVeform[:SELect] <string> [:SOURce]:GROup<group>:SIGNal<signal>:WAVeform[:SELect]? |
SCPI Example |
GRO:SIGN:WAV "wav1.wfm" GRO:SIGN:WAV? |
Preset |
"" |
State Saved |
Yes |
Backwards Compatibility SCPI |
The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. Alias [:SOURce]:SIGNal[1]:WAVeform[:SELect] to :SOURce:GROup1:SIGNal1:WAVeform[:SELect] Alias [:SOURce]:SIGNal2:WAVeform[:SELect] to :SOURce:GROup2:SIGNal1:WAVeform[:SELect] |
Initial S/W Revision |
A.01.00 |
Modified S/W Revision |
A.09.00 Added :GROup keyword |
If you use an embedded application (e.g. 5G NR, Custom Modulation) to configure and generate a waveform, clicking Generate automatically saves the waveform configuration as a metadata file along with the generated waveform file. Then whenever the waveform is selected from the Signal Setup screen, the Edit in App button appears next to the File field, providing easy access to the appropriate application with the configuration used to generate this waveform.
Format |
File Extension |
Description |
---|---|---|
Signal Studio |
*.wfm |
Waveforms exported from Keysight Signal Studio applications. |
Keysight 16-bit binary |
*.wiq *.bin *.WAVEFORM |
Contains interleaved I/Q samples (I0, Q0, I1, Q1, …). Values must be stored in 16-bit signed integers. The Default Binary File Format can be set to either Big Endian or Little Endian. See Keysight 16-Bit Binary in the Creating and Downloading Waveforms tutorial. |
ASCII |
*.csv *.txt |
Two floating-point numbers (one for I and the other for Q) delimited by a comma, a tab or a whitespace, should appear in each line. Each line can have more than two values, but only the first two values are read as IQ point data. For example, the csv file may have values for I, Q, Marker1, Marker2, Marker3, and Marker4 in one line. In this case, only the first two values in the line are imported as an IQ point. The rest of the values are discarded. Only UTF-8 encoding with and without BOM is supported. If the max abs value of I or Q is less than or equal to 1.0, no scaling is applied to the IQ data. If it is more than 1.0, the IQ data is normalized with the max abs value of I or Q. |
Sequence |
*.seq |
Created by Keysight signal generators. |
MATLAB |
*.mat |
The MAT file format (version 4, 6, 7, and 7.3) and the HDF5 format are supported. See MATLAB in the Creating and Downloading Waveforms tutorial. |
The waveform header contains waveform properties such as the sample rate and the RMS value.
A secure waveform file (*.wfm) and a sequence file (*.seq) each contain a header. Other files don’t contain a header but an external header file is supported. An external header file must have the same name as the waveform file with an extension of .whd or .HEADER. It must be placed in the same folder as the associated waveform file.
When a waveform file is selected, the following settings are updated:
Sample Rate if specified in the header.
Scale if specified in the header.
RMS
If a value is specified in the header, it is updated to that value. Otherwise,
If a secure waveform file is selected, it is set to 1.0.
If a sequence file is selected and all the waveforms referenced in the header have been uploaded, it is calculated from the RMS value and the length of the waveforms.
If a non-secure waveform file is selected, it’s calculated from the waveform.
Occupied Bandwidth
If a value is specified in the header, it is updated to that value.
If a value is not specified but the Sample Rate is specified in the header, it is updated to that Sample Rate.
Manually updating the Occupied Bandwidth GUI value does not adjust the occupied bandwidth of the waveform. Rather, it sets the frequency span over which the RF flatness correction and dynamic range optimizations occur. See Optimize Dynamic Range with OBW for more information.
ALC Hold Marker Routing if specified in the header.
RF Blanking Marker Routing if specified in the header.
The following table shows MSUS examples.
SCPI command example |
File |
---|---|
GRO:SIGN:WAV "SNVWFM:abc" |
<Documents>\Keysight\PathWave\SignalGenerator\Waveforms\abc.wfm |
GRO:SIGN:WAV "NVWFM:abc" |
<Documents>\Keysight\PathWave\SignalGenerator\Waveforms\abc.wiq |
GRO:SIGN:WAV "SWFM1:abc" |
Waveform "abc" in Ch1 ARB memory |
GRO:SIGN:WAV "WFM1:abc" |
Waveform "abc" in Ch1 ARB memory |
GRO:SIGN:WAV "SWFM2:abc" |
Waveform "abc" in Ch2 ARB memory |
Please note that there is no MSUS for .bin extension. To select a .bin file, relative or absolute path can be used as shown below.
GRO:SIGN:WAV "abc.bin"
Auto folder selection works for this setting in the same way as memory commands, defined in the ARB Waveform Memory topic. See also Auto Folder Selection by Extension in that same topic for details.
With Auto Folder Selection, the folder of waveform file on non-volatile memory is automatically selected by the extension of file name when relative file path is given as command parameter. For example, when
GRO:SIGN:WAV "abc.wfm"
is sent, the software looks at <Documents>\Keysight\PathWave\SignalGenerator\Waveforms\ folder as a location of waveform file.
If the extension is not supported by Auto Folder Selection, the file path is determined based on the default folder, <Documents>\Keysight\PathWave\SignalGenerator.
The following table shows some of waveform file path examples and which folders are selected.
SCPI command example |
Folder |
---|---|
GRO:SIGN:WAV "abc.wfm" |
<Documents>\Keysight\PathWave\SignalGenerator\Waveforms\ |
GRO:SIGN:WAV "myDir\abc.wfm" |
<Documents>\Keysight\PathWave\SignalGenerator\Waveforms\myDir |
GRO:SIGN:WAV "C:\wfm\abc.wfm" |
C:\wfm\ |
GRO:SIGN:WAV "abc.wiq" |
<Documents>\Keysight\PathWave\SignalGenerator\Waveforms\ |
GRO:SIGN:WAV "abc.bin" |
<Documents>\Keysight\PathWave\SignalGenerator\ |
GRO:SIGN:WAV "abc.csv" |
<Documents>\Keysight\PathWave\SignalGenerator\ |
GRO:SIGN:WAV "Waveforms\abc.bin" |
<Documents>\Keysight\PathWave\SignalGenerator\Waveforms\ |
If an inappropriate file extension is used, a non-intuitive folder is selected. The following table shows such examples.
SCPI command example |
Folder |
---|---|
GRO:SIGN:WAV "abc.sgen" |
<Documents>\Keysight\PathWave\SignalGenerator\States\ |
GRO:SIGN:WAV "..\abc.sgen" |
<Documents>\Keysight\PathWave\SignalGenerator |
An .sgen file is usually a state file, in which instrument settings are saved, however, it is possible to create a signal file with .sgen and then select it as a waveform file. For example, you can send your waveform file with
:MMEM:DATA "abc.sgen", …
and select it with
:GRO:SIGN:WAV "abc.sgen"
This works perfectly, however, the file is saved in the "States" folder under the default folder because Auto Folder Detection designates the "States" folder as the location for .sgen files.
If the number of samples in the specified waveform file is smaller than the Segment Length Minimum or is not a multiple of the Waveform Quantum, the VXG can automatically extend it by either repeating the waveform or appending zeros at the end. The extension method can be configured by the Waveform Extension Method. A message is shown if extension occurs.
Waveform files can be of type .wfm, .csv, .txt, .wiq, .bin, .mat, .hdf, .h5, or .bnd. See Supported File Formats below. The file must exist on the instrument’s disk or a mapped network drive (NV or SNV memory); the file cannot be in the instruments volatile memory (SWFM).
Waveforms must be a minimum of 1024 samples and, for the M9384B, the samples must be a multiple of 16.
Use the File Select button to navigate to the file browser.
Within the file browser, select the desired waveform file.
Attempting to use an inappropriate waveform file will result in an error when the file is actually used, not necessarily when the waveform file is selected via the Select button.
File names and file paths must comprise ASCII characters only. Otherwise, a "File name not found" error occurs. In addition, a file name cannot contain a comma or a semicolon.
Format |
File Extension |
Description |
---|---|---|
Signal Studio |
*.wfm |
Waveforms exported from Keysight Signal Studio applications. |
Keysight 16-bit binary |
*.wiq *.bin *.WAVEFORM |
Contains interleaved I/Q samples (I0, Q0, I1, Q1, …). Values must be stored in 16-bit signed integers. The Default Binary File Format can be set to either Big Endian or Little Endian. See Keysight 16-Bit Binary in the Creating and Downloading Waveforms tutorial. |
ASCII |
*.csv *.txt |
Two floating-point numbers (one for I and the other for Q) delimited by a comma, a tab or a whitespace, should appear in each line. Each line can have more than two values, but only the first two values are read as IQ point data. For example, the csv file may have values for I, Q, Marker1, Marker2, Marker3, and Marker4 in one line. In this case, only the first two values in the line are imported as an IQ point. The rest of the values are discarded. Only UTF-8 encoding with and without BOM is supported. If the max abs value of I or Q is less than or equal to 1.0, no scaling is applied to the IQ data. If it is more than 1.0, the IQ data is normalized with the max abs value of I or Q. |
Sequence |
*.seq |
Created by Keysight signal generators. |
MATLAB |
*.mat |
The MAT file format (version 4, 6, 7, and 7.3) and the HDF5 format are supported. See MATLAB in the Creating and Downloading Waveforms tutorial. |
GUI Location |
System Menu > Configure Channels > Bonded > Signals > File |
SCPI Command |
[:SOURce]:GROup<group>:CBONded:WAVeform[:SELect] <string> [:SOURce]:GROup<group>:CBONded:WAVeform[:SELect]? |
SCPI Example |
GRO:CBON:WAV "wav1.wfm" GRO:CBON:WAV? |
Couplings |
If the selected waveform file is not bonded (*.bnd), bonded vector modulation cannot be set to ON. Likewise, if you select a non-bonded waveform file (e.g. *.wfm) while bonded vector modulation is on, it will be turned OFF. |
Preset |
"" |
State Saved |
Yes |
SCPI Change |
[:SOURce]:CBONded<bondingset>:WAVeform[:SELect] <string> has been changed to [:SOURce]:GROup<group>:CBONded:WAVeform[:SELect] <string>. Prior use of :SOUR:CBON:WAV or :SOUR:CBON1:WAV is now :SOUR:GRO1:CBON:WAV. |
Initial S/W Revision |
A.07.00 |
Modified S/W Revision |
A.10.00 Changed SCPI: Added :GROup<group> and removed <bondingset> from :CBONded |
Sets the sample rate of the modulating waveform, accepts frequency units (e.g., 100 MHz).
GUI Location |
Signals > Mode set to Waveform File > Sample Rate |
SCPI Command |
[:SOURce]:GROup<group>:SIGNal<signal>:WAVeform:SCLock:RATE <freq> [:SOURce]:GROup<group>:SIGNal<signal>:WAVeform:SCLock:RATE? |
SCPI Example |
GRO:SIGN:WAV:SCL:RATE 100 MHz GRO:SIGN:WAV:SCL:RATE? |
Preset |
M9383B/M9384B: Option D20/21 = 2.56 GHz, D05/D06 = 625 MHz, D10/11 = 1.28 GHz M9484C: Options R25/R2E = 3.0 GHz, R10/R1E = 1228.8 MHz, B5X = 600 MHz, B2X = 300 MHz, B1X = 200 MHz |
State Saved |
Yes |
Min |
M9383B/M9384B: 1.0 Hz M9484C: 100 Hz |
Max |
M9383B/M9384B: Option D20/21 = 2.56 GHz, D05/D06 = 625 MHz, D10/11 = 1.28 GHz M9484C: Options R25/R2E = 3.0 GHz, R10/R1E = 1228.8 MHz, B5X = 600 MHz, B2X = 300 MHz, B1X = 200 MHz |
Resolution |
0.000001 Hz |
Backwards Compatibility SCPI |
The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. Alias [:SOURce]:SIGNal[1]:WAVeform:SCLock:RATE to :SOURce:GROup1:SIGNal1:WAVeform:SCLock:RATE Alias [:SOURce]:SIGNal2:WAVeform:SCLock:RATE to :SOURce:GROup2:SIGNal1:WAVeform:SCLock:RATE |
Initial S/W Revision |
A.01.00 |
Modified S/W Revision |
A.09.00 Added :GROup keyword |
Sets the sample rate of the bonded modulating waveform, accepts frequency units (e.g., 3.8 GHz).
The value is not editable in a GUI when a Bonded Waveform File is selected
GUI Location |
System Menu > Configure Channels > Bonded > Signals > Sample Rate |
SCPI Command |
[:SOURce]:GROup<group>:CBONded:WAVeform:SCLock:RATE <freq> [:SOURce]:GROup<group>:CBONded:WAVeform:SCLock:RATE? |
SCPI Example |
GRO:CBON:WAV:SCL:RATE 4 GHZ GRO:CBON:WAV:SCL:RATE? |
Preset |
For M9384B Option D20/21 = 5.12 GHz For M9484C Option R25 = 6.0 GHz |
State Saved |
Yes |
Min |
2.0 Hz |
Max |
For M9384B Option D20/21 = 5.12 GHz For M9484C Option R25 = 6.0 GHz |
Resolution |
0.000001 Hz |
SCPI Change |
[:SOURce]:CBONded<bondingset>:WAVeform:SCLock:RATE <freq> has been changed to [:SOURce]:GROup<group>:CBONded:WAVeform:SCLock:RATE <freq>. Prior use of :SOUR:CBON:WAV:SCL:RATE or :SOUR:CBON1:WAV:SCL:RATE is now :SOUR:GRO1:CBON:WAV:SCL:RATE. |
Initial S/W Revision |
A.07.00 |
Modified S/W Revision |
A.10.00 Changed SCPI: Added :GROup<group> and removed <bondingset> from :CBONded |
Sets the RMS on the modulating waveform.
GUI Location | Signals > Mode set to Waveform File > RMS Power |
SCPI Command | [:SOURce]:GROup<group>:SIGNal<signal>:WAVeform:RMS [:SOURce]:GROup<group>:SIGNal<signal>:WAVeform:RMS? |
SCPI Example | GRO:SIGN:WAV:RMS 1 GRO:SIGN:WAV:RMS? |
Preset | 1 |
State Saved | Yes |
Min | 0.1 |
Max | 1.414213562 |
Resolution | 0.000000001 |
Initial S/W Revision | A.01.00 |
Backwards Compatibility SCPI | The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. Alias [:SOURce]:SIGNal[1]:WAVeform:RMS to :SOURce:GROup1:SIGNal1:WAVeform:RMS Alias [:SOURce]:SIGNal2:WAVeform:RMS to :SOURce:GROup2:SIGNal1:WAVeform:RMS |
Initial S/W Revision | A.01.00 |
Modified S/W Revision | A.03.00 A.09.00 Added :GROup keyword |
Sets the RMS of the bonded modulating waveform.
On selection of a file, the RMS setting is automatically updated as follows:
If a .wfm or .bnd file is selected, the value from the file is used.
If a different type of file is selected, a value is calculated from I/Q samples. Consecutive zero samples are ignored following the MXG implementation. See Figure 4-25 in MXG User's Guide (N5180-90056) for details.
You can override the calculated RMS value, however be aware that loading another file, recalling an instrument state, or performing a Preset will change the setting.
The value is not editable in a GUI when a Bonded Waveform File is selected
GUI Location | System Menu > Configure Channels > Bonded > Signals > RMS Power |
SCPI Command | [:SOURce]:GROup<group>:CBONded:WAVeform:RMS [:SOURce]:GROup<group>:CBONded:WAVeform:RMS? |
SCPI Example | GRO:CBON:WAV:RMS 1 GRO:CBON:WAV:RMS? |
Preset | 1 |
State Saved | Yes |
Min | 0.1 |
Max | 1.414213562 |
Resolution | 0.000000001 |
SCPI Change | [:SOURce]:CBONded<bondingset>:WAVeform:RMS <real> has been changed to [:SOURce]:GROup<group>:CBONded:WAVeform:RMS <real>. Prior use of :SOUR:CBON:WAV:RMS or :SOUR:CBON1:WAV:RMS is now :SOUR:GRO1:CBON:WAV:RMS. |
Initial S/W Revision | A.07.00 |
Modified S/W Revision | A.10.00 Changed SCPI: Added :GROup<group> and removed <bondingset> from :CBONded |
Sets the scale factor of the modulating waveform in percent.
GUI Location | Signals > Mode set to Waveform File > Scale |
SCPI Command | [:SOURce]:GROup<group>:SIGNal<signal>:WAVeform:SCALe <real> [:SOURce]:GROup<group>:SIGNal<signal>:WAVeform:SCALe? |
SCPI Example | GRO:SIGN:WAV:SCAL 100 GRO:SIGN:WAV:SCAL? |
Preset | 100 |
State Saved | Yes |
Min | 1 |
Max | 100 |
Resolution | 0.01 |
Initial S/W Revision | A.01.00 |
Backwards Compatibility SCPI | The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. Alias [:SOURce]:SIGNal[1]:WAVeform:SCALe to :SOURce:GROup1:SIGNal1:WAVeform:SCALe Alias [:SOURce]:SIGNal2:WAVeform:SCALe to :SOURce:GROup2:SIGNal1:WAVeform:SCALe |
Initial S/W Revision | A.01.00 |
Modified S/W Revision | A.09.00 Added :GROup keyword |
Set the scale factor of the bonded waveform.
The value is not editable in a GUI when a Bonded Waveform File is selected
GUI Location | System Menu > Configure Channels > Bonded > Signals > Scale |
SCPI Command | [:SOURce]:GROup<group>:CBONded:WAVeform:SCALe <real> [:SOURce]:GROup<group>:CBONded:WAVeform:SCALe? |
SCPI Example | GRO:CBON:WAV:SCAL 100 GRO:CBON:WAV:SCAL? |
Preset | 100 |
State Saved | Yes |
Min | 1 |
Max | 100 |
Resolution | 0.01 |
SCPI Change | [:SOURce]:CBONded<bondingset>:WAVeform:SCALe <real> has been changed to [:SOURce]:GROup<group>:CBONded:WAVeform:SCALe <real>. Prior use of :SOUR:CBON:WAV:SCAL or :SOUR:CBON1:WAV:SCAL is now :SOUR:GRO1:CBON:WAV:SCAL. |
Initial S/W Revision | A.07.00 |
Modified S/W Revision | A.10.00 Changed SCPI: Added :GROup<group> and removed <bondingset> from :CBONded |
Set the occupied bandwidth of vector modulated signal.
Occupied bandwidth is the bandwidth containing 99 percent of the total integrated power of the transmitted spectrum, centered on the assigned channel frequency.
In Waveform File mode, a GUI-entered value does not control the width of the occupied bandwidth. Rather, it sets the frequency span over which the RF flatness correction and dynamic range optimizations occur. See Optimize Dynamic Range with OBW for more information.
GUI Location | Signals > Mode set to Waveform File > Occupied Bandwidth |
SCPI Command | [:SOURce]:GROup<group>:SIGNal<signal>:WAVeform:OBWidth [:SOURce]:GROup<group>:SIGNal<signal>:WAVeform:OBWidth? |
SCPI Example | GRO:SIGN:WAV:OBW 140 kHz GRO:SIGN:WAV:OBW? |
Preset | 0 |
State Saved | Yes |
Min | 0 Hz |
Max | For M9383B/M9384B: Options D20/D21/D2E = 2.048 GHz Options D10/D11 = 1.024 GHz Options D05/D06= 500 MHz For M9484C: Option R25 = 2.5 GHz Option R10 = 1 GHz Option B5X = 500 MHz Option B2X = 250 MHz Option B1X = 160 MHz |
Resolution | 1 Hz |
Backwards Compatibility SCPI | The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. Alias [:SOURce]:SIGNal[1]:WAVeform:OBWidth to :SOURce:GROup1:SIGNal1:WAVeform:OBWidth Alias [:SOURce]:SIGNal2:WAVeform:OBWidth to :SOURce:GROup2:SIGNal1:WAVeform:OBWidth |
Initial S/W Revision | A.01.00 |
Modified S/W Revision | A.07.00 A.09.00 Added :GROup keyword |
Set the occupied bandwidth of the bonded vector modulated signal.
The value is not editable in a GUI when a Bonded Waveform File is selected
GUI Location | System Menu > Configure Channels > Bonded > Signals > Occupied Bandwidth |
SCPI Command | [:SOURce]:GROup<group>:CBONded:WAVeform:OBWidth [:SOURce]:GROup<group>:CBONded:WAVeform:OBWidth? |
SCPI Example | GRO:CBON:WAV:OBW 3.8 GHZ GRO:CBON:WAV:OBW? |
Preset | 0 |
State Saved | Yes |
Min | 0 Hz |
Max | For M9384B Option D20/21 = 4.096 GHz For M9484C Option R25 = 5.0 GHz |
Resolution | 0.001 |
SCPI Change | [:SOURce]:CBONded<bondingset>:WAVeform:OBWidth <frequency> has been changed to [:SOURce]:GROup<group>:CBONded:WAVeform:OBWidth <frequency>. Prior use of :SOUR:CBON:WAV:OBW or :SOUR:CBON1:WAV:OBW is now :SOUR:GRO1:CBON:WAV:OBW. |
Initial S/W Revision | A.07.00 |
Modified S/W Revision | A.10.00 Changed SCPI: Added :GROup<group> and removed <bondingset> from :CBONded |
Requires Option EP1.
In use cases where the modulated signal contains component carriers that are spectrally separated within the Occupied Bandwidth, you can specify the Aggregate Active Bandwidth to indicate the how the RF energy is distributed within the Occupied Bandwidth. For example, if you have a two component carrier signal with each carrier 5 MHz wide, spaced 100 MHz apart on center, the Occupied Bandwidth will be 105 MHz and you would set the Aggregate Active Bandwidth to 10 MHz. The Aggregate Active Bandwidth is never greater than the Occupied Bandwidth. Appropriately specifying the Aggregate Active Bandwidth and Occupied Bandwidth may improve the ACPR and EVM performance of the instrument. View image of example frequency domain.
GUI Location | Signals > Mode set to Waveform File >Aggregate Active Bandwidth |
SCPI Command | [:SOURce]:GROup<group>:SIGNal<signal>:WAVeform:AABWidth <freq> [:SOURce]:GROup<group>:SIGNal<signal>:WAVeform:AABWidth? |
SCPI Example | GRO:SIGN:WAV:AABW 5 MHZ GRO:SIGN:WAV:AABW? |
Dependencies | Option EP1 must be present, you can change the value via SCPI however you cannot change the State. |
Preset | 0 |
State Saved | Yes |
Min | 0 Hz |
Max | For M9383B/M9384B: Options D20/D21/D2E = 2.048 GHz Options D10/D11 = 1.024 GHz Options D05/D06= 500 MHz For M9484C: Option R25 = 2.5 GHz Option R10 = 1 GHz Option B5X = 500 MHz Option B2X = 250 MHz Option B1X = 160 MHz |
Couplings | The Aggregate Active Bandwidth must be less than the Occupied Bandwidth. {RD} Limited with no bounce back {/RD} When a new waveform is selected the Aggregate Active Bandwidth values does not change except to apply the limit that the value must not be greater than the Occupied Bandwidth. |
Resolution | 1 Hz |
Backwards Compatibility SCPI | The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. Alias [:SOURce]:SIGNal[1]:WAVeform:AABWidth to :SOURce:GROup1:SIGNal1:WAVeform:AABWidth Alias [:SOURce]:SIGNal2:WAVeform:AABWidth to :SOURce:GROup2:SIGNal1:WAVeform:AABWidth |
Initial S/W Revision | A.01.00 |
Modified S/W Revision | A.07.00 A.09.00 Added :GROup keyword |
Requires Option EP1.
Click the checkbox to enable (checkmarked) or disable the Aggregate Active Bandwidth. For signals where the modulation fully consumes the Occupied Bandwidth, Aggregate Active Bandwidth should be Off. Aggregate Active Bandwidth should be set to On when the modulation signal does not fully utilize the RF energy of the Occupied Bandwidth.
GUI Location | Signals > Mode set to Waveform File >Aggregate Active Bandwidth > On |
SCPI Command | [:SOURce]:GROup<group>:SIGNal<signal>:WAVeform:AABWidth:STATe ON|OFF|1|0 [:SOURce]:GROup<group>:SIGNal<signal>:WAVeform:AABWidth:STATe? |
SCPI Example | GRO:SIGN:WAV:AABW:STAT ON GRO:SIGN:WAV:AABW:STAT? |
Dependencies | Option EP1 must be present, if you attempt to change the state without Option EP1 the error message is: -221,"Settings Conflict; cannot turn on Aggregate Active Bandwidth, Option EP1 is required." |
Preset | OFF |
State Saved | Yes |
Choices | OFF | ON |
Couplings | When a waveform is selected the state is set to OFF. |
Backwards Compatibility SCPI | The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. Alias [:SOURce]:SIGNal[1]:WAVeform:AABWidth:STATe to :SOURce:GROup1:SIGNal1:WAVeform:AABWidth:STATe Alias [:SOURce]:SIGNal2:WAVeform:AABWidth:STATe to :SOURce:GROup2:SIGNal1:WAVeform:AABWidth:STATe |
Initial S/W Revision | A.01.00 |
Modified S/W Revision | A.07.00 A.09.00 Added :GROup keyword |
When a *.bnd waveform file is selected, this command should be used to restore the calibrated state of the bonded signal.
This command is only valid when a *.bnd file is loaded.
GUI Location | System Menu > Configure Channels > Bonded > Signals > Recall Calibrated State |
SCPI Command | [:SOURce]:GROup<group>:CBONded:INSTrument:STATe:RECall |
SCPI Example | GRO:CBON:INST:STAT:REC |
SCPI Change | [:SOURce]:CBONded<bondingset>:INSTrument:STATe:RECall has been changed to [:SOURce]:GROup<group>:CBONded:INSTrument:STATe:RECall. Prior use of :SOUR:CBON:INST:STAT:REC or :SOUR:CBON1:INST:STAT:REC is now :SOUR:GRO1:CBON:INST:STAT:REC. |
Initial S/W Revision | A.07.00 |
Modified S/W Revision | A.10.00 Changed SCPI: Added :GROup<group> and removed <bondingset> from :CBONded |
Marker routing applies to the Waveform File and Real-Time signal modes.
SCPI commands directly tied to this GUI are not defined, rather the event connectors SCPI commands are used to setup the marker routine.
Some Vector Modulation Signal Modes provide a mechanism to output a TTL-like signal synchronized with the modulation playback. Depending on the capability provided by the instrument, up to four markers can be provided. See Waveform Header.
For the M9484C, a Marker can be routed to three Event connectors of the instrument:
Event 1 applies to the M9484C only.
Routes a marker of signal<signal> to Event 1.
GUI Location | Signals > Signal Summary selection > Mode set to Waveform File or to Real-Time > Markers > Event 1 |
Preset | Marker 1 for signal 1 NONE for other signals |
Choices | None | Marker 1 | Marker 2 | Marker 3 | Marker 4 |
Initial S/W Revision | A.10.00 |
Refer to Events in the Connectors topic.
Event 2 applies to the M9484C only.
Routes a marker of signal<signal> to Event 2.
GUI Location | Signals > Signal Summary selection > Mode set to Waveform File or to Real-Time > Markers > Event 2 |
Preset | Marker 2 for signal 1 NONE for other signals |
Choices | None | Marker 1 | Marker 2 | Marker 3 | Marker 4 |
Initial S/W Revision | A.10.00 |
Refer to Events in the Connectors topic.
Event 3 applies to the M9484C only.
Routes a marker of signal<signal> to Event 3.
GUI Location | Signals > Signal Summary selection > Mode set to Waveform File or to Real-Time > Markers > Event 3 |
Preset | Marker 3 for signal 1 NONE for other signals |
Choices | None | Marker 1 | Marker 2 | Marker 3 | Marker 4 |
Initial S/W Revision | A.10.00 |
Refer to Events in the Connectors topic.
Edit Event Connectors applies to the M9484C only.
Accesses the Event Configuration screen.
Refer to Events in the Connectors topic.
Click this button to access the Marker Editor.
See also Marker Editing Using SCPI.
Marker routing applies to the Waveform File signal mode.
Some Vector Modulation Signal Modes provide a mechanism to output a TTL-like signal synchronized with the modulation playback. Depending on the capability provided by the instrument, up to four markers can be provided. See Waveform Header.
For M9383B and M9384B, a marker can be routed to the instrument’s internal functions of ALC Hold and RF Blanking, and to the Sync connector for synchronizing external equipment with the modulation playback.
For channel bonding configurations, note the following:
For marker related outputs when in the Bonded Configuration, use the physical connectors on Channel-1. The behavior of connectors for Channel-2 are undefined and should not be used for the bonded configurations.
The bonding process generates the marker data for the bonded waveform based on the marker data of the waveform file provided. Because of this, the marker data cannot be edited after performing the bonding process. Thus, the marker data of the waveform file must be set up first.
ALC and RF Blanking markers are not supported by the bonding process, or for playback when in the bonded configuration. Thus, the Sync output is the appropriate marker for bonded configuration.
Use Signal 1 for SCPI commands when configuring the markers.
Marker Routing for ALC Hold applies only to the M9383B VXG-m and the M9384B VXG.
Enables the marker ALC hold function for the selected marker. Use the ALC hold function when you have a waveform signal that incorporates idle periods, or when the increased dynamic range encountered with RF blanking is not desired. The ALC leveling circuitry responds to the marker signal during the marker pulse (marker signal high), averaging the modulated signal level during this period.
The ALC hold function operates during the low periods of the marker signal.
NONE: This terminates the marker ALC hold function.
M1–M4: These are the marker choices. The ALC hold feature uses only one marker at a time.
Incorrect automatic level control (ALC) sampling can create a sudden unleveled condition that may create a spike in the RF output potentially damaging a DUT or connected instrument. Ensure that you set markers to let the ALC sample over an amplitude that accounts for the high power levels within the signal.
GUI Location | Signals > Mode set to Waveform File or 5G NR > Markers > ALC Hold |
SCPI Command | [:SOURce]:GROup<group>:SIGNal<signal>:WAVeform:MDEStination:ALCHold NONE|M1|M2|M3|M4 [:SOURce]:GROup<group>:SIGNal<signal>:WAVeform:MDEStination:ALCHold? |
SCPI Example | GRO:SIGN:WAV:MDES:ALCH M1 GRO:SIGN:WAV:MDES:ALCH? |
Note | For M9484C: ALC Hold is NONE and not changeable, attempting to change the value generates the standard SCPI error. |
Preset | None |
Choices | None | Marker1 | Marker2 | Marker3 | Marker4 |
State Saved | Yes |
Backwards Compatibility SCPI | The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. [:SOURce]:RADio[1]:ARB:MDEStination:ALCHold Alias [:SOURce]:SIGNal[1]:WAVeform:MDEStination:ALCHold to :SOURce:GROup1:SIGNal1:WAVeform:MDEStination:ALCHold Alias [:SOURce]:SIGNal2:WAVeform:MDEStination:ALCHold to :SOURce:GROup2:SIGNal1:WAVeform:MDEStination:ALCHold Alias [:SOURce]:SIGNal[1]:CMODulation:MDEStination:ALCHold to :SOURce:GROup1:SIGNal1:WAVeform:MDEStination:ALCHold Alias [:SOURce]:SIGNal2:CMODulation:MDEStination:ALCHold to :SOURce:GROup2:SIGNal1:WAVeform:MDEStination:ALCHold Alias [:SOURce]:SIGNal[1]:NR5G:MDEStination:ALCHold to :SOURce:GROup1:SIGNal1:WAVeform:MDEStination:ALCHold Alias [:SOURce]:SIGNal2:NR5G:MDEStination:ALCHold to :SOURce:GROup2:SIGNal1:WAVeform:MDEStination:ALCHold |
Initial S/W Revision | A.01.00 |
Modified S/W Revision | A.09.00 Added :GROup keyword |
Marker Routing for RF Blanking applies only to the M9383B VXG-m and the M9384B VXG.
Enables the marker pulse/RF blanking function for the selected marker. This function automatically uses the ALC hold function, so there is no need to select both the ALC hold and pulse/RF blanking functions for the same marker.
NONE This terminates the marker RF blanking/pulse function.
M1–M4 These are the marker choices. The RF blanking/pulse feature uses only one marker at a time.
The pulse function incorporates ALC hold. Incorrect automatic level control (ALC) sampling can create a sudden unleveled condition that may create a spike in the RF output potentially damaging a DUT or connected instrument. Ensure that you set markers to let the ALC sample over an amplitude that accounts for the high power levels within the signal.
The signal generator blanks the RF output when the marker signal goes low.
GUI Location | Signals > Mode set to Waveform File or 5G NR > Markers > RF Blanking |
SCPI Command | [:SOURce]:GROup<group>:SIGNal<signal>:WAVeform:MDEStination:PULSe NONE|M1|M2|M3|M4 [:SOURce]:GROup<group>:SIGNal<signal>:WAVeform:MDEStination:PULSe? |
SCPI Example | GRO:SIGN:WAV:MDES:PULS M1 GRO:SIGN:WAV:MDES:PULS? |
Note | For M9484C: PULSe is NONE and not changeable, attempting to change the value generates the standard SCPI error. |
Preset | None |
Choices | None | Marker1 | Marker2 | Marker3 | Marker4 |
State Saved | Yes |
Backwards Compatibility SCPI | The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. [:SOURce]:RADio[1]:ARB:MDEStination:PULSe Alias [:SOURce]:SIGNal[1]:WAVeform:MDEStination:PULSe to :SOURce:GROup1:SIGNal1:WAVeform:MDEStination:PULSe Alias [:SOURce]:SIGNal2:WAVeform:MDEStination:PULSe to :SOURce:GROup2:SIGNal1:WAVeform:MDEStination:PULSe Alias [:SOURce]:SIGNal[1]:CMODulation:MDEStination:PULSe to :SOURce:GROup1:SIGNal1:WAVeform:MDEStination:PULSe Alias [:SOURce]:SIGNal2:CMODulation:MDEStination:PULSe to :SOURce:GROup2:SIGNal1:WAVeform:MDEStination:PULSe Alias [:SOURce]:SIGNal[1]:NR5G:MDEStination:PULSe to :SOURce:GROup1:SIGNal1:WAVeform:MDEStination:PULSe Alias [:SOURce]:SIGNal2:NR5G:MDEStination:PULSe to :SOURce:GROup2:SIGNal1:WAVeform:MDEStination:PULSe |
Initial S/W Revision | A.01.00 |
Modified S/W Revision | A.09.00 Added :GROup keyword |
Remote command only.
RF Blanking Marker Polarity applies only to the M9383B VXG-m and the M9384B VXG.
This command uses the same marker as the one set with the [:SOURce]:GROup<group>:SIGNal<signal>:WAVeform:MDEStination:PULSe NONE|M1|M2|M3|M4 command.
If pulse mode is POSitive on the marker, then the signal will be present whenever a marker is present, and the signal will be suppressed whenever there is no marker. Conversely, if it is NEGative on the marker, the signal will be suppressed whenever a marker is present, and present whenever there is no marker.
SCPI Command | [:SOURce]:GROup<group>:SIGNal<signal>:WAVeform:PULSe:POLarity NEGative|POSitive [:SOURce]:GROup<group>:SIGNal<signal>:WAVeform:PULSe:POLarity? |
SCPI Example | GRO:SIGN:WAV:PULS:POL POS GRO:SIGN:WAV:PULS:POL? |
Note | For M9484C: POLarity is POSitive and not changeable, attempting to change the value generates the standard SCPI error. |
Preset | POSitive |
Range | Negative|Positive |
State Saved | No |
Initial S/W Revision | A.02.00 |
Backwards Compatibility SCPI | The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. Alias [:SOURce]:SIGNal[1]:WAVeform:PULSe:POLarity to :SOURce:GROup1:SIGNal1:WAVeform:PULSe:POLarity Alias [:SOURce]:SIGNal2:WAVeform:PULSe:POLarity to :SOURce:GROup2:SIGNal1:WAVeform:PULSe:POLarity Alias [:SOURce]:SIGNal[1]:CMODulation:PULSe:POLarity to :SOURce:GROup1:SIGNal1:WAVeform:PULSe:POLarity Alias [:SOURce]:SIGNal2:CMODulation:PULSe:POLarity to :SOURce:GROup2:SIGNal1:WAVeform:PULSe:POLarity Alias [:SOURce]:SIGNal[1]:NR5G:PULSe:POLarity to :SOURce:GROup1:SIGNal1:WAVeform:PULSe:POLarity Alias [:SOURce]:SIGNal2:NR5G:PULSe:POLarity to :SOURce:GROup2:SIGNal1:WAVeform:PULSe:POLarity |
Initial S/W Revision | A.01.00 |
Modified S/W Revision | A.09.00 Added :GROup keyword, aliased CMODulation and NR5G to WAVeform |
Remote command only.
Sync Marker Polarity applies only to the M9383B VXG-m and the M9384B VXG.
Sets the polarity for Marker Polarity. For a positive marker polarity, the signal at Sync port is high during the marker points. For a negative marker polarity, Sync port is high during the period of no marker points.
SCPI Command | [:SOURce]:GROup<group>:SIGNal<signal>:WAVeform:SYNC:POLarity NEGative|POSitive [:SOURce]:GROup<group>:SIGNal<signal>:WAVeform:SYNC:POLarity? |
SCPI Example | GRO:SIGN:WAV:SYNC:POL POS GRO:SIGN:WAV:SYNC:POL? |
Preset | POSitive |
State Saved | Yes |
Backwards Compatibility SCPI | The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. Alias [:SOURce]:SIGNal[1]:WAVeform:SYNC:POLarity to :SOURce:GROup1:SIGNal1:WAVeform:SYNC:POLarity Alias [:SOURce]:SIGNal2:WAVeform:SYNC:POLarity to :SOURce:GROup2:SIGNal1:WAVeform:SYNC:POLarity Alias [:SOURce]:SIGNal[1]:CMODulation:SYNC:POLarity to :SOURce:GROup1:SIGNal1:WAVeform:SYNC:POLarity Alias [:SOURce]:SIGNal2:CMODulation:SYNC:POLarity to :SOURce:GROup2:SIGNal1:WAVeform:SYNC:POLarity Alias [:SOURce]:SIGNal[1]:NR5G:SYNC:POLarity to :SOURce:GROup1:SIGNal1:WAVeform:SYNC:POLarity Alias [:SOURce]:SIGNal2:NR5G:SYNC:POLarity to :SOURce:GROup2:SIGNal1:WAVeform:SYNC:POLarity For M9484C: SIGN1:WAV:TRIG:SYNC:POL will be aliased to ROUT:RF1:EVEN1:POL SIGN2:WAV:TRIG:SYNC:POL will be aliased to ROUT:RF2:EVEN1:POL |
Initial S/W Revision | A.01.00 |
Modified S/W Revision | A.09.00 Added :GROup keyword, aliased CMODulation and NR5G to WAVeform |
Marker Routing for Sync applies only to the M9383B VXG-m and the M9384B VXG.
Specifies which marker to route to the following port.
On an M9383B, Trig1 of M9343A at slot 16 (CH1) or slot 8 (CH2)
On an M9384B, Ch 1 Sync Out or Ch 2 Sync Out on the rear panel.
The SCPI node differs from ALC Hold and RF Blanking which use :RADio:ARB.
GUI Location | Signals > Mode set to Waveform File or 5G NR > Markers > Sync |
SCPI Command | [:SOURce]:GROup<group>:SIGNal<signal>:WAVeform:MDEStination:SYNC NONE|M1|M2|M3|M4 [:SOURce]:GROup<group>:SIGNal<signal>:WAVeform:MDEStination:SYNC? |
SCPI Example | GRO:SIGN:WAV:MDES:SYNC M1 GRO:SIGN:WAV:MDES:SYNC? |
Preset | Marker1 (M1) |
Choices | None | Marker1 | Marker2 | Marker3 | Marker4 |
State Saved | Yes |
Backwards Compatibility SCPI | The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. Alias [:SOURce]:SIGNal[1]:CMODulation:TRIGger:SYNC:MARKer to :SOURce:GROup1:SIGNal1:WAVeform:MDEStination:SYNC Alias [:SOURce]:SIGNal2:CMODulation:TRIGger:SYNC:MARKer to :SOURce:GROup2:SIGNal1: WAVeform:MDEStination:SYNC Alias [:SOURce]:SIGNal[1]:NR5G:TRIGger:SYNC:MARKer to :SOURce:GROup1:SIGNal1: WAVeform:MDEStination:SYNC Alias [:SOURce]:SIGNal2:NR5G:TRIGger:SYNC:MARKer to :SOURce:GROup2:SIGNal1: WAVeform:MDEStination:SYNC Alias [:SOURce]:SIGNal[1]:WAVeform:TRIGger:SYNC:MARKer to :SOURce:GROup1:SIGNal1: WAVeform:MDEStination:SYNC Alias [:SOURce]:SIGNal2:WAVeform:TRIGger:SYNC:MARKer to :SOURce:GROup2:SIGNal1: WAVeform:MDEStination:SYNC
For M9484C: [:SOURce]:GROup[1]:SIGNal[1]:WAVeform:MDEStination:SYNC NONE|M1|M2|M3|M4 will be aliased to :ROUTe:CONNectors:RF1:EVENt1 NONE| S1M1| S1M2| S1M3| S1M4 [:SOURce]:GROup2:SIGNal[1]:WAVeform:MDEStination:SYNC NONE|M1|M2|M3|M4 will be aliased to :ROUTe:CONNectors:RF2:EVENt1 NONE| S1M1| S1M2| S1M3| S1M4 [:SOURce]:SIGNal[1]:WAVeform:TRIGger:SYNC:MARKer NONE|M1|M2|M3|M4 will be aliased to :ROUTe:CONNectors:RF1:EVENt1 NONE| S1M1| S1M2| S1M3| S1M4 [:SOURce]:SIGNal2:WAVeform:TRIGger:SYNC:MARKer NONE|M1|M2|M3|M4 will be aliased to :ROUTe:CONNectors:RF2:EVENt1 NONE| S1M1| S1M2| S1M3| S1M4 |
Initial S/W Revision | A.01.00 |
Modified S/W Revision | A.09.00 Added :GROup keyword |
Click this button to access the Marker Editor.
See also Marker Editing Using SCPI.
Remote command only.
This is a command for compatibility with the N5181B/82B/83B MXG.
When set to on, Mode is set to Waveform File and vector modulation is enabled. It is off when Mode is not set to Waveform File or vector modulation is disabled.
SCPI Command | [:SOURce]:RADio:ARB[:STATe] ON|OFF|1|0 [:SOURce]:RADio:ARB[:STATe]? |
SCPI Example | :RAD:ARB 1 :RAD:ARB? |
Preset | OFF |
State Saved | No |
Initial S/W Revision | A.01.00 |
Remote command only.
This command creates a waveform sequence. A waveform sequence is made up of waveform files and/or other sequences. Any number of waveform files can be used to create a sequence (within capacity of the file system). The max number of repetitions is 65535.
The query returns the contents and segment settings of the waveform sequence file.
The waveform files and/or sequences play in the same order as placed into the waveform sequence by the command. Once you create the file, you cannot edit the segment settings or add further waveform segments. Using the same waveform sequence name overwrites the existing file with that name.
The parameters of the command are as follows:
"<file name>": The name given to the waveform sequence file. The <file name> can be specified as a full or relative path, or using MSUS "SEQ<channel>:file name".
"<waveform1>": Specifies the name of an existing waveform or sequence file. The file must reside in volatile memory, WFM. This will be the first waveform or sequence in the newly created sequence <file name>.
<reps1>: This variable sets the number of times <waveform1> plays (repeats) before the next segment plays.
"<waveform2>": Specifies the name of an existing waveform or sequence file. The same conditions required for waveform1 apply for this waveform or sequence. This will be the second waveform or sequence in the newly created sequence <file name>.
<reps2>: This variable sets the number of times <waveform2> plays (repeats).
NONE | M1 | M2 | M3 | M4 | M1M2 | M1M3 | M1M4 | M2M3 | M2M4 | M3M4 | M1M2M3 | M1M2M4 | M1M3M4 | M2M3M4 | M1M2M3M4 | ALL: This variable exists only for backward compatibility. Whatever is specified, all four markers in the waveform segment or sequence are enabled as if ALL is specified.
When a sequence file is played and waveform segments in the sequence file are missing from the ARB memory, the VXG signal generator tries to upload them. If the sequence file is in the default folder for sequence files, the default folder for waveform files is checked. Otherwise, the folder where the sequence file is located is checked first, and then the default folder for waveform files is checked. The following files in the folder are checked for a segment <waveform>:
If <waveform> contains a file extension, <waveform>
Otherwise, the VXG signal generator tries to upload the following files in this order:
<waveform> as a secure waveform file
<waveform> as a non-secure waveform file
<waveform>.wfm
<waveform>.wiq
<waveform>.csv
SCPI Command | :MEMory:DATA:SEQuence <file name>,<waveform1>,<reps1>,NONE|M1|M2|M3|M4|M1M2|M1M3|M1M4|M2M3|M2M4|M3M4|M1M2M3|M1M2M4|M1M3M4|M2M3M4|M1M2M3M4|ALL,<waveform2>,<reps2>,NONE|M1|M2|M3|M4|M1M2|M1M3|M1M4|M2M3|M2M4|M3M4|M1M2M3|M1M2M4|M1M3M4|M2M3M4|M1M2M3M4|ALL :MEMory:DATA:SEQuence? <file name> |
SCPI Example | MEM:DATA:SEQ "SEQ:Test_Data","WFM1:ramp_test_wfm",25,M1M4,"WFM1:sine_test_wfm",100,ALL MEM:DATA:SEQ? "SEQ:Test_Data" |
Backwards Compatibility SCPI | [:SOURce]:RADio:ARB:SEQuence[:MWAVeform] |
Initial S/W Revision | A.02.00 |
Assume that there are MyWaveform1.wfm (Keysight Signal Studio waveform), MyWaveform2.wiq (binary waveform) and MyWaveform3.csv (csv waveform) under <Documents>\Keysight\PathWave\SignalGenerator\Waveforms. The following SCPI listings upload the waveform data from non-volatile memory to the arb memory and create waveform sequences.
From version A.03.00, :MMEMory:COPY can be omitted when the waveform is in the predefined folder because the file not found in the ARB memory is automatically uploaded from the non-volatile memory. Also, MSUS in the waveform parameters of :MEMory:DATA:SEQuence is not required. When used, it is ignored. For example:
:MEMory:DATA:SEQuence "SEQ:MySequence", "SWFM1:MyWaveform1", 10, ALL, "SWFM1:MyWaveform2", 100, ALL
is the same as
:MEMory:DATA:SEQuence "SEQ:MySequence", "MyWaveform1", 10, ALL, "MyWaveform2", 100, ALL
because SWFM1: is ignored.
In this example the first waveform is played 10 times and then the second waveform is played 100 times.
*RST
:MMEMory:DELete:WFM
:MMEMory:COPY "SNVWFM:MyWaveform1", "SWFM1:MyWaveform1"
:MMEMory:COPY "NVWFM:MyWaveform2", "SWFM1:MyWaveform2"
:MEMory:DATA:SEQuence "SEQ:MySequence", "MyWaveform1", 10, ALL, "MyWaveform2", 100, ALL
:SOURce:GROup:SIGNal:WAVeform:SELect "SEQ:MySequence"
This is an example of a nested sequence. The first sequence will be named "BaseSequence" and consists of "MyWaveform1.wfm" repeated 10 times followed by "MyWaveform2.wiq" repeated 100 times. Then sequence named "MySequence" is created wherein "BaseSequence" will be repeated twice followed by "MyWaveform3" repeated 30 times. When "MySequence" is selected as waveform, segments played are as follows:
"MyWaveform1.wfm" 10 times
"MyWaveform2.wiq" 100 times
"MyWaveform1.wfm" 10 times
"MyWaveform2.wiq" 100 times
"MyWaveform3.csv" 30 times
*RST
:MMEMory:DELete:WFM1
:MMEMory:COPY "SNVWFM:MyWaveform1", "SWFM1:MyWavform1"
:MMEMory:COPY "NVWFM:MyWaveform2", "SWFM1:MyWaveform2"
:MMEMory:COPY "NVCSVWFM:MyWaveform3", "SWFM1:MyWaveform3"
:MEMory:DATA:SEQuence "SEQ:BaseSequence", "MyWaveform1", 10, ALL, "MyWaveform2", 100, ALL
:MEMory:DATA:SEQuence "SEQ:MySequence", "SEQ:BaseSequence", 2, ALL, "MyWaveform3", 30, ALL
:SOURce:GROup:SIGNal:WAVeform:SELect "SEQ:MySequence"
Please note that SEQ: cannot be omitted.
This is an example of creating a simple sequence for playback on instruments with two channels, with Group 2 in Independent Configuration. The first waveform is played 10 times and then the second waveform is played 100 times.
*RST
:MMEMory:DELete:WFM2
:MMEMory:COPY "SNVWFM:MyWaveform1", "SWFM2:MyWaveform1"
:MMEMory:COPY "NVWFM:MyWaveform2", "SWFM2:MyWaveform2"
:MEMory:DATA:SEQuence "SEQ:MySequence", "MyWaveform1", 10, ALL, "MyWaveform2", 100, ALL
:SOURce:GROup2:SIGNal2:WAVeform:SELect "SEQ:MySequence"
Remote command only.
Query only command. Returns the waveform quantum. Waveform length needs to be a multiple of this number.
SCPI Command | [:SOURce]:GROup<group>:SIGNal<signal>:WAVeform:INFormation:QUANtum? |
SCPI Example | GRO:SIGN:WAV:INF:QUAN? |
State Saved | No |
Notes | For M9383B and M9384B the quantum is 8 For M9484C the quantum is 1 |
Backwards Compatibility SCPI | The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. Alias [:SOURce]:SIGNal[1]:WAVeform:INFormation:QUANtum? to :SOURce:GROup1:SIGNal1:WAVeform:INFormation:QUANtum? Alias [:SOURce]:SIGNal2:WAVeform:INFormation:QUANtum? to :SOURce:GROup2:SIGNal1:WAVeform:INFormation:QUANtum? |
Initial S/W Revision | A.02.00 |
Modified S/W Revision | A.09.00 Added :GROup keyword |
Remote command only.
Query only command. Returns the minimum length of waveform segment. Waveform may not be played when its length is less than this number.
A segment is a part of waveform sequence. The minimum segment is the shortest segment that plays correctly. This is usually the same as the minimum waveform length as playing a "waveform" is internally the same as playing a sequence of one segment.
SCPI Command | [:SOURce]:GROup<group>:SIGNal<signal>:WAVeform:INFormation:SLENgth:MINimum? |
SCPI Example | GRO:SIGN:WAV:INF:SLEN:MIN? |
State Saved | No |
Backwards Compatibility SCPI | The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. Alias [:SOURce]:SIGNal[1]:WAVeform:INFormation:SLENgth:MINimum? to :SOURce:GROup1:SIGNal1:WAVeform:INFormation:SLENgth:MINimum? Alias [:SOURce]:SIGNal2:WAVeform:INFormation:SLENgth:MINimum? to :SOURce:GROup2:SIGNal1:WAVeform:INFormation:SLENgth:MINimum? |
Initial S/W Revision | A.02.00 |
Modified S/W Revision | A.09.00 Added :GROup keyword |
For M9484C with N7631APPC, displays the name of the currently loaded real-time application.
GUI Location | Signals > Real-Time > Loaded Application |
Preset | "" |
State Saved | No |
Initial S/W Revision | A.10.00 |
Query only command.
For M9484C with N7631APPC, returns the sample rate of the modulating waveform set by the real-time application GUI. Accepts frequency units (e.g., 100 MHz).
SCPI Command | [:SOURce]:GROup<group>:SIGNal<signal>:RTIMe:SCLock:RATE? |
SCPI Example | GRO:SIGN:RTIM:SCL:RATE? |
Preset | For M9383B or M9384B: Option D20/21 = 2.56 GHz, D05/D06= 625 MHz, D10/11 = 1.28 GHz For M9484C: Options R25/R2E = 3.0 GHz, R10/R1E = 1228.8 MHz, B5X = 600 MHz, B2X = 300 MHz, B1X = 200 MHz |
State Saved | Yes |
Min | For M9383B or M9384B: 1.0 Hz For M9484C: 100 Hz |
Max | For M9383B/M9384B: Option D20/21 = 2.56 GHz, D05/D06= 625 MHz, D10/11 = 1.28 GHz For M9484C: Options R25/R2E = 3.0 GHz, R10/R1E = 1228.8 MHz, B5X = 600 MHz, B2X = 300 MHz, B1X = 200 MHz |
Resolution | 0.000001 Hz |
Initial S/W Revision | A.10.00 |
Query only command.
For M9484C with N7631APPC, returns the calculated value set by the real-time application GUI.
GUI Location | Signals > Real-Time > RMS Power |
SCPI Command | [:SOURce]:GROup<group>:SIGNal<signal>:RTIMe:RMS? |
SCPI Example | GRO:SIGN:RTIM:RMS? |
Preset | 1 |
State Saved | Yes |
Min | 0.1 |
Max | 1.414213562 |
Resolution | 0.000000001 |
Initial S/W Revision | A.10.00 |
Query only command.
For M9484C with N7631APPC, returns the scale factor of the modulating waveform set by the real-time application GUI in percent.
GUI Location | Signals > Real-Time > Scale |
SCPI Command | [:SOURce]:GROup<group>:SIGNal<signal>:RTIMe:SCALe? |
SCPI Example | GRO:SIGN:RTIM:SCAL? |
Preset | 100 |
State Saved | Yes |
Min | 1 |
Max | 100 |
Resolution | 0.01 |
Initial S/W Revision | A.10.00 |
Query only command.
For M9484C with N7631APPC, returns the occupied bandwidth of the modulating waveform set by the real-time application.
GUI Location | Signals > Real-Time > Occupied Bandwidth |
SCPI Command | [:SOURce]:GROup<group>:SIGNal<signal>:RTIMe:OBWidth? |
SCPI Example | GRO:SIGN:RTIM:OBW? |
Preset | 0 |
State Saved | Yes |
Min | 0 |
Max | For M9484C: Options R25, R2E = 2500 MHz Options R10, R1E = 1024 MHz Options B5X = 500 MHz Options B2X = 250 MHz Options B1X = 160 MHz |
Resolution | 1 Hz |
Initial S/W Revision | A.10.00 |
Additive white Gaussian noise (AWGN) is a basic noise node for thermal noise in communication channels. The modifiers denote specific characteristics:
Additive is added to any noise that might be intrinsic to the information system.
White has uniform to power across the frequency band for the information system. That is, the power spectral density is flat, so the auto correlation of the noise in the time domain is zero for any non-zero time offset.
Gaussian has a normal distribution in the time domain with an average time domain value of zero.
Sets the channel bandwidth over which the AWGN is applied. The channel bandwidth is the portion of the bandwidth specified by the bandwidth ratio.
GUI Location | Signals > AWGN > Channel Bandwidth |
SCPI Command | [:SOURce]:GROup<group>:SIGNal<signal>:AWGN:CBWidth <freq> [:SOURce]:GROup<group>:SIGNal<signal>:AWGN:CBWidth? |
SCPI Example | GRO:SIGN:AWGN:CBW 10 Hz GRO:SIGN:AWGN:CBW? |
Preset | 1 MHz |
State Saved | Yes |
Min | 1 Hz |
Max | For M9383B/M9384B: Options D20/D21/D2E = 2.048 GHz Options D10/D11 = 1.024 GHz Options D05/D06= 500 MHz For M9484C: Option R25 = 2.5 GHz Option R10 = 1 GHz Option B5X = 500 MHz Option B2X = 250 MHz Option B1X = 160 MHz Max of Flat Bandwidth / Bandwidth Ratio |
Resolution | 0.001 Hz |
Step Increment | 5 kHz |
Backwards Compatibility SCPI | The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. [:SOURce]:RADio:AWGN:RT:CBWidth Alias [:SOURce]:SIGNal[1]:AWGN[:RT]:CBWidth to :SOURce:GROup1:SIGNal1:AWGN[:RT]:CBWidth Alias [:SOURce]:SIGNal2:AWGN[:RT]:CBWidth to :SOURce:GROup2:SIGNal1:AWGN[:RT]:CBWidth |
Initial S/W Revision | A.03.00 |
Modified S/W Revision | A.09.00 Added :GROup keyword |
Sets the power control to either of the following two modes:
Total : Selects the displayed instrument power for control.
Channel Noise: Selects the channel noise power for control. The channel noise power is settable from the front panel only when the Power Control mode is set to Channel Noise.
GUI Location | Signals > AWGN > Power Control Mode |
SCPI Command | [:SOURce]:GROup<group>:SIGNal<signal>:AWGN:POWer:CONTrol[:MODE] TOTal|NCHannel [:SOURce]:GROup<group>:SIGNal<signal>:AWGN:POWer:CONTrol[:MODE]? |
SCPI Example | GRO:SIGN:AWGN:POW:CONT TOT GRO:SIGN:AWGN:POW:CONT? |
Preset | TOT |
Choices | Total | Channel Noise |
Backwards Compatibility SCPI | The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. [:SOURce]:RADio:AWGN:RT:POWer:CONTrol[:MODE] Alias [:SOURce]:SIGNal[1]:AWGN[:RT]:POWer:CONTrol[:MODE] to :SOURce:GROup1:SIGNal1:AWGN[:RT]:POWer:CONTrol[:MODE] Alias [:SOURce]:SIGNal2:AWGN[:RT]:POWer:CONTrol[:MODE] to :SOURce:GROup2:SIGNal1:AWGN[:RT]:POWer:CONTrol[:MODE] |
Initial S/W Revision | A.03.00 |
Modified S/W Revision | A.09.00 Added :GROup keyword |
Sets the flat bandwidth value of the stand-alone real-time noise.
GUI Location | Signals > AWGN > Flat Bandwidth |
SCPI Command | [:SOURce]:GROup<group>:SIGNal<signal>:AWGN:BANDwidth|BWIDth <freq> [:SOURce]:GROup<group>:SIGNal<signal>:AWGN:BANDwidth|BWIDth? |
SCPI Example | GRO:SIGN:AWGN:BAND 10 Hz GRO:SIGN:AWGN:BAND? |
Preset | 1 MHz |
State Saved | Yes |
Min | 1 Hz |
Max | For M9383B/M9384B: Options D20/D21/D2E = 2.048 GHz Options D10/D11 = 1.024 GHz Options D05/D06= 500 MHz For M9484C: Option R25 = 2.5 GHz Option R10 = 1 GHz Option B5X = 500 MHz Option B2X = 250 MHz Option B1X = 160 MHz |
Resolution | 0.001 Hz |
Step Increment | 5 kHz |
Backwards Compatibility SCPI | The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. [:SOURce]:RADio:AWGN:RT:BANDwidth|BWIDth Alias [:SOURce]:SIGNal[1]:AWGN[:RT]:BANDwidth|BWIDth to :SOURce:GROup1:SIGNal1:AWGN[:RT]:BANDwidth Alias [:SOURce]:SIGNal2:AWGN[:RT]:BANDwidth|BWIDth to :SOURce:GROup2:SIGNal1:AWGN[:RT]:BANDwidth |
Initial S/W Revision | A.03.00 |
Modified S/W Revision | A.09.00 Added :GROup keyword |
Displays the total power of AWGN signal. This parameter is read only and no SCPI commands are available.
When vector modulation is on, Power is aligned with Total Power.
When Power Control Mode is Total, Total Power is aligned with Power.
GUI Location | Signals > AWGN > Total Power |
Preset | -120.00 dBm |
Min | Minimum value of Power when vector modulation is on or Power Control Mode is Total. |
Max | Maximum value of Power when vector modulation is on or Power Control Mode is Total. |
Resolution | 0.01 dB |
Initial S/W Revision | A.03.00 |
Sets the amount of Channel Bandwidth compared to the amount of Flat Bandwidth.
When Bandwidth Ratio is changed, Flat Bandwidth is updated. If Flat Bandwidth reaches its limit value, Bandwidth Ratio is clipped using that value.
GUI Location | Signals > AWGN > Bandwidth Ratio |
SCPI Command | [:SOURce]:GROup<group>:SIGNal<signal>:AWGN:RATio [:SOURce]:GROup<group>:SIGNal<signal>:AWGN:RATio? |
SCPI Example | GRO:SIGN:AWGN:RAT 10 GRO:SIGN:AWGN:RAT? |
Preset | 1.0 |
State Saved | Yes |
Min | 1.0 |
Max | If Flat Bandwidth reaches its limit value during updating Bandwidth Ratio, Bandwidth Ratio is clipped. min(100, (Maximum of Flat Bandwidth)/(Channel Bandwidth)) |
Resolution | 0.001 |
Step Increment | 1 |
Backwards Compatibility SCPI | The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. [:SOURce]:RADio:AWGN:RT:RATio Alias [:SOURce]:SIGNal[1]:AWGN[:RT]:RATio to :SOURce:GROup1:SIGNal1:AWGN[:RT]:RATio Alias [:SOURce]:SIGNal2:AWGN[:RT]:RATio to :SOURce:GROup2:SIGNal1:AWGN[:RT]:RATio |
Initial S/W Revision | A.03.00 |
Modified S/W Revision | A.09.00 Added :GROup keyword |
Sets the power within the channel bandwidth. The instrument power is changed in relation to this setting when AWGN is selected. The channel noise power is settable from the front panel only when the Power Control mode is set to Channel Noise.
Total Power (Amplitude) – Channel Noise Power = 0.97 dB when Bandwidth is 1.0.
The Preset state is -120 (Power) – 0.97 (Channel Noise Power offset of Bandwidth Ratio = 1) = -120.97. When AWGN is selected, Channel Noise Power is calculated using the current settings (Bandwidth Ratio, Power).
GUI Location | Signals > AWGN > Channel Noise Power |
SCPI Command | [:SOURce]:GROup<group>:SIGNal<signal>:AWGN:POWer:NOISe:CHANnel <ampl> [:SOURce]:GROup<group>:SIGNal<signal>:AWGN:POWer:NOISe:CHANnel? |
SCPI Example | GRO:SIGN:AWGN:POW:NOIS:CHAN -30 dBm GRO:SIGN:AWGN:POW:NOIS:CHAN? |
Preset | -120.97 dBm |
State Saved | Yes |
Min | "1.25" means the ratio of Total power/power in Flat bandwidth. 1.25 is converted to approximately 0.97 dB. |
Max | "1.25" means the ratio of Total power/power in Flat bandwidth. 1.25 is converted to approximately 0.97 dB. |
Resolution | 0.01 dB |
Step Increment | 5 dB |
Backwards Compatibility SCPI | The following commands are not recommended. They are for the convenience of users with existing remote programs developed for earlier versions of the VXG or ported from a similar product. [:SOURce]:RADio:AWGN:RT:POWer:NOISe:CHANnel Alias [:SOURce]:SIGNal[1]:AWGN[:RT]:POWer:NOIse:CHANnel to :SOURce:GROup1:SIGNal1:AWGN[:RT]:POWer:NOIse:CHANnel Alias [:SOURce]:SIGNal2:AWGN[:RT]:POWer:NOIse:CHANnel to :SOURce:GROup2:SIGNal1:AWGN[:RT]:POWer:NOIse:CHANnel |
Initial S/W Revision | A.03.00 |
Modified S/W Revision | A.09.00 Added :GROup keyword |
Remote command only.
This is a command for compatibility with N5181B/82B/83B MXG.
When set to on, Mode is set to stand-alone AWGN and vector modulation is enabled.
It is off when Mode is not set to stand-alone AWGN or when vector modulation is disabled.
SCPI Command | [:SOURce]:RADio:AWGN:RT[:STATe] ON|OFF|1|0 [:SOURce]:RADio:AWGN:RT[:STATe]? |
SCPI Example | :RAD:AWGN:RT 1 :RAD:AWGN:RT? |
Preset | OFF |
State Saved | No |
Initial S/W Revision | A.03.00 |