Read line of text from device and include terminator
tline = fgets(obj)
[tline,count] = fgets(obj)
[tline,count,msg] = fgets(obj)
tline = fgets(obj) reads
one line of text from the device connected to the serial port object,
and returns the data to
tline. This returned data
includes the terminator with the text line. To exclude the terminator,
[tline,count] = fgets(obj) returns
the number of values read to
count, including the
[tline,count,msg] = fgets(obj) returns
a warning message to
msg if the read operation
Create the serial port object
a Tektronix® TDS 210 oscilloscope, and write the
the scope to return serial port communications settings.
s = serial('COM1'); fopen(s) fprintf(s,'RS232?')
Because the default value for the
continuous, data is automatically returned to
the input buffer.
ans = 17
fgets to read the data returned from
the previous write operation, and include the terminator.
settings = fgets(s)
settings = 9600;0;0;NONE;LF
ans = 17
s from the scope, and remove
memory and the workspace.
fclose(s) delete(s) clear s
Before you can read text from the device, it must be connected
obj with the
A connected serial port object has a
open. An error is returned if you attempt
to perform a read operation while
obj is not connected
to the device.
msg is not included as an output argument
and the read operation was not successful, then a warning message
is returned to the command line.
ValuesReceived property value is increased
by the number of values read – including the terminator –
fgets is issued.
A read operation with
fgets blocks access
to the MATLAB® command line until:
The terminator specified by the
The time specified by the
The input buffer is filled.