Homepage Demos Overview Downloads Tutorials Reference
Credits

Controller Class Reference

#include <Controller.h>

Inheritance diagram for Controller:

Inheritance graph
[legend]
List of all members.

Detailed Description

Handles the menu/command system... when it detects the EmergencyStopMC is activated, it'll kick into high priority.

Keeps track of a command stack. A Control can designate another sub-control, which will receive events until it finishes
Events will then be sent to the parent again.

The GUI uses the same commands as the user (makes it much easier to have only one parser). The commands are:

  • '!refresh' - redisplays the current control (handy on first connecting, or when other output has scrolled it off the screen)
  • '!reset' - return to the root control
  • '!next' - calls ControlBase::doNextItem() of the current control
  • '!prev' - calls ControlBase::doPrevItem() of the current control
  • '!select' - calls ControlBase::doSelect() of the current control
  • '!cancel' - calls ControlBase::doCancel() of the current control
  • '!msg text' - sends text out as a TextMsgEvent; also note that any text entered on the console port while a GUI is also connected will also be sent as a TextMsgEvent, without needing the !input.
  • '!root text' - calls ControlBase::takeInput(text) on the root control
  • '!hello' - responds with 'hello\ncount\n' where count is the number of times '!hello' has been sent. Good for detecting first connection after boot vs. a reconnect.
  • '!hilight [n1 [n2 [...]]]' - hilights zero, one, or more items in the menu
  • '!input text' - calls ControlBase::takeInput(text) on the currently hilighted control(s)
  • '!set section.key=value' - will be sent to Config::setValue(section,key,value)
  • any text not beginning with '!' - sent to ControlBase::takeInput() of the current control

In return, to send the menus to the GUI, the following messages are sent: (newlines are required where shown)

  • 'push' - signals a submenu has been activated
  • 'pop' - signals a submenu has been closed
  • 'refresh
    text:title
    int:numitems
    bool:hasSubmenus1
    bool:hilighted1
    text:item-title1
    text:item-description1
    ...
    bool:hasSubmenusnumitems
    bool:hilightednumitems
    text:item-titlenumitems
    text:item-descriptionnumitems' - refreshes the current menu
  • 'status
    text' - sets the status bar to text (until the next refresh)
  • 'load
    text:classname
    text:instancename
    int:port
    [arg1 [arg2 [...]]]' - tells the GUI to load the java class named classname, and have it connect to port, passing it the argument list. classname should contain a constructor of the form Classname(String host, int port, String args[]) the argument list is parsed as if it were on the console - unescaped or unquoted spaces will separate args into elements in the array
  • 'close
    text:instancename' - calls close() on an object previously created by a load message. The Java object is expected to contain a function void close().
  • 'goodbye' - Indicates the connection is about to be closed purposefully, to differentiate from an accidental cut off.

bool types are expected to be numerical values, 0 for false, non-zero for true.

load and close are intended to allow pop-up windows for custom displays.

The upstream is the responsibility of the individual Controls, but the protocol is listed here to keep it together. When a control's state changes, it's that control's responsiblity to refresh the UI (LEDs, console, and GUI as appropriate). Thus, future extensions to the upstream protocol are between the control which will use it and the GUI. Future extensions to the downstream protocol would involve changing Controller and the GUI.

The Controller may connect to serr in the future to pop-up an alert anytime output to serr occurs.

Note that all state is maintained on the robot - even if the GUI is connected, you can still use the buttons to interact with the controller, and the GUI will update to reflect the changes. In HCI (Human Computer Interaction) parlance, this is the MVC, Model-View-Controller architecture, almost by necessity. (HCI happens to be my double major when I was an undergrad ;)

Also, the Controller is responsible for sending out TextMsgEvents from user input it receives - either a !msg command from the console or GUI, or any text at all which is received on the console if there is already a GUI connected.

These TextMsgEvents are always status events, and the duration field is always 0.

Definition at line 95 of file Controller.h.

Public Member Functions

 Controller ()
 Constructor.
 Controller (ControlBase *r)
 Constructor, sets a default root control.
virtual ~Controller ()
 Destructor.
virtual void DoStart ()
 register for events and resets the cmdstack
virtual void DoStop ()
 stop listening for events and resets the cmdstack
virtual bool trapEvent (const EventBase &e)
 passes an event to the top control
virtual void processEvent (const EventBase &e)
 just for e-stop activation/deactivation
void reset ()
 will take the command stack back down to the root
void refresh ()
 refreshes the display, for times like sub-control dying, the previous control needs to reset it's display
void push (ControlBase *c)
 puts a new control on top
void pop ()
 kills the top control, goes to previous
ControlBasetop ()
 returns the current control
ControllersetRoot (ControlBase *r)
 sets the root level control
ControllersetEStopID (MotionManager::MC_ID estopid)
 Sets the emergency stop MC to monitor for pausing.
