7: TSP command reference Series 2600B System SourceMeter® Instrument
7-176 2600BS-901-01 Rev. B / May 2013
Also see
RS-232 interface operation (on page 2-108)
serial.baud (on page 7-173)
serial.databits (on page 7-174)
serial.flowcontrol (on page 7-174)
serial.read()
This function reads available characters (data) from the serial port.
Type TSP-Link accessible Affected by Where saved Default value
Usage
data = serial.read(maxchars)
A string that consists of all data read from the serial port
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
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-176)
serial.write()
This function writes data to the serial port.
Type TSP-Link accessible Affected by Where saved Default value
Usage
serial.write(data)
A string representing the data to write