Tektronix KEITHLEY SourceMeter 2606B Reference Manual page 766

Model 2606B System SourceMeter® Instrument Reference Manual
tspnet.connect()
This function establishes a network connection with another LAN instrument or device through the LAN interface.
Type TSP-Link accessible
Function No
Usage
connectionID = tspnet.connect("ipAddress")
connectionID = tspnet.connect("ipAddress", portNumber, "initString")
connectionID
ipAddress
portNumber
initString
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 2606B 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 2606B sends an abort command to the remote
device on connection.
The 2606B also enables TSP prompts on the remote device and error management. The 2606B
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. 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)
end
Connect to a TSP-enabled device.
2606B-901-01 Rev. C November 2021
Affected by Where saved
The connection ID to be used as a handle in all other tspnet function calls
IP address to which to connect in a string; accepts IP address or host name when
trying to connect
Port number (default 5025)
Initialization string to send to ipAddress
Section 15: TSP command reference
Default value
15-393