Serial Explorer

Свяжитесь с устройствами, соединенными к последовательному порту

Описание

Приложение Serial Explorer создает связь с последовательным портом на вашей машине. После того, как вы свяжете с последовательным портом, можно связаться с ним, построить и анализировать данные, экспортировать данные в рабочую область и сгенерировать MATLAB® код.

Используя это приложение, вы можете:

  • Сконфигурируйте коммуникационные свойства последовательного порта.

  • Отправьте двоичный файл или представьте данные в виде строки к подключенному последовательному порту.

  • Считайте двоичный файл или представьте в виде строки данные, отправленные от подключенного последовательного порта.

  • Отобразите данные на графике в окне рисунка.

  • Анализируйте данные путем просмотра его в приложении Signal Analyzer (Signal Processing Toolbox).

  • Экспортируйте данные в рабочую область.

  • Сгенерируйте файл Live Script MATLAB, который использует serialport интерфейс.

Serial Explorer app

Откройте приложение Serial Explorer

  • Панель инструментов MATLAB: На вкладке Apps, под Test and Measurement, кликают по значку приложения.

  • Командная строка MATLAB: Войти serialExplorer.

Примеры

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

В этом примере запишите отключенные ASCII данные в устройство последовательного порта и считайте данные назад из него. Устройством в этом примере является Arduino® Uno, который был уже запрограммирован с пользовательскими командами и ответами.

Откройте приложение Serial Explorer или от вкладки Apps в панели инструментов MATLAB или от командной строки MATLAB.

В панели Device List выберите устройство последовательного порта, с которым вы хотите связаться. В этом примере устройство соединяется к COM4.

Serial Explorer app showing Device List pane.

Сконфигурируйте свойства Connection и Communication от Property Inspector. Задайте эти свойства устройства прежде, чем записать и считать данные, чтобы совпадать с соответствующим значением для подключенного устройства. В данном примере измените BaudRate в 38400.

Serial Explorer app showing Property Inspector.

Некоторые устройства последовательного порта могут принять запросы строки и ответить на них. В этом примере связанный Uno Arduino был запрограммирован, чтобы получить и ответить на настроенные команды строки. Команды в этом примере не работают на другие устройства.

Отправьте Send Status? команда к устройству. В разделе Write, набор Data Format к ASCII-Terminated String. Data Type превращается в string поскольку это - единственный возможный вариант. Задайте Data to Write как Send Status?. Нажмите Write, чтобы записать данные в устройство последовательного порта. Для отключенных ASCII операций записи строки терминатор строки записи, заданный свойством Terminator, автоматически добавлен к записанным данным.

Serial Explorer app Write section for ASCII data.

Можно просмотреть ответ на эту команду путем чтения из устройства последовательного порта. В разделе Read, набор Data Format к ASCII-Terminated String, который изменяет Data Type в string. Считайте данные из устройства путем нажатия на Read. Данные считаны до первого вхождения терминатора строки.

Serial Explorer app Read section for ASCII data.

Просмотрите и запись и операции чтения в панели Communication Log. Операция чтения показывает сообщению Arduino connected to 'COM4'. Можно выбрать строку, чтобы экспортировать его, когда переменная к рабочей области путем выполнения шагов в Экспортирует Данные из Коммуникационного Журнала и Генерирует СКРИПТ MATLAB.

Serial Explorer app Communication Log pane.

Панель MATLAB Code Log показывает код для этих операций. Можно экспортировать этот код, когда файл Live Script MATLAB путем выполнения шагов в Экспортирует Данные из Коммуникационного Журнала и Генерирует СКРИПТ MATLAB.

Serial Explorer app MATLAB Code Log pane.

В этом примере запишите отключенные ASCII данные в устройство последовательного порта и считайте данные назад из него. Устройство в этом примере является Uno Arduino, который был уже запрограммирован с пользовательскими командами и ответами.

Откройте приложение Serial Explorer или от вкладки Apps в панели инструментов MATLAB или от командной строки MATLAB.

В панели Device List выберите устройство последовательного порта, с которым вы хотите связаться. В этом примере устройство соединяется к COM4.

Serial Explorer app showing Device List pane.

Сконфигурируйте свойства Connection и Communication от Property Inspector. Задайте эти свойства устройства прежде, чем записать и считать данные, чтобы совпадать с соответствующим значением для подключенного устройства. В данном примере измените BaudRate в 38400.

Serial Explorer app showing Property Inspector.

Некоторые устройства последовательного порта могут принять запросы строки и ответить на них. В этом примере связанный Uno Arduino был запрограммирован, чтобы получить и ответить на настроенные команды строки. Команды в этом примере не работают на другие устройства.

Отправьте Send Sine-Wave Data команда к устройству. В разделе Write, набор Data Format к ASCII-Terminated String. Data Type превращается в string поскольку это - единственный возможный вариант. Задайте Data to Write как Send Sine-Wave Data. Нажмите Write, чтобы записать данные в устройство последовательного порта. Для отключенных ASCII операций записи строки терминатор строки записи, заданный свойством Terminator, автоматически добавлен к записанным данным.

Serial Explorer app Write section for ASCII data.

