serialport

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

Описание

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

Создание

Описание

пример

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

s = serialport(port,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

Символ Терминатора для чтения и записи линий, возвращенных как "LF", "CR", или "CR/LF". Установите это свойство с configureTerminator функция.

Пример: "CR"

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

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

Пример: @myFun

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

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

Пример: 128

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

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

Пример: "off"

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

Функция обратного вызова инициирована ошибкой, возвращенной как указатель на функцию.

Пример: @myErrFun

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

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

Пример: datetime()

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char | string | struct | table | cell | function_handle | categorical | datetime | duration | calendarDuration | fi
Поддержка комплексного числа: Да

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

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

Для просмотра документации необходимо авторизоваться на сайте