fgetl (serial)

(Будет удален) Считайте линию текста ASCII с устройства и сбросьте терминатор строки

Этот serial функция object будет удалена в следующем релизе. Использовать serialport вместо этого функции объекта. См. Вопросы совместимости.

Синтаксис

tline = fgetl(obj)
[tline,count] = fgetl(obj)
[tline,count,msg] = fgetl(obj)

Описание

tline = fgetl(obj) считывает одну линию текста ASCII с устройства, подключенного к объекту последовательного порта, obj, и возвращает данные в tline. Возвращенные данные не содержат терминатор строки с текстовой строкой. Чтобы включить терминатор строки, используйте fgets.

[tline,count] = fgetl(obj) возвращает количество значений, считанных в count, включая терминатор строки.

[tline,count,msg] = fgetl(obj) возвращает предупреждающее сообщение в msg если операция чтения была неудачной.

Примеры

В Windows® platform, создайте объект последовательного порта s, соедините s в Tektronix® осциллограф TDS 210 и запишите RS232? команду с fprintf функция. RS232? указывает область возможностей для возврата настроек связи последовательного порта.

s = serial('COM1');
fopen(s)
fprintf(s,'RS232?')

Потому что значение по умолчанию для ReadAsyncMode свойство continuousданные автоматически возвращаются во входной буфер.

s.BytesAvailable
ans =
    17

Использовать fgetl для чтения данных, возвращенных после предыдущей операции записи, и удаления терминатора строки.

settings = fgetl(s)
settings =
9600;0;0;NONE;LF
length(settings)
ans =
    16

Отсоедините s из возможностей и удалить s из памяти и рабочей области.

fclose(s)
delete(s)
clear s

Совет

Прежде чем вы сможете считать текст с устройства, он должен быть подключен к obj с fopen функция. Связанный объект последовательного порта имеет Status значение свойства open. Ошибка возвращается, если вы пытаетесь выполнить операцию чтения во время obj не подключен к устройству.

Если msg не включен в качестве выходного аргумента и операция чтения не была успешной, затем в командную строку возвращается предупреждающее сообщение.

The ValuesReceived значение свойства увеличивается на количество значений, считанных - включая терминатор строки - каждый раз fgetl выдается.

Примечание

Вы не можете использовать значения ASCII, больше 127 символов. Функция ограничена 127 двоичными символами.

Правила завершения операции чтения с помощью fgetl

Операция чтения с fgetl блокирует доступ к MATLAB® командная строка до:

  • Терминатор строки, заданный как Terminator достигается свойство.

  • Время, заданное как Timeout проходит свойство.

  • Входной буфер заполнен.

Примечание

Вы не можете использовать значения ASCII, больше 127 символов. Функция ограничена 127 двоичными символами.

Вопросы совместимости

расширить все

Не рекомендуемый запуск в R2019b

См. также

Функции

Представлено до R2006a