serialport

Связь с последовательным портом

Описание

serialport объект представляет последовательный клиент для связи с последовательным портом. После создания объекта используйте запись через точку, чтобы установить ее свойства.

Создание

Описание

пример

s = serialport(port,baudrate) подключения к последовательному порту заданы port со скоростью в бодах baudrate.

s = serialport(port,baudrate,Name,Value) подключения к последовательному порту и дополнительным свойствам наборов с помощью дополнительных аргументов пары "имя-значение".

s = serialport, без аргументов, подключений к последовательному порту с помощью настроек свойства последнего очищенного serialport экземпляр объекта. Сохраненными свойствами является PortBaudRateByteOrderFlowControlStopBitsDataBitsЧетностьТайм-аут, и Terminator. См. Свойства.

Входные параметры

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

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

Пример: "COM2"

Скорость в бодах для последовательной передачи в виде двойного.

Пример: 9600

Аргументы в виде пар имя-значение

Задайте дополнительные разделенные запятой пары Name,Value аргументы. Name имя аргумента и Value соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

Можно использовать Пары "имя-значение", чтобы установить DataBitsЧетностьStopBitsFlowControlByteOrder, и Timeout свойства объектов. См. Свойства для их типов данных и позволенных значений.

Пример: "Timeout",30

Свойства

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

Свойства создания объекта

Это свойство доступно только для чтения.

Последовательный порт для связи, возвращенной как строка.

Пример: "COM1"

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

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

Пример: 14400

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Четность, чтобы проверять, были ли данные потеряны или записаны, возвращены как "none", "even", или "odd".

Пример: "odd"

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

Количество битов, чтобы представлять один символ данных, возвращенных как 8, 7, 6, или 5.

Пример 8

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Шаблон битов, который указывает на конец символа или целой передачи, возвратился как 1, 1.5, или 2.

Пример 1

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Режим для уровня передачи данных управления, возвращенного как "none", "hardware", или "software".

Пример: "software"

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

Последовательный порядок, в котором байты располагаются в большие численные значения, возвратился как "little-endian" или "big-endian". Установите это свойство при создании объекта с помощью аргумента пары "имя-значение". Можно также изменить его после создания объекта с помощью записи через точку.

Пример: "little-endian"

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

Допустимое время в секундах, чтобы завершить операции чтения и операции записи, возвращенные как числовое значение. Установите это свойство при создании объекта с помощью аргумента пары "имя-значение". Можно также изменить его после создания объекта с помощью записи через точку.

Пример: 60

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Считайте и запишите свойства

Это свойство доступно только для чтения.

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

Пример: 1024

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

Это свойство доступно только для чтения.

Количество байтов записано в последовательный порт, возвращенный как числовое значение.

Пример: 512

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

Символ Терминатора для чтения и записи отключенных ASCII данных, возвращенных как "LF", "CR", или "CR/LF", или номер от 0 до 255, включительно. Если чтение и терминаторы строки записи отличаются, Terminator возвращен как 1x2 массив ячеек этих значений. Установите это свойство с configureTerminator функция.

Пример: "CR"

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

Свойства коллбэка

Байты доступный триггерный режим коллбэка, возвращенный как "off", "byte", или "terminator". Эта установка определяет, выключен ли коллбэк, инициирован количеством байтов, заданных BytesAvailableFcnCount, или инициированный терминатором строки задан Terminator. Установите это свойство с configureCallback функция.

Пример: "off"

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

Количество байтов данных, чтобы инициировать коллбэк, заданный BytesAvailableFcn, возвращенный как двойное. Это значение используется только когда BytesAvailableFcnMode свойством является "byte". Установите эти свойства с configureCallback функция.

Пример: 128

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Функция обратного вызова, инициированная байты доступное событие, возвращенное как указатель на функцию. Байты доступное событие сгенерировано путем получения определенного числа байтов или терминатора строки. Это свойство пусто, пока вы не присваиваете указатель на функцию. Установите это свойство с configureCallback функция.

Пример: @myFcn

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

Функция обратного вызова инициирована ошибочным событием, возвращенным как указатель на функцию. Ошибочное событие сгенерировано, когда асинхронное чтение или ошибка при записи происходят. Это свойство пусто, пока вы не присваиваете указатель на функцию.

Пример: @myErrFcn

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

Свойство общего назначения для пользовательских данных, возвращенных как любой MATLAB® тип данных. Например, можно использовать это свойство хранить данные, когда событие инициировано от функции обратного вызова.

Пример: datetime()

Функции объекта

readСчитайте данные из последовательного порта
readlineПрочитайте строку данных о строке ASCII из последовательного порта
readbinblockСчитайте один binblock данных из последовательного порта
writeЗапишите данные к последовательному порту
writelineЗапишите линию данных о ASCII к последовательному порту
writebinblockЗапишите один binblock данных к последовательному порту
writereadЗапишите команду в последовательный порт и считайте ответ
flushОчистите буферы устройства последовательного порта
configureTerminatorУстановите терминатор строки для связи строки ASCII с последовательным портом
configureCallbackУстановите функцию обратного вызова и инициируйте условие для связи с устройством последовательного порта
getpinstatusПолучите последовательное состояние контакта
setRTSУстановите последовательный контакт RTS
setDTRУстановите последовательный контакт DTR

Примеры

свернуть все

Считайте 16 значений uint32 данных из COM3 последовательный порт.

s = serialport("COM3",9600,"Timeout",5);
data = read(s,16,"uint32");
Введенный в R2019b