virtual std::string getDescription () const
 Gives a short description of what this particular instantiation does (in case a more specific description is needed on an individual basis).

Static Public Member Functions

std::string getClassDescription ()
 Gives a short description of what this class of behaviors does... you should override this (but don't have to).
void loadGUI (const std::string &type, const std::string &name, unsigned int port)
 attempts to open a Java object on the desktop
void loadGUI (const std::string &type, const std::string &name, unsigned int port, const std::vector< std::string > &args)
 attempts to open a Java object on the desktop
void closeGUI (const std::string &name)
 calls close() on a Java object loaded with loadGUI() (on the desktop)
int gui_comm_callback (char *buf, int bytes)
 called by wireless when there's new data from the GUI
int console_callback (char *buf, int bytes)
 called by wireless when someone has entered new data on the tekkotsu console (NOT cin)

Static Public Attributes

EventBase nextItem
 event masks used by processEvent()
EventBase prevItem
 event masks used by processEvent()
EventBase nextItemFast
 event masks used by processEvent()
EventBase prevItemFast
 event masks used by processEvent()
EventBase selectItem
 event masks used by processEvent()
EventBase cancel
 event masks used by processEvent()

Protected Member Functions

void init ()
 assigns appropriate values to the static event bases
void takeLine (const std::string &s)
 called with each line that's entered on the tekkotsu console or from the GUI
int setConfig (const char *str)
 sets a config value - some values may require additional processing (done here) to have the new values take effect
bool setNext (ControlBase *next)
 maintains top Control
void activate ()
 called when the estop switches on
void deactivate ()
 called when the estop switches off

bool chkCmdStack ()
 returns true if a valid control is available on the stack

Static Protected Member Functions

bool calcPulse (unsigned int t, unsigned int last, unsigned int period)
 returns true when the current time and last time are in different periods

Protected Attributes

MotionManager::MC_ID display
 invalid_MC_ID if not active, otherwise id of high priority LEDs
MotionManager::MC_ID estop_id
 the EmergencyStopMC MC_ID that this Controller is monitoring
ControlBaseroot
 the base control, if cmdstack underflows, it will be reset to this
std::stack< ControlBase * > cmdstack
 the stack of the current control hierarchy
should never contain NULL entries
unsigned int last_time
 the time of the last event
unsigned int cur_time
 the time of the current event (do*() can check this instead of calling get_time() )
float nextEv_val
 the magnitude of the last next event (::nextItem)
unsigned int nextEv_dur
 the duration of the last next event (::nextItem)
float prevEv_val
 the magnitude of the last prev event (::prevItem)
unsigned int prevEv_dur
 the duration of the last prev event (::prevItem)
bool alreadyGotBoth
 if doReadStdIn() was already called, but the buttons are both still down
bool isControlling
 true if the Controller is currently active (in the activate()/deactivate() sense, not DoStart()/DoStop() sense - use isActive() for that...)
Socketgui_comm
 the socket to listen on for the gui

Static Protected Attributes

ControllertheOneController = NULL
 currently can't pull connection socket off of server socket, so only one Controller

Private Member Functions

 Controller (const Controller &)
 shouldn't be called...
Controlleroperator= (const Controller &)
 shouldn't be called...


Constructor & Destructor Documentation

Controller::Controller  )  [inline]
 

Constructor.

Definition at line 97 of file Controller.h.

Controller::Controller ControlBase r  )  [inline]
 

Constructor, sets a default root control.

Definition at line 98 of file Controller.h.

virtual Controller::~Controller  )  [inline, virtual]
 

Destructor.

Definition at line 99 of file Controller.h.

Controller::Controller const Controller  )  [private]
 

shouldn't be called...


Member Function Documentation

void Controller::activate  )  [protected]
 

called when the estop switches on

causes the top control to activate, registers for button events

Definition at line 415 of file Controller.cc.

Referenced by processEvent(), and setEStopID().

bool Controller::calcPulse unsigned int  t,
unsigned int  last,
unsigned int  period
[inline, static, protected]
 

returns true when the current time and last time are in different periods

Definition at line 183 of file Controller.h.

Referenced by trapEvent().

bool Controller::chkCmdStack  )  [protected]
 

returns true if a valid control is available on the stack

if the stack is empty, will push root if it's non-null

Definition at line 435 of file Controller.cc.

Referenced by activate(), push(), refresh(), takeLine(), and trapEvent().

void Controller::closeGUI const std::string &  name  )  [static]
 

calls close() on a Java object loaded with loadGUI() (on the desktop)

Definition at line 201 of file Controller.cc.

Referenced by WalkControllerBehavior::DoStop(), ViewWMVarsBehavior::DoStop(), SegCamBehavior::DoStop(), RawCamBehavior::DoStop(), HeadPointControllerBehavior::DoStop(), and Aibo3DControllerBehavior::DoStop().

