Home
FAQ
Player
Stage
Gazebo
Contrib
Documentation
Publications
Contributors
Users

Project
Download
Bugs/Feedback
Mailing lists

Radish

Old news
Old stuff

player_fiducial_msg Struct Reference
[fiducial]

#include <player.h>

List of all members.


Detailed Description

Configuration request: Fiducial messaging.

META-NOTE: FIDUCIAL MESSAGING IS NOT WORKING IN STAGE CVS HEAD OR STAGE-1.5

NOTE: These configs are currently supported only by the Stage fiducial driver (stg_fidicial), but are intended to be a general interface for addressable, peer-to-peer messaging.

The fiducial sensor can attempt to send a message to a target using the PLAYER_FIDUCIAL_SEND_MSG request. If target_id is -1, the message is broadcast to all targets. The device replies with an ACK if the message was sent OK, but receipt by the target is not guaranteed. The intensity field sets a transmit power in device-dependent units. If the consume flag is set, the message is transmitted just once. If it is unset, the message may transmitted repeatedly (at device-dependent intervals, if at all).

Send a PLAYER_FIDUCIAL_RECV_MSG request to obtain the last message recieved from the indicated target. If the consume flag is set, the message is deleted from the device's buffer, if unset, the same message can be retreived multiple times until a new message arrives. The power field indicates the intensity of the recieved messag, again in device-dependent units.

Similarly, the PLAYER_FIDUCIAL_EXCHANGE_MSG request sends a message, then returns the most recently received message. Depending on the device and the situation, this could be a reflection of the sent message, a reply from the target of the sent message, or a message received from an unrelated sender.


Public Attributes

int32_t target_id
uint8_t bytes [PLAYER_FIDUCIAL_MAX_MSG_LEN]
uint8_t len
uint8_t intensity


Member Data Documentation

int32_t player_fiducial_msg::target_id
 

the fiducial ID of the intended target.

uint8_t player_fiducial_msg::bytes[PLAYER_FIDUCIAL_MAX_MSG_LEN]
 

the raw data of the message

uint8_t player_fiducial_msg::len
 

the length of the message in bytes.

uint8_t player_fiducial_msg::intensity
 

the power to transmit, or the intensity of a received message. 0-255 in device-dependent units.


The documentation for this struct was generated from the following file:
Generated on Tue May 3 14:15:55 2005 for Player by doxygen 1.3.6