CCA
HeartBeat.h
Go to the documentation of this file.
00001 /* ============================================================
00002  *
00003  * This file is a part of CCA project
00004  *
00005  * Copyright (C) 2011 by Arne Nordmann <anordman at cor-lab dot uni-bielefeld dot de>
00006  *
00007  * This file may be licensed under the terms of the
00008  * GNU Lesser General Public License Version 3 (the ``LGPL''),
00009  * or (at your option) any later version.
00010  *
00011  * Software distributed under the License is distributed
00012  * on an ``AS IS'' basis, WITHOUT WARRANTY OF ANY KIND, either
00013  * express or implied. See the LGPL for the specific language
00014  * governing rights and limitations.
00015  *
00016  * You should have received a copy of the LGPL along with this
00017  * program. If not, go to http://www.gnu.org/licenses/lgpl.html
00018  * or write to the Free Software Foundation, Inc.,
00019  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
00020  *
00021  * The development of this software was supported by:
00022  *   CoR-Lab, Research Institute for Cognition and Robotics
00023  *     Bielefeld University
00024  *
00025  * ============================================================ */
00026 
00027 #pragma once
00028 
00029 #include <boost/shared_ptr.hpp>
00030 
00031 #include <rsc/logging/LoggerFactory.h>
00032 #include <rsc/threading/PeriodicTask.h>
00033 
00034 #include "cca/timing/BeatProvider.h"
00035 #include "cca/timing/Tick.h"
00036 
00037 namespace cca {
00038 namespace timing {
00039 
00040 class HeartBeat;
00041 typedef ::boost::shared_ptr<HeartBeat> HeartBeatPtr;
00042 
00049 class HeartBeat:
00050         public BeatProvider,
00051         public rsc::threading::PeriodicTask {
00052 public:
00053     HeartBeat(unsigned int milliseconds,
00054             PortConfiguration::Transport transport = PortConfiguration::CCALocal);
00055     ~HeartBeat();
00056 
00060     std::string print() const;
00061 
00065     void execute();
00066 
00072     virtual unsigned int getCycleTime();
00073 
00077     virtual void run();
00078 
00082     virtual void run(unsigned int cycles) ;
00083 
00088     virtual void cancel();
00089 
00097     virtual bool isCancelRequested();
00098 
00102     static HeartBeatPtr LOCAL(unsigned int milliseconds = 10);
00103 
00107     static HeartBeatPtr REMOTE(unsigned int milliseconds = 10);
00108 
00112     static HeartBeatPtr LOCALREMOTE(unsigned int milliseconds = 10);
00113 
00120     friend std::ostream
00121     & operator<<(std::ostream& os, const HeartBeat& beat);
00122 
00123 protected:
00128     unsigned int _cycletime;
00129 
00130     unsigned int _sequenceNumber;
00131 
00132 private:
00133     rsc::logging::LoggerPtr logger;
00134 };
00135 
00136 }
00137 }