:SYSTem:MPButton:FUNCtion

Instrument:

N1010A

N1000A

DCA-M

Meas. mode:

Scope

Eye

Jitter

TDR

Flex Apps:

FlexDCA

FlexRT

Command Syntax

:SYSTem:MPButton:FUNCtion {NONE | LSETup | RSCRipt | SDWFile | SSCReen}

Query Syntax

:SYSTem:MPButton:FUNCtion?

Description

Assigns one of five possible actions to the Multi-Purpose button according to the arguments NONE, SSCReen, RSCRipt, and LSETup. A default setup (:SYSTem:DEFault) will not reset this setting but a factory preset (:SYSTem:FACTory) does reset it to NONE.

Requires FlexDCA revision A.04.50 and above.

The following arguments can be used:

NONE

The Multi-Purpose button is disabled. This is the factory preset setting.

LSETup

Configures the Multi-Purpose button to run an instrument setup file.

Configuration Commands for Running Instrument Setups
Command	Description	Setting Reset By
Command	Description	Default Setup	Factory Preset
:MPButton:QSETup:FNAMe	Loads and runs an instrument setup file. The default script is MultiPurpose.setx.		♦

Example Command Sequence

				:SYSTem:MPButton:QSETup:FNAMe "EyeModeSetup.setx"
				:SYSTem:MPButton:FUNCtion LSETup

RSCRipt

Configures the Multi-Purpose button to run a SCPI script. The factory preset scripts are named in the following table.

Configuration Commands for Running Scripts
Command	Description	Setting Reset By
Command	Description	Default Setup	Factory Preset
:MPButton:QSPBack:SSCRipt	Selects one script for all four instrument modes or a different script for each mode. The default script is MultiPurpose.scpi.		♦
:MPButton:QSPBack:EYE:FNAMe	Specifies the script to run in Eye mode. The default script is MultiPurpose Eye.scpi.		♦
:MPButton:QSPBack:JITTer:FNAMe	Specifies the script to run in Jitter mode. The default script is MultiPurpose Jitter.scpi.		♦
:MPButton:QSPBack:OSCilloscope:FNAMe	Specifies the script to run in Oscilloscope mode. The default script is MultiPurpose Scope.scpi.		♦
:MPButton:QSPBack:TDR:FNAMe	Specifies the script to run in TDR/TDT mode. The default script is MultiPurpose TDR.scpi.		♦

Example Command Sequence

:SYSTem:MPButton:QSPBack:SSCRipt OFF  //  Separate script for each Instrument mode
:SYSTem:MPButton:QSPBack:EYE:FNAMe "EyeOpeningScript.scpi"  //  Script for Eye mode
:SYSTem:MPButton:QSPBack:JITTer:FNAMe "JitterScript.scpi"  //  Script for Jitter mode
:SYSTem:MPButton:QSPBack:OSCilloscope:FNAMe "ScopeScript.scpi"  //  Script for Scope mode
:SYSTem:MPButton:QSPBack:TDR:FNAMe "TDRScript.scpi"  //  Script for TDR/TDT mode
:SYSTem:MPButton:FUNCtion RSCRipt  //  Assign running s script to Multi-Purpose button

SDWFile

Configures the Multi-Purpose button to save a documentation wizard file. To specify the name of the saved file, use the :SYSTem:MPButton:DOCWizard:BFName command. To select the contents for the documentation wizard file, use the :DWIZard commands that are located in the :DISK subsystem, as described in :DISK:DWIZard:SAVE command.

Configuration Commands for Saving a Documentation Wizard File
Command	Description	Setting Reset By
Command	Description	Default Setup	Factory Preset
:MPButton:DOCWizard:BFName	Save a documentation wizard file. The default script is QuickDocWizardSave.zip.		♦

Example Command Sequence

:SYSTem:MPButton:DOCWizard:BFName "%USER_DATA_DIR%\Documentation Results\DocWizard.zip"
:SYSTem:MPButton:FUNCtion SDWFile

SSCReen

Configures the Multi-Purpose button to save a screen image to a file. The factory preset file name for the saved image is QuickScreenSave.jpg. An integer is appended to the file name and is incremented each time a screen is saved.

Screen Image Information
FlexDCA Installed	Screen Captured	Default File Location
On N1000A	N1000A	N1000A
PC (connected to N1000A)	FlexDCA on PC	PC
PC (not connected to N1000A)	FlexDCA on PC	PC

Configuration Commands for Screen Images
Command	Description	Setting Reset By
Command	Description	Default Setup	Factory Preset
:MPButton:SIMage:BFName	Change the default path and filename for saving screens images.		♦
:MPButton:SIMage:IMETadata	Turns on and off the saving of metadata for jpg and tiff files.	♦	♦
:MPButton:SIMage:INVert	Turns on and off the inversion the graticule area's background color.	♦	♦
:MPButton:SIMage:MONochrome	Turns monochrome screen capture on and off.	♦	♦
:MPButton:SIMage:SAVE	Saves a screen image.	—	—

Example Command Sequence

:SYSTem:MPButton:SIMage:BFName "ProtoWaveform.png"  //  Assign a base filename
:SYSTem:MPButton:SIMage:INVert ON
:SYSTem:MPButton:FUNCtion SSCReen  //  Assign saving a screen image to Multi-Purpose button