rtiostream_wrapper

Тестирование rtiostream общие функции библиотеки в MATLAB

Свернуть все на странице

Синтаксис

streamID = rtiostream_wrapper(sharedLib, 'open')

[errFlag,transmittedDataSize] = rtiostream_wrapper(sharedLib,'send',streamID,data,dataSize)

[errFlag,receivedData,receivedDataSize] = rtiostream_wrapper(sharedLib,'recv',streamID,dataSize)

streamID = rtiostream_wrapper(___,Name,Value)

errFlag = rtiostream_wrapper(sharedLib,'close',streamID)

rtiostream_wrapper(sharedLib,'unloadlibrary')

Описание

streamID = rtiostream_wrapper(sharedLib, 'open') открывает rtiostream канал связи или поток через общую библиотеку.

[errFlag,transmittedDataSize] = rtiostream_wrapper(sharedLib,'send',streamID,data,dataSize)передает данные из переменной рабочей области через открытый канал связи или поток.

[errFlag,receivedData,receivedDataSize] = rtiostream_wrapper(sharedLib,'recv',streamID,dataSize) получает данные переменной рабочей области из открытого канала связи или потока.

streamID = rtiostream_wrapper(___,Name,Value) задает дополнительные опции, используя один или несколько аргументы пары "имя-значение". Эти аргументы зависят от реализации, то есть они специфичны для общей библиотеки, которую вы используете.

errFlag = rtiostream_wrapper(sharedLib,'close',streamID) закрывает rtiostream канал связи или поток.

пример

rtiostream_wrapper(sharedLib,'unloadlibrary') выгружает общую библиотеку, очищая постоянные данные.

Примеры

Откройте каналы связи

Эти примеры используют поставляемые драйверы TCP/IP и последовательной связи для открытия каналов связи.

Откройте rtiostream stationA как сервер TCP/IP:

stationA = rtiostream_wrapper('libmwrtiostreamtcpip.dll','open',...
                              '-client', '0',...
                              '-blocking', '0',...
                              '-port', port_number);

Открывает rtiostream StationB как клиент TCP/IP:

stationB = rtiostream_wrapper('libmwrtiostreamtcpip.dll','open',...
                              '-client','1',...
                              '-blocking', '0',...
                              '-port', port_number,...
                              '-hostname','localhost');

Если вы используете поставляемый драйвер компьютера разработчика для последовательной связи (в качестве альтернативы драйверам для TCP/IP), задайте скорость передачи при открытии канала с определенным портом. Для примера откройте stationA канала с портом COM1 и скорость передачи 9600:

stationA = rtiostream_wrapper('libmwrtiostreamserial.dll','open',...
                              '-port','COM1',...
                              '-baud','9600');

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

свернуть все

`sharedLib` - Общая библиотека
вектор символов

Общая библиотека, реализующая требуемые rtIOStream функции, rtIOStreamOpen, rtIOStreamSend, rtIOStreamRecv, и rtIOStreamClose. Должен находиться в системном пути. Задайте одно из следующих значений:

libTCPIP - Для связи TCP/IP. Значение зависит от вашей операционной системы, например 'libmwrtiostreamtcpip.dll'
libSerial - Для последовательной связи, например, 'libmwrtiostreamserial.dll'.

`streamID` - Указатель на поток
скалярное целое число

Указатель на rtiostream коммуникационный поток.

`data` - Переменная рабочей области
массив

Массив, который содержит данные для передачи.

`dataSize` - Размер данных для передачи или приема
скалярное целое число

Размер данных переменной рабочей области для передачи или приема в байтах.

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

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

Пример: '-hostname', 'localhost'

Коммуникация TCP/IP

свернуть все

`'-client'` - Тип потока
0 | 1

Откройте rtiostream как сервер TCP/IP или клиент:

0 - сервер TCP/IP
1 - клиент TCP/IP

`'-port'` - Номер порта
скалярное целое число

Порт для связи TCP/IP.

`'-hostname'` - Компьютер разработчика
вектор символов

Идентификатор вашего компьютера разработчика, например 'localhost'.

`'-blocking'` - Поведение вызова
0 | 1

Поведение вызова при приеме данных:

0 - Режим опроса. Если данные доступны, вызов возвращается с данными. Если данные недоступны, вызов возвращается без ожидания.
1 - Режим блокировки. Если данные доступны, вызов возвращается с данными. Если данные недоступны, вызов ожидает данных. Использование recv_timeout_secs для определения периода ожидания.

Значение по умолчанию 0, если только макрос препроцессора не define VXWORKS существует. В этом случае значение по умолчанию является 1.

