MDO3000 Programmer Manual.pdf - 第43页

Command Groups AFG Command Gr oup Use the AFG commands for Arbitrary F unction Generator functionality . MDO3000 series with option MDO3AFG in stalled and MDO4000C series with option MDO4AFG installed only . The AFG func…

100%1 / 1158
Command Groups
Act on Event Co
mmand Group
Use the Act on Event commands to Act once a certain type of Event has happened.
Available actions:
- Stop acquisitions
- Save waveform data to a file
- Save a screen image to a file
- Send a screen image to a printer
-SendapulsetotheAuxOutport
- Generate a service request
-Sendanemail
- Display a visual notification
Available events:
- Upon trigger
-When a certain number of acquisitions have completed
-None
Table 2-14: Act o n Event
Command Description
ACTONEVent:ACTION:AUXOUT:
STA
TE
Sends a pulse to the AUX OUT port when a specified event occurs, or queries the state
of t
he “pulse to aux out” action.
ACT
ONEVent:ACTION:EMAIL:
STATE
Sen
ds an email when a specified event occurs, or queries the state of the “send email” action.
ACTONEVent:ACTION:PRINT:
STATE
Sends a screen image to a printer when a specified event occurs, or queries the state of
the “send screen image” action.
ACTONEVent:ACTION:
S
AVEIMAGE:STATE
Saves a screen image to file when a specified event occurs, or queries the state of the
“
save screen image to a file” action.
A
CTONEVent:ACTION:SAV EWFM:
STATE
S
aves the currently selected waveform data to a file when a specified event occurs, or
queries the state of the “save waveform to file” action.
ACTONEVent:ACTION:SRQ:STATE Sets or returns the enabled state of the generate service request (SRQ) action when a
specified event occurs. The default state is 0.
ACTONEVent:ACTION:STOPACQ:
STATE
Stops acquisitions when a s pecifi ed event occurs, or queries the state of the “stop
acquisition” action.
ACTONEVent:ACTION:VISUAL:
STATE
Sends a visual notification when a specified event occurs, or queries the state of the “send a
visual notification” action.
ACTONEVent:EVENTTYPe Specifies (or queries) which event to act on (TRIGger, ACQCOMPLete, or NONe) when
using an Act on Event command.
ACTONEVent:NUMACQs Sets (or queries) the number of acquisitions to complete for the event type ACQCOMPLete.
ACTONEVent:REP EATCount Sets or returns the number of events to run.
2-12 MDO4000/B/C, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual
Command Groups
AFG Command Gr
oup
Use the AFG commands for Arbitrary Function Generator functionality.
MDO3000 series with option MDO3AFG installed and MDO4000C series with
option MDO4AFG installed only.
The AFG functionality is available when either the time domain acquisitionor
RF acquisition is active.
Table 2-15: AFG Commands
Command Description
AFG:AMPLitude Sets (or queries) the AFG amplitude in volts, peak to peak.
AFG:FREQuency Sets (or queries) the AFG frequency.
AFG:FUNCtion Sets (or queries) which AFG function to execute.
AFG:HIGHLevel Sets (or queries) the AFG high level, in volts.
AFG:LEVELPreset Sets ( or queries) the AFG preset levels to values that correspond to the logic s tandard
specified by the argument The presets set the vertical controls for AMPLitude, OFFSet ,
HIGHLevel, and LOWLevel.
AFG:LOWLevel Sets (or queries) the AFG low level, in volts.
AFG:NOISEAdd:PERCent Sets (or queries) the A FG additive noise level as a percentage.
AFG:NOISEAdd:STATE Sets ( or queries) the AFG additive noise state.
AFG:OFFSet Sets (or queries) the AFG offset, in volts.
AFG:OUTPut:LOAd:IMPEDance Sets (or queries) the AFG output load impedance.
AFG:OUTPut:STATE Sets (or queries) the AFG output state.
AFG:PERIod Sets (or queries) the period of the AFG waveform, in seconds.
AFG:PHASe Sets (or queries) the AFG phase.
AFG:PULse:WIDth Sets (or queries) the AFG pulse width, in seconds.
AFG:RAMP:SYMmetry Sets (or queries) the A FG ramp symmetry as a percentage.
AFG:SQUare:DUty Sets (or queries) the AFG duty cycle, as a percentage.
Alias Command Group
Use the Alias commands to define new commands as a sequence of standard
commands. You may find this useful when repeatedly using the same commands
to perform certain tasks like setting up measurements.
Aliases are similar to macros but do not include the capability to substitute
parameters into alias bodies. To use Alias commands, first define the alias, then
turn on the alias state.
The alias mechanism obeys the following rules:
MDO4000/B/C, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual 2-13
Command Groups
thealiasnamem
ust consist of a valid IEEE488.2 message unit, which may
not appear in a message preceded by a colon, comma, or a command or query
program header.
the alias name may not appear in a message followed by a colon, comma,
or question mark.
an alias name must be distinct from any keyword or keyword short form.
an alias name cannot be redefined without first being deleted using one of
the alias deletion functions.
alias names do not appear in response messages.
Table 2-16: Alias Commands
Command Description
ALIas:CATalog? Returns a list of the currentl
ydefined alias labels
ALIas:DEFine
Assigns a sequence of program
messages to an alias label
ALIas:DELEte:ALL Deletes all existing aliases
ALIas:DELEte[:NAMe]
Removes a specified alias
ALIas[:STATE] This command specifies the alias state
ARB Command Group
Use the ARB commands for Arbitrary Waveform Generator functionality.
MDO3000 series with option MDO3AFG installed and MDO4000C series with
option MDO4AFG installed only.
Table 2-17: ARB Commands
Command Description
AFG:ARBitrary:ARB<x>:DATE? Returns the date that the data in the specified arbitrary waveform slot 1-4 was s aved.
AFG:ARBitrary:ARB<x>:LABel Sets (or queries) the waveform label for arbitrary waveform slots 1- 4.
AFG:ARBitrary:ARB<x>:TIMe? Returns the time that the data in the specified arbitrary waveform slot was saved.
AFG:ARBitrary:EMEM:FUNCtion? Returns the currently selected arbitrary waveform pre-defined function.
AFG:ARBitrary:EMEM:GENerate This command generates the arbitrary waveform function specified by the enumeration
argument, w ith the number of points optionally specified by the NR1 argument. To query the
arbitrary waveform function set by this command, use AFG:ARBitrary:EMEM:FUNCtion?
AFG:ARBitrary:EMEM:NUMPoints? Returns the number of points in the AFB arbitrary waveform edit memory.
AFG:ARBitrary:EMEM:POINTS Specifies which points to load into the AFG arbitrary waveform edit memory.
AFG.ARBitrary.EMEM.POINTS.BYTEORDerThis command specifies the byte order for the :AF G:AR Bitrary :EM E M :POINTS? query
when the :AFG :ARB itrary:EMEM:ENCDG is set to BINary and when binary block data is
sent for the :AFG:ARB itrary:EMEM:PO INTS command.
AFG:ARBitrary:EMEM:POINTS:ENCdg This command specifies the data encoding format for the AFG:ARBitrary:EMEM:POINTS
query (either AS CII or binary).
2-14 MDO4000/B/C, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual