Model 2657A High Power System SourceMeter® Instrument Reference Manual Section 7: TSP command reference
2657A-901-01 Rev. B/December 2012 7-171
Also see
RS-232 interface operation (on page 2-88)
serial.baud
(on page 7-168)
serial.databits
(on page 7-169)
serial.flowcontrol
(on page 7-169)
serial.read()
This function reads available characters (data) from the serial port.
Type TSP-Link accessible Affected by Where saved Default value
Function Yes
Usage
data = serial.read(maxchars)
data
A string that consists of all data read from the serial port
maxchars
An integer that specifies the maximum number of characters to read
Details
This function reads available characters from the serial port. It does not wait for new characters to arrive. As long
as maxchars is less than 200 characters, all characters that are received by the serial port (before the
serial.read() command is executed) are returned. If too many characters are received between calls to this
function, the RS-232 buffers will overflow and some characters may be lost.
Call this function as many times as necessary to receive the required number of characters. For optimal
performance, use a small delay between repeated calls to this function.
The data returned is the raw data stream read from the port. No characters, such as control characters or
terminator characters, are interpreted.
If you attempt to use this function when the serial port is enabled as a command interface, a settings conflict
error is generated.
Example
data = serial.read(200)
print(data)
Read data from the serial port.
Output:
John Doe
The above output indicates that the string "John
Doe" was read from the serial port.
Also see
serial.write() (on page 7-171)
serial.write()
This function writes data to the serial port.
Type TSP-Link accessible Affected by Where saved Default value
Function Yes
Usage
serial.write(data)
data
A string representing the data to write