Fawkes API  Fawkes Development Version
JoystickBlackBoardActListener Class Reference

Wake actuator thread on incomin messages. More...

Inheritance diagram for JoystickBlackBoardActListener:

Public Member Functions

 JoystickBlackBoardActListener (JoystickAcquisitionThread *aqt, BlackBoard *blackboard, JoystickInterface *joystick_if, Logger *logger)
 Constructor. More...
 
 ~JoystickBlackBoardActListener ()
 Destructor. More...
 
virtual bool bb_interface_message_received (Interface *interface, Message *message) throw ()
 BlackBoard message received notification. More...
 
- Public Member Functions inherited from fawkes::BlackBoardInterfaceListener
 BlackBoardInterfaceListener (const char *name_format,...)
 Constructor. More...
 
virtual ~BlackBoardInterfaceListener ()
 Destructor. More...
 
const char * bbil_name () const
 Get BBIL name. More...
 
virtual void bb_interface_data_changed (Interface *interface) throw ()
 BlackBoard data changed notification. More...
 
virtual void bb_interface_writer_added (Interface *interface, unsigned int instance_serial) throw ()
 A writing instance has been opened for a watched interface. More...
 
virtual void bb_interface_writer_removed (Interface *interface, unsigned int instance_serial) throw ()
 A writing instance has been closed for a watched interface. More...
 
virtual void bb_interface_reader_added (Interface *interface, unsigned int instance_serial) throw ()
 A reading instance has been opened for a watched interface. More...
 
virtual void bb_interface_reader_removed (Interface *interface, unsigned int instance_serial) throw ()
 A reading instance has been closed for a watched interface. More...
 

Additional Inherited Members

- Public Types inherited from fawkes::BlackBoardInterfaceListener
enum  QueueEntryType { DATA = 0, MESSAGES = 1, READER = 2, WRITER = 3 }
 Queue entry type. More...
 
typedef std::list< QueueEntryInterfaceQueue
 Queue of additions/removal of interfaces. More...
 
typedef std::map< std::string, Interface * > InterfaceMap
 Map of currently active event subscriptions. More...
 
- Protected Member Functions inherited from fawkes::BlackBoardInterfaceListener
void bbil_add_data_interface (Interface *interface)
 Add an interface to the data modification watch list. More...
 
void bbil_add_message_interface (Interface *interface)
 Add an interface to the message received watch list. More...
 
void bbil_add_reader_interface (Interface *interface)
 Add an interface to the reader addition/removal watch list. More...
 
void bbil_add_writer_interface (Interface *interface)
 Add an interface to the writer addition/removal watch list. More...
 
void bbil_remove_data_interface (Interface *interface)
 Remove an interface to the data modification watch list. More...
 
void bbil_remove_message_interface (Interface *interface)
 Remove an interface to the message received watch list. More...
 
void bbil_remove_reader_interface (Interface *interface)
 Remove an interface to the reader addition/removal watch list. More...
 
void bbil_remove_writer_interface (Interface *interface)
 Remove an interface to the writer addition/removal watch list. More...
 
Interfacebbil_data_interface (const char *iuid) throw ()
 Get interface instance for given UID. More...
 
Interfacebbil_message_interface (const char *iuid) throw ()
 Get interface instance for given UID. More...
 
Interfacebbil_reader_interface (const char *iuid) throw ()
 Get interface instance for given UID. More...
 
Interfacebbil_writer_interface (const char *iuid) throw ()
 Get interface instance for given UID. More...
 

Detailed Description

Wake actuator thread on incomin messages.

Author
Tim Niemueller

Definition at line 194 of file ffjoystick.cpp.

Constructor & Destructor Documentation

◆ JoystickBlackBoardActListener()

JoystickBlackBoardActListener::JoystickBlackBoardActListener ( JoystickAcquisitionThread aqt,
BlackBoard blackboard,
JoystickInterface joystick_if,
Logger logger 
)
inline

Constructor.

Parameters
aqtacquisition thread to pass to message processor
blackboardblackboard to register for message event handling
joystick_ifjoystick interface to listen on for messages
loggerlogger

Definition at line 204 of file ffjoystick.cpp.

◆ ~JoystickBlackBoardActListener()

JoystickBlackBoardActListener::~JoystickBlackBoardActListener ( )
inline

Destructor.

Definition at line 218 of file ffjoystick.cpp.

Member Function Documentation

◆ bb_interface_message_received()

virtual bool JoystickBlackBoardActListener::bb_interface_message_received ( Interface interface,
Message message 
)
throw (
)
inlinevirtual

BlackBoard message received notification.

This is called whenever a message is received for this interface. This method is only called for writing instances of an interface, never on reading instances. If you have processed the message already, you can order that the message is not enqueued by returning false. Returning true will enqueue the message as usual. You should only do very (very!) quick tasks directly in this method, as it is out of the regular thread context and can harm performance of other plugins and the system as a whole. Note that if you decide to return false the message is not referenced. If you want to keep it longer you have to ref() it by yourself. An example where this would really make sense is a "STOP" message for the motor, which needs to be processed ASAP and maybe even waiting a couple of miliseconds for the next cycle is not acceptable.

Parameters
interfaceinterface instance that you supplied to bbil_add_message_interface()
messagethe message that was sent
Returns
true to get the message enqueued afterwards as usual, false to prevent queuing of the message.

Reimplemented from fawkes::BlackBoardInterfaceListener.

Definition at line 225 of file ffjoystick.cpp.

References fawkes::ArgumentParser::arg(), JoystickRemoteBlackBoardPoster::blackboard(), fawkes::ArgumentParser::has_arg(), fawkes::Thread::join(), JoystickRemoteBlackBoardPoster::joystick_if(), fawkes::ArgumentParser::parse_hostport(), fawkes::Exception::print_trace(), fawkes::SignalManager::register_handler(), JoystickBlackBoardLogger::run(), fawkes::Thread::start(), and fawkes::Exception::what().


The documentation for this class was generated from the following file: