blob: 881f0f16d42b351c91968100f6e8048ae27864c7 [file] [log] [blame]
John Park33858a32018-09-28 23:05:48 -07001#ifndef AOS_TIME_H_
2#define AOS_TIME_H_
brians343bc112013-02-10 01:53:46 +00003
4#include <stdint.h>
brians57dd5822013-02-27 21:44:15 +00005#include <sys/time.h>
James Kuszmaul651fc3f2019-05-15 21:14:25 -07006#include <time.h>
Brian4a424a22014-04-02 11:52:45 -07007
Austin Schuh793d6b92016-05-01 13:28:14 -07008#include <chrono>
brians343bc112013-02-10 01:53:46 +00009#include <ostream>
James Kuszmaul651fc3f2019-05-15 21:14:25 -070010#include <thread>
11#include <type_traits>
brians343bc112013-02-10 01:53:46 +000012
John Park33858a32018-09-28 23:05:48 -070013#include "aos/macros.h"
James Kuszmaul651fc3f2019-05-15 21:14:25 -070014#include "aos/type_traits/type_traits.h"
brians343bc112013-02-10 01:53:46 +000015
16namespace aos {
Austin Schuh793d6b92016-05-01 13:28:14 -070017
18class monotonic_clock {
19 public:
20 typedef ::std::chrono::nanoseconds::rep rep;
21 typedef ::std::chrono::nanoseconds::period period;
22 typedef ::std::chrono::nanoseconds duration;
23 typedef ::std::chrono::time_point<monotonic_clock> time_point;
24
25 static monotonic_clock::time_point now() noexcept;
Brian Silvermana3688802019-02-16 19:31:26 -080026 // This clock is still subject to rate adjustments based on adjtime, so it is
27 // not steady.
28 static constexpr bool is_steady = false;
29
30 // Returns the epoch (0).
31 static constexpr monotonic_clock::time_point epoch() {
32 return time_point(zero());
33 }
34
35 static constexpr monotonic_clock::duration zero() { return duration(0); }
36
37 static constexpr time_point min_time{
38 time_point(duration(::std::numeric_limits<duration::rep>::min()))};
Brian Silverman94357272019-02-23 21:00:54 -080039 static constexpr time_point max_time{
40 time_point(duration(::std::numeric_limits<duration::rep>::max()))};
Brian Silvermana3688802019-02-16 19:31:26 -080041};
42
43class realtime_clock {
44 public:
45 typedef ::std::chrono::nanoseconds::rep rep;
46 typedef ::std::chrono::nanoseconds::period period;
47 typedef ::std::chrono::nanoseconds duration;
48 typedef ::std::chrono::time_point<monotonic_clock> time_point;
49
50#ifdef __linux__
51 static monotonic_clock::time_point now() noexcept;
52#endif // __linux__
53 static constexpr bool is_steady = false;
Austin Schuh793d6b92016-05-01 13:28:14 -070054
55 // Returns the epoch (0).
56 static constexpr monotonic_clock::time_point epoch() {
Austin Schuh8aec1ed2016-05-01 13:29:20 -070057 return time_point(zero());
Austin Schuh793d6b92016-05-01 13:28:14 -070058 }
Austin Schuh8aec1ed2016-05-01 13:29:20 -070059
60 static constexpr monotonic_clock::duration zero() { return duration(0); }
Austin Schuh858c0212016-11-25 17:23:30 -080061
62 static constexpr time_point min_time{
63 time_point(duration(::std::numeric_limits<duration::rep>::min()))};
Brian Silverman94357272019-02-23 21:00:54 -080064 static constexpr time_point max_time{
65 time_point(duration(::std::numeric_limits<duration::rep>::max()))};
Austin Schuh793d6b92016-05-01 13:28:14 -070066};
67
brians343bc112013-02-10 01:53:46 +000068namespace time {
69
Brian Silvermanc03a30c2019-02-16 18:21:56 -080070#ifdef __linux__
71
Austin Schuh6a6f90c2016-11-25 21:36:42 -080072// Enables returning the mock time value for Now instead of checking the system
73// clock.
74void EnableMockTime(monotonic_clock::time_point now);
75// Calls SetMockTime with the current actual time.
76void UpdateMockTime();
77// Sets now when time is being mocked.
78void SetMockTime(monotonic_clock::time_point now);
79// Convenience function to just increment the mock time by a certain amount in
80// a thread safe way.
81void IncrementMockTime(monotonic_clock::duration amount);
82// Disables mocking time.
83void DisableMockTime();
84
Austin Schuhf2a50ba2016-12-24 16:16:26 -080085// Construct a time representing the period of hertz.
86constexpr ::std::chrono::nanoseconds FromRate(int hertz) {
87 return ::std::chrono::duration_cast<::std::chrono::nanoseconds>(
88 ::std::chrono::seconds(1)) /
89 hertz;
90}
91
James Kuszmaul651fc3f2019-05-15 21:14:25 -070092template <typename Scalar>
93constexpr Scalar TypedDurationInSeconds(monotonic_clock::duration dt) {
94 return ::std::chrono::duration_cast<::std::chrono::duration<Scalar>>(dt)
95 .count();
96}
97
98constexpr double DurationInSeconds(monotonic_clock::duration dt) {
99 return TypedDurationInSeconds<double>(dt);
100}
101
Austin Schuhf2a50ba2016-12-24 16:16:26 -0800102// RAII class that freezes monotonic_clock::now() (to avoid making large numbers
103// of syscalls to find the real time).
Brian Silvermanb407c672014-04-09 11:58:37 -0700104class TimeFreezer {
105 public:
Austin Schuh6a6f90c2016-11-25 21:36:42 -0800106 TimeFreezer() { EnableMockTime(monotonic_clock::now()); }
107 ~TimeFreezer() { DisableMockTime(); }
Brian Silvermanb407c672014-04-09 11:58:37 -0700108
109 private:
110 DISALLOW_COPY_AND_ASSIGN(TimeFreezer);
111};
112
Brian Silvermanc03a30c2019-02-16 18:21:56 -0800113#endif // __linux__
114
Neil Balch229001a2018-01-07 18:22:52 -0800115// Converts a monotonic_clock::duration into a timespec object.
116struct timespec to_timespec(::aos::monotonic_clock::duration duration);
117
118// Converts a monotonic_clock::time_point into a timespec object as time since
119// epoch.
120struct timespec to_timespec(::aos::monotonic_clock::time_point time);
121
Brian Silvermanc03a30c2019-02-16 18:21:56 -0800122namespace time_internal {
123
124template <class T>
125struct is_duration : std::false_type {};
126template <class Rep, class Period>
127struct is_duration<std::chrono::duration<Rep, Period>> : std::true_type {};
128
129} // namespace time_internal
130
131// Returns the greatest duration t representable in ToDuration that is less or
132// equal to d.
133// Implementation copied from
134// https://en.cppreference.com/w/cpp/chrono/duration/floor.
135// TODO(Brian): Remove once we have C++17 support.
136template <class To, class Rep, class Period,
137 class = std::enable_if_t<time_internal::is_duration<To>{}>>
138constexpr To floor(const std::chrono::duration<Rep, Period> &d) {
139 To t = std::chrono::duration_cast<To>(d);
140 if (t > d) return t - To{1};
141 return t;
142}
143
144// Returns the value t representable in ToDuration that is the closest to d. If
145// there are two such values, returns the even value (that is, the value t such
146// that t % 2 == 0).
147// Implementation copied from
148// https://en.cppreference.com/w/cpp/chrono/duration/round.
149// TODO(Brian): Remove once we have C++17 support.
150template <class To, class Rep, class Period,
151 class = std::enable_if_t<
152 time_internal::is_duration<To>{} &&
153 !std::chrono::treat_as_floating_point<typename To::rep>{}>>
154constexpr To round(const std::chrono::duration<Rep, Period> &d) {
155 To t0 = aos::time::floor<To>(d);
156 To t1 = t0 + To{1};
157 auto diff0 = d - t0;
158 auto diff1 = t1 - d;
159 if (diff0 == diff1) {
160 if (t0.count() & 1) return t1;
161 return t0;
162 } else if (diff0 < diff1) {
163 return t0;
164 }
165 return t1;
166}
167
168// Returns the nearest time point to tp representable in ToDuration, rounding to
169// even in halfway cases, like std::chrono::round in C++17.
170// Implementation copied from
171// https://en.cppreference.com/w/cpp/chrono/time_point/round.
172// TODO(Brian): Remove once we have C++17 support.
173template <class To, class Clock, class FromDuration,
174 class = std::enable_if_t<
175 time_internal::is_duration<To>{} &&
176 !std::chrono::treat_as_floating_point<typename To::rep>{}>>
177constexpr std::chrono::time_point<Clock, To> round(
178 const std::chrono::time_point<Clock, FromDuration> &tp) {
179 return std::chrono::time_point<Clock, To>{
180 aos::time::round<To>(tp.time_since_epoch())};
181}
182
brians343bc112013-02-10 01:53:46 +0000183} // namespace time
184} // namespace aos
185
Brian Silvermanc03a30c2019-02-16 18:21:56 -0800186#ifdef __linux__
187
Austin Schuh793d6b92016-05-01 13:28:14 -0700188namespace std {
189namespace this_thread {
190// Template specialization for monotonic_clock, since we can use clock_nanosleep
191// with TIMER_ABSTIME and get very precise absolute time sleeps.
192template <>
193void sleep_until(const ::aos::monotonic_clock::time_point &end_time);
194
195} // namespace this_thread
196} // namespace std
197
Brian Silvermanc03a30c2019-02-16 18:21:56 -0800198#endif // __linux__
Austin Schuh793d6b92016-05-01 13:28:14 -0700199
John Park33858a32018-09-28 23:05:48 -0700200#endif // AOS_TIME_H_