19-222 Return to Section Topics 2600AS-901-01 Rev. B / September 2008
Section 19: Remote Commands Series 2600A System SourceMeter® Instruments Reference Manual
tspnet.connect
Function Establish a connection to a remote instrument.
TSP-Link
accessibility
This function can be accessed from a remote TSP-Link node.
Usage To connect to any remote instrument on the LAN:
connection_id = tspnet.connect(ip_address, port_number,
initialize_string)
To connect to a TSP-enabled remote instrument on the LAN:
connection_id = tspnet.connect(ip_address)
connection_id Integer value used as a handle for other tspnet commands.
ip_address String variable for passing the IP address.
port_number Integer value of the port number.
initialize_string The initialization string to send.
Remarks • This command connects to another instrument by way of the LAN interface (using the optionally-
specified port number). The default port number is 5025. If the port number is 23, the interface
will use the Telnet protocol (and set appropriate termination characters) to communicate with the
instrument.
• If a port number and initialization string are provided, the remote instrument is assumed to be
non-TSP-enabled. The Series 2600A does not perform any extra processing, prompt handling,
error handling, or sending of commands. Additionally, the tspnet.tsp commands do not apply
for use on this remote instrument.
• If no port number and initialization string is provided, the remote instrument is assumed to be a
Keithley Instruments TSP-enabled instrument. Depending on the state of
tspnet.tsp.abortonconnect, the Series 2600A sends an abort to the remote instrument
upon connection. The Series 2600A also enables TSP prompts on the remote instrument and
error management. The Series 2600A places remote errors from the TSP-enabled instrument in
its own error queue and prefaces these errors with "Remote Error," followed by an error
description. Do not manually change either the prompt functionality (localnode.prompts) or
show errors functionality (localnode.showerrors) on the remote TSP-enabled instrument, or
subsequent tspnet.tsp.* commands using the connection may fail.
• You can simultaneously connect to a maximum of 32 remote instruments.
• Errors:
Connection Failed
Connection Failed, Timeout
Invalid IP Address or Port Number
Example To connect to a TSP-enabled instrument:
mytspconnection = tspnet.connect(“10.80.64.216”)
To connect to a non-TSP-enabled instrument:
myconnection = tspnet.connect("192.168.1.51", 1394, "*rst\r\n")