![background image](http://html2.mh-extra.com/html/keithley/system-sourcemeter-2601b/system-sourcemeter-2601b_reference-manual_4009934516.webp)
Section 7: TSP command reference
Series 2600B System SourceMeter® Instrument Reference Manual
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
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-176)
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
Summary of Contents for System SourceMeter 2601B
Page 841: ......