`'-recv_timeout_secs'` - Период ожидания
положительное целое число | 0 | -1 | -2 | -3

Период ожидания вызова, который принимает данные:

X, положительное целое число - Ожидание X секунд.
0 - Нет периода ожидания.
-1 - Подождите бесконечно.
-2 - Ожидание периода по умолчанию.
-3 - Подождите 10 мс.

По умолчанию для клиентских подключений требуется подождать 1 секунду. По умолчанию для подключений к серверу требуется неопределенное время ожидания.

Последовательная связь

свернуть все

`'-port'` - Номер порта
скалярное целое число

COM-порт для последовательной связи.

`'-baud'` - Скорость передачи битов
скалярное целое число

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

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

свернуть все

`streamID` - Указатель на поток
скалярное целое число

Если функция открывает поток связи, она возвращает указатель в поток. В противном случае возвращается -1.

`errFlag` - Флаг ошибки
0 | -1

Если функция запускается без ошибок, она возвращает нуль. В противном случае возвращается -1.

`transmittedDataSize` - Размер передаваемых данных
скалярное целое число

Размер данных, передаваемых через поток связи. Может быть меньше dataSize, количество байтов, заданное для передачи.

`receivedData` - Получена переменная рабочей области
массив

Массив, содержащий полученные данные.

`receivedDataSize` - Размер полученных данных
скалярное целое число

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

См. также

rtIOStreamClose | rtIOStreamOpen | rtIOStreamRecv | rtIOStreamSend

Темы

Введенный в R2008b

Документация

rtiostream_wrapper

Синтаксис

Описание

Примеры

Откройте каналы связи

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

`sharedLib` - Общая библиотека
вектор символов

`streamID` - Указатель на поток
скалярное целое число

`data` - Переменная рабочей области
массив

`dataSize` - Размер данных для передачи или приема
скалярное целое число

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

`'-client'` - Тип потока
0 | 1

`'-port'` - Номер порта
скалярное целое число

`'-hostname'` - Компьютер разработчика
вектор символов

`'-blocking'` - Поведение вызова
0 | 1

`'-recv_timeout_secs'` - Период ожидания
положительное целое число | 0 | -1 | -2 | -3

`'-port'` - Номер порта
скалярное целое число

`'-baud'` - Скорость передачи битов
скалярное целое число

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

`streamID` - Указатель на поток
скалярное целое число

`errFlag` - Флаг ошибки
0 | -1

`transmittedDataSize` - Размер передаваемых данных
скалярное целое число

`receivedData` - Получена переменная рабочей области
массив

`receivedDataSize` - Размер полученных данных
скалярное целое число

См. также

Темы

Embedded Coder

Поддержка

Документация

rtiostream_wrapper

Синтаксис

Описание

Примеры

Откройте каналы связи

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

sharedLib - Общая библиотека вектор символов

streamID - Указатель на поток скалярное целое число

data - Переменная рабочей области массив

dataSize - Размер данных для передачи или приема скалярное целое число

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

'-client' - Тип потока 0 | 1

'-port' - Номер порта скалярное целое число

'-hostname' - Компьютер разработчика вектор символов

'-blocking' - Поведение вызова 0 | 1

'-recv_timeout_secs' - Период ожидания положительное целое число | 0 | -1 | -2 | -3

'-port' - Номер порта скалярное целое число

'-baud' - Скорость передачи битов скалярное целое число

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

streamID - Указатель на поток скалярное целое число

errFlag - Флаг ошибки 0 | -1

transmittedDataSize - Размер передаваемых данных скалярное целое число

receivedData - Получена переменная рабочей области массив

receivedDataSize - Размер полученных данных скалярное целое число

См. также

Темы

Embedded Coder

Поддержка

`sharedLib` - Общая библиотека
вектор символов

`streamID` - Указатель на поток
скалярное целое число

`data` - Переменная рабочей области
массив

`dataSize` - Размер данных для передачи или приема
скалярное целое число

`'-client'` - Тип потока
0 | 1

`'-port'` - Номер порта
скалярное целое число

`'-hostname'` - Компьютер разработчика
вектор символов

`'-blocking'` - Поведение вызова
0 | 1

`'-recv_timeout_secs'` - Период ожидания
положительное целое число | 0 | -1 | -2 | -3

`'-port'` - Номер порта
скалярное целое число

`'-baud'` - Скорость передачи битов
скалярное целое число

`streamID` - Указатель на поток
скалярное целое число

`errFlag` - Флаг ошибки
0 | -1

`transmittedDataSize` - Размер передаваемых данных
скалярное целое число

`receivedData` - Получена переменная рабочей области
массив

`receivedDataSize` - Размер полученных данных
скалярное целое число