NTPClient.h
/*H********************************************************
 * The MIT License (MIT)
 * Copyright (c) 2015 by Fabrice Weinberg
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 * above copyright notice and this permission notice shall be included in all
 * copies or substantial portions of the Software.
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 * SOFTWARE.
 ********************************************************/
#include "NTPClient.h"
/*F********************************************************************
*  NTPClient Constructors
**********************************************************************/
NTPClient::
NTPClient( UDP &udp ) 
{
	this->_udp            = &udp;
}
NTPClient::
NTPClient( UDP &udp, long timeOffset ) 
{
	this->_udp            = &udp;
	this->_timeOffset     = timeOffset;
}
NTPClient::
NTPClient( UDP &udp, const char *poolServerName ) 
{
	this->_udp            = &udp;
	this->_poolServerName = poolServerName;
}
NTPClient::
NTPClient( UDP &udp, IPAddress poolServerIP ) 
{
	this->_udp            = &udp;
	this->_poolServerIP   = poolServerIP;
	this->_poolServerName = NULL;
}
NTPClient::
NTPClient( UDP &udp, const char *poolServerName, long timeOffset ) 
{
	this->_udp            = &udp;
	this->_timeOffset     = timeOffset;
	this->_poolServerName = poolServerName;
}
NTPClient::
NTPClient( UDP &udp, IPAddress poolServerIP, long timeOffset )
{
	this->_udp            = &udp;
	this->_timeOffset     = timeOffset;
	this->_poolServerIP   = poolServerIP;
	this->_poolServerName = NULL;
}
NTPClient::
NTPClient( UDP &udp, const char *poolServerName, long timeOffset
	, unsigned long updateInterval) 
{
	this->_udp            = &udp;
	this->_timeOffset     = timeOffset;
	this->_poolServerName = poolServerName;
	this->_updateInterval = updateInterval;
}
NTPClient::
NTPClient( UDP &udp, IPAddress poolServerIP, long timeOffset
	, unsigned long updateInterval) 
{
	this->_udp            = &udp;
	this->_timeOffset     = timeOffset;
	this->_poolServerIP   = poolServerIP;
	this->_poolServerName = NULL;
	this->_updateInterval = updateInterval;
}
/*F********************************************************************
*
**********************************************************************/
void NTPClient::
begin() 
{
	this->begin( NTP_DEFAULT_LOCAL_PORT );
}
void NTPClient::
begin( unsigned int port ) 
{
	this->_port = port;
	this->_udp->begin( this->_port );
	this->_udpSetup = true;
}
/*F********************************************************************
*
**********************************************************************/
bool NTPClient::
forceUpdate() 
{
#ifdef DEBUG_NTPClient
	Serial.println( "Update from NTP Server");
#endif
	while( this->_udp->parsePacket() != 0)     // flush any existing packets
	this->_udp->flush();
	this->sendNTPPacket();
	byte timeout = 0;
	int cb = 0;
	do 
	{ // Wait till data is there or timeout...
		delay( 10 );
		cb = this->_udp->parsePacket();
		if( timeout > 100 ) 
			return( false ); // timeout after 1000 ms
		timeout++;
	}while( cb == 0 );
	this->_lastUpdate = millis() - (10 * (timeout +1)); // Account for TX delay
	this->_udp->read( this->_packetBuffer, NTP_PACKET_SIZE );
	unsigned long highWord = word( this->_packetBuffer[40]
		, this->_packetBuffer[41]);
	unsigned long lowWord = word( this->_packetBuffer[42]
		, this->_packetBuffer[43]);
	// combine 4 bytes (two words) into a long int, NTP time 
	// (secs since Jan 1 1900):
	unsigned long secsSince1900 = highWord << 16 | lowWord;
	this->_currentEpoc = secsSince1900 - SEVENZYYEARS;
	return( true );  // return true after successful update
}
/*F********************************************************************
*
**********************************************************************/
bool NTPClient::
update() 
{
	if( (millis() - this->_lastUpdate >= this->_updateInterval) 
		|| this->_lastUpdate == 0)           // UPDATE AFTER _UPDATEiNTERVAL
	{                                   // UPDATE IF THERE WAS NO UPDATE YET
		if( !this->_udpSetup || this->_port != NTP_DEFAULT_LOCAL_PORT) 
			this->begin( this->_port);         // SETUP UDP CLIENT IF NEEDED
		return this->forceUpdate();
	}
	return( false );                // RETURN FALSE IF UPDATE DOES NOT OCCUR
}
/*F********************************************************************
*
**********************************************************************/
bool NTPClient::
isTimeSet() const 
{
	return( this->_lastUpdate != 0); // RETURNS TRUE IF TIME SET, ELSE FALSE
}
/*F********************************************************************
*
**********************************************************************/
unsigned long NTPClient::
getEpochTime() const 
{
	return( this->_timeOffset                                 // USER OFFSET
		+ this->_currentEpoc                 // Epoch RETURNED BY NTP SERVER 
		+ ((millis() - this->_lastUpdate) / 1000); // TIME SINCE LAST UPDATE
}
/*F********************************************************************
*
**********************************************************************/
int NTPClient::
getDay() const 
{
	return( ((this->getEpochTime()  / 86400L) + 4 ) % 7);    // 0 IS SUNDAY
}
/*F********************************************************************
*
**********************************************************************/
int NTPClient::
getHours() const 
{
	return( (this->getEpochTime()  % 86400L) / 3600);
}
/*F********************************************************************
*
**********************************************************************/
int NTPClient::
getMinutes() const 
{
	return( (this->getEpochTime() % 3600) / 60);
}
/*F********************************************************************
*
**********************************************************************/
int NTPClient::
getSeconds() const 
{
	return( this->getEpochTime() % 60);
}
/*F********************************************************************
*
**********************************************************************/
String NTPClient::
getFormattedTime() const 
{
	unsigned long rawTime = this->getEpochTime();
	unsigned long hours = (rawTime % 86400L) / 3600;
	String hoursStr = hours < 10 ? "0" + String(hours) : String(hours);
	unsigned long minutes = (rawTime % 3600) / 60;
	String minuteStr = minutes < 10 ? "0" + String(minutes) : String(minutes);
	unsigned long seconds = rawTime % 60;
	String secondStr = seconds < 10 ? "0" + String(seconds) : String(seconds);
	return( hoursStr + ":" + minuteStr + ":" + secondStr );
}
/*F********************************************************************
*
**********************************************************************/
void NTPClient::
end() 
{
	this->_udp->stop();
	this->_udpSetup = false;
}
/*F********************************************************************
*
**********************************************************************/
void NTPClient::
setTimeOffset(int timeOffset) 
{
	this->_timeOffset = timeOffset;
}
    
/*F********************************************************************
*
**********************************************************************/
void NTPClient::
setUpdateInterval( unsigned long updateInterval ) 
{
	this->_updateInterval = updateInterval;
}
/*F********************************************************************
*
**********************************************************************/
void NTPClient::
setPoolServerName(const char* poolServerName) 
{
	this->_poolServerName = poolServerName;
}
/*F********************************************************************
*
**********************************************************************/
void NTPClient::
sendNTPPacket() 
{
	memset( this->_packetBuffer, 0, NTP_PACKET_SIZE); // CLR BUFFER
	// Init values needed to form NTP request
	this->_packetBuffer[0] = 0b11100011;   // LI, Version, Mode
	this->_packetBuffer[1] = 0;     // Stratum, or type of clock
	this->_packetBuffer[2] = 6;     // Polling Interval
	this->_packetBuffer[3] = 0xEC;  // Peer Clock Precision
	// 8 bytes of zero for Root Delay & Root Dispersion
	this->_packetBuffer[12]  = 49;
	this->_packetBuffer[13]  = 0x4E;
	this->_packetBuffer[14]  = 49;
	this->_packetBuffer[15]  = 52;
	// all NTP fields have been given values, send packet requesting timestamp:
	if( this->_poolServerName ) 
		this->_udp->beginPacket(this->_poolServerName, 123);
	else 
		this->_udp->beginPacket(this->_poolServerIP, 123);
	this->_udp->write( this->_packetBuffer, NTP_PACKET_SIZE);
	this->_udp->endPacket();
}
/*F********************************************************************
*
**********************************************************************/
void NTPClient::
setRandomPort( unsigned int minValue, unsigned int maxValue) 
{
	randomSeed( analogRead(0) );
	this->_port = random( minValue, maxValue );
}