Tektronix KEITHLEY SourceMeter 2606B Reference Manual page 770

Model 2606B System SourceMeter® Instrument Reference Manual
tspnet.read()
This function reads data from a remote device.
Type TSP-Link accessible
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
value2
valueN
...
connectionID
formatString
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
%[max width]t
%[max width]n
%d
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 2606B 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 2606B reads from a TSP-enabled remote instrument, the 2606B removes Test Script
Processor (TSP
error queue. The 2606B prefaces errors from the remote device with "Remote Error," followed by
the error number and error description.
Example
tspnet.write(deviceID, "*idn?\r\n")
print("write/read returns:", tspnet.read(deviceID))
Send the "*idn?\r\n" message to the instrument connected as deviceID.
Display the response that is read from deviceID (based on the *idn? message).
2606B-901-01 Rev. C November 2021
Affected by
The first value decoded from the response message
The second value decoded from the response message
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
The connection ID returned from tspnet.connect()
Format string for the output, maximum of 10 specifiers
Read data until the specified length
Read data until the specified length or until punctuation is found, whichever comes first
Read data until a newline or carriage return
Read a number (delimited by punctuation)
® ) prompts and places any errors it receives from the remote instrument into its own
Section 15: TSP command reference
Where saved Default value
15-397