Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command refere
2461-901-01 A/November 2015 8-325
tspnet.connect()
This function establishes a network connection with another LAN instrument or device through the LAN interface.
Type TSP-Link accessible
Affected by Where saved Default value
Usage
connectionID = tspnet.connect(ipAddress)
connectionID = tspnet.connect(ipAddress, portNumber, initString)
The connection ID to be used as a handle in all other tspnet function calls
IP address to which to connect in a string
Port number (default 5025)
Initialization string to send to ipAddress
Details
This command connects a device to another device through the LAN interface. 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 2461 does not perform any extra processing, prompt handling, error
handling, or sending of commands. In addition, 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-enabled device. Depending on the state of the
tspnet.tsp.abortonconnect attribute, the Model 2461 sends an abort command to the remote
device on connection.
The Model 2461 also enables TSP prompts on the remote device and event management. The Model
2461 places remote errors and events from the TSP-enabled device in its own event queue and
prefaces these events with Remote Error, followed by an event description.
Do not manually change either the prompt functionality (localnode.prompts) or show events by
changing localnode.showerrors or localnode.showevents on the remote TSP-enabled
device. If you do this, subsequent tspnet.tsp.* commands using the connection may fail.
You can simultaneously connect to a maximum of 32 remote devices.
Example 1
instrumentID = tspnet.connect("192.0.2.1")
if instrumentID then
-- Use instrumentID as needed here
tspnet.disconnect(instrumentID)
device.