first commit 1437_31102025
This commit is contained in:
301
include/robot/time.h
Normal file
301
include/robot/time.h
Normal file
@@ -0,0 +1,301 @@
|
||||
/*********************************************************************
|
||||
* Software License Agreement (BSD License)
|
||||
*
|
||||
* Copyright (c) 2010, Willow Garage, Inc.
|
||||
* All rights reserved.
|
||||
*
|
||||
* Redistribution and use in source and binary forms, with or without
|
||||
* modification, are permitted provided that the following conditions
|
||||
* are met:
|
||||
*
|
||||
* * Redistributions of source code must retain the above copyright
|
||||
* notice, this list of conditions and the following disclaimer.
|
||||
* * Redistributions in binary form must reproduce the above
|
||||
* copyright notice, this list of conditions and the following
|
||||
* disclaimer in the documentation and/or other materials provided
|
||||
* with the distribution.
|
||||
* * Neither the name of Willow Garage, Inc. nor the names of its
|
||||
* contributors may be used to endorse or promote products derived
|
||||
* from this software without specific prior written permission.
|
||||
*
|
||||
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
||||
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
||||
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
|
||||
* FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
|
||||
* COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
|
||||
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
|
||||
* BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
|
||||
* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
|
||||
* CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
||||
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
|
||||
* ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
||||
* POSSIBILITY OF SUCH DAMAGE.
|
||||
*********************************************************************/
|
||||
|
||||
#ifndef ROBOT_TIME_H_INCLUDED
|
||||
#define ROBOT_TIME_H_INCLUDED
|
||||
|
||||
/*********************************************************************
|
||||
** Pragmas
|
||||
*********************************************************************/
|
||||
|
||||
#ifdef _MSC_VER
|
||||
// Robot_time has some magic interface that doesn't directly include
|
||||
// its implementation, this just disables those warnings.
|
||||
#pragma warning(disable: 4244)
|
||||
#pragma warning(disable: 4661)
|
||||
#endif
|
||||
|
||||
/*********************************************************************
|
||||
** Headers
|
||||
*********************************************************************/
|
||||
|
||||
#include <robot/platform.h>
|
||||
#include <iostream>
|
||||
#include <cmath>
|
||||
#include <robot/exception.h>
|
||||
#include "duration.h"
|
||||
#include "robot_time_decl.h"
|
||||
|
||||
/*********************************************************************
|
||||
** Cross Platform Headers
|
||||
*********************************************************************/
|
||||
|
||||
#if defined(_WIN32)
|
||||
#include <sys/timeb.h>
|
||||
#else
|
||||
#include <sys/time.h>
|
||||
#endif
|
||||
|
||||
namespace robot
|
||||
{
|
||||
|
||||
/*********************************************************************
|
||||
** Exceptions
|
||||
*********************************************************************/
|
||||
|
||||
/**
|
||||
* @brief Thrown if the robot subsystem hasn't been initialised before use.
|
||||
*/
|
||||
class ROBOT_TIME_DECL TimeNotInitializedException : public Exception
|
||||
{
|
||||
public:
|
||||
TimeNotInitializedException()
|
||||
: Exception("Cannot use robot::Time::now() before the first NodeHandle has been created or robot::start() has been called. "
|
||||
"If this is a standalone app or test that just uses robot::Time and does not communicate over ROBOT, you may also call robot::Time::init()")
|
||||
{}
|
||||
};
|
||||
|
||||
/**
|
||||
* @brief Thrown if windows high perf. timestamping is unavailable.
|
||||
*
|
||||
* @sa getWallTime
|
||||
*/
|
||||
class ROBOT_TIME_DECL NoHighPerformanceTimersException : public Exception
|
||||
{
|
||||
public:
|
||||
NoHighPerformanceTimersException()
|
||||
: Exception("This windows platform does not "
|
||||
"support the high-performance timing api.")
|
||||
{}
|
||||
};
|
||||
|
||||
/*********************************************************************
|
||||
** Functions
|
||||
*********************************************************************/
|
||||
|
||||
ROBOT_TIME_DECL void normalizeSecNSec(uint64_t& sec, uint64_t& nsec);
|
||||
ROBOT_TIME_DECL void normalizeSecNSec(uint32_t& sec, uint32_t& nsec);
|
||||
ROBOT_TIME_DECL void normalizeSecNSecUnsigned(int64_t& sec, int64_t& nsec);
|
||||
ROBOT_TIME_DECL void robot_walltime(uint32_t& sec, uint32_t& nsec);
|
||||
ROBOT_TIME_DECL void robot_steadytime(uint32_t& sec, uint32_t& nsec);
|
||||
|
||||
/*********************************************************************
|
||||
** Time Classes
|
||||
*********************************************************************/
|
||||
|
||||
/**
|
||||
* \brief Base class for Time implementations. Provides storage, common functions and operator overloads.
|
||||
* This should not need to be used directly.
|
||||
*/
|
||||
template<class T, class D>
|
||||
class TimeBase
|
||||
{
|
||||
public:
|
||||
uint32_t sec, nsec;
|
||||
|
||||
TimeBase() : sec(0), nsec(0) { }
|
||||
TimeBase(uint32_t _sec, uint32_t _nsec) : sec(_sec), nsec(_nsec)
|
||||
{
|
||||
normalizeSecNSec(sec, nsec);
|
||||
}
|
||||
explicit TimeBase(double t) { fromSec(t); }
|
||||
D operator-(const T &rhs) const;
|
||||
T operator+(const D &rhs) const;
|
||||
T operator-(const D &rhs) const;
|
||||
T& operator+=(const D &rhs);
|
||||
T& operator-=(const D &rhs);
|
||||
bool operator==(const T &rhs) const;
|
||||
inline bool operator!=(const T &rhs) const { return !(*static_cast<const T*>(this) == rhs); }
|
||||
bool operator>(const T &rhs) const;
|
||||
bool operator<(const T &rhs) const;
|
||||
bool operator>=(const T &rhs) const;
|
||||
bool operator<=(const T &rhs) const;
|
||||
|
||||
double toSec() const { return static_cast<double>(sec) + 1e-9*static_cast<double>(nsec); };
|
||||
T& fromSec(double t);
|
||||
|
||||
uint64_t toNSec() const {return static_cast<uint64_t>(sec)*1000000000ull + static_cast<uint64_t>(nsec); }
|
||||
T& fromNSec(uint64_t t);
|
||||
|
||||
inline bool isZero() const { return sec == 0 && nsec == 0; }
|
||||
inline bool is_zero() const { return isZero(); }
|
||||
// boost::posix_time conversion removed in std-only build
|
||||
|
||||
static const T MIN; //!< Minimum representable time
|
||||
static const T MAX; //!< Maximum representable time
|
||||
static const T ZERO; //!< Zero (invalid) time
|
||||
static const T UNINITIALIZED; //!< Uninitialized time
|
||||
};
|
||||
|
||||
/**
|
||||
* \brief Time representation. May either represent wall clock time or ROBOT clock time.
|
||||
*
|
||||
* robot::TimeBase provides most of its functionality.
|
||||
*/
|
||||
class ROBOT_TIME_DECL Time : public TimeBase<Time, Duration>
|
||||
{
|
||||
public:
|
||||
Time()
|
||||
: TimeBase<Time, Duration>()
|
||||
{}
|
||||
|
||||
Time(uint32_t _sec, uint32_t _nsec)
|
||||
: TimeBase<Time, Duration>(_sec, _nsec)
|
||||
{}
|
||||
|
||||
explicit Time(double t) { fromSec(t); }
|
||||
|
||||
/**
|
||||
* \brief Retrieve the current time. If ROBOT clock time is in use, this returns the time according to the
|
||||
* ROBOT clock. Otherwise returns the current wall clock time.
|
||||
*/
|
||||
static Time now();
|
||||
/**
|
||||
* \brief Sleep until a specific time has been reached.
|
||||
* @return True if the desired sleep time was met, false otherwise.
|
||||
*/
|
||||
static bool sleepUntil(const Time& end);
|
||||
|
||||
static void init();
|
||||
static void shutdown();
|
||||
static void setNow(const Time& new_now);
|
||||
static bool useSystemTime();
|
||||
static bool isSimTime();
|
||||
static bool isSystemTime();
|
||||
|
||||
/**
|
||||
* \brief Returns whether or not the current time source is valid. Simulation time is valid if it is non-zero.
|
||||
*/
|
||||
static bool isValid();
|
||||
/**
|
||||
* \brief Wait for time source to become valid
|
||||
*/
|
||||
static bool waitForValid();
|
||||
/**
|
||||
* \brief Wait for time source to become valid, with timeout
|
||||
*/
|
||||
static bool waitForValid(const robot::WallDuration& timeout);
|
||||
|
||||
// boost::posix_time conversion removed in std-only build
|
||||
};
|
||||
|
||||
extern ROBOT_TIME_DECL const Time TIME_MAX;
|
||||
extern ROBOT_TIME_DECL const Time TIME_MIN;
|
||||
template<> const Time TimeBase<Time, Duration>::MAX;
|
||||
template<> const Time TimeBase<Time, Duration>::MIN;
|
||||
template<> const Time TimeBase<Time, Duration>::ZERO;
|
||||
template<> const Time TimeBase<Time, Duration>::UNINITIALIZED;
|
||||
|
||||
/**
|
||||
* \brief Time representation. Always wall-clock time.
|
||||
*
|
||||
* robot::TimeBase provides most of its functionality.
|
||||
*/
|
||||
class ROBOT_TIME_DECL WallTime : public TimeBase<WallTime, WallDuration>
|
||||
{
|
||||
public:
|
||||
WallTime()
|
||||
: TimeBase<WallTime, WallDuration>()
|
||||
{}
|
||||
|
||||
WallTime(uint32_t _sec, uint32_t _nsec)
|
||||
: TimeBase<WallTime, WallDuration>(_sec, _nsec)
|
||||
{}
|
||||
|
||||
explicit WallTime(double t) { fromSec(t); }
|
||||
|
||||
/**
|
||||
* \brief Returns the current wall clock time.
|
||||
*/
|
||||
static WallTime now();
|
||||
|
||||
/**
|
||||
* \brief Sleep until a specific time has been reached.
|
||||
* @return True if the desired sleep time was met, false otherwise.
|
||||
*/
|
||||
static bool sleepUntil(const WallTime& end);
|
||||
|
||||
static bool isSystemTime() { return true; }
|
||||
};
|
||||
|
||||
template<> const WallTime TimeBase<WallTime, WallDuration>::MAX;
|
||||
template<> const WallTime TimeBase<WallTime, WallDuration>::MIN;
|
||||
template<> const WallTime TimeBase<WallTime, WallDuration>::ZERO;
|
||||
template<> const WallTime TimeBase<WallTime, WallDuration>::UNINITIALIZED;
|
||||
|
||||
/**
|
||||
* \brief Time representation. Always steady-clock time.
|
||||
*
|
||||
* Not affected by ROBOT time.
|
||||
*
|
||||
* robot::TimeBase provides most of its functionality.
|
||||
*/
|
||||
class ROBOT_TIME_DECL SteadyTime : public TimeBase<SteadyTime, WallDuration>
|
||||
{
|
||||
public:
|
||||
SteadyTime()
|
||||
: TimeBase<SteadyTime, WallDuration>()
|
||||
{}
|
||||
|
||||
SteadyTime(uint32_t _sec, uint32_t _nsec)
|
||||
: TimeBase<SteadyTime, WallDuration>(_sec, _nsec)
|
||||
{}
|
||||
|
||||
explicit SteadyTime(double t) { fromSec(t); }
|
||||
|
||||
/**
|
||||
* \brief Returns the current steady (monotonic) clock time.
|
||||
*/
|
||||
static SteadyTime now();
|
||||
|
||||
/**
|
||||
* \brief Sleep until a specific time has been reached.
|
||||
* @return True if the desired sleep time was met, false otherwise.
|
||||
*/
|
||||
static bool sleepUntil(const SteadyTime& end);
|
||||
|
||||
static bool isSystemTime() { return true; }
|
||||
};
|
||||
|
||||
template<> const SteadyTime TimeBase<SteadyTime, WallDuration>::MAX;
|
||||
template<> const SteadyTime TimeBase<SteadyTime, WallDuration>::MIN;
|
||||
template<> const SteadyTime TimeBase<SteadyTime, WallDuration>::ZERO;
|
||||
template<> const SteadyTime TimeBase<SteadyTime, WallDuration>::UNINITIALIZED;
|
||||
|
||||
ROBOT_TIME_DECL std::ostream &operator <<(std::ostream &os, const Time &rhs);
|
||||
ROBOT_TIME_DECL std::ostream &operator <<(std::ostream &os, const WallTime &rhs);
|
||||
ROBOT_TIME_DECL std::ostream &operator <<(std::ostream &os, const SteadyTime &rhs);
|
||||
}
|
||||
|
||||
#endif // ROBOT_TIME_H
|
||||
Reference in New Issue
Block a user