rossvcserver

Создайте сервисный сервер ROS

Описание

Используйте rossvcserver или ros.ServiceServer создать сервисный сервер ROS, который может получить запросы из и отправить ответы на, сервисный клиент ROS. Необходимо создать сервисный сервер прежде, чем создать сервисный клиент (см. ROSSVCCLIENT).

Когда вы создаете сервисный клиент, это устанавливает связь с сервером. Связь сохраняется, в то время как и клиент-сервер существует и может достигнуть друг друга. Когда вы создаете сервисный сервер, он указывает себя с ведущим устройством ROS. Чтобы получить список сервисов или получить информацию о конкретном сервисе, который доступен в текущей сети ROS, используют rosservice функция.

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

Используйте ros.ServiceServer синтаксис при соединении с определенным узлом ROS.

Создание

Описание

пример

server = rossvcserver(servicename,svctype) создает сервисный серверный объект с заданным ServiceType доступный в сети ROS под именем ServiceName. Объект службы не может ответить на запросы на обслуживание, пока вы не задаете коллбэк указателя на функцию, NewMessageFcn.

server = rossvcserver(servicename,svctype,callback) задает функцию обратного вызова, которая создает ответ, когда сервер получает запрос. callback задает NewMessageFcn свойство.

server = ros.ServiceServer(node, name,type) создает сервисный сервер, который присоединяет к узлу ROS, node. Сервер становится доступным через заданное сервисное имя и тип, если указатель функции обратного вызова задан в NewMessageFcn.

server = ros.ServiceServer(node, name,type,callback) задает функцию обратного вызова, которая установлена в NewMessageFcn свойство.

Свойства

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

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

Имя сервиса в виде строкового скаляра или вектора символов.

Пример: "/gazebo/get_model_state"

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

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

Тип сервиса в виде строкового скаляра или вектора символов.

Пример: "gazebo_msgs/GetModelState"

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

Свойство Callback в виде указателя на функцию или массива ячеек. В первом элементе массива ячеек задайте или указатель на функцию, строковый скаляр или вектор символов, представляющий имя функции. В последующих элементах задайте пользовательские данные.

Сервисная функция обратного вызова требует по крайней мере трех входных параметров с одним выходом. Первый аргумент, src, связанный сервисный серверный объект. Второй аргумент, reqMsg, объект сообщения запроса, отправленный сервисным клиентом. Третий аргумент является объектом сообщения ответа по умолчанию, defaultRespMsg. Коллбэк возвращает сообщение ответа, response, на основе входа запрос обмениваются сообщениями, и передает его обратно сервисному клиенту. Используйте сообщение ответа по умолчанию в качестве начальной точки для построения сообщения запроса. Функциональный заголовок для коллбэка:

function response = serviceCallback(src,reqMsg,defaultRespMsg)

Задайте NewMessageFcn свойство как:

server.NewMessageFcn = @serviceCallback;

При установке коллбэка вы передаете дополнительные параметры функции обратного вызова включением и функция обратного вызова и параметры как элементы массива ячеек. Функциональный заголовок для коллбэка:

function response = serviceCallback(src,reqMsg,defaultRespMsg,userData)

Задайте NewMessageFcn свойство как:

server.NewMessageFcn = {@serviceCallback,userData};

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

rosmessageСоздайте сообщения ROS

Примеры

свернуть все

Соединитесь с сетью ROS.

rosinit
Initializing ROS master on http://bat6346glnxa64:35031/.
Initializing global node /matlab_global_node_09194 with NodeURI http://bat6346glnxa64:37145/

Настройте сервисный сервер и клиент.

server = rossvcserver('/test', 'std_srvs/Empty', @exampleHelperROSEmptyCallback);
client = rossvcclient('/test');

Вызовите сервисный сервер с сообщением по умолчанию.

response = call(client)
response = 
  ROS EmptyResponse message with properties:

    MessageType: 'std_srvs/EmptyResponse'

  Use showdetails to show the contents of the message

Закройте сеть ROS.

rosshutdown
Shutting down global node /matlab_global_node_09194 with NodeURI http://bat6346glnxa64:37145/
Shutting down ROS master on http://bat6346glnxa64:35031/.

Введенный в R2019b

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