Tekkotsu Homepage | Demos | Overview | Downloads | Dev. Resources | Reference | Credits |
Controller.hGo to the documentation of this file.00001 //-*-c++-*- 00002 #ifndef INCLUDED_Controller_h 00003 #define INCLUDED_Controller_h 00004 00005 #include "Controls/ControlBase.h" 00006 #include "Behaviors/BehaviorBase.h" 00007 #include "Events/EventBase.h" 00008 #include "Events/EventRouter.h" 00009 #include "Motion/MotionManager.h" 00010 #include "Wireless/Wireless.h" 00011 #include "Wireless/Socket.h" 00012 #include <stack> 00013 00014 //! Handles the menu/command system... when it detects the EmergencyStopMC is activated, it'll kick into high priority. 00015 /*! Keeps track of a command stack. A Control can designate another sub-control, which will receive events until it finishes\n 00016 * Events will then be sent to the parent again. 00017 * 00018 * The GUI uses the same commands as the user (makes it much easier to have only one parser). 00019 * The commands are: 00020 * - '<tt>!refresh</tt>' - redisplays the current control (handy on first connecting, or when other output has scrolled it off the screen) 00021 * - '<tt>!reset</tt>' - return to the root control 00022 * - '<tt>!next</tt>' - calls ControlBase::doNextItem() of the current control 00023 * - '<tt>!prev</tt>' - calls ControlBase::doPrevItem() of the current control 00024 * - '<tt>!select</tt> [<i>item</i>]' - calls ControlBase::doSelect() of the current control, unless <i>item</i> is specified, in which case it is searched for, starting at the root. 00025 * - '<tt>!cancel</tt>' - calls current ControlBase::doCancel(), indicates control should cease activity and return to parent (e.g. "Back" button) 00026 * - '<tt>!dump_stack</tt>' - requests a dump of the current stack of submenus (useful if the GUI (re)connects and thus current robot state is unknown) 00027 * - '<tt>!post </tt><i>generator source type</i> [<i>duration</i>]' - posts an event of your choosing; <i>Generator</i> should be an entry in EventBase::EventGeneratorNames (e.g. timerEGID) or numeric value; <i>source</i> should be a numeric value (unless generator is buttonEGID, in which case it could be an entry from #buttonNames); <i>type</i> can be a numeric value, EventBase::EventTypeNames (e.g. <tt>activate</tt>), or EventBase::EventTypeAbbr (e.g. <tt>A</tt>); <i>duration</i>, if specified, gives the value for EventBase::duration 00028 * - '<tt>!msg </tt><i>text</i>' - sends <i>text</i> 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. 00029 * - '<tt>!root </tt><i>text</i>' - calls ControlBase::takeInput(<i>text</i>) on the root control 00030 * - '<tt>!hello</tt>' - responds with '<tt>hello\\n</tt><i>count</i>\\n' where <i>count</i> is the number of times '<tt>!hello</tt>' has been sent. Good for detecting first connection after boot vs. a reconnect. 00031 * - '<tt>!hilight</tt> [<i>n1</i> [<i>n2</i> [...]]]' - hilights zero, one, or more items in the menu 00032 * - '<tt>!input </tt><i>text</i>' - calls ControlBase::takeInput(text) on the currently hilighted control(s) 00033 * - '<tt>!set </tt><i>section</i><tt>.</tt><i>key</i><tt>=</tt><i>value</i>' - will be sent to Config::setValue(<i>section</i>,<i>key</i>,<i>value</i>) 00034 * - any text not beginning with '<tt>!</tt>' - sent to ControlBase::takeInput() of the current control 00035 * 00036 * In return, to send the menus to the GUI, the following messages are sent: (newlines are required where shown) 00037 * - '<tt>push</tt>' - signals a submenu has been activated 00038 * - '<tt>pop</tt>' - signals a submenu has been closed 00039 * - '<tt>refresh</tt>\n 00040 * <i>text:title</i>\n 00041 * <i>int:numitems</i>\n 00042 * <i>bool:hasSubmenus</i><sub>1</sub>\n 00043 * <i>bool:hilighted</i><sub>1</sub>\n 00044 * <i>text:item-title</i><sub>1</sub>\n 00045 * <i>text:item-description</i><sub>1</sub>\n 00046 * ...\n 00047 * <i>bool:hasSubmenus<sub>numitems</sub></i>\n 00048 * <i>bool:hilighted<sub>numitems</sub></i>\n 00049 * <i>text:item-title<sub>numitems</sub></i>\n 00050 * <i>text:item-description<sub>numitems</sub></i>' - refreshes the current menu\n 00051 * - '<tt>status</tt>\n 00052 * <i>text</i>' - sets the status bar to <i>text</i> (until the next refresh) 00053 * - '<tt>load</tt>\n 00054 * <i>text:classname</i>\n 00055 * <i>text:instancename</i>\n 00056 * <i>int:port</i>\n 00057 * [<i>arg1</i> [<i>arg2</i> [...]]]' - tells the GUI to load the java class named <i>classname</i>, and have it connect to <i>port</i>, passing it the argument list. 00058 * <i>classname</i> should contain a constructor of the form <tt>Classname(String </tt><i>host</i>, <tt>int </tt><i>port</i>, <tt>String </tt><i>args</i><tt>[])</tt> 00059 * the argument list is parsed as if it were on the console - unescaped or unquoted spaces will separate args into elements in the array 00060 * - '<tt>close</tt>\n 00061 * <i>text:instancename</i>' - calls <tt>close()</tt> on an object previously created by a <tt>load</tt> message. 00062 * The Java object is expected to contain a function <tt>void close()</tt>. 00063 * - '<tt>stack_dump</tt>\n 00064 * <i>int:depth</i>\n 00065 * <i>text:item-title</i><sub>1</sub>\n 00066 * ...\n 00067 * <i>text:item-title</i><sub>depth</sub>' - a listing of the current stack, first item is root, last item is current control 00068 * - '<tt>goodbye</tt>' - Indicates the connection is about to be closed purposefully, to differentiate from an accidental cut off. 00069 * 00070 * bool types are expected to be numerical values, 0 for false, 00071 * non-zero for true. 00072 * 00073 * <tt>load</tt> and <tt>close</tt> are intended to allow pop-up 00074 * windows for custom displays. 00075 * 00076 * The upstream is the responsibility of the individual Controls, but 00077 * the protocol is listed here to keep it together. When a control's 00078 * state changes, it's that control's responsiblity to refresh the UI 00079 * (LEDs, console, and GUI as appropriate). Thus, future extensions 00080 * to the upstream protocol are between the control which will use it 00081 * and the GUI. Future extensions to the downstream protocol would 00082 * involve changing Controller and the GUI. 00083 * 00084 * The Controller may connect to serr in the future to pop-up an alert 00085 * anytime output to serr occurs. 00086 * 00087 * Note that all state is maintained on the robot - even if the GUI 00088 * is connected, you can still use the buttons to interact with the 00089 * controller, and the GUI will update to reflect the changes. In 00090 * HCI (Human Computer Interaction) parlance, this is the MVC, 00091 * Model-View-Controller architecture, almost by necessity. (HCI 00092 * happens to be my double major when I was an undergrad ;) 00093 * 00094 * Also, the Controller is responsible for sending out TextMsgEvents 00095 * from user input it receives - either a !msg command from the 00096 * console or GUI, or <i>any text at all</i> which is received on the 00097 * console if there is already a GUI connected. 00098 * 00099 * These TextMsgEvents are always status events, and the duration 00100 * field is always 0. 00101 */ 00102 class Controller : public BehaviorBase, public EventTrapper { 00103 public: 00104 Controller() : BehaviorBase("Controller"), EventTrapper(), display(MotionManager::invalid_MC_ID), estop_id(MotionManager::invalid_MC_ID), root(NULL), cmdstack(), last_time(0), cur_time(0), nextEv_val(0), nextEv_dur(0), prevEv_val(0), prevEv_dur(0), alreadyGotBoth(false), isControlling(false), gui_comm(NULL) {init();} //!< Constructor 00105 Controller(ControlBase* r) : BehaviorBase("Controller"), EventTrapper(), display(MotionManager::invalid_MC_ID), estop_id(MotionManager::invalid_MC_ID), root(r), cmdstack(), last_time(0), cur_time(0), nextEv_val(0), nextEv_dur(0), prevEv_val(0), prevEv_dur(0), alreadyGotBoth(false), isControlling(false), gui_comm(NULL) { init(); } //!< Constructor, sets a default root control 00106 virtual ~Controller() { 00107 std::cout << "~Controller()..." << std::endl; 00108 delete root; 00109 theOneController=NULL; 00110 std::cout << "~Controller()-DONE" << std::endl; 00111 } //!< Destructor 00112 00113 //@{ 00114 //! event masks used by processEvent() 00115 static EventBase nextItem; 00116 static EventBase prevItem; 00117 static EventBase nextItemFast; 00118 static EventBase prevItemFast; 00119 static EventBase selectItem; 00120 static EventBase cancel; //@} 00121 00122 virtual void DoStart(); //!< register for events and resets the cmdstack 00123 virtual void DoStop(); //!< stop listening for events and resets the cmdstack 00124 virtual bool trapEvent(const EventBase& e); //!< passes an event to the top control 00125 virtual void processEvent(const EventBase& e); //!< just for e-stop activation/deactivation 00126 00127 void reset(); //!< will take the command stack back down to the root 00128 void refresh(); //!< refreshes the display, for times like sub-control dying, the previous control needs to reset it's display 00129 00130 void push(ControlBase* c); //!< puts a new control on top 00131 void pop(); //!< kills the top control, goes to previous 00132 ControlBase* top() { return cmdstack.top(); } //!< returns the current control 00133 00134 Controller& setRoot(ControlBase* r); //!< sets the root level control 00135 00136 Controller& setEStopID(MotionManager::MC_ID estopid); //!< Sets the emergency stop MC to monitor for pausing 00137 00138 static std::string getClassDescription() { return "Provides interface for activating/deactivating controls (and through them, behaviors)"; } 00139 virtual std::string getDescription() const { return getClassDescription(); } 00140 00141 00142 static void loadGUI(const std::string& type, const std::string& name, unsigned int port) {loadGUI(type,name,port,std::vector<std::string>());} //!< attempts to open a Java object on the desktop 00143 static 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 00144 static void closeGUI(const std::string& name); //!< calls close() on a Java object loaded with loadGUI() (on the desktop) 00145 00146 static int gui_comm_callback(char *buf, int bytes); //!< called by wireless when there's new data from the GUI 00147 static int console_callback(char *buf, int bytes); //!< called by wireless when someone has entered new data on the tekkotsu console (NOT cin) 00148 00149 protected: 00150 //! calls initButtons with the appropriate button offsets for the host robot model 00151 void init(); 00152 00153 //! assigns appropriate values to the static event bases 00154 void initButtons(unsigned fastTime, unsigned downTime, unsigned nextB, unsigned prevB, unsigned nextFastB, unsigned prevFastB, unsigned selectB, unsigned cancelB); 00155 00156 //! called with each line that's entered on the tekkotsu console or from the GUI 00157 void takeLine(const std::string& s); 00158 00159 //! called with slots (options), a name to lookup; will select the named control 00160 bool select(ControlBase* item, const std::string& name); 00161 00162 //! sets a config value - some values may require additional processing (done here) to have the new values take effect 00163 int setConfig(const std::string& str); 00164 00165 //! maintains top Control 00166 /*! @param next one of: @li NULL: pop() ::cmdstack @li ::cmdstack.top(): nothing @li other address: ::push(@a next) 00167 * @return true, all the time, for convenience from trapEvent() */ 00168 bool setNext(ControlBase* next); 00169 00170 //! called when the estop switches on 00171 /*! causes the top control to activate, registers for button events */ 00172 void activate(); 00173 00174 //! called when the estop switches off\n 00175 /*! causes the top control to deactivate, stops listening for buttons */ 00176 void deactivate(); 00177 00178 //! @brief returns true if a valid control is available on the stack 00179 /*! if the stack is empty, will push root if it's non-null */ 00180 bool chkCmdStack(); 00181 00182 //! invalid_MC_ID if not active, otherwise id of high priority LEDs 00183 MotionManager::MC_ID display; 00184 00185 //! the EmergencyStopMC MC_ID that this Controller is monitoring 00186 MotionManager::MC_ID estop_id; 00187 00188 //! the base control, if cmdstack underflows, it will be reset to this 00189 ControlBase * root; 00190 00191 /*! @brief the stack of the current control hierarchy\n 00192 * should never contain NULL entries */ 00193 std::stack< ControlBase* > cmdstack; 00194 00195 //! returns true when the current time and last time are in different periods 00196 static bool calcPulse(unsigned int t, unsigned int last, unsigned int period) { 00197 if(period<t-last) 00198 return true; 00199 bool nextclock=(t/period)&1; 00200 bool lastclock=(last/period)&1; 00201 return (lastclock!=nextclock); 00202 } 00203 00204 00205 unsigned int last_time; //!< the time of the last event 00206 unsigned int cur_time; //!< the time of the current event (do*() can check this instead of calling get_time() ) 00207 float nextEv_val; //!< the magnitude of the last next event (::nextItem) 00208 unsigned int nextEv_dur; //!< the duration of the last next event (::nextItem) 00209 float prevEv_val; //!< the magnitude of the last prev event (::prevItem) 00210 unsigned int prevEv_dur; //!< the duration of the last prev event (::prevItem) 00211 bool alreadyGotBoth; //!< if doReadStdIn() was already called, but the buttons are both still down 00212 bool isControlling; //!< true if the Controller is currently active (in the activate()/deactivate() sense, not DoStart()/DoStop() sense - use isActive() for that...) 00213 00214 Socket * gui_comm; //!< the socket to listen on for the gui 00215 static Controller * theOneController; //!< currently can't pull connection socket off of server socket, so only one Controller 00216 00217 private: 00218 Controller(const Controller&); //!< shouldn't be called... 00219 Controller& operator=(const Controller&); //!< shouldn't be called... 00220 }; 00221 00222 /*! @file 00223 * @brief Describes Controller class, a behavior that should be started whenever the emergency stop goes on to provide menus for robot control 00224 * @author ejt (Creator) 00225 * 00226 * $Author: ejt $ 00227 * $Name: tekkotsu-4_0 $ 00228 * $Revision: 1.40 $ 00229 * $State: Exp $ 00230 * $Date: 2007/06/28 04:36:19 $ 00231 */ 00232 00233 #endif |
Tekkotsu v4.0 |
Generated Thu Nov 22 00:54:52 2007 by Doxygen 1.5.4 |