19-222
Return to
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
, 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")