Количество байтов, доступных во входном буфере, заданном как двойное. Это свойство только для чтения указывает на количество байтов, в настоящее время доступных, чтобы быть считанным из входного буфера. Значение свойства постоянно обновляется, когда входной буфер заполнен, и установлен в 0 после того, как функция fopen выпущена.

Можно использовать BytesAvailable только при чтении данных асинхронно. Это вызвано тем, что при чтении данных синхронно, управление возвращено в командную строку ^MATLAB® только после того, как входной буфер будет пуст. Поэтому значение BytesAvailable всегда 0.

Значение BytesAvailable может колебаться от нуля до размера входного буфера. Используйте свойство InputBufferSize задать размер входного буфера. Используйте свойство ValuesReceived возвратить общее количество чтения значений.

Примеры. BytesAvailable

Типы данных: double

Размер входного буфера в байтах, заданных как двойное. Вы конфигурируете InputBufferSize как общее количество байтов, которые могут быть сохранены во входном буфере во время операции чтения.

Операция чтения отключена, если объем данных, сохраненный во входном буфере, равняется значению InputBufferSize. Можно считать текстовые данные с fgetl, fget или функциями fscanf. Можно считать двоичные данные с функцией fread.

Можно сконфигурировать InputBufferSize только, когда объект последовательного порта отключается от устройства. Можно сконфигурировать его прежде, чем вызвать функцию fopen. Вы отключаете объект с функцией fclose. Разъединенный объект имеет значение свойства Status closed.

Если вы конфигурируете InputBufferSize, в то время как существуют данные во входном буфере, что данные очищены.

Примеры. InputBufferSize = 768;

Типы данных: double

Задайте, является ли асинхронная операция чтения непрерывной или ручной, задана как manual или continuous. Если ReadAsyncMode является continuous, объект последовательного порта постоянно запрашивает устройство, чтобы определить, доступны ли данные, чтобы быть считанными. Если данные доступны, это автоматически читается и сохранено во входном буфере. Если выпущено, функция readasync проигнорирована.

Если ReadAsyncMode является manual, объект не запрашивает устройство, чтобы определить, доступны ли данные, чтобы быть считанными. Вместо этого необходимо вручную выпустить функцию readasync, чтобы выполнить асинхронную операцию чтения. Поскольку проверки readasync на терминатор строки, эта функция может быть медленной. Чтобы увеличить скорость, сконфигурируйте ReadAsyncMode к continuous.

Чтобы определить объем данных, доступный во входном буфере, используйте свойство BytesAvailable. Или для значения ReadAsyncMode, можно принести данные в MATLAB workspace с одной из синхронных функций чтения, таких как fscanf, fgetl, fgets или для fread.

Примеры. ReadAsyncMode = 'руководство';

Типы данных: char | string

Время ожидания, чтобы завершить операцию чтения или операцию записи, заданную как двойное. Вы конфигурируете Timeout, чтобы быть максимальным временем (в секундах), чтобы ожидать, чтобы завершить операцию чтения или операцию записи. Значение по умолчанию секунд 10 используется, если вы не задаете различное значение. Тайм-ауты округлены вверх к целым секундам.

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

Примеры. Тайм-аут = 30;

Типы данных: double

Состояние асинхронной операции чтения или операции записи, заданной как idle, read, write или read&write. Это свойство только для чтения указывает, происходят ли асинхронная операция чтения или операция записи. Если TransferStatus является idle, никакие асинхронные операции чтения или операции записи не происходят. Если это - read, асинхронная операция чтения происходит. Если это - write, асинхронная операция записи происходит. Если TransferStatus является read&write, и асинхронное чтение и асинхронная операция записи происходят.

Можно записать данные асинхронно с помощью функций fwrite или fprintf. Можно считать данные асинхронно с помощью функции readasync, или путем конфигурирования свойства ReadAsyncMode к continuous. В то время как readasync выполняется, TransferStatus может указать, что данные считываются даже при том, что данные не заполняют входной буфер. Если ReadAsyncMode является continuous, TransferStatus указывает, что данные только для чтения, когда данные заполняют входной буфер.

