Keithley 3700A Series, Справочное руководство

Страница: 817 / 936

Section 11: TSP command reference Series 3700A System Switch/Multimeter Reference Manual
11-438 3700AS-901-01 Rev. D/June 2018
Example
deviceID = tspnet.connect("192.0.2.1")
print(tspnet.idn(deviceID))
tspnet.disconnect(deviceID)
Assume the instrument is at IP address 192.0.2.1.
The output that is produced when you connect to the
instrument and read the identification string may appear
as:
KEITHLEY INSTRUMENTS,MODEL
3706A,00000170,01.10h
Also see
tspnet.connect() (on page 11-434)
tspnet.read()
This function reads data from a remote device.
Type TSP-Link accessible Affected by Where saved Default value
Function No
Usage
value1 = tspnet.read( connectionID )
value1 = tspnet.read( connectionID , formatString )
value1 , value2 = tspnet.read( connectionID , formatString )
value1 , ... , valueN = tspnet.read( connectionID , formatString )
value1
The first value decoded from the response message
value2
The second value decoded from the response message
valueN
The nth value decoded from the response message; there is one return value for
each format specifier in the format string
...
One or more values separated with commas
connectionID
The connection ID returned from
tspnet.connect()
formatString
Format string for the output, maximum of 10 specifiers
Details
This command reads available data from the remote instrument and returns responses for the
specified number of arguments.
The format string can contain the following specifiers:
%[width]s
Read data until the specified length
%[max width]t
Read data until the specified length or until punctuation is found, whichever comes first
%[max width]n
Read data until a newline or carriage return
%d
Read a number (delimited by punctuation)
A maximum of 10 format specifiers can be used for a maximum of 10 return values.
If
formatString
is not provided, the command returns a string that contains the data until a new
line is reached. If no data is available, the Series 3700A pauses operation until the requested data is
available or until a timeout error is generated. Use
tspnet.timeout
to specify the timeout period.
When the Series 3700A reads from a TSP-enabled remote instrument, the Series 3700A removes
Test Script Processor (TSP
®
) prompts and places any errors it receives from the remote instrument
into its own error queue. The Series 3700A prefaces errors from the remote device with "
Remote
Error
," followed by the error number and error description.