NTPCLient.cpp
NTP Client begin isValid forceUpdate
update getEpochTime getDay getHours
getMinutes getSeconds getFormattedTime getFormattedDate
end setTimeOffset setUpdateInterval sendNtpPacket
setEpochTime
/*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:
* The 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"

typedef unsigned long ulong;

/*F******************************************************************** * **********************************************************************/ NTPClient:: NTPClient( UDP &udp ) { this->_udp = &udp; } /*F******************************************************************** * **********************************************************************/ NTPClient:: NTPClient( UDP &udp, int timeOffset ) { this->_udp = &udp; this->_timeOffset = timeOffset; } /*F******************************************************************** * **********************************************************************/ NTPClient:: NTPClient( UDP &udp, const char *poolServerName ) { this->_udp = &udp; this->_poolServerName = poolServerName; } /*F******************************************************************** * **********************************************************************/ NTPClient:: NTPClient( UDP &udp, const char *poolServerName, int timeOffset ) { this->_udp = &udp; this->_timeOffset = timeOffset; this->_poolServerName = poolServerName; } /*F******************************************************************** * **********************************************************************/ NTPClient:: NTPClient( UDP &udp, const char *poolServerName, int timeOffset , unsigned long updateInterval ) { this->_udp = &udp; this->_timeOffset = timeOffset; this->_poolServerName = poolServerName; this->_updateInterval = updateInterval; }
/*F******************************************************************** * **********************************************************************/ void NTPClient:: begin() { this->begin( NTP_DEFAULT_LOCAL_PORT ); } /*F******************************************************************** * **********************************************************************/ void NTPClient:: begin( int port ) { this->_port = port; this->_udp->begin( this->_port ); this->_udpSetup = true; }
/*F******************************************************************** * Perform a few validity checks on the packet **********************************************************************/ bool NTPClient:: isValid( byte * ntpPacket ) { if( ( ntpPacket[0] & 0b11000000 ) == 0b11000000 ) //Check for LI=UNSYNC return false; if( ( ntpPacket[0] & 0b00111000 ) >> 3 < 0b100 )//Check for Version >= 4 return false; if( ( ntpPacket[0] & 0b00000111 ) != 0b100 ) //Check for Mode == Server return false; if( ( ntpPacket[1] < 1 ) || ( ntpPacket[1] > 15 ) )//Check for valid Stratum return false; if( ntpPacket[16] == 0 && ntpPacket[17] == 0 //Check for Ref TimStamp != 0 && ntpPacket[18] == 0 && ntpPacket[19] == 0 && ntpPacket[20] == 0 && ntpPacket[21] == 0 && ntpPacket[22] == 0 && ntpPacket[22] == 0 ) return false; return true; }
/*F******************************************************************** * **********************************************************************/ bool NTPClient:: forceUpdate() { #ifdef DEBUG_NTPClient Serial.println( "Update from NTP Server" ); #endif while( this->_udp->parsePacket() != 0 ) this->_udp->flush(); // FLUSH ANY EXISTING PACKETS this->sendNTPPacket(); byte timeout = 0; // WAIT TILL DATA IS THERE OR TIMEOUT int cb = 0; do { delay ( 10 ); cb = this->_udp->parsePacket(); if( cb > 0 ) { this->_udp->read( this->_packetBuffer, NTP_PACKET_SIZE ); if( !this->isValid( this->_packetBuffer ) ) cb = 0; } if( timeout > 100 ) return( false ); // TIMEOUT AFTER 1000 MS timeout++; } while( cb == 0 ); this->_lastUpdate = millis() - (10 * (timeout +1)); // FOR TIME READ DLY ulong highWord = word( this->_packetBuffer[40], this->_packetBuffer[41] ); ulong lowWord = word( this->_packetBuffer[42], this->_packetBuffer[43] ); // COMBINE FOUR BYTES ( TWO WORDS ) INTO A LONG INTEGER // THIS IS NTP TIME ( SECONDS SINCE jAN 1 1900 ): ulong secsSince1900 = highWord << 16 | lowWord; this->_currentEpoc = secsSince1900 - SEVENZYYEARS; return( true ); }
/*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->begin(); // SETUP UDP CLIENT IF NEEDED return( this->forceUpdate() ); } return( true ); }
/*F******************************************************************** * **********************************************************************/ unsigned long NTPClient:: getEpochTime() { // USER OFFSET+ EPOC RETURNED BY NTP SERVER return( this->_timeOffset + this->_currentEpoc + ((millis() - this->_lastUpdate ) / 1000 ));// TIME SINCE LAST UPDATE }
/*F******************************************************************** * **********************************************************************/ int NTPClient:: getDay() { return( ((this->getEpochTime() / 86400L ) + 4 ) % 7 ); // 0 IS SUNDAY }
/*F******************************************************************** * **********************************************************************/ int NTPClient:: getHours() { return ( ( this->getEpochTime() % 86400L ) / 3600 ); }
/*F******************************************************************** * **********************************************************************/ int NTPClient:: getMinutes() { return ( ( this->getEpochTime() % 3600 ) / 60 ); }
/*F******************************************************************** * **********************************************************************/ int NTPClient:: getSeconds() { return ( this->getEpochTime() % 60 ); }
/*F******************************************************************** * **********************************************************************/ String NTPClient:: getFormattedTime( unsigned long secs ) { unsigned long rawTime = secs ? secs : 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******************************************************************** * BASED ON https://github.com/PaulStoffregen/Time/blob/master/Time.cpp CURRENTLY ASSUMES UTC TIMEZONE, INSTEAD OF USING this->_timeOffset **********************************************************************/ String NTPClient:: getFormattedDate( unsigned long secs ) { // in days unsigned long rawTime = (secs ? secs : this->getEpochTime() ) / 86400L; unsigned long days = 0, year = 1970; uint8_t month; static const uint8_t monthDays[]={31,28,31,30,31,30,31,31,30,31,30,31}; while( ( days += ( LEAP_YEAR( year ) ? 366 : 365 ) ) <= rawTime ) year++; rawTime -= days - (LEAP_YEAR( year ) ? 366 : 365); // DAYS IN THIS YEAR, STARTING AT 0 days =0; for( month=0; month<12; month++ ) { uint8_t monthLength; if( month == 1 ) // february monthLength = LEAP_YEAR( year ) ? 29 : 28; else monthLength = monthDays[month]; if( rawTime < monthLength ) break; rawTime -= monthLength; } String monthStr = ++month < 10 ? "0" + String( month ) : String( month ); // jan is month 1 String dayStr = ++rawTime < 10 ? "0" + String( rawTime ) : String( rawTime ); // day of month return String( year ) + "-" + monthStr + "-" + dayStr + "T" + this->getFormattedTime( secs ? secs : 0 ) + "Z"; }
/*F******************************************************************** * **********************************************************************/ void NTPClient:: end() { this->_udp->stop(); this->_udpSetup = false; }
/*F******************************************************************** * SET SECONDS FROM GMT **********************************************************************/ void NTPClient:: setTimeOffset( int timeOffset ) { this->_timeOffset = timeOffset; }
/*F******************************************************************** * **********************************************************************/ void NTPClient:: setUpdateInterval( unsigned long updateInterval ) { this->_updateInterval = updateInterval; }
/*F******************************************************************** * **********************************************************************/ void NTPClient:: sendNTPPacket() { // SET ALL BUFFER BYTES TO 0 memset( this->_packetBuffer, 0, NTP_PACKET_SIZE ); // INIT VALUES NEEDED TO FORM NTP REQUEST (SEE URL ABOVE FOR DETAILS ON PACKETS) 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] = 0x49; this->_packetBuffer[13] = 0x4E; this->_packetBuffer[14] = 0x49; this->_packetBuffer[15] = 0x52; // NTP fields set, send packet requesting timestamp: this->_udp->beginPacket( this->_poolServerName, 123 ); this->_udp->write( this->_packetBuffer, NTP_PACKET_SIZE ); this->_udp->endPacket(); }
/*F******************************************************************** * **********************************************************************/ void NTPClient:: setEpochTime( unsigned long secs ) { this->_currentEpoc = secs; }