Tspnet.connect() - Keithley 708B Reference Manual

Models 707B and 708B Switching Matrix Reference Manual

tspnet.connect()

This function connects the device processing the command to another device through the LAN interface.
Type TSP-Link accessible
Function Yes
Usage
connectionID = tspnet.connect(ipAddress)
connectionID = tspnet.connect(ipAddress, portNumber)
connectionID = tspnet.connect(ipAddress, portNumber, initString)
connectionID
ipAddress
portNumber
initString
Details
This command connects a device to another device through the LAN interface. The default port number is 5025.
If the portNumber is 23, the interface uses the Telnet protocol and sets appropriate termination characters to
communicate with the device.
If a portNumber and initString are provided, it is assumed that the remote device is not TSP-enabled. The
Model 707B or 708B does not perform any extra processing, prompt handling, error handling, or sending of
commands. Additionally, the tspnet.tsp.* commands cannot be used on devices that are not TSP-enabled.
If neither a portNumber nor an initString is provided, the remote device is assumed to be a Keithley
Instruments TSP-enbled device. Depending on the state of tspnet.tsp.abortonconnect, the Model 707B or
708B sends an abort command to the remote device on connection. The Model 707B or 708B also enables
TSP prompts on the remote device and error management. The Model 707B or 708B places remote errors from
the TSP-enabled device 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 by
changing localnode.showerrors on the remote TSP-enabled device, or subsequent tspnet.tsp.*
commands using the connection may fail.
You can simultaneously connect to a maximum of 32 remote devices.
Example 1
myID = tspnet.connect("192.0.2.1")
if myID then
-- Use myID as needed here
end
tspnet.disconnect(myID)
Example 2
myID = tspnet.connect("192.0.2.1", 1394,
"*rst\r\n")
if myID then
-- Use myID as needed here
end
tspnet.disconnect(myID)
707B-901-01 Rev. A / August 2010
Affected by
The connection ID to be used as a handle in all other tspnet function calls
IP address to which to connect
Port number
Initialization string to send to ipAddress
Where saved Default value
Connect to a TSP-enabled device.
Connect to a device that is not TSP-enabled.
Section 7: Command reference
7-229