Отправьте другую команду в устройство. В командной строке MATLAB создайте переменную рабочей области для этой команды.

command = "Send Arbitrary Waveform";

Выберите Workspace Variable и выберите command опция. Нажмите Write.

Serial Explorer app Write section for ASCII data.

Прежде, чем считать данные из устройства последовательного порта, необходимо задать правильный формат данных и тип. В этом примере ответы на команды строки хранятся как двоичные данные с одинарной точностью. В разделе Read, набор Data Format к Binary, и Data Type к single. Параметром Values Available является 300. Первые 100 значений являются ответом на Send Sine-Wave Data команда и остающиеся 200 значений являются ответом на Send Arbitrary Waveform команда.

Задайте Num Values to Read как 100. Считайте первые 100 значений данных из устройства последовательного порта путем нажатия на Read.

Serial Explorer app Read section for binary data.

Если вы не задаете значение для параметра Num Values to Read, можно считать все доступные значения. Считайте остающиеся 200 значений путем очистки параметра Num Values to Read и нажатия на Read.

Serial Explorer app Read section for binary data.

Просмотрите и запись и операции чтения в панели Communication Log. Можно выбрать строку, чтобы построить его, просмотреть его в приложении Signal Analyzer или экспортировать его как переменную к рабочей области. Выберите данные из первой операции чтения.

Serial Explorer app Communication Log pane.

Нажмите Plot в разделе Analyze.

Serial Explorer plot button.

Новое окно рисунка с графиком данных открывается. Можно изменить график и фигуру из командного окна.

Выберите другие данные об ответе и нажмите Plot снова. Другое окно рисунка с графиком данных открывается.

Панель MATLAB Code Log показывает код для этих операций (за исключением создания графика). Можно экспортировать этот код, когда файл Live Script MATLAB путем выполнения шагов в Экспортирует Данные из Коммуникационного Журнала и Генерирует СКРИПТ MATLAB.

Serial Explorer app MATLAB Code Log pane.

В этом примере постройте строку данных из Communication Log в новом окне рисунка. Можно отобразить на графике любые числовые данные, в которые вы записали или считали из последовательного порта.

Communication Log собирает все данные, в которые вы записали или считали из подключенного последовательного порта.

Выберите строку данных.

Serial Explorer Communication Log pane with row selected.

Нажмите Plot в разделе Analyze.

Serial Explorer plot button.

Новое окно рисунка с графиком данных открывается. Можно изменить график и фигуру из командного окна.

MATLAB figure window showing a plot of the selected row of data.

В этом примере используйте различные варианты для экспортирования данных и взаимодействий приложений.

Communication Log собирает все данные, в которые вы записали или считали из подключенного последовательного порта.

Выберите строку данных.

Serial Explorer app Communication Log pane.

Экспортируйте эту строку данных к рабочей области как переменная, заданная в Workspace Variable. Приложение обеспечивает имя переменной по умолчанию, но можно отредактировать его. Поменяйте имя переменной, нажмите Export и выберите опцию Export Selected Row.

Serial Explorer app showing Export Selected Row option.

Можно также экспортировать полноту Communication Log к рабочей области как timetable. Поменяйте имя переменной, нажмите Export и выберите опцию Export Communication Log.

Serial Explorer app showing Export Communication Log option.

Помимо экспортирования данных, можно также экспортировать код от панели MATLAB Code Log. Эта панель содержит весь serialport создание объекта, запишите, читайте, и операции настройки свойства, которые вы делаете в приложении.

Serial Explorer app MATLAB Code Log pane.

Сгенерируйте файл Live Script MATLAB и откройте его в Live Editor путем нажатия на Export и выбирания опции Generate MATLAB Script.

Serial Explorer app showing Generate MATLAB Script option.

После того, как файл Live Script открывается, можно изменить код, чтобы соответствовать потребностям и сохранить файл.

Параметры

Запишите раздел

Можно записать Binary или ASCII-Terminated String данные к последовательному порту.

Binary запись эквивалентна write функционируйте и ASCII-Terminated String запись эквивалентна writeline функция.

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

Зависимости

Если вы устанавливаете Data Format на ASCII-Terminated String, единственным возможным значением для этого параметра является string.

Если вы устанавливаете Data Format на Binary, значением по умолчанию этого параметра является uint8.

Этот параметр может быть установлен на uint64 или int64 только если вы выбираете опцию Workspace Variable вместо Data to Write.

Задайте данные, чтобы записать в последовательный порт. Данные записаны как тип, заданный Data Type, независимо от формата в этом параметре.

Выберите или этот параметр или Workspace Variable, чтобы записать данные.

Выберите существующую переменную рабочей области, чтобы записать в последовательный порт. Данные записаны как тип, заданный Data Type, независимо от типа данных переменной в рабочей области.

Если Data Format является Binary, можно выбрать следующие типы переменных рабочей области:

  • Строка (1 N) или столбец (N- 1) вектор из числовых значений

  • 1 N символьный вектор

  • Строковый скаляр 1 на 1

Если Data Format является ASCII-Terminated String, можно выбрать следующие типы переменных рабочей области:

  • 1 N символьный вектор

  • Строковый скаляр 1 на 1

