System:setup - Keysight Technologies InfiniiVision MSO-X 4022A Programmer's Manual

31
:SYSTem Commands

:SYSTem:SETup

Command Syntax
:SYSTem:SETup <setup_data>
<setup_data> ::= binary block data in IEEE 488.2 # format.
The :SYSTem:SETup command sets the oscilloscope as defined by the data in the
setup (learn) string sent from the controller. The setup string does not change the
interface mode or interface address.
Query Syntax
:SYSTem:SETup?
The :SYSTem:SETup? query operates the same as the *LRN? query. It outputs the
current oscilloscope setup in the form of a learn string to the controller. The setup
(learn) string is sent and received as a binary block of data. The format for the data
transmission is the # format defined in the IEEE 488.2 specification.
Return Format
<setup_data><NL>
<setup_data> ::= binary block data in IEEE 488.2 # format
See Also •
•
Example Code
1120
(see page 1428)
"Introduction to :SYSTem Commands"
"*LRN (Learn Device Setup)"
' SAVE_SYSTEM_SETUP - The :SYSTEM:SETUP? query returns a program
' message that contains the current state of the instrument.
' format is a definite-length binary block, for example,
' #800075595<setup string><NL>
' where the setup string is 75595 bytes in length.
myScope.WriteString ":SYSTEM:SETUP?"
varQueryResult = myScope.ReadIEEEBlock(BinaryType_UI1)
CheckForInstrumentErrors
' Output setup string to a file:
Dim strPath As String
strPath = "c:\scope\config\setup.dat"
' Open file for output.
Close #1 ' If #1 is open, close it.
Open strPath For Binary Access Write Lock Write As #1
Put #1, , varQueryResult
Close #1 ' Close file.
' RESTORE_SYSTEM_SETUP - Read the setup string from a file and
' write it back to the oscilloscope.
Dim varSetupString As Variant
strPath = "c:\scope\config\setup.dat"
' Open file for input.
Open strPath For Binary Access Read As #1
Get #1, , varSetupString
Close #1 ' Close file.
' Write setup string back to oscilloscope using ":SYSTEM:SETUP"
on page 1104
on page 207
' After reading query results.
' Write data.
' Read data.
Keysight InfiniiVision 4000 X-Series Oscilloscopes Programmer's Guide
Its