Model 2461 Interactive SourceMeter® Instrument Reference Manual
Section 8: TSP command reference
2461-901-01 A/November 2015
8-329
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 Model 2461 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 Model 2461 reads from a TSP-enabled remote instrument, the Model 2461 removes Test
Script Processor (TSP
®
) prompts and places any errors or events it receives from the remote
instrument into its own event queue. The Model 2461 prefaces events and errors from the remote
device with
Remote Error
, followed by the event number and 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).
Also see
(on page 8-325)
(on page 8-329)
(on page 8-332)
(on page 8-335)
tspnet.readavailable()
This function checks to see if data is available from the remote device.
Type
TSP-Link accessible
Affected by
Where saved
Default value
Function
No
Usage
bytesAvailable
= tspnet.readavailable(
connectionID
)
bytesAvailable
The number of bytes available to be read from the connection
connectionID
The connection ID returned from
tspnet.connect()
Details
This command checks to see if any output data is available from the device. No data is read from the
instrument. This allows TSP scripts to continue to run without waiting on a remote command to finish.
