exponenta event banner

serialport

Подключение к последовательному порту

Описание

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

Создание

Описание

пример

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

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

s = serialport, без аргументов, подключается к последовательному порту с помощью настроек свойств последнего очищенного serialport экземпляр объекта. Сохраненные свойства: Port, BaudRate, ByteOrder, FlowControl, StopBits, DataBits, Parity, Timeout, и Terminator. См. раздел Свойства.

Входные аргументы

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

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

Пример: "COM2"

Скорость передачи для последовательной связи, заданная как двойная.

Пример: 9600

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

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

Можно использовать пары Наименование (Name) - Значение (Value) для установки DataBits, Parity, StopBits, FlowControl, ByteOrder, и 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 с последовательного порта
writeЗапись данных в последовательный порт
writelineЗапись строки данных ASCII в последовательный порт
flushОчистка буферов устройств последовательного порта
configureTerminatorУстановка терминатора для связи строки ASCII с последовательным портом
configureCallbackУстановка функции обратного вызова и условия запуска для связи с устройством последовательного порта
getpinstatusПолучение статуса последовательного контакта
setRTSУстановка последовательного контакта RTS
setDTRУстановка последовательного контакта DTR

Примеры

свернуть все

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

s = serialport("COM3",9600,"Timeout",5);
data = read(s,16,"uint32");

См. также

Функции

Представлен в R2019b