Tektronix Keithley 2601B-PULSE Reference Manual

Section 11: TSP command reference Model 2601B-PULSE System SourceMeter Instrument Reference Manual
11-382 2601B-PULSE-901-01A April 2020
tspnet.execute()
This function sends a command string to the remote device.
Type
TSP-Link accessible
Affected by
Where saved
Default value
Function
No
Usage
tspnet.execute("connectionID", "commandString")
value1 = tspnet.execute("connectionID", "commandString", formatString)
value1, value2 = tspnet.execute("connectionID", "commandString", formatString)
value1, ..., valueN = tspnet.execute("connectionID", "commandString", formatString)
connectionID
The connection ID returned from tspnet.connect()
commandString
The command to send to the remote device
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
formatString
Format string for the output
Details
This command sends a command string to the remote instrument. A termination is added to the
command string when it is sent to the remote instrument (tspnet.termination()). You can also
specify a format string, which causes the command to wait for a response from the remote
instrument. The 2601B-PULSE decodes the response message according to the format specified in
the format string and returns the message as return values from the function (see tspnet.read()
for format specifiers).
When this command is sent to a TSP-enabled instrument, the 2601B-PULSE suspends operation
until a timeout error is generated or until the instrument responds. The TSP prompt from the remote
instrument is read and discarded. The 2601B-PULSE places any remotely generated errors into its
error queue. When the optional format string is not specified, this command is equivalent to
tspnet.write(), except that a termination is automatically added to the end of the command.
Example 1
tspnet.execute(instrumentID, "runScript()")
Command the remote device to run a script named runScript.
Example 2
tspnet.timeout = 5
id_instr = tspnet.connect("192.0.2.23", 23, "*rst\r\n")
tspnet.termination(id_instr, tspnet.TERM_CRLF)
tspnet.execute(id_instr, "*idn?")
print("tspnet.execute returns:", tspnet.read(id_instr))
Print the *idn? string from the remote device.
Also see
tspnet.connect() (on page 11-380)
tspnet.read() (on page 11-383)
tspnet.termination() (on page 11-385)
tspnet.write() (on page 11-390)

Tektronix Keithley 2601B-PULSE Specifications

General

Brand	Tektronix
Model	Keithley 2601B-PULSE
Category	Measuring Instruments
Language	English