fgetl (serial)

(Чтобы быть удаленным) Прочитанная строка текста ASCII от устройства и терминатора строки отбрасывания

Этот serial объектная функция будет удалена в будущем релизе. Использование 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® платформа, создайте объект последовательного порта 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 не включен как выходной аргумент, и операция чтения не была успешна, затем предупреждающее сообщение возвращено в командную строку.

ValuesReceived значение свойства увеличено на количество чтения значений – включая терминатор строки – каждый раз fgetl выпущен.

Примечание

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

Правила для Завершения Операции чтения с fgetl

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

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

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

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

Примечание

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

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

развернуть все

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

Смотрите также

Функции

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