
Model 2461 Interactive SourceMeter® Instrument Reference Manual
Section 3: Functions and features
2461-901-01 A/November 2015
3-163
Using TSP-Net with any ethernet-enabled instrument
Refer to
(on page 8-1) for details about the commands presented in this
section.
The Model 2461 LAN port is auto-sensing (Auto-MDIX), so you can use either a LAN crossover cable
or a LAN straight-through cable to connect directly from the Model 2461 to an ethernet device or to a
hub.
To set up communication to a remote ethernet-enabled instrument that is TSP
®
enabled:
1. Send the following command to configure TSP-Net to send an abort command when a
connection to a TSP instrument is established:
tspnet.tsp.abortonconnect = 1
If the scripts are allowed to run, the connection is made, but the remote instrument may be busy.
2. Send the command:
connectionID
= tspnet.connect(
ipAddress
)
Where:
•
connectionID
is the connection ID that will be used as a handle in all other TSP-Net function calls.
•
ipAddress
is the IP address of the remote instrument.
See
(on page 8-325) for additional detail.
To set up communication to a remote ethernet-enabled device that is not TSP enabled:
Send the command:
connectionID
= tspnet.connect(
ipAddress
,
portNumber
,
initString
)
Where:
•
connectionID
is the connection ID that will be used as a handle in all other
tspnet
function calls.
•
ipAddress
is the IP address of the remote device.
•
portNumber
is the port number of the remote device.
•
initString
is the initialization string that is to be sent to
ipAddress
.
See
(on page 8-325) for additional detail.
To communicate to a remote ethernet device from the Model 2461:
1. Connect to the remote device using one of the above procedures. If the Model 2461 cannot make
a connection to the remote device, it generates a timeout event. Use
tspnet.timeout
to set
the timeout value. The default timeout value is 20 s.
2. Use
tspnet.write()
or
tspnet.execute()
to send strings to a remote device. If you use:
tspnet.write()
: Strings are sent to the device exactly as indicated, and you must supply
any needed termination characters.
tspnet.execute()
: The Model 2461 appends termination characters to all strings that are
sent. Use
tspnet.termination()
to specify the termination character.
3. To retrieve responses from the remote instrument, use
tspnet.read()
. The Model 2461
suspends operation until the remote device responds or a timeout event is generated. To check if
data is available from the remote instrument, use
tspnet.readavailable()
.
4. Disconnect from the remote device using the
tspnet.disconnect()
function. Terminate all
remote connections using
tspnet.reset()
.