blob: cd4ecda12b10050f4a54f5ec9f593cc3d53e944e [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
brians57dd5822013-02-27 21:44:15 +00004#include <sys/time.h>
Brian4a424a22014-04-02 11:52:45 -07005
Austin Schuh793d6b92016-05-01 13:28:14 -07006#include <chrono>
Tyler Chatowbf0609c2021-07-31 16:13:27 -07007#include <cstdint>
8#include <ctime>
Austin Schuh3ce0a922020-07-21 21:08:54 -07009#include <optional>
brians343bc112013-02-10 01:53:46 +000010#include <ostream>
James Kuszmaul651fc3f2019-05-15 21:14:25 -070011#include <thread>
brians343bc112013-02-10 01:53:46 +000012
13namespace aos {
Austin Schuh793d6b92016-05-01 13:28:14 -070014
15class monotonic_clock {
16 public:
17 typedef ::std::chrono::nanoseconds::rep rep;
18 typedef ::std::chrono::nanoseconds::period period;
19 typedef ::std::chrono::nanoseconds duration;
20 typedef ::std::chrono::time_point<monotonic_clock> time_point;
21
22 static monotonic_clock::time_point now() noexcept;
Brian Silvermana3688802019-02-16 19:31:26 -080023 // This clock is still subject to rate adjustments based on adjtime, so it is
24 // not steady.
25 static constexpr bool is_steady = false;
26
Austin Schuh3ce0a922020-07-21 21:08:54 -070027 // Converts the time string to a time_point if it is well formatted. This is
28 // designed to reverse operator <<.
Austin Schuhd90499f2023-03-24 15:10:51 -070029#ifdef __linux__
Austin Schuh3ce0a922020-07-21 21:08:54 -070030 static std::optional<monotonic_clock::time_point> FromString(
31 const std::string_view now);
Austin Schuhd90499f2023-03-24 15:10:51 -070032#endif
Austin Schuh3ce0a922020-07-21 21:08:54 -070033
Brian Silvermana3688802019-02-16 19:31:26 -080034 // Returns the epoch (0).
35 static constexpr monotonic_clock::time_point epoch() {
36 return time_point(zero());
37 }
38
39 static constexpr monotonic_clock::duration zero() { return duration(0); }
40
41 static constexpr time_point min_time{
42 time_point(duration(::std::numeric_limits<duration::rep>::min()))};
Brian Silverman94357272019-02-23 21:00:54 -080043 static constexpr time_point max_time{
44 time_point(duration(::std::numeric_limits<duration::rep>::max()))};
Brian Silvermana3688802019-02-16 19:31:26 -080045};
46
47class realtime_clock {
48 public:
49 typedef ::std::chrono::nanoseconds::rep rep;
50 typedef ::std::chrono::nanoseconds::period period;
51 typedef ::std::chrono::nanoseconds duration;
Austin Schuh40102d22019-12-27 23:30:06 -080052 typedef ::std::chrono::time_point<realtime_clock> time_point;
Brian Silvermana3688802019-02-16 19:31:26 -080053
54#ifdef __linux__
Austin Schuh40102d22019-12-27 23:30:06 -080055 static realtime_clock::time_point now() noexcept;
Brian Silvermana3688802019-02-16 19:31:26 -080056#endif // __linux__
57 static constexpr bool is_steady = false;
Austin Schuh793d6b92016-05-01 13:28:14 -070058
Austin Schuh3ce0a922020-07-21 21:08:54 -070059 // Converts the time string to a time_point if it is well formatted. This is
60 // designed to reverse operator <<.
Austin Schuhd90499f2023-03-24 15:10:51 -070061#ifdef __linux__
Austin Schuh3ce0a922020-07-21 21:08:54 -070062 static std::optional<realtime_clock::time_point> FromString(
63 const std::string_view now);
Austin Schuhd90499f2023-03-24 15:10:51 -070064#endif
Austin Schuh3ce0a922020-07-21 21:08:54 -070065
Austin Schuh793d6b92016-05-01 13:28:14 -070066 // Returns the epoch (0).
Austin Schuh40102d22019-12-27 23:30:06 -080067 static constexpr realtime_clock::time_point epoch() {
Austin Schuh8aec1ed2016-05-01 13:29:20 -070068 return time_point(zero());
Austin Schuh793d6b92016-05-01 13:28:14 -070069 }
Austin Schuh8aec1ed2016-05-01 13:29:20 -070070
Austin Schuh40102d22019-12-27 23:30:06 -080071 static constexpr realtime_clock::duration zero() { return duration(0); }
Austin Schuh858c0212016-11-25 17:23:30 -080072
73 static constexpr time_point min_time{
74 time_point(duration(::std::numeric_limits<duration::rep>::min()))};
Brian Silverman94357272019-02-23 21:00:54 -080075 static constexpr time_point max_time{
76 time_point(duration(::std::numeric_limits<duration::rep>::max()))};
Austin Schuh793d6b92016-05-01 13:28:14 -070077};
78
James Kuszmaul38735e82019-12-07 16:42:06 -080079std::ostream &operator<<(std::ostream &stream,
80 const aos::monotonic_clock::time_point &now);
Austin Schuh40102d22019-12-27 23:30:06 -080081std::ostream &operator<<(std::ostream &stream,
82 const aos::realtime_clock::time_point &now);
Austin Schuhde8a8ff2019-11-30 15:25:36 -080083
brians343bc112013-02-10 01:53:46 +000084namespace time {
Brian Silvermanc03a30c2019-02-16 18:21:56 -080085#ifdef __linux__
86
Austin Schuhf2a50ba2016-12-24 16:16:26 -080087// Construct a time representing the period of hertz.
88constexpr ::std::chrono::nanoseconds FromRate(int hertz) {
89 return ::std::chrono::duration_cast<::std::chrono::nanoseconds>(
90 ::std::chrono::seconds(1)) /
91 hertz;
92}
93
James Kuszmaul651fc3f2019-05-15 21:14:25 -070094template <typename Scalar>
95constexpr Scalar TypedDurationInSeconds(monotonic_clock::duration dt) {
96 return ::std::chrono::duration_cast<::std::chrono::duration<Scalar>>(dt)
97 .count();
98}
99
100constexpr double DurationInSeconds(monotonic_clock::duration dt) {
101 return TypedDurationInSeconds<double>(dt);
102}
103
Brian Silvermanc03a30c2019-02-16 18:21:56 -0800104#endif // __linux__
105
Neil Balch229001a2018-01-07 18:22:52 -0800106// Converts a monotonic_clock::duration into a timespec object.
107struct timespec to_timespec(::aos::monotonic_clock::duration duration);
108
109// Converts a monotonic_clock::time_point into a timespec object as time since
110// epoch.
111struct timespec to_timespec(::aos::monotonic_clock::time_point time);
112
Brian Silverman967e5df2020-02-09 16:43:34 -0800113// Converts a timeval object to a monotonic_clock::time_point.
114::aos::monotonic_clock::time_point from_timeval(struct timeval t);
115
brians343bc112013-02-10 01:53:46 +0000116} // namespace time
117} // namespace aos
118
Brian Silvermanc03a30c2019-02-16 18:21:56 -0800119#ifdef __linux__
120
Austin Schuh793d6b92016-05-01 13:28:14 -0700121namespace std {
122namespace this_thread {
123// Template specialization for monotonic_clock, since we can use clock_nanosleep
124// with TIMER_ABSTIME and get very precise absolute time sleeps.
125template <>
126void sleep_until(const ::aos::monotonic_clock::time_point &end_time);
127
128} // namespace this_thread
129} // namespace std
130
Brian Silvermanc03a30c2019-02-16 18:21:56 -0800131#endif // __linux__
Austin Schuh793d6b92016-05-01 13:28:14 -0700132
John Park33858a32018-09-28 23:05:48 -0700133#endif // AOS_TIME_H_