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