Agilent Technologies InfiniiVision 3000 X-Series Programmer's Guide

862 Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide
29 :SYSTem Commands
:SYSTem:SETup
(see page 1138)
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 • "Introduction to :SYSTem Commands" on page 852
• "*LRN (Learn Device Setup)" on page 171
Example Code
' SAVE_SYSTEM_SETUP - The :SYSTEM:SETUP? query returns a program
' message that contains the current state of the instrument. Its
' 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 ' After reading query results.
' 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 ' Write data.
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 ' Read data.
Close #1 ' Close file.

Agilent Technologies InfiniiVision 3000 X-Series Specifications

General

Brand	Agilent Technologies
Model	InfiniiVision 3000 X-Series
Category	Test Equipment
Language	English