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