Можно выполнить асинхронное чтение и асинхронную операцию записи одновременно, потому что последовательные порты имеют отдельное чтение и контакты записи.

Сводные данные возможные значения:

Примеры. TransferStatus

Типы данных: char | string

Общее количество значений считано из устройства, заданного как двойное. Это - свойство только для чтения, и значение обновляется после каждой успешной операции чтения и устанавливается к 0 после того, как функция fopen выпущена. Если терминатор строки читается из устройства, то это значение отражается ValuesReceived.

Если вы считываете данные асинхронно, используйте свойство BytesAvailable возвратить количество байтов, в настоящее время доступных во входном буфере.

При выполнении операции чтения полученные данные представлены значениями, а не байтами. Значение состоит из одного или нескольких байтов. Например, одно значение uint32 состоит из четырех байтов.

Например, создайте объект последовательного порта, сопоставленный с последовательным портом COM1, и откройте связь.

s = serial('COM1');
fopen(s)

Если вы пишете команду RS232? и читаете назад ответ с помощью fscanf, ValuesReceived является 17, потому что инструмент сконфигурирован, чтобы отправить терминатор строки LF.

fprintf(s,'RS232?')
out = fscanf(s)
out =
9600;0;0;NONE;LF
s.ValuesReceived
ans =
    17

Примеры. ValuesReceived

Типы данных: double

Количество байтов в настоящее время в буфере вывода, заданном как двойное. Это свойство только для чтения указывает на количество байтов в настоящее время в буфере вывода, ожидающем, чтобы быть записанным в устройство. Значение свойства постоянно обновляется, когда буфер вывода заполнен и освобожден и установлен в 0 после того, как функция fopen выпущена.

Можно использовать BytesToOutput только при записывании данные асинхронно. Это вызвано тем, что при записывании данные синхронно, управление возвращено в командную строку MATLAB только после того, как буфер вывода будет пуст. Поэтому значением BytesToOutput всегда является 0.

Используйте свойство ValuesSent возвратить общее количество значений, записанных в устройство.

Примеры. BytesToOutput

Типы данных: double

Размер буфера вывода в байтах, заданных как двойное. Вы конфигурируете OutputBufferSize как общее количество байтов, которые могут быть сохранены в буфере вывода во время операции записи.

Можно сконфигурировать OutputBufferSize только, когда объект последовательного порта отключается от устройства. Можно сконфигурировать его прежде, чем вызвать функцию fopen. Вы отключаете объект с функцией fclose. Разъединенный объект имеет значение свойства Status closed.

Ошибка происходит, если буфер вывода не может содержать все данные, которые будут записаны. Вы пишете текстовые данные с функцией fprintf. Вы пишете двоичные данные с функцией fwrite.

Примеры. OutputBufferSize = 256;

Типы данных: double

Общее количество значений записано в устройство, заданное как двойное. Это - свойство только для чтения, и значение обновляется после каждой успешной операции записи и устанавливается к 0 после того, как функция fopen выпущена. Если вы пишете терминатор строки, ValuesSent отражает это значение.

Если вы записываете данные асинхронно, используйте свойство BytesToOutput возвращать количество байтов в настоящее время в буфере вывода.

При выполнении операции записи передаваемые данные представлены значениями, а не байтами. Значение состоит из одного или нескольких байтов. Например, одно значение uint32 состоит из четырех байтов.

Например, создайте объект последовательного порта, сопоставленный с последовательным портом COM1, и откройте связь.

s = serial('COM1');
fopen(s)

Если вы пишете команду *IDN? с помощью функции fprintf, ValuesSent является 6, потому что форматом данных по умолчанию является %s\n, и терминатор строки был записан.

