Keithley 2657A, Reference Manual, Page: 311 / 805

Section 6: Instrument programming Model 2657A High Power System SourceMeter® Instrument Reference Manual
6-62 2657A-901-01 Rev. B/December 2012
Using TSP-Net with any ethernet-enabled device
Refer to
TSP command reference (on page 7-1) for details about the commands presented in this
section.
The Model 2657A has Auto-MDIX, so you can use either a LAN crossover cable or a LAN straight-
through cable to connect directly from the Model 2657A to an ethernet device or to a hub.
To set up communication to a remote ethernet 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 will be 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 tspnet.connect() (on page 7-359) for additional detail.
To setup communication to a remote ethernet-enabled device that is not TSP enabled:
1. 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 tspnet.connect() (on page 7-359) for additional detail.
To communicate to a remote ethernet device from the Model 2657A:
1. Connect to the remote device using one of the above procedures. If the Model 2657A cannot
make a connection to the remote device, it generates a timeout error. Use
tspnet.timeout
to
set the timeout value. The default timeout value is 20 seconds.
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 2657A 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 2657A
suspends operation until the remote device responds or a timeout error 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()
.
NOTE