Section 7: Command reference
Model 2651A High Power System SourceMeter® Instrument Reference Manual
7-362
2651A-901-01 Rev. A / March 2011
Usage
connectionID
= tspnet.connect(
ipAddress
)
connectionID
= tspnet.connect(
ipAddress
,
portNumber
,
initString
)
connectionID
The connection ID to be used as a handle in all other tspnet function calls
ipAddress
IP address to which to connect
portNumber
Port number
initString
Initialization string to send to
ipAddress
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 2651A 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-enabled device. Depending on the state of
tspnet.tsp.abortonconnect
, the Model 2651A
sends an
abort
command to the remote device on connection. The Model 2651A also enables TSP prompts on
the remote device and error management. The Model 2651A 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
tspnet.disconnect(myID)
end
Connect to a TSP-enabled device.
Example 2
myID = tspnet.connect("192.0.2.1", 1394,
"*rst\r\n")
if myID then
-- Use myID as needed here
tspnet.disconnect(myID)
end
Connect to a device that is not TSP-enabled.
Also see
(on page 7-136)
(on page 7-139)
(on page 7-369)