Выберите или этот параметр или Data to Write, чтобы записать данные.

Нажмите эту кнопку, чтобы написать данные, заданные в Data to Write или Workspace Variable к последовательному порту как заданный Data Type. Если Data Format является ASCII-Terminated String, терминатор строки записи, заданный свойством Terminator, автоматически добавлен к записанным данным.

Эта кнопка эквивалентна выполнению write или writeline функции.

Считайте раздел

Считайте Binary или ASCII-Terminated String данные из последовательного порта. Binary чтение эквивалентно read функционируйте и ASCII-Terminated String чтение эквивалентно readline функция.

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

Зависимости

Если вы устанавливаете Data Format на ASCII-Terminated String, единственным возможным значением для этого параметра является string.

Если вы устанавливаете Data Format на Binary, значением по умолчанию этого параметра является uint8.

Задайте количество значений, чтобы читать как положительное целое число. Этот параметр должен быть меньше чем или равен Values Available. Если вы оставляете этот параметр пустым, приложение читает все доступные значения из последовательного порта с помощью заданного Data Type.

Зависимости

Чтобы включить этот параметр, установите Data Format на Binary.

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

Это - количество значений, доступных, чтобы читать в формате, заданном Data Type.

Зависимости

Чтобы включить этот параметр, установите Data Format на Binary.

Нажмите эту кнопку, чтобы считать данные из последовательного порта. Если Data Format является Binary, считайте количество значений, заданных Num Values to Read в форме, заданной Data Type. Если Data Format является ASCII-Terminated String, считайте данные до первого вхождения терминатора строки чтения, заданного свойством Terminator.

Эта кнопка эквивалентна read или readline функции.

Коммуникационный логарифмический раздел

Просмотрите данные в столбце Data Communication Log как BinaryASCII, или Hexadecimal, как применимый на основе типа данных. Этот параметр не изменяет исходное значение или тип данных данных. Для получения дополнительной информации об этих форматах, смотрите Преобразование типа данных.

Нажмите эту кнопку, чтобы очистить все содержимое Communication Log.

Анализируйте раздел

Нажмите эту кнопку, чтобы создать новое окно фигуры, которое отображает на графике данные, в настоящее время выбранные в Communication Log. Можно выбрать только одну строку данных, и выбранные данные должны быть числовыми.

В отличие от Write и Read, эта операция не получена в панели MATLAB Code Log.

Нажмите эту кнопку, чтобы запустить приложение Signal Analyzer (Signal Processing Toolbox) и отправить ему данные, в настоящее время выбранные в Communication Log. Можно выбрать только одну строку данных, и выбранные данные должны быть числовым вектором.

Необходимо было установить Signal Processing Toolbox™, чтобы использовать приложение Signal Analyzer.

Раздел экспорта

Отредактируйте имя переменной рабочей области, в которую вы хотите экспортировать данные. Export Selected Row и Export Communication Log опции в Export сохраняют ваши данные в рабочей области как переменная, заданная этим параметром.

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

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

  • Export Selected Row — Сохраните данные, в настоящее время выбранные в Communication Log к рабочей области как переменная, заданная Workspace Variable.

  • Export Communication Log — Сохраните все данные Communication Log к рабочей области как timetable с именем переменной, заданным Workspace Variable.

  • Generate MATLAB Script — Сгенерируйте файл Live Script MATLAB, заполненный с содержимым в MATLAB Code Log, и откройте его в Live Editor.

Инспектор свойств

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

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

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

Количество битов данных, чтобы передать по последовательному интерфейсу.

Количество битов раньше указывало на конец байта.

Тип бита четности, добавленный к данным, передается последовательным портом. Можно использовать этот параметр, чтобы добавить бит четности (также называемый контрольным битом) к данным. Добавление бита четности к строке двоичного кода является методом обнаружения ошибок в передаче данных путем гарантирования, что общее количество 1 бита является четным или нечетное.

Значение бита четности определяется числом единиц в данном наборе битов и установлено можно следующим образом.

Тип бита четностиЗначение бита четности
Если число единиц является четнымЕсли число единиц является нечетным
noneНикакой бит четности не установленНикакой бит четности не установлен
even01
odd10

Процесс управления уровень передачи данных на вашем последовательном порте. Выберите none не иметь никакого управления потоками, hardware позволять вашему оборудованию определить управление потоками или software позволять вашему программному обеспечению определить управление потоками.

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

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

Символы Терминатора для чтения и записи отключенных ASCII данных в виде LF, CR, CR/LF, или номер от 0 до 255. Терминатор строки чтения сопровождается терминатором строки записи, и эти два разделяются запятой. Кликните по вертикальному значку замещающего знакаVertical ellipsis icon, чтобы задать чтение и значения символа терминатора строки записи отдельно.

Последовательный порядок, в котором байты располагаются в большие численные значения. Если порядком байтов является little-endian, затем последовательный порт хранит первый байт в первом адресе памяти. Если порядком байтов является big-endian, затем последовательный порт хранит последний байт в первом адресе памяти.

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

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

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

Приложения

Функции

Введенный в R2021b