code-grappe/lib/NTPClient-master/NTPClient.h

115 lines
3 KiB
C
Raw Normal View History

2021-06-21 11:29:53 +02:00
#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
2022-05-24 10:03:16 +02:00
IPAddress _poolServerIP;
unsigned int _port = NTP_DEFAULT_LOCAL_PORT;
long _timeOffset = 0;
2021-06-21 11:29:53 +02:00
unsigned long _updateInterval = 60000; // In ms
unsigned long _currentEpoc = 0; // In s
unsigned long _lastUpdate = 0; // In ms
byte _packetBuffer[NTP_PACKET_SIZE];
void sendNTPPacket();
public:
NTPClient(UDP& udp);
2022-05-24 10:03:16 +02:00
NTPClient(UDP& udp, long timeOffset);
2021-06-21 11:29:53 +02:00
NTPClient(UDP& udp, const char* poolServerName);
2022-05-24 10:03:16 +02:00
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 random local port
*/
void setRandomPort(unsigned int minValue = 49152, unsigned int maxValue = 65535);
2021-06-21 11:29:53 +02:00
/**
* Starts the underlying UDP client with the default local port
*/
void begin();
/**
* Starts the underlying UDP client with the specified local port
*/
2022-05-24 10:03:16 +02:00
void begin(unsigned int port);
2021-06-21 11:29:53 +02:00
/**
* 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();
2022-05-24 10:03:16 +02:00
/**
* This allows to check if the NTPClient successfully received a NTP packet and set the time.
*
* @return true if time has been set, else false
*/
bool isTimeSet() const;
int getDay() const;
int getHours() const;
int getMinutes() const;
int getSeconds() const;
2021-06-21 11:29:53 +02:00
/**
* 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);
/**
2022-05-24 10:03:16 +02:00
* @return time formatted like `hh:mm:ss`
*/
String getFormattedTime() const;
2021-06-21 11:29:53 +02:00
/**
* @return time in seconds since Jan. 1, 1970
*/
2022-05-24 10:03:16 +02:00
unsigned long getEpochTime() const;
2021-06-21 11:29:53 +02:00
/**
* Stops the underlying UDP client
*/
void end();
};