roslua: ROS client library for Lua

Module roslua.master_proxy

Master XML-RPC API proxy. This module contains the MasterProxy class to call methods provided via XML-RPC by the ROS master.

The user should not have to directly interact with the master. It is used register and unregister topic publishers/subscribers and services, to lookup nodes and services, and to gather information about the master.

Copyright© Tim Niemueller, Carnegie Mellon University, Intel Research Pittsburgh

Release: Released under BSD license

Functions

MasterProxy:getPublishedTopics (subgraph) Get published topics.
MasterProxy:getSystemState () Get master system state.
MasterProxy:getUri () Get master URI.
MasterProxy:lookupNode (node_name, name) Lookup node by name.
MasterProxy:lookupService (service) Lookup service by name.
MasterProxy:new (ros_master_uri, node_name) Constructor.
MasterProxy:registerPublisher (topic, topic_type) Register Publisher with the master.
MasterProxy:registerService (service, service_api) Register a service with the master.
MasterProxy:registerSubscriber (topic, topic_type) Register subscriber with the master.
MasterProxy:unregisterPublisher (topic) Unregister publisher from master.
MasterProxy:unregisterService (service, service_api) Unregister a service from master.
MasterProxy:unregisterSubscriber (topic) Unregister subscriber from master.


Functions

MasterProxy:getPublishedTopics (subgraph)
Get published topics.

Parameters

  • subgraph: subgraph to query from master

Return value:

graph of topics
MasterProxy:getSystemState ()
Get master system state.

Return value:

three array of registered publishers, subscribers, and services
MasterProxy:getUri ()
Get master URI. Considering that you need to know the URI to call this method is's quite useless.

Return value:

ROS master URI
MasterProxy:lookupNode (node_name, name)
Lookup node by name.

Parameters

  • node_name:
  • name: of node to lookup

Return value:

Slave API XML-RPC HTTP URI
MasterProxy:lookupService (service)
Lookup service by name.

Parameters

  • service: name of service to lookup

Return value:

ROS RPC URI of service provider
MasterProxy:new (ros_master_uri, node_name)
Constructor.

Parameters

  • ros_master_uri: XML-RPC HTTP URI of ROS master
  • node_name: name of this node
MasterProxy:registerPublisher (topic, topic_type)
Register Publisher with the master.

Parameters

  • topic: topic to register for
  • topic_type: type of the topic
MasterProxy:registerService (service, service_api)
Register a service with the master.

Parameters

  • service: name of service to register
  • service_api: ROS RPC URI of service
MasterProxy:registerSubscriber (topic, topic_type)
Register subscriber with the master.

Parameters

  • topic: topic to register for
  • topic_type: type of the topic
MasterProxy:unregisterPublisher (topic)
Unregister publisher from master.

Parameters

  • topic: topic to register for
MasterProxy:unregisterService (service, service_api)
Unregister a service from master.

Parameters

  • service: name of service to register
  • service_api: ROS RPC URI of service
MasterProxy:unregisterSubscriber (topic)
Unregister subscriber from master.

Parameters

  • topic: topic to register for

Valid XHTML 1.0!