be86f1b324
As the update() function return false both if the forceUpdate fail, and also if the timeout isn't expired, we are not able to know if the last ntp update was fine. Wouldn't be better to return true if the last sync was gone ok, and false if wasn't good?
116 lines
3.0 KiB
C++
Executable File
116 lines
3.0 KiB
C++
Executable File
#pragma once
|
|
|
|
#include "Arduino.h"
|
|
|
|
#include <Udp.h>
|
|
|
|
#define SEVENZYYEARS 2208988800UL
|
|
#define NTP_PACKET_SIZE 48
|
|
#define NTP_DEFAULT_LOCAL_PORT 1337
|
|
|
|
class NTPClient {
|
|
private:
|
|
UDP* _udp;
|
|
bool _udpSetup = false;
|
|
|
|
const char* _poolServerName = "pool.ntp.org"; // Default time server
|
|
IPAddress _poolServerIP;
|
|
unsigned int _port = NTP_DEFAULT_LOCAL_PORT;
|
|
long _timeOffset = 0;
|
|
|
|
unsigned long _updateInterval = 60000; // In ms
|
|
|
|
unsigned long _currentEpoc = 0; // In s
|
|
unsigned long _lastUpdate = 0; // In ms
|
|
bool _lastUpdateOk = false; //
|
|
|
|
byte _packetBuffer[NTP_PACKET_SIZE];
|
|
|
|
void sendNTPPacket();
|
|
|
|
public:
|
|
NTPClient(UDP& udp);
|
|
NTPClient(UDP& udp, long timeOffset);
|
|
NTPClient(UDP& udp, const char* poolServerName);
|
|
NTPClient(UDP& udp, const char* poolServerName, long timeOffset);
|
|
NTPClient(UDP& udp, const char* poolServerName, long timeOffset, unsigned long updateInterval);
|
|
NTPClient(UDP& udp, IPAddress poolServerIP);
|
|
NTPClient(UDP& udp, IPAddress poolServerIP, long timeOffset);
|
|
NTPClient(UDP& udp, IPAddress poolServerIP, long timeOffset, unsigned long updateInterval);
|
|
|
|
/**
|
|
* Set time server name
|
|
*
|
|
* @param poolServerName
|
|
*/
|
|
void setPoolServerName(const char* poolServerName);
|
|
|
|
/**
|
|
* Set time server IP
|
|
*
|
|
* @param poolServerIP
|
|
*/
|
|
void setPoolServerIP(IPAddress poolServerIP);
|
|
|
|
/**
|
|
* Set random local port
|
|
*/
|
|
void setRandomPort(unsigned int minValue = 49152, unsigned int maxValue = 65535);
|
|
|
|
/**
|
|
* Starts the underlying UDP client with the default local port
|
|
*/
|
|
void begin();
|
|
|
|
/**
|
|
* Starts the underlying UDP client with the specified local port
|
|
*/
|
|
void begin(unsigned int port);
|
|
|
|
/**
|
|
* This should be called in the main loop of your application. By default an update from the NTP Server is only
|
|
* made every 60 seconds. This can be configured in the NTPClient constructor.
|
|
*
|
|
* @return true on success, false on failure
|
|
*/
|
|
bool update();
|
|
|
|
/**
|
|
* This will force the update from the NTP Server.
|
|
*
|
|
* @return true on success, false on failure
|
|
*/
|
|
bool forceUpdate();
|
|
|
|
int getDay() const;
|
|
int getHours() const;
|
|
int getMinutes() const;
|
|
int getSeconds() const;
|
|
|
|
/**
|
|
* Changes the time offset. Useful for changing timezones dynamically
|
|
*/
|
|
void setTimeOffset(int timeOffset);
|
|
|
|
/**
|
|
* Set the update interval to another frequency. E.g. useful when the
|
|
* timeOffset should not be set in the constructor
|
|
*/
|
|
void setUpdateInterval(unsigned long updateInterval);
|
|
|
|
/**
|
|
* @return time formatted like `hh:mm:ss`
|
|
*/
|
|
String getFormattedTime() const;
|
|
|
|
/**
|
|
* @return time in seconds since Jan. 1, 1970
|
|
*/
|
|
unsigned long getEpochTime() const;
|
|
|
|
/**
|
|
* Stops the underlying UDP client
|
|
*/
|
|
void end();
|
|
};
|