TCP/IP Explorer

Соединитесь с и свяжитесь с сервером TCP/IP

Описание

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

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

  • Сконфигурируйте коммуникационные свойства TCP/IP.

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

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

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

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

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

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

Можно использовать это приложение только в качестве клиента и не в качестве сервера. Для получения информации о создании сервера TCP/IP смотрите, Связываются Используя Сокеты Сервера TCP/IP (Instrument Control Toolbox).

TCP/IP Explorer app

Откройте Приложение TCP/IP Explorer

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

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

Примеры

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

В этом примере свяжите с сервером TCP/IP.

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

На вкладке Devices в приложении нажмите Device> TCP/IP Connection.

TCP/IP Explorer app with Device and TCP/IP Connection selected.

Задайте Address как имя хоста сервера www.mathworks.com и Port как порт сервера 80. Можно оставить Connect Timeout как значение по умолчанию 10. Для получения дополнительной информации об этих параметрах, смотрите, Конфигурируют Связь в TCP/IP Explorer.

Нажмите Confirm Parameters, чтобы создать клиент TCP/IP, соединенный с заданным сервером TCP/IP.

TCP/IP Explorer app with connection parameters.

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

Вкладка TCP/IP Explorer открывается в приложении и вашем клиенте, TCP/IP Connection появляется в Device List.

TCP/IP Explorer app showing TCP/IP Explorer tab and Device List pane.

Просмотрите свойства Connection и сконфигурируйте свойства Communication от Property Inspector. Можно задать Terminator, ByteOrder и свойства Timeout сервера прежде, чем записать и считать данные.

TCP/IP Explorer app showing Property Inspector.

В этом примере запишите отключенные ASCII данные клиенту TCP/IP, соединенному с сервером, и считайте данные назад из него. Сервер TCP/IP в этом примере был уже запрограммирован с пользовательскими командами и ответами.

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

На вкладке Devices в приложении нажмите Device> TCP/IP Connection.

TCP/IP Explorer app with Device and TCP/IP Connection selected.

Задайте Address как адрес сервера и Port как порт сервера, чтобы связать с сервером. Значения, заданные в этом примере, характерны для этого сервера и не работают над другими машинами. Можно оставить Connect Timeout как значение по умолчанию 10. Нажмите Confirm Parameters, чтобы создать клиент TCP/IP, соединенный с заданным сервером.

TCP/IP Explorer app with connection parameters.

Прежде, чем записать или считать данные, можно изменить свойства Communication от Property Inspector. Убедитесь, что эти свойства совпадают с соответствующими значениями для сервера. В данном примере значения, показанные уже, совпадают с настройкой сервера.

TCP/IP Explorer app showing Property Inspector.

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

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

TCP/IP Explorer app Write section for ASCII data.

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

TCP/IP Explorer app Read section for ASCII data.

Просмотрите и запись и операции чтения в панели Communication Log. Операция чтения показывает сообщению Server Running on "172.XX.XXX.XXX" and port 3030.. Можно выбрать строку, чтобы экспортировать его, когда переменная к рабочей области путем выполнения шагов в Экспортирует Данные из Коммуникационного Журнала и Генерирует СКРИПТ MATLAB.

TCP/IP Explorer app Communication Log pane.

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

TCP/IP Explorer app MATLAB Code Log pane.

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

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

На вкладке Devices в приложении нажмите Device> TCP/IP Connection.

TCP/IP Explorer app with Device and TCP/IP Connection selected.

Задайте Address как адрес сервера и Port как порт сервера, чтобы связать с сервером. Значения, заданные в этом примере, характерны для этого сервера и не работают над другими машинами. Можно оставить Connect Timeout как значение по умолчанию 10. Нажмите Confirm Parameters, чтобы создать клиент TCP/IP, соединенный с заданным сервером.

TCP/IP Explorer app with connection parameters.

Прежде, чем записать или считать данные, можно изменить свойства Communication от Property Inspector. Убедитесь, что эти свойства совпадают с соответствующими значениями для сервера. В данном примере значения, показанные уже, совпадают с настройкой сервера.

TCP/IP Explorer app showing Property Inspector.

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

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

TCP/IP Explorer app Write section for ASCII data.

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

command = "Send Arbitrary Waveform";

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

TCP/IP Explorer app Write section for ASCII data.

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

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

TCP/IP Explorer app Read section for binary data.

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

TCP/IP Explorer app Read section showing Num Values to Read blank.

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

TCP/IP Explorer app Communication Log pane.

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

TCP/IP Explorer plot button.

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

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

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

TCP/IP Explorer app MATLAB Code Log pane.

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

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

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

TCP/IP Explorer Communication Log pane with row selected.

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

TCP/IP Explorer plot button.

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

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

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

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

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

TCP/IP Explorer app Communication Log pane.

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

TCP/IP Explorer app showing Export Selected Row option.

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

TCP/IP Explorer app showing Export Communication Log option.

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

TCP/IP Explorer app MATLAB Code Log pane.

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

TCP/IP Explorer app showing Generate MATLAB Script option.

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

Параметры

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

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

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

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

Зависимости

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

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

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

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

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

Выберите существующую переменную рабочей области, чтобы записать от клиента TCP/IP в подключенный сервер. Данные записаны как тип, заданный 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 от клиента TCP/IP к подключенному серверу как заданный Data Type. Если Data Format является ASCII-Terminated String, терминатор строки записи, заданный свойством Terminator, автоматически добавлен к записанным данным.

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

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

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

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

Зависимости

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

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

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

Зависимости

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

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

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

Зависимости

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

Нажмите эту кнопку, чтобы считать данные, полученные клиентом TCP/IP от подключенного сервера. Если 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. Данные сохранены как свой Data Type.

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

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

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

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

Имя сервера или IP-адрес, возвращенный как вектор символов. Это свойство установлено во время настройки Связи TCP/IP.

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

Порт сервера, возвращенный как номер между 1 и 65535, включительно. Это свойство установлено во время настройки Связи TCP/IP.

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

Допустимое время в секундах, чтобы связать с сервером в виде числового значения. Это свойство указывает, что максимальное время, чтобы ожидать связи запрашивает к заданному серверу успешно выполниться или перестать работать. Это свойство установлено во время настройки Связи TCP/IP.

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

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

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

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

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

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

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

Приложения

Функции

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