int Controller::console_callback char *  buf,
int  bytes
[static]
 

called by wireless when someone has entered new data on the tekkotsu console (NOT cin)

Definition at line 240 of file Controller.cc.

void Controller::deactivate  )  [protected]
 

called when the estop switches off

causes the top control to deactivate, stops listening for buttons

Definition at line 425 of file Controller.cc.

Referenced by processEvent(), and setEStopID().

void Controller::DoStart  )  [virtual]
 

register for events and resets the cmdstack

Reimplemented from BehaviorBase.

Definition at line 29 of file Controller.cc.

void Controller::DoStop  )  [virtual]
 

stop listening for events and resets the cmdstack

Reimplemented from BehaviorBase.

Definition at line 50 of file Controller.cc.

std::string Controller::getClassDescription  )  [inline, static]
 

Gives a short description of what this class of behaviors does... you should override this (but don't have to).

If you do override this, also consider overriding getDescription() to return it

Reimplemented from BehaviorBase.

Definition at line 131 of file Controller.h.

Referenced by getDescription().

virtual std::string Controller::getDescription  )  const [inline, virtual]
 

Gives a short description of what this particular instantiation does (in case a more specific description is needed on an individual basis).

By default simply returns getName(), because any calls from a BehaviorBase function to getClassDescription() are going to call BehaviorBase::getClassDescription(), not ~YourSubClass~::getClassDescription(), because static functions can't be virtual in C++ (doh!)

This means that getDescription called on a pointer to a BehaviorBase of unknown subtype would always return an empty string, which is pretty useless. So instead we return the name in this situation. If you want getDescription to return getClassDescription, you'll have to override it in your subclass to do so.

Reimplemented from BehaviorBase.

Definition at line 132 of file Controller.h.

int Controller::gui_comm_callback char *  buf,
int  bytes
[static]
 

called by wireless when there's new data from the GUI

Definition at line 209 of file Controller.cc.

Referenced by DoStart().

void Controller::init  )  [protected]
 

assigns appropriate values to the static event bases

Definition at line 274 of file Controller.cc.

Referenced by Controller().

void Controller::loadGUI const std::string &  type,
const std::string &  name,
unsigned int  port,
const std::vector< std::string > &  args
[static]
 

attempts to open a Java object on the desktop

Definition at line 183 of file Controller.cc.

void Controller::loadGUI const std::string &  type,
const std::string &  name,
unsigned int  port
[inline, static]
 

attempts to open a Java object on the desktop

Definition at line 135 of file Controller.h.

Referenced by WalkControllerBehavior::DoStart(), ViewWMVarsBehavior::DoStart(), SegCamBehavior::DoStart(), RawCamBehavior::DoStart(), HeadPointControllerBehavior::DoStart(), Aibo3DControllerBehavior::DoStart(), and WalkCalibration::err().

Controller& Controller::operator= const Controller  )  [private]
 

shouldn't be called...

void Controller::pop  ) 
 

kills the top control, goes to previous

Definition at line 157 of file Controller.cc.

Referenced by reset(), and setNext().

void Controller::processEvent const EventBase e  )  [virtual]
 

just for e-stop activation/deactivation

Reimplemented from BehaviorBase.

Definition at line 122 of file Controller.cc.

void Controller::push ControlBase c  ) 
 

puts a new control on top

Definition at line 148 of file Controller.cc.

Referenced by chkCmdStack(), and setNext().

void Controller::refresh  ) 
 

refreshes the display, for times like sub-control dying, the previous control needs to reset it's display

Definition at line 142 of file Controller.cc.

Referenced by pop(), reset(), setRoot(), and takeLine().

void Controller::reset  ) 
 

will take the command stack back down to the root

Definition at line 132 of file Controller.cc.

Referenced by DoStart(), DoStop(), setRoot(), and takeLine().

int Controller::setConfig const char *  str  )  [protected]
 

sets a config value - some values may require additional processing (done here) to have the new values take effect

Definition at line 386 of file Controller.cc.

Referenced by takeLine().

Controller & Controller::setEStopID MotionManager::MC_ID  estopid  ) 
 

Sets the emergency stop MC to monitor for pausing.

Definition at line 171 of file Controller.cc.

bool Controller::setNext ControlBase next  )  [protected]
 

maintains top Control

Parameters:
next one of:
  • NULL: pop() ::cmdstack
  • ::cmdstack.top(): nothing
  • other address: ::push(next)
Returns:
true, all the time, for convenience from trapEvent()

Definition at line 407 of file Controller.cc.

Referenced by push(), takeLine(), and trapEvent().

Controller & Controller::setRoot ControlBase r  ) 
 

sets the root level control

Definition at line 164 of file Controller.cc.

void Controller::takeLine const std::string &  s  )  [protected]
 