fprintf(s,'*IDN?')
s.ValuesSent
ans =
    6

Примеры. ValuesSent

Типы данных: double

Состояние подключения устройства последовательного порта, возвращенного как closed или open. Это свойство только для чтения указывает, соединяется ли объект последовательного порта с устройством. Если Status является closed, объект последовательного порта не соединяется с устройством. Если Status является open, объект последовательного порта соединяется с устройством.

Прежде чем можно будет записать или считать данные, необходимо соединить объект последовательного порта с устройством с функцией fopen. Используйте функцию fclose, чтобы отключить объект последовательного порта от устройства.

Примеры. Состояние

Типы данных: char | string

Состояние контакта DTR, заданного как on или off. Если DataTerminalReady является on, контакт Data Terminal Ready (DTR) утверждается. Если DataTerminalReady является off, контакт DTR не утверждается.

В нормальном использовании DTR и контакты Data Set Ready (DSR) работают совместно и используются, чтобы сигнализировать, соединяются ли устройства и приводятся в действие. Однако нет ничего в стандарте RS-232, который утверждает, что контакт DTR должен использоваться в любом особенном методе. Например, DTR и DSR могут использоваться для квитирования. Необходимо обратиться к документации устройства, чтобы определить ее определенное поведение контакта.

Можно возвратить значение контакта DSR со свойством PinStatus.

Примеры. DataTerminalReady = 'off';

Типы данных: char | string

Метод управления потока данных, заданный как none, hardware или software. Если FlowControl является none, управление потоком данных (квитирование) не используется. Если FlowControl является hardware, аппаратное квитирование используется, чтобы управлять потоком данных. Если FlowControl является software, программное квитирование используется, чтобы управлять потоком данных.

Аппаратные средства, квитирующие обычно, используют Request To Send (RTS) и контакты Clear to Send (CTS), чтобы управлять потоком данных. Программное квитирование использует управляющие символы (Xon и Xoff), чтобы управлять потоком данных.

Можно возвратить значение контакта CTS со свойством PinStatus. Можно задать значение контакта RTS со свойством RequestToSend. Однако, если FlowControl является hardware, и вы задаете значение для RequestToSend, то значение не может соблюдаться.

Примеры. FlowControl = 'аппаратные средства';

Типы данных: char | string

Состояние CD, CTS, DSR, и контактов RI, возвратилось как структура. Это свойство только для чтения возвращает массив структур, который содержит поля CarrierDetect, ClearToSend, DataSetReady и RingIndicator. Эти поля указывают на состояние обнаружения несущей (CD), Clear to Send (CTS), Data Set Ready (DSR) и контактов Ring Indicator (RI), соответственно.

PinStatus может быть on или off для любого из этих полей. Значение on указывает, что связанный контакт утверждается. Значение off указывает, что связанный контакт не утверждается. Событие изменения состояния контакта происходит, когда любой из этих контактов изменяет его состояние. Событие изменения состояния контакта выполняется, вызов назад функционируют заданные PinStatusFcn.

В нормальном использовании работают совместно Data Terminal Ready (DTR) и контакты DSR, в то время как Request To Send (RTS) и контакты CTS работают совместно. Можно задать состояние контакта DTR со свойством DataTerminalReady. Можно задать состояние контакта RTS со свойством RequestToSend.

Примеры. PinStatus

Типы данных: struct

Состояние контакта RTS, заданного как on или off. Если RequestToSend является on, контакт Request To Send (RTS) утверждается. Если RequestToSend является off, контакт RTS не утверждается.

В нормальном использовании RTS и контакты Clear to Send (CTS) работают совместно и используются в качестве стандартных контактов квитирования для передачи данных. В этом случае RTS и CTS автоматически управляемы DTE и DCE. Однако нет ничего в стандарте RS-232, который требует, чтобы контакт RTS использовался в любом особенном методе. Поэтому, если вы вручную конфигурируете значение RequestToSend, это, вероятно, для нестандартных операций.

