Ben Meadors
99abfebc4a
* Fix TransmitHistory to improve epoch handling * Enable epoch handling in unit tests * Improve comments and test handling for epoch persistence in TransmitHistory * Add boot-relative timestamp handling and unit tests for TransmitHistory * loadFromDisk should handle legacy entries and clean up old v1 files after migration * Revert "loadFromDisk should handle legacy entries and clean up old v1 files after migration" This reverts commit eb7e5c7acfa4ac077fe50980be752e4b42a739b8. * Add NodeInfoModule integration for RTC quality changes and trigger immediate checks * Update test conditions for RTC quality checks
69 lines
1.9 KiB
C
69 lines
1.9 KiB
C
#pragma once
|
|
|
|
#include "configuration.h"
|
|
#include "sys/time.h"
|
|
#include <Arduino.h>
|
|
|
|
#ifdef RX8130CE_RTC
|
|
#include <ArtronShop_RX8130CE.h>
|
|
#endif
|
|
|
|
enum RTCQuality {
|
|
|
|
/// We haven't had our RTC set yet
|
|
RTCQualityNone = 0,
|
|
|
|
/// We got time from an onboard peripheral after boot.
|
|
RTCQualityDevice = 1,
|
|
|
|
/// Some other node gave us a time we can use
|
|
RTCQualityFromNet = 2,
|
|
|
|
/// Our time is based on NTP
|
|
RTCQualityNTP = 3,
|
|
|
|
/// Our time is based on our own GPS
|
|
RTCQualityGPS = 4
|
|
};
|
|
|
|
/// The RTC set result codes
|
|
/// Used to indicate the result of an attempt to set the RTC.
|
|
enum RTCSetResult {
|
|
RTCSetResultNotSet = 0, ///< RTC was set successfully
|
|
RTCSetResultSuccess = 1, ///< RTC was set successfully
|
|
RTCSetResultInvalidTime = 3, ///< The provided time was invalid (e.g., before the build epoch)
|
|
RTCSetResultError = 4 ///< An error occurred while setting the RTC
|
|
};
|
|
|
|
RTCQuality getRTCQuality();
|
|
|
|
extern uint32_t lastSetFromPhoneNtpOrGps;
|
|
|
|
/// If we haven't yet set our RTC this boot, set it from a GPS derived time
|
|
RTCSetResult perhapsSetRTC(RTCQuality q, const struct timeval *tv, bool forceUpdate = false);
|
|
RTCSetResult perhapsSetRTC(RTCQuality q, const struct tm &t);
|
|
|
|
/// Return a string name for the quality
|
|
const char *RtcName(RTCQuality quality);
|
|
|
|
/// Return time since 1970 in secs. While quality is RTCQualityNone we will be returning time based at zero
|
|
uint32_t getTime(bool local = false);
|
|
|
|
/// Return time since 1970 in secs. If quality is RTCQualityNone return zero
|
|
uint32_t getValidTime(RTCQuality minQuality, bool local = false);
|
|
|
|
RTCSetResult readFromRTC();
|
|
|
|
#ifdef PIO_UNIT_TESTING
|
|
void setBootRelativeTimeForUnitTest(uint32_t secondsSinceBoot);
|
|
#endif
|
|
|
|
time_t gm_mktime(const struct tm *tm);
|
|
|
|
#define SEC_PER_DAY 86400
|
|
#define SEC_PER_HOUR 3600
|
|
#define SEC_PER_MIN 60
|
|
#ifdef BUILD_EPOCH
|
|
static constexpr uint64_t FORTY_YEARS = (40ULL * 365 * SEC_PER_DAY); // Use 64-bit arithmetic to prevent overflow
|
|
#endif
|