called with each line that's entered on the tekkotsu console or from the GUI

Definition at line 306 of file Controller.cc.

Referenced by console_callback(), and gui_comm_callback().

ControlBase* Controller::top  )  [inline]
 

returns the current control

Definition at line 125 of file Controller.h.

bool Controller::trapEvent const EventBase e  )  [virtual]
 

passes an event to the top control

Implements EventTrapper.

Definition at line 70 of file Controller.cc.


Member Data Documentation

bool Controller::alreadyGotBoth [protected]
 

if doReadStdIn() was already called, but the buttons are both still down

Definition at line 198 of file Controller.h.

Referenced by Controller(), and trapEvent().

EventBase Controller::cancel [static]
 

event masks used by processEvent()

Definition at line 24 of file Controller.cc.

Referenced by init().

std::stack< ControlBase* > Controller::cmdstack [protected]
 

the stack of the current control hierarchy
should never contain NULL entries

Definition at line 180 of file Controller.h.

Referenced by activate(), chkCmdStack(), Controller(), deactivate(), pop(), push(), refresh(), reset(), setNext(), takeLine(), top(), and trapEvent().

unsigned int Controller::cur_time [protected]
 

the time of the current event (do*() can check this instead of calling get_time() )

Definition at line 193 of file Controller.h.

Referenced by Controller(), and trapEvent().

MotionManager::MC_ID Controller::display [protected]
 

invalid_MC_ID if not active, otherwise id of high priority LEDs

Definition at line 170 of file Controller.h.

Referenced by activate(), chkCmdStack(), Controller(), deactivate(), DoStart(), DoStop(), and push().

MotionManager::MC_ID Controller::estop_id [protected]
 

the EmergencyStopMC MC_ID that this Controller is monitoring

Definition at line 173 of file Controller.h.

Referenced by Controller(), and setEStopID().

Socket* Controller::gui_comm [protected]
 

the socket to listen on for the gui

Definition at line 201 of file Controller.h.

Referenced by activate(), chkCmdStack(), closeGUI(), console_callback(), Controller(), DoStart(), DoStop(), loadGUI(), pop(), push(), and takeLine().

bool Controller::isControlling [protected]
 

true if the Controller is currently active (in the activate()/deactivate() sense, not DoStart()/DoStop() sense - use isActive() for that...)

Definition at line 199 of file Controller.h.

Referenced by activate(), Controller(), deactivate(), and DoStart().

unsigned int Controller::last_time [protected]
 

the time of the last event

Definition at line 192 of file Controller.h.

Referenced by Controller(), and trapEvent().

unsigned int Controller::nextEv_dur [protected]
 

the duration of the last next event (::nextItem)

Definition at line 195 of file Controller.h.

Referenced by Controller(), and trapEvent().

float Controller::nextEv_val [protected]
 

the magnitude of the last next event (::nextItem)

Definition at line 194 of file Controller.h.

Referenced by Controller(), and trapEvent().

EventBase Controller::nextItem [static]
 

event masks used by processEvent()

Definition at line 19 of file Controller.cc.

Referenced by init(), and trapEvent().

EventBase Controller::nextItemFast [static]
 

event masks used by processEvent()

Definition at line 21 of file Controller.cc.

Referenced by init(), and trapEvent().

unsigned int Controller::prevEv_dur [protected]
 

the duration of the last prev event (::prevItem)

Definition at line 197 of file Controller.h.

Referenced by Controller(), and trapEvent().

float Controller::prevEv_val [protected]
 

the magnitude of the last prev event (::prevItem)

Definition at line 196 of file Controller.h.

Referenced by Controller(), and trapEvent().

EventBase Controller::prevItem [static]
 

event masks used by processEvent()

Definition at line 20 of file Controller.cc.

Referenced by init(), and trapEvent().

EventBase Controller::prevItemFast [static]
 

event masks used by processEvent()

Definition at line 22 of file Controller.cc.

Referenced by init(), and trapEvent().

ControlBase* Controller::root [protected]
 

the base control, if cmdstack underflows, it will be reset to this

Definition at line 176 of file Controller.h.

Referenced by chkCmdStack(), Controller(), setRoot(), and takeLine().

EventBase Controller::selectItem [static]
 

event masks used by processEvent()

Definition at line 23 of file Controller.cc.

Referenced by init(), and trapEvent().

Controller * Controller::theOneController = NULL [static, protected]
 

currently can't pull connection socket off of server socket, so only one Controller

Definition at line 16 of file Controller.cc.

Referenced by closeGUI(), console_callback(), DoStart(), DoStop(), gui_comm_callback(), loadGUI(), pop(), push(), takeLine(), and ~Controller().


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

Tekkotsu v2.2.1
Generated Tue Nov 23 16:37:44 2004 by Doxygen 1.3.9.1