|
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.
Member Data Documentation
|
the fiducial ID of the intended target. |
|
the raw data of the message |
|
the length of the message in bytes. |
|
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 1.3.6
|