Если ваше устройство не использует аппаратное квитирование стандартным способом, и необходимо вручную сконфигурировать RequestToSend, сконфигурировать свойство FlowControl к none. В противном случае значение RequestToSend, которое вы задаете, не может соблюдаться. Обратитесь к своей документации устройства, чтобы определить ее определенное поведение контакта.

Можно возвратить значение контакта CTS со свойством PinStatus.

Примеры. RequestToSend = 'off';

Типы данных: char | string

Уровень детализации информации сохранен в файл записи, заданный как compact или verbose. Если RecordDetail является compact, количество значений, записанных в устройство, количество значений, считанных из устройства, типа данных значений, и информация о событии сохранена в файл записи. Если RecordDetail является verbose, данные, записанные в устройство и данные, считанные из устройства, также сохраняются к файлу записи.

Сводные данные возможных значений:

Примеры. RecordDetail = 'многословный';

Типы данных: char | string

Метод для того, чтобы сохранить данные и информацию о событии в файлах записи, заданных как overwrite, append или index. Если RecordMode является overwrite, файл записи перезаписывается, каждая запись времени инициируется. Если RecordMode является append, данные добавлен к файлу записи, каждая запись времени инициируется. Если RecordMode является index, различный файл записи создается, каждая запись времени инициируется, каждый с индексируемым именем файла.

Можно сконфигурировать RecordMode только, когда объект не записывает. Вы отключаете запись с функцией record. Объект, который не записывает, имеет значение свойства RecordStatus off.

Вы задаете имя файла записи со свойством RecordName. Индексируемое имя файла следует за предписанным рядом правил.

Сводные данные возможных значений:

Например, запишите последовательные данные с помощью свойств записи. Создайте объект последовательного порта и откройте связь.

s = serial('COM1');
fopen(s)

Задайте имя файла записи со свойством RecordName, сконфигурируйте RecordMode к index и инициируйте запись.

s.RecordName = 'MyRecord.txt';
s.RecordMode = 'index';
record(s)

Имя файла записи автоматически обновляется с индексируемым именем файла после того, как запись будет выключена.

record(s,'off')
s.RecordName
ans =
MyRecord01.txt

Отключите s от периферийного устройства, удалите s из памяти и удалите s из MATLAB workspace.

fclose(s)
delete(s)
clear s

Примеры. RecordMode = 'индекс';

Типы данных: char | string

Имя файла записи, заданного как строка. Можно задать любое значение для RecordName - включая путь к каталогу - если имя файла поддержано операционной системой.

Именем файла записи по умолчанию является record.txt, который используется, если вы записываете файл данных и не задаете другое имя.

MATLAB поддерживает любое имя файла, поддержанное вашей операционной системой. Можно получить доступ к файлу с помощью функции type. Например, если вы называете файл записи, MyRecord.txt, чтобы ввести этот файл в командной строке MATLAB, входит:

type('MyRecord.txt')

Можно задать, сохранены ли данные и информация о событии в один дисковый файл или в несколько дисковых файлов со свойством RecordMode. Если RecordMode является index, имя файла следует за предписанным рядом правил.

Можно сконфигурировать RecordName только, когда объект не записывает. Вы отключаете запись с функцией record. Объект, который не записывает, имеет значение свойства RecordStatus off.

Примеры. RecordName = 'MonthlyDataFile_April';

Типы данных: char | string

Состояние записи последовательных данных и информации о событии, возвращенной как on или off. Это свойство только для чтения указывает, ли включена запись или прочь, которым управляет функция record. Если RecordStatus является off, то данные и информация о событии не сохранены в файл записи. Если RecordStatus является on, то данные и информация о событии сохранены в файл записи, заданный RecordName.

Используйте функцию record, чтобы инициировать или завершить запись. RecordStatus автоматически сконфигурирован, чтобы отразить состояние записи.

Примеры. RecordStatus

Типы данных: char | string